[Custom Integration] Livolo Cloud Gateway Integration

Share your Projects! Custom Integrations
1

New Custom Integration: Livolo for Home Assistant

Hi everyone,

I’ve been searching for a Home Assistant integration for Livolo devices for quite some time, but I never found a solution that works out of the box with the Livolo gateways. So, I started looking into it myself, and I’m excited to finally share a solution I’ve developed!

What is this integration?

This is a custom component that allows you to control Livolo devices through Home Assistant. Currently, it supports controlling lights via the cloud, working similarly to the Android app with Livolo gateways.

Features

  • Light Control: Turn lights on/off

  • Cloud-based: Uses Livolo’s cloud service for communication

  • Easy Setup: Simple configuration through the Home Assistant UI

Installation

You can install this integration via HACS:

  1. Add this repository to HACS: https://github.com/emil-ha/livolo

  2. Install the “Livolo” integration

  3. Restart Home Assistant

  4. Add the integration through Settings > Devices & Services

First Release

This is the first iteration of the integration, so it’s still in early development. I’d love to get your feedback! Please try it out and let me know:

  • What works well for you?

  • Any issues you encounter?

  • What features would you like to see added (switches, sensors, etc.)?

Feel free to open issues on the GitHub repository for bug reports or feature requests.

Thanks for trying it out!

Livolo light switch with Zigbee EC
Livolo switches
2

That’s fantastic !!

I fought with zigbee and Livolo for a long lonnnnnng time. In the end I am now using two different concentrators with to instances of Z2M. That solved all the problems.

However, there is no support for Livolo curtain switches, so I will follow integration, hopefully you will be able to add that feature at some point :slight_smile:

3

I should be able to add that pretty easy if i would have a curtain switc. I need that in order to see what kind of data structure this kind of device has in cloud. But unfortunetly i don’t have one.

But together with your help we can add the feature pretty easy. I can extend the current integration to expose to you the api responses from the livolo and then you can send me that responses via pm (of course you can remove some ids and stuff from there to anonymize the data) so i can figure out what data structure and what triggers they have. This way i should be able to integrate what you need.

But question: Did you already try it? it does not even see the curtains? or it does but hey show like lights or they don’t trigger anything?

4

Great, that would be perfect :slightly_smiling_face:

I am away from home for a couple days. As soon as I am back home I will install your integration and let you know if curtains show up… and how.

Thanks !

5

Cool, in the meantime i added the debug events so you can see the raw responses from cloud both for get devices list and for mqtt events.

I documented how to use/trigger thrm in the git repo readme

6

Hi thank you so much for this integration. However I am not able to configure it because I can not get the app key and secret. Could you provide some help?

7

Just a quick update: I managed to get it working (at least for my switches).

I was able to retrieve the appKey and appSecret and complete the setup. The integration is now working and I can see and control my switches.

However, I still don’t see my dimmers. These control my lighting (ceiling spots and pendant lights), but they don’t appear in Home Assistant.

8

Right now the dimmers are not implemented. I only have 1, 2 , 3 gang switch devices with which i can test, but i would be glad to help you out to integrate. For this i would need your help. If you can send me your api response i can integrate the dimmers. In the readme of the github repo there is documented a step (Debug Events) how you can retrieve livolo api response, send that to me via pm so i can see what is the structure for dimmers

1 Like
9

Hi, first of all, thank you so much for the integration. Could you please help me find the app key and app secret? I’m completely stuck :pleading_face:

10

Hi, try the keys from this comment: Can't get past the login screen · Issue #1 · emil-ha/livolo · GitHub

11

Thanks, that worked, but unfortunately my roller shutters aren’t showing up :face_with_diagonal_mouth:

13

Hey, unfortunetly right now only the light switches are integrated because i don’t have other type of devices to test with. But i can help you out if you send me via private message the responses you get for the devices list and the mqtt messages. Follow the Debug Events section from the github repo. Don’t forget to anonymize your data before you send it to me

14

Sorry, but I just can’t seem to manage it. I’m still very inexperienced in this area. Could you perhaps describe it step by step with pictures? That would be very helpful :pleading_face::pray:t3:

15

Hey i have just deployed today a new version of the integration, added support for multiple device types, unfortunately I am not able to test them out with real devices. Maybe you can give it a try, please try with the new version and let me know if it works for you.

Thanks

16

Hey, thank you so much! The roller shutters are installed now, but the up and down buttons are reversed; those need to be changed, then it will be perfect :ok_hand:t3:

17

Hey @pockeras

The mapping of the operation buttons was initially implemented to match the Android app, so the issue is likely not with the app itself but possibly due to the motor being installed in reverse.

Depending on the type of curtain or roller shutter device you have, there should now be an option to invert the direction directly on the entity. If it’s not available on the entity, there’s also an option at the Livolo level where you can choose which devices should have inverted direction.

Please check the release notes for the latest version here:

18

Thank you so much :pray:t3: it works now with version v1.0.4!