From patchwork Thu Nov 10 08:57:27 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Oleksii Moisieiev X-Patchwork-Id: 18020 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp28875wru; Thu, 10 Nov 2022 00:58:51 -0800 (PST) X-Google-Smtp-Source: AMsMyM5/Adwr4RhCJ1M/Y4gqOkasogoCN8YgMPKSjJJeWmDHZkgQnGXHYMSWDE6J4LyP+raUqNmu X-Received: by 2002:a05:6a00:c8f:b0:56d:70ca:fec3 with SMTP id a15-20020a056a000c8f00b0056d70cafec3mr55800728pfv.50.1668070731254; Thu, 10 Nov 2022 00:58:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1668070731; cv=pass; d=google.com; s=arc-20160816; b=z8GJqN/wg8SVLmIwNwQe4EHWPbNStym4PRk9eMR1ZTmGwdl/52CSDtnDpZUq4L3Daz CI66dWndsqPQ3eXxhERBH3ibn7OgJRJr+Ezu69jzD4vdTS6j+iDsiqrsrqEuBXC1b7A3 UAlhY5E5Pz/Kz9w4rIKW+hYD8f4/rsYTlbrdvfz4+BlefywK4+eQUss3D46GDvrbr9+u +GDM13LsDC1vHYuMWiX2Kyth1jEFt3HbZQbjt6xxAyy5XDNZ67C6MVl7SGXw+52qkINl sYJQI8rEoXLMdbY1uUUK1f42E/SZILKBUsNk3D49vQ4AVqXo90z2b57dg8VlNoTs4AyV UUeA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :content-language:accept-language:in-reply-to:references:message-id :date:thread-index:thread-topic:subject:cc:to:from:dkim-signature; bh=gISmrocsyx+RrUwOu+W6m/pLDZQZ1ZADokv3gjt4T2E=; b=Fxj6sWQ0svv8G/AQ9mmDoNNuQDpN2uCGzVpev0XEcEr3MlCwo68ghrUZqLhMEZP3fl 8jSDikMgx96GkHdFU4VrK4cu/CT2CiRIO4RTgOFbf2cET7jm21jUN9iO0QvbIbWMaPE3 z3YEN2TjbqzaBKUMqQL74hiZ1Y/a9QwxFkpcsFn1NkTnvitHf/xHd114lKMa2JIAEZiF M+s7Ntv95dikM8NxCBRVyS1yCpMrw7kXZNvOyJxtW8LfDy6+I/W/w3Ky6ROrTO49vCyB cxM96/JrIyqeuELEUFaXfRQu7RqOdpvW1FIjnDU3tdMppd+Cpo13kqSjtz3X/Gi/SXjq EQ9Q== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@epam.com header.s=selector2 header.b=nKzTx1cg; arc=pass (i=1 spf=pass spfdomain=epam.com dkim=pass dkdomain=epam.com dmarc=pass fromdomain=epam.com); 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=epam.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id p10-20020a170902eaca00b00176b3c7d158si18697211pld.99.2022.11.10.00.58.35; Thu, 10 Nov 2022 00:58:51 -0800 (PST) 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=@epam.com header.s=selector2 header.b=nKzTx1cg; arc=pass (i=1 spf=pass spfdomain=epam.com dkim=pass dkdomain=epam.com dmarc=pass fromdomain=epam.com); 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=epam.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229518AbiKJI6H (ORCPT + 99 others); Thu, 10 Nov 2022 03:58:07 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34602 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229463AbiKJI6F (ORCPT ); Thu, 10 Nov 2022 03:58:05 -0500 Received: from mx0b-0039f301.pphosted.com (mx0b-0039f301.pphosted.com [148.163.137.242]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B21B167F74; Thu, 10 Nov 2022 00:58:03 -0800 (PST) Received: from pps.filterd (m0174680.ppops.net [127.0.0.1]) by mx0b-0039f301.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 2AA8XZIN005288; Thu, 10 Nov 2022 08:57:31 GMT Received: from eur05-am6-obe.outbound.protection.outlook.com (mail-am6eur05lp2106.outbound.protection.outlook.com [104.47.18.106]) by mx0b-0039f301.pphosted.com (PPS) with ESMTPS id 3krwuag33q-2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 10 Nov 2022 08:57:31 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EdPXTqp4N9d54KYTDO5vc1H3pd1D/6ORvaxtp5PW8nI0Bm3fQCqFimKr9mvY74XlFzkQ6e3yoT4K1ghO7wT+3QwdlQThRYYon3KIwhEt3e/l3kG45Wu4onjv/VJgEvmL+Y3vaIFN8mQqzsyF83AG3BIQtr6Fggm+0rWYdiwCY/yZEZQZ69wPUvEQi68yYURJG3KQqWogFYnFh9X816eZbcR7rXcHyVksea0PCumN3shw21yRSLY7fHQAFiR0dev110BRKW4LBmgBquXgnWdf3z+LaA7JigMUl+HqRoQ1/chwmPUFOa32msKDXmGrG7f2r/Jtsk2yw/MS18pr1yQf7g== 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=gISmrocsyx+RrUwOu+W6m/pLDZQZ1ZADokv3gjt4T2E=; b=GTy9l12ZgtpvflfyddR6hKAQwr1oP6FA4GVaFgRAdwcIUqyOu5aCxsVARb0kL5rQ/pfKjW7a1A1JWCH09miXendVlL5Pw6ChaDARORHMQSAk1e1cEzAdzFlXpGJhfw+j3Z5t55AIrHL1dIzdslFxGioijzRNb+QtAUxBiyH0KDpqQ+sdh/d82bl/VTCXhdpHq+ol3WwV4jRfZchnKQqoJD9A+6A5NzTq6zfhqNwmCGKnOa0gZ8Y8AyFvUdMZ41C66Wts25bzD5mh6d5G7nNI7TmZ7JEIEJqfay6qTfmNEOEDNn9nQ+FXhctuD7Y1S3h2B84Aun5MdHCaGuhTievggQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=epam.com; dmarc=pass action=none header.from=epam.com; dkim=pass header.d=epam.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=epam.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=gISmrocsyx+RrUwOu+W6m/pLDZQZ1ZADokv3gjt4T2E=; b=nKzTx1cg8EI+ZPQZooLcvMQEse3q4HkOgNbYwkbZUgFTlqWWC1xdwKw5nXGSdLM62EHXhvMSonBpvdcdR0pc70Q3wD9/TFhElyz/8DJbOoW02MulQ2y8+J9MvpXAXnOpAF+det2Eg/2ublMZotCBZwXV02Vpzibm31ZvQihLkezkipJw13RmJOYYNblR+cvl/PpSbgFiGqeGNZBblrxxhwXX9oxCxQvgBp95PVCrPZSw86wfcZGfpNNUukMim1pwH256ZVALEhwjz/bDgnvLznhF6WFLiI0ptXd0HGloZ9C369x8BnY8eLDpCVIaNDr1+hWYiVA0audFZ1+Os4DUqg== Received: from PA4PR03MB7136.eurprd03.prod.outlook.com (2603:10a6:102:ea::23) by AS8PR03MB6822.eurprd03.prod.outlook.com (2603:10a6:20b:295::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.22; Thu, 10 Nov 2022 08:57:28 +0000 Received: from PA4PR03MB7136.eurprd03.prod.outlook.com ([fe80::cc80:5238:61b7:43c4]) by PA4PR03MB7136.eurprd03.prod.outlook.com ([fe80::cc80:5238:61b7:43c4%5]) with mapi id 15.20.5791.027; Thu, 10 Nov 2022 08:57:27 +0000 From: Oleksii Moisieiev To: "robh+dt@kernel.org" CC: Oleksii Moisieiev , "mcoquelin.stm32@gmail.com" , "alexandre.torgue@st.com" , "linus.walleij@linaro.org" , "gregkh@linuxfoundation.org" , "devicetree@vger.kernel.org" , "tomase@xilinx.com" , "benjamin.gaignard@st.com" , "broonie@kernel.org" , "arnd@arndb.de" , "shawnguo@kernel.org" , "fabio.estevam@nxp.com" , "loic.pallardy@st.com" , "mark.rutland@arm.com" , Sudeep Holla , Cristian Marussi , Stefano Stabellini , "a.fatoum@pengutronix.de" , "peng.fan@oss.nxp.com" , "linux-kernel@vger.kernel.org" , Krzysztof Kozlowski , "linux-arm-kernel@lists.infradead.org" Subject: [PATCH v6 1/2] dt-bindings: Update scmi node description Thread-Topic: [PATCH v6 1/2] dt-bindings: Update scmi node description Thread-Index: AQHY9OJ15svHVoFEaUSVCL2S/1sqYw== Date: Thu, 10 Nov 2022 08:57:27 +0000 Message-ID: References: In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: PA4PR03MB7136:EE_|AS8PR03MB6822:EE_ x-ms-office365-filtering-correlation-id: 3a694cf2-63a2-4a78-3e4f-08dac2f99800 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: KXOZQgIlKF8/nVbG2ap3Jajp9AaAmYbBW2lM5ON/zK+/t9mRjuvw5Z9K1ddPK/PxQtuxjaJZc24G+9yMb/rsH0qQ5uPT0swZVgKkB+wb2bF3/6Yc2aLGEUHi2ov3XOlv4Dpd/Nt01B/rufuQkYXsfEA3k3re0DvWn3RuPuj3Q/iqEbTx/oYD0qsVECc5Z1QfoUwdRL2iTnn2QOsm8CiiEeGQ2MtgKHsHigSFCPb8sHaLx+ZvJKesDP5+jK0lNSpbJx0Reob80frCH2KpfaZMs9xQmlm3PLuecEv1nG59NsRRdZ6Dv3JFzdpDsqhm77sRhH/RKUxglF54U7VDNPM+O/6U3z9G2YioGX/ea96UGnIE5Oz/ug75OZZanJtMm4GDIwHSiHxPDEyIF/7IfyrOXxt9NU2gIKt+sdg7OqSt0OP9885h0f4WytO1oDc1U+MtaqPVT8WrUt3X6rEhMeqn5DK28eyhYpYT5XNo89eB1XVllHT6+OV6MKvc3FN4uca8Q5SzakejzwKEcyfGl7YHRou82BZFG1bsqaLiZq7HNsEhFMXGh0cl660o9z3RoLqHU4TEKF9DLG1yA4sSsvnGkn9a/NrJxqFaWsEVZNtD5PyjXmV+s2+KxBWxwK8NUcjpirlwuOcTM5g5MyTpMvU0sl92Q84rgpLT/vXT3opiLXv5CgZ5h078TXsYwoiYSiSzR78M1PExUlQ/mOdZ8HtKuObXYZZlH/fJ/uYfNf6YqSLYrXjojAJR1RBpY2d6OlfiO0/3GtndzjROvy5I6oAAsu9gdxZu3JZv2LvCWgkIgz8= x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PA4PR03MB7136.eurprd03.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(4636009)(366004)(39860400002)(136003)(346002)(396003)(376002)(451199015)(86362001)(38070700005)(36756003)(15650500001)(7416002)(2906002)(2616005)(6506007)(6512007)(26005)(83380400001)(186003)(5660300002)(38100700002)(122000001)(91956017)(66946007)(66476007)(76116006)(316002)(66446008)(64756008)(66556008)(8936002)(71200400001)(54906003)(4326008)(478600001)(6486002)(8676002)(41300700001)(966005);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?q?ifduplF3GvsiZRYDdpe4nU9?= =?iso-8859-1?q?sq1L2UUD2ZX6kL1h5I8XVGY0LnzdHVmej0PCsx6a2q9a0Xem/IGJBgrnQGte?= =?iso-8859-1?q?zgw6V/EmUWtYeTwVqfS7i3u3zpWw59fabEPiPbXl2SisRXc7lL4qf9q6jKut?= =?iso-8859-1?q?3ldK8hIwyuCuQrZLySS/4WkcseJUUUBDavXlc67+F+5074C8Ou9CWgQpDxCQ?= =?iso-8859-1?q?hrMYmkG1DJW1xe8IxYtnUpzxFzCfpUBuezSTIiaBbfypT8//fEOl4Ket4y+m?= =?iso-8859-1?q?SWxtDrIoNgZPTLuKNvV0YUty7eNnEGWd89iL1zrZ0tSAx6pcSwKwsBel7Mv3?= =?iso-8859-1?q?md2aYMVfHeWgYEmZxd/lTylYelTpjAHqd5vQMIUiH77iT1bzFSf1m9fD9tpb?= =?iso-8859-1?q?FXGKQyEVxwHvtzA1ByAOrvD8AXk42EwoWz1U9KC15uVL9JuxrKFZQSvUcKMo?= =?iso-8859-1?q?RO9lmOXk0DjWMEYKyhvBQTLEGhh2iY7HtLtSRKOZ+7T+nev+iZu4Wj2sMNuP?= =?iso-8859-1?q?FUn19m7oOaEQHVU1Afx+PctwwYh3woOr1AUiPRZkp+QwpkUfRIDz+petuKkE?= =?iso-8859-1?q?5BbPZkIkvePZlyY6cdvlvPpmxv8/0hSeyuNegrn7BkF4R1vhH2ModM+iKvcX?= =?iso-8859-1?q?EkX9dW1eluxmldtIqWnElPSHL8sxxH86bJgdDcqgsPLi7eYadDIIORxrYFQ/?= =?iso-8859-1?q?7KDKzn4IAQ9S/6t4e70mR6YhcYoe79VOFnsNmlDpHakPWhVRvml+U/7pnuNX?= =?iso-8859-1?q?7rFA+EdjqQLRPa1gLKPynXN9/CDuHWVbgwAd7rCTRwfYrL527WjjclgLJypW?= =?iso-8859-1?q?2gq8rkt7omDmjOAAn7tXpAHDaXYW5CWwqqUX8Mpk7Ac/5ZGVPkNCpoqEY8sv?= =?iso-8859-1?q?wGcy13kMNu68LZthPZhwbr3RPryTTbYqjD/gqEjUIRvrXA8eu6m+xRZPxDhM?= =?iso-8859-1?q?PXaNWIIsdgUlMdh6nWlXcBqD60pq3PuOnxsXZ3epshNrlac+WVb9sdKZcjfC?= =?iso-8859-1?q?oieOaR6cxKMLdQby0PkMll7l+/ngmWhBKIY3rrWTosIHt+h/pUX+RkqlXZGN?= =?iso-8859-1?q?mEhvAkps+cRtypIoOvI4KuZyb+CYAW6LYCm2jUpBnEJ5On4E4VszmKXq63aV?= =?iso-8859-1?q?2jtBFuyG8Z6A76R1nfAKydJjqI0sJwlTarvNQcOXdSNTPh+WkioEsJZcWY1O?= =?iso-8859-1?q?+9PauD9LiBKNgcGsjVQdO31Ql69/+91vg7yiRmRwUI8DLH4REATOec1Ipko0?= =?iso-8859-1?q?U1CBaXorAB9PJVpUPWxvLZDLAyfQoEcZMiHCV24P9dagAnogTAq7SYj4XEY+?= =?iso-8859-1?q?lyLaBLHNrCPwuiwky7dJbrtBAxEYmOcYbCL75fU2h1so0Aq7/Co9pXOh8FnY?= =?iso-8859-1?q?Sh2Gxr9tQhe4GB6+sSkxUYSLx86FIv5RF4clzA8/Rle6s7lFDn5E4kqZuDg3?= =?iso-8859-1?q?tXelCggtskiZSCyYVnYijgUU1XC5qAsQhi//XVWQs2APFUBKXxHOH0cq/ASR?= =?iso-8859-1?q?jnu5+avqWJD3IzXK/AXBWbpQY8DkiT7i+3lhmoy/egGsO5ymaqy3ITkRR1cH?= =?iso-8859-1?q?ilCdU/qn8ssvCCk9WmDHT2PLdWl4wyzil/zvOwNLIEXOBUJaLNitcXrp+sAW?= =?iso-8859-1?q?1gGYNzybvpbNXU+suvyVW/TXpnqQ48DQoC5WGWw=3D=3D?= MIME-Version: 1.0 X-OriginatorOrg: epam.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: PA4PR03MB7136.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3a694cf2-63a2-4a78-3e4f-08dac2f99800 X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Nov 2022 08:57:27.8832 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: b41b72d0-4e9f-4c26-8a69-f949f367c91d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 4NcVCs70c7DAVkbS1NigG5S3maJh79p5gjjUgplmmrxux0fwkQt2tjD4gJ8bh97Y4BKmVFuA3DY0BZFH80Q8kpWAOrYHjiki842qrUjlGUw= X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR03MB6822 X-Proofpoint-GUID: Jsq7WKiAmo6uIcjz5QTsSjckB6WOW7HF X-Proofpoint-ORIG-GUID: Jsq7WKiAmo6uIcjz5QTsSjckB6WOW7HF X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.895,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-11-10_07,2022-11-09_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 malwarescore=0 impostorscore=0 adultscore=0 mlxscore=0 priorityscore=1501 bulkscore=0 phishscore=0 spamscore=0 clxscore=1015 mlxlogscore=933 lowpriorityscore=0 suspectscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2211100067 X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE, SPF_NONE 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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749098935010751427?= X-GMAIL-MSGID: =?utf-8?q?1749098935010751427?= Add '#feature-domain-cells' property description to the scmi node. This property makes scmi node as feature-domain-controller provider, which allows consumers to provide scmi node with the device_ids of the devices, which are using scmi protocols to control clocks/resets/power-domains etc. The device_ids could be used to set the device permissions for the Firmware using BASE_SET_DEVICE_PERMISSIONS message (see 4.2.2.10 of [0]). Device permissions management described in DEN 0056, Section 4.2.2.10 [0]. For SCMI this property is used by Trusted Agent to set the device permissions for the Non-Trusted Agents. Trusted and non-trusted Agent terms described in Section 4.1.1 [0]. [0] https://developer.arm.com/documentation/den0056/latest Signed-off-by: Oleksii Moisieiev --- Changes v1 -> V2: - update parameter name, made it xen-specific - add xen vendor bindings Changes V2 -> V3: - update parameter name, make it generic - update parameter format, add link to controller - do not include xen vendor bindings as already upstreamed Changes V3 -> V4: - introduce domain controller provider/consumer device tree bindings - making scmi node to act as domain controller provider when the device permissions should be configured Changes V4 -> V5: - rename domain-controller to feature-domain-controller - feature-domains format fixes Changes V5 -> V6: - formatting fixes --- .../bindings/firmware/arm,scmi.yaml | 28 +++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml index 1c0388da6721..bb5aa49e88fd 100644 --- a/Documentation/devicetree/bindings/firmware/arm,scmi.yaml +++ b/Documentation/devicetree/bindings/firmware/arm,scmi.yaml @@ -89,6 +89,16 @@ properties: atomic mode of operation, even if requested. default: 0 + '#feature-domain-cells': + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Number of cells in a domain controller specifier. + Set const to 1 here for nodes providing the device id, needed for + the BASE_SET_DEVICE_PERMISSIONS message (see 4.2.2.10 of [0]). + const: 1 + + feature-domain-controller: true + arm,smc-id: $ref: /schemas/types.yaml#/definitions/uint32 description: @@ -429,4 +439,22 @@ examples: }; }; + - | + firmware { + scmi_link: scmi { + compatible = "arm,scmi-smc"; + shmem = <&cpu_scp_lpri0 &cpu_scp_lpri1>; + arm,smc-id = <0xc3000001>; + + #address-cells = <1>; + #size-cells = <0>; + feature-domain-controller; + #feature-domain-cells = <1>; + }; + }; + + foo@0 { + reg = <0x0 0x10>; + feature-domains = <&scmi_link 1>; + }; ... From patchwork Thu Nov 10 08:57:28 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Oleksii Moisieiev X-Patchwork-Id: 18019 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:6687:0:0:0:0:0 with SMTP id l7csp28877wru; Thu, 10 Nov 2022 00:58:51 -0800 (PST) X-Google-Smtp-Source: AMsMyM4y95ODs3CuWcTy/H8e89V9PtvfBm5gtYzMCaVRDN06x5dNK21YdiBRUb/O8Q/wZL1YMYiH X-Received: by 2002:a17:903:404c:b0:188:602b:5a24 with SMTP id n12-20020a170903404c00b00188602b5a24mr34300389pla.105.1668070731460; Thu, 10 Nov 2022 00:58:51 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1668070731; cv=pass; d=google.com; s=arc-20160816; b=EkVere/4fMPXkW3d8/szZVvwsIw4BFSleuPLmFV+2rCRtWqpgPWElg1Df8BWx5v44c hJAJdezoGz5o6MODI0YR4Ztu/DaMsWVedVSnZpt+pkaYnusZgxKZjizyL3Z2l6hgk2jF b73z8mwusu+w0mfEnDVgFHLKIBS/s3pSnY8x2lS25mj9EJQnOQG6hYaddYizg9NcFbGX iDsJYxWANhUd/pZUlyFodGhDBw8p0xSveh5PMstiMToJ3bFz7JVKm9fRJpPJTBghp5g8 6XNSX4+TngYKqt5cVVzmKPm9UFmbedtNg9Vv1nOtZoSLPCjVmc5tYu28O6pgHP/yv3+W xknQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:mime-version:content-transfer-encoding :content-language:accept-language:in-reply-to:references:message-id :date:thread-index:thread-topic:subject:cc:to:from:dkim-signature; bh=wcW+NVVeeduweYjZD7yPr4NghgcLnJ3t8K40X7/1iW4=; b=0BIjUNd69utcFmxuH+fDG1b53YfWc3Zzy/Sl1USsLcwlF6tKFPSVD+KSqrW346hZYq SVbzDY5u/scXGZhruVAzGnBkiIlVf81Mwi17qgPEvDZHNO+BTtnZptNBNRZVCqGB7IcU Ln1fHYTBLiaVB46H1TtutO1GJ35hxJJX2IKP78wxY4R944pcxaTUYXCJiytKM2tq7/YZ T4tGtg0OZUB3Wuyiu6aLSMvMy3QmGrZLV4UoN2tKR7nKyGceSgHQmJoX9cxvF+TvwyOB PG7wgNxG9lb9+yYOIM/1gwOBSfYtICAM2/4c6yhqV/3oms/qcVQM17HOT+Y7aR6NVYhj dhxA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@epam.com header.s=selector2 header.b=XURzts98; arc=pass (i=1 spf=pass spfdomain=epam.com dkim=pass dkdomain=epam.com dmarc=pass fromdomain=epam.com); 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=epam.com Received: from out1.vger.email (out1.vger.email. [2620:137:e000::1:20]) by mx.google.com with ESMTP id i17-20020a170902c95100b00176806795b7si22489999pla.351.2022.11.10.00.58.37; Thu, 10 Nov 2022 00:58:51 -0800 (PST) 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=@epam.com header.s=selector2 header.b=XURzts98; arc=pass (i=1 spf=pass spfdomain=epam.com dkim=pass dkdomain=epam.com dmarc=pass fromdomain=epam.com); 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=epam.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229552AbiKJI6L (ORCPT + 99 others); Thu, 10 Nov 2022 03:58:11 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:34604 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229454AbiKJI6F (ORCPT ); Thu, 10 Nov 2022 03:58:05 -0500 Received: from mx0b-0039f301.pphosted.com (mx0b-0039f301.pphosted.com [148.163.137.242]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B20D1657D9; Thu, 10 Nov 2022 00:58:03 -0800 (PST) Received: from pps.filterd (m0174683.ppops.net [127.0.0.1]) by mx0b-0039f301.pphosted.com (8.17.1.5/8.17.1.5) with ESMTP id 2AA8XalP019576; Thu, 10 Nov 2022 08:57:33 GMT Received: from eur05-am6-obe.outbound.protection.outlook.com (mail-am6eur05lp2110.outbound.protection.outlook.com [104.47.18.110]) by mx0b-0039f301.pphosted.com (PPS) with ESMTPS id 3kr9d73vht-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Thu, 10 Nov 2022 08:57:32 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ONP8oNYlX7Qc+C7cWCywZyw//kvR4/pWqa4O0NMwpAK5reEkGJq2v+idKZLzHbLVi+9JBf520uPAU40Tl9qanUtufp68fAyFxN0NSo74pfZ1MqRs6MxCGP1fhfQZxIW2I3+iV9a//P8ski4K4OyCckYb+Xe9GBgzoH7K+sa9Tg/kFVIapHJLxLonA90Neo9jqwkWP9dqSbjHKb7qRCskL8TTpKgHv2HYAqkg/vICyC2IrRfT1dgOi+UnRCYv26yBffhBL593oj0ebkDpxMqvQKktkvn3wOIn+x525gp3nJFF47mDZr0BjJxrmEMgOwb8h45zRMXJ2EeGWsPW0Dsnjg== 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=wcW+NVVeeduweYjZD7yPr4NghgcLnJ3t8K40X7/1iW4=; b=kOEQk2ibF/Pnuuh4XBImQPqfYi9C1//abi3PmkeUN3JJj49Xf7sR68LYPH0n5XF7nMdIaofG+Z3St11J/puBb4kOoyz9iHSTEMjJ2KOqRO8CxCEx+AtPCnJIigagkE69d/e4yCFlM8SJiZJBRMAjUe7kEbnoDaqRPacp0/i0axTW2Eh7IydmuYTCUkNrrsnyI9ny4iSDvD4A1Ji/JVLpNImp7kMicQbKvA77nGFYgygTJN1K78zGffSuln6Y8EskFmE+J2UL2Gp26WHs8sKEGPc5F7x0GrL2Xn4p246tSZAQbRbC8QbNmlOW/IBSs9lJcr+sGTXN0ECayv4hKRCs9w== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=epam.com; dmarc=pass action=none header.from=epam.com; dkim=pass header.d=epam.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=epam.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=wcW+NVVeeduweYjZD7yPr4NghgcLnJ3t8K40X7/1iW4=; b=XURzts98T8OfOOL6eJKcrqSV+qZJALwTJZ+buxWNp5dnhJgfb6+KpxPArVaZeXw5FYft4tJvhp+GiOxXcwxUsf1LcB1wP4Z0G5+tHA3eViR7Y5VIgTnpg6iGECG1ZX6cjO5WfnVxrFAP2lWe/sE+S6s4d9BJmVTjkY0ieDYYvo4xVHFxR6EtCLYWWHgH3odyoSi9fQ3oh6F3dSGf3lq8V5kOIvJU5nMCEN4md76TZ3NS2gpSjq0s+6FccpnpWy6AgQgvTd1UfXus2YdbdlGW1taONZE5E0e/JGVDeKDDyQhCjqu53eIFcG+Y8R3JOhWTo6xGeU/tUnGg1f2N1n/cpg== Received: from PA4PR03MB7136.eurprd03.prod.outlook.com (2603:10a6:102:ea::23) by AS8PR03MB6822.eurprd03.prod.outlook.com (2603:10a6:20b:295::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5791.22; Thu, 10 Nov 2022 08:57:28 +0000 Received: from PA4PR03MB7136.eurprd03.prod.outlook.com ([fe80::cc80:5238:61b7:43c4]) by PA4PR03MB7136.eurprd03.prod.outlook.com ([fe80::cc80:5238:61b7:43c4%5]) with mapi id 15.20.5791.027; Thu, 10 Nov 2022 08:57:28 +0000 From: Oleksii Moisieiev To: "robh+dt@kernel.org" CC: Oleksii Moisieiev , "mcoquelin.stm32@gmail.com" , "alexandre.torgue@st.com" , "linus.walleij@linaro.org" , "gregkh@linuxfoundation.org" , "devicetree@vger.kernel.org" , "tomase@xilinx.com" , "benjamin.gaignard@st.com" , "broonie@kernel.org" , "arnd@arndb.de" , "shawnguo@kernel.org" , "fabio.estevam@nxp.com" , "loic.pallardy@st.com" , "mark.rutland@arm.com" , Sudeep Holla , Cristian Marussi , Stefano Stabellini , "a.fatoum@pengutronix.de" , "peng.fan@oss.nxp.com" , "linux-kernel@vger.kernel.org" , Krzysztof Kozlowski , "linux-arm-kernel@lists.infradead.org" Subject: [PATCH v6 2/2] dt-bindings: Document common device controller bindings Thread-Topic: [PATCH v6 2/2] dt-bindings: Document common device controller bindings Thread-Index: AQHY9OJ1y3k80CKnGk2nkmUaURfjMw== Date: Thu, 10 Nov 2022 08:57:28 +0000 Message-ID: References: In-Reply-To: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ms-publictraffictype: Email x-ms-traffictypediagnostic: PA4PR03MB7136:EE_|AS8PR03MB6822:EE_ x-ms-office365-filtering-correlation-id: caf65f31-dfe6-45a1-a9c4-08dac2f99872 x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: q1NFtc5qoPCv3+t9vwmxwtnmwb7dw4YurQdeoLPWdJCcNZDLyRXrHFo/kWqK9PGryROoWSd4aUGQKjaP/OvC0jMswkERDyafna4/7nHTihDPdyObQE1wg83oDbx75jlObTDtM82fWY3IbEbo5IovjfopxqU5QEy8h+rMoNFL2Qvz4YDof62/szHLXGZ47uXUXD1LdLnhK50R9mCrI5eHAmaCbdkYEcL/HsSXVf9XnFaWB2TjXKvhzVji/R1MZg7K2org+kYBGfewdZVyC97cRWmZsB/FyEg+ox7pUOjXlM/mabMcBwKjZQ5Lj18kFFtWaJl1Li0K4q8Ci13ye2hr1G45dBrTrlkEIJLQkexRkIfm8k9ZXkGHVM+1ON9xXnqhJigt7uNjpvMUg09lCKudhXau0eYjGV13Q3BWDv+SqH3emx8m1wtpRJmW7OeWZT7KR2QNg8G1bsCv1u1/GvC8HZojx6+aEyRfYvkK9tg9d2Bxq4XFgisewZ2/pQ1vqnUXbs40GtCbTXh8RCWA2xUmePiJPVbE23hPY+4IN6JOHh5DeFeEaG4J3eZPgYIsChcDyDpagsTrhCsvvtp6OTliFJK4RYEIuAaal5Xq0V33lQR/xWY2CgBjlnKVujPZQbmkPeHjX9R5acQ5FjoyuxXqltYZYbJRc12wqWMA8xjf/W4kU7zrm1NyaCf1Z4Qpbt0FZcHSrOZaqKgBTAZiD6Ou9EVSqZ3vhxp8wroMhXE/r1BDVOXVpoBihlSBysvcKsqBftdrLuLYlx9uuXH1jWYB5CKG44OIPzejNIiaEXvc+IM= x-forefront-antispam-report: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PA4PR03MB7136.eurprd03.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230022)(4636009)(366004)(39860400002)(136003)(346002)(396003)(376002)(451199015)(86362001)(38070700005)(36756003)(7416002)(2906002)(2616005)(6506007)(6512007)(26005)(83380400001)(186003)(5660300002)(38100700002)(122000001)(91956017)(66946007)(66476007)(76116006)(316002)(66446008)(64756008)(66556008)(8936002)(71200400001)(54906003)(4326008)(478600001)(6486002)(8676002)(41300700001)(966005);DIR:OUT;SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?q?DzGC+OavsbpWS/IC4wQr6L+?= =?iso-8859-1?q?RRP0+z1eMZtaRHe1wJm/Vk4X3KXYvEyMQWQU1XBDY2tzZishiSdSfmuTkn3x?= =?iso-8859-1?q?asLiVsZbabgUCT5NPr4To46xVxJnmZR7f6oj6legRQukwKN0t0m3aIJ9u7yj?= =?iso-8859-1?q?wAIBJ9auCw3dngZwCmPqrvpM5uKgXnkGISwIG/RWnq0lcS0U6Tk6fK3pauKt?= =?iso-8859-1?q?XxLBjuKFfQ+sgHBwWAWLnsREArd3t34LZQKpfO+4whoqx/NNkldPqpg5ykBC?= =?iso-8859-1?q?LAH+8EbAaeKKFUqd5ZoDcyvXjjeLyTfaCd2edYKuLIH5uBp3R9hAKcSgmbAB?= =?iso-8859-1?q?OCRxsFQ8tPNZHfCW3JRsBrSHD/h5PQgGiIvYJkCRWHsiVRbPqLNF9HK/plj/?= =?iso-8859-1?q?PEo4BT2lbjrxfjcnSt9r1u4MCojD8Bc6XU4tITd7iUqh2jxY8qMLM5JD3Jov?= =?iso-8859-1?q?OXL8/qFcNIl9ozXh0LU/Uy21QiVM26w4rUyoGUuR3V1a5ZhKFbZPPzSzO2FO?= =?iso-8859-1?q?5TWX5bF9SiMQBj62PKQeGfD+LtV4ozAn0a4cCfvx5Npo14hAUu1nPf+tJjyx?= =?iso-8859-1?q?Y2/cTQhjmJkaf0FU0gFFAeGtxv2g7dQARj5T7lu0zrye2ToaLb5CK+RoDkDl?= =?iso-8859-1?q?86EQg1sZ8G0YIgCcD4QWHTuktHVoHqn4b1d3S2btY+3TRRIwPABbuWePlNtE?= =?iso-8859-1?q?CJcUCxLdfXcJ7NQnT99R6O/ps/2C6HLPJMy5gGnvviDmy6dVUU0hqAjwHpmw?= =?iso-8859-1?q?boUmGLQbqzAip85n/GAEXjeAEBpy/tN/PA0kqFkO61OGy4J5GMOQ0kARklgH?= =?iso-8859-1?q?X/qbg2jWtYnizPwVAsc6fBntDsZk7S6Ad85k61AOqF76s4/i0GHZheQfXxrq?= =?iso-8859-1?q?hISC3fPHvrfuzIXYzJ7B2WC/lHWqvvuOORCm4+N89Pv5Z7b6VbZVRZNBDf8b?= =?iso-8859-1?q?5vWgX93Aio19WhAFIIf9/BZON8dqWTnD0+q6Zqyq1O23UCqrEzcf3M6VigKL?= =?iso-8859-1?q?TU2CTV0tUB8SxOY+KofZeVXaustwTuWa+hmxT2e2laNZEZsb/OV7Qe84gOaH?= =?iso-8859-1?q?dfy3uT2ExUzV76qXBr9xZ5Cc9gHKalrCU/a8BmXtsYLLiM9EFWOylN15Ff9w?= =?iso-8859-1?q?6tvfkkF4g1InrOV2d9GXB3I3Wy3Zxs4XRW8bgHghjzGGc9H6Shm9ZHDZE4ju?= =?iso-8859-1?q?Gxo4u3R5t7dRLAbNz9c2oFoZKhbk31ANbmDyn83XpVS1vurPYO6sIZkgmVd9?= =?iso-8859-1?q?pRex7uC6+kC6ynko8PAyjp1MWp3p/Jl37zJWPh/el9GSbKY+G2zTPB+DGQ6D?= =?iso-8859-1?q?zjnF753QrzHFyWpcLQStkgvdU5qUqw8+x8Mp6OjkuCEpSP3qOPaLkHR7AzR/?= =?iso-8859-1?q?zV1W2YqGY6NqQv5gbMluUorj0ssLfPFXVtM1DY6aPD7tjudai7gOkUfT3uBp?= =?iso-8859-1?q?W33JiSIzQXyzylXkUKX6RecUWKbd9/u8eqaLrQ7rfMajBqcWvVMv9FHNzj5O?= =?iso-8859-1?q?59HF1vm7COwgMUZOfT03kZKArqrUE38CntG8AszpdNha9fpBp6vv7bZJ2l1o?= =?iso-8859-1?q?INmBXnZPSgRa6StQREElpD48EsbVbBK827oX+7bnJl9LUikikmUvsHFstQS9?= =?iso-8859-1?q?K/SDGBFnWNL+yW+zySDQIvyJa0rBkppX6CMxtiQ=3D=3D?= MIME-Version: 1.0 X-OriginatorOrg: epam.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: PA4PR03MB7136.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: caf65f31-dfe6-45a1-a9c4-08dac2f99872 X-MS-Exchange-CrossTenant-originalarrivaltime: 10 Nov 2022 08:57:28.6018 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: b41b72d0-4e9f-4c26-8a69-f949f367c91d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: 55QX06jU18t8jB2yaCLgjwQ3JVaoa56lHukuHll6oYKqKG3/WdTc6Dq0e4/DZhY+R3tL4fiJqdG12UhR4Oerzmpbz2giUpbvQvZDMmq+nJk= X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR03MB6822 X-Proofpoint-ORIG-GUID: BflOH_Dlch5EHNUp2LnhOPhOOX6NPNHg X-Proofpoint-GUID: BflOH_Dlch5EHNUp2LnhOPhOOX6NPNHg X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.895,Hydra:6.0.545,FMLib:17.11.122.1 definitions=2022-11-10_07,2022-11-09_01,2022-06-22_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 adultscore=0 mlxlogscore=999 clxscore=1015 mlxscore=0 priorityscore=1501 impostorscore=0 lowpriorityscore=0 spamscore=0 bulkscore=0 malwarescore=0 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2210170000 definitions=main-2211100067 X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE, SPF_NONE 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 X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1749098935462689634?= X-GMAIL-MSGID: =?utf-8?q?1749098935462689634?= Introducing of the common device controller bindings for the controller provider and consumer devices. Those bindings are intended to allow divided system on chip into muliple domains, that can be used to configure hardware permissions. Signed-off-by: Oleksii Moisieiev --- .../feature-domain-controller.yaml | 84 +++++++++++++++++++ MAINTAINERS | 6 ++ 2 files changed, 90 insertions(+) create mode 100644 Documentation/devicetree/bindings/feature-controllers/feature-domain-controller.yaml diff --git a/Documentation/devicetree/bindings/feature-controllers/feature-domain-controller.yaml b/Documentation/devicetree/bindings/feature-controllers/feature-domain-controller.yaml new file mode 100644 index 000000000000..90a7c38c833c --- /dev/null +++ b/Documentation/devicetree/bindings/feature-controllers/feature-domain-controller.yaml @@ -0,0 +1,84 @@ +# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause) +%YAML 1.2 +--- +$id: http://devicetree.org/schemas/feature-controllers/feature-domain-controller.yaml# +$schema: http://devicetree.org/meta-schemas/core.yaml# + +title: Generic Domain Controller bindings + +maintainers: + - Oleksii Moisieiev + +description: |+ + Common Feature Domains Controller bindings properties + + Domain controllers allow to divided system on chip into multiple feature + domains that can be used to select by who hardware blocks could be accessed. + A feature domain could be a cluster of CPUs (or coprocessors), a range of + addresses or a group of hardware blocks. + + This device tree bindings can be used to bind feature domain consumer devices + with their feature domains provided by feature-domains controllers. + Feature omain controller provider can be represened by any node in the + device tree and can provide one or more configuration parameters, needed to + control parameters of the consumer device. A consumer node can refer to the + provider by phandle and a set of phandle arguments, specified by + '#feature-domain-cells' property in the device controller provider node. + + Device controllers are typically used to set the permissions of the hardware + block. The contents of the feature-domains configuration properties are + defined by the binding for the individual feature-domains controller device. + + Each node can be a consumer for the several providers. The first + configuration of 'feature-domains' or the one named 'default' is applied + before probing the device itself. + +# always select the core schema +select: true + +properties: + '#feature-domain-cells': + $ref: /schemas/types.yaml#/definitions/uint32 + description: + Number of cells in a feature-domains controller specifier; + Can be any value as specified by device tree binding documentation + of a particular provider. + + feature-domain-controller: + description: + Indicates that the node is feature-domain-controller provider. + + feature-domain-names: + $ref: '/schemas/types.yaml#/definitions/string-array' + description: + A list of feature-domains names, sorted in the same order as + feature-domains entries. Consumer drivers will use feature-domain-names + to match with existing feature-domains entries. + + feature-domains: + $ref: "/schemas/types.yaml#/definitions/phandle-array" + description: + A list of feature-domains controller specifiers, as defined by the + bindings of the feature-domain-controller provider. + +additionalProperties: true + +examples: + - | + ctrl0: ctrl@100 { + feature-domain-controller; + reg = <0x100 0x10>; + #feature-domain-cells = <2>; + }; + + ctrl1: ctrl@110 { + feature-domain-controller; + reg = <0x110 0x10>; + #feature-domain-cells = <3>; + }; + + foo@0 { + reg = <0x0 0x1>; + feature-domains = <&ctrl0 1 2>, <&ctrl1 3 4 5>; + feature-domain-names = "default", "unbind"; + }; diff --git a/MAINTAINERS b/MAINTAINERS index 046ff06ff97f..2d1a5023e61c 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -7920,6 +7920,12 @@ F: include/scsi/libfc.h F: include/scsi/libfcoe.h F: include/uapi/scsi/fc/ +FEATURE CONTROLLERS +M: Oleksii Moiseev +L: devicetree@vger.kernel.org +S: Maintained +F: Documentation/deviceree/bindings/feature-controllers/feature-domain-controller.yaml + FILE LOCKING (flock() and fcntl()/lockf()) M: Jeff Layton M: Chuck Lever