Instance-based devicetree APIs

Macros
#define	DT_DRV_INST(inst)   DT_INST(inst, DT_DRV_COMPAT)
	Node identifier for an instance of a DT_DRV_COMPAT compatible.
#define	DT_INST_PARENT(inst)   DT_PARENT(DT_DRV_INST(inst))
	Get a DT_DRV_COMPAT parent's node identifier.
#define	DT_INST_GPARENT(inst)   DT_GPARENT(DT_DRV_INST(inst))
	Get a DT_DRV_COMPAT grandparent's node identifier.
#define	DT_INST_CHILD(inst, child)    DT_CHILD(DT_DRV_INST(inst), child)
	Get a node identifier for a child node of DT_DRV_INST(inst)
#define	DT_INST_FOREACH_CHILD(inst, fn)    DT_FOREACH_CHILD(DT_DRV_INST(inst), fn)
	Call fn on all child nodes of DT_DRV_INST(inst).
#define	DT_INST_FOREACH_CHILD_SEP(inst, fn, sep)    DT_FOREACH_CHILD_SEP(DT_DRV_INST(inst), fn, sep)
	Call fn on all child nodes of DT_DRV_INST(inst) with a separator.
#define	DT_INST_FOREACH_CHILD_VARGS(inst, fn, ...)    DT_FOREACH_CHILD_VARGS(DT_DRV_INST(inst), fn, __VA_ARGS__)
	Call fn on all child nodes of DT_DRV_INST(inst).
#define	DT_INST_FOREACH_CHILD_SEP_VARGS(inst, fn, sep, ...)    DT_FOREACH_CHILD_SEP_VARGS(DT_DRV_INST(inst), fn, sep, __VA_ARGS__)
	Call fn on all child nodes of DT_DRV_INST(inst) with separator.
#define	DT_INST_FOREACH_CHILD_STATUS_OKAY(inst, fn)    DT_FOREACH_CHILD_STATUS_OKAY(DT_DRV_INST(inst), fn)
	Call fn on all child nodes of DT_DRV_INST(inst) with status okay.
#define	DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP(inst, fn, sep)    DT_FOREACH_CHILD_STATUS_OKAY_SEP(DT_DRV_INST(inst), fn, sep)
	Call fn on all child nodes of DT_DRV_INST(inst) with status okay and with separator.
#define	DT_INST_FOREACH_CHILD_STATUS_OKAY_VARGS(inst, fn, ...)    DT_FOREACH_CHILD_STATUS_OKAY_VARGS(DT_DRV_INST(inst), fn, __VA_ARGS__)
	Call fn on all child nodes of DT_DRV_INST(inst) with status okay and multiple arguments.
#define	DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS(inst, fn, sep, ...)    DT_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS(DT_DRV_INST(inst), fn, sep, __VA_ARGS__)
	Call fn on all child nodes of DT_DRV_INST(inst) with status okay and with separator and multiple arguments.
#define	DT_INST_ENUM_IDX(inst, prop)    DT_ENUM_IDX(DT_DRV_INST(inst), prop)
	Get a DT_DRV_COMPAT value's index into its enumeration values.
#define	DT_INST_ENUM_IDX_OR(inst, prop, default_idx_value)    DT_ENUM_IDX_OR(DT_DRV_INST(inst), prop, default_idx_value)
	Like DT_INST_ENUM_IDX(), but with a fallback to a default enum index.
#define	DT_INST_ENUM_HAS_VALUE(inst, prop, value)    DT_ENUM_HAS_VALUE(DT_DRV_INST(inst), prop, value)
	Does a DT_DRV_COMPAT enumeration property have a given value?
#define	DT_INST_PROP(inst, prop)   DT_PROP(DT_DRV_INST(inst), prop)
	Get a DT_DRV_COMPAT instance property.
#define	DT_INST_PROP_LEN(inst, prop)   DT_PROP_LEN(DT_DRV_INST(inst), prop)
	Get a DT_DRV_COMPAT property length.
#define	DT_INST_PROP_HAS_IDX(inst, prop, idx)    DT_PROP_HAS_IDX(DT_DRV_INST(inst), prop, idx)
	Is index idx valid for an array type property on a DT_DRV_COMPAT instance?
#define	DT_INST_PROP_HAS_NAME(inst, prop, name)    DT_PROP_HAS_NAME(DT_DRV_INST(inst), prop, name)
	Is name name available in a foo-names property?
#define	DT_INST_PROP_BY_IDX(inst, prop, idx)    DT_PROP_BY_IDX(DT_DRV_INST(inst), prop, idx)
	Get a DT_DRV_COMPAT element value in an array property.
#define	DT_INST_PROP_OR(inst, prop, default_value)    DT_PROP_OR(DT_DRV_INST(inst), prop, default_value)
	Like DT_INST_PROP(), but with a fallback to default_value.
#define	DT_INST_PROP_LEN_OR(inst, prop, default_value)    DT_PROP_LEN_OR(DT_DRV_INST(inst), prop, default_value)
	Like DT_INST_PROP_LEN(), but with a fallback to default_value.
#define	DT_INST_STRING_TOKEN(inst, prop)    DT_STRING_TOKEN(DT_DRV_INST(inst), prop)
	Get a DT_DRV_COMPAT instance's string property's value as a token.
#define	DT_INST_STRING_UPPER_TOKEN(inst, prop)    DT_STRING_UPPER_TOKEN(DT_DRV_INST(inst), prop)
	Like DT_INST_STRING_TOKEN(), but uppercased.
#define	DT_INST_STRING_UNQUOTED(inst, prop)    DT_STRING_UNQUOTED(DT_DRV_INST(inst), prop)
	Get a DT_DRV_COMPAT instance's string property's value as an unquoted sequence of tokens.
#define	DT_INST_STRING_TOKEN_BY_IDX(inst, prop, idx)    DT_STRING_TOKEN_BY_IDX(DT_DRV_INST(inst), prop, idx)
	Get an element out of string-array property as a token.
#define	DT_INST_STRING_UPPER_TOKEN_BY_IDX(inst, prop, idx)    DT_STRING_UPPER_TOKEN_BY_IDX(DT_DRV_INST(inst), prop, idx)
	Like DT_INST_STRING_TOKEN_BY_IDX(), but uppercased.
#define	DT_INST_STRING_UNQUOTED_BY_IDX(inst, prop, idx)    DT_STRING_UNQUOTED_BY_IDX(DT_DRV_INST(inst), prop, idx)
	Get an element out of string-array property as an unquoted sequence of tokens.
#define	DT_INST_PROP_BY_PHANDLE(inst, ph, prop)    DT_INST_PROP_BY_PHANDLE_IDX(inst, ph, 0, prop)
	Get a DT_DRV_COMPAT instance's property value from a phandle's node.
