BLE configuration options. More...

Modules
	BLE_EVENT_NOTIFICATIONS
	Doxygen documentation is not yet available for this module. Please check the source code file(s)

Files
file	ble_config.h
	BLE configuration options.

Macros
#define	dg_configBLE_CONNECTIONS_MAX (2)
	Define the maximum number of connections. More...

#define	dg_configBLE_OBSERVER (1)
	Enable the Observer role in the BLE framework. More...

#define	dg_configBLE_BROADCASTER (1)
	Enable the Broadcaster role in the BLE framework. More...

#define	dg_configBLE_CENTRAL (1)
	Enable the Central role in the BLE framework. More...

#define	dg_configBLE_PERIPHERAL (1)
	Enable the Peripheral role in the BLE framework. More...

#define	dg_configBLE_GATT_CLIENT (1)
	Enable the GATT Client role in the BLE framework. More...

#define	dg_configBLE_GATT_SERVER (1)
	Enable the GATT Server role in the BLE framework. More...

#define	dg_configBLE_L2CAP_COC (1)
	Enable L2CAP CoC (Connection Oriented Channels) in the BLE framework. More...

#define	dg_configBLE_EVENT_COUNTER_ENABLE (0)
	Enable Event Counters in BLE ISR. More...

#define	dg_configBLE_ADV_STOP_DELAY_ENABLE (0)
	Enable ADV_UNDERRUN workaround. More...

#define	dg_configBLE_SKIP_LATENCY_API (0)
	Enable the ble_gap_skip_latency() API. More...

#define	dg_configBLE_PRIVACY_1_2 (0)
	Enable LE Privacy v1.2 functionality. More...

#define	dg_configBLE_DATA_LENGTH_RX_MAX (251)
	Maximum Receive Data Channel PDU Payload Length. More...

#define	dg_configBLE_DATA_LENGTH_TX_MAX (251)
	Maximum Transmit Data Channel PDU Payload Length. More...

#define	BLE_DATA_LENGTH_TO_TIME(OCTETS) ( ( (OCTETS) + 11 + 3 ) * 8 )
	Convert Receive/Transmit Data Length to Time.

#define	dg_configBLE_CONN_EVENT_LENGTH_MIN
	Minimum Connection Event Length. More...

#define	dg_configBLE_CONN_EVENT_LENGTH_MAX (0xFFFF)
	Maximum Connection Event Length. More...

#define	dg_configBLE_DUPLICATE_FILTER_MAX (10)
	Duplicate Filtering List Maximum size. More...

#define	dg_configBLE_PAIR_INIT_KEY_DIST (GAP_KDIST_ENCKEY \| GAP_KDIST_IDKEY \| GAP_KDIST_SIGNKEY)
	Security keys to be distributed by the pairing initiator. More...

#define	dg_configBLE_PAIR_RESP_KEY_DIST (GAP_KDIST_ENCKEY \| GAP_KDIST_IDKEY \| GAP_KDIST_SIGNKEY)
	Security keys to be distributed by the pairing responder. More...

#define	dg_configBLE_SECURE_CONNECTIONS (1)
	Enable Secure Connections. More...

#define	dg_configBLE_INITIAL_TX_POWER (GAP_TX_POWER_0_dBm)
	Pairing successes threshold for renewing the public key (DEPRECATED) More...

#define	dg_configDEFAULT_RADIO_OP_MODE (LOW_POWER_ALL_PHYS)
	Set Radio Power mode. More...

#define	dg_configRF_CALIB_TEMP_DIFF (8)
	Set temperature difference trigger for RF calibration (in Celsius degrees) More...

#define	dg_configRF_CALIB_TEMP_POLL_INTV (1000)
	Set temperature poll interval (in milliseconds) More...

#define	defaultBLE_DEVICE_NAME "Dialog BLE"
	Default device name (GAP service attribute only) More...

#define	defaultBLE_APPEARANCE (0)
	Default appearance (GAP service attribute only) More...

#define	defaultBLE_MAX_CONNECTIONS (CFG_CON)
	Default maximum number of simultaneous connections. More...

#define	defaultBLE_MAX_BONDED (8)
	Default maximum number of bonded devices. More...

