On Mon, Nov 2, 2020 at 2:36 PM Rob Herring <r...@kernel.org> wrote: > > From: Sameer Pujar <spu...@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@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 <spu...@nvidia.com> > Acked-by: Philipp Zabel <p.za...@pengutronix.de> > Signed-off-by: Rob Herring <r...@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
