aboutsummaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorPantelis Antoniou <pantelis.antoniou@konsulko.com>2016-12-07 12:48:21 +0800
committerSzuWei Lin <szuweilin@google.com>2017-02-17 11:30:51 +0800
commit8876e278cfa7180d7929b32ce35442dbdc99c039 (patch)
treeaba44a3e15cdd2472343978e8b9123855c6216e6 /Documentation
parent507cd9883ab5be53c88459fe5b3ea61384381712 (diff)
downloaddtc-8876e278cfa7180d7929b32ce35442dbdc99c039.tar.gz
overlay: Documentation for the overlay sugar syntax
There exists a syntactic sugar version of overlays which make them simpler to write for the trivial case of a single target. Document it in the device tree object internals. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> Downloaded from https://marc.info/?l=devicetree&m=148111492925863&w=4 Change-Id: Iac4cb844f655516022926e7c18e7de3ae384e5e8
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/dt-object-internal.txt17
1 files changed, 17 insertions, 0 deletions
diff --git a/Documentation/dt-object-internal.txt b/Documentation/dt-object-internal.txt
index 51d68ab..624aa43 100644
--- a/Documentation/dt-object-internal.txt
+++ b/Documentation/dt-object-internal.txt
@@ -308,3 +308,20 @@ the run time loader must apply an offset to each phandle in every dynamic
DT object loaded. The __local_fixups__ node records the offset relative to the
start of every local reference within that property so that the loader can apply
the offset.
+
+There is an alternative syntax to the expanded form for overlays with phandle
+targets which makes the format similar to the one using in .dtsi include files.
+
+So for the &ocp target example above one can simply write:
+
+/dts-v1/;
+/plugin/;
+&ocp {
+ /* bar peripheral */
+ bar {
+ compatible = "corp,bar";
+ ... /* various properties and child nodes */
+ }
+};
+
+The resulting dtb object is identical.