#define	defaultBLE_GAP_ROLE GAP_NO_ROLE
	Default GAP role. More...

#define	defaultBLE_ADDRESS_RENEW_DURATION (900)
	Default random address renew duration. More...

#define	defaultBLE_STATIC_ADDRESS { 0x06, 0x00, 0xF4, 0x35, 0x23, 0x48 }
	Default static BD address. More...

#define	defaultBLE_ADDRESS_TYPE PUBLIC_ADDRESS
	Default BD address type. More...

#define	defaultBLE_IRK
	Default Identity Resolution Key. More...

#define	defaultBLE_ATT_DB_CONFIGURATION (0x10)
	Default attribute database configuration. More...

#define	defaultBLE_MAX_MTU_SIZE (512)
	Maximum MTU size. More...

#define	defaultBLE_MIN_MTU_SIZE (65)
	Minimum MTU size. More...

#define	defaultBLE_MTU_SIZE (defaultBLE_MIN_MTU_SIZE)
	Default MTU size. More...

#define	defaultBLE_CHANNEL_MAP {0xFF, 0xFF, 0xFF, 0xFF, 0x1F}
	Default channel map (for central role only) More...

#define	defaultBLE_ADVERTISE_MODE GAP_DISC_MODE_GEN_DISCOVERABLE
	Default advertising mode. More...

#define	defaultBLE_ADVERTISE_CHANNEL_MAP (GAP_ADV_CHANNEL_37 \| GAP_ADV_CHANNEL_38 \| GAP_ADV_CHANNEL_39)
	Default channels used for advertising. More...

#define	defaultBLE_ADVERTISE_INTERVAL_MIN (BLE_ADV_INTERVAL_FROM_MS(687.5))
	Default minimum interval used for advertising. More...

#define	defaultBLE_ADVERTISE_INTERVAL_MAX (BLE_ADV_INTERVAL_FROM_MS(687.5))
	Default maximum interval used for advertising. More...

#define	defaultBLE_ADVERTISE_FILTER_POLICY ADV_ALLOW_SCAN_ANY_CONN_ANY
	Default filtering policy used for advertising. More...

#define	defaultBLE_ADVERTISE_DATA_LENGTH (28)
	Default advertising data length. More...

#define	defaultBLE_ADVERTISE_DATA
	Default advertising Data. More...

#define	defaultBLE_SCAN_RESPONSE_DATA_LENGTH (31)
	Default scan response data length. More...

#define	defaultBLE_SCAN_RESPONSE_DATA { }
	Default scan response Data. More...

#define	defaultBLE_SCAN_INTERVAL (BLE_SCAN_INTERVAL_FROM_MS(100))
	Default scan interval. More...

#define	defaultBLE_SCAN_WINDOW (BLE_SCAN_WINDOW_FROM_MS(50))
	Default scan window. More...

#define	defaultBLE_PPCP_INTERVAL_MIN (BLE_CONN_INTERVAL_FROM_MS(10))
	Default peripheral preferred minimum connection interval. More...

#define	defaultBLE_PPCP_INTERVAL_MAX (BLE_CONN_INTERVAL_FROM_MS(20))
	Default peripheral preferred maximum connection interval. More...

#define	defaultBLE_PPCP_SLAVE_LATENCY (0)
	Default peripheral preferred slave latency. More...

#define	defaultBLE_PPCP_SUP_TIMEOUT (BLE_SUPERVISION_TMO_FROM_MS(1000))
	Default peripheral preferred supervision timeout. More...

#define	defaultBLE_GAP_IO_CAP GAP_IO_CAP_NO_INPUT_OUTPUT
	Default Input/Output capabilities. More...

#define	defaultBLE_DIS_MANUFACTURER "Renesas Electronics Corporation"
	Device Information Service default data. More...

#define	USE_BLE_SLEEP 1
	Use passthrough mode. More...

#define	dg_configBLE_2MBIT_PHY (1)
	Enable 2MBIT PHY. More...

#define	dg_configBLE_UUID_SUOTA_SERVICE (0xFEF5)
	Set the UUID of the SUOTA service. More...

Detailed Description

BLE configuration options.

The following tags are used to describe the type of each configuration option.

