[PATCH 1/4] dt-bindings: reserved-memory: Introduce memory-region{s,-names}

From: Thierry Reding
Date: Fri Apr 03 2020 - 14:57:00 EST


From: Thierry Reding <treding@xxxxxxxxxx>

In order to make the reserved-memory bindings more consistent with other
existing bindings, add a memory-region-names property that contains an
array of strings that name the entries of the memory-region property and
allows these regions to be looked up by name.

Also add the memory-regions property as an alias for the existing
memory-region property. This is again for consistency with other similar
bindings and makes it clearer that this property can take multiple
<phandle, specifier> pairs.

Signed-off-by: Thierry Reding <treding@xxxxxxxxxx>
---
.../bindings/reserved-memory/reserved-memory.txt | 12 ++++++++----
1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt
index bac4afa3b197..823e619cfca3 100644
--- a/Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt
+++ b/Documentation/devicetree/bindings/reserved-memory/reserved-memory.txt
@@ -76,7 +76,11 @@ Device node references to reserved memory
Regions in the /reserved-memory node may be referenced by other device
nodes by adding a memory-region property to the device node.

-memory-region (optional) - phandle, specifier pairs to children of /reserved-memory
+memory-regions (optional) - phandle, specifier pairs to children of /reserved-memory
+memory-region-names (optional) - a list of names, one for each corresponding
+ entry in the memory-regions property
+
+memory-region (optional) - alias for memory-regions

Example
-------
@@ -120,17 +124,17 @@ one for multimedia processing (named multimedia-memory@77000000, 64MiB).
/* ... */

fb0: video@12300000 {
- memory-region = <&display_reserved>;
+ memory-regions = <&display_reserved>;
/* ... */
};

scaler: scaler@12500000 {
- memory-region = <&multimedia_reserved>;
+ memory-regions = <&multimedia_reserved>;
/* ... */
};

codec: codec@12600000 {
- memory-region = <&multimedia_reserved>;
+ memory-regions = <&multimedia_reserved>;
/* ... */
};
};
--
2.24.1