Access layer. More...

Data Structures
struct	bt_mesh_elem

struct	bt_mesh_model_op

struct	bt_mesh_model_pub

struct	bt_mesh_models_metadata_entry

struct	bt_mesh_model_cb

struct	bt_mesh_mod_id_vnd

struct	bt_mesh_model

struct	bt_mesh_send_cb

struct	bt_mesh_comp

Macros
#define	BT_MESH_ADDR_UNASSIGNED 0x0000

#define	BT_MESH_ADDR_ALL_NODES 0xffff

#define	BT_MESH_ADDR_RELAYS 0xfffe

#define	BT_MESH_ADDR_FRIENDS 0xfffd

#define	BT_MESH_ADDR_PROXIES 0xfffc

#define	BT_MESH_ADDR_DFW_NODES 0xfffb

#define	BT_MESH_ADDR_IP_NODES 0xfffa

#define	BT_MESH_ADDR_IP_BR_ROUTERS 0xfff9

#define	BT_MESH_KEY_UNUSED 0xffff

#define	BT_MESH_KEY_ANY 0xffff

#define	BT_MESH_KEY_DEV 0xfffe

#define	BT_MESH_KEY_DEV_LOCAL BT_MESH_KEY_DEV

#define	BT_MESH_KEY_DEV_REMOTE 0xfffd

#define	BT_MESH_KEY_DEV_ANY 0xfffc

#define	BT_MESH_ADDR_IS_UNICAST(addr) ((addr) && (addr) < 0x8000)

#define	BT_MESH_ADDR_IS_GROUP(addr) ((addr) >= 0xc000 && (addr) < 0xff00)

#define	BT_MESH_ADDR_IS_FIXED_GROUP(addr) ((addr) >= 0xff00 && (addr) < 0xffff)

#define	BT_MESH_ADDR_IS_VIRTUAL(addr) ((addr) >= 0x8000 && (addr) < 0xc000)

#define	BT_MESH_ADDR_IS_RFU(addr) ((addr) >= 0xff00 && (addr) <= 0xfff8)

#define	BT_MESH_IS_DEV_KEY(key)

#define	BT_MESH_APP_SEG_SDU_MAX 12

#define	BT_MESH_APP_UNSEG_SDU_MAX 15

#define	BT_MESH_RX_SEG_MAX 0

#define	BT_MESH_TX_SEG_MAX 0

#define	BT_MESH_TX_SDU_MAX

#define	BT_MESH_RX_SDU_MAX

#define	BT_MESH_ELEM(_loc, _mods, _vnd_mods)

#define	BT_MESH_MODEL_ID_CFG_SRV 0x0000

#define	BT_MESH_MODEL_ID_CFG_CLI 0x0001

#define	BT_MESH_MODEL_ID_HEALTH_SRV 0x0002

#define	BT_MESH_MODEL_ID_HEALTH_CLI 0x0003

#define	BT_MESH_MODEL_ID_REMOTE_PROV_SRV 0x0004

#define	BT_MESH_MODEL_ID_REMOTE_PROV_CLI 0x0005

#define	BT_MESH_MODEL_ID_PRIV_BEACON_SRV 0x000a

#define	BT_MESH_MODEL_ID_PRIV_BEACON_CLI 0x000b

#define	BT_MESH_MODEL_ID_SAR_CFG_SRV 0x000e

#define	BT_MESH_MODEL_ID_SAR_CFG_CLI 0x000f

#define	BT_MESH_MODEL_ID_OP_AGG_SRV 0x0010

#define	BT_MESH_MODEL_ID_OP_AGG_CLI 0x0011

#define	BT_MESH_MODEL_ID_LARGE_COMP_DATA_SRV 0x0012

#define	BT_MESH_MODEL_ID_LARGE_COMP_DATA_CLI 0x0013

#define	BT_MESH_MODEL_ID_SOL_PDU_RPL_SRV 0x0014

#define	BT_MESH_MODEL_ID_SOL_PDU_RPL_CLI 0x0015

#define	BT_MESH_MODEL_ID_ON_DEMAND_PROXY_SRV 0x000c

#define	BT_MESH_MODEL_ID_ON_DEMAND_PROXY_CLI 0x000d

#define	BT_MESH_MODEL_ID_GEN_ONOFF_SRV 0x1000

#define	BT_MESH_MODEL_ID_GEN_ONOFF_CLI 0x1001

#define	BT_MESH_MODEL_ID_GEN_LEVEL_SRV 0x1002

#define	BT_MESH_MODEL_ID_GEN_LEVEL_CLI 0x1003

#define	BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_SRV 0x1004

#define	BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_CLI 0x1005

#define	BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SRV 0x1006

#define	BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SETUP_SRV 0x1007

#define	BT_MESH_MODEL_ID_GEN_POWER_ONOFF_CLI 0x1008

#define	BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SRV 0x1009

#define	BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SETUP_SRV 0x100a

#define	BT_MESH_MODEL_ID_GEN_POWER_LEVEL_CLI 0x100b

#define	BT_MESH_MODEL_ID_GEN_BATTERY_SRV 0x100c

#define	BT_MESH_MODEL_ID_GEN_BATTERY_CLI 0x100d

#define	BT_MESH_MODEL_ID_GEN_LOCATION_SRV 0x100e

#define	BT_MESH_MODEL_ID_GEN_LOCATION_SETUPSRV 0x100f

#define	BT_MESH_MODEL_ID_GEN_LOCATION_CLI 0x1010

#define	BT_MESH_MODEL_ID_GEN_ADMIN_PROP_SRV 0x1011

#define	BT_MESH_MODEL_ID_GEN_MANUFACTURER_PROP_SRV 0x1012

#define	BT_MESH_MODEL_ID_GEN_USER_PROP_SRV 0x1013

#define	BT_MESH_MODEL_ID_GEN_CLIENT_PROP_SRV 0x1014

#define	BT_MESH_MODEL_ID_GEN_PROP_CLI 0x1015

#define	BT_MESH_MODEL_ID_SENSOR_SRV 0x1100

#define	BT_MESH_MODEL_ID_SENSOR_SETUP_SRV 0x1101

#define	BT_MESH_MODEL_ID_SENSOR_CLI 0x1102

#define	BT_MESH_MODEL_ID_TIME_SRV 0x1200

#define	BT_MESH_MODEL_ID_TIME_SETUP_SRV 0x1201

#define	BT_MESH_MODEL_ID_TIME_CLI 0x1202

#define	BT_MESH_MODEL_ID_SCENE_SRV 0x1203

#define	BT_MESH_MODEL_ID_SCENE_SETUP_SRV 0x1204

#define	BT_MESH_MODEL_ID_SCENE_CLI 0x1205

#define	BT_MESH_MODEL_ID_SCHEDULER_SRV 0x1206

#define	BT_MESH_MODEL_ID_SCHEDULER_SETUP_SRV 0x1207