BUILD : To be changed only in the build configuration of the project ("Defined symbols -D" in the preprocessor options).
APP : To be changed only in the custom_config*.h project files.
EXPERT-only : To be changed only by an expert user.

Macro Definition Documentation

◆ defaultBLE_ADDRESS_RENEW_DURATION

#define defaultBLE_ADDRESS_RENEW_DURATION (900)

Default random address renew duration.

Default duration for random address generation when a random resolvable or a random non-resolvable address has been set using ble_gap_address_set().

Note: Value is in seconds (valid range is 1 to 3600 seconds. Out of range values will be ignored)

APP

◆ defaultBLE_ADDRESS_TYPE

#define defaultBLE_ADDRESS_TYPE PUBLIC_ADDRESS

Default BD address type.

Default BD address type used if one is not set using ble_gap_address_set().

APP

◆ defaultBLE_ADVERTISE_CHANNEL_MAP

#define defaultBLE_ADVERTISE_CHANNEL_MAP (GAP_ADV_CHANNEL_37 | GAP_ADV_CHANNEL_38 | GAP_ADV_CHANNEL_39)

Default channels used for advertising.

Default channel used for advertising if they are not set using ble_gap_adv_chnl_map_set().

APP

◆ defaultBLE_ADVERTISE_DATA

#define defaultBLE_ADVERTISE_DATA

Value:

{ 0x0D, GAP_DATA_TYPE_LOCAL_NAME, \

'R', 'e', 'n', 'e', 's', 'a', 's', ' ', 'B', 'L', 'E' }

Default advertising Data.

Default advertising data are set to advertise the device name. If the application should have specific advertising data, these should be set using the ble_gap_adv_data_set().

Note: Changing defaultBLE_DEVICE_NAME won't change the device name included by default in the advertising data.

APP

◆ defaultBLE_ADVERTISE_DATA_LENGTH

#define defaultBLE_ADVERTISE_DATA_LENGTH (28)

Default advertising data length.

Default length of advertising data. This is set to the maximum value allowed by the stack, which is 28 bytes.

APP

◆ defaultBLE_ADVERTISE_FILTER_POLICY

#define defaultBLE_ADVERTISE_FILTER_POLICY ADV_ALLOW_SCAN_ANY_CONN_ANY

Default filtering policy used for advertising.

Default filtering policy used for advertising if one is not set using ble_gap_adv_filt_policy_set().

Note: Whitelist management API is not present in this release, so setting a filtering policy for advertising is not possible.

APP

◆ defaultBLE_ADVERTISE_INTERVAL_MAX

#define defaultBLE_ADVERTISE_INTERVAL_MAX (BLE_ADV_INTERVAL_FROM_MS(687.5))

Default maximum interval used for advertising.

Default maximum interval used for advertising in steps of 0.625ms if one is not set using ble_gap_adv_intv_set().

APP

◆ defaultBLE_ADVERTISE_INTERVAL_MIN

#define defaultBLE_ADVERTISE_INTERVAL_MIN (BLE_ADV_INTERVAL_FROM_MS(687.5))

Default minimum interval used for advertising.

Default minimum interval used for advertising in steps of 0.625ms if one is not set using ble_gap_adv_intv_set().

APP

◆ defaultBLE_ADVERTISE_MODE

#define defaultBLE_ADVERTISE_MODE GAP_DISC_MODE_GEN_DISCOVERABLE

Default advertising mode.

Default mode used for advertising if one is not set using ble_gap_adv_mode_set().

APP

◆ defaultBLE_APPEARANCE

#define defaultBLE_APPEARANCE (0)

Default appearance (GAP service attribute only)

Appearance used for GAP service attribute.

Note: This is not reflected on advertising data, which have to be changed either using ble_gap_adv_data_set() or by changing defaultBLE_ADVERTISE_DATA.

APP

◆ defaultBLE_ATT_DB_CONFIGURATION

#define defaultBLE_ATT_DB_CONFIGURATION (0x10)

Default attribute database configuration.

