ble_gap_opt_ch_map_t Struct Reference

Channel Map option. More...

#include </home/runner/work/sdk-nrf-bm/sdk-nrf-bm/sdk-nrf-bm/nrf-bm/components/softdevice/nrf54lm/s115/s115_API/include/ble_gap.h>

Data Fields
uint16_t	conn_handle
uint8_t	ch_map [5]

Detailed Description

Channel Map option.

Used with sd_ble_opt_get to get the current channel map or sd_ble_opt_set to set a new channel map. When setting the channel map, it applies to all current and future connections. When getting the current channel map, it applies to a single connection and the connection handle must be supplied.

Note

Setting the channel map may take some time, depending on connection parameters. The time taken may be different for each connection and the get operation will return the previous channel map until the new one has taken effect.

After setting the channel map, by spec it can not be set again until at least 1 s has passed. See Bluetooth Core Specification, Vol 4, Part E, Section 7.8.19. The SoftDevice does not enforce this.

Return values

NRF_SUCCESS	Get or set successful.
NRF_ERROR_INVALID_PARAM	One or more of the following is true: Less then two bits in ch_map are set. Bits for primary advertising channels (37-39) are set.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid connection handle supplied for get.
NRF_ERROR_NOT_SUPPORTED	Returned by sd_ble_opt_set in peripheral-only SoftDevices.

---

The documentation for this struct was generated from the following file:

• ble_gap.h