AwoX Smart Plug over Bluetooth — Home Assistant integration

A local Bluetooth (BLE) integration for Home Assistant that replicates what the discontinued AwoX Smart Control mobile app did for AwoX / Revogi smart plugs — but driven entirely from Home Assistant, with no cloud and no phone app required.

The plug's BLE protocol was reverse-engineered from the official AwoX Smart Control Android app so that Home Assistant can talk to the hardware directly.

• A single Home Assistant device per plug, with:
  • a switch (outlet) whose state reflects the plug's real on/off status,
  • a Power sensor in watts (device_class: power, state_class: measurement),
  • device-measured energy sensors (today / last 24 h / yesterday) read straight from the plug, with Energy today ready for the Energy Dashboard, and
  • a Status light switch to turn the plug's LED indicator on/off.
• A guarded awox_plug.factory_reset action — it refuses to run unless you pass confirm: true, so it can't fire from an accidental tap (it erases the plug's stored energy history).
• 100% local — talks to the plug over BLE via Home Assistant's own Bluetooth stack. No internet, no AwoX account, no app.
• UI configuration — add it from Settings → Devices & Services; pick the plug from discovered devices or type its MAC.
• Adjustable polling — change how often the plug is polled from the integration's Options (no restart).
• Resilient connections — uses bleak-retry-connector (the same library Home Assistant uses internally) so it cooperates with the adapter instead of fighting other Bluetooth consumers.

Any AwoX / Revogi BLE smart plug that uses the Revogi GATT protocol (service fff0, write fff3, notify fff4). Verified with:

Other Revogi-based plugs with power metering are likely compatible.

Not supported: the newer AwoX Home Control app devices (different hardware/protocol).

• Home Assistant 2024.6 or newer.
• The Home Assistant Bluetooth integration configured with an adapter that can reach the plug (built-in, USB dongle, or an ESPHome Bluetooth proxy).

1. In HACS, open the ⋮ menu → Custom repositories.
2. Add https://github.com/diogolccsilva/ha-awox-ble with category Integration.
3. Search HACS for AwoX Smart Plug (Revogi) and Download it.
4. Restart Home Assistant.

Copy custom_components/awox_plug/ into your Home Assistant config/custom_components/ directory and restart Home Assistant.

1. Settings → Devices & Services → + Add Integration.
2. Search for AwoX Smart Plug (Revogi).
3. Select the plug from the discovered list, or type its Bluetooth MAC address (e.g. E0:E5:CF:11:C0:6D), and give it a name.
4. (Optional) Open the device → Configure to change the polling interval (default 30s).

Commands and responses are framed as:

[0x0f][len][cmd][0x00][data...][checksum][0xff][0xff]
   len      = len(data) + 3
   checksum = (cmd + 1 + sum(data)) & 0xFF

• On: cmd 0x03, data {1,0,0} → 0f 06 03 00 01 00 00 05 ff ff
• Off: cmd 0x03, data {0,0,0} → 0f 06 03 00 00 00 00 04 ff ff
• Poll: cmd 0x04, data {0,0} → 0f 05 04 00 00 00 05 ff ff

The poll response (cmd 0x04) returns the on/off state and the instant power as a big-endian value in milliwatts, so a single poll updates both the switch and the sensor.

python -m venv .venv
.venv/Scripts/activate      # Windows
pip install -r requirements_test.txt
ruff check .
pytest

The protocol layer (custom_components/awox_plug/protocol.py) is dependency-free and fully unit-tested in tests/.

There is no one-tap reset button on purpose. To reset the plug, call the awox_plug.factory_reset action and target the plug's switch entity, e.g.:

action: awox_plug.factory_reset
target:
  entity_id: switch.awox_smart_plug
data:
  confirm: true

If you want a clickable control, add a dashboard button with a confirmation popup that calls the action above.

• Firmware (OTA) updates — investigated, intentionally not planned. The app flashes firmware from binaries bundled inside the APK, streamed in 20-byte chunks over a dedicated characteristic. Reproducing this would mean shipping those firmware blobs and getting the flashing sequence exactly right; a bad flash can brick the plug, with little upside since the plug already works fully over BLE. Not planned.
• Schedules / timers — supported by the plug, intentionally not added. The plug can store on-device on/off schedules (up to ~5 rules with weekday masks and times) via commands 0x06 (write) / 0x07 (read). Home Assistant automations and schedule helpers do this far better and more flexibly, work even if the plug's clock drifts, and aren't limited to a handful of rules, so scheduling is deliberately left to HA rather than duplicated on the device.
• Set the device name on the plug — supported by the plug, intentionally not added. The plug can store a friendly name internally via command 0x02. Home Assistant already names the device/entities locally (and that name is what shows up in the UI, automations, and dashboards), so writing a separate name onto the hardware adds no value and would only be a source of confusion if the two ever disagreed. Renaming is deliberately kept in HA.

This is an unofficial, community integration. "AwoX" and "Revogi" are trademarks of their respective owners. Use at your own risk.

This integration was built with AI assistance (vibe coded), and reviewed, supervised, and tested on real hardware by the author.

MIT