#define	DT_INST_PROP_BY_PHANDLE_IDX(inst, phs, idx, prop)    DT_PROP_BY_PHANDLE_IDX(DT_DRV_INST(inst), phs, idx, prop)
	Get a DT_DRV_COMPAT instance's property value from a phandle in a property.
#define	DT_INST_PHA_BY_IDX(inst, pha, idx, cell)    DT_PHA_BY_IDX(DT_DRV_INST(inst), pha, idx, cell)
	Get a DT_DRV_COMPAT instance's phandle-array specifier value at an index.
#define	DT_INST_PHA_BY_IDX_OR(inst, pha, idx, cell, default_value)    DT_PHA_BY_IDX_OR(DT_DRV_INST(inst), pha, idx, cell, default_value)
	Like DT_INST_PHA_BY_IDX(), but with a fallback to default_value.
#define	DT_INST_PHA(inst, pha, cell)   DT_INST_PHA_BY_IDX(inst, pha, 0, cell)
	Get a DT_DRV_COMPAT instance's phandle-array specifier value Equivalent to DT_INST_PHA_BY_IDX(inst, pha, 0, cell)
#define	DT_INST_PHA_OR(inst, pha, cell, default_value)    DT_INST_PHA_BY_IDX_OR(inst, pha, 0, cell, default_value)
	Like DT_INST_PHA(), but with a fallback to default_value.
#define	DT_INST_PHA_BY_NAME(inst, pha, name, cell)    DT_PHA_BY_NAME(DT_DRV_INST(inst), pha, name, cell)
	Get a DT_DRV_COMPAT instance's value within a phandle-array specifier by name.
#define	DT_INST_PHA_BY_NAME_OR(inst, pha, name, cell, default_value)    DT_PHA_BY_NAME_OR(DT_DRV_INST(inst), pha, name, cell, default_value)
	Like DT_INST_PHA_BY_NAME(), but with a fallback to default_value.
#define	DT_INST_PHANDLE_BY_NAME(inst, pha, name)    DT_PHANDLE_BY_NAME(DT_DRV_INST(inst), pha, name) \
	Get a DT_DRV_COMPAT instance's phandle node identifier from a phandle array by name.
#define	DT_INST_PHANDLE_BY_IDX(inst, prop, idx)    DT_PHANDLE_BY_IDX(DT_DRV_INST(inst), prop, idx)
	Get a DT_DRV_COMPAT instance's node identifier for a phandle in a property.
#define	DT_INST_PHANDLE(inst, prop)   DT_INST_PHANDLE_BY_IDX(inst, prop, 0)
	Get a DT_DRV_COMPAT instance's node identifier for a phandle property's value.
#define	DT_INST_REG_HAS_IDX(inst, idx)   DT_REG_HAS_IDX(DT_DRV_INST(inst), idx)
	is idx a valid register block index on a DT_DRV_COMPAT instance?
#define	DT_INST_REG_ADDR_BY_IDX(inst, idx)   DT_REG_ADDR_BY_IDX(DT_DRV_INST(inst), idx)
	Get a DT_DRV_COMPAT instance's idx-th register block's address.
#define	DT_INST_REG_SIZE_BY_IDX(inst, idx)    DT_REG_SIZE_BY_IDX(DT_DRV_INST(inst), idx)
	Get a DT_DRV_COMPAT instance's idx-th register block's size.
#define	DT_INST_REG_ADDR_BY_NAME(inst, name)    DT_REG_ADDR_BY_NAME(DT_DRV_INST(inst), name)
	Get a DT_DRV_COMPAT's register block address by name.
#define	DT_INST_REG_ADDR_BY_NAME_U64(inst, name)    DT_U64_C(DT_INST_REG_ADDR_BY_NAME(inst, name))
	64-bit version of DT_INST_REG_ADDR_BY_NAME()
#define	DT_INST_REG_SIZE_BY_NAME(inst, name)    DT_REG_SIZE_BY_NAME(DT_DRV_INST(inst), name)
	Get a DT_DRV_COMPAT's register block size by name.
#define	DT_INST_REG_ADDR(inst)   DT_INST_REG_ADDR_BY_IDX(inst, 0)
	Get a DT_DRV_COMPAT's (only) register block address.
#define	DT_INST_REG_ADDR_U64(inst)   DT_U64_C(DT_INST_REG_ADDR(inst))
	64-bit version of DT_INST_REG_ADDR()
#define	DT_INST_REG_SIZE(inst)   DT_INST_REG_SIZE_BY_IDX(inst, 0)
	Get a DT_DRV_COMPAT's (only) register block size.
#define	DT_INST_IRQ_LEVEL(inst)   DT_IRQ_LEVEL(DT_DRV_INST(inst))
	Get a DT_DRV_COMPAT interrupt level.
#define	DT_INST_IRQ_BY_IDX(inst, idx, cell)    DT_IRQ_BY_IDX(DT_DRV_INST(inst), idx, cell)
	Get a DT_DRV_COMPAT interrupt specifier value at an index.
#define	DT_INST_IRQ_INTC_BY_IDX(inst, idx)    DT_IRQ_INTC_BY_IDX(DT_DRV_INST(inst), idx)
	Get a DT_DRV_COMPAT interrupt specifier's interrupt controller by index.
#define	DT_INST_IRQ_INTC_BY_NAME(inst, name)    DT_IRQ_INTC_BY_NAME(DT_DRV_INST(inst), name)
	Get a DT_DRV_COMPAT interrupt specifier's interrupt controller by name.
#define	DT_INST_IRQ_INTC(inst)    DT_INST_IRQ_INTC_BY_IDX(inst, 0)
	Get a DT_DRV_COMPAT interrupt specifier's interrupt controller.
#define	DT_INST_IRQ_BY_NAME(inst, name, cell)    DT_IRQ_BY_NAME(DT_DRV_INST(inst), name, cell)
	Get a DT_DRV_COMPAT interrupt specifier value by name.
#define	DT_INST_IRQ(inst, cell)   DT_INST_IRQ_BY_IDX(inst, 0, cell)
	Get a DT_DRV_COMPAT interrupt specifier's value.
#define	DT_INST_IRQN(inst)   DT_IRQN(DT_DRV_INST(inst))
	Get a DT_DRV_COMPAT's (only) irq number.
#define	DT_INST_IRQN_BY_IDX(inst, idx)   DT_IRQN_BY_IDX(DT_DRV_INST(inst), idx)
	Get a DT_DRV_COMPAT's irq number at index.
#define	DT_INST_BUS(inst)   DT_BUS(DT_DRV_INST(inst))
	Get a DT_DRV_COMPAT's bus node identifier.
