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
This commit is contained in:
Pantelis Antoniou 2016-12-07 12:48:21 +08:00 committed by SzuWei Lin
parent 507cd9883a
commit 8876e278cf

View file

@ -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.