Legrand Home + Control Smart-Home-Integration, kostenlos und Open Source
Céliane and dooxie with Netatmo: lights, dimmers, outlets, shutters and energy meters.
Veröffentlicht von LM1LC3N7
- Geräte
- Version 0.1.1
- Erfordert Gladys >=5.1.0
- ★ 0
Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.
Control the Céliane with Netatmo and dooxie with Netatmo modules of your Legrand Home + Control gateway from Gladys: lights and dimmers, power outlets, contactors, roller shutters and energy meters. The integration talks to the Netatmo cloud (the service behind the Home + Control app) with the official Netatmo Connect API, on your behalf. Unofficial integration, not affiliated with Legrand or Netatmo.
Development version (0.1). Developed against the Netatmo documentation and recorded answers, not yet tested on a real installation. Your feedback is welcome on the GitHub repository.
What you get
| Module | In Gladys |
|---|---|
| Power outlet, mobile socket, cable outlet (NLP, NLPM, NLC) | a switch: on/off and power (W) |
| Teleruptor, contactor, dry contact (NLPT, NLPO, NLPD) | a switch (a light when it drives a light) |
| Light switch, micromodule, double switch (NLL, NLM, NLIS) | a light: on/off and power (one per gang) |
| Dimmer (NLF, NLFN, NLFE) | a light: on/off, brightness and power |
| Roller shutter switch (NLV, NLLV), Zigbee covering (Z3V) | a shutter: open, close, stop (and position) |
| DIN energy meter, load shedder, three-phase meter (NLPC, NLPS, NLY) | power drawn (per phase for NLY) |
| Remote control (NLT, NLD) | battery level |
The position of a shutter is offered for the modules that accept any position (NLLV); the others open, close and stop. Each device shows on its badge whether the module answers.
Not yet: cable outlets in pilot-wire mode (radiators: their power only), ventilation (NLLF), garage door (NLJ), the ecometer lines (NLE), the button presses of the remotes, energy history. They are planned.
Installation
You need a Netatmo app of your own (free, five minutes): it gives the integration the right to use the API with your account.
- Go to dev.netatmo.com and sign in with the account of the Home + Control app.
- Create an app: any name and description (e.g. "Gladys"), your name and email as data protection contact.
- In the Gladys configuration of the integration, copy the redirect URI Gladys shows for the Connect button, and paste it in the Redirect URI field of the Netatmo app. Save the app.
- Copy the client ID and the client secret of the app into the Gladys configuration, and save.
- Click Connect: Netatmo asks you to sign in and to accept the Home +
Control rights (
read_magellan,write_magellan). You come back to Gladys, connected. - Open the Discovery tab: your modules are there, add the ones you want.
Test the connection shows how many homes and devices were found.
Options
| Option | Default | Purpose |
|---|---|---|
| Refresh interval | 60 s | how often the states are read (one minute minimum, max 1 hour) |
A command is sent at once and the state is read again a few seconds later. Netatmo limits the requests (500 per hour per user): the integration spaces them, sends the commands of a same moment together and pauses when Netatmo asks it to. With several homes or many commands, a longer interval is safer.
Troubleshooting
- "Netatmo refused the authorization": the authorization expired or was revoked (from the Netatmo account), or the client secret is wrong. Check the client ID and the client secret, save, then click Connect again.
- The Connect page shows an error: the redirect URI of the Netatmo app is not exactly the one Gladys shows (copy it again, without a space).
- "Read only": the Home + Control rights were not all accepted: click Connect again and accept them.
- "usage limit reached": Netatmo asked to slow down; the integration retries by itself. Increase the refresh interval if it comes back.
- A module is missing: the logs list the modules the integration cannot show yet; Test the connection counts them.
- A device shows "unreachable": the module or the gateway does not answer Netatmo (power cut, Wi-Fi of the gateway).
Privacy
The integration only talks to api.netatmo.com, with your own Netatmo app.
The client secret and the tokens are stored by Gladys and never appear in the
logs. Nothing goes through Gladys Plus.
Konfigurationseinstellungen
Diese Einstellungen fragt Legrand Home + Control in seinem Konfigurationsbildschirm in Gladys ab.
| Einstellung | Typ | Pflichtfeld | Beschreibung |
|---|---|---|---|
| Your Legrand Home + Control installation | section | Nein | Control the Céliane with Netatmo and dooxie with Netatmo modules of your Home + Control gateway through the Netatmo cloud: lights and dimmers, outlets, contactors, roller shutters and energy meters. 1. Sign in on dev.netatmo.com with your Home + Control account and create an app. 2. In its Redirect URI field, paste the redirect URI Gladys shows for the Connect button below. 3. Copy the client ID and the client secret of the app here and save. 4. Click Connect and accept the Home + Control rights. Unofficial integration, not affiliated with Legrand or Netatmo. |
| Client ID | string | Ja | The client ID of the app you created on dev.netatmo.com. |
| Client secret | secret | Ja | The client secret of the same app. Stored in Gladys, never shown again. |
| Netatmo account | oauth2 | Nein | Save the client ID and the client secret first, then connect: Netatmo asks you to sign in and to accept the Home + Control rights (read_magellan, write_magellan). |
| Refresh interval (s) | number | Nein | How often the states are read from Netatmo, in seconds (one minute minimum, within the Netatmo usage limits). A command is confirmed a few seconds after it is sent. |
So installierst du Legrand Home + Control in Gladys
- Öffne in Gladys Integrationen: Legrand Home + Control erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
- Klicke auf Installieren. Gladys lädt das Docker-Image (
ghcr.io/lm1lc3n7/gladys-legrand-home-control:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration). - Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
- Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-legrand-home-control.
Legrand Home + Control benötigt Gladys >=5.1.0. Der Katalog in Gladys wird stündlich aktualisiert, eine neue Version ist also spätestens eine Stunde nach ihrer Veröffentlichung verfügbar.
Du nutzt Gladys noch nicht? Es ist kostenlos und Open Source: folge der Installationsanleitung, um loszulegen.
Über externe Integrationen
Legrand Home + Control ist eine externe Integration: eine Community-Integration, die als Docker-Container verpackt und auf GitHub veröffentlicht wird. Gladys installiert sie mit einem Klick und führt sie in einer vom Kern isolierten Sandbox aus. Sie wird von LM1LC3N7 veröffentlicht und gepflegt, nicht vom Gladys-Kernteam.
- Alle Integrationen durchsuchen, native und aus der Community
- Deine eigene externe Integration bauen und veröffentlichen
- Quellcode auf GitHub — Quelle dieser Dokumentation