#define	DT_INST_ON_BUS(inst, bus)   DT_ON_BUS(DT_DRV_INST(inst), bus)
	Test if a DT_DRV_COMPAT's bus type is a given type.
#define	DT_INST_STRING_TOKEN_OR(inst, name, default_value)    DT_STRING_TOKEN_OR(DT_DRV_INST(inst), name, default_value)
	Like DT_INST_STRING_TOKEN(), but with a fallback to default_value.
#define	DT_INST_STRING_UPPER_TOKEN_OR(inst, name, default_value)    DT_STRING_UPPER_TOKEN_OR(DT_DRV_INST(inst), name, default_value)
	Like DT_INST_STRING_UPPER_TOKEN(), but with a fallback to default_value.
#define	DT_INST_STRING_UNQUOTED_OR(inst, name, default_value)    DT_STRING_UNQUOTED_OR(DT_DRV_INST(inst), name, default_value)
	Like DT_INST_STRING_UNQUOTED(), but with a fallback to default_value.
#define	DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(compat, bus)    IS_ENABLED(DT_CAT4(DT_COMPAT_, compat, _BUS_, bus))
#define	DT_ANY_INST_ON_BUS_STATUS_OKAY(bus)    DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(DT_DRV_COMPAT, bus)
	Test if any DT_DRV_COMPAT node is on a bus of a given type and has status okay.
#define	DT_ANY_INST_HAS_PROP_STATUS_OKAY(prop)    COND_CODE_1(IS_EMPTY(DT_ANY_INST_HAS_PROP_STATUS_OKAY_(prop)), (0), (1))
	Check if any DT_DRV_COMPAT node with status okay has a given property.
#define	DT_INST_FOREACH_STATUS_OKAY(fn)
	Call fn on all nodes with compatible DT_DRV_COMPAT and status okay
#define	DT_INST_FOREACH_STATUS_OKAY_VARGS(fn, ...)
	Call fn on all nodes with compatible DT_DRV_COMPAT and status okay with multiple arguments.
#define	DT_INST_FOREACH_PROP_ELEM(inst, prop, fn)    DT_FOREACH_PROP_ELEM(DT_DRV_INST(inst), prop, fn)
	Invokes fn for each element of property prop for a DT_DRV_COMPAT instance.
#define	DT_INST_FOREACH_PROP_ELEM_SEP(inst, prop, fn, sep)    DT_FOREACH_PROP_ELEM_SEP(DT_DRV_INST(inst), prop, fn, sep)
	Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with a separator.
#define	DT_INST_FOREACH_PROP_ELEM_VARGS(inst, prop, fn, ...)    DT_FOREACH_PROP_ELEM_VARGS(DT_DRV_INST(inst), prop, fn, __VA_ARGS__)
	Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with multiple arguments.
#define	DT_INST_FOREACH_PROP_ELEM_SEP_VARGS(inst, prop, fn, sep, ...)
	Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with multiple arguments and a sepatator.
#define	DT_INST_NODE_HAS_PROP(inst, prop)    DT_NODE_HAS_PROP(DT_DRV_INST(inst), prop)
	Does a DT_DRV_COMPAT instance have a property?
#define	DT_INST_PHA_HAS_CELL_AT_IDX(inst, pha, idx, cell)    DT_PHA_HAS_CELL_AT_IDX(DT_DRV_INST(inst), pha, idx, cell)
	Does a phandle array have a named cell specifier at an index for a DT_DRV_COMPAT instance?
#define	DT_INST_PHA_HAS_CELL(inst, pha, cell)    DT_INST_PHA_HAS_CELL_AT_IDX(inst, pha, 0, cell)
	Does a phandle array have a named cell specifier at index 0 for a DT_DRV_COMPAT instance?
#define	DT_INST_IRQ_HAS_IDX(inst, idx)   DT_IRQ_HAS_IDX(DT_DRV_INST(inst), idx)
	is index valid for interrupt property on a DT_DRV_COMPAT instance?
#define	DT_INST_IRQ_HAS_CELL_AT_IDX(inst, idx, cell)    DT_IRQ_HAS_CELL_AT_IDX(DT_DRV_INST(inst), idx, cell)
	Does a DT_DRV_COMPAT instance have an interrupt named cell specifier?
#define	DT_INST_IRQ_HAS_CELL(inst, cell)    DT_INST_IRQ_HAS_CELL_AT_IDX(inst, 0, cell)
	Does a DT_DRV_COMPAT instance have an interrupt value?
#define	DT_INST_IRQ_HAS_NAME(inst, name)    DT_IRQ_HAS_NAME(DT_DRV_INST(inst), name)
	Does a DT_DRV_COMPAT instance have an interrupt value?

Detailed Description

Macro Definition Documentation

DT_ANY_INST_HAS_PROP_STATUS_OKAY

#define DT_ANY_INST_HAS_PROP_STATUS_OKAY

(

prop

)

COND_CODE_1(IS_EMPTY(DT_ANY_INST_HAS_PROP_STATUS_OKAY_(prop)), (0), (1))

#include <zephyr/devicetree.h>

Check if any DT_DRV_COMPAT node with status okay has a given property.

Parameters

prop	lowercase-and-underscores property name

Example devicetree overlay:

&i2c0 {
    sensor0: sensor@0 {
        compatible = "vnd,some-sensor";
        status = "okay";
        reg = <0>;
        foo = <1>;
        bar = <2>;
    };
 
    sensor1: sensor@1 {
        compatible = "vnd,some-sensor";
        status = "okay";
        reg = <1>;
        foo = <2>;
    };
 
    sensor2: sensor@2 {
        compatible = "vnd,some-sensor";
        status = "disabled";
        reg = <2>;
        baz = <1>;
    };
};

Example usage:

#define DT_DRV_COMPAT vnd_some_sensor
 
DT_ANY_INST_HAS_PROP_STATUS_OKAY(foo) // 1
DT_ANY_INST_HAS_PROP_STATUS_OKAY(bar) // 1
DT_ANY_INST_HAS_PROP_STATUS_OKAY(baz) // 0

DT_ANY_INST_ON_BUS_STATUS_OKAY

#define DT_ANY_INST_ON_BUS_STATUS_OKAY

(

bus

)

DT_HAS_COMPAT_ON_BUS_STATUS_OKAY(DT_DRV_COMPAT, bus)

#include <zephyr/devicetree.h>

Test if any DT_DRV_COMPAT node is on a bus of a given type and has status okay.

This is a special-purpose macro which can be useful when writing drivers for devices which can appear on multiple buses. One example is a sensor device which may be wired on an I2C or SPI bus.

Example devicetree overlay:

&i2c0 {
       temp: temperature-sensor@76 {
                compatible = "vnd,some-sensor";
                reg = <0x76>;
       };
};

Example usage, assuming i2c0 is an I2C bus controller node, and therefore temp is on an I2C bus:

