iobroker.zeptrion 0.8.2

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,302 @@
+# ioBroker.zeptrion
+
+![Logo](admin/zeptrion.png)
+
+[![NPM version](https://img.shields.io/npm/v/iobroker.zeptrion.svg)](https://www.npmjs.com/package/iobroker.zeptrion)
+[![Downloads](https://img.shields.io/npm/dm/iobroker.zeptrion.svg)](https://www.npmjs.com/package/iobroker.zeptrion)
+[![Tests](https://github.com/bueste/ioBroker.zeptrion/workflows/Test%20and%20Release/badge.svg)](https://github.com/bueste/ioBroker.zeptrion/actions)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Adapter für Feller **zeptrion / zApp** WLAN-Aktoren (WLAN-Nebenstelle 4K = zApp-Gateway,
+WLAN-Zwischenmodul 2K = zApp-Booster) für Licht- und Storensteuerung, basierend auf der
+zrap Webservice API (Feller-Dokument 10.ZEPAPI-E.1612 / Version 1.0, Firmware ab 01.08.18).
+
+> Vor der Store-Veröffentlichung muss noch die Autor-E-Mail-Adresse
+> in `package.json` eingetragen werden (Platzhalter CHANGE_ME@example.com).
+
+## Funktionsumfang
+
+- **Kanalsteuerung** (`zrap/chctrl`): on/off/stop/toggle, open/close, move_open/move_close,
+  dim_up/dim_down inkl. zeitgesteuerter Varianten (`_t` in ms), sowie Szenen
+  recall_s1-4 / store_s1-4 / delete_s1-4 - als einzelne Buttons UND als freies
+  `command`-Textfeld.
+- **Kanalzustand** (`zrap/chscan` als periodischer Resync + `zrap/chnotify` als
+  Long-Poll-Push für nahezu Echtzeit-Updates) und **Kanalbeschreibung** (`zrap/chdes`,
+  read/write: Name, Gruppe, Icon, Typ, Kategorie).
+- **Geräteinformationen** (`zrap/id`): Hardware-/Software-/Bootloader-Version, Seriennummer,
+  Systemname, Gerätetyp.
+- **Signalstärke** (`zrap/rssi`, gepollt).
+- **Netzwerkstatus** (`zrap/net`, read-only): SSID, IP, MAC, Modus, Verschlüsselung,
+  Maske, Gateway.
+- **Systembefehle** (`zrap/sys`): Neustart, Werksreset, Zurücksetzen in Access-Point-Modus.
+- **Standort** (`zrap/loc`), **NTP-Konfiguration** (`zrap/ntp`) und **Datum/Zeit**
+  (`zrap/date`) inkl. Ein-Klick-Synchronisation der Geräte-Uhrzeit mit dem ioBroker-Host.
+- **mDNS-Discovery** (Kapitel 4 der API-Doku): durchsucht das lokale Netz nach
+  zeptrion-Geräten und übernimmt Funde deaktiviert in die Konfigurationstabelle
+  (Discovery kombiniert mit manueller Kontrolle/Aktivierung).
+- **Sammelbefehle für Hagelalarm**: `control.closeAllShutters` / `openAllShutters` /
+  `stopAllShutters` steuern alle konfigurierten Kanäle über alle aktiven Geräte gleichzeitig
+  - dank Multicast-Bündelung (siehe unten) als je EIN Request pro Gerät, nicht pro Kanal.
+- **Multicast-Befehlsbündelung**: Kanalbefehle desselben Geräts, die innerhalb von 50ms
+  eintreffen, werden automatisch zu einem einzigen `zrap/chctrl`-Multicast-POST gebündelt
+  (Kapitel 3.6.5 der API-Doku) statt mehrerer sequentieller Einzelrequests.
+- **Storen-Positionsschätzung** (optional, `posEstimate`): da die Hardware laut Doku für
+  Storenkanäle praktisch immer `-1` (unbekannt) liefert, kann pro Gerät eine
+  Motor-Laufzeit hinterlegt werden; der Adapter schätzt daraus die Position anhand
+  Bewegungsrichtung und verstrichener Zeit (Best Effort, kein Hardware-Feedback,
+  manuell kalibrierbar).
+- **Smartfront-Unterstützung** (optional, `zapi/smartfront/*`): Temperatur/Helligkeit/
+  Luftfeuchtigkeit auslesen, LED-Hintergrundfarbe setzen (nur für Geräte mit
+  angeschlossenem Feller-Smartfront-Taster, Checkbox in der Konfiguration).
+- Robustes Error-Handling: unterscheidet ECONNREFUSED/Timeout/DNS-Fehler, Backoff bei
+  wiederholten Fehlern, pro Gerät und global sichtbarer Verbindungsstatus. mDNS-Discovery
+  ist zusätzlich gegen Exceptions durch fremde/kaputte Netzwerkpakete abgesichert.
+
+Nicht implementiert (siehe "Bekannte Einschränkungen"): Schreibzugriff auf `zrap/net`
+(WLAN-Zugangsdaten ändern), `zrap/scheduler`, Smartbutton-Webhook-Programmierung
+(`zapi/smartbt/*`).
+
+## Installation
+
+### a) Lokal/manuell (vor Store-Veröffentlichung)
+
+```bash
+cd /opt/iobroker/node_modules
+mkdir iobroker.zeptrion
+# Dateien dieses Pakets hierhin kopieren
+cd iobroker.zeptrion
+npm install --production
+
+cd /opt/iobroker
+iobroker upload zeptrion
+iobroker add zeptrion
+```
+
+### b) Über den ioBroker Adapter-Store (nach erfolgter Veröffentlichung)
+
+Admin-Oberfläche -> Adapter -> "zeptrion" suchen -> Installieren.
+
+## Konfiguration
+
+- **HTTP Timeout**: Timeout pro Request an ein Gerät (Default 4000 ms).
+- **Discovery-Button**: durchsucht das lokale Netz per mDNS (Service-Type `_zapp._tcp`,
+  Fallback `_http._tcp` für Firmware < 01.08.xx anhand des Hostname-Musters
+  `zapp-YYWWNNNN`). Neu gefundene Geräte werden **deaktiviert** in die Tabelle
+  übernommen - Zeile danach prüfen, ID/Name vergeben, Kanalzahl kontrollieren
+  (3340-4-x = 4 Kanäle, 3340-2-x = 2 Kanäle) und aktivieren. mDNS funktioniert nur
+  innerhalb des gleichen Netzsegments/VLANs.
+- **Geräte-Tabelle** (auch komplett manuell befüllbar, ohne Discovery):
+  - `Aktiv`, `ID` (a-z 0-9 _ -), `Bezeichnung`, `IP-Adresse/Hostname`,
+    `Kanäle` (1-4), `Art` (Storen/Licht/unbekannt - steuert die ioBroker-Objektrollen,
+    siehe unten), `Laufzeit Storenmotor` (Sekunden, 0=deaktiviert - schaltet
+    `posEstimate` frei, siehe unten, gilt als Standard für alle Kanäle),
+    `Laufzeit/Kanal` (optional, kommagetrennt, z.B. `22,28` - überschreibt die
+    Standard-Laufzeit einzeln je Kanal; nützlich bei 2K-Geräten, deren beide
+    Kanäle unterschiedliche Motor-Laufzeiten haben; leere Einträge fallen auf
+    die Standard-Laufzeit zurück), `Smartfront` (Checkbox, nur bei angeschlossenem
+    Feller-Smartfront-Taster aktivieren), `Poll (s)` (Default 30, für RSSI +
+    periodischen chscan-Resync; die eigentlichen Kanalupdates laufen über den
+    chnotify-Long-Poll unabhängig davon).
+
+## Objektbaum pro Gerät (`zeptrion.0.<id>`)
+
+```
+<id>.info.connection / lastError / hw / sw / boot / sn / sys / type / oen / rssi / refresh
+<id>.network.ssid / ip / mac / mode / enc / mask / gw / bssid        (read-only)
+<id>.system.reboot / unlock / factoryDefault / networkDefault      (Buttons; factoryDefault erfordert unlock binnen 30s)
+<id>.location.name                                                  (read/write)
+<id>.ntp.url / per                                                   (read/write)
+<id>.date.rfc1123 / tz / dst / syncNow                               (read/write + Button)
+
+<id>.channels.chN.val                                    Kanalzustand 0-100 / -1 (roher Hardwarewert)
+<id>.channels.chN.posEstimate                             nur bei Art=Storen: Software-Positionsschätzung
+                                                           0=zu/100=offen, auch manuell schreibbar (Kalibrierung)
+<id>.channels.chN.name / group / icon / type / cat        Kanalbeschreibung (read/write)
+<id>.channels.chN.command                                 freies Kommando (String)
+<id>.channels.chN.stop / on / off / toggle / open / close /
+                  move_open / move_close / dim_up / dim_down        (Buttons)
+<id>.channels.chN.recall_s1..4 / store_s1..4 / delete_s1..4          (Buttons)
+
+<id>.smartfront.temp / lux / hum       nur wenn "Smartfront" aktiviert (read)
+<id>.smartfront.ledState               aktueller LED-Status als JSON (read)
+<id>.smartfront.ledSet                 LED(s) setzen, JSON-Array (write)
+```
+
+Global:
+
+```
+info.connection                mind. ein Gerät erreichbar
+control.closeAllShutters       Button: ALLE konfigurierten Kanäle -> "close"
+control.openAllShutters        Button: ALLE konfigurierten Kanäle -> "open"
+control.stopAllShutters        Button: ALLE konfigurierten Kanäle -> "stop"
+```
+
+## Objekt-Rollen und "Art" (kind)
+
+Die zrap-API selbst unterscheidet nicht zwischen Licht- und Storenkanal - das steckt
+allein in der Verkabelung/im Aktor. Damit Visualisierungen (VIS, evtl. spätere
+ioBroker.iot/Alexa-Anbindung) Kanäle trotzdem sinnvoll klassifizieren können, kann pro
+Gerät die "Art" gesetzt werden:
+
+| Art | `<ch>.val` Rolle | `stop`/`open`/`close` Rolle |
+|---|---|---|
+| Storen/Rolladen | `level.blind` | `button.stop` / `button.open.blind` / `button.close.blind` |
+| Licht | `level.dimmer` | generisch `button` |
+| unbekannt (Default) | `value` | generisch `button` |
+
+Wichtig: `level.blind` täuscht **keine** echte Positionsrückmeldung vor - laut Feller-Doku
+liefert `chscan`/`chnotify` für einen Storenkanal so gut wie immer `-1` (unbekannt), da die
+Hardware selbst keine Lamellenposition zurückmeldet. Die Rolle verbessert nur die
+Erkennung durch VIS-Widgets, der Zahlenwert bleibt i.d.R. uninformativ.
+
+## Hagelalarm-Nutzung
+
+```javascript
+// JavaScript-Adapter Beispiel
+on({id: 'wetter.0.warnungen.hagel', val: true}, function () {
+    setState('zeptrion.0.control.closeAllShutters', true);
+});
+```
+
+Fehler bei einzelnen Geräten (offline etc.) unterbrechen die übrigen Kanäle nicht -
+jeder fehlgeschlagene Kanal wird einzeln geloggt und in `<id>.info.lastError` vermerkt.
+
+## Bekannte Einschränkungen / bewusste Entscheidungen
+
+- **Smartbutton-Webhook-Programmierung** (`zapi/smartbt/prgm`/`prgn`/`prgs`) ist nicht
+  implementiert: dabei ruft der Taster bei Tastendruck direkt eine URL auf ioBroker auf
+  (echtes Push, ganz ohne Polling). Das würde einen eingehenden HTTP-Server im Adapter
+  voraussetzen, den es aktuell nicht gibt - eine grössere Architekturerweiterung, kein
+  kleiner Zusatz. Bleibt als möglicher zukünftiger Ausbauschritt dokumentiert.
+- **Schreibzugriff auf `zrap/net`** ist nicht implementiert - WLAN-Zugangsdaten eines
+  Aktors per Skript zu ändern ist riskant (Verbindungsverlust, Reboot nötig). Kann bei
+  Bedarf ergänzt werden.
+- **Scheduler (`zrap/scheduler`)** und die **zeptrionAir-Smartfront-Services**
+  (`zapi/smartfront/*`, `zapi/smartbt/*`) sind nicht implementiert, da für den
+  Storen-/Hagel-Use-Case nicht relevant. Die vorhandene `zrapGet`/`zrapPost`-Struktur
+  in `main.js` lässt sich leicht erweitern.
+- `chctrl` liefert laut Doku HTTP 302 ohne Body - Redirects werden bewusst nicht verfolgt
+  (`maxRedirects: 0`), um unnötige Zusatzrequests zu vermeiden.
+- Bei wiederholten Fehlern eines Geräts wird das Poll-Intervall bis maximal das
+  5-fache verlängert (einfacher Backoff).
+
+## Entwicklung / Tests
+
+```bash
+npm install
+npm run lint
+npm test              # Package-Konsistenz + Unit-Tests
+npm run test:integration   # startet echten js-controller (dauert länger)
+```
+
+## Veröffentlichung im ioBroker Adapter-Store
+
+Kurzer Fahrplan (Details: https://github.com/ioBroker/ioBroker.docs/blob/master/docs/de/dev/adaptercreation.md):
+
+1. Autor-E-Mail (`CHANGE_ME@example.com`) in `package.json` eintragen.
+2. Eigenes öffentliches GitHub-Repository `ioBroker.zeptrion` anlegen, Code pushen.
+3. `npx @iobroker/adapter-checker` (bzw. https://adapter-check.iobroker.in/) gegen das
+   Repository laufen lassen und alle Fehler/Warnungen bereinigen.
+4. Ersten Release-Tag setzen (`v0.1.0`), CI-Workflow veröffentlicht bei Bedarf automatisch
+   auf npm (Secret `NPM_TOKEN` in den Repo-Settings hinterlegen) oder manuell `npm publish`.
+5. Pull Request gegen `ioBroker/ioBroker.repositories` (`sources-dist.json`, Eintrag unter
+   `latest`) erstellen.
+6. Nach Review/Merge erscheint der Adapter im Adapter-Store; nach ausreichender Stabilität
+   und positiven Bewertungen kann später ein Antrag auf Aufnahme in den `stable`-Zweig
+   gestellt werden.
+
+## Changelog
+
+### 0.7.0 (2026-07-10)
+- Skalierung für 20+ Geräte: paralleles Setup, Poll-Jitter, Duplikat-Erkennung
+- Strikte Startup-Validierung jeder konfigurierten Geräte-Zeile
+- CSV-Massenimport (eigener Konfig-Tab) mit Zeilen-Validierung und Auto-ID
+- FIX: Positionsschätzung nach Stopp während Endlagenfahrt korrekt
+- FIX: Adapter-Timer-Cleanup (this.clearTimeout), führende Nullen in chdes-Codes bleiben erhalten
+
+### 0.6.0 (2026-07-10)
+- Auto-ID aus Host, Geräte-Test-Button (Erreichbarkeit + zeptrion-Verifikation + Kanalzahl-Prüfung)
+- Kanal-Objektnamen aus dem Gerät (chdes), neues Icon, Geräte-Icons
+
+### 0.5.1 (2026-07-10)
+- KRITISCHER FIX: XML-Parser übersprang die Nutzdaten wegen des XML-Deklarations-Keys - alle GET-Werte blieben in 0.5.0 null
+
+### 0.5.0 (2026-07-07)
+- setPosition: zeitbasierte %-Anfahrt für Storen (Chunking wegen 32s-API-Limit, Referenzfahrt bei unbekannter Position)
+- tiltOpen/tiltClose: Lamellen-Kipp-Impulse (konfigurierbare Impulsdauer)
+- calibrate: Positionsschätzung ohne Fahrt setzen
+
+### 0.4.0 (2026-07-07) - Security- & Qualitäts-Härtung
+- **Verriegelter Werksreset**: `system.factoryDefault` funktioniert nur noch innerhalb
+  von 30s nach Setzen von `system.unlock` - ein einzelner versehentlicher setState aus
+  Script/VIS kann das Gerät nicht mehr plätten.
+- **Crashsicheres onStateChange**: der komplette Handler (inkl. der Sammelbefehle) läuft
+  jetzt in einer zentralen Fehlerbehandlung - keine Unhandled Promise Rejections mehr
+  möglich.
+- **Eingabevalidierung**: Kanalbeschreibung (32/32/24/4/4 Bytes UTF-8), Standort (32),
+  NTP-URL (32) und NTP-Intervall (0-255) werden vor dem Senden geprüft; klare
+  Fehlermeldung statt HTTP-400 vom Gerät. Umlaute zählen korrekt als 2 Bytes.
+- **Adapter-verwaltete Timer** (`this.setTimeout`) überall - automatische Aufräumung
+  beim Unload gemäss ioBroker-Guidelines.
+- **Verbindungs-Ökonomie**: solange der chnotify-Long-Poll gesund läuft, wird der
+  redundante chscan-Resync nur noch bei jedem 5. Poll ausgeführt (schont die
+  schwachen Embedded-Webserver der Unterputzaktoren).
+- **chnotify abschaltbar** (Experten-Tab) für Umgebungen mit Verbindungsproblemen.
+- **Admin-UI neu**: Tabs (Geräte/Experten), durchgängig EN+DE, Eingabe-Validatoren
+  (ID-Muster, Host-Muster), Tooltips an jeder Spalte, Sicherheitshinweis.
+- ESLint auf Flat Config (v9) migriert, Lint läuft sauber durch; Smoke-Tests für
+  Kommando-Validierung, Byte-Limits, Positionsmathematik und Multicast-Body.
+
+### 0.3.0 (2026-07-07)
+- Kanalbefehle desselben Geräts werden innerhalb eines 50ms-Fensters automatisch zu
+  einem einzigen Multicast-POST an `/zrap/chctrl` gebündelt statt sequentiell einzeln
+  gesendet - insbesondere `control.closeAllShutters` (Hagelalarm) profitiert davon
+  massiv (ein Request pro Gerät statt einer pro Kanal).
+- Optionale zeitbasierte Storen-Positionsschätzung (`posEstimate`) anhand konfigurierbarer
+  Motor-Laufzeit, da die Hardware selbst keine Position zurückmeldet.
+- Optionale Smartfront-Unterstützung (`zapi/smartfront/*`): Temperatur/Helligkeit/
+  Feuchtigkeit auslesen, LED-Hintergrundfarbe setzen.
+- Rollen-Korrektur: `level.blind` sitzt jetzt auf der Positionsschätzung statt auf dem
+  rohen (meist -1) Hardwarewert.
+
+### 0.2.0 (2026-07-07)
+- Kanalzustände werden jetzt primär über `zrap/chnotify` (Long-Poll) nahezu in
+  Echtzeit aktualisiert statt nur per Intervall-Polling; `chscan`-Poll bleibt als
+  periodischer Resync/Fallback erhalten.
+- Zusätzliches Sicherheitsnetz (Busy-Window, 5s) verhindert, dass ein zeitgleicher
+  chscan-Resync einen gerade gesendeten Bewegungsbefehl mit einem veralteten Wert
+  überschreibt.
+- mDNS-Discovery-Handler gegen Exceptions durch fremde/kaputte Netzwerkpakete
+  abgesichert (try/catch je Service-Event statt nur um die Subscription herum).
+- Neues Geräte-Feld "Art" (Storen/Licht/unbekannt) steuert Standard-Objektrollen
+  (`level.blind`, `button.stop`, `button.open.blind`, `button.close.blind` bzw.
+  `level.dimmer`) für bessere VIS-/Smart-Home-Integration.
+- Strukturierte `native`-Metadaten (Host, Kanalnummer, Art) an Geräte-/Kanal-Objekten.
+
+### 0.1.0 (2026-07-07)
+- Erste Version: Kanalsteuerung, Kanalzustand/-beschreibung, Geräte-/Netzwerkinfo,
+  Systembefehle, Standort/NTP/Datum, Sammelbefehle für Hagelalarm, mDNS-Discovery.
+
+## License
+
+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/jsonConfig.json

@@ -0,0 +1,245 @@
+{
+  "type": "tabs",
+  "items": {
+    "tabDevices": {
+      "type": "panel",
+      "label": { "en": "Devices", "de": "Geräte" },
+      "items": {
+        "_infoHeader": {
+          "type": "staticText",
+          "text": {
+            "en": "Feller zeptrion / zApp WLAN actuators (WLAN-Nebenstelle 4K, WLAN-Zwischenmodul 2K). Host = IP address or mDNS name (e.g. zapp-14250034.local).",
+            "de": "Feller zeptrion / zApp WLAN-Aktoren (WLAN-Nebenstelle 4K, WLAN-Zwischenmodul 2K). Host = IP-Adresse oder mDNS-Name (z.B. zapp-14250034.local)."
+          },
+          "sm": 12
+        },
+        "discoverBtn": {
+          "newLine": true,
+          "type": "sendTo",
+          "command": "discover",
+          "jsonData": "{}",
+          "variant": "contained",
+          "label": {
+            "en": "🔍 Scan network for zeptrion devices (mDNS, ~4s)",
+            "de": "🔍 Netzwerk nach zeptrion-Geräten durchsuchen (mDNS, ca. 4s)"
+          },
+          "showProcess": true,
+          "sm": 12, "md": 6
+        },
+        "testBtn": {
+          "type": "sendTo",
+          "command": "testDevices",
+          "jsonData": "{}",
+          "variant": "outlined",
+          "label": {
+            "en": "🔎 Test configured devices (reachable? really zeptrion?)",
+            "de": "🔎 Konfigurierte Geräte testen (erreichbar? wirklich zeptrion?)"
+          },
+          "showProcess": true,
+          "sm": 12, "md": 6
+        },
+        "_discoverHint": {
+          "type": "staticText",
+          "text": {
+            "en": "Found devices are added DISABLED to the table below. Close and reopen this dialog after scanning, then verify each row (name, channel count, kind) and enable it. mDNS only works within the same network segment / VLAN.",
+            "de": "Gefundene Geräte werden DEAKTIVIERT in die Tabelle übernommen. Dialog nach der Suche schliessen und neu öffnen, dann jede Zeile prüfen (Name, Kanalzahl, Art) und aktivieren. mDNS funktioniert nur im gleichen Netzsegment/VLAN."
+          },
+          "sm": 12
+        },
+        "devices": {
+          "newLine": true,
+          "type": "table",
+          "label": { "en": "Devices", "de": "Geräte" },
+          "sm": 12,
+          "items": [
+            {
+              "type": "checkbox",
+              "attr": "enabled",
+              "title": { "en": "Active", "de": "Aktiv" },
+              "default": true,
+              "width": "5%"
+            },
+            {
+              "type": "text",
+              "attr": "id",
+              "title": "ID",
+              "tooltip": { "en": "Leave empty = auto-generated from host. Only a-z, 0-9, _ and -", "de": "Leer lassen = wird automatisch aus dem Host erzeugt. Nur a-z, 0-9, _ und -" },
+              "validator": "!data.id || /^[a-zA-Z0-9_-]+$/.test(data.id)",
+              "validatorErrorText": { "en": "Only a-z, 0-9, _ and - (or leave empty)", "de": "Nur a-z, 0-9, _ und - (oder leer lassen)" },
+              "width": "10%"
+            },
+            {
+              "type": "text",
+              "attr": "name",
+              "title": { "en": "Label", "de": "Bezeichnung" },
+              "width": "14%"
+            },
+            {
+              "type": "text",
+              "attr": "host",
+              "title": { "en": "IP address / hostname", "de": "IP-Adresse / Hostname" },
+              "validator": "!data.host || /^[a-zA-Z0-9.\\-]+$/.test(data.host)",
+              "validatorErrorText": { "en": "Invalid host (no protocol, no spaces)", "de": "Ungültiger Host (kein Protokoll, keine Leerzeichen)" },
+              "width": "16%"
+            },
+            {
+              "type": "number",
+              "attr": "channels",
+              "title": { "en": "Channels", "de": "Kanäle" },
+              "tooltip": { "en": "3340-4-x = 4, 3340-2-x = 2", "de": "3340-4-x = 4, 3340-2-x = 2" },
+              "min": 1, "max": 4, "default": 1,
+              "width": "6%"
+            },
+            {
+              "type": "select",
+              "attr": "kind",
+              "title": { "en": "Kind", "de": "Art" },
+              "tooltip": { "en": "Controls ioBroker object roles for VIS/smart home integrations", "de": "Steuert ioBroker-Objektrollen für VIS/Smart-Home-Integrationen" },
+              "options": [
+                { "value": "unknown", "label": { "en": "unknown/mixed", "de": "unbekannt/gemischt" } },
+                { "value": "blind", "label": { "en": "Blinds/shutters", "de": "Storen/Rolladen" } },
+                { "value": "light", "label": { "en": "Light", "de": "Licht" } }
+              ],
+              "default": "unknown",
+              "width": "12%"
+            },
+            {
+              "type": "number",
+              "attr": "travelTimeSec",
+              "title": { "en": "Motor travel (s)", "de": "Motor-Laufzeit (s)" },
+              "tooltip": {
+                "en": "Default travel time in seconds, used for all channels unless overridden per-channel below. 0 = position estimation and setPosition disabled. Only relevant for kind=Blinds.",
+                "de": "Standard-Laufzeit in Sekunden, gilt für alle Kanäle, sofern nicht rechts pro Kanal überschrieben. 0 = Positionsschätzung und setPosition deaktiviert. Nur relevant bei Art=Storen."
+              },
+              "min": 0, "max": 300, "default": 0,
+              "width": "8%"
+            },
+            {
+              "type": "text",
+              "attr": "travelTimeSecCh",
+              "title": { "en": "Travel/ch (s)", "de": "Laufzeit/Kanal (s)" },
+              "tooltip": {
+                "en": "Optional: comma-separated per-channel override, one value per channel in order (e.g. '22,28' for a 2K device where channel 1 and 2 have different motor travel times). Empty entries fall back to 'Motor travel (s)'. Leave the whole field empty to use the same value for all channels.",
+                "de": "Optional: Kommagetrennte Laufzeit pro Kanal, ein Wert je Kanal in Reihenfolge (z.B. '22,28' für ein 2K-Gerät, bei dem Kanal 1 und 2 unterschiedliche Motor-Laufzeiten haben). Leere Einträge verwenden 'Motor-Laufzeit (s)'. Ganzes Feld leer lassen = gleicher Wert für alle Kanäle."
+              },
+              "validator": "!data.travelTimeSecCh || /^\\s*\\d*\\s*(,\\s*\\d*\\s*){0,3}$/.test(data.travelTimeSecCh)",
+              "validatorErrorText": { "en": "Comma-separated numbers only, max 4 values (e.g. '22,28')", "de": "Nur kommagetrennte Zahlen, max. 4 Werte (z.B. '22,28')" },
+              "width": "9%"
+            },
+            {
+              "type": "number",
+              "attr": "tiltTimeMs",
+              "title": { "en": "Tilt pulse (ms)", "de": "Kipp-Impuls (ms)" },
+              "tooltip": {
+                "en": "Short move pulse for tilting raffstore lamellas via tiltOpen/tiltClose (typically 300-800ms). 0 = disabled. Only relevant for kind=Blinds.",
+                "de": "Kurzer Fahr-Impuls zum Schrägstellen von Rafflamellen via tiltOpen/tiltClose (typisch 300-800ms). 0 = deaktiviert. Nur relevant bei Art=Storen."
+              },
+              "min": 0, "max": 5000, "default": 0,
+              "width": "8%"
+            },
+            {
+              "type": "checkbox",
+              "attr": "smartfront",
+              "title": "Smartfront",
+              "tooltip": {
+                "en": "Only enable if a Feller Smartfront (920-330x.xx.ZS/.ZU) is attached: adds temperature/brightness/humidity sensors and LED control",
+                "de": "Nur aktivieren, wenn ein Feller-Smartfront (920-330x.xx.ZS/.ZU) montiert ist: ergänzt Temperatur/Helligkeit/Feuchte-Sensoren und LED-Steuerung"
+              },
+              "default": false,
+              "width": "8%"
+            },
+            {
+              "type": "number",
+              "attr": "pollInterval",
+              "title": "Poll (s)",
+              "tooltip": {
+                "en": "Interval for RSSI + periodic resync. Real-time channel updates come via long-poll independently.",
+                "de": "Intervall für RSSI + periodischen Resync. Echtzeit-Kanalupdates kommen unabhängig davon per Long-Poll."
+              },
+              "min": 5, "max": 3600, "default": 30,
+              "width": "7%"
+            }
+          ]
+        }
+      }
+    },
+    "tabImport": {
+      "type": "panel",
+      "label": { "en": "CSV import", "de": "CSV-Import" },
+      "items": {
+        "_csvHelp": {
+          "type": "staticText",
+          "text": {
+            "en": "Bulk-add devices. One line per device, semicolon separated (recommended if using the last column, since it contains commas):\nhost;name;channels;kind;travel_s;tilt_ms;smartfront;poll_s;travel_s_per_channel\nOnly host is mandatory. kind: blind/light/unknown (also: storen, licht). smartfront: 1/0. travel_s_per_channel (optional): comma-separated per-channel override, e.g. '22,28' for a 2K device with different travel times, empty = use travel_s for all channels. Lines starting with # are ignored, a header line 'host;...' is skipped.\nExample:\n10.195.36.116;Storen Büro;2;blind;22;500;0;30;22,28\n10.195.36.117;Storen Wohnen;2;storen;25",
+            "de": "Geräte in Serie anlegen. Eine Zeile pro Gerät, Semikolon getrennt (empfohlen bei Nutzung der letzten Spalte, da diese Kommas enthält):\nhost;name;kanäle;art;laufzeit_s;kipp_ms;smartfront;poll_s;laufzeit_kanal_s\nNur host ist Pflicht. art: blind/light/unknown (auch: storen, licht). smartfront: 1/0. laufzeit_kanal_s (optional): kommagetrennte Laufzeit pro Kanal, z.B. '22,28' für ein 2K-Gerät mit unterschiedlichen Laufzeiten, leer = laufzeit_s für alle Kanäle. Zeilen mit # werden ignoriert, eine Kopfzeile 'host;...' wird übersprungen.\nBeispiel:\n10.195.36.116;Storen Büro;2;blind;22;500;0;30;22,28\n10.195.36.117;Storen Wohnen;2;storen;25"
+          },
+          "sm": 12
+        },
+        "csvText": {
+          "newLine": true,
+          "type": "text",
+          "label": { "en": "CSV lines", "de": "CSV-Zeilen" },
+          "minRows": 8,
+          "maxRows": 20,
+          "trim": false,
+          "noClearButton": true,
+          "sm": 12
+        },
+        "importBtn": {
+          "newLine": true,
+          "type": "sendTo",
+          "command": "importCsv",
+          "jsonData": "{\"csv\": ${JSON.stringify(data.csvText)}}",
+          "variant": "contained",
+          "label": { "en": "⬆️ Import (validates every line)", "de": "⬆️ Importieren (validiert jede Zeile)" },
+          "showProcess": true,
+          "sm": 12, "md": 5
+        },
+        "_importHint": {
+          "type": "staticText",
+          "text": {
+            "en": "Valid lines are added ENABLED, invalid lines are reported and skipped. Duplicate hosts are rejected. After import the adapter restarts - close and reopen this dialog to see the new table rows.",
+            "de": "Gültige Zeilen werden AKTIVIERT übernommen, ungültige gemeldet und übersprungen. Doppelte Hosts werden abgelehnt. Nach dem Import startet der Adapter neu - Dialog schliessen und neu öffnen, um die neuen Tabellenzeilen zu sehen."
+          },
+          "sm": 12
+        }
+      }
+    },
+    "tabExpert": {
+      "type": "panel",
+      "label": { "en": "Expert", "de": "Experten" },
+      "items": {
+        "requestTimeout": {
+          "type": "number",
+          "label": { "en": "HTTP timeout (ms)", "de": "HTTP Timeout (ms)" },
+          "help": {
+            "en": "Timeout per request to a device (does not apply to the chnotify long-poll, which uses a fixed 35s).",
+            "de": "Timeout pro Request an ein Gerät (gilt nicht für den chnotify-Long-Poll, der fix 35s verwendet)."
+          },
+          "min": 500, "max": 30000, "default": 4000,
+          "sm": 12, "md": 4
+        },
+        "useNotify": {
+          "newLine": true,
+          "type": "checkbox",
+          "label": { "en": "Use chnotify long-poll (near real-time updates)", "de": "chnotify-Long-Poll verwenden (nahezu Echtzeit-Updates)" },
+          "help": {
+            "en": "Keeps one HTTP connection per device permanently open (device answers within 30s at the latest). Disable only if devices show connection problems; channel states then update only at the poll interval.",
+            "de": "Hält dauerhaft eine HTTP-Verbindung pro Gerät offen (Gerät antwortet spätestens nach 30s). Nur deaktivieren, falls Geräte Verbindungsprobleme zeigen; Kanalzustände aktualisieren dann nur noch im Poll-Intervall."
+          },
+          "default": true,
+          "sm": 12, "md": 8
+        },
+        "_safetyHint": {
+          "newLine": true,
+          "type": "staticText",
+          "text": {
+            "en": "⚠️ Safety: the factory reset button (system.factoryDefault) is interlocked - it only works within 30s after setting system.unlock. This prevents accidental wipes from scripts/VIS.",
+            "de": "⚠️ Sicherheit: der Werksreset-Button (system.factoryDefault) ist verriegelt - er funktioniert nur innerhalb von 30s nach Setzen von system.unlock. Das verhindert versehentliches Löschen durch Scripts/VIS."
+          },
+          "sm": 12
+        }
+      }
+    }
+  }
+}