Integración domótica Legrand Home + Control, gratuita y de código abierto
Céliane and dooxie with Netatmo: lights, dimmers, outlets, shutters and energy meters.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.1.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
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.
Parámetros de configuración
Estos son los parámetros que Legrand Home + Control te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Your Legrand Home + Control installation | section | No | 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 | Sí | The client ID of the app you created on dev.netatmo.com. |
| Client secret | secret | Sí | The client secret of the same app. Stored in Gladys, never shown again. |
| Netatmo account | oauth2 | No | 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 | No | 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. |
Cómo instalar Legrand Home + Control en Gladys
- En Gladys, abre Integraciones: Legrand Home + Control aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/lm1lc3n7/gladys-legrand-home-control:0.1.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-legrand-home-control.
Legrand Home + Control requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
Legrand Home + Control es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene LM1LC3N7, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación