/ha-triones

Home Assistant integration for BLE based Triones/HappyLighting lights

Primary LanguagePythonMIT LicenseMIT

ha-triones

hacs_badge Hassfest HACS

Home Assistant integration for BLE based Triones or HappyLighting lights.

Supports controlling BLE based lights controllable through the Triones or HappyLighting apps.

Installation

Note: Restart is always required after installation.

HACS (recommended)

Installation can be done through HACS custom repository.

Manual installation

You can manually clone this repository inside config/custom_components/triones.

For example, from Terminal plugin:

cd /config/custom_components
git clone https://github.com/sysofwan/ha-triones triones

Setup

After installation, you should find Triones under the Configuration -> Integrations -> Add integration.

The setup step includes discovery which will list out all Triones lights discovered. The setup will validate connection by toggling the selected light. Make sure your light is in-sight to validate this.

The setup needs to be repeated for each light.

Features

  1. Discovery: Automatically discover Triones based lights without manually hunting for Bluetooth MAC address
  2. On/Off/RGB/Brightness support
  3. Live state polling: External control (i.e. IR remote) state changes will reflect in Home Assistant
  4. Emulated RGB brightness: Supports adjusting brightness of RGB lights
  5. Multiple light support

Not supported

Light modes (blinking, fading, etc) is not yet supported.

Known issues

  1. Light connection may fail a few times after Home Assistant reboot. The integration will usually reconnect and the issue will resolve itself.
  2. After toggling lights, Home Assistant may not reflect state changes for up to 30 seconds. This is due to a lag in Triones status API.

Debugging

Add the following to configuration.yml to show debugging logs. Please make sure to include debug logs when filing an issue.

See logger intergration docs for more information to configure logging.

logger:
  default: warn
  logs:
    custom_components.triones: debug

Credits

This integration will not be possible without the awesome work of reverse engineering and documenting the Triones BLE protocol here.