fsaris / home-assistant-awox

AwoX mesh light integration for Home Assistant

Warning

Please consider to switch to a dedicated ESP32 module with https://github.com/fsaris/EspHome-AwoX-BLE-mesh-hub it's more stable then this HA integration

Until #110 can be resolved development of this integration is put on hold

AwoX MESH control component for Home Assistant

Control your AwoX, Eglo, ... bluetooth lights from Home Assistant

Work is based on the python-awox-mesh-light Python package created by @leiaz to control AwoX mesh lights bulbs.

Supported devices

• Bluethoot devices that use the ble.tlmesh protocol
  (when adding your devices check the logs and check for the type of your device, when it starts with .ble.tlmesh.light* it probably supported)

  Tested with following lights:
  (Tested with firmware v2.2.x but should work with all >= v1.2.4)

  • Eglo (120) RGBW spots (ESpot_120 HW v4.3)
  • LED strip 3m (HW v4.0 and v4.3)
  • LED strip 5m (HW v4.3)
  • ECeil_G60 (HW v4.0)
  • EPanel_120 (HW v4.0)
  • EPanel_600 (HW v4.0)
  • Eglo Fueva-C RGB CCT
  • Eglo Crossling RGBW Spot (ETriSpot 85 HW 4.31, firmware 2.2.6)
  • Eglo Crossling RGBW Spot (ESpot 170 HW 4.30, firmware 2.2.6)
  • Eglo Connect Plug Plus (on/off support over Bluetooth)

• .ble.zigbee.light.* are not supported. Recommended to use a ZigBee integration like https://www.zigbee2mqtt.io/supported-devices/#v=EGLO,Eglo,AwoX

• .wifi.light.* are currently not supported see #17

Current features

• Supports RGBW mesh lights and plugs (plug only on/off for now)
• Uses the AwoX app credentials to access the AwoX server to download light info during initial setup

Installation

Install pre-conditions

Your Home Assistant system needs to have access to a bluetooth device to access the lights.

Further it requires pybluez to be installed. On Debian based installs, run

sudo apt install bluetooth libbluetooth-dev

(already part of Home Assistant Operating System / HassOS)

Tip

Make sure that at least 1 device/light is in bluetooth range of your Home Assistant server.

Install with HACS (recommended)

Do you have HACS installed?

1. Add AwoX as custom repository.
   1. Go to: HACS -> Integrations -> Click menu in right top -> Custom repositories
   2. A modal opens
   3. Fill https://github.com/fsaris/home-assistant-awox in the input in the footer of the modal
   4. Select integration in category select box
   5. Click Add
2. Search integrations for AwoX
3. Click Install
4. Restart Home Assistant
5. See Setup for how to add your lights to HA

Install manually

1. Install this platform by creating a custom_components folder in the same folder as your configuration.yaml, if it doesn't already exist.
2. Create another folder awox in the custom_components folder. Copy all files from custom_components/awox into the awox folder.

Setup

1. In Home Assistant click on Configuration
2. Click on Integrations
3. Click on + Add integration
4. Search for and select AwoX MESH control
5. Enter you username and password you also use in the AwoX Smart Control app
6. The system will download you light list and add them to Home Assistant
7. Once the system could connect to one of the lights your lights will show up as available and can be controlled from HA
8. Enjoy

Todo

• Add option to refetch/update devices from AwoX Smart Control account
• Finish support adding lights without AwoX Smart Control account (full local support)
• Add support for plug power monitoring (currently do not own such a device, maybe you can sponser me one so I can try to add support for it)
• Add support for ble.zigbee devices (if possible)

Troubleshooting

Make sure that at least 1 device/light is in bluetooth range of your Home Assistant server.

If you run into issues during setup or controlling the lights please increase logging and provide them when creating an issue:

Add custom_components.awox: debug to the logger config in you configuration.yaml:

logger:
  default: error
  logs:
     custom_components.awox: debug