Runtime Configuration. More...

Modules
	Application Configuration
	Application Configuration.

	Subnet Configuration
	Subnet Configuration.

Macros
#define	BT_MESH_KR_NORMAL 0x00

#define	BT_MESH_KR_PHASE_1 0x01

#define	BT_MESH_KR_PHASE_2 0x02

#define	BT_MESH_KR_PHASE_3 0x03

#define	BT_MESH_RELAY_DISABLED BT_MESH_FEATURE_DISABLED

#define	BT_MESH_RELAY_ENABLED BT_MESH_FEATURE_ENABLED

#define	BT_MESH_RELAY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#define	BT_MESH_BEACON_DISABLED BT_MESH_FEATURE_DISABLED

#define	BT_MESH_BEACON_ENABLED BT_MESH_FEATURE_ENABLED

#define	BT_MESH_GATT_PROXY_DISABLED BT_MESH_FEATURE_DISABLED

#define	BT_MESH_GATT_PROXY_ENABLED BT_MESH_FEATURE_ENABLED

#define	BT_MESH_GATT_PROXY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#define	BT_MESH_FRIEND_DISABLED BT_MESH_FEATURE_DISABLED

#define	BT_MESH_FRIEND_ENABLED BT_MESH_FEATURE_ENABLED

#define	BT_MESH_FRIEND_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#define	BT_MESH_NODE_IDENTITY_STOPPED BT_MESH_FEATURE_DISABLED

#define	BT_MESH_NODE_IDENTITY_RUNNING BT_MESH_FEATURE_ENABLED

#define	BT_MESH_NODE_IDENTITY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

Enumerations
enum	bt_mesh_feat_state { BT_MESH_FEATURE_DISABLED , BT_MESH_FEATURE_ENABLED , BT_MESH_FEATURE_NOT_SUPPORTED }

Functions
void	bt_mesh_beacon_set (bool beacon)
	Enable or disable sending of the Secure Network Beacon. More...

bool	bt_mesh_beacon_enabled (void)
	Get the current Secure Network Beacon state. More...

int	bt_mesh_default_ttl_set (uint8_t default_ttl)
	Set the default TTL value. More...

uint8_t	bt_mesh_default_ttl_get (void)
	Get the current default TTL value. More...

void	bt_mesh_net_transmit_set (uint8_t xmit)
	Set the Network Transmit parameters. More...

uint8_t	bt_mesh_net_transmit_get (void)
	Get the current Network Transmit parameters. More...

int	bt_mesh_relay_set (enum bt_mesh_feat_state relay, uint8_t xmit)
	Configure the Relay feature. More...

enum bt_mesh_feat_state	bt_mesh_relay_get (void)
	Get the current Relay feature state. More...

uint8_t	bt_mesh_relay_retransmit_get (void)
	Get the current Relay Retransmit parameters. More...

int	bt_mesh_gatt_proxy_set (enum bt_mesh_feat_state gatt_proxy)
	Enable or disable the GATT Proxy feature. More...

enum bt_mesh_feat_state	bt_mesh_gatt_proxy_get (void)
	Get the current GATT Proxy state. More...

int	bt_mesh_friend_set (enum bt_mesh_feat_state friendship)
	Enable or disable the Friend feature. More...

enum bt_mesh_feat_state	bt_mesh_friend_get (void)
	Get the current Friend state. More...

Detailed Description

Runtime Configuration.

Macro Definition Documentation

◆ BT_MESH_BEACON_DISABLED

#define BT_MESH_BEACON_DISABLED BT_MESH_FEATURE_DISABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_BEACON_ENABLED

#define BT_MESH_BEACON_ENABLED BT_MESH_FEATURE_ENABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_FRIEND_DISABLED

#define BT_MESH_FRIEND_DISABLED BT_MESH_FEATURE_DISABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_FRIEND_ENABLED

#define BT_MESH_FRIEND_ENABLED BT_MESH_FEATURE_ENABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_FRIEND_NOT_SUPPORTED

#define BT_MESH_FRIEND_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_GATT_PROXY_DISABLED

#define BT_MESH_GATT_PROXY_DISABLED BT_MESH_FEATURE_DISABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_GATT_PROXY_ENABLED

#define BT_MESH_GATT_PROXY_ENABLED BT_MESH_FEATURE_ENABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_GATT_PROXY_NOT_SUPPORTED

#define BT_MESH_GATT_PROXY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_KR_NORMAL

#define BT_MESH_KR_NORMAL 0x00

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_KR_PHASE_1

