devicetree: update DT_PROP_LEN documentation about ranges and dma-ranges

superna9999 · cfriedt · commit 053e54c2ded7 · 2021-11-10T08:23:00.000-05:00
Like reg and interrupts, using DT_PROP_LEN doesn't make sense since
the ranges &amp; dma-ranges block lengths and values depends on the DT
node #address-cells, #size-cells and parents #address-cells value.

Signed-off-by: Neil Armstrong &lt;narmstrong@baylibre.com&gt;
diff --git a/doc/releases/release-notes-3.0.rst b/doc/releases/release-notes-3.0.rst
@@ -38,6 +38,9 @@ Changes in this release
 
 * Added function for getting status of USB device remote wakeup feature.
 
+* Added ``ranges`` and ``dma-ranges`` as invalid property to be used with DT_PROP_LEN()
+  along ``reg`` and ``interrupts``.
+
 ==========================
 
 Removed APIs in this release
diff --git a/include/devicetree.h b/include/devicetree.h
@@ -549,7 +549,8 @@
  * - reg property: use DT_NUM_REGS(node_id) instead
  * - interrupts property: use DT_NUM_IRQS(node_id) instead
  *
- * It is an error to use this macro with the reg or interrupts properties.
+ * It is an error to use this macro with the ranges, dma-ranges, reg
+ * or interrupts properties.
  *
  * For other properties, behavior is undefined.
  *

Original file line number	Diff line number	Diff line change
`@@ -549,7 +549,8 @@`
`549`	`549`	`* - reg property: use DT_NUM_REGS(node_id) instead`
`550`	`550`	`* - interrupts property: use DT_NUM_IRQS(node_id) instead`
`551`	`551`	`*`
`552`		`- * It is an error to use this macro with the reg or interrupts properties.`
	`552`	`+ * It is an error to use this macro with the ranges, dma-ranges, reg`
	`553`	`+ * or interrupts properties.`
`553`	`554`	`*`
`554`	`555`	`* For other properties, behavior is undefined.`
`555`	`556`	`*`