#define DT_DRV_COMPAT vnd_some_sensor
 
DT_ANY_INST_ON_BUS_STATUS_OKAY(i2c) // 1

Parameters

bus	a binding's bus type as a C token, lowercased and without quotes

Returns

1 if any enabled node with that compatible is on that bus type, 0 otherwise

DT_DRV_INST

#define DT_DRV_INST

(

inst

)

DT_INST(inst, DT_DRV_COMPAT)

#include <zephyr/devicetree.h>

Node identifier for an instance of a DT_DRV_COMPAT compatible.

Parameters

inst	instance number

Returns

a node identifier for the node with DT_DRV_COMPAT compatible and instance number inst

DT_HAS_COMPAT_ON_BUS_STATUS_OKAY

#define DT_HAS_COMPAT_ON_BUS_STATUS_OKAY	(		compat,
			bus
	)		IS_ENABLED(DT_CAT4(DT_COMPAT_, compat, _BUS_, bus))

#include <zephyr/devicetree.h>

DT_INST_BUS

#define DT_INST_BUS

(

inst

)

DT_BUS(DT_DRV_INST(inst))

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's bus node identifier.

Parameters

inst	instance number

Returns

node identifier for the instance's bus node

DT_INST_CHILD

#define DT_INST_CHILD	(		inst,
			child
	)		DT_CHILD(DT_DRV_INST(inst), child)

#include <zephyr/devicetree.h>

Get a node identifier for a child node of DT_DRV_INST(inst)

Parameters

inst	instance number
child	lowercase-and-underscores child node name

Returns

node identifier for the node with the name referred to by 'child'

See also

DT_CHILD

DT_INST_ENUM_HAS_VALUE

#define DT_INST_ENUM_HAS_VALUE	(		inst,
			prop,
			value
	)		DT_ENUM_HAS_VALUE(DT_DRV_INST(inst), prop, value)

#include <zephyr/devicetree.h>

Does a DT_DRV_COMPAT enumeration property have a given value?

Parameters

inst	instance number
prop	lowercase-and-underscores property name
value	lowercase-and-underscores enumeration value

Returns

1 if the node property has the value value, 0 otherwise.

DT_INST_ENUM_IDX

#define DT_INST_ENUM_IDX	(		inst,
			prop
	)		DT_ENUM_IDX(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT value's index into its enumeration values.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

zero-based index of the property's value in its enum: list

DT_INST_ENUM_IDX_OR

#define DT_INST_ENUM_IDX_OR	(		inst,
			prop,
			default_idx_value
	)		DT_ENUM_IDX_OR(DT_DRV_INST(inst), prop, default_idx_value)

#include <zephyr/devicetree.h>

Like DT_INST_ENUM_IDX(), but with a fallback to a default enum index.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
default_idx_value	a fallback index value to expand to

Returns

zero-based index of the property's value in its enum if present, default_idx_value otherwise

DT_INST_FOREACH_CHILD

#define DT_INST_FOREACH_CHILD	(		inst,
			fn
	)		DT_FOREACH_CHILD(DT_DRV_INST(inst), fn)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst).

The macro fn should take one argument, which is the node identifier for the child node.

The children will be iterated over in the same order as they appear in the final devicetree.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier

See also

DT_FOREACH_CHILD

DT_INST_FOREACH_CHILD_SEP

#define DT_INST_FOREACH_CHILD_SEP	(		inst,
			fn,
			sep
	)		DT_FOREACH_CHILD_SEP(DT_DRV_INST(inst), fn, sep)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with a separator.

The macro fn should take one argument, which is the node identifier for the child node.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.

See also

DT_FOREACH_CHILD_SEP

DT_INST_FOREACH_CHILD_SEP_VARGS

#define DT_INST_FOREACH_CHILD_SEP_VARGS	(		inst,
			fn,
			sep,
			...
	)		DT_FOREACH_CHILD_SEP_VARGS(DT_DRV_INST(inst), fn, sep, __VA_ARGS__)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with separator.

The macro fn takes multiple arguments. The first should be the node identifier for the child node. The remaining are passed-in by the caller.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.
...	variable number of arguments to pass to fn

See also

DT_FOREACH_CHILD_SEP_VARGS

DT_INST_FOREACH_CHILD_STATUS_OKAY

#define DT_INST_FOREACH_CHILD_STATUS_OKAY	(		inst,
			fn
	)		DT_FOREACH_CHILD_STATUS_OKAY(DT_DRV_INST(inst), fn)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with status okay.

The macro fn should take one argument, which is the node identifier for the child node.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier

See also

DT_FOREACH_CHILD_STATUS_OKAY

DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP

#define DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP	(		inst,
			fn,
			sep
	)		DT_FOREACH_CHILD_STATUS_OKAY_SEP(DT_DRV_INST(inst), fn, sep)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with status okay and with separator.

The macro fn should take one argument, which is the node identifier for the child node.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.

See also

DT_FOREACH_CHILD_STATUS_OKAY_SEP

DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS

#define DT_INST_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS	(		inst,
			fn,
			sep,
			...
	)		DT_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS(DT_DRV_INST(inst), fn, sep, __VA_ARGS__)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with status okay and with separator and multiple arguments.

The macro fn takes multiple arguments. The first should be the node identifier for the child node. The remaining are passed-in by the caller.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.
...	variable number of arguments to pass to fn

See also

DT_FOREACH_CHILD_STATUS_OKAY_SEP_VARGS

DT_INST_FOREACH_CHILD_STATUS_OKAY_VARGS

#define DT_INST_FOREACH_CHILD_STATUS_OKAY_VARGS	(		inst,
			fn,
			...
	)		DT_FOREACH_CHILD_STATUS_OKAY_VARGS(DT_DRV_INST(inst), fn, __VA_ARGS__)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst) with status okay and multiple arguments.

The macro fn takes multiple arguments. The first should be the node identifier for the child node. The remaining are passed-in by the caller.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
...	variable number of arguments to pass to fn

See also

DT_FOREACH_CHILD_STATUS_OKAY_VARGS

DT_INST_FOREACH_CHILD_VARGS

#define DT_INST_FOREACH_CHILD_VARGS	(		inst,
			fn,
			...
	)		DT_FOREACH_CHILD_VARGS(DT_DRV_INST(inst), fn, __VA_ARGS__)

#include <zephyr/devicetree.h>

Call fn on all child nodes of DT_DRV_INST(inst).

The macro fn takes multiple arguments. The first should be the node identifier for the child node. The remaining are passed-in by the caller.

The children will be iterated over in the same order as they appear in the final devicetree.

Parameters

inst	instance number
fn	macro to invoke on each child node identifier
...	variable number of arguments to pass to fn

See also

DT_FOREACH_CHILD

