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;
From:   Oleksii Moisieiev <Oleksii_Moisieiev@epam.com>
To:     "robh+dt@kernel.org" <robh+dt@kernel.org>
CC:     Oleksii Moisieiev <Oleksii_Moisieiev@epam.com>,
        "mcoquelin.stm32@gmail.com" <mcoquelin.stm32@gmail.com>,
        "alexandre.torgue@st.com" <alexandre.torgue@st.com>,
        "linus.walleij@linaro.org" <linus.walleij@linaro.org>,
        "gregkh@linuxfoundation.org" <gregkh@linuxfoundation.org>,
        "devicetree@vger.kernel.org" <devicetree@vger.kernel.org>,
        "tomase@xilinx.com" <tomase@xilinx.com>,
        "benjamin.gaignard@st.com" <benjamin.gaignard@st.com>,
        "broonie@kernel.org" <broonie@kernel.org>,
        "arnd@arndb.de" <arnd@arndb.de>,
        "shawnguo@kernel.org" <shawnguo@kernel.org>,
        "fabio.estevam@nxp.com" <fabio.estevam@nxp.com>,
        "loic.pallardy@st.com" <loic.pallardy@st.com>,
        "mark.rutland@arm.com" <mark.rutland@arm.com>,
        Sudeep Holla <sudeep.holla@arm.com>,
        Cristian Marussi <cristian.marussi@arm.com>,
        Stefano Stabellini <sstabellini@kernel.org>,
        "a.fatoum@pengutronix.de" <a.fatoum@pengutronix.de>,
        "peng.fan@oss.nxp.com" <peng.fan@oss.nxp.com>,
        "linux-kernel@vger.kernel.org" <linux-kernel@vger.kernel.org>,
        Krzysztof Kozlowski <krzysztof.kozlowski+dt@linaro.org>,
        "linux-arm-kernel@lists.infradead.org" 
        <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: <c730d1b47223f535ae214d21cfa18e2c011c7dc2.1668070216.git.oleksii_moisieiev@epam.com>
