iobroker.faikout 0.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Immanuel
+
+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,129 @@
+![Logo](admin/faikout.png)
+
+# ioBroker.faikout
+
+Connect Daikin air conditioners equipped with a [faikout](https://codeberg.org/RevK/ESP32-Faikout)
+module to ioBroker — purely over MQTT, entirely local, no cloud and no vendor API.
+
+The adapter brings **its own MQTT broker**. You point the faikout modules at it and that is all;
+no separate broker, no `mqtt` adapter instance, and no interference with any MQTT setup you
+already run.
+
+## Why a dedicated adapter
+
+A faikout module also emulates the old local Daikin HTTP API, so it can be used with the
+`daikin` adapter. Over MQTT, however, it exposes considerably more — in particular values the
+HTTP API does not provide at all:
+
+| Value | HTTP (`daikin` adapter) | MQTT (this adapter) |
+|---|---|---|
+| Indoor humidity | not reported | yes |
+| Energy counters (total / heating / cooling) | not reported | yes |
+| Current power draw | not reported | yes |
+| Compressor speed | reported as 0 | yes |
+| Fan speed | not reported | yes |
+| Refrigerant temperature | not reported | yes |
+| Demand limit, louvre angle, presets | not reported | yes |
+| WiFi and device diagnostics | version only | yes |
+
+## Data points are created dynamically
+
+A faikout module only publishes a field when the attached air conditioner actually supports it,
+and its own settings can hide further ones. There is therefore **no fixed list of fields**: the
+adapter creates exactly the data points it receives and silently omits the rest. Two units of
+different models will legitimately end up with different object trees.
+
+Fields the adapter does not know yet are still created, with a type derived from the value, and
+noted in the log.
+
+Objects are grouped per device:
+
+- `<device>.control.*` — writable: power, mode, target temperature, fan, swing, preset, demand,
+  econo, powerful, comfort, streamer, sensor, LED, quiet, humidify
+- `<device>.status.*` — readings: temperatures, humidity, energy, power, compressor and fan speed
+- `<device>.info.*` — device diagnostics: IP, WiFi signal, uptime, firmware
+
+## Setup
+
+1. Install the adapter and open the instance configuration.
+2. Choose the broker port (default `1888`). It must not collide with another MQTT broker.
+   Optionally set a user name and password; leaving the user name empty accepts unauthenticated
+   connections, which is the usual case inside a home network.
+3. Open the web interface of each faikout module, go to **Settings → Basic** and set
+   **MQTT host** to `<ioBroker IP>:<port>`. The module reconnects on its own.
+
+### Running ioBroker in Docker
+
+The broker port has to be published by the container, otherwise the modules cannot reach it.
+Add a port mapping for the configured port.
+
+### Faster feedback
+
+Out of the box a module reports its state every 60 seconds (`reporting` setting), so a command
+is only confirmed with the next report — expect up to a minute. Enabling `livestatus` in the
+module's **Extra** settings makes it report immediately.
+
+## Changelog
+
+### 0.0.5
+- Meet the ioBroker repository requirements: updated dev dependencies, removed the deprecated
+  `common.main`, fixed responsive column widths, and translated the admin texts into the nine
+  remaining languages.
+
+### 0.0.4
+- Fix: the admin rejected the whole configuration with "invalid jsonConfig". `instance` fields
+  do not allow `visible` (their schema sets `additionalProperties: false`); the condition
+  belongs in `hidden`. The configuration is now validated against the official schema.
+
+### 0.0.3
+- Fix: consumption tracking crashed on every meter reading after updating from 0.0.1
+  ("Cannot read properties of undefined") because the stored state predates the day and month
+  buffers. Stored state is merged into a fresh default now.
+- Fix: with no month recorded yet, the month rollover booked the whole meter reading as last
+  month's consumption (3783 kWh instead of the difference).
+- `npm test` only ran the package checks; the unit tests now run with it.
+
+### 0.0.2
+- New VIS widget **Energy history**: bar chart switchable between day, month and year, with
+  cooling and heating shown separately.
+- Consumption now also covers the current and previous month, and keeps three series ready for
+  charting: `stundenJson` (48 hours), `tageJson` (62 days) and `monateJson` (24 months).
+
+### 0.0.1
+- Initial version: own MQTT broker, dynamically created data points, writable controls.
+
+## Trademark and relationship to the hardware project
+
+*Faikout* is a registered trademark of Andrews & Arnold Ltd. This adapter is an independent
+piece of software and is neither affiliated with nor endorsed by Andrews & Arnold Ltd or the
+authors of [ESP32-Faikout](https://codeberg.org/RevK/ESP32-Faikout). The name is used solely to
+state which hardware the adapter talks to.
+
+No source code from the hardware project is included. The adapter was written from scratch
+against the MQTT interface; field names and value lists necessarily match, because that is what
+the protocol prescribes. The hardware project is licensed under the GPL, this adapter under MIT
+— they are separate works that communicate over a network protocol.
+
+## License
+
+MIT License
+
+Copyright (c) 2026 Immanuel
+
+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,25 @@
+{
+  "tabBroker": "MQTT-Broker",
+  "tabHilfe": "Einrichtung",
+  "headerBroker": "Eigener MQTT-Broker",
+  "textBroker": "Dieser Adapter bringt einen eigenen MQTT-Broker mit. Die faikout-Module müssen nur darauf zeigen, mehr ist nicht nötig.",
+  "labelPort": "Port",
+  "helpPort": "Port, auf dem der Broker lauscht. Muss sich von anderen MQTT-Brokern unterscheiden (z. B. dem mqtt-Adapter).",
+  "labelUser": "Benutzername",
+  "helpUser": "Leer lassen, um Verbindungen ohne Anmeldung zuzulassen.",
+  "labelPass": "Passwort",
+  "helpPass": "Wird nur ausgewertet, wenn ein Benutzername gesetzt ist.",
+  "headerSetup": "Ein faikout-Modul einrichten",
+  "textSetup": "Weboberfläche des Moduls öffnen, Settings, Reiter Basic, dort 'MQTT host' auf <IP des ioBroker>:<Port von oben> setzen. Das Modul verbindet sich selbständig neu.",
+  "headerDocker": "ioBroker im Docker-Container",
+  "textDocker": "Der Broker-Port muss vom Container nach außen gemappt sein, sonst erreichen ihn die Module nicht. Für den oben eingestellten Port ein Portmapping ergänzen.",
+  "headerLive": "Schnellere Rückmeldung",
+  "textLive": "Ab Werk meldet ein Modul seinen Zustand alle 60 Sekunden ('reporting') - ein Befehl wird deshalb erst mit der nächsten Meldung bestätigt. Die Einstellung 'livestatus' in den Extra-Einstellungen des Moduls lässt es sofort melden.",
+  "tabVerbrauch": "Verbrauch",
+  "headerVerbrauch": "Verbrauchshistorie",
+  "textVerbrauch": "Die Anlagen melden nur Gesamtzähler. Der Adapter bildet daraus Stunden- und Tagesverbrauch (verbrauch.*), lässt die Gesamtzähler unangetastet (status.*) und legt die letzten 48 Stunden als JSON für das Widget ab.",
+  "labelHistoryAnmelden": "Verbrauch über den History-Adapter aufzeichnen",
+  "helpHistoryAnmelden": "Meldet die Verbrauchs-Datenpunkte automatisch zur Aufzeichnung an, damit Diagramme ohne Handarbeit an jedem einzelnen Punkt funktionieren.",
+  "labelHistoryInstanz": "History-Instanz",
+  "helpHistoryInstanz": "Instanz, welche die Reihen speichert."
+}

package/admin/i18n/en/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "This adapter runs its own MQTT broker. Point the faikout modules at it; nothing else is needed.",
+  "labelPort": "Port",
+  "helpPort": "Port the broker listens on. Must differ from any other MQTT broker (e.g. the mqtt adapter).",
+  "labelUser": "User name",
+  "helpUser": "Leave empty to accept connections without authentication.",
+  "labelPass": "Password",
+  "helpPass": "Only used when a user name is set.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Open the module's web interface, go to Settings, tab Basic, and set 'MQTT host' to <ioBroker IP>:<port above>. The module reconnects on its own.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "The broker port must be published by the container, otherwise the modules cannot reach it. Add a port mapping for the port configured above.",
+  "headerLive": "Faster feedback",
+  "textLive": "By default a module reports its status every 60 seconds ('reporting'), so a command is confirmed only with the next report. Enabling 'livestatus' in the module's Extra settings makes it report immediately.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "The units only report lifetime counters. The adapter derives hourly and daily consumption from them (verbrauch.*), keeps the totals unchanged (status.*) and stores the last 48 hours as JSON for the widget.",
+  "labelHistoryAnmelden": "Log consumption with the history adapter",
+  "helpHistoryAnmelden": "Registers the consumption data points for recording automatically, so charts work without configuring each point by hand.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/es/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Este adaptador ejecuta su propio broker MQTT. Apunte los módulos faikout hacia él; no se necesita nada más.",
+  "labelPort": "Port",
+  "helpPort": "Puerto en el que escucha el broker. Debe ser distinto de cualquier otro broker MQTT (por ejemplo, el adaptador mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Déjelo vacío para aceptar conexiones sin autenticación.",
+  "labelPass": "Password",
+  "helpPass": "Solo se utiliza cuando se ha indicado un nombre de usuario.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Abra la interfaz web del módulo, vaya a Ajustes, pestaña Basic, y ponga 'MQTT host' en <IP de ioBroker>:<puerto de arriba>. El módulo se reconecta solo.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "El contenedor debe publicar el puerto del broker; de lo contrario los módulos no pueden alcanzarlo. Añada una asignación de puerto para el puerto configurado arriba.",
+  "headerLive": "Faster feedback",
+  "textLive": "De forma predeterminada, un módulo informa de su estado cada 60 segundos ('reporting'), por lo que una orden solo se confirma con el siguiente informe. Activar 'livestatus' en los ajustes Extra del módulo hace que informe de inmediato.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Las unidades solo informan de contadores acumulados. El adaptador deriva de ellos el consumo por hora y por día (verbrauch.*), mantiene los totales sin cambios (status.*) y guarda las últimas 48 horas como JSON para el widget.",
+  "labelHistoryAnmelden": "Registrar el consumo con el adaptador history",
+  "helpHistoryAnmelden": "Da de alta automáticamente los puntos de datos de consumo para su registro, de modo que los gráficos funcionan sin configurar cada punto a mano.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/fr/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Cet adaptateur exécute son propre broker MQTT. Dirigez-y les modules faikout ; rien d'autre n'est nécessaire.",
+  "labelPort": "Port",
+  "helpPort": "Port d'écoute du broker. Il doit différer de tout autre broker MQTT (par exemple l'adaptateur mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Laisser vide pour accepter les connexions sans authentification.",
+  "labelPass": "Password",
+  "helpPass": "Utilisé uniquement lorsqu'un nom d'utilisateur est défini.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Ouvrez l'interface web du module, allez dans Settings, onglet Basic, et réglez « MQTT host » sur <IP ioBroker>:<port ci-dessus>. Le module se reconnecte tout seul.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "Le port du broker doit être publié par le conteneur, sinon les modules ne peuvent pas l'atteindre. Ajoutez un mappage pour le port configuré ci-dessus.",
+  "headerLive": "Faster feedback",
+  "textLive": "Par défaut, un module signale son état toutes les 60 secondes (« reporting ») ; une commande n'est donc confirmée qu'au rapport suivant. Activer « livestatus » dans les réglages Extra du module le fait répondre immédiatement.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Les unités ne fournissent que des compteurs cumulés. L'adaptateur en déduit la consommation horaire et journalière (verbrauch.*), conserve les totaux inchangés (status.*) et enregistre les 48 dernières heures en JSON pour le widget.",
+  "labelHistoryAnmelden": "Enregistrer la consommation avec l'adaptateur history",
+  "helpHistoryAnmelden": "Inscrit automatiquement les points de données de consommation à l'enregistrement, afin que les graphiques fonctionnent sans configurer chaque point à la main.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/it/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Questo adapter esegue un proprio broker MQTT. Puntare i moduli faikout su di esso; non serve altro.",
+  "labelPort": "Port",
+  "helpPort": "Porta su cui è in ascolto il broker. Deve essere diversa da quella di altri broker MQTT (ad esempio l'adapter mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Lasciare vuoto per accettare connessioni senza autenticazione.",
+  "labelPass": "Password",
+  "helpPass": "Usato solo quando è impostato un nome utente.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Aprire l'interfaccia web del modulo, andare in Settings, scheda Basic, e impostare 'MQTT host' su <IP di ioBroker>:<porta indicata sopra>. Il modulo si riconnette da solo.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "La porta del broker deve essere pubblicata dal container, altrimenti i moduli non possono raggiungerla. Aggiungere un mapping per la porta configurata sopra.",
+  "headerLive": "Faster feedback",
+  "textLive": "Per impostazione predefinita un modulo comunica il proprio stato ogni 60 secondi ('reporting'), quindi un comando viene confermato solo con la segnalazione successiva. Attivando 'livestatus' nelle impostazioni Extra del modulo la segnalazione è immediata.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Le unità comunicano solo contatori cumulativi. L'adapter ne ricava il consumo orario e giornaliero (verbrauch.*), lascia invariati i totali (status.*) e memorizza le ultime 48 ore in JSON per il widget.",
+  "labelHistoryAnmelden": "Registrare il consumo con l'adapter history",
+  "helpHistoryAnmelden": "Registra automaticamente i datapoint di consumo, così i grafici funzionano senza configurare ogni punto a mano.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/nl/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Deze adapter draait een eigen MQTT-broker. Richt de faikout-modules daarop; meer is niet nodig.",
+  "labelPort": "Port",
+  "helpPort": "Poort waarop de broker luistert. Moet verschillen van elke andere MQTT-broker (bijvoorbeeld de mqtt-adapter).",
+  "labelUser": "User name",
+  "helpUser": "Laat leeg om verbindingen zonder authenticatie toe te staan.",
+  "labelPass": "Password",
+  "helpPass": "Wordt alleen gebruikt als een gebruikersnaam is ingesteld.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Open de webinterface van de module, ga naar Settings, tabblad Basic, en zet 'MQTT host' op <ioBroker-IP>:<poort hierboven>. De module maakt zelf opnieuw verbinding.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "De brokerpoort moet door de container worden gepubliceerd, anders kunnen de modules hem niet bereiken. Voeg een portmapping toe voor de hierboven ingestelde poort.",
+  "headerLive": "Faster feedback",
+  "textLive": "Standaard meldt een module zijn status elke 60 seconden ('reporting'), waardoor een opdracht pas bij de volgende melding wordt bevestigd. Met 'livestatus' in de Extra-instellingen van de module meldt hij direct.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "De units melden alleen tellerstanden. De adapter leidt daaruit het uur- en dagverbruik af (verbrauch.*), laat de totalen ongewijzigd (status.*) en bewaart de laatste 48 uur als JSON voor de widget.",
+  "labelHistoryAnmelden": "Verbruik vastleggen met de history-adapter",
+  "helpHistoryAnmelden": "Meldt de verbruiksdatapunten automatisch aan voor registratie, zodat grafieken werken zonder elk punt handmatig in te stellen.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/pl/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Ten adapter uruchamia własnego brokera MQTT. Skieruj na niego moduły faikout; nic więcej nie jest potrzebne.",
+  "labelPort": "Port",
+  "helpPort": "Port nasłuchu brokera. Musi różnić się od innych brokerów MQTT (np. adaptera mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Pozostaw puste, aby akceptować połączenia bez uwierzytelniania.",
+  "labelPass": "Password",
+  "helpPass": "Używane tylko wtedy, gdy ustawiono nazwę użytkownika.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Otwórz interfejs webowy modułu, przejdź do Settings, zakładka Basic, i ustaw 'MQTT host' na <IP ioBrokera>:<port powyżej>. Moduł połączy się ponownie samodzielnie.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "Port brokera musi być opublikowany przez kontener, inaczej moduły go nie osiągną. Dodaj mapowanie dla portu ustawionego powyżej.",
+  "headerLive": "Faster feedback",
+  "textLive": "Domyślnie moduł zgłasza swój stan co 60 sekund ('reporting'), więc polecenie zostaje potwierdzone dopiero przy kolejnym zgłoszeniu. Włączenie 'livestatus' w ustawieniach Extra modułu powoduje natychmiastowe zgłaszanie.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Jednostki podają wyłącznie liczniki sumaryczne. Adapter wylicza z nich zużycie godzinowe i dobowe (verbrauch.*), pozostawia sumy bez zmian (status.*) i zapisuje ostatnie 48 godzin jako JSON dla widgetu.",
+  "labelHistoryAnmelden": "Rejestruj zużycie w adapterze history",
+  "helpHistoryAnmelden": "Automatycznie zgłasza punkty danych zużycia do rejestracji, dzięki czemu wykresy działają bez ręcznej konfiguracji każdego punktu.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/pt/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Este adaptador executa o seu próprio broker MQTT. Aponte os módulos faikout para ele; não é preciso mais nada.",
+  "labelPort": "Port",
+  "helpPort": "Porta em que o broker escuta. Tem de ser diferente de qualquer outro broker MQTT (por exemplo, o adaptador mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Deixe vazio para aceitar ligações sem autenticação.",
+  "labelPass": "Password",
+  "helpPass": "Só é utilizado quando está definido um nome de utilizador.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Abra a interface web do módulo, vá a Settings, separador Basic, e defina 'MQTT host' como <IP do ioBroker>:<porta acima>. O módulo volta a ligar-se sozinho.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "A porta do broker tem de ser publicada pelo contentor, caso contrário os módulos não lhe conseguem chegar. Adicione um mapeamento para a porta configurada acima.",
+  "headerLive": "Faster feedback",
+  "textLive": "Por predefinição, um módulo comunica o seu estado a cada 60 segundos ('reporting'), pelo que um comando só é confirmado na comunicação seguinte. Ativar 'livestatus' nas definições Extra do módulo faz com que comunique de imediato.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "As unidades comunicam apenas contadores acumulados. O adaptador deriva deles o consumo horário e diário (verbrauch.*), mantém os totais inalterados (status.*) e guarda as últimas 48 horas em JSON para o widget.",
+  "labelHistoryAnmelden": "Registar o consumo com o adaptador history",
+  "helpHistoryAnmelden": "Regista automaticamente os pontos de dados de consumo, para que os gráficos funcionem sem configurar cada ponto à mão.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/ru/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Адаптер запускает собственный MQTT-брокер. Направьте на него модули faikout — больше ничего не требуется.",
+  "labelPort": "Port",
+  "helpPort": "Порт, который слушает брокер. Должен отличаться от других MQTT-брокеров (например, адаптера mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Оставьте пустым, чтобы принимать подключения без аутентификации.",
+  "labelPass": "Password",
+  "helpPass": "Используется только при заданном имени пользователя.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Откройте веб-интерфейс модуля, перейдите в Settings, вкладка Basic, и укажите в «MQTT host» <IP ioBroker>:<порт выше>. Модуль переподключится сам.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "Порт брокера должен быть опубликован контейнером, иначе модули до него не достучатся. Добавьте проброс для порта, заданного выше.",
+  "headerLive": "Faster feedback",
+  "textLive": "По умолчанию модуль сообщает состояние каждые 60 секунд («reporting»), поэтому команда подтверждается лишь со следующим отчётом. Включение «livestatus» в разделе Extra настроек модуля включает мгновенную отправку.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Устройства сообщают только накопительные счётчики. Адаптер вычисляет из них почасовое и суточное потребление (verbrauch.*), оставляет итоги без изменений (status.*) и хранит последние 48 часов в JSON для виджета.",
+  "labelHistoryAnmelden": "Записывать потребление через адаптер history",
+  "helpHistoryAnmelden": "Автоматически включает запись точек данных потребления, чтобы графики работали без ручной настройки каждой точки.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/uk/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "Адаптер запускає власний MQTT-брокер. Спрямуйте на нього модулі faikout — більше нічого не потрібно.",
+  "labelPort": "Port",
+  "helpPort": "Порт, який слухає брокер. Має відрізнятися від інших MQTT-брокерів (наприклад, адаптера mqtt).",
+  "labelUser": "User name",
+  "helpUser": "Залиште порожнім, щоб приймати підключення без автентифікації.",
+  "labelPass": "Password",
+  "helpPass": "Використовується лише за наявності імені користувача.",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "Відкрийте вебінтерфейс модуля, перейдіть у Settings, вкладка Basic, і вкажіть у «MQTT host» <IP ioBroker>:<порт вище>. Модуль перепідключиться сам.",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "Порт брокера має бути опублікований контейнером, інакше модулі до нього не достукаються. Додайте проброс для порту, заданого вище.",
+  "headerLive": "Faster feedback",
+  "textLive": "Типово модуль повідомляє стан кожні 60 секунд («reporting»), тому команда підтверджується лише з наступним звітом. Увімкнення «livestatus» у розділі Extra налаштувань модуля вмикає миттєве надсилання.",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "Пристрої повідомляють лише накопичувальні лічильники. Адаптер обчислює з них погодинне та добове споживання (verbrauch.*), залишає підсумки без змін (status.*) і зберігає останні 48 годин у JSON для віджета.",
+  "labelHistoryAnmelden": "Записувати споживання через адаптер history",
+  "helpHistoryAnmelden": "Автоматично вмикає запис точок даних споживання, щоб графіки працювали без ручного налаштування кожної точки.",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/i18n/zh-cn/translations.json

@@ -0,0 +1,25 @@
+{
+  "tabBroker": "MQTT broker",
+  "tabHilfe": "Setup",
+  "headerBroker": "Own MQTT broker",
+  "textBroker": "本适配器自带 MQTT 代理。将 faikout 模块指向它即可，无需其他设置。",
+  "labelPort": "Port",
+  "helpPort": "代理监听的端口。必须与其他 MQTT 代理（例如 mqtt 适配器）不同。",
+  "labelUser": "User name",
+  "helpUser": "留空则接受无需认证的连接。",
+  "labelPass": "Password",
+  "helpPass": "仅在设置了用户名时使用。",
+  "headerSetup": "Setting up a faikout module",
+  "textSetup": "打开模块的网页界面，进入 Settings 的 Basic 选项卡，将 “MQTT host” 设为 <ioBroker IP>:<上面的端口>。模块会自行重新连接。",
+  "headerDocker": "Running ioBroker in Docker",
+  "textDocker": "容器必须发布代理端口，否则模块无法访问。请为上面配置的端口添加端口映射。",
+  "headerLive": "Faster feedback",
+  "textLive": "模块默认每 60 秒上报一次状态（reporting），因此指令要到下一次上报才被确认。在模块的 Extra 设置中启用 livestatus 可让其立即上报。",
+  "tabVerbrauch": "Consumption",
+  "headerVerbrauch": "Consumption history",
+  "textVerbrauch": "设备只上报累计计数。适配器由此推算每小时和每天的能耗（verbrauch.*），保持总计不变（status.*），并将最近 48 小时以 JSON 保存供控件使用。",
+  "labelHistoryAnmelden": "使用 history 适配器记录能耗",
+  "helpHistoryAnmelden": "自动将能耗数据点登记为记录对象，无需逐个手动配置即可生成图表。",
+  "labelHistoryInstanz": "History instance",
+  "helpHistoryInstanz": "Instance that stores the series."
+}

package/admin/jsonConfig.json

@@ -0,0 +1,187 @@
+{
+    "i18n": true,
+    "type": "tabs",
+    "items": {
+        "tabBroker": {
+            "type": "panel",
+            "label": "tabBroker",
+            "items": {
+                "hinweis": {
+                    "type": "header",
+                    "size": 4,
+                    "text": "headerBroker",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "erklaerung": {
+                    "type": "staticText",
+                    "text": "textBroker",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "port": {
+                    "type": "number",
+                    "label": "labelPort",
+                    "help": "helpPort",
+                    "min": 1,
+                    "max": 65535,
+                    "default": 1888,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "_leer": {
+                    "type": "staticText",
+                    "text": "",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 6,
+                    "xl": 6
+                },
+                "user": {
+                    "type": "text",
+                    "label": "labelUser",
+                    "help": "helpUser",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                },
+                "pass": {
+                    "type": "password",
+                    "label": "labelPass",
+                    "help": "helpPass",
+                    "hidden": "!data.user",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 6,
+                    "lg": 4,
+                    "xl": 4
+                }
+            }
+        },
+        "tabVerbrauch": {
+            "type": "panel",
+            "label": "tabVerbrauch",
+            "items": {
+                "hVerbrauch": {
+                    "type": "header",
+                    "size": 4,
+                    "text": "headerVerbrauch",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "tVerbrauch": {
+                    "type": "staticText",
+                    "text": "textVerbrauch",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "historyAnmelden": {
+                    "type": "checkbox",
+                    "label": "labelHistoryAnmelden",
+                    "help": "helpHistoryAnmelden",
+                    "default": true,
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 6,
+                    "xl": 6
+                },
+                "historyInstanz": {
+                    "type": "instance",
+                    "adapter": "history",
+                    "hidden": "!data.historyAnmelden",
+                    "allowDeactivate": false,
+                    "label": "labelHistoryInstanz",
+                    "help": "helpHistoryInstanz",
+                    "default": "history.0",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 6,
+                    "xl": 6
+                }
+            }
+        },
+        "tabHilfe": {
+            "type": "panel",
+            "label": "tabHilfe",
+            "items": {
+                "h1": {
+                    "type": "header",
+                    "size": 4,
+                    "text": "headerSetup",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "t1": {
+                    "type": "staticText",
+                    "text": "textSetup",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "h2": {
+                    "type": "header",
+                    "size": 5,
+                    "text": "headerDocker",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "t2": {
+                    "type": "staticText",
+                    "text": "textDocker",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "h3": {
+                    "type": "header",
+                    "size": 5,
+                    "text": "headerLive",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                },
+                "t3": {
+                    "type": "staticText",
+                    "text": "textLive",
+                    "xs": 12,
+                    "sm": 12,
+                    "md": 12,
+                    "lg": 12,
+                    "xl": 12
+                }
+            }
+        }
+    }
+}