From 053e54c2ded7d69b0cf1013e4285de9c46dc171e Mon Sep 17 00:00:00 2001 From: Neil Armstrong Date: Fri, 8 Oct 2021 10:34:11 +0200 Subject: [PATCH] devicetree: update DT_PROP_LEN documentation about ranges and dma-ranges Like reg and interrupts, using DT_PROP_LEN doesn't make sense since the ranges & 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 --- doc/releases/release-notes-3.0.rst | 3 +++ include/devicetree.h | 3 ++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/doc/releases/release-notes-3.0.rst b/doc/releases/release-notes-3.0.rst index 093c22a0778..ff5c4b60323 100644 --- 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 index 38e169053ce..d8e43c9868a 100644 --- 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. *