DT_INST_FOREACH_PROP_ELEM

#define DT_INST_FOREACH_PROP_ELEM	(		inst,
			prop,
			fn
	)		DT_FOREACH_PROP_ELEM(DT_DRV_INST(inst), prop, fn)

#include <zephyr/devicetree.h>

Invokes fn for each element of property prop for a DT_DRV_COMPAT instance.

Equivalent to DT_FOREACH_PROP_ELEM(DT_DRV_INST(inst), prop, fn).

Parameters

inst	instance number
prop	lowercase-and-underscores property name
fn	macro to invoke

DT_INST_FOREACH_PROP_ELEM_SEP

#define DT_INST_FOREACH_PROP_ELEM_SEP	(		inst,
			prop,
			fn,
			sep
	)		DT_FOREACH_PROP_ELEM_SEP(DT_DRV_INST(inst), prop, fn, sep)

#include <zephyr/devicetree.h>

Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with a separator.

Equivalent to DT_FOREACH_PROP_ELEM_SEP(DT_DRV_INST(inst), prop, fn, sep).

Parameters

inst	instance number
prop	lowercase-and-underscores property name
fn	macro to invoke
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.

DT_INST_FOREACH_PROP_ELEM_SEP_VARGS

#define DT_INST_FOREACH_PROP_ELEM_SEP_VARGS	(		inst,
			prop,
			fn,
			sep,
			...
	)

#include <zephyr/devicetree.h>

Value:

        DT_FOREACH_PROP_ELEM_SEP_VARGS(DT_DRV_INST(inst), prop, fn, sep,        \
                                       __VA_ARGS__)

Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with multiple arguments and a sepatator.

Equivalent to DT_FOREACH_PROP_ELEM_SEP_VARGS(DT_DRV_INST(inst), prop, fn, sep, VA_ARGS)

Parameters

inst	instance number
prop	lowercase-and-underscores property name
fn	macro to invoke
sep	Separator (e.g. comma or semicolon). Must be in parentheses; this is required to enable providing a comma as separator.
...	variable number of arguments to pass to fn

See also

DT_INST_FOREACH_PROP_ELEM

DT_INST_FOREACH_PROP_ELEM_VARGS

#define DT_INST_FOREACH_PROP_ELEM_VARGS	(		inst,
			prop,
			fn,
			...
	)		DT_FOREACH_PROP_ELEM_VARGS(DT_DRV_INST(inst), prop, fn, __VA_ARGS__)

#include <zephyr/devicetree.h>

Invokes fn for each element of property prop for a DT_DRV_COMPAT instance with multiple arguments.

Equivalent to DT_FOREACH_PROP_ELEM_VARGS(DT_DRV_INST(inst), prop, fn, VA_ARGS)

Parameters

inst	instance number
prop	lowercase-and-underscores property name
fn	macro to invoke
...	variable number of arguments to pass to fn

See also

DT_INST_FOREACH_PROP_ELEM

DT_INST_FOREACH_STATUS_OKAY

#define DT_INST_FOREACH_STATUS_OKAY

(

fn

)

#include <zephyr/devicetree.h>

Value:

        COND_CODE_1(DT_HAS_COMPAT_STATUS_OKAY(DT_DRV_COMPAT),   \
                    (UTIL_CAT(DT_FOREACH_OKAY_INST_,            \
                              DT_DRV_COMPAT)(fn)),              \
                    ())

Call fn on all nodes with compatible DT_DRV_COMPAT and status okay

This macro calls fn(inst) on each inst number that refers to a node with status okay. Whitespace is added between invocations.

Example devicetree fragment:

a {
        compatible = "vnd,device";
        status = "okay";
        foobar = "DEV_A";
};
 
b {
        compatible = "vnd,device";
        status = "okay";
        foobar = "DEV_B";
};
 
c {
        compatible = "vnd,device";
        status = "disabled";
        foobar = "DEV_C";
};

Example usage:

#define DT_DRV_COMPAT vnd_device
#define MY_FN(inst) DT_INST_PROP(inst, foobar),
 
DT_INST_FOREACH_STATUS_OKAY(MY_FN)

This expands to:

MY_FN(0) MY_FN(1)

and from there, to either this:

"DEV_A", "DEV_B",

or this:

"DEV_B", "DEV_A",

No guarantees are made about the order that a and b appear in the expansion.

Note that fn is responsible for adding commas, semicolons, or other separators or terminators.

Device drivers should use this macro whenever possible to instantiate a struct device for each enabled node in the devicetree of the driver's compatible DT_DRV_COMPAT.

Parameters

fn	Macro to call for each enabled node. Must accept an instance number as its only parameter.

DT_INST_FOREACH_STATUS_OKAY_VARGS

#define DT_INST_FOREACH_STATUS_OKAY_VARGS	(		fn,
			...
	)

#include <zephyr/devicetree.h>

Value:

        COND_CODE_1(DT_HAS_COMPAT_STATUS_OKAY(DT_DRV_COMPAT),   \
                    (UTIL_CAT(DT_FOREACH_OKAY_INST_VARGS_,      \
                              DT_DRV_COMPAT)(fn, __VA_ARGS__)), \
                    ())

Call fn on all nodes with compatible DT_DRV_COMPAT and status okay with multiple arguments.

Parameters

fn	Macro to call for each enabled node. Must accept an instance number as its only parameter.
...	variable number of arguments to pass to fn

See also

DT_INST_FOREACH_STATUS_OKAY

DT_INST_GPARENT

#define DT_INST_GPARENT

(

inst

)

DT_GPARENT(DT_DRV_INST(inst))

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT grandparent's node identifier.

Parameters

inst	instance number

Returns

a node identifier for the instance's grandparent

See also

DT_GPARENT

DT_INST_IRQ

#define DT_INST_IRQ	(		inst,
			cell
	)		DT_INST_IRQ_BY_IDX(inst, 0, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier's value.

Parameters

inst	instance number
cell	cell name specifier

Returns

the named value at that index

DT_INST_IRQ_BY_IDX

#define DT_INST_IRQ_BY_IDX	(		inst,
			idx,
			cell
	)		DT_IRQ_BY_IDX(DT_DRV_INST(inst), idx, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier value at an index.

Parameters

inst	instance number
idx	logical index into the interrupt specifier array
cell	cell name specifier

Returns

the named value at the specifier given by the index

DT_INST_IRQ_BY_NAME

#define DT_INST_IRQ_BY_NAME	(		inst,
			name,
			cell
	)		DT_IRQ_BY_NAME(DT_DRV_INST(inst), name, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier value by name.

Parameters

inst	instance number
name	lowercase-and-underscores interrupt specifier name
cell	cell name specifier

Returns

the named value at the specifier given by the index

DT_INST_IRQ_HAS_CELL

#define DT_INST_IRQ_HAS_CELL	(		inst,
			cell
	)		DT_INST_IRQ_HAS_CELL_AT_IDX(inst, 0, cell)