#define	BT_MESH_MODEL_ID_SCHEDULER_CLI 0x1208

#define	BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SRV 0x1300

#define	BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SETUP_SRV 0x1301

#define	BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_CLI 0x1302

#define	BT_MESH_MODEL_ID_LIGHT_CTL_SRV 0x1303

#define	BT_MESH_MODEL_ID_LIGHT_CTL_SETUP_SRV 0x1304

#define	BT_MESH_MODEL_ID_LIGHT_CTL_CLI 0x1305

#define	BT_MESH_MODEL_ID_LIGHT_CTL_TEMP_SRV 0x1306

#define	BT_MESH_MODEL_ID_LIGHT_HSL_SRV 0x1307

#define	BT_MESH_MODEL_ID_LIGHT_HSL_SETUP_SRV 0x1308

#define	BT_MESH_MODEL_ID_LIGHT_HSL_CLI 0x1309

#define	BT_MESH_MODEL_ID_LIGHT_HSL_HUE_SRV 0x130a

#define	BT_MESH_MODEL_ID_LIGHT_HSL_SAT_SRV 0x130b

#define	BT_MESH_MODEL_ID_LIGHT_XYL_SRV 0x130c

#define	BT_MESH_MODEL_ID_LIGHT_XYL_SETUP_SRV 0x130d

#define	BT_MESH_MODEL_ID_LIGHT_XYL_CLI 0x130e

#define	BT_MESH_MODEL_ID_LIGHT_LC_SRV 0x130f

#define	BT_MESH_MODEL_ID_LIGHT_LC_SETUPSRV 0x1310

#define	BT_MESH_MODEL_ID_LIGHT_LC_CLI 0x1311

#define	BT_MESH_MODEL_ID_BLOB_SRV 0x1400

#define	BT_MESH_MODEL_ID_BLOB_CLI 0x1401

#define	BT_MESH_MODEL_ID_DFU_SRV 0x1402

#define	BT_MESH_MODEL_ID_DFU_CLI 0x1403

#define	BT_MESH_MODEL_ID_DFD_SRV 0x1404

#define	BT_MESH_MODEL_ID_DFD_CLI 0x1405

#define	BT_MESH_MODEL_OP_1(b0) (b0)

#define	BT_MESH_MODEL_OP_2(b0, b1) (((b0) << 8) \| (b1))

#define	BT_MESH_MODEL_OP_3(b0, cid) ((((b0) << 16) \| 0xc00000) \| (cid))

#define	BT_MESH_LEN_EXACT(len) (-len)

#define	BT_MESH_LEN_MIN(len) (len)

#define	BT_MESH_MODEL_OP_END { 0, 0, NULL }

#define	BT_MESH_MODEL_NO_OPS
	Helper to define an empty opcode list. More...

#define	BT_MESH_MODEL_NONE ((struct bt_mesh_model []){})
	Helper to define an empty model array. More...

#define	BT_MESH_MODEL_CNT_CB(_id, _op, _pub, _user_data, _keys, _grps, _cb)
	Composition data SIG model entry with callback functions with specific number of keys & groups. More...

#define	BT_MESH_MODEL_CNT_VND_CB(_company, _id, _op, _pub, _user_data, _keys, _grps, _cb)
	Composition data vendor model entry with callback functions with specific number of keys & groups. More...

#define	BT_MESH_MODEL_CB(_id, _op, _pub, _user_data, _cb)
	Composition data SIG model entry with callback functions. More...

#define	BT_MESH_MODEL_METADATA_CB(_id, _op, _pub, _user_data, _cb, _metadata) BT_MESH_MODEL_CB(_id, _op, _pub, _user_data, _cb)
	Composition data SIG model entry with callback functions and metadata. More...

#define	BT_MESH_MODEL_VND_CB(_company, _id, _op, _pub, _user_data, _cb)
	Composition data vendor model entry with callback functions. More...

#define	BT_MESH_MODEL_VND_METADATA_CB(_company, _id, _op, _pub, _user_data, _cb, _metadata)
	Composition data vendor model entry with callback functions and metadata. More...

#define	BT_MESH_MODEL(_id, _op, _pub, _user_data) BT_MESH_MODEL_CB(_id, _op, _pub, _user_data, NULL)
	Composition data SIG model entry. More...

#define	BT_MESH_MODEL_VND(_company, _id, _op, _pub, _user_data) BT_MESH_MODEL_VND_CB(_company, _id, _op, _pub, _user_data, NULL)
	Composition data vendor model entry. More...

#define	BT_MESH_TRANSMIT(count, int_ms) ((count) \| (((int_ms / 10) - 1) << 3))
	Encode transmission count & interval steps. More...

#define	BT_MESH_TRANSMIT_COUNT(transmit) (((transmit) & (uint8_t)BIT_MASK(3)))
	Decode transmit count from a transmit value. More...

#define	BT_MESH_TRANSMIT_INT(transmit) ((((transmit) >> 3) + 1) * 10)
	Decode transmit interval from a transmit value. More...

#define	BT_MESH_PUB_TRANSMIT(count, int_ms)
	Encode Publish Retransmit count & interval steps. More...

#define	BT_MESH_PUB_TRANSMIT_COUNT(transmit) BT_MESH_TRANSMIT_COUNT(transmit)
	Decode Publish Retransmit count from a given value. More...

#define	BT_MESH_PUB_TRANSMIT_INT(transmit) ((((transmit) >> 3) + 1) * 50)
	Decode Publish Retransmit interval from a given value. More...

#define	BT_MESH_PUB_MSG_TOTAL(pub) (BT_MESH_PUB_TRANSMIT_COUNT((pub)->retransmit) + 1)
	Get total number of messages within one publication interval including initial publication. More...

#define	BT_MESH_PUB_MSG_NUM(pub) (BT_MESH_PUB_TRANSMIT_COUNT((pub)->retransmit) + 1 - (pub)->count)
	Get message number within one publication interval. More...

#define	BT_MESH_MODEL_PUB_DEFINE(_name, _update, _msg_len)

#define	BT_MESH_MODELS_METADATA_ENTRY(_len, _id, _data)

#define	BT_MESH_MODELS_METADATA_NONE NULL

#define	BT_MESH_MODELS_METADATA_END { 0, 0, NULL }

#define	BT_MESH_TTL_DEFAULT 0xff

#define	BT_MESH_TTL_MAX 0x7f

Functions
int	bt_mesh_model_send (struct bt_mesh_model model, struct bt_mesh_msg_ctx ctx, struct net_buf_simple msg, const struct bt_mesh_send_cb cb, void *cb_data)
	Send an Access Layer message. More...

int	bt_mesh_model_publish (struct bt_mesh_model *model)
	Send a model publication message. More...

static bool	bt_mesh_model_pub_is_retransmission (const struct bt_mesh_model *model)
	Check if a message is being retransmitted. More...

