ble_gap_cfg_device_name_t

Device name and its properties, set with sd_ble_cfg_set .

Note

If the device name is not configured, the default device name will be BLE_GAP_DEVNAME_DEFAULT , the maximum device name length will be BLE_GAP_DEVNAME_DEFAULT_LEN , vloc will be set to BLE_GATTS_VLOC_STACK and the device name will have no write access.

If max_len is more than BLE_GAP_DEVNAME_DEFAULT_LEN and vloc is set to BLE_GATTS_VLOC_STACK , the attribute table size must be increased to have room for the longer device name (see sd_ble_cfg_set and ble_gatts_cfg_attr_tab_size_t ).

If vloc is BLE_GATTS_VLOC_STACK :

• p_value must point to non-volatile memory (flash) or be NULL.
• If p_value is NULL, the device name will initially be empty.

If vloc is BLE_GATTS_VLOC_USER :

• p_value cannot be NULL.
• If the device name is writable, p_value must point to volatile memory (RAM).

Return values

NRF_ERROR_INVALID_PARAM	One or more of the following is true: Invalid device name location (vloc). Invalid device name security mode.
NRF_ERROR_INVALID_LENGTH	One or more of the following is true: The device name length is invalid (must be between 0 and BLE_GAP_DEVNAME_MAX_LEN ). The device name length is too long for the given Attribute Table.
NRF_ERROR_NOT_SUPPORTED	Device name security mode is not supported.