From patchwork Wed Aug 31 13:56:34 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Claudiu Beznea X-Patchwork-Id: 12960739 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 0E0DAC0502A for ; Wed, 31 Aug 2022 13:55:34 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-ID:Date:Subject:CC:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=deCfnypLXlbsBoELVC2WRMuFdZRT/5sa+/dk0hHJyGM=; b=yJJ6tEzXIiN46d 6CEHucXzA9x9OzkmYpPtI+wwU35Kv8q7TTtzO9UfGCyfnvbXhPK1NlOj7dlLrQoSN02PLnA+TXVcM DpenQQBsCwuo4HxLKrdbVA7uOdHZZViF/5496x4SShAMiaGb7FwHswJIkNJ6KTaACngzabNCk73Jf DnuvLbem4RkTaPqEdjI7CHoP1HSdbmrlIQNqjEVB75wPu3RWG0AARzEa3d4sX7FADvHDbyIWOjTx3 oRS1R0k0qXywdjaj6t23Je5RAIvKp4depxf25TAQiZnG84jEN41ULIIRrwYwPzSfmPxZVktSihvZM oOk5o4CQCPFCbj5OjppA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1oTOAw-006U1t-H6; Wed, 31 Aug 2022 13:54:38 +0000 Received: from esa.microchip.iphmx.com ([68.232.154.123]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1oTOAp-006U09-CF for linux-arm-kernel@lists.infradead.org; Wed, 31 Aug 2022 13:54:33 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1661954071; x=1693490071; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=KY6bpmQ3eJvu6vH+Ew2QhhCbPYbB0XbDG0reDpNS9rg=; b=cYb+TmFo4tK63JV2mw2WFklitna8o7JzPpsgIQ03fJCtW9caT/w/nRHm yucYnMbeubbQ84i2NlNOMXUDRdTihOdOlgSUHRT+x6vWXsAlDEJuCL8Zy claRdToWeH+hdrto+mvb44jHdwuMSE3+NILhNj87vLw0n7CjYJUFu0MOD Th1hDEl15TG8ivvNGutaRetA1BeJ5UOVINFYsoZEF5WyqGDKko/pv/adb PnPP5TxrLYwwlOver576zJ3ZbM0/ouiQeoUieDTjhpcSY/HR31/4/hXnz ia9j5QNCMcx25yjZEZBmYUb3k8IakMIDT2jIs+C0fI6xlkWVxbEEahWzE Q==; X-IronPort-AV: E=Sophos;i="5.93,278,1654585200"; d="scan'208";a="111574440" Received: from unknown (HELO email.microchip.com) ([170.129.1.10]) by esa6.microchip.iphmx.com with ESMTP/TLS/AES256-SHA256; 31 Aug 2022 06:54:25 -0700 Received: from chn-vm-ex04.mchp-main.com (10.10.85.152) by chn-vm-ex01.mchp-main.com (10.10.85.143) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.12; Wed, 31 Aug 2022 06:54:24 -0700 Received: from localhost.localdomain (10.10.115.15) by chn-vm-ex04.mchp-main.com (10.10.85.152) with Microsoft SMTP Server id 15.1.2507.12 via Frontend Transport; Wed, 31 Aug 2022 06:54:21 -0700 From: Claudiu Beznea To: , , , , CC: , , , Claudiu Beznea Subject: [PATCH 1/3] pinctrl: at91: use kernel-doc style for documentation of at91_gpio_chip Date: Wed, 31 Aug 2022 16:56:34 +0300 Message-ID: <20220831135636.3176406-2-claudiu.beznea@microchip.com> X-Mailer: git-send-email 2.33.0 In-Reply-To: <20220831135636.3176406-1-claudiu.beznea@microchip.com> References: <20220831135636.3176406-1-claudiu.beznea@microchip.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20220831_065431_517444_B50B7E27 X-CRM114-Status: GOOD ( 10.54 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Use kernel-doc style for documentation of struct at91_gpio_chip. Signed-off-by: Claudiu Beznea --- drivers/pinctrl/pinctrl-at91.c | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/drivers/pinctrl/pinctrl-at91.c b/drivers/pinctrl/pinctrl-at91.c index 5634fa063ebf..0b78fd48fd02 100644 --- a/drivers/pinctrl/pinctrl-at91.c +++ b/drivers/pinctrl/pinctrl-at91.c @@ -33,16 +33,28 @@ struct at91_pinctrl_mux_ops; +/** + * struct at91_gpio_chip: at91 gpio chip + * @chip: gpio chip + * @range: gpio range + * @next: bank sharing same clock + * @pioc_hwirq: PIO bank interrupt identifier on AIC + * @pioc_virq: PIO bank Linux virtual interrupt + * @pioc_idx: PIO bank index + * @regbase: PIO bank virtual address + * @clock: associated clock + * @ops: at91 pinctrl mux ops + */ struct at91_gpio_chip { struct gpio_chip chip; struct pinctrl_gpio_range range; - struct at91_gpio_chip *next; /* Bank sharing same clock */ - int pioc_hwirq; /* PIO bank interrupt identifier on AIC */ - int pioc_virq; /* PIO bank Linux virtual interrupt */ - int pioc_idx; /* PIO bank index */ - void __iomem *regbase; /* PIO bank virtual address */ - struct clk *clock; /* associated clock */ - const struct at91_pinctrl_mux_ops *ops; /* ops */ + struct at91_gpio_chip *next; + int pioc_hwirq; + int pioc_virq; + int pioc_idx; + void __iomem *regbase; + struct clk *clock; + const struct at91_pinctrl_mux_ops *ops; }; static struct at91_gpio_chip *gpio_chips[MAX_GPIO_BANKS];