struct bt_mesh_elem *	bt_mesh_model_elem (struct bt_mesh_model *mod)
	Get the element that a model belongs to. More...

struct bt_mesh_model *	bt_mesh_model_find (const struct bt_mesh_elem *elem, uint16_t id)
	Find a SIG model. More...

struct bt_mesh_model *	bt_mesh_model_find_vnd (const struct bt_mesh_elem *elem, uint16_t company, uint16_t id)
	Find a vendor model. More...

static bool	bt_mesh_model_in_primary (const struct bt_mesh_model *mod)
	Get whether the model is in the primary element of the device. More...

int	bt_mesh_model_data_store (struct bt_mesh_model mod, bool vnd, const char name, const void *data, size_t data_len)
	Immediately store the model's user data in persistent storage. More...

void	bt_mesh_model_data_store_schedule (struct bt_mesh_model *mod)
	Schedule the model's user data store in persistent storage. More...

int	bt_mesh_model_extend (struct bt_mesh_model extending_mod, struct bt_mesh_model base_mod)
	Let a model extend another. More...

int	bt_mesh_model_correspond (struct bt_mesh_model corresponding_mod, struct bt_mesh_model base_mod)
	Let a model correspond to another. More...

bool	bt_mesh_model_is_extended (struct bt_mesh_model *model)
	Check if model is extended by another model. More...

int	bt_mesh_comp_change_prepare (void)
	Indicate that the composition data will change on next bootup. More...

int	bt_mesh_models_metadata_change_prepare (void)
	Indicate that the metadata will change on next bootup. More...

Detailed Description

Access layer.

Macro Definition Documentation

◆ BT_MESH_ADDR_ALL_NODES

#define BT_MESH_ADDR_ALL_NODES 0xffff

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_DFW_NODES

#define BT_MESH_ADDR_DFW_NODES 0xfffb

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_FRIENDS

#define BT_MESH_ADDR_FRIENDS 0xfffd

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IP_BR_ROUTERS

#define BT_MESH_ADDR_IP_BR_ROUTERS 0xfff9

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IP_NODES

#define BT_MESH_ADDR_IP_NODES 0xfffa

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IS_FIXED_GROUP

#define BT_MESH_ADDR_IS_FIXED_GROUP ( addr ) ((addr) >= 0xff00 && (addr) < 0xffff)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IS_GROUP

#define BT_MESH_ADDR_IS_GROUP ( addr ) ((addr) >= 0xc000 && (addr) < 0xff00)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IS_RFU

#define BT_MESH_ADDR_IS_RFU ( addr ) ((addr) >= 0xff00 && (addr) <= 0xfff8)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IS_UNICAST

#define BT_MESH_ADDR_IS_UNICAST ( addr ) ((addr) && (addr) < 0x8000)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_IS_VIRTUAL

#define BT_MESH_ADDR_IS_VIRTUAL ( addr ) ((addr) >= 0x8000 && (addr) < 0xc000)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_PROXIES

#define BT_MESH_ADDR_PROXIES 0xfffc

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_RELAYS

#define BT_MESH_ADDR_RELAYS 0xfffe

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_ADDR_UNASSIGNED

#define BT_MESH_ADDR_UNASSIGNED 0x0000

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_APP_SEG_SDU_MAX

#define BT_MESH_APP_SEG_SDU_MAX 12

#include <include/zephyr/bluetooth/mesh/access.h>

Maximum size of an access message segment (in octets).

◆ BT_MESH_APP_UNSEG_SDU_MAX

#define BT_MESH_APP_UNSEG_SDU_MAX 15

#include <include/zephyr/bluetooth/mesh/access.h>

Maximum payload size of an unsegmented access message (in octets).

◆ BT_MESH_ELEM

#define BT_MESH_ELEM	(	_loc,
		_mods,
		_vnd_mods
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

{                                                   \
        .loc              = (_loc),                 \
        .model_count      = ARRAY_SIZE(_mods),      \
        .vnd_model_count  = ARRAY_SIZE(_vnd_mods),  \
        .models           = (_mods),                \
        .vnd_models       = (_vnd_mods),            \
}

Helper to define a mesh element within an array.

In case the element has no SIG or Vendor models the helper macro BT_MESH_MODEL_NONE can be given instead.

Parameters

_loc	Location Descriptor.
_mods	Array of models.
_vnd_mods	Array of vendor models.

◆ BT_MESH_IS_DEV_KEY

#define BT_MESH_IS_DEV_KEY ( key )

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

(key == BT_MESH_KEY_DEV_LOCAL || \

key == BT_MESH_KEY_DEV_REMOTE)

BT_MESH_KEY_DEV_LOCAL

#define BT_MESH_KEY_DEV_LOCAL

Definition: access.h:48

BT_MESH_KEY_DEV_REMOTE

#define BT_MESH_KEY_DEV_REMOTE

Definition: access.h:49

key

static k_spinlock_key_t key

Definition: spinlock_error_case.c:15

◆ BT_MESH_KEY_ANY

#define BT_MESH_KEY_ANY 0xffff

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_KEY_DEV

#define BT_MESH_KEY_DEV 0xfffe

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_KEY_DEV_ANY

#define BT_MESH_KEY_DEV_ANY 0xfffc

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_KEY_DEV_LOCAL

#define BT_MESH_KEY_DEV_LOCAL BT_MESH_KEY_DEV

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_KEY_DEV_REMOTE

#define BT_MESH_KEY_DEV_REMOTE 0xfffd

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_KEY_UNUSED

#define BT_MESH_KEY_UNUSED 0xffff

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_LEN_EXACT

#define BT_MESH_LEN_EXACT ( len ) (-len)

#include <include/zephyr/bluetooth/mesh/access.h>

Macro for encoding exact message length for fixed-length messages.

◆ BT_MESH_LEN_MIN

#define BT_MESH_LEN_MIN ( len ) (len)

#include <include/zephyr/bluetooth/mesh/access.h>

Macro for encoding minimum message length for variable-length messages.

◆ BT_MESH_MODEL

#define BT_MESH_MODEL	(	_id,
		_op,
		_pub,
		_user_data
	)	BT_MESH_MODEL_CB(_id, _op, _pub, _user_data, NULL)

#include <include/zephyr/bluetooth/mesh/access.h>

Composition data SIG model entry.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.

◆ BT_MESH_MODEL_CB

#define BT_MESH_MODEL_CB	(	_id,
		_op,
		_pub,
		_user_data,
		_cb
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

        BT_MESH_MODEL_CNT_CB(_id, _op, _pub, _user_data,        \
                             CONFIG_BT_MESH_MODEL_KEY_COUNT,    \
                             CONFIG_BT_MESH_MODEL_GROUP_COUNT, _cb)

Composition data SIG model entry with callback functions.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_cb	Callback structure, or NULL to keep no callbacks.

