Function nrf_softdevice_s132::sd_ble_gattc_read
source · 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.