#include <zephyr/devicetree.h>

Does a DT_DRV_COMPAT instance have an interrupt value?

Parameters

inst	instance number
cell	named cell value whose existence to check

Returns

1 if the named cell exists in the interrupt specifier at index 0 0 otherwise.

DT_INST_IRQ_HAS_CELL_AT_IDX

#define DT_INST_IRQ_HAS_CELL_AT_IDX	(		inst,
			idx,
			cell
	)		DT_IRQ_HAS_CELL_AT_IDX(DT_DRV_INST(inst), idx, cell)

#include <zephyr/devicetree.h>

Does a DT_DRV_COMPAT instance have an interrupt named cell specifier?

Parameters

inst	instance number
idx	index to check
cell	named cell value whose existence to check

Returns

1 if the named cell exists in the interrupt specifier at index idx 0 otherwise.

DT_INST_IRQ_HAS_IDX

#define DT_INST_IRQ_HAS_IDX	(		inst,
			idx
	)		DT_IRQ_HAS_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

is index valid for interrupt property on a DT_DRV_COMPAT instance?

Parameters

inst	instance number
idx	logical index into the interrupt specifier array

Returns

1 if the idx is valid for the interrupt property 0 otherwise.

DT_INST_IRQ_HAS_NAME

#define DT_INST_IRQ_HAS_NAME	(		inst,
			name
	)		DT_IRQ_HAS_NAME(DT_DRV_INST(inst), name)

#include <zephyr/devicetree.h>

Does a DT_DRV_COMPAT instance have an interrupt value?

Parameters

inst	instance number
name	lowercase-and-underscores interrupt specifier name

Returns

1 if name is a valid named specifier

DT_INST_IRQ_INTC

#define DT_INST_IRQ_INTC

(

inst

)

DT_INST_IRQ_INTC_BY_IDX(inst, 0)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier's interrupt controller.

Note

Equivalent to DT_INST_IRQ_INTC_BY_IDX(node_id, 0)

Parameters

inst	instance number

Returns

node_id of interrupt specifier's interrupt controller

See also

DT_INST_IRQ_INTC_BY_IDX()

DT_INST_IRQ_INTC_BY_IDX

#define DT_INST_IRQ_INTC_BY_IDX	(		inst,
			idx
	)		DT_IRQ_INTC_BY_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier's interrupt controller by index.

Parameters

inst	instance number
idx	interrupt specifier's index

Returns

node_id of interrupt specifier's interrupt controller

DT_INST_IRQ_INTC_BY_NAME

#define DT_INST_IRQ_INTC_BY_NAME	(		inst,
			name
	)		DT_IRQ_INTC_BY_NAME(DT_DRV_INST(inst), name)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt specifier's interrupt controller by name.

Parameters

inst	instance number
name	interrupt specifier's name

Returns

node_id of interrupt specifier's interrupt controller

DT_INST_IRQ_LEVEL

#define DT_INST_IRQ_LEVEL

(

inst

)

DT_IRQ_LEVEL(DT_DRV_INST(inst))

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT interrupt level.

Parameters

inst	instance number

Returns

interrupt level

DT_INST_IRQN

#define DT_INST_IRQN

(

inst

)

DT_IRQN(DT_DRV_INST(inst))

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's (only) irq number.

Parameters

inst	instance number

Returns

the interrupt number for the node's only interrupt

DT_INST_IRQN_BY_IDX

#define DT_INST_IRQN_BY_IDX	(		inst,
			idx
	)		DT_IRQN_BY_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's irq number at index.

Parameters

inst	instance number
idx	logical index into the interrupt specifier array

Returns

the interrupt number for the node's idx-th interrupt

DT_INST_NODE_HAS_PROP

#define DT_INST_NODE_HAS_PROP	(		inst,
			prop
	)		DT_NODE_HAS_PROP(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Does a DT_DRV_COMPAT instance have a property?

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

1 if the instance has the property, 0 otherwise.

DT_INST_ON_BUS

#define DT_INST_ON_BUS	(		inst,
			bus
	)		DT_ON_BUS(DT_DRV_INST(inst), bus)

#include <zephyr/devicetree.h>

Test if a DT_DRV_COMPAT's bus type is a given type.

Parameters

inst	instance number
bus	a binding's bus type as a C token, lowercased and without quotes

Returns

1 if the given instance is on a bus of the given type, 0 otherwise

DT_INST_PARENT

#define DT_INST_PARENT

(

inst

)

DT_PARENT(DT_DRV_INST(inst))

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT parent's node identifier.

Parameters

inst	instance number

Returns

a node identifier for the instance's parent

See also

DT_PARENT

DT_INST_PHA

#define DT_INST_PHA	(		inst,
			pha,
			cell
	)		DT_INST_PHA_BY_IDX(inst, pha, 0, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's phandle-array specifier value Equivalent to DT_INST_PHA_BY_IDX(inst, pha, 0, cell)

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
cell	binding's cell name for the specifier at pha index 0

Returns

the cell value

DT_INST_PHA_BY_IDX

#define DT_INST_PHA_BY_IDX	(		inst,
			pha,
			idx,
			cell
	)		DT_PHA_BY_IDX(DT_DRV_INST(inst), pha, idx, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's phandle-array specifier value at an index.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
idx	logical index into the property pha
cell	binding's cell name within the specifier at index idx

Returns

the value of the cell inside the specifier at index idx

DT_INST_PHA_BY_IDX_OR

#define DT_INST_PHA_BY_IDX_OR	(		inst,
			pha,
			idx,
			cell,
			default_value
	)		DT_PHA_BY_IDX_OR(DT_DRV_INST(inst), pha, idx, cell, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_PHA_BY_IDX(), but with a fallback to default_value.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
idx	logical index into the property pha
cell	binding's cell name within the specifier at index idx
default_value	a fallback value to expand to

Returns

DT_INST_PHA_BY_IDX(inst, pha, idx, cell) or default_value

DT_INST_PHA_BY_NAME

#define DT_INST_PHA_BY_NAME	(		inst,
			pha,
			name,
			cell
	)		DT_PHA_BY_NAME(DT_DRV_INST(inst), pha, name, cell)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's value within a phandle-array specifier by name.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
name	lowercase-and-underscores name of a specifier in pha
cell	binding's cell name for the named specifier

Returns

the cell value

DT_INST_PHA_BY_NAME_OR

