sd_ble_cfg_set()

uint32_t sd_ble_cfg_set	(	uint32_t	cfg_id,
		ble_cfg_t const *	p_cfg,
		uint32_t	app_ram_base )

#include <ble.h>

Add configurations for the BLE stack.

Parameters

[in]	cfg_id	Config ID, see BLE_CONN_CFGS, BLE_COMMON_CFGS, BLE_GAP_CFGS or BLE_GATTS_CFGS.
[in]	p_cfg	Pointer to a ble_cfg_t structure containing the configuration value.
[in]	app_ram_base	The start address of the application RAM region (APP_RAM_BASE). See sd_ble_enable for details about APP_RAM_BASE.

Note

The memory requirement for a specific configuration will not increase between SoftDevices with the same major version number.

If a configuration is set more than once, the last one set is the one that takes effect on sd_ble_enable.

Any part of the BLE stack that is NOT configured with sd_ble_cfg_set will have default configuration.

sd_ble_cfg_set may be called at any time when the SoftDevice is enabled (see sd_softdevice_enable) while the BLE part of the SoftDevice is not enabled (see sd_ble_enable).

Error codes for the configurations are described in the configuration structs.

Relevant Message Sequence Charts

BLE Stack Enable

Return values

NRF_SUCCESS	The configuration has been added successfully.
NRF_ERROR_INVALID_STATE	The BLE stack had already been initialized.
NRF_ERROR_INVALID_ADDR	Invalid or not sufficiently aligned pointer supplied.
NRF_ERROR_INVALID_PARAM	Invalid cfg_id supplied.
NRF_ERROR_NOT_SUPPORTED	A second connection configuration (ble_conn_cfg_t::conn_cfg_tag) is attempted to be created.
NRF_ERROR_NO_MEM	The amount of memory assigned to the SoftDevice by app_ram_base is not large enough to fit this configuration's memory requirement.