iobroker.goodwe-sems 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stefan Bühler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,170 @@
+![Logo](admin/goodwe-sems.png)
+
+# ioBroker.goodwe-sems
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.goodwe-sems.svg)](https://www.npmjs.com/package/iobroker.goodwe-sems)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.goodwe-sems.svg)](https://www.npmjs.com/package/iobroker.goodwe-sems)
+![Test and Release](https://github.com/bueste/ioBroker.goodwe-sems/actions/workflows/test-and-release.yml/badge.svg)
+
+Liest Wechselrichter-, Batterie- und Energiefluss-Daten aus dem **GoodWe SEMS Portal (Cloud)** – für Anlagen, die (z. B. weil kein LAN-Zugriff auf den Wechselrichter besteht) **nicht** mit dem lokalen [ioBroker.goodwe](https://github.com/FossyTom/ioBroker.goodwe)-Adapter (Modbus/UDP, Port 8899) abgefragt werden können.
+
+Login erfolgt mit dem **ganz normalen SEMS-Portal-Konto** (dasselbe wie unter semsportal.com / in der SEMS-App). Ein GoodWe-"Organization"/OpenAPI-Konto wird **nicht** benötigt.
+
+## Inhaltsverzeichnis
+
+- [Warum dieser Adapter?](#warum-dieser-adapter)
+- [API-Herkunft und Grenzen (bitte lesen)](#api-herkunft-und-grenzen-bitte-lesen)
+- [Installation](#installation)
+- [Konfiguration](#konfiguration)
+- [Objekt-/State-Struktur](#objekt-state-struktur)
+- [Fehlerbehandlung, Backoff und Rate-Limits](#fehlerbehandlung-backoff-und-rate-limits)
+- [Pushover-Benachrichtigungen](#pushover-benachrichtigungen)
+- [Sicherheit & Datenschutz](#sicherheit--datenschutz)
+- [Entwicklung](#entwicklung)
+- [Changelog](#changelog)
+- [Lizenz](#lizenz)
+
+## Warum dieser Adapter?
+
+GoodWe ET/EH/BH/BT-Wechselrichter lassen sich normalerweise lokal per Modbus/UDP auslesen (siehe [ioBroker.goodwe](https://github.com/FossyTom/ioBroker.goodwe)). Steht kein LAN-Zugriff auf den Wechselrichter zur Verfügung (z. B. weil nur ein WLAN/LTE-Stick mit dem SEMS-Portal verbunden ist und das Zielnetz nicht erreichbar ist), bleibt nur der Umweg über die Cloud: das **SEMS Portal** (semsportal.com), über das die Anlage ohnehin schon überwacht wird.
+
+## API-Herkunft und Grenzen (bitte lesen)
+
+GoodWe bietet offiziell drei APIs an (siehe [GoodWe API Technical Document](https://community.goodwe.com/solution/API)):
+
+- **OpenAPI** – nur für SEMS-*Organization*-Konten, erfordert Freischaltung durch GoodWe.
+- **Real-time Data Monitoring API** – für Drittanbieter, erfordert Lizenzvertrag + Geräte-Whitelist.
+- **Batch Remote Control Interface** – Kafka-basiert, nur Fernsteuerung.
+
+Für ein **normales** SEMS-Portal-Konto (wie es die meisten Privatanwender haben) ist keine davon zugänglich. Dieser Adapter spricht stattdessen dieselbe **undokumentierte HTTPS-API**, die auch die offizielle SEMS-App/Webseite verwendet (Login via `CrossLogin`/`SEMS+ cross-login`, Datenabfrage via `GetMonitorDetailByPowerstationId`). Diese Endpunkte wurden nicht von GoodWe für Drittnutzung freigegeben oder dokumentiert; die Implementierung basiert auf eigener Analyse sowie den quelloffenen Referenzprojekten:
+
+- [pygoodwe](https://github.com/yaleman/pygoodwe) (MIT)
+- [goodwe-sems-home-assistant](https://github.com/TimSoethout/goodwe-sems-home-assistant)
+- [openHAB SEMSPortal-Binding](https://www.openhab.org/addons/bindings/semsportal/)
+
+**Konsequenzen:**
+
+- GoodWe kann die API jederzeit ohne Vorankündigung ändern - der Adapter kann dadurch (temporär) ausfallen.
+- Es gibt **kein dokumentiertes Echtzeit-/Push-Verfahren** (Websocket/SignalR) für Drittanbieter. Ein `msgSocketAdr`-Feld taucht in älteren Login-Antworten auf, wird aber von keinem der oben genannten Referenzprojekte tatsächlich genutzt - es wäre reines Reverse-Engineering ohne belastbare Dokumentation und ein deutlich höheres Risiko (Kontosperrung, instabile Verbindung). Dieser Adapter pollt daher bewusst per HTTPS in konfigurierbarem Intervall (Default 5 Minuten) statt eine ungetestete Websocket-Verbindung vorzutäuschen.
+- Es wurde ein **Rate-Limit-Code (`GY0429`)** beobachtet (u. a. in der Home-Assistant-Integration dokumentiert). Der Adapter erkennt diesen Code und pausiert automatisch (Default 5 Minuten Cool-down), statt das Konto durch wiederholte Anfragen zu gefährden.
+- Nutzung erfolgt auf eigenes Risiko, siehe [LICENSE](LICENSE) (MIT, ohne Gewährleistung).
+
+## Installation
+
+Solange der Adapter noch nicht im offiziellen ioBroker-Repository gelistet ist:
+
+```
+cd /opt/iobroker
+npm install https://github.com/bueste/ioBroker.goodwe-sems/tarball/main
+iobroker add goodwe-sems
+```
+
+## Konfiguration
+
+| Feld | Beschreibung |
+|---|---|
+| SEMS-Konto / Passwort | Dieselben Zugangsdaten wie auf semsportal.com. Passwort wird von ioBroker verschlüsselt gespeichert. |
+| Anlagen-ID (optional) | Leer lassen für automatische Erkennung (`GetPowerStationIdByOwner`). Bei mehreren Anlagen pro Konto: ID manuell aus der Portal-URL übernehmen (`.../powerstation/powerstatussnmin/<ID>`). |
+| Poll-Intervall | Default 300 s. Der Adapter erzwingt ein Minimum von 60 s, unabhängig von der Konfiguration. |
+| Pushover | Siehe [Pushover-Benachrichtigungen](#pushover-benachrichtigungen). |
+
+## Objekt-/State-Struktur
+
+```
+goodwe-sems.0.info.connection              SEMS Portal erreichbar (bool)
+goodwe-sems.0.info.lastSuccess             Zeitstempel letzter erfolgreicher Poll
+goodwe-sems.0.info.lastError               Letzte Fehlermeldung
+goodwe-sems.0.info.consecutiveErrors       Anzahl aufeinanderfolgender Fehlversuche
+goodwe-sems.0.info.rateLimited             SEMS Portal limitiert aktuell (bool)
+goodwe-sems.0.info.activePollInterval      Aktuell wirksames Intervall inkl. Backoff (s)
+goodwe-sems.0.info.rawResponse             Rohe JSON-Antwort (nur wenn Debug-Option aktiv)
+
+goodwe-sems.0.Station.Name / .Capacity / .Address / .Latitude / .Longitude / .PortalTimestamp / .Status / .StationId
+goodwe-sems.0.KPI.CurrentPower / .TodayGeneration / .MonthGeneration / .TotalGeneration / .TodayIncome / .TotalIncome / .Currency
+goodwe-sems.0.PowerFlow.PV / .Load / .Grid / .Battery / .LoadStatus / .GridStatus / .PvStatus / .BatteryStatus
+goodwe-sems.0.Battery.SOC / .Status
+goodwe-sems.0.EVCharger.*                  (nur wenn vom Portal gemeldet)
+
+goodwe-sems.0.Inverters.<Seriennummer>.Name / .Model / .Status / .WarningCode
+goodwe-sems.0.Inverters.<Seriennummer>.CurrentPower / .TodayGeneration / .TotalGeneration / .Temperature
+goodwe-sems.0.Inverters.<Seriennummer>.PV1..4.Voltage / .Current
+goodwe-sems.0.Inverters.<Seriennummer>.AC_L1..3.Voltage / .Current / .Frequency
+goodwe-sems.0.Inverters.<Seriennummer>.Battery.SOC / .Voltage / .Current
+```
+
+Bei zwei Wechselrichtern (wie in der ursprünglichen Anforderung) entstehen automatisch zwei `Inverters.<SN>.*`-Zweige - die Anzahl ist nicht fest codiert, sondern richtet sich nach dem, was das Portal für das jeweilige Konto zurückliefert.
+
+Felder, die das Portal liefert, aber dieser Adapter (noch) nicht kennt, gehen nicht verloren: Mit aktivierter Debug-Option landet die komplette Rohantwort in `info.rawResponse` (JSON), sodass sie inspiziert und bei Bedarf per PR ergänzt werden können.
+
+## Fehlerbehandlung, Backoff und Rate-Limits
+
+- Jeder Poll-Zyklus ist vollständig try/catch-abgesichert; ein einzelner Fehler kann die Polling-Schleife nicht dauerhaft stoppen.
+- Fehlerklassen (`SemsAuthError`, `SemsRateLimitError`, `SemsNetworkError`, `SemsProtocolError`) steuern das Verhalten gezielt:
+  - **Rate-Limit (`GY0429`)** → sofortige Pause (Default 300 s), `info.rateLimited = true`.
+  - **Login-Fehler** → exponentielles Backoff (bis 1 h Deckel), damit falsche Zugangsdaten das Konto nicht zusätzlich belasten.
+  - **Netzwerk-/Protokollfehler** → moderates Backoff.
+- Nach konfigurierbar vielen aufeinanderfolgenden Fehlversuchen (Default 3) gilt die Anlage als "offline" und es wird - falls aktiviert - eine Pushover-Meldung ausgelöst.
+- Alles wird zusätzlich strukturiert ins ioBroker-Log geschrieben (`error`/`warn`/`debug` je nach Schweregrad).
+
+## Pushover-Benachrichtigungen
+
+Konfigurierbar in drei Modi:
+
+1. **Über eine bestehende `ioBroker.pushover`-Instanz** (`sendTo`) - empfohlen, keine doppelte Zugangsdatenverwaltung.
+2. **Direkt über die Pushover-API** (eigener User-Key + API-/App-Token, verschlüsselt gespeichert) - funktioniert auch ohne separate Pushover-Instanz.
+3. **Beides gleichzeitig.**
+
+Ausgelöst wird bei: SEMS-Login-Fehler, SEMS-Rate-Limit, länger andauerndem Ausfall, unerwartetem Adapterfehler - jeweils einzeln aktivierbar. Eine interne Sperrfrist (Default 1 h pro Kategorie) verhindert Spam bei andauernden Störungen.
+
+## Sicherheit & Datenschutz
+
+- SEMS-Passwort und Pushover-API-Token sind in `io-package.json` als `encryptedNative`/`protectedNative` markiert und werden von ioBroker verschlüsselt abgelegt, nicht im Klartext geloggt (Kontoname wird in Log-Meldungen maskiert, z. B. `st***@gmail.com`).
+- Der Adapter führt **ausschließlich lesende** Zugriffe aus (`GetMonitorDetailByPowerstationId`, `GetPowerStationIdByOwner`). Es gibt bewusst **keine** Fernsteuerungs-/Schreibfunktion (`SaveRemoteControlInverter`) - das wäre ein deutlich größeres Sicherheits- und Haftungsrisiko und war nicht Teil der Anforderung.
+- Keine Drittanbieter-Abhängigkeiten für den HTTP-Zugriff: Es wird das in Node.js ≥18 eingebaute `fetch` verwendet statt einer zusätzlichen HTTP-Bibliothek - kleinere Angriffsfläche, weniger Supply-Chain-Risiko.
+- Alle Netzwerkfehler werden typisiert abgefangen; es werden keine ungeprüften Daten aus der API-Antwort ausgeführt (`eval`, `Function`, o. ä. werden nirgends verwendet).
+
+## Entwicklung
+
+```
+npm install
+npm run lint
+npm test          # Unit-Tests (lib/mapping.js, lib/semsApi.js, lib/notify.js) + Package-Konsistenz-Check
+```
+
+Empfehlung vor jedem Release zusätzlich lokal:
+
+```
+npx @iobroker/adapter-checker@latest .
+```
+
+Pull Requests willkommen, insbesondere um zusätzliche, vom Portal gelieferte Felder zu ergänzen (siehe `info.rawResponse` mit aktivierter Debug-Option) oder Übersetzungen zu verbessern.
+
+## Changelog
+
+### **WORK IN PROGRESS**
+
+- (bueste) initial release: SEMS-Portal-Login (SEMS+ mit Legacy-Fallback), automatische Anlagen-Erkennung, vollständiges Monitoring (Station/KPI/PowerFlow/Battery/EV-Charger/pro Wechselrichter), Rate-Limit-Handling, Backoff, Pushover-Alarmierung, Admin6-JSON-Config, i18n (11 Sprachen), Unit-Tests.
+
+## Lizenz
+
+MIT License
+
+Copyright (c) 2026 Stefan Bühler
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/admin/i18n/de/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Rohe JSON-Antwort speichern (Debug)",
+    "debugRawResponseHelp": "Schreibt die komplette letzte SEMS-API-Antwort nach info.rawResponse. Nützlich, um Felder zu finden, die dieser Adapter noch nicht abbildet. Standardmässig aus.",
+    "hintLoginText": "Melde dich mit deinem normalen SEMS-Portal-Konto an (dasselbe wie auf semsportal.com oder in der SEMS-App). Ein SEMS-\"Organization\"/OpenAPI-Konto wird nicht benötigt.",
+    "hintPollingText": "Das SEMS-Portal ist nicht für Drittzugriffe dokumentiert und limitiert Konten bei zu aggressivem Polling nachweislich. 5 Minuten sind ein sicherer Standardwert; der Adapter erzwingt ein Minimum von 60s und drosselt automatisch nach Fehlern oder einer Rate-Limit-Antwort.",
+    "hintPushoverText": "Kritische Ereignisse (Login-Fehler, SEMS-Rate-Limit, längere Ausfälle, unerwartete Adapterfehler) können zusätzlich zum ioBroker-Log per Pushover aufs Handy geschickt werden.",
+    "maxConsecutiveErrors": "Fehlversuche bis \"Anlage offline\"-Meldung",
+    "maxConsecutiveErrorsHelp": "Anzahl aufeinanderfolgender fehlgeschlagener Poll-Zyklen, bevor info.connection als echter Ausfall gilt und (falls aktiviert) eine Pushover-Meldung gesendet wird.",
+    "notifyHeader": "Meldung senden bei",
+    "notifyOnAdapterError": "Unerwartetem Adapterfehler",
+    "notifyOnLoginFailure": "SEMS-Login-Fehler",
+    "notifyOnRateLimit": "SEMS-Rate-Limit erreicht",
+    "notifyOnStationOffline": "Länger andauerndem Ausfall",
+    "pollInterval": "Abfrage-Intervall (Sekunden)",
+    "pollIntervalHelp": "Minimum 60s, empfohlen 300s (5 Min).",
+    "pollingTab": "Abfrage-Intervall",
+    "powerStationId": "Anlagen-ID (optional)",
+    "powerStationIdHelp": "Leer lassen für automatische Erkennung der Anlage dieses Kontos. Bei mehreren Anlagen pro Konto: ID explizit setzen (zu finden in der SEMS-Portal-URL nach dem Login, z. B. semsportal.com/powerstation/powerstatussnmin/<ID>).",
+    "priorityEmergency": "Notfall (wiederholt bis Bestätigung)",
+    "priorityHigh": "Hoch (ignoriert Ruhezeiten)",
+    "priorityLow": "Niedrig (kein Ton)",
+    "priorityNormal": "Normal",
+    "pushoverApiToken": "Pushover API-/App-Token",
+    "pushoverInstance": "Pushover-Adapterinstanz",
+    "pushoverInstanceHelp": "z. B. pushover.0",
+    "pushoverMode": "Pushover-Versand",
+    "pushoverModeBoth": "Beides",
+    "pushoverModeDirect": "Direkt über die Pushover-API",
+    "pushoverModeHelp": "Wie Pushover-Meldungen versendet werden.",
+    "pushoverModeInstance": "Über bestehende ioBroker.pushover-Instanz",
+    "pushoverModeNone": "Deaktiviert (nur Log)",
+    "pushoverPriority": "Pushover-Priorität",
+    "pushoverTab": "Pushover-Meldungen",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Anfrage-Timeout (Sekunden)",
+    "requestTimeoutHelp": "Pro HTTP-Anfrage an das SEMS-Portal.",
+    "semsAccount": "SEMS-Konto (E-Mail)",
+    "semsAccountHelp": "Die E-Mail-Adresse, mit der du dich auf semsportal.com anmeldest.",
+    "semsPassword": "SEMS-Passwort",
+    "semsPasswordHelp": "Wird von ioBroker verschlüsselt gespeichert.",
+    "stationOfflineMinutes": "Sperrfrist Ausfall-Meldung (Minuten)",
+    "stationOfflineMinutesHelp": "Nur informativ - wird im Text der Ausfall-Meldung angezeigt."
+}

package/admin/i18n/en/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Store raw JSON response (debug)",
+    "debugRawResponseHelp": "Writes the full last SEMS API response into info.rawResponse. Useful to discover fields this adapter does not map yet. Off by default.",
+    "hintLoginText": "Log in with your normal SEMS Portal account (the same you use at semsportal.com or in the SEMS app). No SEMS \"organization\"/OpenAPI account is required.",
+    "hintPollingText": "The SEMS Portal is not documented for third-party use and has been observed to rate-limit accounts that poll too aggressively. 5 minutes is a safe default; the adapter enforces a hard floor of 60s and automatically backs off after errors or a rate-limit response.",
+    "hintPushoverText": "Critical events (login failures, SEMS rate-limiting, prolonged outages, unexpected adapter errors) can be pushed to your phone via Pushover, in addition to always being written to the ioBroker log.",
+    "maxConsecutiveErrors": "Failures before \"station offline\" alert",
+    "maxConsecutiveErrorsHelp": "Number of consecutive failed poll cycles before info.connection is considered a real outage and (if enabled) a Pushover alert is sent.",
+    "notifyHeader": "Send alert on",
+    "notifyOnAdapterError": "Unexpected adapter error",
+    "notifyOnLoginFailure": "SEMS login failure",
+    "notifyOnRateLimit": "SEMS rate-limit hit",
+    "notifyOnStationOffline": "Prolonged outage",
+    "pollInterval": "Poll interval (seconds)",
+    "pollIntervalHelp": "Minimum 60s, recommended 300s (5 min).",
+    "pollingTab": "Polling",
+    "powerStationId": "Power station ID (optional)",
+    "powerStationIdHelp": "Leave empty to auto-detect the plant owned by this account. Multiple plants on one account: set the ID explicitly (found in the SEMS portal URL after login, e.g. semsportal.com/powerstation/powerstatussnmin/<ID>).",
+    "priorityEmergency": "Emergency (repeated until confirmed)",
+    "priorityHigh": "High (bypass quiet hours)",
+    "priorityLow": "Low (no sound)",
+    "priorityNormal": "Normal",
+    "pushoverApiToken": "Pushover API/application token",
+    "pushoverInstance": "Pushover adapter instance",
+    "pushoverInstanceHelp": "e.g. pushover.0",
+    "pushoverMode": "Pushover delivery",
+    "pushoverModeBoth": "Both",
+    "pushoverModeDirect": "Directly via Pushover API",
+    "pushoverModeHelp": "How Pushover notifications are sent.",
+    "pushoverModeInstance": "Via existing ioBroker.pushover instance",
+    "pushoverModeNone": "Disabled (log only)",
+    "pushoverPriority": "Pushover priority",
+    "pushoverTab": "Pushover alerts",
+    "pushoverUserKey": "Pushover user key",
+    "requestTimeout": "Request timeout (seconds)",
+    "requestTimeoutHelp": "Per HTTP request to the SEMS Portal.",
+    "semsAccount": "SEMS account (e-mail)",
+    "semsAccountHelp": "The e-mail address you use to log in at semsportal.com.",
+    "semsPassword": "SEMS password",
+    "semsPasswordHelp": "Stored encrypted by ioBroker.",
+    "stationOfflineMinutes": "Outage alert cool-down (minutes)",
+    "stationOfflineMinutesHelp": "Informational only - shown in the outage notification text."
+}

package/admin/i18n/es/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Guardar respuesta JSON en bruto (depuración)",
+    "debugRawResponseHelp": "Escribe la última respuesta completa de la API SEMS en info.rawResponse. Desactivado por defecto.",
+    "hintLoginText": "Inicia sesión con tu cuenta normal de SEMS Portal (la misma que usas en semsportal.com o en la app SEMS). No se requiere una cuenta SEMS \"organization\"/OpenAPI.",
+    "hintPollingText": "El portal SEMS no está documentado para uso de terceros y puede limitar cuentas con solicitudes demasiado frecuentes. 5 minutos es un valor predeterminado seguro; el adaptador impone un mínimo de 60s.",
+    "hintPushoverText": "Los eventos críticos pueden enviarse por Pushover, además de registrarse siempre en el log de ioBroker.",
+    "maxConsecutiveErrors": "Fallos antes de alerta \"planta offline\"",
+    "maxConsecutiveErrorsHelp": "Número de ciclos de consulta fallidos consecutivos antes de considerarlo una interrupción real.",
+    "notifyHeader": "Enviar alerta al",
+    "notifyOnAdapterError": "Error inesperado del adaptador",
+    "notifyOnLoginFailure": "Fallo de inicio de sesión SEMS",
+    "notifyOnRateLimit": "Límite de solicitudes SEMS alcanzado",
+    "notifyOnStationOffline": "Interrupción prolongada",
+    "pollInterval": "Intervalo de consulta (segundos)",
+    "pollIntervalHelp": "Mínimo 60s, recomendado 300s (5 min).",
+    "pollingTab": "Intervalo de consulta",
+    "powerStationId": "ID de la planta (opcional)",
+    "powerStationIdHelp": "Déjalo vacío para la detección automática. Con varias plantas, indica el ID manualmente (visible en la URL del portal SEMS tras iniciar sesión).",
+    "priorityEmergency": "Emergencia",
+    "priorityHigh": "Alta",
+    "priorityLow": "Baja (sin sonido)",
+    "priorityNormal": "Normal",
+    "pushoverApiToken": "Token de API/App Pushover",
+    "pushoverInstance": "Instancia del adaptador Pushover",
+    "pushoverInstanceHelp": "p. ej. pushover.0",
+    "pushoverMode": "Envío Pushover",
+    "pushoverModeBoth": "Ambos",
+    "pushoverModeDirect": "Directamente mediante la API de Pushover",
+    "pushoverModeHelp": "Cómo se envían las notificaciones Pushover.",
+    "pushoverModeInstance": "Mediante una instancia existente de ioBroker.pushover",
+    "pushoverModeNone": "Desactivado (solo log)",
+    "pushoverPriority": "Prioridad Pushover",
+    "pushoverTab": "Alertas Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Tiempo de espera de la solicitud (segundos)",
+    "requestTimeoutHelp": "Por solicitud HTTP al portal SEMS.",
+    "semsAccount": "Cuenta SEMS (correo)",
+    "semsAccountHelp": "La dirección de correo con la que inicias sesión en semsportal.com.",
+    "semsPassword": "Contraseña SEMS",
+    "semsPasswordHelp": "Se almacena cifrada.",
+    "stationOfflineMinutes": "Espera entre alertas de interrupción (minutos)",
+    "stationOfflineMinutesHelp": "Solo informativo."
+}

package/admin/i18n/fr/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Enregistrer la réponse JSON brute (debug)",
+    "debugRawResponseHelp": "Écrit la dernière réponse complète de l'API SEMS dans info.rawResponse. Désactivé par défaut.",
+    "hintLoginText": "Connectez-vous avec votre compte SEMS Portal habituel (le même que sur semsportal.com ou dans l'appli SEMS). Un compte SEMS \"organization\"/OpenAPI n'est pas requis.",
+    "hintPollingText": "Le portail SEMS n'est pas documenté pour un usage tiers et peut limiter les comptes trop sollicités. 5 minutes est une valeur par défaut sûre ; l'adaptateur impose un minimum de 60s.",
+    "hintPushoverText": "Les événements critiques peuvent être envoyés via Pushover, en plus du journal ioBroker.",
+    "maxConsecutiveErrors": "Échecs avant alerte \"centrale hors ligne\"",
+    "maxConsecutiveErrorsHelp": "Nombre de cycles d'interrogation consécutifs en échec avant de considérer une vraie panne.",
+    "notifyHeader": "Envoyer une alerte en cas de",
+    "notifyOnAdapterError": "Erreur inattendue de l'adaptateur",
+    "notifyOnLoginFailure": "Échec de connexion SEMS",
+    "notifyOnRateLimit": "Limite de requêtes SEMS atteinte",
+    "notifyOnStationOffline": "Panne prolongée",
+    "pollInterval": "Intervalle d'interrogation (secondes)",
+    "pollIntervalHelp": "Minimum 60s, recommandé 300s (5 min).",
+    "pollingTab": "Intervalle d'interrogation",
+    "powerStationId": "ID de la centrale (optionnel)",
+    "powerStationIdHelp": "Laisser vide pour la détection automatique. Plusieurs centrales : indiquer l'ID manuellement (visible dans l'URL du portail SEMS après connexion).",
+    "priorityEmergency": "Urgence",
+    "priorityHigh": "Haute",
+    "priorityLow": "Basse (sans son)",
+    "priorityNormal": "Normale",
+    "pushoverApiToken": "Jeton API/App Pushover",
+    "pushoverInstance": "Instance de l'adaptateur Pushover",
+    "pushoverInstanceHelp": "p. ex. pushover.0",
+    "pushoverMode": "Envoi Pushover",
+    "pushoverModeBoth": "Les deux",
+    "pushoverModeDirect": "Directement via l'API Pushover",
+    "pushoverModeHelp": "Comment les notifications Pushover sont envoyées.",
+    "pushoverModeInstance": "Via une instance ioBroker.pushover existante",
+    "pushoverModeNone": "Désactivé (journal uniquement)",
+    "pushoverPriority": "Priorité Pushover",
+    "pushoverTab": "Alertes Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Délai d'expiration (secondes)",
+    "requestTimeoutHelp": "Par requête HTTP vers le portail SEMS.",
+    "semsAccount": "Compte SEMS (e-mail)",
+    "semsAccountHelp": "Adresse e-mail utilisée pour se connecter sur semsportal.com.",
+    "semsPassword": "Mot de passe SEMS",
+    "semsPasswordHelp": "Stocké de façon chiffrée.",
+    "stationOfflineMinutes": "Délai entre alertes de panne (minutes)",
+    "stationOfflineMinutesHelp": "Information uniquement."
+}

package/admin/i18n/it/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Salva risposta JSON grezza (debug)",
+    "debugRawResponseHelp": "Scrive l'ultima risposta completa dell'API SEMS in info.rawResponse. Disattivato di default.",
+    "hintLoginText": "Accedi con il tuo normale account SEMS Portal (lo stesso usato su semsportal.com o nell'app SEMS). Non è richiesto un account SEMS \"organization\"/OpenAPI.",
+    "hintPollingText": "Il portale SEMS non è documentato per l'uso di terze parti e può limitare gli account con richieste troppo frequenti. 5 minuti è un valore predefinito sicuro; l'adattatore impone un minimo di 60s.",
+    "hintPushoverText": "Gli eventi critici possono essere inviati via Pushover, oltre a essere sempre scritti nel log di ioBroker.",
+    "maxConsecutiveErrors": "Errori prima dell'avviso \"impianto offline\"",
+    "maxConsecutiveErrorsHelp": "Numero di cicli di polling falliti consecutivi prima di considerare un vero guasto.",
+    "notifyHeader": "Invia avviso per",
+    "notifyOnAdapterError": "Errore imprevisto dell'adattatore",
+    "notifyOnLoginFailure": "Errore di login SEMS",
+    "notifyOnRateLimit": "Limite richieste SEMS raggiunto",
+    "notifyOnStationOffline": "Guasto prolungato",
+    "pollInterval": "Intervallo di polling (secondi)",
+    "pollIntervalHelp": "Minimo 60s, consigliato 300s (5 min).",
+    "pollingTab": "Intervallo di polling",
+    "powerStationId": "ID impianto (opzionale)",
+    "powerStationIdHelp": "Lascia vuoto per il rilevamento automatico. Con più impianti, imposta l'ID manualmente (visibile nell'URL del portale SEMS dopo il login).",
+    "priorityEmergency": "Emergenza",
+    "priorityHigh": "Alta",
+    "priorityLow": "Bassa (senza suono)",
+    "priorityNormal": "Normale",
+    "pushoverApiToken": "Token API/App Pushover",
+    "pushoverInstance": "Istanza dell'adattatore Pushover",
+    "pushoverInstanceHelp": "es. pushover.0",
+    "pushoverMode": "Invio Pushover",
+    "pushoverModeBoth": "Entrambi",
+    "pushoverModeDirect": "Direttamente tramite l'API Pushover",
+    "pushoverModeHelp": "Come vengono inviate le notifiche Pushover.",
+    "pushoverModeInstance": "Tramite un'istanza ioBroker.pushover esistente",
+    "pushoverModeNone": "Disattivato (solo log)",
+    "pushoverPriority": "Priorità Pushover",
+    "pushoverTab": "Avvisi Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Timeout richiesta (secondi)",
+    "requestTimeoutHelp": "Per ogni richiesta HTTP al portale SEMS.",
+    "semsAccount": "Account SEMS (e-mail)",
+    "semsAccountHelp": "L'indirizzo e-mail usato per accedere a semsportal.com.",
+    "semsPassword": "Password SEMS",
+    "semsPasswordHelp": "Memorizzata in modo crittografato.",
+    "stationOfflineMinutes": "Attesa tra avvisi di guasto (minuti)",
+    "stationOfflineMinutesHelp": "Solo informativo."
+}

package/admin/i18n/nl/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Ruwe JSON-respons opslaan (debug)",
+    "debugRawResponseHelp": "Schrijft het laatste volledige SEMS API-antwoord naar info.rawResponse. Standaard uit.",
+    "hintLoginText": "Log in met uw normale SEMS Portal-account (hetzelfde als op semsportal.com of in de SEMS-app). Een SEMS \"organization\"/OpenAPI-account is niet nodig.",
+    "hintPollingText": "Het SEMS-portaal is niet gedocumenteerd voor gebruik door derden en kan accounts met te frequente aanvragen limiteren. 5 minuten is een veilige standaardwaarde; de adapter hanteert een minimum van 60s.",
+    "hintPushoverText": "Kritieke gebeurtenissen kunnen via Pushover naar uw telefoon worden gestuurd, naast het ioBroker-log.",
+    "maxConsecutiveErrors": "Fouten tot \"installatie offline\"-melding",
+    "maxConsecutiveErrorsHelp": "Aantal opeenvolgende mislukte pollcycli voordat dit als echte storing geldt.",
+    "notifyHeader": "Melding versturen bij",
+    "notifyOnAdapterError": "Onverwachte adapterfout",
+    "notifyOnLoginFailure": "SEMS-inlogfout",
+    "notifyOnRateLimit": "SEMS-ratelimit bereikt",
+    "notifyOnStationOffline": "Langdurige storing",
+    "pollInterval": "Poll-interval (seconden)",
+    "pollIntervalHelp": "Minimaal 60s, aanbevolen 300s (5 min).",
+    "pollingTab": "Polling-interval",
+    "powerStationId": "Installatie-ID (optioneel)",
+    "powerStationIdHelp": "Leeg laten voor automatische detectie. Bij meerdere installaties: ID handmatig instellen (te vinden in de SEMS-portal-URL na het inloggen).",
+    "priorityEmergency": "Noodgeval",
+    "priorityHigh": "Hoog",
+    "priorityLow": "Laag (geen geluid)",
+    "priorityNormal": "Normaal",
+    "pushoverApiToken": "Pushover API-/App-token",
+    "pushoverInstance": "Pushover-adapterinstantie",
+    "pushoverInstanceHelp": "bijv. pushover.0",
+    "pushoverMode": "Pushover-verzending",
+    "pushoverModeBoth": "Beide",
+    "pushoverModeDirect": "Rechtstreeks via de Pushover-API",
+    "pushoverModeHelp": "Hoe Pushover-meldingen worden verzonden.",
+    "pushoverModeInstance": "Via bestaande ioBroker.pushover-instantie",
+    "pushoverModeNone": "Uitgeschakeld (alleen log)",
+    "pushoverPriority": "Pushover-prioriteit",
+    "pushoverTab": "Pushover-meldingen",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Time-out aanvraag (seconden)",
+    "requestTimeoutHelp": "Per HTTP-aanvraag aan het SEMS-portaal.",
+    "semsAccount": "SEMS-account (e-mail)",
+    "semsAccountHelp": "Het e-mailadres waarmee u inlogt op semsportal.com.",
+    "semsPassword": "SEMS-wachtwoord",
+    "semsPasswordHelp": "Wordt versleuteld opgeslagen.",
+    "stationOfflineMinutes": "Wachttijd storingsmelding (minuten)",
+    "stationOfflineMinutesHelp": "Alleen informatief."
+}

package/admin/i18n/pl/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Zapisz surową odpowiedź JSON (debug)",
+    "debugRawResponseHelp": "Zapisuje ostatnią pełną odpowiedź API SEMS w info.rawResponse. Domyślnie wyłączone.",
+    "hintLoginText": "Zaloguj się przy użyciu zwykłego konta SEMS Portal (tego samego co na semsportal.com lub w aplikacji SEMS). Konto SEMS \"organization\"/OpenAPI nie jest wymagane.",
+    "hintPollingText": "Portal SEMS nie jest udokumentowany do użytku zewnętrznego i może ograniczać konta zbyt często odpytywane. 5 minut to bezpieczna wartość domyślna; adapter wymusza minimum 60s.",
+    "hintPushoverText": "Krytyczne zdarzenia mogą być wysyłane przez Pushover, oprócz zawsze zapisywanych w logu ioBroker.",
+    "maxConsecutiveErrors": "Błędy przed alertem \"instalacja offline\"",
+    "maxConsecutiveErrorsHelp": "Liczba kolejnych nieudanych cykli odpytywania przed uznaniem tego za rzeczywistą awarię.",
+    "notifyHeader": "Wyślij alert przy",
+    "notifyOnAdapterError": "Nieoczekiwanym błędzie adaptera",
+    "notifyOnLoginFailure": "Błędzie logowania SEMS",
+    "notifyOnRateLimit": "Osiągnięciu limitu żądań SEMS",
+    "notifyOnStationOffline": "Długotrwałej awarii",
+    "pollInterval": "Interwał odpytywania (sekundy)",
+    "pollIntervalHelp": "Minimum 60s, zalecane 300s (5 min).",
+    "pollingTab": "Interwał odpytywania",
+    "powerStationId": "ID instalacji (opcjonalnie)",
+    "powerStationIdHelp": "Pozostaw puste dla automatycznego wykrywania. Przy kilku instalacjach ustaw ID ręcznie (widoczne w adresie URL portalu SEMS po zalogowaniu).",
+    "priorityEmergency": "Alarmowy",
+    "priorityHigh": "Wysoki",
+    "priorityLow": "Niski (bez dźwięku)",
+    "priorityNormal": "Normalny",
+    "pushoverApiToken": "Token API/App Pushover",
+    "pushoverInstance": "Instancja adaptera Pushover",
+    "pushoverInstanceHelp": "np. pushover.0",
+    "pushoverMode": "Wysyłka Pushover",
+    "pushoverModeBoth": "Oba",
+    "pushoverModeDirect": "Bezpośrednio przez API Pushover",
+    "pushoverModeHelp": "Sposób wysyłania powiadomień Pushover.",
+    "pushoverModeInstance": "Przez istniejącą instancję ioBroker.pushover",
+    "pushoverModeNone": "Wyłączone (tylko log)",
+    "pushoverPriority": "Priorytet Pushover",
+    "pushoverTab": "Powiadomienia Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Limit czasu żądania (sekundy)",
+    "requestTimeoutHelp": "Na jedno żądanie HTTP do portalu SEMS.",
+    "semsAccount": "Konto SEMS (e-mail)",
+    "semsAccountHelp": "Adres e-mail używany do logowania na semsportal.com.",
+    "semsPassword": "Hasło SEMS",
+    "semsPasswordHelp": "Przechowywane w postaci zaszyfrowanej.",
+    "stationOfflineMinutes": "Odstęp między alertami awarii (minuty)",
+    "stationOfflineMinutesHelp": "Tylko informacyjnie."
+}

package/admin/i18n/pt/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Guardar resposta JSON bruta (depuração)",
+    "debugRawResponseHelp": "Grava a última resposta completa da API SEMS em info.rawResponse. Desativado por padrão.",
+    "hintLoginText": "Inicie sessão com a sua conta normal do Portal SEMS (a mesma usada em semsportal.com ou na app SEMS). Não é necessária uma conta SEMS \"organization\"/OpenAPI.",
+    "hintPollingText": "O Portal SEMS não é documentado para uso por terceiros e pode limitar contas com consultas muito frequentes. 5 minutos é um valor padrão seguro; o adaptador aplica um mínimo de 60s.",
+    "hintPushoverText": "Eventos críticos podem ser enviados via Pushover, além de sempre serem gravados no log do ioBroker.",
+    "maxConsecutiveErrors": "Falhas até alerta de \"central offline\"",
+    "maxConsecutiveErrorsHelp": "Número de ciclos de consulta falhados consecutivos antes de considerar uma falha real.",
+    "notifyHeader": "Enviar alerta em",
+    "notifyOnAdapterError": "Erro inesperado do adaptador",
+    "notifyOnLoginFailure": "Falha de login SEMS",
+    "notifyOnRateLimit": "Limite de pedidos SEMS atingido",
+    "notifyOnStationOffline": "Falha prolongada",
+    "pollInterval": "Intervalo de consulta (segundos)",
+    "pollIntervalHelp": "Mínimo 60s, recomendado 300s (5 min).",
+    "pollingTab": "Intervalo de consulta",
+    "powerStationId": "ID da central (opcional)",
+    "powerStationIdHelp": "Deixe em branco para deteção automática. Com várias centrais, defina o ID manualmente (visível na URL do portal SEMS após o login).",
+    "priorityEmergency": "Emergência",
+    "priorityHigh": "Alta",
+    "priorityLow": "Baixa (sem som)",
+    "priorityNormal": "Normal",
+    "pushoverApiToken": "Token de API/App Pushover",
+    "pushoverInstance": "Instância do adaptador Pushover",
+    "pushoverInstanceHelp": "ex.: pushover.0",
+    "pushoverMode": "Envio Pushover",
+    "pushoverModeBoth": "Ambos",
+    "pushoverModeDirect": "Diretamente via API Pushover",
+    "pushoverModeHelp": "Como as notificações Pushover são enviadas.",
+    "pushoverModeInstance": "Via instância existente do ioBroker.pushover",
+    "pushoverModeNone": "Desativado (apenas log)",
+    "pushoverPriority": "Prioridade Pushover",
+    "pushoverTab": "Alertas Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Tempo limite do pedido (segundos)",
+    "requestTimeoutHelp": "Por pedido HTTP ao Portal SEMS.",
+    "semsAccount": "Conta SEMS (e-mail)",
+    "semsAccountHelp": "Endereço de e-mail usado para entrar em semsportal.com.",
+    "semsPassword": "Senha SEMS",
+    "semsPasswordHelp": "Armazenada de forma encriptada.",
+    "stationOfflineMinutes": "Intervalo entre alertas de falha (minutos)",
+    "stationOfflineMinutesHelp": "Apenas informativo."
+}

package/admin/i18n/ru/translations.json

@@ -0,0 +1,43 @@
+{
+    "debugRawResponse": "Сохранять сырой JSON-ответ (отладка)",
+    "debugRawResponseHelp": "Записывает последний полный ответ SEMS API в info.rawResponse. По умолчанию выключено.",
+    "hintLoginText": "Войдите с обычной учётной записью портала SEMS (той же, что на semsportal.com или в приложении SEMS). Учётная запись SEMS \"Organization\"/OpenAPI не требуется.",
+    "hintPollingText": "Портал SEMS не документирован для сторонних обращений и может ограничивать частые запросы. 5 минут - безопасное значение по умолчанию; адаптер применяет минимум 60с и автоматически снижает частоту при ошибках.",
+    "hintPushoverText": "Критические события можно отправлять через Pushover в дополнение к логу ioBroker.",
+    "maxConsecutiveErrors": "Ошибок до уведомления \"станция недоступна\"",
+    "maxConsecutiveErrorsHelp": "Количество последовательных неудачных опросов перед уведомлением об отключении.",
+    "notifyHeader": "Отправлять уведомление при",
+    "notifyOnAdapterError": "Непредвиденной ошибке адаптера",
+    "notifyOnLoginFailure": "Ошибка входа SEMS",
+    "notifyOnRateLimit": "Достигнут лимит запросов SEMS",
+    "notifyOnStationOffline": "Длительном отключении",
+    "pollInterval": "Интервал опроса (секунды)",
+    "pollIntervalHelp": "Минимум 60с, рекомендуется 300с (5 мин).",
+    "pollingTab": "Опрос",
+    "powerStationId": "ID электростанции (опционально)",
+    "powerStationIdHelp": "Оставьте пустым для автоматического определения. При нескольких станциях укажите ID вручную (из URL портала SEMS после входа).",
+    "priorityEmergency": "Экстренный",
+    "priorityHigh": "Высокий",
+    "priorityLow": "Низкий (без звука)",
+    "priorityNormal": "Обычный",
+    "pushoverApiToken": "Pushover API/App-токен",
+    "pushoverInstance": "Экземпляр адаптера Pushover",
+    "pushoverInstanceHelp": "например, pushover.0",
+    "pushoverMode": "Доставка Pushover",
+    "pushoverModeBoth": "Оба варианта",
+    "pushoverModeDirect": "Напрямую через API Pushover",
+    "pushoverModeHelp": "Способ отправки уведомлений Pushover.",
+    "pushoverModeInstance": "Через существующий экземпляр ioBroker.pushover",
+    "pushoverModeNone": "Отключено (только лог)",
+    "pushoverPriority": "Приоритет Pushover",
+    "pushoverTab": "Уведомления Pushover",
+    "pushoverUserKey": "Pushover User-Key",
+    "requestTimeout": "Тайм-аут запроса (секунды)",
+    "requestTimeoutHelp": "На один HTTP-запрос к порталу SEMS.",
+    "semsAccount": "Учётная запись SEMS (e-mail)",
+    "semsAccountHelp": "Адрес электронной почты для входа на semsportal.com.",
+    "semsPassword": "Пароль SEMS",
+    "semsPasswordHelp": "Хранится в зашифрованном виде.",
+    "stationOfflineMinutes": "Пауза уведомления об отключении (мин)",
+    "stationOfflineMinutesHelp": "Только информативно."
+}