Existence checks

Macros
#define	DT_NODE_EXISTS(node_id)   IS_ENABLED(DT_CAT(node_id, _EXISTS))
	Does a node identifier refer to a node? More...
#define	DT_NODE_HAS_STATUS(node_id, status)    DT_NODE_HAS_STATUS_INTERNAL(node_id, status)
	Does a node identifier refer to a node with a status? More...
#define	DT_HAS_COMPAT_STATUS_OKAY(compat)    IS_ENABLED(DT_CAT(DT_COMPAT_HAS_OKAY_, compat))
	Does the devicetree have a status "okay" node with a compatible? More...
#define	DT_NUM_INST_STATUS_OKAY(compat)
	Get the number of instances of a given compatible with status "okay". More...
#define	DT_NODE_HAS_COMPAT(node_id, compat)    IS_ENABLED(DT_CAT(node_id, _COMPAT_MATCHES_##compat))
	Does a devicetree node match a compatible? More...
#define	DT_NODE_HAS_COMPAT_STATUS(node_id, compat, status)    DT_NODE_HAS_COMPAT(node_id, compat) && DT_NODE_HAS_STATUS(node_id, status)
	Does a devicetree node have a compatible and status? More...
#define	DT_NODE_HAS_PROP(node_id, prop)    IS_ENABLED(DT_CAT(node_id, _P_##prop##_EXISTS))
	Does a devicetree node have a property? More...
#define	DT_PHA_HAS_CELL_AT_IDX(node_id, pha, idx, cell)
	Does a phandle array have a named cell specifier at an index? More...
#define	DT_PHA_HAS_CELL(node_id, pha, cell)    DT_PHA_HAS_CELL_AT_IDX(node_id, pha, 0, cell)
	Equivalent to DT_PHA_HAS_CELL_AT_IDX(node_id, pha, 0, cell) More...

Detailed Description

Macro Definition Documentation

DT_HAS_COMPAT_STATUS_OKAY

#define DT_HAS_COMPAT_STATUS_OKAY

(

compat

)

IS_ENABLED(DT_CAT(DT_COMPAT_HAS_OKAY_, compat))

#include <include/devicetree.h>

Does the devicetree have a status "okay" node with a compatible?

Test for whether the devicetree has any nodes with status "okay" and the given compatible. That is, this returns 1 if and only if there is at least one "node_id" for which both of these expressions return 1:

DT_NODE_HAS_STATUS(node_id, okay)
DT_NODE_HAS_COMPAT(node_id, compat)

As usual, both a missing status and an "ok" status are treated as "okay".

Parameters

compat

lowercase-and-underscores compatible, without quotes

Returns

1 if both of the above conditions are met, 0 otherwise

DT_NODE_EXISTS

#define DT_NODE_EXISTS

(

node_id

)

IS_ENABLED(DT_CAT(node_id, _EXISTS))

#include <include/devicetree.h>

Does a node identifier refer to a node?

Tests whether a node identifier refers to a node which exists, i.e. is defined in the devicetree.

It doesn't matter whether or not the node has a matching binding, or what the node's status value is. This is purely a check of whether the node exists at all.

Parameters

node_id

a node identifier

Returns

1 if the node identifier refers to a node, 0 otherwise.

DT_NODE_HAS_COMPAT

