Skip to main content

A python library to bridge between Avi-on based lights and Home Assistant using MQTT

Project description

avionmqtt

A python library to bridge between Avi-on based lights and Home Assistant using MQTT

support

This should support any devices that uses Avi-on's technology, including Halo Home and GE branded BLE lights (both discontinued, but both supported by Avi-on's cloud infra and mobile apps).

features

  • creates lights for devices and groups in Home Assistant
    • supports creating meta lights such as for 'all', usefull for automation of color temperature
  • supports changing brightness and color temperature
    • for:
      • individidual devices
      • groups
      • the entire mesh at once
    • color temperature can be set without turning on the light
  • polls the whole network on startup to get the current state of each device
  • updates Home Assistant whenever devices are updated externally

how to use

# if bluepy fails to compile, try installing libglib2.0-dev first (apt-get install libglib2.0-dev)
pip install avionmqtt
python -m avionmqtt -s settings.yaml

service install script

See Running as a service.md for how to install this as a service using systemd.

settings.yaml

avion:
    email: email@example.com
    password: ********

mqtt:
    host: mqtt_broker.local
    username: avion
    password: avion

devices:
    import: true
    # If set, include only these pids when importing devices
    include:
      - abcde...
      - bcdef...
    # If set, exclude these pids when importing devices
    exclude:
      - abcde...
      - bcdef...
    # If set, automatically adds all devices part of a group to the exclude list
    exclude_in_group: true

groups:
    import: true
    include:
    exclude:

# Controls if a single device, or one per light is created. Defaults to false.
single_device: true

# If you need to add additional overrides to dimmable or color_temp capabilities, then you can do so here.
# If new products are discovered to work with this library, create an issue on github so that it can be added in.
capabilities_overrides:
  dimming:
    - 123
    - 234
  color_temp:
    - 123

acknowledgements

This project would not have been possible without the original work done in https://github.com/nkaminski/csrmesh and https://github.com/nayaverdier/halohome

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

avionmqtt-1.3.8.tar.gz (10.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

avionmqtt-1.3.8-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

Details for the file avionmqtt-1.3.8.tar.gz.

File metadata

  • Download URL: avionmqtt-1.3.8.tar.gz
  • Upload date:
  • Size: 10.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for avionmqtt-1.3.8.tar.gz
Algorithm Hash digest
SHA256 836200a1fe891ad9cf01e8f8a4d8595e857e7bdaadc51f2c1ee861cc9094995d
MD5 b2e155d8fddeb96d3deee65569b206e0
BLAKE2b-256 fe35189b392eb1ee11f18d059862aa9b28d648247850e0cbd3eb734065c846e3

See more details on using hashes here.

Provenance

The following attestation bundles were made for avionmqtt-1.3.8.tar.gz:

Publisher: workflow.yml on oyvindkinsey/avionmqtt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file avionmqtt-1.3.8-py3-none-any.whl.

File metadata

  • Download URL: avionmqtt-1.3.8-py3-none-any.whl
  • Upload date:
  • Size: 9.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for avionmqtt-1.3.8-py3-none-any.whl
Algorithm Hash digest
SHA256 4e8264f195a9281d57fd3aafb030dfbf3ad98a5e759f06e89c82ba9a8d99944a
MD5 33eed1f8b62b2ef2bcc15bc2fbac94ca
BLAKE2b-256 4e36253a705b497edb7bdc76f33dcc009dabef1a4871ca970bcf51e49e73a98c

See more details on using hashes here.

Provenance

The following attestation bundles were made for avionmqtt-1.3.8-py3-none-any.whl:

Publisher: workflow.yml on oyvindkinsey/avionmqtt

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page