#define BT_MESH_KR_PHASE_1 0x01

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_KR_PHASE_2

#define BT_MESH_KR_PHASE_2 0x02

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_KR_PHASE_3

#define BT_MESH_KR_PHASE_3 0x03

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_NODE_IDENTITY_NOT_SUPPORTED

#define BT_MESH_NODE_IDENTITY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_NODE_IDENTITY_RUNNING

#define BT_MESH_NODE_IDENTITY_RUNNING BT_MESH_FEATURE_ENABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_NODE_IDENTITY_STOPPED

#define BT_MESH_NODE_IDENTITY_STOPPED BT_MESH_FEATURE_DISABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_RELAY_DISABLED

#define BT_MESH_RELAY_DISABLED BT_MESH_FEATURE_DISABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_RELAY_ENABLED

#define BT_MESH_RELAY_ENABLED BT_MESH_FEATURE_ENABLED

#include <include/bluetooth/mesh/cfg.h>

◆ BT_MESH_RELAY_NOT_SUPPORTED

#define BT_MESH_RELAY_NOT_SUPPORTED BT_MESH_FEATURE_NOT_SUPPORTED

#include <include/bluetooth/mesh/cfg.h>

Enumeration Type Documentation

◆ bt_mesh_feat_state

enum bt_mesh_feat_state

#include <include/bluetooth/mesh/cfg.h>

Bluetooth mesh feature states

Enumerator
BT_MESH_FEATURE_DISABLED	Feature is supported, but disabled.
BT_MESH_FEATURE_ENABLED	Feature is supported and enabled.
BT_MESH_FEATURE_NOT_SUPPORTED	Feature is not supported, and cannot be enabled.

Function Documentation

◆ bt_mesh_beacon_enabled()

bool bt_mesh_beacon_enabled ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current Secure Network Beacon state.

Returns: Whether the Secure Network Beacon feature is enabled.

◆ bt_mesh_beacon_set()

void bt_mesh_beacon_set ( bool beacon )

#include <include/bluetooth/mesh/cfg.h>

Enable or disable sending of the Secure Network Beacon.

Parameters

beacon New Secure Network Beacon state.

◆ bt_mesh_default_ttl_get()

uint8_t bt_mesh_default_ttl_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current default TTL value.

Returns: The current default TTL value.

◆ bt_mesh_default_ttl_set()

int bt_mesh_default_ttl_set ( uint8_t default_ttl )

#include <include/bluetooth/mesh/cfg.h>

Set the default TTL value.

The default TTL value is used when no explicit TTL value is set. Models will use the default TTL value when bt_mesh_msg_ctx::send_ttl is BT_MESH_TTL_DEFAULT.

Parameters

default_ttl The new default TTL value. Valid values are 0x00 and 0x02 to BT_MESH_TTL_MAX.

Return values

0	Successfully set the default TTL value.
-EINVAL	Invalid TTL value.

◆ bt_mesh_friend_get()

enum bt_mesh_feat_state bt_mesh_friend_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current Friend state.

Returns: The Friend feature state.

◆ bt_mesh_friend_set()

int bt_mesh_friend_set ( enum bt_mesh_feat_state friendship )

#include <include/bluetooth/mesh/cfg.h>

Enable or disable the Friend feature.

Any active friendships will be terminated immediately if the Friend feature is disabled.

Support for the Friend feature must be enabled through the CONFIG_BT_MESH_FRIEND configuration option.

Parameters

friendship New Friend feature state. Must be one of BT_MESH_FEATURE_ENABLED and BT_MESH_FEATURE_DISABLED.

Return values

0	Successfully changed the Friend feature state.
-ENOTSUP	The Friend feature is not supported.
-EINVAL	Invalid parameter.
-EALREADY	Already in the given state.

◆ bt_mesh_gatt_proxy_get()

enum bt_mesh_feat_state bt_mesh_gatt_proxy_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current GATT Proxy state.

Returns: The GATT Proxy feature state.

◆ bt_mesh_gatt_proxy_set()

int bt_mesh_gatt_proxy_set ( enum bt_mesh_feat_state gatt_proxy )

#include <include/bluetooth/mesh/cfg.h>

Enable or disable the GATT Proxy feature.

Support for the GATT Proxy feature must be enabled through the CONFIG_BT_MESH_GATT_PROXY configuration option.

Note: The GATT Proxy feature only controls a Proxy node's ability to relay messages to the mesh network. A node that supports GATT Proxy will still advertise Connectable Proxy beacons, even if the feature is disabled. The Proxy feature can only be fully disabled through compile time configuration.

