Skip to main content
Returns the list of characteristics for a given service on a connected Bluetooth Low Energy device.

​
Parameters

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

​
Success Callback Parameters

PropertyTypeDescription
characteristicsArrayList of characteristic objects

​
Characteristic Object

PropertyTypeDescription
characteristicIdStringCharacteristic UUID
serviceIdStringParent service UUID
propertiesObjectSupported operations: read, write, notify, indicate

​
Code Example

my.getBLEDeviceCharacteristics({
  deviceId: 'XX:XX:XX:XX:XX:XX',
  serviceId: '0000FFF0-0000-1000-8000-00805F9B34FB',
  success: (res) => {
    res.characteristics.forEach((char) => {
      console.log('Characteristic:', char.characteristicId);
      console.log('Can read:', char.properties.read);
      console.log('Can notify:', char.properties.notify);
    });
  },
  fail: (err) => {
    console.error('Failed:', err);
  }
});

my.getBLEDeviceServices

Get device services

my.readBLECharacteristicValue

Read a characteristic value