devicetree/bindings/example-schema.yaml

1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
4 ---
5 # All the top-level keys are standard json-schema keywords except for
10 $id: http://devicetree.org/schemas/example-schema.yaml#
11 # $schema is the meta-schema this schema should be validated with.
12 $schema: http://devicetree.org/meta-schemas/core.yaml#
17   - Rob Herring <robh@kernel.org>
20   A more detailed multi-line description of the binding.
44       - items:
45           # items is a list of possible values for the property. The number of
51           - enum:
52               - vendor,soc4-ip
53               - vendor,soc3-ip
54               - vendor,soc2-ip
55           - enum:
56               - vendor,soc1-ip
59       - items:
61           - const: vendor,soc1-ip
63   reg:
64     # The core schema already checks that reg values are numbers, so device
67     # the number of reg entries.
69       - description: core registers
70       - description: aux registers
73   reg-names:
74     # The core schema enforces this (*-names) is a string array
76       - const: core
77       - const: aux
87   clock-names:
89       - const: bus
96       - description: tx or combined interrupt
97       - description: rx interrupt
105   interrupt-names:
110       - const: tx irq
111       - const: rx irq
113   # Property names starting with '#' must be quoted
114   '#interrupt-cells':
119   interrupt-controller: true
123   clock-frequency:
128     # The value that should be used if the property is not present
131   foo-gpios:
135   # *-supply is always a single phandle, so nothing more to define.
136   foo-supply: true
143   vendor,int-property:
148   vendor,bool-property:
150       properties are one case where the json-schema 'type' keyword can be used
154   vendor,string-array-property:
157     $ref: /schemas/types.yaml#/definitions/string-array
159       - enum: [foo, bar]
160       - enum: [baz, boo]
162   vendor,property-in-standard-units-microvolt:
167   child-node:
168     description: Child nodes are just another property from a json-schema
172       vendor,a-child-node-property:
178       - vendor,a-child-node-property
182   # 'vendor,bool-property' is only allowed when 'vendor,string-array-property'
184   vendor,bool-property: [ 'vendor,string-array-property' ]
187   vendor,string-array-property: [ 'vendor,bool-property' ]
190   - compatible
191   - reg
192   - interrupts
193   - interrupt-controller
195 # if/then schema can be used to handle conditions on a property affecting
196 # another property. A typical case is a specific 'compatible' value changes the
204   - if:
208             const: vendor,soc2-ip
211         - foo-supply
214   - if:
216         - vendor,bool-property
219         vendor,int-property:
224 # 'pinctrl-*' which are added automatically by the tooling.
236   # Examples have a default #address-cells and #size-cells value of 1. This can
241   - |
243           compatible = "vendor,soc4-ip", "vendor,soc1-ip";
244           reg = <0x1000 0x80>,
246           reg-names = "core", "aux";
248           interrupt-controller;