nrf-softdevice-s132

Crates

git

Versions

default

Flavors

pub unsafe fn sd_ble_gattc_read(conn_handle: u16, handle: u16, offset: u16) -> u32
Expand description

@brief Initiate or continue a GATT Read (Long) Characteristic or Descriptor procedure.

@details This function initiates or resumes a GATT Read (Long) Characteristic or Descriptor procedure. If the Characteristic or Descriptor to be read is longer than ATT_MTU - 1, this function must be called multiple times with appropriate offset to read the complete value.

@events @event{@ref BLE_GATTC_EVT_READ_RSP} @endevents

@mscs @mmsc{@ref BLE_GATTC_VALUE_READ_MSC} @endmscs

@param[in] conn_handle The connection handle identifying the connection to perform this procedure on. @param[in] handle The handle of the attribute to be read. @param[in] offset Offset into the attribute value to be read.

@retval ::NRF_SUCCESS Successfully started or resumed the Read (Long) procedure. @retval ::BLE_ERROR_INVALID_CONN_HANDLE Invalid Connection Handle. @retval ::NRF_ERROR_INVALID_STATE Invalid Connection State. @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.