[PATCH v3 1/3] dt-bindings: Convert graph bindings to json-schema

[Rob Herring]

On Mon, Nov 2, 2020 at 2:36 PM Rob Herring <robh at kernel.org> wrote:
>
> From: Sameer Pujar <spujar at nvidia.com>
>
> Convert device tree bindings of graph to YAML format. Currently graph.txt
> doc is referenced in multiple files and all of these need to use schema
> references. For now graph.txt is updated to refer to graph.yaml.
>
> For users of the graph binding, they should reference to the graph
> schema from either 'ports' or 'port' property:
>
> properties:
>   ports:
>     type: object
>     $ref: graph.yaml#/properties/ports
>
>     properties:
>       port at 0:
>         description: What data this port has
>
>       ...
>
> Or:
>
> properties:
>   port:
>     description: What data this port has
>     type: object
>     $ref: graph.yaml#/properties/port
>
> Signed-off-by: Sameer Pujar <spujar at nvidia.com>
> Acked-by: Philipp Zabel <p.zabel at pengutronix.de>
> Signed-off-by: Rob Herring <robh at kernel.org>
> ---
> v3:
>  - Move port 'reg' to port@* and make required
>  - Make remote-endpoint required
>  - Add 'additionalProperties: true' now required
>  - Fix yamllint warnings
>
>  Documentation/devicetree/bindings/graph.txt  | 129 +-----------
>  Documentation/devicetree/bindings/graph.yaml | 199 +++++++++++++++++++
>  2 files changed, 200 insertions(+), 128 deletions(-)
>  create mode 100644 Documentation/devicetree/bindings/graph.yaml

I've decided to move this to the dt-schema repo instead[1]. I think
that will be easier to manage dependencies (audio-graph.yaml plus
anything else landing this cycle) than subsystems pulling a shared
branch. I haven't merged it yet, so let me know if any
comments/objections. Note that the meta-schema will have to come a bit
later once existing users are updated (which I have patches for).

Rob

[1] https://github.com/devicetree-org/dt-schema/tree/of-graph