From mboxrd@z Thu Jan 1 00:00:00 1970 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 AD12BC48260 for ; Tue, 13 Feb 2024 04:24:05 +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:Cc:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:Content-ID:In-Reply-To: References:Message-ID:Date:Subject:To:From:Reply-To:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=ezlYpdo3qaLHCx3lrVQVlYDKz0LBaRIr2GLSN4scUFM=; b=rn2C+tQLtWQUVC GDumRl83OJMjyKBT4ldT4m1D8tjrPdz1SUh4kMbSGIkE+YiRsKy3MPrTHf0KiDHvLel7bHqto3qzI gT2+OAeRCLk/onFtmNg9l0Dgi4AL6haWTiV1BUk7B4x2/aCAL8au/UG3xRDNAChz3gonYLiJ8KL6O fhpfLJpjzBk5iMUllgPn6dYgbvC0WwShmdyEta677eI6dbteMk3JdDpr/49L24VkMLPu+4dCYW5Qr oIgePsz81GTF7aJbrnQcNx/GI62/iS7Q+x9AeTwkyPJuk1XjfO7PV/NpNh+lNou1Q/kPxXojiiS4E gcke7atuAq2RXcK3aUbg==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.97.1 #2 (Red Hat Linux)) id 1rZkKl-00000007vXF-1zIQ; Tue, 13 Feb 2024 04:23:51 +0000 Received: from esa.microchip.iphmx.com ([68.232.154.123]) by bombadil.infradead.org with esmtps (Exim 4.97.1 #2 (Red Hat Linux)) id 1rZkKh-00000007vW0-1hhq for linux-arm-kernel@lists.infradead.org; Tue, 13 Feb 2024 04:23:49 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=microchip.com; i=@microchip.com; q=dns/txt; s=mchp; t=1707798227; x=1739334227; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=rHwHQZhKUqw1ZyUDxQrBF2fxis04w8scW/QPb/+tb7g=; b=2C02LKr+DAYDgRz4ZRzpBgMgFysKmBQ9ozEcVt+l1X3DkePr+2uQAO1X uJ/FianObt4BZU2SFssetUKWZUMnLE5RY0tjfcgO8nD6CXaRtAVJjM4cF Zbk9WeT/quDMa18+cvEQAp/PJ2WFwpoU1ljn0r8RxA8YAZCXrRP29oBC/ vW8zsLXuRiZbnG3PnhZ6qqTTD5dOUZkwk4OcYioS/S2UG3j8LWkwCvgfW tObI62086GTUnLOe4RAhpY/sowuXGXeGBuusIREV8ts/E18vg7RVjhZSu lavXw9PlJp8oizaqNbUQBTwrwSPbHbAa5w/kP6khHSIEmZM8So+CSU55Z g==; X-CSE-ConnectionGUID: GrbPa3QvTLeQt9e+1KO4UQ== X-CSE-MsgGUID: jYUkvFAyTCW7clp9xJYgmQ== X-IronPort-AV: E=Sophos;i="6.06,156,1705388400"; d="scan'208";a="183413720" X-Amp-Result: SKIPPED(no attachment in message) Received: from unknown (HELO email.microchip.com) ([170.129.1.10]) by esa6.microchip.iphmx.com with ESMTP/TLS/ECDHE-RSA-AES128-GCM-SHA256; 12 Feb 2024 21:23:41 -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.35; Mon, 12 Feb 2024 21:23:40 -0700 Received: from NAM12-BN8-obe.outbound.protection.outlook.com (10.10.215.250) by email.microchip.com (10.10.87.151) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.35 via Frontend Transport; Mon, 12 Feb 2024 21:23:40 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=nbG7YwI75YNgKph9PuugHxLBUURiUjWO6bRdV3EJk18YBpsfWJsWyG58xN/Lr2SADOi7oLUyMHNpXFDWCnssl3ahXN5COk/hrGEat5voU71zVOygMWpa3fgQYUivWcm194tznLyILCC+bUd5uDgaK3KMCXvrZZY5UNNnu8CBCCuqieVViYsGwAGycsntCZxE6nirtY97M1NSx/RKwu5jY+883Aj9EQ9dBVZEExfnkgoLuFFAZTbgyFEmCVwRJpbHs+zKLLq3PQiwVv6C3NYJeyY8mcOGvX+wFwMCHRvkHcxYe6356xEZeAsie5YNssY5OPfkG73876p2SsXJpXIh4w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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=rHwHQZhKUqw1ZyUDxQrBF2fxis04w8scW/QPb/+tb7g=; b=og0DHx3gIUxIzjORbbsMpApcbZwpjjdlPmbb5rABzDggGIXofMo6gsdVFL+NLIGrsj4fk+nzHV65lj10H9PMeemgcPyF13oXw72bCN6KL3eN8hV5f6yL5QO5bS9Ej4YIPcM8OHEQVZLOonyXDjhHYCUF5GkhTqHXufL2FCiW4tfRNgsJTf8xTPXLTmIWMvverhNj/w3amvXaRzsiMDSETXkSmzxkm/VlSlgKHjQmP6C/o90Jm9XG4vo5LncPYWft7Ip8pvNrnWsZ9mBNNRipFlbh2WItRm090KoKVtsfCTq/hkXIoQrAxqcHtSVlPKvrm8v41NKlLy1/Ia18lwL1iA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=microchip.com; dmarc=pass action=none header.from=microchip.com; dkim=pass header.d=microchip.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=microchip.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=rHwHQZhKUqw1ZyUDxQrBF2fxis04w8scW/QPb/+tb7g=; b=AGsnBeGZe+n5uKuxkBEaTbR2rwOmd2F1cAkqTN7lFiQWBHId/JX5NvTIx6mLyCm0EKCBDNz1qfnf0xlvGlCfyXQVoPpOZ8s+jwv/m2/C6XETAh6Y5KaQ1MFMMeazRkScq+nPWQ9XmszBWofnlSBSw6tpQeBAGKBH32NJ3MRGPWPPAb8sKSEyuNqL36/JjMMjKjNhd8cRONqrtzRwcxVDeti5yHFeXhGNdvQqOQ3QY9A6XZHlW1A0rZCOKxURCAWi2Z15GoG+sdkcXu9b35+LLgVtoW7CQjYk/LpyvU+tPd93xC2Rfnk1AfFiCJznAlV6AfiKE/CS0rnP5YClczlpLg== Received: from PH7PR11MB6451.namprd11.prod.outlook.com (2603:10b6:510:1f4::16) by PH0PR11MB5901.namprd11.prod.outlook.com (2603:10b6:510:143::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7270.39; Tue, 13 Feb 2024 04:23:36 +0000 Received: from PH7PR11MB6451.namprd11.prod.outlook.com ([fe80::80b9:80a3:e88a:57ee]) by PH7PR11MB6451.namprd11.prod.outlook.com ([fe80::80b9:80a3:e88a:57ee%3]) with mapi id 15.20.7270.036; Tue, 13 Feb 2024 04:23:36 +0000 From: To: Subject: Re: [PATCH v2] dt-bindings: interrupt-controller: Convert Atmel AIC to json-schema Thread-Topic: [PATCH v2] dt-bindings: interrupt-controller: Convert Atmel AIC to json-schema Thread-Index: AQHaWz8HvDl6LGSGcE+Fqy+8rXoJf7EGw2QAgADu8AA= Date: Tue, 13 Feb 2024 04:23:36 +0000 Message-ID: <003d61c9-b914-4e1c-b3f8-1140ea640039@microchip.com> References: <20240209100122.61335-1-dharma.b@microchip.com> <20240212140824.GA107736-robh@kernel.org> In-Reply-To: <20240212140824.GA107736-robh@kernel.org> Accept-Language: en-GB, en-US Content-Language: en-GB X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=microchip.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: PH7PR11MB6451:EE_|PH0PR11MB5901:EE_ x-ms-office365-filtering-correlation-id: f4fd6f4c-c4ab-4a02-91da-08dc2c4b8c07 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: UmS9j56s0qyxC7uYprgtKSIbvTzPj9MKLrQ81wGJsRJ6t9JtE4VKAoHpCV8J34hxrNSyOxmsv+vqDT5KiDCby29F1hIdvSP1/2+LkkO8QMjF1Qmg97CsteoJby8lyQ8JSX4T07kCJ4iiGYGyF4i4aIkLivF1MbQNzvN5pWLRK9bK3YrYZZIEf7+05VBOrpJvCimJmAG5ZVyaIH3eHdrHZiXp5tIHZIO3LKGlMM92vRDkEaOMujPEd/m2eDdlbZaBOyGJfsnnYu8YK3JiEDhF4hmV6z01tOxDjeHX6U2IZAqb2T5YI1ZdH3qTZaPgUA4lTVZcqI6ZQGjxbvMKGEi4k/GgVigKs++KkHoWNkdHVzUq9RIaSy42lICB5hpJdPYJZ0Z6YJ1nAJPbg45moK4P7/UPVuTCvU5KXUqowuAtu6jWDAaii4P9U4XsuN94jbzyaPckGrgJUyeG3IFJAghk4WzQ5aTZRR5eH88N7e09fFfr1xKzR0isDIgal/8gMY3Ar1i/+VvlrI6mUsGd8CenLYp6VudeZjyi8y0hPUT80FIK78qZ3eIV8b4KNG4Bys9yh3Ebj0OtStVgHZrHKMOs88BS++jiGXgzYhoS35U6nPs= x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PH7PR11MB6451.namprd11.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(376002)(39860400002)(346002)(366004)(396003)(136003)(230922051799003)(230273577357003)(1800799012)(186009)(64100799003)(451199024)(36756003)(38070700009)(53546011)(478600001)(76116006)(66946007)(26005)(91956017)(6506007)(66476007)(71200400001)(5660300002)(64756008)(8676002)(8936002)(4326008)(6916009)(66446008)(6512007)(6486002)(66556008)(966005)(54906003)(316002)(41300700001)(86362001)(31696002)(38100700002)(122000001)(2616005)(83380400001)(2906002)(31686004);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?utf-8?B?YXdPR2YwNDNpc0E0STlLdWoyT1UrR1dEQ1JzVXBKVHFnZzFWRXluTVdEWWwy?= =?utf-8?B?cVYxWVBJMUJkWnVMeEdLZEEzMzdnVzJzRnRURGZCTXB1SzAyc3RTbXM5eFor?= =?utf-8?B?SWpvakM3dWFOZitld3NKeXlmYmlNL2UvVGs2NlNLQlY0Vi9qUks4RHBpZ0Nr?= =?utf-8?B?WEpjUzNmeU52OHhiSWx2cGJjQlFQRjFlNndwU2JkbVVFenZMclgwclV0bnh4?= =?utf-8?B?RlZXdm5xRjg3ZmZIODlGcWZMUzNaUHBaWUxBRjg5M2FMaEdhb2IvQ25nZkY4?= =?utf-8?B?NFF5V2NMaU5wbm9YRmtZaDhTT0dzaVB3cEp1WUYrRGJ5SG5rLzA2RUdSb3Rq?= =?utf-8?B?Z3draEQ2R2pzOWdMVFZ5QXhwOG1yaEdDMkRrYmswVjZwVEswNGxEVC9Eem1Y?= =?utf-8?B?ZGN6bTVnWDYwcGNDUHJVT0lROEdyNEdoOXBBL2ZYOHpCUURnaitOZlhTUjVO?= =?utf-8?B?TUMyQ0RxZjkwRHZzSUNlRXI5UGdzSi85MWN6MGx6SGsvY3A2MUVlTUhOZ1ZM?= =?utf-8?B?aWxmd1VyRC9uZ1RucmZhWjF3L2g0S2h5Zm83SU5PODVibVdhS21NVm1sajd1?= =?utf-8?B?K3hJeHRJSVVrSksvSHlUQStvUktDU1JDRXh5ZjZqS1dzNFd5Vk0xeVNBcU9j?= =?utf-8?B?My9NdVhlRC9uVXpseGJMNmt3S3hZTkxvcmF4NnhZR1BjOXNDNHJWNE5VSHZz?= =?utf-8?B?a1g5a3RvK0g2UDJiQk5XSk51UFdNcHFxcDVlLzRKU2NGeVV0RlUvSi9Qalln?= =?utf-8?B?UUtoRXNMMHNUVUdkQzBrcW1nV1ROanY5MVNIRVJqSEYwamc2OENheHUycWoz?= =?utf-8?B?UC9PUFJnc3RLUEFXQkVyek5JV29WcmFncFcyWkFsdDNtOUw2K1FRMm1rNlhs?= =?utf-8?B?SG5rSXUwOVlmRW5JdnNqVWFTTEhiazQ0TUJWcS9MeVNXamtGOFVBVU56NlpK?= =?utf-8?B?eFVVdjVJaks0NnJ4TEJPNlJQNXR2clNKTVYxUnRycDJ3ajNBNFlxQkZpYnZL?= =?utf-8?B?Nnd6N2ZiZVQzdEpxQkhFcVQ4YWtCUjdpc2xkaE9XQWJMOSsyZ2V2VU9EcXBR?= =?utf-8?B?WVBxSmswNjVmdk9icmlrVENoL3JRYi93bXd4cWhXVFRkNXRRWHpDN0h6eVJT?= =?utf-8?B?NUhLT3NJeENVcDg0aTZUQ0JwdVhPeFFMUldmN2tQVHluNHFCbUdtNGJLWG15?= =?utf-8?B?RUFzeExDKzlvdWJWbkt0QnVKSGRMdEpKdXN4bXVrR1B6MDJjb0hndjh4SEdp?= =?utf-8?B?REhUU3VqUDEyRzF0Skt6TEdwbE9mWThqdUpLRjMwNS85SWcrNEpPZlRUdnZS?= =?utf-8?B?MlpCWE9rUkhJNmxXZUQ3QllkU01DVUMwUjFTbFQvMmhuMnlTbFUwYmk1QVdo?= =?utf-8?B?Uy9aMXR3ODNGbjAvVlJSTnFuWHROb1RaN3oyeHVQalFrYXFNMDlCakdPWHpI?= =?utf-8?B?VCtaMHZuRk1DSEZLSGRCQXBTNS9zRDlxNXV0Q0x1VUptQXd6YzZJTitTL1ZL?= =?utf-8?B?RHUzL0J1UkQ1Zm5MUFRUQkc5L0xRSGpLRThwZGlZeWZrSDdsSzJKczNldlBE?= =?utf-8?B?ZFVDOVZNT3lVMy9rTFRTRkRnTlF6bVBvQ3VKVXIwR2liSkdKdFhPUzlzYjIz?= =?utf-8?B?ZDRHSHVrZUcyd0MwclZrSXF2bkduQmxCYVBxZDVqMWpDeCsrMWdKUXordS9Z?= =?utf-8?B?eUgzTjAzMHpUSkdId3FjM3QxVVNxSGNhZDZVWEdmRlcxSmNGaGFtcEhxWEZw?= =?utf-8?B?THIyVVUyN1VBR1loSlgyd0RrdWVDUkVIZ2ZqaXQxdVZMWC92bDhBR3Fhb0o5?= =?utf-8?B?V1ZMa3FvQ1MxNFFWL3lMUHZDVzkza1hnRS9hZEN6SUpSa09qbXB3dTNONytT?= =?utf-8?B?djFSdUxxaVpnTHhFWEpoTk9SQkE5VjBrTnRuRGlBdVZZTytVVytBdHdGeXZz?= =?utf-8?B?d2RKenloMjhhMjJKWExocU54ajNoeXgzWWhQOXVvZGpCVUN5MlBPanFubFVt?= =?utf-8?B?cFZRMSt1RVExcDBuQTIzQXRUK09WZS90bzgxQzRvenBueTJjVUdwQWVIenlr?= =?utf-8?B?akpVZldyY0EzRllRSm5XeEtORmNOeDl6ZUV4TStvMG5RRkxqT1VIOEhZclMx?= =?utf-8?Q?rBVtTA7mxK2ns71RxunRGxQP+?= Content-ID: <4A5811C979255E47A65A451AF046B8B9@namprd11.prod.outlook.com> MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: PH7PR11MB6451.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: f4fd6f4c-c4ab-4a02-91da-08dc2c4b8c07 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Feb 2024 04:23:36.2842 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 3f4057f3-b418-4d4e-ba84-d55b4e897d88 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: yF4h1wCYmrfZA5PNneZWRZ+fM41eG4/359u9eiCdHE+pVPNxpdxaPkIHKfBPOALEpE47DKwvkTroH1LcLYSeyg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: PH0PR11MB5901 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20240212_202347_704949_623DCB65 X-CRM114-Status: GOOD ( 19.56 ) 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: , Cc: conor+dt@kernel.org, devicetree@vger.kernel.org, alexandre.belloni@bootlin.com, linux-kernel@vger.kernel.org, claudiu.beznea@tuxon.dev, krzysztof.kozlowski+dt@linaro.org, tglx@linutronix.de, linux-arm-kernel@lists.infradead.org Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org Hi Rob, On 12/02/24 7:38 pm, Rob Herring wrote: > EXTERNAL EMAIL: Do not click links or open attachments unless you know the content is safe > > On Fri, Feb 09, 2024 at 03:31:22PM +0530, Dharma Balasubiramani wrote: >> Convert the Atmel AIC binding document to DT schema format using >> json-schema. >> >> Signed-off-by: Dharma Balasubiramani >> --- >> Changelog >> v1 -> v2 >> - Drop the '|' as there is no formatting to preserve. >> - Remove unnecessary marketing statement from description. >> - Drop the description for interrupts and reg, it's obvious. >> - Put reg after compatible. >> - Drop comment in example. >> - Drop the example of device that is wired to an AIC as it's(dma) binding is >> not yet available. >> --- >> .../interrupt-controller/atmel,aic.txt | 43 ----------- >> .../interrupt-controller/atmel,aic.yaml | 74 +++++++++++++++++++ >> 2 files changed, 74 insertions(+), 43 deletions(-) >> delete mode 100644 Documentation/devicetree/bindings/interrupt-controller/atmel,aic.txt >> create mode 100644 Documentation/devicetree/bindings/interrupt-controller/atmel,aic.yaml >> >> diff --git a/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.txt b/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.txt >> deleted file mode 100644 >> index 7079d44bf3ba..000000000000 >> --- a/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.txt >> +++ /dev/null >> @@ -1,43 +0,0 @@ >> -* Advanced Interrupt Controller (AIC) >> - >> -Required properties: >> -- compatible: Should be: >> - - "atmel,-aic" where can be "at91rm9200", "sama5d2", >> - "sama5d3" or "sama5d4" >> - - "microchip,-aic" where can be "sam9x60" >> - >> -- interrupt-controller: Identifies the node as an interrupt controller. >> -- #interrupt-cells: The number of cells to define the interrupts. It should be 3. >> - The first cell is the IRQ number (aka "Peripheral IDentifier" on datasheet). >> - The second cell is used to specify flags: >> - bits[3:0] trigger type and level flags: >> - 1 = low-to-high edge triggered. >> - 2 = high-to-low edge triggered. >> - 4 = active high level-sensitive. >> - 8 = active low level-sensitive. >> - Valid combinations are 1, 2, 3, 4, 8. >> - Default flag for internal sources should be set to 4 (active high). >> - The third cell is used to specify the irq priority from 0 (lowest) to 7 >> - (highest). >> -- reg: Should contain AIC registers location and length >> -- atmel,external-irqs: u32 array of external irqs. >> - >> -Examples: >> - /* >> - * AIC >> - */ >> - aic: interrupt-controller@fffff000 { >> - compatible = "atmel,at91rm9200-aic"; >> - interrupt-controller; >> - #interrupt-cells = <3>; >> - reg = <0xfffff000 0x200>; >> - }; >> - >> - /* >> - * An interrupt generating device that is wired to an AIC. >> - */ >> - dma: dma-controller@ffffec00 { >> - compatible = "atmel,at91sam9g45-dma"; >> - reg = <0xffffec00 0x200>; >> - interrupts = <21 4 5>; >> - }; >> diff --git a/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.yaml b/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.yaml >> new file mode 100644 >> index 000000000000..df81115a8b7f >> --- /dev/null >> +++ b/Documentation/devicetree/bindings/interrupt-controller/atmel,aic.yaml >> @@ -0,0 +1,74 @@ >> +# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) >> +%YAML 1.2 >> +--- >> +$id: http://devicetree.org/schemas/interrupt-controller/atmel,aic.yaml# >> +$schema: http://devicetree.org/meta-schemas/core.yaml# >> + >> +title: Advanced Interrupt Controller (AIC) >> + >> +maintainers: >> + - Nicolas Ferre >> + - Dharma balasubiramani >> + >> +description: >> + The Advanced Interrupt Controller (AIC) is an 8-level priority, individually >> + maskable, vectored interrupt controller providing handling of up to one >> + hundred and twenty-eight interrupt sources. >> + >> +allOf: >> + - $ref: /schemas/interrupt-controller.yaml# >> + >> +properties: >> + compatible: >> + enum: >> + - atmel,at91rm9200-aic >> + - atmel,sama5d2-aic >> + - atmel,sama5d3-aic >> + - atmel,sama5d4-aic >> + - microchip,sam9x60-aic >> + >> + reg: >> + maxItems: 1 >> + >> + interrupt-controller: true >> + >> + "#interrupt-cells": >> + const: 3 >> + description: | >> + The 1st cell is the IRQ number (Peripheral IDentifier on datasheet). >> + The 2nd cell specifies flags: >> + bits[3:0] trigger type and level flags: >> + 1 = low-to-high edge triggered. >> + 2 = high-to-low edge triggered. >> + 4 = active high level-sensitive. >> + 8 = active low level-sensitive. >> + Valid combinations: 1, 2, 3, 4, 8. >> + Default for internal sources: 4 (active high). >> + The 3rd cell specifies irq priority from 0 (lowest) to 7 (highest). >> + >> + interrupts: >> + maxItems: 1 >> + >> + atmel,external-irqs: >> + $ref: /schemas/types.yaml#/definitions/uint32-array >> + description: u32 array of external irqs. > > Constraints on the array size and/or entry values? The hardware's support for external IRQs may differ, which is why a u32 array is utilized. This choice is based on the fact that IRQ numbers are commonly expressed as integers, and a 32-bit unsigned integer provides a standardized size capable of representing a broad range of numbers. This size is more than adequate for accommodating IRQ numbering. > >> + >> +required: >> + - compatible >> + - reg >> + - interrupt-controller >> + - "#interrupt-cells" >> + - atmel,external-irqs >> + >> +unevaluatedProperties: false >> + >> +examples: >> + - | >> + interrupt-controller@fffff000 { >> + compatible = "atmel,at91rm9200-aic"; >> + interrupt-controller; >> + #interrupt-cells = <3>; >> + reg = <0xfffff000 0x200>; >> + atmel,external-irqs = <31>; >> + }; >> +... >> >> base-commit: 0dd3ee31125508cd67f7e7172247f05b7fd1753a >> -- >> 2.25.1 >> -- With Best Regards, Dharma B. _______________________________________________ linux-arm-kernel mailing list linux-arm-kernel@lists.infradead.org http://lists.infradead.org/mailman/listinfo/linux-arm-kernel