On Fri, Jul 17, 2020 at 5:48 PM Suman Anna <s-a...@ti.com> wrote: > > Add a bindings document that lists the common TI SCI properties > used by the K3 R5F and DSP remoteproc devices. > > Signed-off-by: Suman Anna <s-a...@ti.com> > --- > v4: Addressed both of Rob's review comments on ti,sci-proc-ids property > v3: https://patchwork.kernel.org/patch/11602317/ > > .../bindings/remoteproc/ti,k3-sci-proc.yaml | 48 +++++++++++++++++++ > 1 file changed, 48 insertions(+) > create mode 100644 > Documentation/devicetree/bindings/remoteproc/ti,k3-sci-proc.yaml > > diff --git a/Documentation/devicetree/bindings/remoteproc/ti,k3-sci-proc.yaml > b/Documentation/devicetree/bindings/remoteproc/ti,k3-sci-proc.yaml > new file mode 100644 > index 000000000000..0dca2ffdbc48 > --- /dev/null > +++ b/Documentation/devicetree/bindings/remoteproc/ti,k3-sci-proc.yaml > @@ -0,0 +1,48 @@ > +# SPDX-License-Identifier: (GPL-2.0-only or BSD-2-Clause) > +%YAML 1.2 > +--- > +$id: http://devicetree.org/schemas/remoteproc/ti,k3-sci-proc.yaml# > +$schema: http://devicetree.org/meta-schemas/core.yaml# > + > +title: Common TI K3 remote processor device bindings > + > +maintainers: > + - Suman Anna <s-a...@ti.com> > + > +description: | > + The TI K3 family of SoCs usually have one or more remote processor > sub-systems > + like the dual-core R5F sub-system or a C66x or C71x DSP processor > subsystem. > + The device management of these remote processors is managed by a dedicated > + System Processor, and the communication with that processor is managed > through > + the TI-SCI protocol. > + > + Each remote processor device node should define a common set of properties > + that allows the System Processor firmware to perform the device management > + such as powering the IPs, asserting/deasserting the resets for each of > these > + processors. > + > +properties: > + ti,sci: > + $ref: /schemas/types.yaml#/definitions/phandle > + description: > + Should be a phandle to the TI-SCI System Controller node > + > + ti,sci-dev-id: > + $ref: /schemas/types.yaml#/definitions/uint32 > + description: | > + Should contain the TI-SCI device id corresponding to the remote > processor > + core. Please refer to the corresponding System Controller documentation > + for valid values.
These also apply on Lokesh's series converting ti,sci-int[ra] bindings. Please rework to use for both. > + > + ti,sci-proc-ids: > + description: Should contain a single tuple of <proc_id host_id>. > + $ref: /schemas/types.yaml#/definitions/uint32-array > + items: > + - description: TI-SCI processor id for the remote processor device > + - description: TI-SCI host id to which processor control ownership > + should be transferred to > + > +required: > + - ti,sci > + - ti,sci-dev-id > + - ti,sci-proc-ids > -- > 2.26.0 >