Parameters

gatt_proxy New GATT Proxy state. Must be one of BT_MESH_FEATURE_ENABLED and BT_MESH_FEATURE_DISABLED.

Return values

0	Successfully changed the GATT Proxy feature state.
-ENOTSUP	The GATT Proxy feature is not supported.
-EINVAL	Invalid parameter.
-EALREADY	Already in the given state.

◆ bt_mesh_net_transmit_get()

uint8_t bt_mesh_net_transmit_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current Network Transmit parameters.

The BT_MESH_TRANSMIT_COUNT and BT_MESH_TRANSMIT_INT macros can be used to decode the Network Transmit parameters.

Returns: The current Network Transmit parameters.

◆ bt_mesh_net_transmit_set()

void bt_mesh_net_transmit_set ( uint8_t xmit )

#include <include/bluetooth/mesh/cfg.h>

Set the Network Transmit parameters.

The Network Transmit parameters determine the parameters local messages are transmitted with.

See also: BT_MESH_TRANSMIT

Parameters

xmit	New Network Transmit parameters. Use BT_MESH_TRANSMIT for encoding.

◆ bt_mesh_relay_get()

enum bt_mesh_feat_state bt_mesh_relay_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current Relay feature state.

Returns: The Relay feature state.

◆ bt_mesh_relay_retransmit_get()

uint8_t bt_mesh_relay_retransmit_get ( void )

#include <include/bluetooth/mesh/cfg.h>

Get the current Relay Retransmit parameters.

The BT_MESH_TRANSMIT_COUNT and BT_MESH_TRANSMIT_INT macros can be used to decode the Relay Retransmit parameters.

Returns: The current Relay Retransmit parameters, or 0 if relay is not supported.

◆ bt_mesh_relay_set()

int bt_mesh_relay_set	(	enum bt_mesh_feat_state	relay,
		uint8_t	xmit
	)

#include <include/bluetooth/mesh/cfg.h>

Configure the Relay feature.

Enable or disable the Relay feature, and configure the parameters to transmit relayed messages with.

Support for the Relay feature must be enabled through the CONFIG_BT_MESH_RELAY configuration option.

See also: BT_MESH_TRANSMIT

Parameters

relay	New Relay feature state. Must be one of BT_MESH_FEATURE_ENABLED and BT_MESH_FEATURE_DISABLED.
xmit	New Relay retransmit parameters. Use BT_MESH_TRANSMIT for encoding.

Return values

0	Successfully changed the Relay configuration.
-ENOTSUP	The Relay feature is not supported.
-EINVAL	Invalid parameter.
-EALREADY	Already using the given parameters.

Modules

Macros

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ BT_MESH_BEACON_DISABLED

◆ BT_MESH_BEACON_ENABLED

◆ BT_MESH_FRIEND_DISABLED

◆ BT_MESH_FRIEND_ENABLED

◆ BT_MESH_FRIEND_NOT_SUPPORTED

◆ BT_MESH_GATT_PROXY_DISABLED

◆ BT_MESH_GATT_PROXY_ENABLED

◆ BT_MESH_GATT_PROXY_NOT_SUPPORTED

◆ BT_MESH_KR_NORMAL

◆ BT_MESH_KR_PHASE_1

◆ BT_MESH_KR_PHASE_2

◆ BT_MESH_KR_PHASE_3

◆ BT_MESH_NODE_IDENTITY_NOT_SUPPORTED

◆ BT_MESH_NODE_IDENTITY_RUNNING

◆ BT_MESH_NODE_IDENTITY_STOPPED

◆ BT_MESH_RELAY_DISABLED

◆ BT_MESH_RELAY_ENABLED

◆ BT_MESH_RELAY_NOT_SUPPORTED

Enumeration Type Documentation

◆ bt_mesh_feat_state

Function Documentation

◆ bt_mesh_beacon_enabled()

◆ bt_mesh_beacon_set()

◆ bt_mesh_default_ttl_get()

◆ bt_mesh_default_ttl_set()

◆ bt_mesh_friend_get()

◆ bt_mesh_friend_set()

◆ bt_mesh_gatt_proxy_get()

◆ bt_mesh_gatt_proxy_set()

◆ bt_mesh_net_transmit_get()

◆ bt_mesh_net_transmit_set()

◆ bt_mesh_relay_get()

◆ bt_mesh_relay_retransmit_get()

◆ bt_mesh_relay_set()