* Default attribute database configuration:
*     7     6    5     4     3    2    1    0
* +-----+-----+----+-----+-----+----+----+----+
* | DBG | RFU | SC | PCP | APP_PERM |NAME_PERM|
* +-----+-----+----+-----+-----+----+----+----+
* - Bit [0-1]: Device Name write permission requirements for peer device (see gapm_write_att_perm)
* - Bit [2-3]: Device Appearance write permission requirements for peer device (see gapm_write_att_perm)
* - Bit [4]  : Slave Preferred Connection Parameters present
* - Bit [5]  : Service change feature present in GATT attribute database.
* - Bit [6]  : Reserved
* - Bit [7]  : Enable Debug Mode
*

APP EXPERT-only

◆ defaultBLE_CHANNEL_MAP

#define defaultBLE_CHANNEL_MAP {0xFF, 0xFF, 0xFF, 0xFF, 0x1F}

Default channel map (for central role only)

Default channel map used when device is configured with the central role if one is not set using ble_gap_channel_map_set().

APP

◆ defaultBLE_DEVICE_NAME

#define defaultBLE_DEVICE_NAME "Dialog BLE"

Default device name (GAP service attribute only)

Device Name used for GAP service attribute.

Note: This is not reflected on advertising data, which have to be changed either using ble_gap_adv_data_set() or by changing defaultBLE_ADVERTISE_DATA.

APP

◆ defaultBLE_DIS_MANUFACTURER

#define defaultBLE_DIS_MANUFACTURER "Renesas Electronics Corporation"

Device Information Service default data.

APP

◆ defaultBLE_GAP_IO_CAP

#define defaultBLE_GAP_IO_CAP GAP_IO_CAP_NO_INPUT_OUTPUT

Default Input/Output capabilities.

Default input/output capabilities set for pairing procedures if they are not set using the ble_gap_set_io_cap().

APP

◆ defaultBLE_GAP_ROLE

#define defaultBLE_GAP_ROLE GAP_NO_ROLE

Default GAP role.

Default GAP role set at start-up, if not set otherwise using ble_gap_role_set(), ble_peripheral_start() or ble_central_start()).

APP

◆ defaultBLE_IRK

#define defaultBLE_IRK

Value:

{ 0xEF, 0xCD, 0xAB, 0x89, 0x67, 0x45, 0x23, 0x01, \

0xEF, 0xCD, 0xAB, 0x89, 0x67, 0x45, 0x23, 0x01 }

Default Identity Resolution Key.

Default Identity Resolution Key to be used upon IRK exchange.

APP

◆ defaultBLE_MAX_BONDED

#define defaultBLE_MAX_BONDED (8)

Default maximum number of bonded devices.

Maximum number of bonded devices for which bonding data can be maintained in persistent storage.

APP

◆ defaultBLE_MAX_CONNECTIONS

#define defaultBLE_MAX_CONNECTIONS (CFG_CON)

Default maximum number of simultaneous connections.

Maximum number of connections that can maintained simultaneously.

APP

◆ defaultBLE_MAX_MTU_SIZE

#define defaultBLE_MAX_MTU_SIZE (512)

Maximum MTU size.

Maximum supported MTU size.

APP EXPERT-only

◆ defaultBLE_MIN_MTU_SIZE

#define defaultBLE_MIN_MTU_SIZE (65)

Minimum MTU size.

Minimum supported MTU size as defined by Bluetooth SIG:

23 when LE Secure Connections are not used.
65 when LE Secure Connections are used.

APP EXPERT-only

◆ defaultBLE_MTU_SIZE

#define defaultBLE_MTU_SIZE (defaultBLE_MIN_MTU_SIZE)

Default MTU size.

Default MTU size used on MTU exchange negotiations if one is not set using ble_gap_mtu_size_set().

APP

◆ defaultBLE_PPCP_INTERVAL_MAX

#define defaultBLE_PPCP_INTERVAL_MAX (BLE_CONN_INTERVAL_FROM_MS(20))

Default peripheral preferred maximum connection interval.

Default maximum connection interval set in the peripheral preferred connection parameters attribute in steps of 1.25ms if one is not set using ble_gap_per_pref_conn_params_set().

APP EXPERT-only

◆ defaultBLE_PPCP_INTERVAL_MIN

#define defaultBLE_PPCP_INTERVAL_MIN (BLE_CONN_INTERVAL_FROM_MS(10))

Default peripheral preferred minimum connection interval.

