Overview
The ble node enables communication with Bluetooth Low Energy devices.
Scan for nearby BLE peripherals, connect to specific devices, read and write GATT characteristics,
and receive notifications from sensors, wearables, and beacons.
Properties
| Property | Type | Required | Default | Description |
|---|---|---|---|---|
| mode | string | Yes | "scan" | "scan" | "connect" | "advertise" |
| deviceId | string | No | - | MAC address or UUID of target device |
| service | string | No | - | GATT service UUID to interact with |
| characteristic | string | No | - | GATT characteristic UUID |
| scanDuration | number | No | 10000 | Scan duration in milliseconds |
| autoReconnect | boolean | No | true | Automatically reconnect on disconnect |
| mtu | number | No | 23 | Maximum transmission unit size |
| notifications | boolean | No | false | Subscribe to characteristic notifications |
Inputs
{
"payload": {
"mode": "scan",
"duration": 5000,
"filter": "Heart"
}
}{
"payload": {
"mode": "connect",
"deviceId": "AA:BB:CC:DD:EE:FF",
"service": "180D",
"characteristic": "2A37"
}
}Outputs
{
"payload": {
"devices": [
{
"name": "Heart Rate Monitor",
"address": "AA:BB:CC:DD:EE:FF",
"rssi": -45,
"services": ["180D", "180F"]
}
]
}
}{
"payload": {
"device": "AA:BB:CC:DD:EE:FF",
"service": "180D",
"characteristic": "2A37",
"value": [0x06, 0x48],
"heartRate": 72
}
}Use Case Examples
Wearable Data
Connect to fitness trackers and smartwatches to read heart rate, step count, and activity data in real-time.
Asset Tracking
Deploy BLE beacons for indoor positioning and asset tracking with RSSI-based distance estimation.
Beacon Detection
Detect iBeacon and Eddystone beacons for proximity marketing and location-aware automation.
Sensor Networks
Read environmental data from BLE sensor tags for temperature, humidity, and air quality monitoring.
Tips & Best Practices
Use scan filters (by name or service UUID) to reduce CPU load and battery consumption during discovery.
BLE 5.0+ supports 2x speed, 4x range, and 8x broadcast data capacity over BLE 4.x connections.
Increase the MTU size for faster data transfer. Request MTU negotiation after establishing a connection.
Enable autoReconnect for critical sensor connections. The node will automatically restore the link on disconnection.