#define DT_INST_PHA_BY_NAME_OR	(		inst,
			pha,
			name,
			cell,
			default_value
	)		DT_PHA_BY_NAME_OR(DT_DRV_INST(inst), pha, name, cell, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_PHA_BY_NAME(), but with a fallback to default_value.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
name	lowercase-and-underscores name of a specifier in pha
cell	binding's cell name for the named specifier
default_value	a fallback value to expand to

Returns

DT_INST_PHA_BY_NAME(inst, pha, name, cell) or default_value

DT_INST_PHA_HAS_CELL

#define DT_INST_PHA_HAS_CELL	(		inst,
			pha,
			cell
	)		DT_INST_PHA_HAS_CELL_AT_IDX(inst, pha, 0, cell)

#include <zephyr/devicetree.h>

Does a phandle array have a named cell specifier at index 0 for a DT_DRV_COMPAT instance?

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
cell	named cell value whose existence to check

Returns

1 if the named cell exists in the specifier at index 0, 0 otherwise.

DT_INST_PHA_HAS_CELL_AT_IDX

#define DT_INST_PHA_HAS_CELL_AT_IDX	(		inst,
			pha,
			idx,
			cell
	)		DT_PHA_HAS_CELL_AT_IDX(DT_DRV_INST(inst), pha, idx, cell)

#include <zephyr/devicetree.h>

Does a phandle array have a named cell specifier at an index for a DT_DRV_COMPAT instance?

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
idx	index to check
cell	named cell value whose existence to check

Returns

1 if the named cell exists in the specifier at index idx, 0 otherwise.

DT_INST_PHA_OR

#define DT_INST_PHA_OR	(		inst,
			pha,
			cell,
			default_value
	)		DT_INST_PHA_BY_IDX_OR(inst, pha, 0, cell, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_PHA(), but with a fallback to default_value.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
cell	binding's cell name for the specifier at pha index 0
default_value	a fallback value to expand to

Returns

DT_INST_PHA(inst, pha, cell) or default_value

DT_INST_PHANDLE

#define DT_INST_PHANDLE	(		inst,
			prop
	)		DT_INST_PHANDLE_BY_IDX(inst, prop, 0)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's node identifier for a phandle property's value.

Parameters

inst	instance number
prop	lowercase-and-underscores property of inst with type phandle

Returns

a node identifier for the node pointed to by "ph"

DT_INST_PHANDLE_BY_IDX

#define DT_INST_PHANDLE_BY_IDX	(		inst,
			prop,
			idx
	)		DT_PHANDLE_BY_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's node identifier for a phandle in a property.

Parameters

inst	instance number
prop	lowercase-and-underscores property name in inst with type phandle, phandles or phandle-array
idx	index into prop

Returns

a node identifier for the phandle at index idx in prop

DT_INST_PHANDLE_BY_NAME

#define DT_INST_PHANDLE_BY_NAME	(		inst,
			pha,
			name
	)		DT_PHANDLE_BY_NAME(DT_DRV_INST(inst), pha, name) \

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's phandle node identifier from a phandle array by name.

Parameters

inst	instance number
pha	lowercase-and-underscores property with type phandle-array
name	lowercase-and-underscores name of an element in pha

Returns

node identifier for the phandle at the element named "name"

DT_INST_PROP

#define DT_INST_PROP	(		inst,
			prop
	)		DT_PROP(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance property.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

a representation of the property's value

DT_INST_PROP_BY_IDX

#define DT_INST_PROP_BY_IDX	(		inst,
			prop,
			idx
	)		DT_PROP_BY_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT element value in an array property.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
idx	the index to get

Returns

a representation of the idx-th element of the property

DT_INST_PROP_BY_PHANDLE

#define DT_INST_PROP_BY_PHANDLE	(		inst,
			ph,
			prop
	)		DT_INST_PROP_BY_PHANDLE_IDX(inst, ph, 0, prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's property value from a phandle's node.

Parameters

inst	instance number
ph	lowercase-and-underscores property of inst with type phandle
prop	lowercase-and-underscores property of the phandle's node

Returns

the value of prop as described in the DT_PROP() documentation

DT_INST_PROP_BY_PHANDLE_IDX

#define DT_INST_PROP_BY_PHANDLE_IDX	(		inst,
			phs,
			idx,
			prop
	)		DT_PROP_BY_PHANDLE_IDX(DT_DRV_INST(inst), phs, idx, prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's property value from a phandle in a property.

Parameters

inst	instance number
phs	lowercase-and-underscores property with type phandle, phandles, or phandle-array
idx	logical index into "phs", which must be zero if "phs" has type phandle
prop	lowercase-and-underscores property of the phandle's node

Returns

the value of prop as described in the DT_PROP() documentation

DT_INST_PROP_HAS_IDX

#define DT_INST_PROP_HAS_IDX	(		inst,
			prop,
			idx
	)		DT_PROP_HAS_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Is index idx valid for an array type property on a DT_DRV_COMPAT instance?

Parameters

inst	instance number
prop	lowercase-and-underscores property name
idx	index to check

Returns

1 if idx is a valid index into the given property, 0 otherwise.

DT_INST_PROP_HAS_NAME

#define DT_INST_PROP_HAS_NAME	(		inst,
			prop,
			name
	)		DT_PROP_HAS_NAME(DT_DRV_INST(inst), prop, name)

#include <zephyr/devicetree.h>

Is name name available in a foo-names property?

Parameters

inst	instance number
prop	a lowercase-and-underscores prop-names type property
name	a lowercase-and-underscores name to check

Returns

An expression which evaluates to 1 if name is an available name into the given property, and 0 otherwise.

DT_INST_PROP_LEN

#define DT_INST_PROP_LEN	(		inst,
			prop
	)		DT_PROP_LEN(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT property length.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

logical length of the property

DT_INST_PROP_LEN_OR

#define DT_INST_PROP_LEN_OR	(		inst,
			prop,
			default_value
	)		DT_PROP_LEN_OR(DT_DRV_INST(inst), prop, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_PROP_LEN(), but with a fallback to default_value.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
default_value	a fallback value to expand to

Returns

DT_INST_PROP_LEN(inst, prop) or default_value

DT_INST_PROP_OR

#define DT_INST_PROP_OR	(		inst,
			prop,
			default_value
	)		DT_PROP_OR(DT_DRV_INST(inst), prop, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_PROP(), but with a fallback to default_value.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
default_value	a fallback value to expand to

Returns

DT_INST_PROP(inst, prop) or default_value

DT_INST_REG_ADDR

#define DT_INST_REG_ADDR

(

inst

)

DT_INST_REG_ADDR_BY_IDX(inst, 0)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's (only) register block address.

Parameters

inst	instance number

Returns

instance's register block address

DT_INST_REG_ADDR_BY_IDX

#define DT_INST_REG_ADDR_BY_IDX	(		inst,
			idx
	)		DT_REG_ADDR_BY_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's idx-th register block's address.

