devicetree: deprecate DT_DMAS_LABEL APIs

Mark all variants of the DT_DMAS_LABEL APIs:
* DT_DMAS_LABEL_BY_IDX
* DT_DMAS_LABEL_BY_NAME
* DT_INST_DMAS_LABEL_BY_IDX
* DT_INST_DMAS_LABEL_BY_NAME

As deprecated in favor of utilizing:

* DT_DMAS_CTLR_BY_IDX
* DT_DMAS_CTLR_BY_NAME
* DT_DMAS_CTLR
* DT_INST_DMAS_CTLR_BY_IDX
* DT_INST_DMAS_CTLR_BY_NAME
* DT_INST_DMAS_CTLR

Signed-off-by: Kumar Gala <[email protected]>

Author: galak

doc/releases/release-notes-2.6.rst

@@ -51,6 +51,12 @@ Deprecated in this release
   :c:macro:`DT_INST_IO_CHANNELS_LABEL` were deprecated in favor of utilizing
   :c:macro:`DT_IO_CHANNELS_CTLR` and variants.
 
+* :c:macro:`DT_DMAS_LABEL_BY_IDX`,
+  :c:macro:`DT_DMAS_LABEL_BY_NAME`,
+  :c:macro:`DT_INST_DMAS_LABEL_BY_IDX`, and
+  :c:macro:`DT_INST_DMAS_LABEL_BY_NAME` were deprecated in favor of utilizing
+  :c:macro:`DT_DMAS_CTLR` and variants.
+
 * USB HID specific macros in ``<include/usb/class/usb_hid.h>`` are deprecated
   in favor of new common HID macros defined in ``<include/usb/class/hid.h>``.
 

include/devicetree/dma.h

@@ -53,6 +53,7 @@ extern "C" {
  * @return the label property of the node referenced at index "idx"
  */
 #define DT_DMAS_LABEL_BY_IDX(node_id, idx) \
+	__DEPRECATED_MACRO \
 	DT_PROP_BY_PHANDLE_IDX(node_id, dmas, idx, label)
 
 /**
@@ -64,6 +65,7 @@ extern "C" {
  * @see DT_DMAS_LABEL_BY_IDX()
  */
 #define DT_INST_DMAS_LABEL_BY_IDX(inst, idx) \
+	__DEPRECATED_MACRO \
 	DT_DMAS_LABEL_BY_IDX(DT_DRV_INST(inst), idx)
 
 /**
@@ -99,6 +101,7 @@ extern "C" {
  * @return the label property of the node referenced at the named element
  */
 #define DT_DMAS_LABEL_BY_NAME(node_id, name) \
+	__DEPRECATED_MACRO \
 	DT_PROP(DT_PHANDLE_BY_NAME(node_id, dmas, name), label)
 
 /**
@@ -178,6 +181,7 @@ extern "C" {
  * @see DT_DMAS_LABEL_BY_NAME()
  */
 #define DT_INST_DMAS_LABEL_BY_NAME(inst, name) \
+	__DEPRECATED_MACRO \
 	DT_DMAS_LABEL_BY_NAME(DT_DRV_INST(inst), name)
 
 /**

tests/lib/devicetree/api/src/main.c

@@ -15,6 +15,8 @@
  * - DT_IO_CHANNELS_LABEL_BY_IDX
  * - DT_IO_CHANNELS_LABEL_BY_NAME
  * - DT_IO_CHANNELS_LABEL
+ * - DT_DMAS_LABEL_BY_IDX
+ * - DT_DMAS_LABEL_BY_NAME
  * - DT_INST_CLOCKS_LABEL_BY_IDX
  * - DT_INST_CLOCKS_LABEL_BY_NAME
  * - DT_INST_CLOCKS_LABEL
@@ -24,6 +26,8 @@
  * - DT_INST_IO_CHANNELS_LABEL_BY_IDX
  * - DT_INST_IO_CHANNELS_LABEL_BY_NAME
  * - DT_INST_IO_CHANNELS_LABEL
+ * - DT_INST_DMAS_LABEL_BY_IDX
+ * - DT_INST_DMAS_LABEL_BY_NAME
  */
 #define __DEPRECATED_MACRO