Skip to content

Commit b813616

Browse files
committed
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]>
1 parent 9c02cad commit b813616

File tree

3 files changed

+14
-0
lines changed

3 files changed

+14
-0
lines changed

doc/releases/release-notes-2.6.rst

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -51,6 +51,12 @@ Deprecated in this release
5151
:c:macro:`DT_INST_IO_CHANNELS_LABEL` were deprecated in favor of utilizing
5252
:c:macro:`DT_IO_CHANNELS_CTLR` and variants.
5353

54+
* :c:macro:`DT_DMAS_LABEL_BY_IDX`,
55+
:c:macro:`DT_DMAS_LABEL_BY_NAME`,
56+
:c:macro:`DT_INST_DMAS_LABEL_BY_IDX`, and
57+
:c:macro:`DT_INST_DMAS_LABEL_BY_NAME` were deprecated in favor of utilizing
58+
:c:macro:`DT_DMAS_CTLR` and variants.
59+
5460
* USB HID specific macros in ``<include/usb/class/usb_hid.h>`` are deprecated
5561
in favor of new common HID macros defined in ``<include/usb/class/hid.h>``.
5662

include/devicetree/dma.h

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ extern "C" {
5353
* @return the label property of the node referenced at index "idx"
5454
*/
5555
#define DT_DMAS_LABEL_BY_IDX(node_id, idx) \
56+
__DEPRECATED_MACRO \
5657
DT_PROP_BY_PHANDLE_IDX(node_id, dmas, idx, label)
5758

5859
/**
@@ -64,6 +65,7 @@ extern "C" {
6465
* @see DT_DMAS_LABEL_BY_IDX()
6566
*/
6667
#define DT_INST_DMAS_LABEL_BY_IDX(inst, idx) \
68+
__DEPRECATED_MACRO \
6769
DT_DMAS_LABEL_BY_IDX(DT_DRV_INST(inst), idx)
6870

6971
/**
@@ -99,6 +101,7 @@ extern "C" {
99101
* @return the label property of the node referenced at the named element
100102
*/
101103
#define DT_DMAS_LABEL_BY_NAME(node_id, name) \
104+
__DEPRECATED_MACRO \
102105
DT_PROP(DT_PHANDLE_BY_NAME(node_id, dmas, name), label)
103106

104107
/**
@@ -178,6 +181,7 @@ extern "C" {
178181
* @see DT_DMAS_LABEL_BY_NAME()
179182
*/
180183
#define DT_INST_DMAS_LABEL_BY_NAME(inst, name) \
184+
__DEPRECATED_MACRO \
181185
DT_DMAS_LABEL_BY_NAME(DT_DRV_INST(inst), name)
182186

183187
/**

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

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,8 @@
1515
* - DT_IO_CHANNELS_LABEL_BY_IDX
1616
* - DT_IO_CHANNELS_LABEL_BY_NAME
1717
* - DT_IO_CHANNELS_LABEL
18+
* - DT_DMAS_LABEL_BY_IDX
19+
* - DT_DMAS_LABEL_BY_NAME
1820
* - DT_INST_CLOCKS_LABEL_BY_IDX
1921
* - DT_INST_CLOCKS_LABEL_BY_NAME
2022
* - DT_INST_CLOCKS_LABEL
@@ -24,6 +26,8 @@
2426
* - DT_INST_IO_CHANNELS_LABEL_BY_IDX
2527
* - DT_INST_IO_CHANNELS_LABEL_BY_NAME
2628
* - DT_INST_IO_CHANNELS_LABEL
29+
* - DT_INST_DMAS_LABEL_BY_IDX
30+
* - DT_INST_DMAS_LABEL_BY_NAME
2731
*/
2832
#define __DEPRECATED_MACRO
2933

0 commit comments

Comments
 (0)