◆ BT_MESH_MODEL_CNT_CB

#define BT_MESH_MODEL_CNT_CB	(	_id,
		_op,
		_pub,
		_user_data,
		_keys,
		_grps,
		_cb
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

{                                                                               \
        .id = (_id),                                                            \
        .pub = _pub,                                                            \
        .keys = (uint16_t []) BT_MESH_MODEL_KEYS_UNUSED(_keys),                 \
        .keys_cnt = _keys,                                                      \
        .groups = (uint16_t []) BT_MESH_MODEL_GROUPS_UNASSIGNED(_grps),         \
        .groups_cnt = _grps,                                                    \
        .op = _op,                                                              \
        .cb = _cb,                                                              \
        .user_data = _user_data,                                                \
}

Composition data SIG model entry with callback functions with specific number of keys & groups.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_keys	Number of keys that can be bound to the model. Shall not exceed `CONFIG_BT_MESH_MODEL_KEY_COUNT` .
_grps	Number of addresses that the model can be subscribed to. Shall not exceed `CONFIG_BT_MESH_MODEL_GROUP_COUNT` .
_cb	Callback structure, or NULL to keep no callbacks.

◆ BT_MESH_MODEL_CNT_VND_CB

#define BT_MESH_MODEL_CNT_VND_CB	(	_company,
		_id,
		_op,
		_pub,
		_user_data,
		_keys,
		_grps,
		_cb
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

{                                                                                               \
        .vnd.company = (_company),                                                              \
        .vnd.id = (_id),                                                                        \
        .op = _op,                                                                              \
        .pub = _pub,                                                                            \
        .keys = (uint16_t []) BT_MESH_MODEL_KEYS_UNUSED(_keys),                                 \
        .keys_cnt = _keys,                                                                      \
        .groups = (uint16_t []) BT_MESH_MODEL_GROUPS_UNASSIGNED(_grps),                         \
        .groups_cnt = _grps,                                                                    \
        .user_data = _user_data,                                                                \
        .cb = _cb,                                                                              \
}

Composition data vendor model entry with callback functions with specific number of keys & groups.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_company	Company ID.
_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_keys	Number of keys that can be bound to the model. Shall not exceed `CONFIG_BT_MESH_MODEL_KEY_COUNT` .
_grps	Number of addresses that the model can be subscribed to. Shall not exceed `CONFIG_BT_MESH_MODEL_GROUP_COUNT` .
_cb	Callback structure, or NULL to keep no callbacks.

◆ BT_MESH_MODEL_ID_BLOB_CLI

#define BT_MESH_MODEL_ID_BLOB_CLI 0x1401

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_BLOB_SRV

#define BT_MESH_MODEL_ID_BLOB_SRV 0x1400

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_CFG_CLI

#define BT_MESH_MODEL_ID_CFG_CLI 0x0001

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_CFG_SRV

#define BT_MESH_MODEL_ID_CFG_SRV 0x0000

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_DFD_CLI

#define BT_MESH_MODEL_ID_DFD_CLI 0x1405

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_DFD_SRV

#define BT_MESH_MODEL_ID_DFD_SRV 0x1404

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_DFU_CLI

#define BT_MESH_MODEL_ID_DFU_CLI 0x1403

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_DFU_SRV

#define BT_MESH_MODEL_ID_DFU_SRV 0x1402

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_ADMIN_PROP_SRV

#define BT_MESH_MODEL_ID_GEN_ADMIN_PROP_SRV 0x1011

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_BATTERY_CLI

#define BT_MESH_MODEL_ID_GEN_BATTERY_CLI 0x100d

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_BATTERY_SRV

#define BT_MESH_MODEL_ID_GEN_BATTERY_SRV 0x100c

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_CLIENT_PROP_SRV

#define BT_MESH_MODEL_ID_GEN_CLIENT_PROP_SRV 0x1014

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_CLI

#define BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_CLI 0x1005

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_SRV

#define BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_SRV 0x1004

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_LEVEL_CLI

#define BT_MESH_MODEL_ID_GEN_LEVEL_CLI 0x1003

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_LEVEL_SRV

#define BT_MESH_MODEL_ID_GEN_LEVEL_SRV 0x1002

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_LOCATION_CLI

#define BT_MESH_MODEL_ID_GEN_LOCATION_CLI 0x1010

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_LOCATION_SETUPSRV

#define BT_MESH_MODEL_ID_GEN_LOCATION_SETUPSRV 0x100f

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_LOCATION_SRV

#define BT_MESH_MODEL_ID_GEN_LOCATION_SRV 0x100e

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_MANUFACTURER_PROP_SRV

#define BT_MESH_MODEL_ID_GEN_MANUFACTURER_PROP_SRV 0x1012

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_ONOFF_CLI

#define BT_MESH_MODEL_ID_GEN_ONOFF_CLI 0x1001

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_ONOFF_SRV

#define BT_MESH_MODEL_ID_GEN_ONOFF_SRV 0x1000

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_CLI

#define BT_MESH_MODEL_ID_GEN_POWER_LEVEL_CLI 0x100b

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SETUP_SRV

#define BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SETUP_SRV 0x100a

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SRV

#define BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SRV 0x1009

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_CLI

#define BT_MESH_MODEL_ID_GEN_POWER_ONOFF_CLI 0x1008

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SETUP_SRV

#define BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SETUP_SRV 0x1007

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SRV

#define BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SRV 0x1006

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_PROP_CLI

#define BT_MESH_MODEL_ID_GEN_PROP_CLI 0x1015

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_GEN_USER_PROP_SRV

#define BT_MESH_MODEL_ID_GEN_USER_PROP_SRV 0x1013

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_HEALTH_CLI

#define BT_MESH_MODEL_ID_HEALTH_CLI 0x0003

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_HEALTH_SRV

#define BT_MESH_MODEL_ID_HEALTH_SRV 0x0002

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LARGE_COMP_DATA_CLI

#define BT_MESH_MODEL_ID_LARGE_COMP_DATA_CLI 0x0013

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LARGE_COMP_DATA_SRV

#define BT_MESH_MODEL_ID_LARGE_COMP_DATA_SRV 0x0012

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_CTL_CLI

#define BT_MESH_MODEL_ID_LIGHT_CTL_CLI 0x1305

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_CTL_SETUP_SRV

#define BT_MESH_MODEL_ID_LIGHT_CTL_SETUP_SRV 0x1304

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_CTL_SRV

#define BT_MESH_MODEL_ID_LIGHT_CTL_SRV 0x1303

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_CTL_TEMP_SRV

#define BT_MESH_MODEL_ID_LIGHT_CTL_TEMP_SRV 0x1306

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_HSL_CLI

#define BT_MESH_MODEL_ID_LIGHT_HSL_CLI 0x1309

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_HSL_HUE_SRV

