Skip to main content
Reads the current value of a characteristic on a connected BLE device. The result is delivered via my.onBLECharacteristicValueChange.

​
Parameters

PropertyTypeRequiredDescription
deviceIdStringYesDevice identifier
serviceIdStringYesService UUID
characteristicIdStringYesCharacteristic UUID
successFunctionNoCallback on success
failFunctionNoCallback on failure
completeFunctionNoCallback that always executes

​
Code Example

// Register listener first
my.onBLECharacteristicValueChange((res) => {
  console.log('Value changed:', res.characteristicId, res.value);
});

// Then trigger a read
my.readBLECharacteristicValue({
  deviceId: 'XX:XX:XX:XX:XX:XX',
  serviceId: '0000FFF0-0000-1000-8000-00805F9B34FB',
  characteristicId: '0000FFF1-0000-1000-8000-00805F9B34FB',
  success: () => {
    console.log('Read request sent');
  },
  fail: (err) => {
    console.error('Read failed:', err);
  }
});
The characteristic value is not returned directly in the success callback. Listen for my.onBLECharacteristicValueChange to receive the result.

my.writeBLECharacteristicValue

Write a characteristic value

my.onBLECharacteristicValueChange

Listen for value changes