References: <cover.1668070216.git.oleksii_moisieiev@epam.com>
In-Reply-To: <cover.1668070216.git.oleksii_moisieiev@epam.com>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?iso-8859-1?Q?ifduplF3GvsiZRYDdpe4nU9sq1L2UUD2ZX6kL1h5I8XVGY0LnzdHVmej0P?=
 =?iso-8859-1?Q?Csx6a2q9a0Xem/IGJBgrnQGtezgw6V/EmUWtYeTwVqfS7i3u3zpWw59fab?=
 =?iso-8859-1?Q?EPiPbXl2SisRXc7lL4qf9q6jKut3ldK8hIwyuCuQrZLySS/4WkcseJUUUB?=
 =?iso-8859-1?Q?DavXlc67+F+5074C8Ou9CWgQpDxCQhrMYmkG1DJW1xe8IxYtnUpzxFzCfp?=
 =?iso-8859-1?Q?UBuezSTIiaBbfypT8//fEOl4Ket4y+mSWxtDrIoNgZPTLuKNvV0YUty7eN?=
 =?iso-8859-1?Q?nEGWd89iL1zrZ0tSAx6pcSwKwsBel7Mv3md2aYMVfHeWgYEmZxd/lTylYe?=
 =?iso-8859-1?Q?lTpjAHqd5vQMIUiH77iT1bzFSf1m9fD9tpbFXGKQyEVxwHvtzA1ByAOrvD?=
 =?iso-8859-1?Q?8AXk42EwoWz1U9KC15uVL9JuxrKFZQSvUcKMoRO9lmOXk0DjWMEYKyhvBQ?=
 =?iso-8859-1?Q?TLEGhh2iY7HtLtSRKOZ+7T+nev+iZu4Wj2sMNuPFUn19m7oOaEQHVU1Afx?=
 =?iso-8859-1?Q?+PctwwYh3woOr1AUiPRZkp+QwpkUfRIDz+petuKkE5BbPZkIkvePZlyY6c?=
 =?iso-8859-1?Q?dvlvPpmxv8/0hSeyuNegrn7BkF4R1vhH2ModM+iKvcXEkX9dW1eluxmldt?=
 =?iso-8859-1?Q?IqWnElPSHL8sxxH86bJgdDcqgsPLi7eYadDIIORxrYFQ/7KDKzn4IAQ9S/?=
 =?iso-8859-1?Q?6t4e70mR6YhcYoe79VOFnsNmlDpHakPWhVRvml+U/7pnuNX7rFA+EdjqQL?=
 =?iso-8859-1?Q?RPa1gLKPynXN9/CDuHWVbgwAd7rCTRwfYrL527WjjclgLJypW2gq8rkt7o?=
 =?iso-8859-1?Q?mDmjOAAn7tXpAHDaXYW5CWwqqUX8Mpk7Ac/5ZGVPkNCpoqEY8svwGcy13k?=
 =?iso-8859-1?Q?MNu68LZthPZhwbr3RPryTTbYqjD/gqEjUIRvrXA8eu6m+xRZPxDhMPXaNW?=
 =?iso-8859-1?Q?IIsdgUlMdh6nWlXcBqD60pq3PuOnxsXZ3epshNrlac+WVb9sdKZcjfCoie?=
 =?iso-8859-1?Q?OaR6cxKMLdQby0PkMll7l+/ngmWhBKIY3rrWTosIHt+h/pUX+RkqlXZGNm?=
 =?iso-8859-1?Q?EhvAkps+cRtypIoOvI4KuZyb+CYAW6LYCm2jUpBnEJ5On4E4VszmKXq63a?=
 =?iso-8859-1?Q?V2jtBFuyG8Z6A76R1nfAKydJjqI0sJwlTarvNQcOXdSNTPh+WkioEsJZcW?=
 =?iso-8859-1?Q?Y1O+9PauD9LiBKNgcGsjVQdO31Ql69/+91vg7yiRmRwUI8DLH4REATOec1?=
 =?iso-8859-1?Q?Ipko0U1CBaXorAB9PJVpUPWxvLZDLAyfQoEcZMiHCV24P9dagAnogTAq7S?=
 =?iso-8859-1?Q?Yj4XEY+lyLaBLHNrCPwuiwky7dJbrtBAxEYmOcYbCL75fU2h1so0Aq7/Co?=
 =?iso-8859-1?Q?9pXOh8FnYSh2Gxr9tQhe4GB6+sSkxUYSLx86FIv5RF4clzA8/Rle6s7lFD?=
 =?iso-8859-1?Q?n5E4kqZuDg3tXelCggtskiZSCyYVnYijgUU1XC5qAsQhi//XVWQs2APFUB?=
 =?iso-8859-1?Q?KXxHOH0cq/ASRjnu5+avqWJD3IzXK/AXBWbpQY8DkiT7i+3lhmoy/egGsO?=
 =?iso-8859-1?Q?5ymaqy3ITkRR1cHilCdU/qn8ssvCCk9WmDHT2PLdWl4wyzil/zvOwNLIEX?=
 =?iso-8859-1?Q?OBUJaLNitcXrp+sAW1gGYNzybvpbNXU+suvyVW/TXpnqQ48DQoC5WGWw?=
 =?iso-8859-1?Q?=3D=3D?=
Content-Type: text/plain; charset="iso-8859-1"
Content-Transfer-Encoding: quoted-printable
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: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org

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 <oleksii_moisieiev@epam.com>
---
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/Doc=
umentation/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
=20
+  '#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:
         };
     };
=20
+  - |
+    firmware {
+        scmi_link: scmi {
+            compatible =3D "arm,scmi-smc";
+            shmem =3D <&cpu_scp_lpri0 &cpu_scp_lpri1>;
+            arm,smc-id =3D <0xc3000001>;
+
+            #address-cells =3D <1>;
+            #size-cells =3D <0>;
+            feature-domain-controller;
+            #feature-domain-cells =3D <1>;
+        };
+    };
+
+    foo@0 {
+      reg =3D <0x0 0x10>;
+      feature-domains =3D <&scmi_link 1>;
+    };
 ...
--=20
2.25.1