A Web Bluetooth configuration tool for connecting to and configuring supported BTHome Bluetooth sensors directly from a browser.
This tool is intended only for Athom devices.
- Presence sensor
PSBT03 - Door sensor
SS01-DTH
- Read, generate, and write the BTHome AES key
- Configure the presence sensor report interval, from
10to600seconds - Configure presence sensor radar parameters:
ONTH,HOLD,R1TH,R2TH, andR3TH - Send raw radar AT commands to the presence sensor
- Configure door sensor debounce time, from
10to5000ms - Upgrade firmware over OTA
- Restore key, reboot device, and reset radar parameters
This tool uses Web Bluetooth, so it must run in a browser that supports it:
- Recommended: Chrome / Edge on desktop
- Android: Chrome
- Not supported: iOS Safari
Open https://athom-tech.github.io/bthome-sensor/ and follow the on-page instructions to configure
The AES key is 16 bytes long, represented as 32 hexadecimal characters. It is used by platforms such as Home Assistant to authenticate encrypted BTHome devices.
You can enter a key manually or generate a random one. A generated key is not written to the device until you click the save button.
The presence sensor supports:
- Report interval:
10-600seconds, persisted after power loss - Common radar parameters:
ONTH,HOLD,R1TH,R2TH, andR3TH - Raw AT command sending
- Radar factory reset
When reading or applying common radar parameters, the tool automatically handles radar configuration mode. Before sending a single raw AT command manually, click Enter Config Mode if the radar is not already in configuration mode.
The door sensor supports debounce time configuration from 10 to 5000 ms. The default value is 100 ms. After a state change, the device waits for this duration before reporting the stable state.
- Do not disconnect Bluetooth
- Do not close or refresh the page
- Do not switch device type
- The device will reboot automatically after the upgrade completes
MIT License. See LICENSE for details.