#define BT_MESH_MODEL_ID_LIGHT_HSL_HUE_SRV 0x130a

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SAT_SRV

#define BT_MESH_MODEL_ID_LIGHT_HSL_SAT_SRV 0x130b

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SETUP_SRV

#define BT_MESH_MODEL_ID_LIGHT_HSL_SETUP_SRV 0x1308

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SRV

#define BT_MESH_MODEL_ID_LIGHT_HSL_SRV 0x1307

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LC_CLI

#define BT_MESH_MODEL_ID_LIGHT_LC_CLI 0x1311

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LC_SETUPSRV

#define BT_MESH_MODEL_ID_LIGHT_LC_SETUPSRV 0x1310

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LC_SRV

#define BT_MESH_MODEL_ID_LIGHT_LC_SRV 0x130f

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_CLI

#define BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_CLI 0x1302

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SETUP_SRV

#define BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SETUP_SRV 0x1301

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SRV

#define BT_MESH_MODEL_ID_LIGHT_LIGHTNESS_SRV 0x1300

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_XYL_CLI

#define BT_MESH_MODEL_ID_LIGHT_XYL_CLI 0x130e

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_XYL_SETUP_SRV

#define BT_MESH_MODEL_ID_LIGHT_XYL_SETUP_SRV 0x130d

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_LIGHT_XYL_SRV

#define BT_MESH_MODEL_ID_LIGHT_XYL_SRV 0x130c

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_ON_DEMAND_PROXY_CLI

#define BT_MESH_MODEL_ID_ON_DEMAND_PROXY_CLI 0x000d

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_ON_DEMAND_PROXY_SRV

#define BT_MESH_MODEL_ID_ON_DEMAND_PROXY_SRV 0x000c

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_OP_AGG_CLI

#define BT_MESH_MODEL_ID_OP_AGG_CLI 0x0011

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_OP_AGG_SRV

#define BT_MESH_MODEL_ID_OP_AGG_SRV 0x0010

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_PRIV_BEACON_CLI

#define BT_MESH_MODEL_ID_PRIV_BEACON_CLI 0x000b

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_PRIV_BEACON_SRV

#define BT_MESH_MODEL_ID_PRIV_BEACON_SRV 0x000a

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_REMOTE_PROV_CLI

#define BT_MESH_MODEL_ID_REMOTE_PROV_CLI 0x0005

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_REMOTE_PROV_SRV

#define BT_MESH_MODEL_ID_REMOTE_PROV_SRV 0x0004

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SAR_CFG_CLI

#define BT_MESH_MODEL_ID_SAR_CFG_CLI 0x000f

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SAR_CFG_SRV

#define BT_MESH_MODEL_ID_SAR_CFG_SRV 0x000e

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCENE_CLI

#define BT_MESH_MODEL_ID_SCENE_CLI 0x1205

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCENE_SETUP_SRV

#define BT_MESH_MODEL_ID_SCENE_SETUP_SRV 0x1204

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCENE_SRV

#define BT_MESH_MODEL_ID_SCENE_SRV 0x1203

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCHEDULER_CLI

#define BT_MESH_MODEL_ID_SCHEDULER_CLI 0x1208

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCHEDULER_SETUP_SRV

#define BT_MESH_MODEL_ID_SCHEDULER_SETUP_SRV 0x1207

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SCHEDULER_SRV

#define BT_MESH_MODEL_ID_SCHEDULER_SRV 0x1206

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SENSOR_CLI

#define BT_MESH_MODEL_ID_SENSOR_CLI 0x1102

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SENSOR_SETUP_SRV

#define BT_MESH_MODEL_ID_SENSOR_SETUP_SRV 0x1101

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SENSOR_SRV

#define BT_MESH_MODEL_ID_SENSOR_SRV 0x1100

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SOL_PDU_RPL_CLI

#define BT_MESH_MODEL_ID_SOL_PDU_RPL_CLI 0x0015

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_SOL_PDU_RPL_SRV

#define BT_MESH_MODEL_ID_SOL_PDU_RPL_SRV 0x0014

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_TIME_CLI

#define BT_MESH_MODEL_ID_TIME_CLI 0x1202

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_TIME_SETUP_SRV

#define BT_MESH_MODEL_ID_TIME_SETUP_SRV 0x1201

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_ID_TIME_SRV

#define BT_MESH_MODEL_ID_TIME_SRV 0x1200

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_METADATA_CB

#define BT_MESH_MODEL_METADATA_CB	(	_id,
		_op,
		_pub,
		_user_data,
		_cb,
		_metadata
	)	BT_MESH_MODEL_CB(_id, _op, _pub, _user_data, _cb)

#include <include/zephyr/bluetooth/mesh/access.h>

Composition data SIG model entry with callback functions and metadata.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_cb	Callback structure, or NULL to keep no callbacks.
_metadata	Metadata structure.

◆ BT_MESH_MODEL_NO_OPS

#define BT_MESH_MODEL_NO_OPS

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

((struct bt_mesh_model_op []) \

{ BT_MESH_MODEL_OP_END })

BT_MESH_MODEL_OP_END

#define BT_MESH_MODEL_OP_END

Definition: access.h:244

bt_mesh_model_op

Definition: access.h:208

Helper to define an empty opcode list.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

◆ BT_MESH_MODEL_NONE

#define BT_MESH_MODEL_NONE ((struct bt_mesh_model []){})

#include <include/zephyr/bluetooth/mesh/access.h>

Helper to define an empty model array.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

◆ BT_MESH_MODEL_OP_1

#define BT_MESH_MODEL_OP_1 ( b0 ) (b0)

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_OP_2

#define BT_MESH_MODEL_OP_2	(	b0,
		b1
	)	(((b0) << 8) \| (b1))

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_OP_3

#define BT_MESH_MODEL_OP_3	(	b0,
		cid
	)	((((b0) << 16) \| 0xc00000) \| (cid))

#include <include/zephyr/bluetooth/mesh/access.h>

◆ BT_MESH_MODEL_OP_END

#define BT_MESH_MODEL_OP_END { 0, 0, NULL }

#include <include/zephyr/bluetooth/mesh/access.h>

End of the opcode list. Must always be present.

◆ BT_MESH_MODEL_PUB_DEFINE

#define BT_MESH_MODEL_PUB_DEFINE	(	_name,
		_update,
		_msg_len
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

        NET_BUF_SIMPLE_DEFINE_STATIC(bt_mesh_pub_msg_##_name, _msg_len); \
        static struct bt_mesh_model_pub _name = { \
                .msg = &bt_mesh_pub_msg_##_name, \
                .update = _update, \
        }

Define a model publication context.

Parameters

_name	Variable name given to the context.
_update	Optional message update callback (may be NULL).
_msg_len	Length of the publication message.

◆ BT_MESH_MODEL_VND

#define BT_MESH_MODEL_VND	(	_company,
		_id,
		_op,
		_pub,
		_user_data
	)	BT_MESH_MODEL_VND_CB(_company, _id, _op, _pub, _user_data, NULL)