Parameters

inst	instance number
idx	index of the register whose address to return

Returns

address of the instance's idx-th register block

DT_INST_REG_ADDR_BY_NAME

#define DT_INST_REG_ADDR_BY_NAME	(		inst,
			name
	)		DT_REG_ADDR_BY_NAME(DT_DRV_INST(inst), name)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's register block address by name.

Parameters

inst	instance number
name	lowercase-and-underscores register specifier name

Returns

address of the register block with the given name

DT_INST_REG_ADDR_BY_NAME_U64

#define DT_INST_REG_ADDR_BY_NAME_U64	(		inst,
			name
	)		DT_U64_C(DT_INST_REG_ADDR_BY_NAME(inst, name))

#include <zephyr/devicetree.h>

64-bit version of DT_INST_REG_ADDR_BY_NAME()

This macro version adds the appropriate suffix for 64-bit unsigned integer literals. Note that this macro is equivalent to DT_INST_REG_ADDR_BY_NAME() in linker/ASM context.

Parameters

inst	instance number
name	lowercase-and-underscores register specifier name

Returns

address of the register block with the given name

DT_INST_REG_ADDR_U64

#define DT_INST_REG_ADDR_U64

(

inst

)

DT_U64_C(DT_INST_REG_ADDR(inst))

#include <zephyr/devicetree.h>

64-bit version of DT_INST_REG_ADDR()

This macro version adds the appropriate suffix for 64-bit unsigned integer literals. Note that this macro is equivalent to DT_INST_REG_ADDR() in linker/ASM context.

Parameters

inst	instance number

Returns

instance's register block address

DT_INST_REG_HAS_IDX

#define DT_INST_REG_HAS_IDX	(		inst,
			idx
	)		DT_REG_HAS_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

is idx a valid register block index on a DT_DRV_COMPAT instance?

Parameters

inst	instance number
idx	index to check

Returns

1 if idx is a valid register block index, 0 otherwise.

DT_INST_REG_SIZE

#define DT_INST_REG_SIZE

(

inst

)

DT_INST_REG_SIZE_BY_IDX(inst, 0)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's (only) register block size.

Parameters

inst	instance number

Returns

instance's register block size

DT_INST_REG_SIZE_BY_IDX

#define DT_INST_REG_SIZE_BY_IDX	(		inst,
			idx
	)		DT_REG_SIZE_BY_IDX(DT_DRV_INST(inst), idx)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's idx-th register block's size.

Parameters

inst	instance number
idx	index of the register whose size to return

Returns

size of the instance's idx-th register block

DT_INST_REG_SIZE_BY_NAME

#define DT_INST_REG_SIZE_BY_NAME	(		inst,
			name
	)		DT_REG_SIZE_BY_NAME(DT_DRV_INST(inst), name)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT's register block size by name.

Parameters

inst	instance number
name	lowercase-and-underscores register specifier name

Returns

size of the register block with the given name

DT_INST_STRING_TOKEN

#define DT_INST_STRING_TOKEN	(		inst,
			prop
	)		DT_STRING_TOKEN(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's string property's value as a token.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

the value of prop as a token, i.e. without any quotes and with special characters converted to underscores

DT_INST_STRING_TOKEN_BY_IDX

#define DT_INST_STRING_TOKEN_BY_IDX	(		inst,
			prop,
			idx
	)		DT_STRING_TOKEN_BY_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Get an element out of string-array property as a token.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
idx	the index to get

Returns

the element in prop at index idx as a token

DT_INST_STRING_TOKEN_OR

#define DT_INST_STRING_TOKEN_OR	(		inst,
			name,
			default_value
	)		DT_STRING_TOKEN_OR(DT_DRV_INST(inst), name, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_STRING_TOKEN(), but with a fallback to default_value.

Parameters

inst	instance number
name	lowercase-and-underscores property name
default_value	a fallback value to expand to

Returns

if prop exists, its value as a token, i.e. without any quotes and with special characters converted to underscores. Othewise default_value

DT_INST_STRING_UNQUOTED

#define DT_INST_STRING_UNQUOTED	(		inst,
			prop
	)		DT_STRING_UNQUOTED(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Get a DT_DRV_COMPAT instance's string property's value as an unquoted sequence of tokens.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

the value of prop as a sequence of tokens, with no quotes

DT_INST_STRING_UNQUOTED_BY_IDX

#define DT_INST_STRING_UNQUOTED_BY_IDX	(		inst,
			prop,
			idx
	)		DT_STRING_UNQUOTED_BY_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Get an element out of string-array property as an unquoted sequence of tokens.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
idx	the index to get

Returns

the value of prop at index idx as a sequence of tokens, with no quotes

DT_INST_STRING_UNQUOTED_OR

#define DT_INST_STRING_UNQUOTED_OR	(		inst,
			name,
			default_value
	)		DT_STRING_UNQUOTED_OR(DT_DRV_INST(inst), name, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_STRING_UNQUOTED(), but with a fallback to default_value.

Parameters

inst	instance number
name	lowercase-and-underscores property name
default_value	a fallback value to expand to

Returns

the property's value as a sequence of tokens, with no quotes, or default_value

DT_INST_STRING_UPPER_TOKEN

#define DT_INST_STRING_UPPER_TOKEN	(		inst,
			prop
	)		DT_STRING_UPPER_TOKEN(DT_DRV_INST(inst), prop)

#include <zephyr/devicetree.h>

Like DT_INST_STRING_TOKEN(), but uppercased.

Parameters

inst	instance number
prop	lowercase-and-underscores property name

Returns

the value of prop as an uppercased token, i.e. without any quotes and with special characters converted to underscores

DT_INST_STRING_UPPER_TOKEN_BY_IDX

#define DT_INST_STRING_UPPER_TOKEN_BY_IDX	(		inst,
			prop,
			idx
	)		DT_STRING_UPPER_TOKEN_BY_IDX(DT_DRV_INST(inst), prop, idx)

#include <zephyr/devicetree.h>

Like DT_INST_STRING_TOKEN_BY_IDX(), but uppercased.

Parameters

inst	instance number
prop	lowercase-and-underscores property name
idx	the index to get

Returns

the element in prop at index idx as an uppercased token

DT_INST_STRING_UPPER_TOKEN_OR

#define DT_INST_STRING_UPPER_TOKEN_OR	(		inst,
			name,
			default_value
	)		DT_STRING_UPPER_TOKEN_OR(DT_DRV_INST(inst), name, default_value)

#include <zephyr/devicetree.h>

Like DT_INST_STRING_UPPER_TOKEN(), but with a fallback to default_value.

Parameters

inst	instance number
name	lowercase-and-underscores property name
default_value	a fallback value to expand to

Returns

the property's value as an uppercased token, or default_value