Ksenia Lares 4.0 Integration for Home Assistant

This unofficial integration allows you to connect your HomeAssistant to the Ksenia Lares 4.0 control panel and add all your devices. I am NOT affiliated with Ksenia in any way, this integration was made for personal use only.

Compatible Devices

Device	Compatibility
Alarm System	✅
Lights	✅
Roller Blinds	✅
Window Shutters	✅
Garage Shutters	✅
Buttons	✅
Switches	✅
Scenarios	⚠️
Sensors	⚠️ (see below)
Partitions	⚠️

Legend

⛔ - Not Implemented; ⚠️ - Work In Progress; ✅ - Implemented

Compatible Sensors

• DOMUS (environmental)
• Power Lines
• Alarm System
• Zone-based:
  • Door
  • Window
  • Magnetic Contact (PMC)
  • Internal Movement

⚠️ Warning ⚠️

If any of the devices listed is not compatible, or if some devices listed as "compatible" are not working as intended, please open an issue. Collaboration is more than welcome, if somebody wants to implement new functions or contribute in any form to the integration, feel free to send a pull request.

Installation

1. HACS installation (best method)

Automatic Installation via HACS

Manual Installation via HACS

1. Make sure you have installed HACS to Home Assistant: HACS install guide.
2. Open HACS, click Custom repositories in the top-right menu, Repository input: https://github.com/emanuelegreco29/Ksenia_Lares_4.0-HASS_Addon, Category select Integration.

3. Restart Home Assistant.
4. You can now search for Ksenia Lares 4.0 in HACS and install through there.

2. Manual installation

To install, simply clone this repository or download it locally. Then, add the ksenia_lares folder to your custom_components folder and restart HomeAssistant. Proceed to add the integration as you would with any other integration.

Setup

When prompted, insert:

• The (local) IP address of your Ksenia Control Panel
• The user PIN to access the Ksenia Control Panel. I highly encourage you to use a user PIN, without admin permissions and (if you wish) without access to the home security system
• Check the "SSL" box if you want HomeAssistant to communicate using a secure connection. In case of network error, and only in that case, un-check the box
• Check all the devices that you want to add to HomeAssistant (by default, the integration will scan for all compatible devices)

Credits

Big thanks to @gvisconti1983 for the crc functions and to @realnot16 for the WebSocket library, which has been reworked and updated by me.