#include <include/zephyr/bluetooth/mesh/access.h>

Composition data vendor model entry.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_company	Company ID.
_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.

◆ BT_MESH_MODEL_VND_CB

#define BT_MESH_MODEL_VND_CB	(	_company,
		_id,
		_op,
		_pub,
		_user_data,
		_cb
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

        BT_MESH_MODEL_CNT_VND_CB(_company, _id, _op, _pub, _user_data,  \
                                 CONFIG_BT_MESH_MODEL_KEY_COUNT,        \
                                 CONFIG_BT_MESH_MODEL_GROUP_COUNT, _cb)

Composition data vendor model entry with callback functions.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_company	Company ID.
_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_cb	Callback structure, or NULL to keep no callbacks.

◆ BT_MESH_MODEL_VND_METADATA_CB

#define BT_MESH_MODEL_VND_METADATA_CB	(	_company,
		_id,
		_op,
		_pub,
		_user_data,
		_cb,
		_metadata
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

{                                                                            \
        .vnd.company = (_company),                                           \
        .vnd.id = (_id),                                                     \
        .op = _op,                                                           \
        .pub = _pub,                                                         \
        .keys = (uint16_t []) BT_MESH_MODEL_KEYS_UNUSED(CONFIG_BT_MESH_MODEL_KEY_COUNT), \
        .keys_cnt = CONFIG_BT_MESH_MODEL_KEY_COUNT,                          \
        .groups = (uint16_t []) BT_MESH_MODEL_GROUPS_UNASSIGNED(CONFIG_BT_MESH_MODEL_GROUP_COUNT), \
        .groups_cnt = CONFIG_BT_MESH_MODEL_GROUP_COUNT,                      \
        .user_data = _user_data,                                             \
        .cb = _cb,                                                           \
        .metadata = _metadata,                                               \
}

Composition data vendor model entry with callback functions and metadata.

This macro uses compound literal feature of C99 standard and thus is available only from C, not C++.

Parameters

_company	Company ID.
_id	Model ID.
_op	Array of model opcode handlers.
_pub	Model publish parameters.
_user_data	User data for the model.
_cb	Callback structure, or NULL to keep no callbacks.
_metadata	Metadata structure.

◆ BT_MESH_MODELS_METADATA_END

#define BT_MESH_MODELS_METADATA_END { 0, 0, NULL }

#include <include/zephyr/bluetooth/mesh/access.h>

End of the Models Metadata list. Must always be present.

◆ BT_MESH_MODELS_METADATA_ENTRY

#define BT_MESH_MODELS_METADATA_ENTRY	(	_len,
		_id,
		_data
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

        {                                                                      \
                .len = (_len), .id = _id, .data = _data,                       \
        }

Initialize a Models Metadata entry structure in a list.

Parameters

_len	Length of the metadata entry.
_id	ID of the Models Metadata entry.
_data	Pointer to a contiguous memory that contains the metadata.

◆ BT_MESH_MODELS_METADATA_NONE

#define BT_MESH_MODELS_METADATA_NONE NULL

#include <include/zephyr/bluetooth/mesh/access.h>

Helper to define an empty Models metadata array

◆ BT_MESH_PUB_MSG_NUM

#define BT_MESH_PUB_MSG_NUM ( pub ) (BT_MESH_PUB_TRANSMIT_COUNT((pub)->retransmit) + 1 - (pub)->count)

#include <include/zephyr/bluetooth/mesh/access.h>

Get message number within one publication interval.

Meant to be used inside bt_mesh_model_pub::update.

Parameters

pub	Model publication context.

Returns: message number starting from 1.

◆ BT_MESH_PUB_MSG_TOTAL

#define BT_MESH_PUB_MSG_TOTAL ( pub ) (BT_MESH_PUB_TRANSMIT_COUNT((pub)->retransmit) + 1)

#include <include/zephyr/bluetooth/mesh/access.h>

Get total number of messages within one publication interval including initial publication.

Parameters

pub	Model publication context.

Returns: total number of messages.

◆ BT_MESH_PUB_TRANSMIT

#define BT_MESH_PUB_TRANSMIT	(	count,
		int_ms
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

BT_MESH_TRANSMIT(count, \

(int_ms) / 5)

count

ZTEST_BMEM int count

Definition: main.c:33

BT_MESH_TRANSMIT

#define BT_MESH_TRANSMIT(count, int_ms)

Encode transmission count & interval steps.

Definition: access.h:466

Encode Publish Retransmit count & interval steps.

Parameters

count	Number of retransmissions (first transmission is excluded).
int_ms	Interval steps in milliseconds. Must be greater than 0 and a multiple of 50.

Returns: Mesh transmit value that can be used e.g. for the default values of the configuration model data.

◆ BT_MESH_PUB_TRANSMIT_COUNT

#define BT_MESH_PUB_TRANSMIT_COUNT ( transmit ) BT_MESH_TRANSMIT_COUNT(transmit)

#include <include/zephyr/bluetooth/mesh/access.h>

Decode Publish Retransmit count from a given value.

Parameters

transmit Encoded Publish Retransmit count & interval value.

Returns: Retransmission count (actual transmissions is N + 1).

◆ BT_MESH_PUB_TRANSMIT_INT

#define BT_MESH_PUB_TRANSMIT_INT ( transmit ) ((((transmit) >> 3) + 1) * 50)

#include <include/zephyr/bluetooth/mesh/access.h>

Decode Publish Retransmit interval from a given value.

Parameters

transmit Encoded Publish Retransmit count & interval value.

Returns: Transmission interval in milliseconds.

◆ BT_MESH_RX_SDU_MAX

#define BT_MESH_RX_SDU_MAX

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

                                       MAX((BT_MESH_RX_SEG_MAX *                \
                                       BT_MESH_APP_SEG_SDU_MAX),        \
                                      BT_MESH_APP_UNSEG_SDU_MAX)

Maximum possible payload size of an incoming access message (in octets).

◆ BT_MESH_RX_SEG_MAX

#define BT_MESH_RX_SEG_MAX 0

#include <include/zephyr/bluetooth/mesh/access.h>

Maximum number of segments supported for incoming messages.

◆ BT_MESH_TRANSMIT

#define BT_MESH_TRANSMIT	(	count,
		int_ms
	)	((count) \| (((int_ms / 10) - 1) << 3))

#include <include/zephyr/bluetooth/mesh/access.h>

Encode transmission count & interval steps.

Parameters

count	Number of retransmissions (first transmission is excluded).
int_ms	Interval steps in milliseconds. Must be greater than 0, less than or equal to 320, and a multiple of 10.

Returns: Mesh transmit value that can be used e.g. for the default values of the configuration model data.

◆ BT_MESH_TRANSMIT_COUNT

