I3C Devicetree related bits. More...

Macros
#define	I3C_DEVICE_ID_DT(node_id)
	Structure initializer for i3c_device_id from devicetree.

#define	I3C_DEVICE_ID_DT_INST(inst) I3C_DEVICE_ID_DT(DT_DRV_INST(inst))
	Structure initializer for i3c_device_id from devicetree instance.

#define	I3C_DEVICE_DESC_DT(node_id)
	Structure initializer for i3c_device_desc from devicetree.

#define	I3C_DEVICE_DESC_DT_INST(inst) I3C_DEVICE_DESC_DT(DT_DRV_INST(inst))
	Structure initializer for i3c_device_desc from devicetree instance.

#define	I3C_DEVICE_DESC_DT_FILTERED(node_id)
	Structure initializer for i3c_device_desc from devicetree.

#define	I3C_DEVICE_ARRAY_DT(node_id)
	Array initializer for a list of i3c_device_desc from devicetree.

#define	I3C_DEVICE_ARRAY_DT_INST(inst) I3C_DEVICE_ARRAY_DT(DT_DRV_INST(inst))
	Array initializer for a list of i3c_device_desc from devicetree instance.

#define	I3C_DEVICE_DT_DEFINE(node_id, init_fn, pm, data, config, level, prio, api, ...)
	Like DEVICE_DT_DEFINE() with I3C target device specifics.

#define	I3C_DEVICE_DT_INST_DEFINE(inst, ...) I3C_DEVICE_DT_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)
	Like I3C_TARGET_DT_DEFINE() for an instance of a DT_DRV_COMPAT compatible.

#define	I3C_I2C_DEVICE_DESC_DT(node_id)
	Structure initializer for i3c_i2c_device_desc from devicetree.

#define	I3C_I2C_DEVICE_DESC_DT_INST(inst) I3C_I2C_DEVICE_DESC_DT(DT_DRV_INST(inst))
	Structure initializer for i3c_i2c_device_desc from devicetree instance.

#define	I3C_I2C_DEVICE_DESC_DT_FILTERED(node_id)
	Structure initializer for i3c_i2c_device_desc from devicetree.

#define	I3C_I2C_DEVICE_ARRAY_DT(node_id)
	Array initializer for a list of i3c_i2c_device_desc from devicetree.

#define	I3C_I2C_DEVICE_ARRAY_DT_INST(inst) I3C_I2C_DEVICE_ARRAY_DT(DT_DRV_INST(inst))
	Array initializer for a list of i3c_i2c_device_desc from devicetree instance.

Detailed Description

I3C Devicetree related bits.

Macro Definition Documentation

◆ I3C_DEVICE_ARRAY_DT

#define I3C_DEVICE_ARRAY_DT ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

        {                                                               \
                DT_FOREACH_CHILD_STATUS_OKAY(                           \
                        node_id,                                        \
                        I3C_DEVICE_DESC_DT_FILTERED)                    \
        }

Array initializer for a list of i3c_device_desc from devicetree.

This is a helper macro to generate an array for a list of i3c_device_desc from device tree.

Parameters

node_id Devicetree node identifier of the I3C controller

◆ I3C_DEVICE_ARRAY_DT_INST

#define I3C_DEVICE_ARRAY_DT_INST ( inst ) I3C_DEVICE_ARRAY_DT(DT_DRV_INST(inst))

#include <include/zephyr/drivers/i3c/devicetree.h>

Array initializer for a list of i3c_device_desc from devicetree instance.

This is equivalent to I3C_DEVICE_ARRAY_DT(DT_DRV_INST(inst)).

Parameters

inst	Devicetree instance number of the I3C controller

◆ I3C_DEVICE_DESC_DT

#define I3C_DEVICE_DESC_DT ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

        {                                                               \
                .bus = DEVICE_DT_GET(DT_BUS(node_id)),                  \
                .dev = DEVICE_DT_GET(node_id),                          \
                .static_addr = DT_PROP_BY_IDX(node_id, reg, 0),         \
                .pid = ((uint64_t)DT_PROP_BY_IDX(node_id, reg, 1) << 32)\
                       | DT_PROP_BY_IDX(node_id, reg, 2),               \
                .init_dynamic_addr =                                    \
                        DT_PROP_OR(node_id, assigned_address, 0),       \
        },

