Reference   Language | Libraries | Comparison | Changes

ArduinoBLE : BLECharacteristic class

readValue

Description

Read the current value of the characteristic. If the characteristic is on a remote device, a read request will be sent.

Syntax

bleCharacteristic.readValue(buffer, length)
bleCharacteristic.readValue(value)

Parameters

buffer: byte array to read value into length: size of buffer argument in bytes value: variable to read value into (by reference)

Returns

Number of bytes read

Example

…
  while (peripheral.connected()) {
    // while the peripheral is connected

    // check if the value of the simple key characteristic has been updated
    if (simpleKeyCharacteristic.valueUpdated()) {
      // yes, get the value, characteristic is 1 byte so use byte value
      byte value = 0;

      simpleKeyCharacteristic.readValue(value);

      if (value & 0x01) {
        // first bit corresponds to the right button
        Serial.println("Right button pressed");
      }

      if (value & 0x02) {
        // second bit corresponds to the left button
        Serial.println("Left button pressed");
      }
    }
  }
…
[Get Code]

See Also





Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.