Received: by 2002:a05:6358:11c7:b0:104:8066:f915 with SMTP id i7csp930853rwl; Wed, 12 Apr 2023 06:13:27 -0700 (PDT) X-Google-Smtp-Source: AKy350YIzoAsV1cnA8/pOQDkNFGxBhPN+UitsTPPSOyhHYZSiii6bXgZdiFyWQ7WBFNFPb8hEjrs X-Received: by 2002:a17:903:1c7:b0:1a3:d392:2f29 with SMTP id e7-20020a17090301c700b001a3d3922f29mr2760539plh.20.1681305207397; Wed, 12 Apr 2023 06:13:27 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1681305207; cv=none; d=google.com; s=arc-20160816; b=hq3jm9eTP6/+mBCyVaelm6/ZnhW0PLRa0/2miWhSiUuleHVA9Mw4khbYczyF4Cv478 LifdzPCfoLUUJRu//TG1YngZIYRA+DihrqmUH0V8aM9XeGaTbPjnuC9I8CxGEdntWOup ZqEnYzZFQ8MuLDsXYWtuIFaFzcyJKWFslS34GMi+zConxsgllTu1jfQBofRq3mgi7GMn EkkB/WDjjVURpC9opjV1Suvqyd1d8hEE8NvuYKHmtDok7Ik6VLuUe5jAxc3n32l3DsAe E6XDZqx3kZXERBwU3yAjA8VEMpbuKHmUfIS9f6ubmeZGrY0xFer5ISEH/amZuSCxEXT7 7YvQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=8yupuXvL3rj3TNyP6lvzLm0KmgyUpTnWgiAzlVDKtGo=; b=jUlSkSWcxnWyuxXn7IC7GxN7CgFJ22MrEpEbbMyyx+5PMLGcwHMvq8zFRiVUz66HpC x+jK5qO59kE+t7INSWeDVsr7zQv88UXhm008Us2bPYIG91Ne3TllFRLrSyVZnAyUlAaL P7D4Yx0SvuVLgXV9K50l0z3FmY7riS45N2XChSWAk6A90z8TGUCQtjIcLeo2v06jp0Oo 0jqKKOr8kBywKSFoOLKPoX2p+lzb8Fe411ubuFAPEfW9A+CCeeeRaOuDLYuh/V3eyO5V kyv3LOErZHKlPZFl/p4tdRk3EjPFayCwm1o3jc/q/StYgzaaPV3m6STIAwOIa3r+qtV5 CFxg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=HqY7t6+o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Return-Path: Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id q4-20020a63f944000000b0050be565b856si15997755pgk.685.2023.04.12.06.13.16; Wed, 12 Apr 2023 06:13:27 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20; Authentication-Results: mx.google.com; dkim=pass header.i=@collabora.com header.s=mail header.b=HqY7t6+o; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=collabora.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S230116AbjDLNM4 (ORCPT + 99 others); Wed, 12 Apr 2023 09:12:56 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34772 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230099AbjDLNMm (ORCPT ); Wed, 12 Apr 2023 09:12:42 -0400 Received: from madras.collabora.co.uk (madras.collabora.co.uk [IPv6:2a00:1098:0:82:1000:25:2eeb:e5ab]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 7308F7D93; Wed, 12 Apr 2023 06:12:25 -0700 (PDT) Received: from IcarusMOD.eternityproject.eu (2-237-20-237.ip236.fastwebnet.it [2.237.20.237]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) (Authenticated sender: kholk11) by madras.collabora.co.uk (Postfix) with ESMTPSA id 70EDC6603208; Wed, 12 Apr 2023 14:12:23 +0100 (BST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=collabora.com; s=mail; t=1681305144; bh=W84iqCod7r2TCo/WEoCtavk3ERz0ZI5/UapmrYR06xk=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=HqY7t6+oJxfkhAVqa3XkwqMUNf0cylg2BwhkbtIHM+2MAYLX2nVP4j3BVT8Y2Qkhc ezvk2vVzWaRanUlqWZ8qakLr5SooJILlELkPGVeq8Fx7p7+38Jwryz8rKjJpDaiGRm isR9A9IAZd/rGR+e1gZIF0ovRfNjR5RDMmQLYxC/K8GNA0NAA+cnukEEwycU/KdD9d 7lvxNnHN7KuiTZzLndZjmcjGxslKweXiXJZ4VCP2vJtrIq757ExA4/kLByXheN5oAU 9HD3m66KmFw0ZeaKlwm6HxHcx5WvL/aHlVaPmc0e1IpuEh9wx3RqDSeLVTtRLB26hv euRXWnfDzw5ow== From: AngeloGioacchino Del Regno To: matthias.bgg@gmail.com Cc: robh+dt@kernel.org, krzysztof.kozlowski+dt@linaro.org, amergnat@baylibre.com, flora.fu@mediatek.com, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, linux-arm-kernel@lists.infradead.org, linux-mediatek@lists.infradead.org, kernel@collabora.com, phone-devel@vger.kernel.org, ~postmarketos/upstreaming@lists.sr.ht, AngeloGioacchino Del Regno Subject: [PATCH v3 3/6] soc: mediatek: pwrap: Add kerneldoc for struct pwrap_slv_type Date: Wed, 12 Apr 2023 15:12:13 +0200 Message-Id: <20230412131216.198313-4-angelogioacchino.delregno@collabora.com> X-Mailer: git-send-email 2.40.0 In-Reply-To: <20230412131216.198313-1-angelogioacchino.delregno@collabora.com> References: <20230412131216.198313-1-angelogioacchino.delregno@collabora.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org In preparation for adding new members with name abbreviations describe the struct pwrap_slv_type with kerneldoc to enhance human readability. Signed-off-by: AngeloGioacchino Del Regno Reviewed-by: Alexandre Mergnat --- drivers/soc/mediatek/mtk-pmic-wrap.c | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/drivers/soc/mediatek/mtk-pmic-wrap.c b/drivers/soc/mediatek/mtk-pmic-wrap.c index 5c500be48f7c..a33a1b1820cb 100644 --- a/drivers/soc/mediatek/mtk-pmic-wrap.c +++ b/drivers/soc/mediatek/mtk-pmic-wrap.c @@ -1218,11 +1218,17 @@ struct pwrap_slv_regops { int (*pwrap_write)(struct pmic_wrapper *wrp, u32 adr, u32 wdata); }; +/** + * struct pwrap_slv_type - PMIC device wrapper definitions + * @dew_regs: Device Wrapper (DeW) register offsets + * @type: PMIC Type (model) + * @regops: Register R/W ops + * @caps: Capability flags for the target device + */ struct pwrap_slv_type { const u32 *dew_regs; enum pmic_type type; const struct pwrap_slv_regops *regops; - /* Flags indicating the capability for the target slave */ u32 caps; }; -- 2.40.0