From: Pantelis Antoniou <pantelis.antoniou@konsulko.com> To: Rob Herring <robherring2@gmail.com> Cc: Grant Likely <grant.likely@secretlab.ca>, Matt Porter <mporter@konsulko.com>, Koen Kooi <koen@dominion.thruhere.net>, Guenter Roeck <linux@roeck-us.net>, devicetree@vger.kernel.org, linux-kernel@vger.kernel.org, Pantelis Antoniou <pantelis.antoniou@konsulko.com>, Pantelis Antoniou <panto@antoniou-consulting.com> Subject: [PATCH 3/8] doc: dt: Document the indirect overlay method. Date: Fri, 12 Jun 2015 22:55:00 +0300 [thread overview] Message-ID: <1434138905-15886-4-git-send-email-pantelis.antoniou@konsulko.com> (raw) In-Reply-To: <1434138905-15886-1-git-send-email-pantelis.antoniou@konsulko.com> Add a description of the indirect overlay method to the overlay documention file. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> --- Documentation/devicetree/overlay-notes.txt | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/devicetree/overlay-notes.txt b/Documentation/devicetree/overlay-notes.txt index d418a6c..dd595e6 100644 --- a/Documentation/devicetree/overlay-notes.txt +++ b/Documentation/devicetree/overlay-notes.txt @@ -100,6 +100,10 @@ Finally, if you need to remove all overlays in one-go, just call of_overlay_destroy_all() which will remove every single one in the correct order. +If your board has multiple slots/places where a single overlay can work +and each slot is defined by a node, you can use the of_overlay_create_indirect() +method to select the target. + Overlay DTS Format ------------------ @@ -113,6 +117,11 @@ The DTS of an overlay should have the following format: target=<phandle>; /* phandle target of the overlay */ or target-path="/path"; /* target path of the overlay */ + or + target-indirect { /* indirect target selector */ + foo { target|target-path ... }; + bar { .... }; + }; __overlay__ { property-a; /* add property-a to the target */ @@ -131,3 +140,7 @@ Using the non-phandle based target method allows one to use a base DT which does not contain a __symbols__ node, i.e. it was not compiled with the -@ option. The __symbols__ node is only required for the target=<phandle> method, since it contains the information required to map from a phandle to a tree location. + +The indirect target requires the use of a selector target on the call to +of_overlay_create_indirect(). I.e. passing the "foo" id will select the target +in the foo node, "bar" in bar node, etc. -- 1.7.12
WARNING: multiple messages have this Message-ID (diff)
From: Pantelis Antoniou <pantelis.antoniou-OWPKS81ov/FWk0Htik3J/w@public.gmane.org> To: Rob Herring <robherring2-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> Cc: Grant Likely <grant.likely-s3s/WqlpOiPyB63q8FvJNQ@public.gmane.org>, Matt Porter <mporter-OWPKS81ov/FWk0Htik3J/w@public.gmane.org>, Koen Kooi <koen-QLwJDigV5abLmq1fohREcCpxlwaOVQ5f@public.gmane.org>, Guenter Roeck <linux-0h96xk9xTtrk1uMJSBkQmQ@public.gmane.org>, devicetree-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, linux-kernel-u79uwXL29TY76Z2rM5mHXA@public.gmane.org, Pantelis Antoniou <pantelis.antoniou-OWPKS81ov/FWk0Htik3J/w@public.gmane.org>, Pantelis Antoniou <panto-wVdstyuyKrO8r51toPun2/C9HSW9iNxf@public.gmane.org> Subject: [PATCH 3/8] doc: dt: Document the indirect overlay method. Date: Fri, 12 Jun 2015 22:55:00 +0300 [thread overview] Message-ID: <1434138905-15886-4-git-send-email-pantelis.antoniou@konsulko.com> (raw) In-Reply-To: <1434138905-15886-1-git-send-email-pantelis.antoniou-OWPKS81ov/FWk0Htik3J/w@public.gmane.org> Add a description of the indirect overlay method to the overlay documention file. Signed-off-by: Pantelis Antoniou <pantelis.antoniou-OWPKS81ov/FWk0Htik3J/w@public.gmane.org> --- Documentation/devicetree/overlay-notes.txt | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/Documentation/devicetree/overlay-notes.txt b/Documentation/devicetree/overlay-notes.txt index d418a6c..dd595e6 100644 --- a/Documentation/devicetree/overlay-notes.txt +++ b/Documentation/devicetree/overlay-notes.txt @@ -100,6 +100,10 @@ Finally, if you need to remove all overlays in one-go, just call of_overlay_destroy_all() which will remove every single one in the correct order. +If your board has multiple slots/places where a single overlay can work +and each slot is defined by a node, you can use the of_overlay_create_indirect() +method to select the target. + Overlay DTS Format ------------------ @@ -113,6 +117,11 @@ The DTS of an overlay should have the following format: target=<phandle>; /* phandle target of the overlay */ or target-path="/path"; /* target path of the overlay */ + or + target-indirect { /* indirect target selector */ + foo { target|target-path ... }; + bar { .... }; + }; __overlay__ { property-a; /* add property-a to the target */ @@ -131,3 +140,7 @@ Using the non-phandle based target method allows one to use a base DT which does not contain a __symbols__ node, i.e. it was not compiled with the -@ option. The __symbols__ node is only required for the target=<phandle> method, since it contains the information required to map from a phandle to a tree location. + +The indirect target requires the use of a selector target on the call to +of_overlay_create_indirect(). I.e. passing the "foo" id will select the target +in the foo node, "bar" in bar node, etc. -- 1.7.12 -- To unsubscribe from this list: send the line "unsubscribe devicetree" in the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org More majordomo info at http://vger.kernel.org/majordomo-info.html
next prev parent reply other threads:[~2015-06-12 19:57 UTC|newest] Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top 2015-06-12 19:54 [PATCH 0/8] of: Dynamic DT updates Pantelis Antoniou 2015-06-12 19:54 ` [PATCH 1/8] of: overlay: Implement indirect target support Pantelis Antoniou 2015-06-18 0:10 ` Rob Herring 2015-06-18 0:10 ` Rob Herring 2015-06-18 4:21 ` Guenter Roeck 2015-06-12 19:54 ` [PATCH 2/8] of: unittest: Add indirect overlay target test Pantelis Antoniou 2015-06-12 19:55 ` Pantelis Antoniou [this message] 2015-06-12 19:55 ` [PATCH 3/8] doc: dt: Document the indirect overlay method Pantelis Antoniou 2015-06-12 19:55 ` [PATCH 4/8] of: overlay: Introduce target root capability Pantelis Antoniou 2015-06-12 19:55 ` [PATCH 5/8] of: unittest: Unit-tests for target root overlays Pantelis Antoniou 2015-06-12 19:55 ` [PATCH 6/8] doc: dt: Document the target root overlay method Pantelis Antoniou 2015-06-12 19:55 ` Pantelis Antoniou 2015-06-12 19:55 ` [PATCH 7/8] of: dynamic: Add __of_node_dupv() Pantelis Antoniou 2015-06-12 19:55 ` [PATCH 8/8] of: changesets: Introduce changeset helper methods Pantelis Antoniou 2015-11-17 13:13 ` Geert Uytterhoeven
Reply instructions: You may reply publicly to this message via plain-text email using any one of the following methods: * Save the following mbox file, import it into your mail client, and reply-to-all from there: mbox Avoid top-posting and favor interleaved quoting: https://en.wikipedia.org/wiki/Posting_style#Interleaved_style * Reply using the --to, --cc, and --in-reply-to switches of git-send-email(1): git send-email \ --in-reply-to=1434138905-15886-4-git-send-email-pantelis.antoniou@konsulko.com \ --to=pantelis.antoniou@konsulko.com \ --cc=devicetree@vger.kernel.org \ --cc=grant.likely@secretlab.ca \ --cc=koen@dominion.thruhere.net \ --cc=linux-kernel@vger.kernel.org \ --cc=linux@roeck-us.net \ --cc=mporter@konsulko.com \ --cc=panto@antoniou-consulting.com \ --cc=robherring2@gmail.com \ /path/to/YOUR_REPLY https://kernel.org/pub/software/scm/git/docs/git-send-email.html * If your mail client supports setting the In-Reply-To header via mailto: links, try the mailto: linkBe sure your reply has a Subject: header at the top and a blank line before the message body.
This is an external index of several public inboxes, see mirroring instructions on how to clone and mirror all data and code used by this external index.