#define DT_NODE_HAS_COMPAT	(		node_id,
			compat
	)		IS_ENABLED(DT_CAT(node_id, _COMPAT_MATCHES_##compat))

#include <include/devicetree.h>

Does a devicetree node match a compatible?

Example devicetree fragment:

n: node {
        compatible = "vnd,specific-device", "generic-device";
}

Example usages which evaluate to 1:

DT_NODE_HAS_COMPAT(DT_NODELABEL(n), vnd_specific_device)
DT_NODE_HAS_COMPAT(DT_NODELABEL(n), generic_device)

This macro only uses the value of the compatible property. Whether or not a particular compatible has a matching binding has no effect on its value, nor does the node's status.

Parameters

node_id	node identifier
compat	lowercase-and-underscores compatible, without quotes

Returns

1 if the node's compatible property contains compat, 0 otherwise.

DT_NODE_HAS_COMPAT_STATUS

#define DT_NODE_HAS_COMPAT_STATUS	(		node_id,
			compat,
			status
	)		DT_NODE_HAS_COMPAT(node_id, compat) && DT_NODE_HAS_STATUS(node_id, status)

#include <include/devicetree.h>

Does a devicetree node have a compatible and status?

This is equivalent to:

(DT_NODE_HAS_COMPAT(node_id, compat) &&
 DT_NODE_HAS_STATUS(node_id, status))

Parameters

node_id	node identifier
compat	lowercase-and-underscores compatible, without quotes
status	okay or disabled as a token, not a string

DT_NODE_HAS_PROP

#define DT_NODE_HAS_PROP	(		node_id,
			prop
	)		IS_ENABLED(DT_CAT(node_id, _P_##prop##_EXISTS))

#include <include/devicetree.h>

Does a devicetree node have a property?

Tests whether a devicetree node has a property defined.

This tests whether the property is defined at all, not whether a boolean property is true or false. To get a boolean property's truth value, use DT_PROP(node_id, prop) instead.

Parameters

node_id	node identifier
prop	lowercase-and-underscores property name

Returns

1 if the node has the property, 0 otherwise.

DT_NODE_HAS_STATUS

#define DT_NODE_HAS_STATUS	(		node_id,
			status
	)		DT_NODE_HAS_STATUS_INTERNAL(node_id, status)

#include <include/devicetree.h>

Does a node identifier refer to a node with a status?

Example uses:

DT_NODE_HAS_STATUS(DT_PATH(soc, i2c_12340000), okay)
DT_NODE_HAS_STATUS(DT_PATH(soc, i2c_12340000), disabled)

Tests whether a node identifier refers to a node which:

• exists in the devicetree, and
• has a status property matching the second argument (except that either a missing status or an "ok" status in the devicetree is treated as if it were "okay" instead)

Parameters

node_id	a node identifier
status	a status as one of the tokens okay or disabled, not a string

Returns

1 if the node has the given status, 0 otherwise.

DT_NUM_INST_STATUS_OKAY

#define DT_NUM_INST_STATUS_OKAY

(

compat

)

#include <include/devicetree.h>

Value:

        UTIL_AND(DT_HAS_COMPAT_STATUS_OKAY(compat),             \
                 UTIL_CAT(DT_N_INST, DT_DASH(compat, NUM_OKAY)))

Get the number of instances of a given compatible with status "okay".

Parameters

compat

lowercase-and-underscores compatible, without quotes

Returns

Number of instances with status "okay"

DT_PHA_HAS_CELL

#define DT_PHA_HAS_CELL	(		node_id,
			pha,
			cell
	)		DT_PHA_HAS_CELL_AT_IDX(node_id, pha, 0, cell)

#include <include/devicetree.h>

Equivalent to DT_PHA_HAS_CELL_AT_IDX(node_id, pha, 0, cell)

Parameters

node_id	node identifier
pha	lowercase-and-underscores property with type "phandle-array"
cell	lowercase-and-underscores cell name whose existence to check at index "idx"

Returns

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

DT_PHA_HAS_CELL_AT_IDX

#define DT_PHA_HAS_CELL_AT_IDX	(		node_id,
			pha,
			idx,
			cell
	)

#include <include/devicetree.h>

Value:

        IS_ENABLED(DT_PROP(node_id,                                 \
                           pha##_IDX_##idx##_VAL_##cell##_EXISTS))

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

If this returns 1, then the phandle-array property "pha" has a cell named "cell" at index "idx", and therefore DT_PHA_BY_IDX(node_id, pha, idx, cell) is valid. If it returns 0, it's an error to use DT_PHA_BY_IDX() with the same arguments.

Parameters

node_id	node identifier
pha	lowercase-and-underscores property with type "phandle-array"
idx	index to check within "pha"
cell	lowercase-and-underscores cell name whose existence to check at index "idx"

Returns

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