sd_ble_gattc_read()

uint32_t sd_ble_gattc_read	(	uint16_t	conn_handle,
		uint16_t	handle,
		uint16_t	offset )

#include <ble_gattc.h>

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

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 generated

BLE_GATTC_EVT_READ_RSP

Relevant Message Sequence Charts

GATTC Characteristic or Descriptor Value Read

Parameters

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

Return values

NRF_SUCCESS	Successfully started or resumed the Read (Long) procedure.
BLE_ERROR_INVALID_CONN_HANDLE	Invalid Connection Handle.
NRF_ERROR_INVALID_STATE	Invalid Connection State.
NRF_ERROR_BUSY	Client procedure already in progress.
NRF_ERROR_TIMEOUT	There has been a GATT procedure timeout. No new GATT procedure can be performed without reestablishing the connection.