Livisi Unofficial Fork

This project is in "works for me" state and I do not advise anyone to use it nor can or will I provide support on how to install it. It can be added as a custom repo to HACS and then installed as an integration. This will override the existing livisi integration and add the following features:

• Support VariableActuators (Boolean vars in livisi) as switches
• Support light switches as lights (be sure to categorize them correctly in the livisi controller)
• Support motion detectors (brightness sensor and events)
• Devices with buttons are supported as basic event entities and device triggers
• Support Smoke Detectors
• Support temperature sensors for both the room climate devices and the individual thermostats
• Battery level indicators
• Dropped the dependencies on the aiolivisi lib, which seems to be abandoned. The neccessary connection code is simply included in this integration (which was opposed by the home assistant team for the official integration, but is the only logical way forward)
• Dropped the pydantic dependency

Note: As I don't have any shutter contol devices (nor do I have window shutters at all) or dimmers, I cannot add these devices to this lib. If you are willing to add support from them (in the same style as the other devices are implemented), feel free to submit a PR

Caution

This is not a drop-in replacement anymore. As entities in the original implementation were uniquely identified by the device id, only one entity per device was supported. This does not scale, so this integration migrates the old entities and changes the unique id to the capability id (which should be unique for every functionality of a device in the livisi controller). So once you install this integration via HACS, you cannot go back to the official implementation without recreating your Livisi devices.

Installation

Using HACS (preferred)

Add this repository in HACS as a custom repository and install it from there

This way you will get automatic updates

Manual

1. Using the tool of choice open the directory (folder) for your HA configuration (where you find configuration.yaml).
2. If you do not have a custom_components directory (folder) there, you need to create it.
3. In the custom_components directory (folder) create a new folder called livisi.
4. Download all the files from the custom_components/livisi/ directory (folder) in this repository.
5. Place the files you downloaded in the new directory (folder) you created.
6. Restart Home Assistant
7. In the HA UI go to "Configuration" -> "Integrations" click "+" and search for "livisi"

Configuration

All configuration in done in the UI. See the official documentation

Notes

• Luminance is provided in percent by Livisi. Currently we get a warning: <LivisiSensor> is using native unit of measurement '%' which is not a valid unit for the device class ('illuminance') it is using; expected one of ['lx'] but as percent is the correct unit here, I don't think we should change it (at least until it causes problems in HA)