Embassy
nrf-softdevice-s113

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gattc_characteristics_discover(
conn_handle: u16,
p_handle_range: *const ble_gattc_handle_range_t
) -> u32
Expand description

@brief Initiate or continue a GATT Characteristic Discovery procedure.

@details This function initiates or resumes a Characteristic discovery procedure. If the last Characteristic has not been reached, this must be called again with an updated handle range to continue the discovery.

@note If any of the discovered characteristics have 128-bit UUIDs which are not present in the table provided to ble_vs_uuids_assign, a UUID structure with type @ref BLE_UUID_TYPE_UNKNOWN will be received in the corresponding event.

@events @event{@ref BLE_GATTC_EVT_CHAR_DISC_RSP} @endevents

@mscs @mmsc{@ref BLE_GATTC_CHAR_DISC_MSC} @endmscs

@param[in] conn_handle The connection handle identifying the connection to perform this procedure on. @param[in] p_handle_range A pointer to the range of handles of the Service to perform this procedure on.

@retval ::NRF_SUCCESS Successfully started or resumed the Characteristic Discovery procedure. @retval ::BLE_ERROR_INVALID_CONN_HANDLE Invalid Connection Handle. @retval ::NRF_ERROR_INVALID_STATE Invalid Connection State. @retval ::NRF_ERROR_INVALID_ADDR Invalid pointer supplied. @retval ::NRF_ERROR_BUSY Client procedure already in progress. @retval ::NRF_ERROR_TIMEOUT There has been a GATT procedure timeout. No new GATT procedure can be performed without reestablishing the connection.