#define BT_MESH_TRANSMIT_COUNT ( transmit ) (((transmit) & (uint8_t)BIT_MASK(3)))

#include <include/zephyr/bluetooth/mesh/access.h>

Decode transmit count from a transmit value.

Parameters

transmit Encoded transmit count & interval value.

Returns: Transmission count (actual transmissions is N + 1).

◆ BT_MESH_TRANSMIT_INT

#define BT_MESH_TRANSMIT_INT ( transmit ) ((((transmit) >> 3) + 1) * 10)

#include <include/zephyr/bluetooth/mesh/access.h>

Decode transmit interval from a transmit value.

Parameters

transmit Encoded transmit count & interval value.

Returns: Transmission interval in milliseconds.

◆ BT_MESH_TTL_DEFAULT

#define BT_MESH_TTL_DEFAULT 0xff

#include <include/zephyr/bluetooth/mesh/access.h>

Special TTL value to request using configured default TTL

◆ BT_MESH_TTL_MAX

#define BT_MESH_TTL_MAX 0x7f

#include <include/zephyr/bluetooth/mesh/access.h>

Maximum allowed TTL value

◆ BT_MESH_TX_SDU_MAX

#define BT_MESH_TX_SDU_MAX

#include <include/zephyr/bluetooth/mesh/access.h>

Value:

                                       MAX((BT_MESH_TX_SEG_MAX *                \
                                       BT_MESH_APP_SEG_SDU_MAX),        \
                                      BT_MESH_APP_UNSEG_SDU_MAX)

Maximum possible payload size of an outgoing access message (in octets).

◆ BT_MESH_TX_SEG_MAX

#define BT_MESH_TX_SEG_MAX 0

#include <include/zephyr/bluetooth/mesh/access.h>

Maximum number of segments supported for outgoing messages.

Function Documentation

◆ bt_mesh_comp_change_prepare()

int bt_mesh_comp_change_prepare ( void )

#include <include/zephyr/bluetooth/mesh/access.h>

Indicate that the composition data will change on next bootup.

Tell the config server that the composition data is expected to change on the next bootup, and the current composition data should be backed up.

Returns: Zero on success or (negative) error code otherwise.

◆ bt_mesh_model_correspond()

