Saltar al contenido principal

Integración domótica SAX Power Home, gratuita y de código abierto

Integración SAX Power Home para Gladys Assistant

Unofficial: SAX Power Home batteries on your network over Modbus TCP, read-only.

Ver en GitHubTodas las integraciones
info

La documentación de esta integración la escribe su autor y, por ahora, solo está disponible en inglés.

Unofficial connector, not affiliated with SAX Power. It reads your SAX Power Home or Home Plus batteries on your local network through their Modbus TCP interface (port 502): a single battery, or a group of up to three (the master A and the others). Read-only: it never changes a setting and never steers the battery. No cloud.

Never tested with a real device. Feedback welcome.

What you get​

For each battery (the registers sax_battery_ha reads, Modbus units 64 and 40):

  • state of charge (%), battery power (W, signed as the battery gives it: SAX does not document which sign is charging), status code;
  • temperature, number of cycles, capacity (kWh);
  • two energy counters, "energy produced" and "energy consumed" (kWh), shown only: they do not go to the Gladys energy monitoring (SAX does not document their meaning nor their unit).

For battery A (the master), also the values of the whole system from the SunSpec interface SAX documents (firmware Master V61 / Gateway V54 or later):

  • state of charge of the system, storage power (W, signed), highest cell temperature, state (1 off, 2 standby, 3 waiting, 4 on, 7 meter fault), events;
  • charge and discharge power available, capacity of the system;
  • with the ADW200 meter only: solar power and grid power (W, signed as the meter gives it). Without an ADW200 (grid voltage read under 100 V), these two are not published.

SAX advises reading only the master of a group: it already gives the values of the system. Add B and C only to see each battery's own values.

Setup​

  1. Have the Modbus TCP interface of your batteries enabled if it is not (the SAX Power customer service does it; a firmware update may be needed for the SunSpec interface).
  2. Give each battery a fixed address in your router (it takes its address by DHCP; the address is shown on its display).
  3. In Gladys, install the integration, enter the address of battery A, then those of B and C if any, and save.
  4. "Discover" tab: create the device of each battery. Its values come with the next read.

Reading​

  • Each battery is read every 30 s by default (15 to 300 s), over its own connection, one request at a time and at least 500 ms between two requests, as SAX asks. The batteries are read side by side: one that does not answer never delays the others.
  • Never faster than the interval: not the test button, not Discovery, not a reconnection to Gladys, not a restart of the container (the first read then waits the interval and one minute after the last read). Only a new address saved is read at once.
  • While its display refreshes, the battery does not answer for 1 to 3 s: the part not read is missing this time, the status says so ("not read this time"), the rest is published. A part that fails three reads in a row is skipped for ten reads (never the serial number of a battery already known by its serial number).
  • A battery unreachable: tried again after 1 min at least, then a delay doubled up to 15 min.

Identity of each battery​

  • Every read reads the serial number of the SunSpec interface (with its fixed words "SunS", model 1 of length 15 and "SAXPOWER"); when the read has to open a new connection, it reads it again first, and another battery at that address gives nothing there. The values only go to the device of that number.
  • A battery without the SunSpec interface (an older firmware, or a battery of a group that leaves it to the master) is named after its address (ip192-168-1-51-502) after three reads where its unit 64 answered and its serial number did not. If a serial number shows up later, it wins: a new device appears in Discovery, the old one keeps its history.
  • A battery whose serial number is known and does not give it this time: nothing is published for it (never to the device of its address).
  • Another serial number at the same address: another battery, its own device appears in Discovery; the old one gets no value any more.

Energy counters​

The two counters "energy produced" and "energy consumed" of each battery are published as read, as plain sensors (kWh), never counted by the energy monitoring. SAX documents neither their direction, nor their unit, nor their nature: they are 16-bit registers that may start over from zero (near 65.5 kWh if they are in Wh) or be periodic (reset now and then). To be confirmed on a real battery. A value of 0 is taken as unknown and never published.

What is not done​

  • No steering: no charge or discharge limit, no power set-point (the "pilot mode" of sax_battery_ha is not ported).
  • No index for the Gladys energy monitoring.

Troubleshooting​

  • "unreachable": check the address and the port (502), and that the battery is on the same network.
  • "connected, but no register answered": the Modbus interface is probably not enabled; ask the SAX Power customer service.
  • "serial number (SunSpec)" never read on the master: the firmware is probably older than Master V61 / Gateway V54; the system values are then missing.
  • /data unreadable: the file is left as it is, no battery is named after its address (a battery identified by its serial number is still read); restart the integration.

Parámetros de configuración​

Estos son los parámetros que SAX Power Home te pide en su pantalla de configuración en Gladys.

ParámetroTipoObligatorioDescripción
SAX Power Home batteriessectionNoUnofficial connector, not affiliated with SAX Power. It reads your SAX Power Home or Home Plus batteries (one, or a group of up to three: the master and the others) on your network through their Modbus TCP interface (port 502), every 30 s by default: state of charge, power, temperature, cycles, capacity and two energy counters of each battery, and the values of the whole system from the master (SunSpec interface, firmware Master V61 / Gateway V54 or later). No cloud. Read-only: it never changes a setting nor steers the battery (the "pilot mode" of other tools is not offered). Never tested with a real device.
Battery A (master)stringSíThe IP address of the master battery (A), shown on its display, with a port only if it is not 502. Give it a fixed address in your router (the battery takes its address by DHCP). The values of the whole system are read from this one.
Battery B (optional)stringNoThe IP address of a second battery of the group, for its own values. Leave empty with a single battery.
Battery C (optional)stringNoThe IP address of a third battery of the group, for its own values. Leave empty otherwise.
Reading interval (seconds)numberNoHow often each battery is read, from 15 to 300 seconds. Never faster, except right after you save a new address.

Cómo instalar SAX Power Home en Gladys​

  1. En Gladys, abre Integraciones: SAX Power Home aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
  2. Haz clic en Instalar. Gladys descarga la imagen Docker (ghcr.io/lm1lc3n7/gladys-sax-power: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).
  3. Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
  4. También puedes instalarla directamente desde la URL de su repositorio: https://github.com/LM1LC3N7/gladys-sax-power.

SAX Power Home 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​

SAX Power Home 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.

Suscríbete a la newsletter de Gladys Assistant

Unos pocos correos al mes sobre nuevas versiones y novedades del proyecto. Enviados por Pierre-Gilles Leymarie, fundador del proyecto. Puedes darte de baja cuando quieras 🙂
Última actualización en