Skip to main content

Library implementing Zigpy quirks for ZHA in Home Assistant

Project description

ZHA Device Handlers For Home Assistant

ZHA Device Handlers are quirks implementations for Zigpy, the library that provides the Zigbee support for the ZHA component in Home Assistant. These device handlers are similar to the device handlers that exist as part of the Smart Things platform and they expose additional functionality that isn't provided OOTB by the existing integration between these platforms. See Device Specifics for details.

These device handlers currently require the use of a custom branch of Home Assistant. This will be remediated soon.

Currently Supported Devices:

CentraLite

Xiaomi Aqara

Osram

SmartThings

Configuration:

  1. Update Home Assistant to use the ZHA component from this branch. Be sure to get the zha.py files from every component that ZHA supports.

NOTE: Some devices will need to be unpaired and repaired in order to see sensor values populate in Home Assistant.

Device Specifics:

Centralite

  • All supported devices report battery level
  • Dimmer Switch publishes events to Home Assistant
  • Dimmer Switch temperature sensor is removed because it is non functional

Osram

  • Dimmer Switch publishes events to Home Assistant and reports battery level
  • Dimmer Switch temperature sensor is removed because it is non functional

Xiaomi Aqara

  • All supported devices report battery level
  • All supported devices report temperature but I am unsure if it is correct or accurate
  • Vibration sensor exposes a binary sensor in Home Assistant that reports current vibration state
  • Vibration sensor sends tilt and drop events to Home Assistant
  • Cube sends the following events: flip (90 and 180 degrees), rotate_left, rotate_right, knock, drop, slide and shake
  • Motion sensor exposes binary sensors for motion and occupancy.
  • Button sends events to Home Assistant

SmartThings

  • tagV4 exposed as a device tracker in Home Assistant and reports battery. The current implementation will use batteries rapidly.

Thanks

  • Special thanks to damarco for the majority of the device tracker code
  • Special thanks to Yoda-x for the Xioami attribute parsing code
  • Special thanks to damarco and Adminiuga for allowing me to bounce ideas off of them and for listening to me ramble

Project details


Release history Release notifications | RSS feed

Download files

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

Source Distribution

zha-quirks-0.0.6.tar.gz (10.9 kB view hashes)

Uploaded Source

Built Distribution

zha_quirks-0.0.6-py3-none-any.whl (29.7 kB view hashes)

Uploaded Python 3

Supported by

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