5.4.4.1 Read Remote Characteristic Value or Query as Client by Handle

Table 5-67. Format
Firmware Version 1.0Firmware Version 1.2 and Later
CHR,<hex16>,<hex16>

QCH,<hex16>[,<hex16>,<hex16>]

Note: All firmware version 1.0 syntax remains valid in version 1.2 and later.

The command CHR or QCH reads the content of the GATT service characteristic on the remote device by addressing its handle.

Command CHR or QCH takes three parameters. The first parameter indicates the handle value (16-bit hex value) of the characteristic in a particular server service. The second parameter is a 16-bit hex value that indicates the Bluetooth® Low Energy link connection handle. The user must find a match between the handle and its characteristic UUID by using command LC.

This command is effective under the following conditions:

  • An active connection with peer exists.
  • Command CI starts the client operation.
  • The handle parameter is valid and the corresponding characteristic is readable according to its property.

The value returned is retrieved from the remote peer device.

ItemFirmware Version 1.0 and LaterDescription
Example:CHR,001A,0071

Read the content of the characteristic with the handle 0x001A from the remote device; the connection handle is 0x0071

Response:<Value read>Success
Err

Syntax error, invalid parameter, not connected or characteristic not readable

%ERR_READ%Status string
ItemFirmware Version 1.2 and LaterDescription
Example:QCH,001A,0071

Read the content of the characteristic with the handle 0x001A from the remote device; the connection handle is 0x0071

Response:<Value read>Success
Err

Syntax error, invalid parameter, not connected or characteristic not readable

%ERR_READ%Status string