[PATCH v12 5/7] overlay: Documentation for the overlay sugar syntax
From: Pantelis Antoniou <hidden>
Date: 2016-12-05 17:05:26
Subsystem:
documentation, the rest · Maintainers:
Jonathan Corbet, Linus Torvalds
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-OWPKS81ov/FWk0Htik3J/w@public.gmane.org> --- Documentation/dt-object-internal.txt | 16 ++++++++++++++++ 1 file changed, 16 insertions(+)
diff --git a/Documentation/dt-object-internal.txt b/Documentation/dt-object-internal.txt
index 7d76296..9219d27 100644
--- a/Documentation/dt-object-internal.txt
+++ b/Documentation/dt-object-internal.txt@@ -306,3 +306,19 @@ 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.
--
2.1.4