Default minimum connection interval set in the peripheral preferred connection parameters attribute in steps of 1.25ms if one is not set using ble_gap_per_pref_conn_params_set().

APP EXPERT-only

◆ defaultBLE_PPCP_SLAVE_LATENCY

#define defaultBLE_PPCP_SLAVE_LATENCY (0)

Default peripheral preferred slave latency.

Default slave latency set in the peripheral preferred connection parameters attribute in number of events if one is not set using ble_gap_per_pref_conn_params_set().

APP EXPERT-only

◆ defaultBLE_PPCP_SUP_TIMEOUT

#define defaultBLE_PPCP_SUP_TIMEOUT (BLE_SUPERVISION_TMO_FROM_MS(1000))

Default peripheral preferred supervision timeout.

Default supervision timeout set in the peripheral preferred connection parameters attribute in steps of 10ms if one is not set using ble_gap_per_pref_conn_params_set().

APP EXPERT-only

◆ defaultBLE_SCAN_INTERVAL

#define defaultBLE_SCAN_INTERVAL (BLE_SCAN_INTERVAL_FROM_MS(100))

Default scan interval.

Default interval used for scanning in steps of 0.625ms if one is not set using ble_gap_scan_params_set().

APP EXPERT-only

◆ defaultBLE_SCAN_RESPONSE_DATA

#define defaultBLE_SCAN_RESPONSE_DATA { }

Default scan response Data.

Default scan response data are set to zero. If the application should have specific scan response data, these should be set using the ble_gap_adv_data_set().

Note: Changing defaultBLE_DEVICE_NAME won't change the device name included by default in the scan response data.

APP

◆ defaultBLE_SCAN_RESPONSE_DATA_LENGTH

#define defaultBLE_SCAN_RESPONSE_DATA_LENGTH (31)

Default scan response data length.

Default length of scan response data. This is set to the maximum value allowed by the stack, which is 31 bytes.

APP

◆ defaultBLE_SCAN_WINDOW

#define defaultBLE_SCAN_WINDOW (BLE_SCAN_WINDOW_FROM_MS(50))

Default scan window.

Default window used for scanning in steps of 0.625ms if one is not set using ble_gap_scan_params_set().

APP EXPERT-only

◆ defaultBLE_STATIC_ADDRESS

#define defaultBLE_STATIC_ADDRESS { 0x06, 0x00, 0xF4, 0x35, 0x23, 0x48 }

Default static BD address.

Default static BD address set if one is not retrieved from the non-volatile storage.

APP

◆ dg_configBLE_2MBIT_PHY

#define dg_configBLE_2MBIT_PHY (1)

Enable 2MBIT PHY.

This is defined by default to 1 to enable LE 2MBIT PHY.

◆ dg_configBLE_ADV_STOP_DELAY_ENABLE

#define dg_configBLE_ADV_STOP_DELAY_ENABLE (0)

Enable ADV_UNDERRUN workaround.

If the application has not defined dg_configBLE_ADV_STOP_DELAY_ENABLE in its custom_config file, this is defined to the default value of 0 to disable the ADV_UNDERRUN workaround in the BLE adapter.

APP EXPERT-only

◆ dg_configBLE_BROADCASTER

#define dg_configBLE_BROADCASTER (1)

Enable the Broadcaster role in the BLE framework.

By default, all roles are supported by the BLE framework. However, if the application does not use the Broadcaster role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_CENTRAL

#define dg_configBLE_CENTRAL (1)

Enable the Central role in the BLE framework.

By default, all roles are supported by the BLE framework. However, if the application does not use the Central role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_CONN_EVENT_LENGTH_MAX

#define dg_configBLE_CONN_EVENT_LENGTH_MAX (0xFFFF)

Maximum Connection Event Length.

Maximum length for connection events in steps of 0.625ms. This is set to a "don't care" value since the BLE stack uses only dg_configBLE_CONN_EVENT_LENGTH_MIN to determine the connection event length to use for a given connection.

Note: This is used in outgoing connection requests initiated using ble_gap_connect(), and connection parameter requests and connection updates done using ble_gap_conn_param_update() and ble_gap_conn_param_update_reply(), if the maximum length for connection events is not modified by the application using ble_gap_connect_ce().; This parameter applies only when the device is the master of the connection.

