Lines Matching +full:a +full:- +full:child +full:- +full:node +full:- +full:property

1 .\"-
6 .\" Cambridge Computer Laboratory under DARPA/AFRL contract (FA8750-10-C-0237)
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 .Op Fl E Ar [no-]checker_name
52 .Op Fl W Ar [no-]checker_name
64 The binary is identical to the in-memory representation and can be used
70 This format is most commonly used to produce a kernel specific to a device,
74 .Bl -tag -width indent
76 Writes a dependency file understandable by make to the specified file.
77 This file can be included in a Makefile and will ensure that the output file
80 has a notion of inclusions.
82 Adds a path to search for include files.
83 .It Fl E Ar [no-]checker_name
84 Enable or disable a specified checker.
89 Emit a __symbols__ node to allow plugins to be loaded.
98 .Bl -tag -width indent -compact
112 .Bl -tag -width indent -compact
125 .Bl -tag -width indent -compact
127 Assembler source for generating a device tree blob, as described in
140 Defines a macro, in the form
148 .Ar /include/if [property]/ "file.dts"
149 directive that is allowed at the start of a file and which will only include
150 the specified file if it the specified property is passed with this flag.
153 format for property values.
154 These allow property value to be specified on the command line.
157 This is useful if you are generating a device tree blob for bootloader or
172 .It Fl W Ar [no-]checker_name
173 Enable or disable a specified checker.
183 This is only relevant for binary outputs, and only a value of 17 is currently
195 .Bl -tag -width "dt_strings_start" -compact -offset indent
214 The utility provides a number of semantic checks on the correctness of the
220 .Fl W Ar no-type-phandle
224 .Bl -tag -width "no-type-phandle" -compact -offset indent
225 .It type-compatible
228 property.
229 .It type-model
232 property.
233 .It type-compatible
236 property.
237 .It cells-attributes
239 .Va #address-cells
241 .Va #size-cells
243 .It deleted-nodes
245 .Va /delete-node/
250 Overlays are a method of patching a base device tree that has been compiled with
258 To denote that a DTS is intended to be used as an overlay,
261 .Va /dts-v1/\&;
266 nodes in a root.
267 Each fragment node must have either a
269 property set to a label reference, or a
270 .Va target-path
271 string property set to a path.
274 child node, whose properties and child nodes are merged into the base device
278 Instead of creating targeted fragments manually, one can instead create a root
279 node that targets a label in the base FDT using the
282 This will indicate that a fragment should be generated for the node, with the
285 being the target, and the properties and child nodes will be used as the
288 Additionally, a path-based version of this syntactic sugar is supported.
289 A root node may target a path in the base FDT using a name of the form
291 A fragment will be generated for the node as it is in the
294 .Va target-path
295 property will be set to
301 Both conventional overlays and the later-added syntactic sugar are supported.
308 .Sh NODE OMISSION
310 .Va /omit-if-no-ref/
313 This may be used in more space-constrained environments to remove nodes that may
323 .Dl "dtc -o blob.S -O asm device.dts"
325 will generate a
329 and print errors if any occur during parsing or property checking.
330 The resulting file can be assembled and linked into a binary.
334 .Dl "dtc -o - -O dts -I dtb device.dtb"
343 .Dl "dtc -@ -O dtb -I dts -o device.dtb device.dts"
345 will generate a
349 with a __symbols__ node included so that overlays may be applied to it.
353 .Dl "dtc -@ -O dtb -I dts -o device_overlay.dtbo device_overlay.dts"
355 will generate a
357 file, using the standard extension for a device tree overlay, from the device
360 A __symbols__ node will be included so that overlays may be applied to it.
361 The presence of a
380 This builds a tree from a Linux
381 .Pa  /proc/device-tree ,
382 a file system hierarchy not found in
384 which instead exposes the DTB directly via a sysctl.
401 .Bl -bullet -compact
403 The target of cross references is defined to be a node name in the
404 specification, but is in fact a label.
409 It must appear in the top level of a file, and imports a new root definition.
410 If a file, plus all of its inclusions, contains multiple roots then they are
414 replacing those from the first and properties child nodes being recursively
417 A dtc tool first appeared in
433 .Bl -bullet -compact
435 Labels in the middle of property values.
444 The current version performs a very limited set of semantic checks on the tree.