x

Author: soburi

dts/bindings/gpio/gpio-nexus.yaml

@@ -2,6 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 # Common fields for GPIO nexus nodes
+#
+# see 2.5 Nexus Nodes and Specifier Mapping
+# https://devicetree-specification.readthedocs.io/en/latest/chapter2-devicetree-basics.html#nexus-nodes-and-specifier-mapping
+# in the Devicetree Specification
 
 properties:
   gpio-map:

dts/bindings/iio/io-channel-nexus.yaml

@@ -2,6 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 # Common fields for io-channel nexus
+#
+# see 2.5 Nexus Nodes and Specifier Mapping
+# https://devicetree-specification.readthedocs.io/en/latest/chapter2-devicetree-basics.html#nexus-nodes-and-specifier-mapping
+# in the Devicetree Specification
 
 properties:
   io-channel-map:

dts/bindings/interrupt-controller/interrupt-nexus.yaml

@@ -2,6 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 # Common fields for interrupt nexus nodes
+#
+# see 2.5 Nexus Nodes and Specifier Mapping
+# https://devicetree-specification.readthedocs.io/en/latest/chapter2-devicetree-basics.html#nexus-nodes-and-specifier-mapping
+# in the Devicetree Specification
 
 properties:
   interrupt-map:

dts/bindings/pwm/pwm-nexus.yaml

@@ -2,6 +2,10 @@
 # SPDX-License-Identifier: Apache-2.0
 
 # Common fields for PWM nexus nodes
+#
+# see 2.5 Nexus Nodes and Specifier Mapping
+# https://devicetree-specification.readthedocs.io/en/latest/chapter2-devicetree-basics.html#nexus-nodes-and-specifier-mapping
+# in the Devicetree Specification
 
 properties:
   pwm-map:

scripts/dts/python-devicetree/src/devicetree/edtlib.py

@@ -1046,6 +1046,14 @@ class Node:
       list is empty if the node does not hog any GPIOs. Only relevant for GPIO hog
       nodes.
 
+    maps:
+      A list of ControllerAndData objects for each entry in a *-map property on
+      the node, such as 'interrupt-map'. Each ControllerAndData describes a
+      mapping from a child specifier to a parent controller, with 'basename' set
+      to the specifier name (e.g. 'interrupt') and 'data' containing the
+      parsed child and parent specifier cells.
+      The list is empty if the node has no *-map properties.
+
     is_pci_device:
       True if the node is a PCI device.
     """
@@ -1323,6 +1331,8 @@ def gpio_hogs(self) -> list[ControllerAndData]:
 
     @property
     def maps(self) -> list[ControllerAndData]:
+        "See the class docstring"
+
         res: list[ControllerAndData] = []
 
         def count_cells_num(node: dtlib_Node, specifier: str) -> int:
@@ -1332,9 +1342,6 @@ def count_cells_num(node: dtlib_Node, specifier: str) -> int:
             add up the values of the address cells.
             """
 
-            if node is None:
-                _err("node is None.")
-
             num = node.props[f"#{specifier}-cells"].to_num()
 
             if specifier == "interrupt":