APP EXPERT-only

◆ dg_configBLE_CONN_EVENT_LENGTH_MIN

#define dg_configBLE_CONN_EVENT_LENGTH_MIN

Value:

( (BLE_DATA_LENGTH_TO_TIME(dg_configBLE_DATA_LENGTH_RX_MAX) \

+ BLE_DATA_LENGTH_TO_TIME(dg_configBLE_DATA_LENGTH_TX_MAX) + 150 + 624) / 625)

Minimum Connection Event Length.

Minimum length for Connection Event in steps of 0.625ms. This is calculated based on the maximum LE Data Lengths defined for reception and transmission (dg_configBLE_DATA_LENGTH_RX_MAX and dg_configBLE_DATA_LENGTH_TX_MAX respectively) plus 150us for the IFS.

Note: This is used in outgoing connection requests initiated using ble_gap_connect(), and connection parameter requests and connection updates done using ble_gap_conn_param_update() and ble_gap_conn_param_update_reply(), if the maximum length for connection events is not modified by the application using ble_gap_connect_ce().; This parameter applies only when the device is the master of the connection.

APP EXPERT-only

◆ dg_configBLE_CONNECTIONS_MAX

#define dg_configBLE_CONNECTIONS_MAX (2)

Define the maximum number of connections.

Define what will be the maximum number of connections. The minimum supported number by the BLE stack is 1 connection and the maximum is 8 connections. The default value for the DA1459X device family is 2 connections and for the rest is 8 connections.

APP EXPERT-only

◆ dg_configBLE_DATA_LENGTH_RX_MAX

#define dg_configBLE_DATA_LENGTH_RX_MAX (251)

Maximum Receive Data Channel PDU Payload Length.

If the application has not defined dg_configBLE_DATA_LENGTH_RX_MAX in its custom_config file, this is defined to the maximum value allowed by Bluetooth Core v_4.2, which is 251 octets.

Note: This value should be between 27 and 251.

APP EXPERT-only

◆ dg_configBLE_DATA_LENGTH_TX_MAX

#define dg_configBLE_DATA_LENGTH_TX_MAX (251)

Maximum Transmit Data Channel PDU Payload Length.

If the application has not defined dg_configBLE_DATA_LENGTH_TX_MAX in its custom_config file, this is defined to the maximum value allowed by Bluetooth Core v_4.2, which is 251 octets.

Note: This value should be between 27 and 251.

APP EXPERT-only

◆ dg_configBLE_DUPLICATE_FILTER_MAX

#define dg_configBLE_DUPLICATE_FILTER_MAX (10)

Duplicate Filtering List Maximum size.

This defines the size of the list used for duplicate filtering. When the duplicate filtering list is full, additional advertising reports or scan responses will be dropped.

APP EXPERT-only

◆ dg_configBLE_EVENT_COUNTER_ENABLE

#define dg_configBLE_EVENT_COUNTER_ENABLE (0)

Enable Event Counters in BLE ISR.

If the application has not defined dg_configBLE_EVENT_COUNTER_ENABLE in its custom_config file, this is defined to the default value of 0 to disable the Event Counters in BLE stack ISR.

APP EXPERT-only

◆ dg_configBLE_GATT_CLIENT

#define dg_configBLE_GATT_CLIENT (1)

Enable the GATT Client role in the BLE framework.

By default, all GATT roles are supported by the BLE framework. However, if the application does not use the GATT Client role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_GATT_SERVER

#define dg_configBLE_GATT_SERVER (1)

Enable the GATT Server role in the BLE framework.

By default, all GATT roles are supported by the BLE framework. However, if the application does not use the GATT Server role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_INITIAL_TX_POWER

#define dg_configBLE_INITIAL_TX_POWER (GAP_TX_POWER_0_dBm)

Pairing successes threshold for renewing the public key (DEPRECATED)

This option is deprecated. The P-256 Public/Private Key Pair is automatically renewed by the stack prior to every pairing procedure.

Pairing failures threshold for renewing the public key (DEPRECATED)

This option is deprecated. The P-256 Public/Private Key Pair is automatically renewed by the stack prior to every pairing procedure.

