fsaris / home-assistant-awox

AwoX mesh light integration for Home Assistant
MIT License
83 stars 23 forks source link
awox bluetooth eglo 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

hacs_badge stability-wip

AwoX Smart Control

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

Current features

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

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