πŸ”΅

BLE Debugger

A telescope and a scalpel for the BLE world

Page 4 of 24 MCP / API open OTA updates

Scans nearby BLE devices, shows advertising payloads and RSSI changes, then browses the complete GATT tree after connecting: services, characteristics and descriptors expanded level by level, with read, write and notification subscription.

Debugging BLE peripherals is usually slowed down by "services not fully listed", "writes have no effect" or "subscriptions get nothing". This page makes every step explicit β€” hex read/write plus a notify log turn guesswork into observation.

Screen

On-screen interface

A recreation of this page on the 2.41-inch AMOLED display (600 Γ— 450). Actual interaction and layout follow the latest firmware.

BLE debug Scan
XR-POWER-48 dBmConnected
Mi Band 8-62 dBmAdvertising
ESP32-Desk-71 dBmAdvertising
HID-Box-80 dBmAdvertising
SmartPlug-88 dBmAdvertising
Services 0x180F Β· Characteristics 0x2A19 Battery Read Notify
Screen Β· Page 4
Recreated from the real firmware layout; the display type can be changed in the admin panel
Highlights

Key capabilities

πŸ”­

Scan and advertising decode

Device name, MAC, RSSI and raw advertising bytes in hex, all visible.

🌳

Full GATT tree

Services / characteristics / descriptors expanded level by level, with permissions and UUIDs.

✍️

Read, write and subscribe

Write as hex or text; subscribed notifications print data frames live.

πŸ“‹

Persistent log

Actions and responses fully recorded and copyable for protocol analysis.

Specifications

Technical specs

RoleBLE central (active scan + connect)
ConnectivityMulti-device connection management, service discovery and MTU negotiation
I/O formatHexadecimal / UTF-8 text, long writes split into segments
Use Cases

Typical scenarios

Peripheral protocol reverse engineering

Quickly map a custom service’s characteristic layout and frame format.

Firmware bring-up

Change firmware and verify characteristic values in the same loop to shorten debugging.

On-site troubleshooting

When a user device will not connect, check whether advertising exists and services are complete.

Commands

Related commands

page 4  Jump to the BLE debugger

Read the full API & command reference β†’

⚠ Boundaries & notes
  • Some system services (HID, for instance) are claimed by the host driver and may not be listable by a generic client β€” that is expected behaviour.

Other feature pages