Zum Hauptinhalt springen

Zinvolt Smart-Home-Integration, kostenlos und Open Source

Zinvolt-Integration für Gladys Assistant

Unofficial: Zinvolt batteries from your account: charge, powers, mode, read-only.

Auf GitHub ansehenAlle Integrationen
Info

Die Dokumentation dieser Integration wird von ihrem Autor geschrieben und ist bisher nur auf Englisch verfügbar.

Unofficial integration, not affiliated with Zinvolt. It reads the Zinvolt batteries of your account through the Zinvolt cloud service, with the e-mail and password you use in the Zinvolt app.

Never tested with a real device: it was built from the python-zinvolt library (the one of Home Assistant) and its test answers. Please report what you see on a real battery.

What you get​

One device per battery of the account (10 at most), with:

  • state of charge (%);
  • the socket power (W, signed): what the device exchanges with the home at its socket, solar included. It is not the power of the battery itself: with 500 W of solar, 300 W into the battery and 200 W to the home, it reads +200 W while the battery charges. Positive towards the home, negative from it; this sign follows Home Assistant (its Zinvolt sensor shows the opposite of the pso value of the API) and is still to be confirmed on a real battery. This version has no battery charge or discharge power: the API does not give it with a known sign;
  • solar power (W), and the power given to the home through the socket (W, the positive part of the socket power, same sign to confirm);
  • online, on grid and dormant states (1 = yes, 0 = no);
  • the smart mode (0 = default, 1 = self use, 2 = dynamic, 3 = charged, 4 = performance, 5 = feed, 6 = custom);
  • the settings: maximum output, charge upper and discharge lower limits, maximum charge power, standby time, and the system power limit.

Read-only: the integration never changes the mode, the output, the limits nor anything else of the battery.

No energy counter: the Zinvolt API gives powers only, no kWh. The integration adds nothing to the energy monitoring of Gladys and never makes up an energy from a power.

An offline battery (or one whose online state is unknown or contradictory) only gets its online state and its settings: its last live values are never sent again as new ones.

Configuration​

  1. In Gladys, open the integration, Configuration tab.
  2. Enter the e-mail and the password of your Zinvolt account. The password is kept by Gladys in its database, never shown again; it is sent only to the Zinvolt service, in its login request, never logged.
  3. Keep the reading interval at 60 s, or more. One read is one request for the list, one per battery, and a login when the session needs one.
  4. Save, then create the devices from the Discover tab.

Behaviour​

  • Never a read faster than the interval: not the test button, not Discovery, not a reconnection, not a save of an unchanged form, not a restart (the time of the last request is kept in /data).
  • Refused e-mail or password: the reads stop and stay stopped, even after a restart; there is no new automatic try (an account could get locked). Enter another password, or click Test the connection to try once: saving the same password again tries nothing.
  • Account accepted but access to the API refused (the service refuses the session it has just opened, for instance an account without access to the API): the same final stop, kept in /data, never a login in a loop. Check the account in the Zinvolt app, then click Test the connection, or enter other credentials.
  • An expired session gets one new login per read at most.
  • Too many requests or an error of the service: the reads pause from 1 minute to 6 hours (kept in /data). A battery that fails alone is only left out of that read.
  • /data never keeps the e-mail, the password nor the session: only a salted fingerprint of the account, and of refused credentials while they are refused.
  • Each answer must name the serial number of the battery it was asked for; an answer naming another one is left out. A battery listed without a readable identifier is left out too, and the status says so.

Troubleshooting​

  • The status of the integration says what happened and when the next read is.
  • The socket power looks inverted (negative while the home gets power from the device, with no solar)? Its sign has not been checked on a real battery yet: please report it. With solar, a positive socket power while the battery charges is normal (see above).

Konfigurationseinstellungen​

Diese Einstellungen fragt Zinvolt in seinem Konfigurationsbildschirm in Gladys ab.

EinstellungTypPflichtfeldBeschreibung
ZinvoltsectionNeinUnofficial connector, not affiliated with Zinvolt. It reads the batteries of your Zinvolt account through the Zinvolt cloud service, with the e-mail and password of the Zinvolt app, every 60 seconds: state of charge, power at the socket (signed, sign to confirm) and to the home, solar power, online and grid state, smart mode and settings. Read-only: it never changes the mode, the output or the charge limits. No energy counter: the API gives powers only. Never tested with a real device.
E-mail of the Zinvolt accountstringJaThe e-mail you sign in with in the Zinvolt app.
Password of the Zinvolt accountsecretJaKept by Gladys in its database, never shown again; sent only to the Zinvolt service, in its login request, never logged. If Zinvolt refuses it, the reads stop with no automatic try: enter another password (saving the same one again tries nothing), or click the test button to try once.
Reading interval (s)numberNeinHow often the account is read (one request plus one per battery): 60 s by default, more if you wish. Nothing reads it faster, not even the test button.

So installierst du Zinvolt in Gladys​

  1. Öffne in Gladys Integrationen: Zinvolt erscheint im Katalog neben den nativen Integrationen, mit einem Community-Badge.
  2. Klicke auf Installieren. Gladys lädt das Docker-Image (ghcr.io/lm1lc3n7/gladys-zinvolt:0.1.1) herunter, startet es in einer vom Kern isolierten Sandbox und erzeugt die Oberfläche der Integration (Geräte, Erkennung und Konfiguration).
  3. Öffne den Bildschirm Konfiguration der Integration, fülle die Einstellungen aus und speichere.
  4. Du kannst sie auch direkt über die URL ihres Repositorys installieren: https://github.com/LM1LC3N7/gladys-zinvolt.

Zinvolt benötigt Gladys >=5.2.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​

Zinvolt 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.

Abonniere den Newsletter von Gladys Assistant

Ein paar E-Mails im Monat zu neuen Releases und Neuigkeiten aus dem Projekt. Verschickt von Pierre-Gilles Leymarie, dem Gründer des Projekts. Jederzeit abbestellbar 🙂
Zuletzt aktualisiert am