Integración domótica inexogy (Discovergy), gratuita y de código abierto
Unofficial: inexogy (Discovergy) smart meters: power, electricity index, gas, water.
Publicado por LM1LC3N7
- Dispositivos
- Versión 0.1.1
- Requiere Gladys >=5.2.0
- ★ 0
La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.
Unofficial integration, not affiliated with inexogy. It reads the smart
meters of an inexogy customer account (formerly Discovergy, Germany)
through the official inexogy API (api.inexogy.com), with the e-mail and
the password of the inexogy web portal. Read-only: nothing is ever
commanded.
Never tested with a real device nor a real inexogy account: it was built from the pydiscovergy library (used by Home Assistant) and its test answers. Feedback welcome.
What you get
One Gladys device per meter of the account:
| Meter | Features |
|---|---|
| Electricity | power (W, as inexogy gives it: negative while injecting on a two-way meter), consumption index (kWh, fed to the Gladys energy monitoring), tariff 1 and 2 registers, injection index, power and voltage of each phase |
| Gas | gas index (m³), a plain sensor |
| Water | water index (m³), a plain sensor |
A feature exists only once inexogy gives its value (a counter: once above 0). Other kinds of meters (heat...) are listed in the status, not read.
- The consumption index is the meter's own total register (
energy): the Gladys core derives the consumption and its cost from it. It is never a sum of the tariffs and never holds the injection. - Gas and water stay out of the energy monitoring (Gladys would price them at the electricity tariff): plain volume sensors.
- The tariff registers and the injection are plain sensors (kWh in their name): as indexes they would be counted twice, or billed.
Setup
- In Gladys, open the integration and enter the e-mail and the
password of your inexogy customer account (the ones of
https://my.inexogy.com/). The password is kept by Gladys in its
database, never shown again, and only sent to inexogy
(
api.inexogy.com, HTTPS) with each request (HTTP Basic, the authentication of the official API). - Optionally choose the minutes between two reads (1 by default, 60 at most).
- Save, then open the Discover tab and create the devices you want.
How it behaves
- Pace: one read every interval (the last reading of each meter, and the
meter list once an hour), never more often: not after a restart of the
container (the time of the last read is kept in
/data), a reconnection, a save of the form, the Discover tab nor the test button. - Refused login (HTTP 401 or 403 on the meter list): the integration stops and says so; nothing more is sent with these credentials, even after a restart. Save the right ones, or click "Test the connection" for one more try (never sooner than the interval).
- inexogy asks to wait (HTTP 429, or 5xx on the meter list or on every
meter): every read pauses, from 1 minute to 6 hours (its
Retry-Afteris followed within those bounds), kept across restarts. A 5xx on one meter only leaves the others going. - Stale reading: when the last reading of an electricity meter is more than 15 minutes old on the clock of inexogy, its power and voltages are not sent (never an old value as a new one); the counters still are.
- At most 280 values a minute are sent to Gladys (its limit is 300).
The consumption index is protected
Gladys counts every rise of an index in full. A glitch (a register at 0, a wrong value) would become thousands of kWh. So:
- 0 is never sent;
- a value lower than the last one (a drop) is held, and never accepted: the index goes on by itself when the register comes back. A meter really replaced or reset: delete its device and create it again;
- a rise faster than 100 kW on average since the last value (a jump) is
held, never confirmed by time, repetition or a restart (kept in
/data); while held, the last accepted value is sent again and the status says so. If that energy was really consumed, click "Accept the held index" twice: the first click lists the jumps, the second (within 5 minutes) takes exactly those values. Saving the configuration never accepts anything.
After 24 hours without any reading, up to 2,400 kWh may pass at once (the margin grows with the time since the last value).
Privacy
/data/inexogy-state.json keeps the time of the last read, a pause, the
fingerprint (salted) of refused credentials only (erased at the first
success), and the reference of each consumption index. Never the password,
the e-mail, a serial number nor an address: the location inexogy keeps for a
meter is never read. The logs and the status hold our own words only. In
Gladys itself, the serial number of a meter names its device, and its full
serial number and make are parameters of the device (kept in the Gladys
database).
Limits
- Only the first 10 meters of an account are read.
- The scales of the values are the ones of Home Assistant (power in mW, energy in 1e-10 kWh, volume in 1e-3 m³); the water meters were never seen.
- No history import, no load disaggregation, no statistics.
- Not the P1 Monitor, YouLess or Tibber integrations.
Credits
The API calls and the meaning of the values are ported from
pydiscovergy (MIT, Jan-Philipp
Benecke); see THIRD_PARTY_NOTICES.md.
Parámetros de configuración
Estos son los parámetros que inexogy (Discovergy) te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| inexogy customer account | section | No | Unofficial connector, not affiliated with inexogy. It reads the smart meters of your inexogy account (formerly Discovergy, Germany) through the official inexogy API, with the e-mail and password of the inexogy web portal: the power and the electricity index every minute (the index is fed to the Gladys energy monitoring), and, when the meter gives them, the tariff registers, the injection, the power and voltage of each phase, and the gas and water meters. Gas and water are plain sensors in m³: they stay out of the energy monitoring. Read-only: nothing is ever commanded. Never tested with a real device. |
| inexogy e-mail | string | Sí | The e-mail of your inexogy customer account (the one of the web portal). |
| inexogy password | secret | Sí | Kept by Gladys in its database, never shown again, only sent to inexogy (api.inexogy.com, HTTPS) with each request. |
| Minutes between two reads | number | No | Each read asks inexogy for the last reading of every meter (and for the meter list once an hour). Never more often, whatever happens (a restart, the test button). |
Cómo instalar inexogy (Discovergy) en Gladys
- En Gladys, abre Integraciones: inexogy (Discovergy) 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-inexogy: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-inexogy.
inexogy (Discovergy) requiere Gladys >=5.2.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
inexogy (Discovergy) 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