Embassy
nrf-softdevice-s140

Crates

git

Versions

default

Flavors

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

@brief Initiate or continue a GATT Read using Characteristic UUID procedure.

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

@events @event{@ref BLE_GATTC_EVT_CHAR_VAL_BY_UUID_READ_RSP} @endevents

@mscs @mmsc{@ref BLE_GATTC_READ_UUID_MSC} @endmscs

@param[in] conn_handle The connection handle identifying the connection to perform this procedure on. @param[in] p_uuid Pointer to a Characteristic value UUID to read. @param[in] p_handle_range A pointer to the range of handles to perform this procedure on.

@retval ::NRF_SUCCESS Successfully started or resumed the Read using Characteristic UUID 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.