Commit Graph

2 Commits

Author SHA1 Message Date
Rob Herring
195712bfdd dt-bindings: Update schema project location to devicetree.org github group
The DT schema tools are moving from my personal GH repo to the
devicetree.org group on GH. The new location is here:

https://github.com/devicetree-org/dt-schema.git

The old repo will be kept as a mirror.

Signed-off-by: Rob Herring <robh@kernel.org>
2019-05-01 14:27:58 -05:00
Rob Herring
00ce8a8000 dt-bindings: Add a writing DT schemas how-to and annotated example
Add a how-to doc on writing DT schema documentation. This gives a
description of each section and details on how to validate the DT schema
file. The DT schema are written using json-schema vocabulary in a YAML
encoded document. Using jsonschema gives us access to existing tooling.
A YAML encoding gives us something easy to edit. The example is
annotated to help explain what each section does.

This example is just the tip of the iceberg, but is it the part most
developers writing bindings will interact with. Backing all this up
are meta-schema (to validate the binding schemas), some DT core schema,
YAML encoded DT output with dtc, and a small number of python scripts to
run validation.

Cc: Mark Rutland <mark.rutland@arm.com>
Cc: devicetree@vger.kernel.org
Signed-off-by: Rob Herring <robh@kernel.org>
2018-12-13 09:41:49 -06:00