Set initial BLE TX power for any operation

If the application has not defined dg_configBLE_INITIAL_TX_POWER in its custom configuration file, this is defined by default to 0 dBm.

◆ dg_configBLE_L2CAP_COC

#define dg_configBLE_L2CAP_COC (1)

Enable L2CAP CoC (Connection Oriented Channels) in the BLE framework.

If the application does not use L2CAP CoC, it can define this macro to 0 in its custom config file to reduce code size.

◆ dg_configBLE_OBSERVER

#define dg_configBLE_OBSERVER (1)

Enable the Observer role in the BLE framework.

By default, all roles are supported by the BLE framework. However, if the application does not use the Observer role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_PAIR_INIT_KEY_DIST

#define dg_configBLE_PAIR_INIT_KEY_DIST (GAP_KDIST_ENCKEY | GAP_KDIST_IDKEY | GAP_KDIST_SIGNKEY)

Security keys to be distributed by the pairing initiator.

This defines which security keys will be requested to be distributed by the pairing initiator during a pairing feature exchange procedure.

Available keys for distribution:

GAP_KDIST_ENCKEY: Long Term Key (LTK)
GAP_KDIST_IDKEY: Identity Resolving Key (IRK)
GAP_KDIST_SIGNKEY: Connection Signature Resolving Key (CSRK)

APP EXPERT-only

◆ dg_configBLE_PAIR_RESP_KEY_DIST

#define dg_configBLE_PAIR_RESP_KEY_DIST (GAP_KDIST_ENCKEY | GAP_KDIST_IDKEY | GAP_KDIST_SIGNKEY)

Security keys to be distributed by the pairing responder.

This defines which security keys will be requested to be distributed by the pairing responder during a pairing feature exchange procedure.

Available keys for distribution:

GAP_KDIST_ENCKEY: Long Term Key (LTK)
GAP_KDIST_IDKEY: Identity Resolving Key (IRK)
GAP_KDIST_SIGNKEY: Connection Signature Resolving Key (CSRK)

APP EXPERT-only

◆ dg_configBLE_PERIPHERAL

#define dg_configBLE_PERIPHERAL (1)

Enable the Peripheral role in the BLE framework.

By default, all roles are supported by the BLE framework. However, if the application does not use the Peripheral role, it can define this macro to 0 in its custom config file to reduce code size.

APP EXPERT-only

◆ dg_configBLE_PRIVACY_1_2

#define dg_configBLE_PRIVACY_1_2 (0)

Enable LE Privacy v1.2 functionality.

To use this feature, ble_gap_address_set() should be called using the PRIVATE_CNTL address type. The configuration of the Resolving Address List (RAL) is handled by the BLE Manager and will be used by the Link Layer when advertising, scanning or connection procedures take place. RAL will be automatically updated when new bonds are created or existing bonds are removed.

APP EXPERT-only

◆ dg_configBLE_SECURE_CONNECTIONS

#define dg_configBLE_SECURE_CONNECTIONS (1)

Enable Secure Connections.

If the application has not defined dg_configBLE_SECURE_CONNECTIONS in its custom configuration file, this is defined by default to 1 to enable LE Secure Connections.

APP

◆ dg_configBLE_SKIP_LATENCY_API

#define dg_configBLE_SKIP_LATENCY_API (0)

Enable the ble_gap_skip_latency() API.

APP EXPERT-only

◆ dg_configBLE_UUID_SUOTA_SERVICE

#define dg_configBLE_UUID_SUOTA_SERVICE (0xFEF5)

Set the UUID of the SUOTA service.

APP EXPERT-only

◆ dg_configDEFAULT_RADIO_OP_MODE

#define dg_configDEFAULT_RADIO_OP_MODE (LOW_POWER_ALL_PHYS)

Set Radio Power mode.

LOW_POWER_ALL_PHYS
HIGH_PERFORMANCE_ALL_PHYS

◆ dg_configRF_CALIB_TEMP_DIFF

#define dg_configRF_CALIB_TEMP_DIFF (8)

Set temperature difference trigger for RF calibration (in Celsius degrees)

Define the temperature difference in Celsius degrees after which the RF calibration will be triggered.

