diff options
author | Pantelis Antoniou <pantelis.antoniou@konsulko.com> | 2016-12-07 14:48:18 +0200 |
---|---|---|
committer | David Gibson <david@gibson.dropbear.id.au> | 2016-12-09 13:26:39 +1100 |
commit | 20f29d8d41f6d1bd2fbe466aa5676026eb012832 (patch) | |
tree | 1a988fa4e9da16bca01af7f43b99b75912142373 /Documentation/manual.txt | |
parent | a2c92cac53f806e6c1936c1c522a6c24a5ec7199 (diff) | |
download | dtc-20f29d8d41f6d1bd2fbe466aa5676026eb012832.zip dtc-20f29d8d41f6d1bd2fbe466aa5676026eb012832.tar.gz dtc-20f29d8d41f6d1bd2fbe466aa5676026eb012832.tar.bz2 |
dtc: Plugin and fixup support
This patch enable the generation of symbols & local fixup information
for trees compiled with the -@ (--symbols) option.
Using this patch labels in the tree and their users emit information
in __symbols__ and __local_fixups__ nodes.
The __fixups__ node make possible the dynamic resolution of phandle
references which are present in the plugin tree but lie in the
tree that are applying the overlay against.
Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com>
Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
Signed-off-by: Jan Luebbe <jlu@pengutronix.de>
Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
Diffstat (limited to 'Documentation/manual.txt')
-rw-r--r-- | Documentation/manual.txt | 21 |
1 files changed, 20 insertions, 1 deletions
diff --git a/Documentation/manual.txt b/Documentation/manual.txt index 398de32..74e27c4 100644 --- a/Documentation/manual.txt +++ b/Documentation/manual.txt @@ -119,6 +119,20 @@ Options: Make space for <number> reserve map entries Relevant for dtb and asm output only. + -@ + Generates a __symbols__ node at the root node of the resulting blob + for any node labels used, and for any local references using phandles + it also generates a __local_fixups__ node that tracks them. + + When using the /plugin/ tag all unresolved label references to + be tracked in the __fixups__ node, making dynamic resolution possible. + + -A + Generate automatically aliases for all node labels. This is similar to + the -@ option (the __symbols__ node contain identical information) but + the semantics are slightly different since no phandles are automatically + generated for labeled nodes. + -S <bytes> Ensure the blob at least <bytes> long, adding additional space if needed. @@ -146,13 +160,18 @@ Additionally, dtc performs various sanity checks on the tree. Here is a very rough overview of the layout of a DTS source file: - sourcefile: list_of_memreserve devicetree + sourcefile: versioninfo plugindecl list_of_memreserve devicetree memreserve: label 'memreserve' ADDR ADDR ';' | label 'memreserve' ADDR '-' ADDR ';' devicetree: '/' nodedef + versioninfo: '/' 'dts-v1' '/' ';' + + plugindecl: '/' 'plugin' '/' ';' + | /* empty */ + nodedef: '{' list_of_property list_of_subnode '}' ';' property: label PROPNAME '=' propdata ';' |