From patchwork Wed Feb 12 13:46:52 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Nikolaos Pasaloukos X-Patchwork-Id: 864909 Received: from mx07-0063e101.pphosted.com (mx07-0063e101.pphosted.com [205.220.184.123]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8BE2020E310; Wed, 12 Feb 2025 13:58:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=fail smtp.client-ip=205.220.184.123 ARC-Seal: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739368718; cv=fail; b=SJ0WDN/YWivrwJV9wOqzgfXmZ+1XQUywFkCyDSTcF1DYFV8Uk0ZlPYCVsz0f3os5SGtNZ7mHQIEtmjPlLd+OsKHW7LwitKOwIEgNz4K3q7wCvwreEzzoSn9CLK9/lbBRpCgRmQD1ZG0b3nKMhmL4zFgE8oiEcyLce3DQjCjGUVU= ARC-Message-Signature: i=2; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1739368718; c=relaxed/simple; bh=awUHMfuL8rTISk+QYJBUgTicy8I93tjlNXUdV9Qo06g=; h=From:To:CC:Subject:Date:Message-ID:References:In-Reply-To: Content-Type:MIME-Version; b=U3M1RfKM1AjS5Fqdk3qFWp4EedIvndzd3p4xpJiY5ai7010ZvHRBHrY/adBhhq6IGPSkE3ZyjrjDvAa8/I+AWiIU4SX64OoSALjVVs+RNm0iL+d21mxxbl0eCX73fs7GLnNeAfmOrkh0j0o7ATVM7laSl3bG6pPLRB328Gf5Dt0= ARC-Authentication-Results: i=2; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=blaize.com; spf=pass smtp.mailfrom=blaize.com; dkim=pass (1024-bit key) header.d=BLAIZE.COM header.i=@BLAIZE.COM header.b=StFRaGfm; arc=fail smtp.client-ip=205.220.184.123 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=blaize.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=blaize.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=BLAIZE.COM header.i=@BLAIZE.COM header.b="StFRaGfm" Received: from pps.filterd (m0247495.ppops.net [127.0.0.1]) by mx08-0063e101.pphosted.com (8.18.1.2/8.18.1.2) with ESMTP id 51CDLEpW031943; Wed, 12 Feb 2025 13:47:01 GMT Received: from ma0pr01cu009.outbound.protection.outlook.com (mail-southindiaazlp17010006.outbound.protection.outlook.com [40.93.131.6]) by mx08-0063e101.pphosted.com (PPS) with ESMTPS id 44qwtd8sy3-3 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Wed, 12 Feb 2025 13:47:00 +0000 (GMT) ARC-Seal: i=1; a=rsa-sha256; s=arcselector10001; d=microsoft.com; cv=none; b=DkdmXdb9ucw6yUw5Z84A7DXQa2ybHGrI7Cez59DokFNZ0b/gwEOnYPmiz8St6BYd6Gq+U+ywQmb7KiUCmo+/WglNCdCyGPOCjal/NFJSW1dIiVQxeXi3AJBmeNsOeIODcYE4Xb0+gHKnWOfaUWw1yB0CFIOPr3XA6aM/feNb/7OOIIrE9LHRNScFvQj22TOtDZg8nqoGeP2GK9as8s6AltS2dbpy3+tb9vrL5MWaM2XCjuvMuMGzuW89BjRAeBktRGCazzfi/Zt4P+Pyhftiv4JRcgv0VFnujhNtrczvqinN+FEs5o6+pPRDkODaJmJZ/d7ZOCQnvx/+4fU2Q6trdg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector10001; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=awUHMfuL8rTISk+QYJBUgTicy8I93tjlNXUdV9Qo06g=; b=S+6xdYt480dHg4Itcj8nEFpZX+lXqZwAw40SQ7Tbi62EFk2kNT8DKRHL9dnznSjM5RDgSWjKUShyQaaFtpaZg7xWfnNvqDpcQ6MKxJYz9oOQafH2sgih5JQ6MUlFrTBwO1QJlFEVJ/ma+PjEgLMYol7H64ZilIxC5HmZrWbGnBBI5GI9B0eB7AocLHl5/gTYNJVmRpXnYzBUStMf4ZOgRospPH/2DE1hfFKt5hyCM61TgkQRbIQ7/Q9P2D4SDwKuuHLZ6wltwS6gcjGhOEQiXEtTQBTzAYuczKi9D06/Amv13v7adHmKVsN5LHowpudd3a5HE1RltLsiw8/tpxO/MQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=blaize.com; dmarc=pass action=none header.from=blaize.com; dkim=pass header.d=blaize.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=BLAIZE.COM; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=awUHMfuL8rTISk+QYJBUgTicy8I93tjlNXUdV9Qo06g=; b=StFRaGfmnk3HEcAHF3SvIKwfGA7jXwePHwJv0evYy6rQbmWRNzmn4UegyS7m6aY1sqTG5apOwwrMqFVhAULmP1XVc7NA5gK3RCOh2foDTNQBWYhIThRrNflsU5Ffj2cMsqccfypEDSH/S/A/HvNTP0djwCkaEhh+tsMVgyIO9pY= Received: from MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a01:12a::5) by MA0PR01MB10196.INDPRD01.PROD.OUTLOOK.COM (2603:1096:a01:127::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.8422.19; Wed, 12 Feb 2025 13:46:52 +0000 Received: from MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM ([fe80::309a:12cf:74a4:5655]) by MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM ([fe80::309a:12cf:74a4:5655%4]) with mapi id 15.20.8445.011; Wed, 12 Feb 2025 13:46:52 +0000 From: Nikolaos Pasaloukos To: Rob Herring , Krzysztof Kozlowski , Conor Dooley , James Cowgill , Matt Redfearn , Neil Jones , Linus Walleij , Bartosz Golaszewski , Matt Redfearn , Catalin Marinas , Will Deacon CC: "devicetree@vger.kernel.org" , "linux-kernel@vger.kernel.org" , "linux-gpio@vger.kernel.org" , "linux-arm-kernel@lists.infradead.org" , Nikolaos Pasaloukos Subject: [PATCH 2/5] dt-bindings: Document VeriSilicon APB GPIO driver Thread-Topic: [PATCH 2/5] dt-bindings: Document VeriSilicon APB GPIO driver Thread-Index: AQHbfVSSTpvyU60QdUO68FRWGQydSw== Date: Wed, 12 Feb 2025 13:46:52 +0000 Message-ID: <20250212-kernel-upstreaming-add_gpio_support-v1-2-080e724a21f3@blaize.com> References: <20250212-kernel-upstreaming-add_gpio_support-v1-0-080e724a21f3@blaize.com> In-Reply-To: <20250212-kernel-upstreaming-add_gpio_support-v1-0-080e724a21f3@blaize.com> Accept-Language: en-GB, en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: MA0PR01MB10184:EE_|MA0PR01MB10196:EE_ x-ms-office365-filtering-correlation-id: 2b16f719-fc19-448f-2fe5-08dd4b6bb4b6 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; ARA:13230040|366016|1800799024|376014|7416014|921020|38070700018; x-microsoft-antispam-message-info: =?utf-8?q?Q+up2B+N2fN1aYx3/ZVYyOGdHk6+b+q?= =?utf-8?q?EfhlO/EA0SO6dGpjScBdaRElTs0edgLmO1IlNVQ7E3LMB79xYK411J53IhebuSa1y?= =?utf-8?q?sqZh1h+x/lqyZr49hWTVa6s7luhn2nZP8PAjFZzpd3MOxyepimRPdtLTWmBJ8Kkgy?= =?utf-8?q?/Bw6fhUlmhd3Gx6vf+zT8vgmA9qSlkhwlhOkHvt8wQbLY7gPBslM8F3U4GYn93M6R?= =?utf-8?q?BQT5t8E3XHlkFvTnLZSwx1tvYB8PVojkjg0Ad1w4r9QjOPom0VTJ++K3y84MQ8gds?= =?utf-8?q?4hMZur27W4ZE8tAKrgG0ExpqwVBa0tXpQELyeIwlRmfs6b8ub1QOrXlojfGw1QfGT?= =?utf-8?q?L0yDtJLstr8Xns9ewtckQM4ZbMXs5u799sXBWAFWy+8yDjaFSh6A4IPPUJ78SY5En?= =?utf-8?q?Peo66tCSt6V/lGt1vHyjYZZaKW7uRINzvbrSSsLt72G2wPUY+Aiy0HJgTV8XlsRUJ?= =?utf-8?q?zMV5mCiNe84EaJUp8Fy1vr5DFJLNGikPREfiPKGvkwyEJtDNX5sscyCtn90709fRr?= =?utf-8?q?ZOzoQ40PjE6GqIxJWbYBrIbCEEzJW0K56keb32SRA0vnbtIKIanTJqH4eIvjK0x2J?= =?utf-8?q?Ac+mHnVSQJN4vnTh08rM6T5fL6SQc6iYG763g3TUcYg9sPgAMR9TrGXYAjeUUIUtC?= =?utf-8?q?Usexywzmmxp59eAEXHnPsNJmGGuJamvws89Dtay3xgFDGxwAoMW0fhpvpsS6FtnJe?= =?utf-8?q?FUOdPoOYf3VCnB4DGE3YUBHe564apC5L9vm7nRKP05PPiXTDwStGoF/4Ifk4iF651?= =?utf-8?q?Momhwud5iBPpP0jjNAWezTSPe12OQwgH06SuDOCa8dFQ5z0WATqWSQWiHFDID+i1k?= =?utf-8?q?VtdUCu/0zXOh1SvMHbdJqKVyZmndvjqqb3krgydYDQ7Hgoa+T1EKbtdyS+ArLaQJv?= =?utf-8?q?Yy2OmjKpf71LsUrLggWtdSS5f2Tjl2h3CnD0qNurGWkp1OpnqgBi7CCm0NBgA1WIG?= =?utf-8?q?ImfQiBtWyZ+7Mt0Nl5dC+QZsE+MIg6c04CF2SOlsKop5wAQlgv20yW/hOuJnAJ5bQ?= =?utf-8?q?ppxcBOVpcDhm62sXgp2IQmDGwfv0SNtnjXHLsw6LZdhN5t7aNT6ikZMKhvVoNFLjc?= =?utf-8?q?4nSiyejpaOclXybm0H9MwmexcG6CUM14PHOyHytalp4R+lXkx1tSuzA8JAtb5GlR+?= =?utf-8?q?TqFL6ig6JDNIf7RUA07fH/BZqn5JbJV4Q67/ADf2rzNfCXVWRIX2760gLMMA02fDl?= =?utf-8?q?nsbyF6BcJ1BTo28yZXVFNpysN+QJU7gaUZmrTutsQO5Zdw55l6OQMYtW7xHPxSmg8?= =?utf-8?q?yswgAcTpCtSbcwsxnT8fQ5jKfxFm2OfutkJdh+RjtpQGdl5a0Eq0iz2/FcU0vI6or?= =?utf-8?q?/fR0okxbyxrmT3+aZosgrwqMkvp3EEoLyg=3D=3D?= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(13230040)(366016)(1800799024)(376014)(7416014)(921020)(38070700018); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?q?OP0osKSNvUOf6g6anYvdc1zb0vaj?= =?utf-8?q?nLBYBKAhxGUYKWiYhnfTIQUAIOrcIWbODwGxtmjTSDZzrbAmz6yERDVEbLeCZWNb1?= =?utf-8?q?1HqEjV3EhawDWVNKWJxo2436WybI/wtqY4HXACyGa3evvtoyIvRDuV6KqtwNhMqaU?= =?utf-8?q?GrlRWNXKVw8aZmSWHoolSwMDIIgDBaFAzSRok/a7D/mN08uGDhBVIPRfxnjJEjcu0?= =?utf-8?q?H24s9Rkk+PSTctYkde4rCJTzfxtlmJEuqS7pHZ7NVKWsavXETzfs4ClJ3g7iZzhCJ?= =?utf-8?q?kEM1g1KI6+wRd4EZhlt+t4nQW2pIjbfYq7qM5LQweYkRa45BN26lAJsQgl37wdMf4?= =?utf-8?q?NwkHYlkGzXklOoLso9Hc45mD/deDRLhhcmthCzCju7yjyCKeChEo1FaAwSxIeHuSK?= =?utf-8?q?PljHi575vZKXpXvuGY34g8eCEVJdEw6YmxTnFbTDIcwezyTCyYcjUwPc6Nmm4F/xX?= =?utf-8?q?HSgX9Vjgoy7B/4qkJng8cNCQv9qLKg7HsCFFcGQ8V4Q/Zu18WnzqwAsyXOpHeDreL?= =?utf-8?q?fru956EwnjBPYNq2oFy97SkINFPj4E6MVQJOM/pVw1UHsBJBZ66GW7SDW72pqdmCj?= =?utf-8?q?APTzJB5TPQIKqFMS+s/swujfbRYQVMEE+gq7+gN3hNNqWK7uZ3nJn0cxRASwnDTvQ?= =?utf-8?q?sdwfFdxwe90TswyAZYPRIfchTKKhscFQI2ZoP3p5M3LjMTiVP+CeyUMgbCfG01nlb?= =?utf-8?q?/W64YR1XALVynqx3g6eaHdSgBpHtw9hmxgg/XHY8QDt6z1Zf4jufoFQC9rs8omjen?= =?utf-8?q?s49A+ZD3JqE5U59ygtYDt5rHT93oXv2QvMMUKtQ02YvFs2RTB9intP14M8hng7Z78?= =?utf-8?q?BW9aJngaI4zT3wvh7LnOsJMqzGGwhiw9E6vZDOkENn8e7+6WGKNkyiq4xjyQE0pDv?= =?utf-8?q?H/UYbIPooHI3+rX5fQf83V6GtGCrESrnMJ+CNkwhEuU9Zqek/6FvpuTgCVm/7XaqY?= =?utf-8?q?WpQvgX/NGVwyZSqzPPzsQDY+88M3cTwZWp2bL/ZLKTO7J3MM0tcTQFdDk+r1dOx3r?= =?utf-8?q?6WxXSV7rXbFbSzQqP8KGrKylt1bFfMN/nEsrp4IRiEV06crcmhRVEvpLqEXM7COiE?= =?utf-8?q?HobwdhIjnDW36vvW65mGPsNyWOBUCdzJD7vdHvD2QmwBCt2uGKK450hP3KqteMCD+?= =?utf-8?q?Ny1afz6XUdyY2W/rf6ZCDBOxXxY4+dfOVoTF/p3RM87uZJn+WtwGvIiYWi7wR7/1X?= =?utf-8?q?H3aZBykRHrRHvLQJSaBuyHHfjmpa0D+0MklIW/fYUcIIKnSG61WQ/RuAJYPBcgB7W?= =?utf-8?q?R/dthrMECZciRR76PRtVMt/pCTNbmFPjBdZoieBLgNVyPalDQFmULpspZS9xW1mPz?= =?utf-8?q?uyFnBhhKdrdUlDBUKXmooZaQTa/+xkQxIMaPlGnEpunDwwkjqttF7K3VMZBAju/8N?= =?utf-8?q?3hFhoL87aney9yqqOtJ1Ssi1Zj5ebXLgcouDzHBti2lQ1TushhQlkrsb0eGAkerLA?= =?utf-8?q?eb+MIdychREEPgIp6R8QVawmRiPluaIdEdpLYrmq+xH9+6Lm4lnqoDL4Hz2yZ3Ktd?= =?utf-8?q?IyFm7aBcLHwCg/QkNd24ywGDj4B6YiEtlg=3D=3D?= Content-ID: Precedence: bulk X-Mailing-List: linux-gpio@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-OriginatorOrg: blaize.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: MA0PR01MB10184.INDPRD01.PROD.OUTLOOK.COM X-MS-Exchange-CrossTenant-Network-Message-Id: 2b16f719-fc19-448f-2fe5-08dd4b6bb4b6 X-MS-Exchange-CrossTenant-originalarrivaltime: 12 Feb 2025 13:46:52.1755 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 9d1c3c89-8615-4064-88a7-bb1a8537c779 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: r+yqskJTblfVnxaFsgxU64pWjDQod3ubsWJgMqI4o/UUPiuSVgQfEHl7GoIwH/5Zq1kll4GHTWz2EPJ1eibT4JhOWGq7Otg6H5g9h2/7Rlc= X-MS-Exchange-Transport-CrossTenantHeadersStamped: MA0PR01MB10196 X-Authority-Analysis: v=2.4 cv=ALxkcdDx c=1 sm=1 tr=0 ts=67aca654 cx=c_pps a=TXs1g+7sIME2BPo3OSn30g==:117 a=wKuvFiaSGQ0qltdbU6+NXLB8nM8=:19 a=Ol13hO9ccFRV9qXi2t6ftBPywas=:19 a=xqWC_Br6kY4A:10 a=IkcTkHD0fZMA:10 a=T2h4t0Lz3GQA:10 a=4MthsM0t3ikA:10 a=-5LYVjoNHPMA:10 a=gEfo2CItAAAA:8 a=SrsycIMJAAAA:8 a=TTxV7h_1yqWNZ0CMU5MA:9 a=QEXdDO2ut3YA:10 a=sptkURWiP4Gy88Gu7hUp:22 a=zapPnUM7SFj2ezx6rUw-:22 X-Proofpoint-GUID: av7BiCyyUm606-CvkNxytzdiJRG3wYay X-Proofpoint-ORIG-GUID: av7BiCyyUm606-CvkNxytzdiJRG3wYay X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1057,Hydra:6.0.680,FMLib:17.12.68.34 definitions=2025-02-12_04,2025-02-11_01,2024-11-22_01 X-Proofpoint-Spam-Reason: orgsafe This is a custom silicon GPIO driver provided from VeriSilicon Microelectronics. It has 32 input/output ports which can be configured as edge or level triggered interrupts. It also provides a de-bounce feature. Signed-off-by: Nikolaos Pasaloukos --- .../devicetree/bindings/gpio/vsi,apb-gpio.yaml | 83 ++++++++++++++++++++++ 1 file changed, 83 insertions(+) diff --git a/Documentation/devicetree/bindings/gpio/vsi,apb-gpio.yaml b/Documentation/devicetree/bindings/gpio/vsi,apb-gpio.yaml new file mode 100644 index 0000000000000000000000000000000000000000..4a293b44e03895b6a45cb85f42c47c46b64f5638 --- /dev/null +++ b/Documentation/devicetree/bindings/gpio/vsi,apb-gpio.yaml @@ -0,0 +1,83 @@ +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/gpio/vsi,apb-gpio.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: VeriSilicon APB GPIO controller + +description: | + VeriSilicon GPIO controllers have a configurable number of ports, each + of which are intended to be represented as child nodes with the generic + GPIO-controller properties as described in this bindings file. + +maintainers: + - Nikolaos Pasaloukos + - James Cowgill + - Matthew Redfearn + - Neil Jones + +properties: + $nodename: + pattern: "^gpio@[0-9a-f]+$" + + compatible: + oneOf: + - description: Verisilicon APB GPIO controller + items: + - enum: + - vsi,apb-gpio-0.2 + + reg: + maxItems: 1 + + gpio-controller: true + + '#gpio-cells': + const: 2 + + ngpios: + default: 32 + minimum: 1 + maximum: 32 + + interrupts: + description: | + The interrupts to the parent controller raised when GPIOs generate + the interrupts. Specify a single interrupt since the controller + provides one combined interrupt for all GPIOs. + maxItems: 1 + + gpio-line-names: true + + interrupt-controller: true + + '#interrupt-cells': + const: 2 + +required: + - compatible + - reg + - gpio-controller + - '#gpio-cells' + +dependencies: + interrupt-controller: [ interrupts ] + +additionalProperties: false + +examples: + - | + #include + + gpio: gpio@4c0000 { + compatible = "vsi,apb-gpio-0.2"; + reg = <0x004c0000 0x1000>; + gpio-controller; + #gpio-cells = <2>; + ngpios = <32>; + interrupt-controller; + #interrupt-cells = <2>; + interrupts = ; + }; +...