Lines Matching +full:fixed +full:- +full:links

1 .. SPDX-License-Identifier: GPL-2.0
3 Writing Devicetree Bindings in json-schema
6 Devicetree bindings are written using json-schema vocabulary. Schema files are
11 Also see :ref:`example-schema`.
14 ---------------
16 Each schema doc is a structured json-schema which is defined by a set of
17 top-level properties. Generally, there is one binding defined per file. The
18 top-level json-schema properties used are:
21   A json-schema unique identifier string. The string must be a valid
31   Indicates the meta-schema the schema file adheres to.
41   Optional. A multi-line text block containing any detailed
43   or device does, standards the device conforms to, and links to datasheets for
47   Optional. A json-schema used to match nodes for applying the
57   A set of sub-schema defining all the DT properties for the
80 ---------------
83 binding. Each property contains a set of constraints using json-schema
100 The default for arrays in json-schema is they are variable sized and allow more
102 'maxItems', and 'additionalItems'. However, for DeviceTree Schemas, a fixed
108 is present. Single entries in schemas are fixed up to match this encoding.
111 -------
120     pip3 install git+https://github.com/devicetree-org/dt-schema.git@master
122 Several executables (dt-doc-validate, dt-mk-schema, dt-validate) will be
131   apt-get install libyaml-dev
135   dnf -y install libyaml-devel
140 The DT schema binding documents must be validated using the meta-schema (the
141 schema for the schema) to ensure they are both valid json-schema and valid
164     make dt_binding_check DT_SCHEMA_FILES=Documentation/devicetree/bindings/trivial-devices.yaml
165     make dtbs_check DT_SCHEMA_FILES=Documentation/devicetree/bindings/trivial-devices.yaml
168 json-schema Resources
169 ---------------------
172 `JSON-Schema Specifications <http://json-schema.org/>`_
176 .. _example-schema:
179 ------------------------
181 Also available as a separate file: :download:`example-schema.yaml`
183 .. literalinclude:: example-schema.yaml