Skip to main content

Bluetooth Proxy

A Bluetooth proxy is ideal when your server is too far from BLE devices (sensors, locks, trackers) to pick them up directly. The Sensa Bluetooth Proxy runs on an M5Stack AtomS3 (C008 or C124) — a thumb-sized ESP32-S3 module — and forwards nearby BLE traffic into Home Assistant over Wi-Fi.

Install firmware on a new unit​

You can flash a brand-new unit directly from this page. No drivers, no command line.

Which model do I have?​

The Sensa Bluetooth Proxy runs on two M5Stack AtomS3 variants. Check your unit before flashing — the firmware is different for each.

M5Stack AtomS3 Lite (C008)

AtomS3 Lite — C008
Grey in colour.

M5Stack AtomS3 (C124)

AtomS3 — C124
White in colour.

You will need:

  • Your M5Stack Atom (C008 or C124)
  • A USB-C cable that supports data (not charge-only)
  • A desktop browser that supports Web Serial — Chrome or Edge on Windows, macOS, Linux, or ChromeOS. Safari and Firefox are not supported.

Steps:

  1. Plug the device into your computer with USB-C.
  2. Click the Install Firmware button for your model below.

Atom Lite (C008)

Loading installer…

AtomS3 (C124)

Loading installer…
  1. In the browser pop-up, pick the serial port for the device (usually shows up as USB JTAG/serial debug unit or USB Single Serial).
Can't see the device?

If the port picker is empty, try a different USB-C cable — many cables are charge-only and won't carry data. On Windows you may also need to hold the AtomS3's side button while plugging in to force boot mode.

  1. Choose Install when prompted, then wait — flashing takes about a minute.
  2. When it finishes, unplug and re-plug the device to boot the new firmware.

Join Wireless Network​

Steps:

  1. On your mobile or another wireless device, a new wireless SSID should appear named sen-setup-btp. Join this network, the password is sensasetup

  2. You will then be presented with a list of all the SSIDs available, select YOUR wireless network and enter YOUR wireless password.

Bluetooth Proxy web interface
  1. Power off the device and power on. The device should then join your network.

Running Web Interface​

The device has a basic web interface which is useful to ensure the device is running and check the logs.

Steps:

  1. Identify the ip address of the device from your wireless network. You should see a device ss-bt-proxy-c124-xxxxxx, where xxxxxx is th e last 6 characters of the MAC address of the unit. That is used to make them unique incase you have multiple proxies on the network.
  2. Connect to your ip address in your browser
  3. You will be prompted for a user and password, user: admin, password: sensaweb

Bluetooth Proxy web interface

Adding to Home Assistant (Sensa Nomad)​

If you are building a Bluetooth Proxy for your Sensa Nomad installation, follow these steps.

Steps:

  1. Click on Settings to show the Discovery page. Now that the Bluetooth proxy has been configured to your Wifi network, the discovery should find it. Discovery

  2. Select the device and click Add Selected Devices. Discovery

  3. The device should now show in the Added group of devices. Discovery

Adding to Home Assistant (DIY)​

If you are building a Bluetooth Proxy for your own Home Assistant installation, follow these steps.

Steps:

  1. Enter the Settings > Devices & Services
  2. Home Assistant should automatically discover the device as a ESP device, named Sensa Bluetooth Proxy 0ed520
  3. Just click Add.

Bluetooth Proxy web interface

Bluetooth devices can then be advertised by the device to Home Assistant.

Last updated on