Structure initializer for i3c_device_desc from devicetree.

This helper macro expands to a static initializer for a struct i3c_device_desc by reading the relevant bus and device data from the devicetree.

Parameters

node_id Devicetree node identifier for the I3C device whose struct i3c_device_desc to create an initializer for

◆ I3C_DEVICE_DESC_DT_FILTERED

#define I3C_DEVICE_DESC_DT_FILTERED ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

COND_CODE_0(DT_PROP_BY_IDX(node_id, reg, 1), \

(), (I3C_DEVICE_DESC_DT(node_id)))

I3C_DEVICE_DESC_DT

#define I3C_DEVICE_DESC_DT(node_id)

Structure initializer for i3c_device_desc from devicetree.

Definition devicetree.h:62

COND_CODE_0

#define COND_CODE_0(_flag, _if_0_code, _else_code)

Like COND_CODE_1() except tests if _flag is 0.

Definition util_macro.h:195

Structure initializer for i3c_device_desc from devicetree.

This is mainly used by I3C_DEVICE_ARRAY_DT() to only create a struct if and only if it is an I3C device.

◆ I3C_DEVICE_DESC_DT_INST

#define I3C_DEVICE_DESC_DT_INST ( inst ) I3C_DEVICE_DESC_DT(DT_DRV_INST(inst))

#include <include/zephyr/drivers/i3c/devicetree.h>

Structure initializer for i3c_device_desc from devicetree instance.

This is equivalent to I3C_DEVICE_DESC_DT(DT_DRV_INST(inst)).

Parameters

inst	Devicetree instance number

◆ I3C_DEVICE_DT_DEFINE

#define I3C_DEVICE_DT_DEFINE	(	node_id,
		init_fn,
		pm,
		data,
		config,
		level,
		prio,
		api,
		...
	)

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

DEVICE_DT_DEFINE(node_id, init_fn, pm, data, config, level, \

prio, api, __VA_ARGS__)

DEVICE_DT_DEFINE

#define DEVICE_DT_DEFINE(node_id, init_fn, pm, data, config, level, prio, api,...)

Create a device object from a devicetree node identifier and set it up for boot time initialization.

Definition device.h:195

init_fn

static int init_fn(void)

Definition main.c:263

data

static fdata_t data[2]

Definition test_fifo_contexts.c:15

Like DEVICE_DT_DEFINE() with I3C target device specifics.

Defines a I3C target device which implements the I3C target device API.

Parameters

node_id	The devicetree node identifier.
init_fn	Name of the init function of the driver.
pm	PM device resources reference (NULL if device does not use PM).
data	Pointer to the device's private data.
config	The address to the structure containing the configuration information for this instance of the driver.
level	The initialization level. See SYS_INIT() for details.
prio	Priority within the selected initialization level. See SYS_INIT() for details.
api	Provides an initial pointer to the API function struct used by the driver. Can be NULL.

◆ I3C_DEVICE_DT_INST_DEFINE

#define I3C_DEVICE_DT_INST_DEFINE	(	inst,
		...
	)	I3C_DEVICE_DT_DEFINE(DT_DRV_INST(inst), __VA_ARGS__)

#include <include/zephyr/drivers/i3c/devicetree.h>

Like I3C_TARGET_DT_DEFINE() for an instance of a DT_DRV_COMPAT compatible.

Parameters

inst	instance number. This is replaced by `DT_DRV_COMPAT(inst)` in the call to I3C_TARGET_DT_DEFINE().
...	other parameters as expected by I3C_TARGET_DT_DEFINE().

◆ I3C_DEVICE_ID_DT

#define I3C_DEVICE_ID_DT ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

        {                                                               \
                .pid = ((uint64_t)DT_PROP_BY_IDX(node_id, reg, 1) << 32)\
                       | DT_PROP_BY_IDX(node_id, reg, 2),               \
        }

Structure initializer for i3c_device_id from devicetree.

This helper macro expands to a static initializer for a struct i3c_device_id by reading the relevant device data from devicetree.

Parameters

node_id Devicetree node identifier for the I3C device whose struct i3c_device_id to create an initializer for

◆ I3C_DEVICE_ID_DT_INST

#define I3C_DEVICE_ID_DT_INST ( inst ) I3C_DEVICE_ID_DT(DT_DRV_INST(inst))