int bt_mesh_model_correspond	(	struct bt_mesh_model *	corresponding_mod,
		struct bt_mesh_model *	base_mod
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Let a model correspond to another.

Mesh models may correspond to each other, which means that if one is present, other must be present too. A Mesh model may correspond to any number of models, in any element. All models connected together via correspondence form single Correspondence Group, which has it's unique Correspondence ID. Information about Correspondence is used to construct Composition Data Page 1.

This function must be called on already initialized base_mod. Because this function is designed to be called in corresponding_mod initializer, this means that base_mod shall be initialized before corresponding_mod is.

Parameters

corresponding_mod	Mesh model that is corresponding to the base model.
base_mod	The model being corresponded to.

Return values

0	Successfully saved correspondence to the base_mod model.
-ENOMEM	There is no more space to save this relation.
-ENOTSUP	Composition Data Page 1 is not supported.

◆ bt_mesh_model_data_store()

int bt_mesh_model_data_store	(	struct bt_mesh_model *	mod,
		bool	vnd,
		const char *	name,
		const void *	data,
		size_t	data_len
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Immediately store the model's user data in persistent storage.

Parameters

mod	Mesh model.
vnd	This is a vendor model.
name	Name/key of the settings item. Only SETTINGS_MAX_DIR_DEPTH bytes will be used at most.
data	Model data to store, or NULL to delete any model data.
data_len	Length of the model data.

Returns: 0 on success, or (negative) error code on failure.

◆ bt_mesh_model_data_store_schedule()

void bt_mesh_model_data_store_schedule ( struct bt_mesh_model * mod )

#include <include/zephyr/bluetooth/mesh/access.h>

Schedule the model's user data store in persistent storage.

This function triggers the bt_mesh_model_cb::pending_store callback for the corresponding model after delay defined by CONFIG_BT_MESH_STORE_TIMEOUT .

The delay is global for all models. Once scheduled, the callback can not be re-scheduled until previous schedule completes.

Parameters

mod	Mesh model.

◆ bt_mesh_model_elem()

struct bt_mesh_elem * bt_mesh_model_elem ( struct bt_mesh_model * mod )

#include <include/zephyr/bluetooth/mesh/access.h>

Get the element that a model belongs to.

Parameters

mod	Mesh model.

Returns: Pointer to the element that the given model belongs to.

◆ bt_mesh_model_extend()

int bt_mesh_model_extend	(	struct bt_mesh_model *	extending_mod,
		struct bt_mesh_model *	base_mod
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Let a model extend another.

Mesh models may be extended to reuse their functionality, forming a more complex model. A Mesh model may extend any number of models, in any element. The extensions may also be nested, ie a model that extends another may itself be extended.

A set of models that extend each other form a model extension list.

All models in an extension list share one subscription list per element. The access layer will utilize the combined subscription list of all models in an extension list and element, giving the models extended subscription list capacity.

Parameters

extending_mod	Mesh model that is extending the base model.
base_mod	The model being extended.

Return values

0	Successfully extended the base_mod model.

◆ bt_mesh_model_find()

struct bt_mesh_model * bt_mesh_model_find	(	const struct bt_mesh_elem *	elem,
		uint16_t	id
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Find a SIG model.

Parameters

elem	Element to search for the model in.
id	Model ID of the model.

Returns: A pointer to the Mesh model matching the given parameters, or NULL if no SIG model with the given ID exists in the given element.

◆ bt_mesh_model_find_vnd()

struct bt_mesh_model * bt_mesh_model_find_vnd	(	const struct bt_mesh_elem *	elem,
		uint16_t	company,
		uint16_t	id
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Find a vendor model.

Parameters

elem	Element to search for the model in.
company	Company ID of the model.
id	Model ID of the model.

Returns: A pointer to the Mesh model matching the given parameters, or NULL if no vendor model with the given ID exists in the given element.

◆ bt_mesh_model_in_primary()

static bool bt_mesh_model_in_primary ( const struct bt_mesh_model * mod )

inlinestatic

#include <include/zephyr/bluetooth/mesh/access.h>

Get whether the model is in the primary element of the device.

Parameters

mod	Mesh model.

Returns: true if the model is on the primary element, false otherwise.

◆ bt_mesh_model_is_extended()

bool bt_mesh_model_is_extended ( struct bt_mesh_model * model )

#include <include/zephyr/bluetooth/mesh/access.h>

Check if model is extended by another model.

Parameters

model The model to check.

Return values

true	If model is extended by another model, otherwise false

◆ bt_mesh_model_pub_is_retransmission()

static bool bt_mesh_model_pub_is_retransmission ( const struct bt_mesh_model * model )

inlinestatic

#include <include/zephyr/bluetooth/mesh/access.h>

Check if a message is being retransmitted.

Meant to be used inside the bt_mesh_model_pub::update callback.

Parameters

model Mesh Model that supports publication.

Returns: true if this is a retransmission, false if this is a first publication.

◆ bt_mesh_model_publish()

int bt_mesh_model_publish ( struct bt_mesh_model * model )

#include <include/zephyr/bluetooth/mesh/access.h>

Send a model publication message.

Before calling this function, the user needs to ensure that the model publication message (bt_mesh_model_pub::msg) contains a valid message to be sent. Note that this API is only to be used for non-period publishing. For periodic publishing the app only needs to make sure that bt_mesh_model_pub::msg contains a valid message whenever the bt_mesh_model_pub::update callback is called.

Parameters

model Mesh (client) Model that's publishing the message.

Returns: 0 on success, or (negative) error code on failure.

◆ bt_mesh_model_send()

int bt_mesh_model_send	(	struct bt_mesh_model *	model,
		struct bt_mesh_msg_ctx *	ctx,
		struct net_buf_simple *	msg,
		const struct bt_mesh_send_cb *	cb,
		void *	cb_data
	)

#include <include/zephyr/bluetooth/mesh/access.h>

Send an Access Layer message.

Parameters

model	Mesh (client) Model that the message belongs to.
ctx	Message context, includes keys, TTL, etc.
msg	Access Layer payload (the actual message to be sent).
cb	Optional "message sent" callback.
cb_data	User data to be passed to the callback.

Returns: 0 on success, or (negative) error code on failure.

◆ bt_mesh_models_metadata_change_prepare()

int bt_mesh_models_metadata_change_prepare ( void )

#include <include/zephyr/bluetooth/mesh/access.h>

Indicate that the metadata will change on next bootup.

Tell the config server that the models metadata is expected to change on the next bootup, and the current models metadata should be backed up.

Returns: Zero on success or (negative) error code otherwise.

Data Structures

Macros

Functions

Detailed Description

Macro Definition Documentation

◆ BT_MESH_ADDR_ALL_NODES

◆ BT_MESH_ADDR_DFW_NODES

◆ BT_MESH_ADDR_FRIENDS

◆ BT_MESH_ADDR_IP_BR_ROUTERS

◆ BT_MESH_ADDR_IP_NODES

◆ BT_MESH_ADDR_IS_FIXED_GROUP

◆ BT_MESH_ADDR_IS_GROUP

◆ BT_MESH_ADDR_IS_RFU

◆ BT_MESH_ADDR_IS_UNICAST

◆ BT_MESH_ADDR_IS_VIRTUAL

◆ BT_MESH_ADDR_PROXIES

◆ BT_MESH_ADDR_RELAYS

◆ BT_MESH_ADDR_UNASSIGNED

◆ BT_MESH_APP_SEG_SDU_MAX

◆ BT_MESH_APP_UNSEG_SDU_MAX

◆ BT_MESH_ELEM

◆ BT_MESH_IS_DEV_KEY

◆ BT_MESH_KEY_ANY

◆ BT_MESH_KEY_DEV

◆ BT_MESH_KEY_DEV_ANY

◆ BT_MESH_KEY_DEV_LOCAL

◆ BT_MESH_KEY_DEV_REMOTE

◆ BT_MESH_KEY_UNUSED

◆ BT_MESH_LEN_EXACT

◆ BT_MESH_LEN_MIN

◆ BT_MESH_MODEL

◆ BT_MESH_MODEL_CB

◆ BT_MESH_MODEL_CNT_CB

◆ BT_MESH_MODEL_CNT_VND_CB

◆ BT_MESH_MODEL_ID_BLOB_CLI

◆ BT_MESH_MODEL_ID_BLOB_SRV

◆ BT_MESH_MODEL_ID_CFG_CLI

◆ BT_MESH_MODEL_ID_CFG_SRV

◆ BT_MESH_MODEL_ID_DFD_CLI

◆ BT_MESH_MODEL_ID_DFD_SRV

◆ BT_MESH_MODEL_ID_DFU_CLI

◆ BT_MESH_MODEL_ID_DFU_SRV

◆ BT_MESH_MODEL_ID_GEN_ADMIN_PROP_SRV

◆ BT_MESH_MODEL_ID_GEN_BATTERY_CLI

◆ BT_MESH_MODEL_ID_GEN_BATTERY_SRV

◆ BT_MESH_MODEL_ID_GEN_CLIENT_PROP_SRV

◆ BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_CLI

◆ BT_MESH_MODEL_ID_GEN_DEF_TRANS_TIME_SRV

◆ BT_MESH_MODEL_ID_GEN_LEVEL_CLI

◆ BT_MESH_MODEL_ID_GEN_LEVEL_SRV

◆ BT_MESH_MODEL_ID_GEN_LOCATION_CLI

◆ BT_MESH_MODEL_ID_GEN_LOCATION_SETUPSRV

◆ BT_MESH_MODEL_ID_GEN_LOCATION_SRV

◆ BT_MESH_MODEL_ID_GEN_MANUFACTURER_PROP_SRV

◆ BT_MESH_MODEL_ID_GEN_ONOFF_CLI

◆ BT_MESH_MODEL_ID_GEN_ONOFF_SRV

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_CLI

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SETUP_SRV

◆ BT_MESH_MODEL_ID_GEN_POWER_LEVEL_SRV

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_CLI

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SETUP_SRV

◆ BT_MESH_MODEL_ID_GEN_POWER_ONOFF_SRV

◆ BT_MESH_MODEL_ID_GEN_PROP_CLI

◆ BT_MESH_MODEL_ID_GEN_USER_PROP_SRV

◆ BT_MESH_MODEL_ID_HEALTH_CLI

◆ BT_MESH_MODEL_ID_HEALTH_SRV

◆ BT_MESH_MODEL_ID_LARGE_COMP_DATA_CLI

◆ BT_MESH_MODEL_ID_LARGE_COMP_DATA_SRV

◆ BT_MESH_MODEL_ID_LIGHT_CTL_CLI

◆ BT_MESH_MODEL_ID_LIGHT_CTL_SETUP_SRV

◆ BT_MESH_MODEL_ID_LIGHT_CTL_SRV

◆ BT_MESH_MODEL_ID_LIGHT_CTL_TEMP_SRV

◆ BT_MESH_MODEL_ID_LIGHT_HSL_CLI

◆ BT_MESH_MODEL_ID_LIGHT_HSL_HUE_SRV

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SAT_SRV

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SETUP_SRV

◆ BT_MESH_MODEL_ID_LIGHT_HSL_SRV

◆ BT_MESH_MODEL_ID_LIGHT_LC_CLI

◆ BT_MESH_MODEL_ID_LIGHT_LC_SETUPSRV

◆ BT_MESH_MODEL_ID_LIGHT_LC_SRV