APP

◆ dg_configRF_CALIB_TEMP_POLL_INTV

#define dg_configRF_CALIB_TEMP_POLL_INTV (1000)

Set temperature poll interval (in milliseconds)

Define the temperature measurement poll interval (in milliseconds) used for RF calibration.

APP

◆ USE_BLE_SLEEP

#define USE_BLE_SLEEP 1

Use passthrough mode.

If application has enabled the external host configuration, BLE stack is configured for pass-through mode.

Use BLE sleep mode

Macro USE_BLE_SLEEP controls whether BLE will be set to sleep when it is not needed to be active.

APP EXPERT-only

Modules

Files

Macros

Detailed Description

Macro Definition Documentation

◆ defaultBLE_ADDRESS_RENEW_DURATION

◆ defaultBLE_ADDRESS_TYPE

◆ defaultBLE_ADVERTISE_CHANNEL_MAP

◆ defaultBLE_ADVERTISE_DATA

◆ defaultBLE_ADVERTISE_DATA_LENGTH

◆ defaultBLE_ADVERTISE_FILTER_POLICY

◆ defaultBLE_ADVERTISE_INTERVAL_MAX

◆ defaultBLE_ADVERTISE_INTERVAL_MIN

◆ defaultBLE_ADVERTISE_MODE

◆ defaultBLE_APPEARANCE

◆ defaultBLE_ATT_DB_CONFIGURATION

◆ defaultBLE_CHANNEL_MAP

◆ defaultBLE_DEVICE_NAME

◆ defaultBLE_DIS_MANUFACTURER

◆ defaultBLE_GAP_IO_CAP

◆ defaultBLE_GAP_ROLE

◆ defaultBLE_IRK

◆ defaultBLE_MAX_BONDED

◆ defaultBLE_MAX_CONNECTIONS

◆ defaultBLE_MAX_MTU_SIZE

◆ defaultBLE_MIN_MTU_SIZE

◆ defaultBLE_MTU_SIZE

◆ defaultBLE_PPCP_INTERVAL_MAX

◆ defaultBLE_PPCP_INTERVAL_MIN

◆ defaultBLE_PPCP_SLAVE_LATENCY

◆ defaultBLE_PPCP_SUP_TIMEOUT

◆ defaultBLE_SCAN_INTERVAL

◆ defaultBLE_SCAN_RESPONSE_DATA

◆ defaultBLE_SCAN_RESPONSE_DATA_LENGTH

◆ defaultBLE_SCAN_WINDOW

◆ defaultBLE_STATIC_ADDRESS

◆ dg_configBLE_2MBIT_PHY

◆ dg_configBLE_ADV_STOP_DELAY_ENABLE

◆ dg_configBLE_BROADCASTER

◆ dg_configBLE_CENTRAL

◆ dg_configBLE_CONN_EVENT_LENGTH_MAX

◆ dg_configBLE_CONN_EVENT_LENGTH_MIN

◆ dg_configBLE_CONNECTIONS_MAX

◆ dg_configBLE_DATA_LENGTH_RX_MAX

◆ dg_configBLE_DATA_LENGTH_TX_MAX

◆ dg_configBLE_DUPLICATE_FILTER_MAX

◆ dg_configBLE_EVENT_COUNTER_ENABLE

◆ dg_configBLE_GATT_CLIENT

◆ dg_configBLE_GATT_SERVER

◆ dg_configBLE_INITIAL_TX_POWER

◆ dg_configBLE_L2CAP_COC

◆ dg_configBLE_OBSERVER

◆ dg_configBLE_PAIR_INIT_KEY_DIST

◆ dg_configBLE_PAIR_RESP_KEY_DIST

◆ dg_configBLE_PERIPHERAL

◆ dg_configBLE_PRIVACY_1_2

◆ dg_configBLE_SECURE_CONNECTIONS

◆ dg_configBLE_SKIP_LATENCY_API

◆ dg_configBLE_UUID_SUOTA_SERVICE

◆ dg_configDEFAULT_RADIO_OP_MODE

◆ dg_configRF_CALIB_TEMP_DIFF

◆ dg_configRF_CALIB_TEMP_POLL_INTV

◆ USE_BLE_SLEEP