#include <include/zephyr/drivers/i3c/devicetree.h>

Structure initializer for i3c_device_id from devicetree instance.

This is equivalent to I3C_DEVICE_ID_DT(DT_DRV_INST(inst)).

Parameters

inst	Devicetree instance number

◆ I3C_I2C_DEVICE_ARRAY_DT

#define I3C_I2C_DEVICE_ARRAY_DT ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

        {                                                               \
                DT_FOREACH_CHILD_STATUS_OKAY(                           \
                        node_id,                                        \
                        I3C_I2C_DEVICE_DESC_DT_FILTERED)                \
        }

Array initializer for a list of i3c_i2c_device_desc from devicetree.

This is a helper macro to generate an array for a list of i3c_i2c_device_desc from device tree.

Parameters

node_id Devicetree node identifier of the I3C controller

◆ I3C_I2C_DEVICE_ARRAY_DT_INST

#define I3C_I2C_DEVICE_ARRAY_DT_INST ( inst ) I3C_I2C_DEVICE_ARRAY_DT(DT_DRV_INST(inst))

#include <include/zephyr/drivers/i3c/devicetree.h>

Array initializer for a list of i3c_i2c_device_desc from devicetree instance.

This is equivalent to I3C_I2C_DEVICE_ARRAY_DT(DT_DRV_INST(inst)).

Parameters

inst	Devicetree instance number of the I3C controller

◆ I3C_I2C_DEVICE_DESC_DT

#define I3C_I2C_DEVICE_DESC_DT ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

        {                                                               \
                .bus = DEVICE_DT_GET(DT_BUS(node_id)),                  \
                .addr = DT_PROP_BY_IDX(node_id, reg, 0),                \
                .lvr = DT_PROP_BY_IDX(node_id, reg, 2),                 \
        },

Structure initializer for i3c_i2c_device_desc from devicetree.

This helper macro expands to a static initializer for a struct i3c_i2c_device_desc by reading the relevant bus and device data from the devicetree.

Parameters

node_id Devicetree node identifier for the I3C device whose struct i3c_i2c_device_desc to create an initializer for

◆ I3C_I2C_DEVICE_DESC_DT_FILTERED

#define I3C_I2C_DEVICE_DESC_DT_FILTERED ( node_id )

#include <include/zephyr/drivers/i3c/devicetree.h>

Value:

COND_CODE_0(DT_PROP_BY_IDX(node_id, reg, 1), \

(I3C_I2C_DEVICE_DESC_DT(node_id)), ())

I3C_I2C_DEVICE_DESC_DT

#define I3C_I2C_DEVICE_DESC_DT(node_id)

Structure initializer for i3c_i2c_device_desc from devicetree.

Definition devicetree.h:171

Structure initializer for i3c_i2c_device_desc from devicetree.

This is mainly used by I3C_I2C_DEVICE_ARRAY_DT() to only create a struct if and only if it is an I2C device.

◆ I3C_I2C_DEVICE_DESC_DT_INST

#define I3C_I2C_DEVICE_DESC_DT_INST ( inst ) I3C_I2C_DEVICE_DESC_DT(DT_DRV_INST(inst))

#include <include/zephyr/drivers/i3c/devicetree.h>

Structure initializer for i3c_i2c_device_desc from devicetree instance.

This is equivalent to I3C_I2C_DEVICE_DESC_DT(DT_DRV_INST(inst)).

Parameters

inst	Devicetree instance number

Macros

Detailed Description

Macro Definition Documentation

◆ I3C_DEVICE_ARRAY_DT

◆ I3C_DEVICE_ARRAY_DT_INST

◆ I3C_DEVICE_DESC_DT

◆ I3C_DEVICE_DESC_DT_FILTERED

◆ I3C_DEVICE_DESC_DT_INST

◆ I3C_DEVICE_DT_DEFINE

◆ I3C_DEVICE_DT_INST_DEFINE

◆ I3C_DEVICE_ID_DT

◆ I3C_DEVICE_ID_DT_INST

◆ I3C_I2C_DEVICE_ARRAY_DT

◆ I3C_I2C_DEVICE_ARRAY_DT_INST

◆ I3C_I2C_DEVICE_DESC_DT

◆ I3C_I2C_DEVICE_DESC_DT_FILTERED

◆ I3C_I2C_DEVICE_DESC_DT_INST