Reference   Language | Libraries | Comparison | Changes

ArduinoBLE : BLECharacteristic class

writeValue

Description

Write the value of the characteristic. If the characteristic is on a remote device, a write request or command will be sent.

Syntax

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

Parameters

buffer: byte array to write value with
length: number of bytes of the buffer argument to write
value: value to write

Returns

1 on success, 0 on failure

Example

…
    // read the button pin
    int buttonState = digitalRead(buttonPin);

    if (oldButtonState != buttonState) {
      // button changed
      oldButtonState = buttonState;

      if (buttonState) {
        Serial.println("button pressed");

        // button is pressed, write 0x01 to turn the LED on
        ledCharacteristic.writeValue((byte)0x01);
      } else {
        Serial.println("button released");

        // button is released, write 0x00 to turn the LED off
        ledCharacteristic.writeValue((byte)0x00);
      }
    }
…
[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.