iobroker.e3oncan 1.1.3 → 1.2.0

package/README.de.md

@@ -19,12 +19,11 @@
 ## Inhaltsverzeichnis
 
 - [Übersicht](#übersicht)
-- [Was ist neu in v1.1.0](#was-ist-neu-in-v110)
-- [Was ist neu in v1.0.3](#was-ist-neu-in-v103)
-- [Was ist neu in v1.0.0](#was-ist-neu-in-v100)
+- [Was ist neu in v1.2.0](#was-ist-neu-in-v120)
 - [Schnellstart](#schnellstart)
 - [Konfigurationsanleitung](#konfigurationsanleitung)
   - [Schritt 1 – CAN-Adapter](#schritt-1--can-adapter)
+  - [Alternative: open3e-esp32-Gateway](#alternative-open3e-esp32-gateway)
   - [Schritt 2 – Gerätescan und Energiezähler-Erkennung](#schritt-2--gerätescan-und-energiezähler-erkennung)
   - [Schritt 3 – Datenpunktscan](#schritt-3--datenpunktscan)
   - [Schritt 4 – Zuweisungen und Zeitpläne](#schritt-4--zuweisungen-und-zeitpläne)
@@ -32,6 +31,7 @@
 - [e3oncan Datenpunkte-Seite](#e3oncan-datenpunkte-seite)
 - [Datenpunkte lesen](#datenpunkte-lesen)
 - [Datenpunkte schreiben](#datenpunkte-schreiben)
+- [Rohschnittstelle des Gateways](#rohschnittstelle-des-gateways)
 - [Datenpunkte und Metadaten](#datenpunkte-und-metadaten)
 - [Energiezähler](#energiezähler)
   - [E380 – Daten und Einheiten](#e380--daten-und-einheiten)
@@ -60,76 +60,19 @@ Welche Modi verfügbar sind, hängt von der Gerätekonfiguration ab. Weitere Det
 
 ---
 
-## Was ist neu in v1.1.1
+## Was ist neu in v1.2.0
 
-### Aktualisierte Datenpunkt-Definitionen
+### Nur ein ESP32 am CAN-Bus, alles über TCP/IP
 
-Die Datenpunktdefinitionen wurden auf Version 20260705 (allgemein) und 20260630 (Varianten) aktualisiert.
+Mit dem [open3e-esp32](https://github.com/boonkerz/open3e-esp32)-Gateway genügt am Viessmann-CAN-Bus ein ESP32 mit CAN-Transceiver. Der ioBroker-Rechner braucht keinen CAN-Adapter: Er kommuniziert vollständig über TCP/IP mit dem Gateway, über dessen REST-API (UDS-Lesen und -Schreiben) und einen MQTT-Broker (passiv empfangene Frames). Die Funktionalität des Adapters bleibt dieselbe: Geräte- und Datenpunktscan, Collect, Energiezähler, Zeitpläne und Schreibzugriffe. Schreibzugriffe setzen zusätzlich voraus, dass *Rohes Schreiben freigeben* im Gateway aktiviert ist. Lokale CAN-Adapter funktionieren unverändert weiter. Die Einrichtung ist unter [Alternative: open3e-esp32-Gateway](#alternative-open3e-esp32-gateway) beschrieben.
 
-### Neuer Codec O3ESwitch
+### Rohschnittstelle für eigene Decoder
 
-Ein neuer Codec `O3ESwitch` wurde für Datenpunkte ergänzt, deren Struktur von einem gerätespezifischen Diskriminator-Byte abhängt. Das erste Byte wählt die aktive Variante aus einem Satz vordefinierter Codec-Zweige. Damit wird die vollständig strukturierte Dekodierung der ZigBee-Geräteslot-DIDs (2086–2143, 2262) ermöglicht, bei denen die dekodierten Felder je nach Gerätetyp unterschiedlich sind (z. B. Klimasensor, Heizkörperthermostat, Fußbodenheizungsthermostat, Stellantrieb).
+Das Gateway stellt rohe UDS-Daten und rohe CAN-Frames für Software bereit, die sie selbst dekodiert. Im Gateway-Betrieb nutzt der Adapter diesen Weg; die Bedeutung der Bytes bleibt beim eigenen Codec von ioBroker. Siehe [Rohschnittstelle des Gateways](#rohschnittstelle-des-gateways).
 
-### Dezimalrundung für numerische Codecs
+### Gateway-Zustand und Selbstheilung
 
-Numerische Codecs (`O3EInt8`, `O3EInt16`, `O3EInt32`, `O3EInt64`, `O3EFloat32`) unterstützen jetzt einen optionalen Parameter `decimals`. Ist dieser größer als 0, wird das Dekodierergebnis auf die angegebene Anzahl Nachkommastellen gerundet. Beispielsweise wird `SignalLevel` (Skalierung 2,55, Dezimalstellen 2) damit ohne übermäßig lange Gleitkommazahlen ausgegeben.
-
-### Einheiten und Metadaten werden beim Start nach Strukturänderungen gesetzt
-
-Erkennt der Adapter beim Start, dass sich die Struktur eines Datenpunkts geändert hat (neue Version in `didsE3var.json` oder `didsE3.json`), werden Einheiten und Beschreibungen für alle Unterzustände des neu angelegten Tree-Abschnitts jetzt korrekt gesetzt. Bisher wurden Einheiten nur beim Datenpunktscan gesetzt; nach einer Strukturaktualisierung war ein erneuter Scan erforderlich, um sie zu befüllen.
-
----
-
-## Was ist neu in v1.0.3
-
-### Kein Rebuild mehr nach einem Node.js-Upgrade
-
-Das native CAN-Modul `socketcan` wurde auf Version 4.2.1 aktualisiert und verwendet jetzt die stabile **N-API**-Schnittstelle. Das Modul muss nach einem Wechsel der Node.js-Version nicht mehr neu kompiliert werden. Ein Upgrade von Node.js (z. B. von 22 auf 24) erfordert keinen `iob rebuild`-Schritt mehr — der Adapter startet ohne weitere Maßnahmen.
-
-### Filter für geplante Datenpunkte in der Datenpunkte-Seite
-
-Ein Klick auf das grüne Badge mit der Anzahl geplanter Datenpunkte auf einer Gerätekarte **filtert die Karte auf die geplanten Datenpunkte**. So lassen sich Zeitpläne für ein bestimmtes Gerät schnell prüfen und anpassen. Ein weiterer Klick auf das Badge oder auf den Kartenkopf stellt die vollständige Ansicht wieder her.
-
-### Schutz benutzerdefinierter Variantendatenpunkt-Definitionen
-
-Benutzerdefinierte Strukturen in `e3oncan.0.<GERÄT>.info.udsDidsSpecific` können jetzt durch das Setzen von `"protected": true` **vor automatischen Updates geschützt** werden. Ein optionales Feld `"reason"` wird in das Log geschrieben, wenn der Schutz greift. Ohne Schutz werden Variantendatenpunkte (die auch in `didsE3var.json` enthalten sind) weiterhin automatisch auf neuere Definitionen aktualisiert. Details stehen in der [Dokumentation](lib/data-points.md#user-defined-data-point-structures-in-udsdidsspecific).
-
-### Aktualisierte Datenpunkt-Definitionen
-
-Die Datenpunktdefinitionen wurden auf Version 20260528 (allgemein) und 20260527 (Varianten) aktualisiert. Highlights:
-- ZigBee-DIDs 2084–2319 vollständig strukturiert (Geräteeigenschaften, aktuelle Werte in 57- und 68-Byte-Varianten)
-- Raum-DIDs 1884–1943 strukturiert (Name, Typ, Temperaturregelung, Fenstererkennung, Min/Max-Luftfeuchte)
-- Neue ViGuide-basierte DID-Strukturen für Brennstoffzellenmetriken, Energiedeckung und Batterie-/Wechselrichter-Abonnements
-- `Unknown*`-Felder verwenden jetzt einheitlich `RawCodec`
-
----
-
-## Was ist neu in v1.0.0
-
-### Datenpunkte-Seite
-
-Eine neue **e3oncan Datenpunkte**-Seite ist direkt in der Instanzzeile des Adapters in der ioBroker-Instanzansicht verankert. Klicke auf die Schaltfläche <img src="admin/icon_open_tab.svg" height="20"> in der Instanzzeile, um sie zu öffnen. Sie bietet eine dedizierte Oberfläche zum Verwalten von Zeitplänen und Collect-Einstellungen je Gerät und Datenpunkt — ohne dass der vollständige Adapterkonfigurationsdialog geöffnet werden muss.
-
-### Automatische Erkennung von Energiezählern
-
-Energiezähler (E380 und E3100CB) werden jetzt während des Gerätescans **automatisch erkannt**, indem passiv auf beiden CAN-Kanälen gelauscht wird. Die State-Namen werden anhand der erkannten CAN-Adresse und des Kanals automatisch vergeben. Der Aktiv/Inaktiv-Schalter und die Collect-Verzögerung für jeden Energiezähler werden ausschließlich in der Datenpunkte-Seite konfiguriert.
-
-Beim ersten Start nach einem Upgrade von einer früheren Version wird die bisherige Energiezähler-Konfiguration automatisch migriert.
-
-### Automatische Erkennung von Collect-fähigen Geräten
-
-Während des Datenpunktscans lauscht der Adapter passiv auf dem CAN-Bus, um zu erkennen, welche Geräte den Collect-Modus unterstützen. Erkannte Geräte werden mit einem Pin-Symbol im Gerätekarten-Header der Datenpunkte-Seite hervorgehoben.
-
-### Flexibler Datenpunktscan
-
-Eine neue Option **Datenpunktwerte während des Scans im Objektbaum speichern** steuert, ob die aktuellen Werte während des Scans in den Objektbaum geschrieben werden. Wenn diese Option deaktiviert ist, aktualisiert der Adapter Werte und Metadaten für bereits vorhandene Datenpunkt-Objekte, erstellt aber keine neuen — diese werden automatisch angelegt, wenn nach dem Scan erstmals Daten empfangen werden.
-
-### Bus-Topologie-Analyse
-
-Nach dem Datenpunktscan wertet der Adapter automatisch alle während des Scans gesammelten Topologie-Daten aus und erzeugt eine Zusammenfassung. Das Ergebnis wird in zwei neuen States im `info`-Kanal gespeichert:
-
-- `info.topology` – strukturiertes JSON mit allen gefundenen UDS-zugänglichen Geräten und Topologie-Elementen (dedupliziert über alle Topologie-Matrizen).
-- `info.topologyHtml` – eine fertig gerenderte HTML-Tabelle, farbkodiert nach Bus-Typ (CanInternal, CanExternal, CanRaw, ModBus, ServiceBus), mit UDS-Badge für Geräte, die auch über UDS erreichbar sind. Geeignet zur Anzeige in vis, jarvis oder einem beliebigen HTML-Widget.
+Der Verbindungszustand folgt dem eigenen Zustand des Gateways. Wird das Gateway unhealthy, zeigt das Log, ob der Broker oder der CAN-Bus die Ursache ist, und die Verbindung wird als getrennt markiert. Meldet sich das Gateway wieder gesund, startet sich der Adapter neu, um die Verbindung wiederherzustellen.
 
 ---
 
@@ -170,6 +113,24 @@ Die detaillierten Schritte sind in der [Konfigurationsanleitung](#konfigurations
 
 Falls ein zweiter CAN-Bus vorhanden ist (z. B. interner Bus), kann er hier als zweiter Adapter konfiguriert werden. Ein zweiter **Zuweisungen**-Tab erscheint, sobald der zweite Adapter konfiguriert ist.
 
+### Alternative: open3e-esp32-Gateway
+
+Statt eines lokalen CAN-Adapters kann ein Bus über ein [open3e-esp32](https://github.com/boonkerz/open3e-esp32)-Gateway gelesen werden. Stellen Sie für diesen Bus **Verbindungsart** auf *open3e-esp32-Gateway* und tragen Sie ein:
+
+- **Gateway-REST-URL**, z. B. `http://open3e-esp32.local`
+- **Gateway-MQTT-Broker-URL**, z. B. `mqtt://broker.local`, und das **MQTT-Basis-Topic**. Das Basis-Topic muss mit der Einstellung `mqtt.baseTopic` des Gateways übereinstimmen (Standard `open3e`).
+- **MQTT-Benutzername und -Passwort**, falls der Broker sie verlangt.
+
+Bei jedem Start teilt der Adapter dem Gateway mit, welche CAN-IDs roh weitergeleitet werden sollen. Die Liste ergibt sich aus den Energiezählern und den Collect-IDs Ihrer Geräte, Sie müssen sie daher nicht auf dem Gateway konfigurieren.
+
+Das Gateway braucht open3e-esp32 in Version 0.2.0 oder neuer. Diese Version stellt die Raw-API Version 1 bereit, die der Adapter erwartet. Der Adapter protokolliert beim Start die gefundene Firmware-Version.
+
+Regeln im Gateway-Betrieb:
+
+- **Die eigene Datenpunktauswahl des Gateways (Datenpunkte-Seite) ist unabhängig von der in ioBroker.** Konfigurieren Sie die zu lesenden Datenpunkte und ihre Zeitpläne wie gewohnt in ioBroker; open3e-esp32 fragt parallel dazu seine eigene Auswahl ab und veröffentlicht sie auf seinen eigenen dekodierten MQTT-Topics, ohne dass sich beide Wege in die Quere kommen. Die einzige Einstellung, die der Adapter auf dem Gateway selbst verwaltet, ist die Liste der weitergeleiteten rohen CAN-IDs (siehe oben): Eine händische Änderung in der Web-Oberfläche des Gateways gilt nur bis zum nächsten Neustart des Adapters.
+- **Schreibzugriffe auf Datenpunkte erfordern *Rohes Schreiben freigeben* im Gateway.** Im Gateway-Betrieb laufen alle Schreibzugriffe über den rohen Schreibpfad des Gateways. Aktivieren Sie **Rohes Schreiben freigeben** im Gateway unter **Einstellungen → Bus**, neben *Schreiben freigeben*. Der Adapter setzt diesen Schalter nie selbst, weil er die Datenpunktprüfungen von open3e umgeht.
+- **Auf einem Bus darf nur ein Master senden.** Betreiben Sie keine weitere open3e-Instanz, etwa auf einem Raspberry Pi, am selben Bus.
+
 ### Schritt 2 – Gerätescan und Energiezähler-Erkennung
 
 Zum Tab **Liste der UDS-Geräte** wechseln und **Scan** drücken.
@@ -320,6 +281,15 @@ Einige Datenpunkte können auch nach der Aufnahme in die Whitelist nicht geände
 
 ---
 
+## Rohschnittstelle des Gateways
+
+Das open3e-esp32-Gateway bietet zwei rohe Wege für Software, die CAN-Daten selbst dekodiert:
+
+- **REST:** `GET /api/rawread` liefert die unveränderten UDS-Antwortbytes für bis zu 10 Datenpunkt-IDs pro Anfrage. `POST /api/rawwrite` sendet rohe Wertbytes mit Dienst `0x2E`, und nur bei aktiviertem *Rohes Schreiben freigeben* im Gateway.
+- **MQTT:** CAN-IDs aus der Einstellung `rawCanIds` des Gateways werden unverändert auf `<Basis-Topic>/raw/<ID-hex>` veröffentlicht, z. B. als `{"dlc": 8, "data": "21fa01b3...", "ts": 1725455669123}`.
+
+Keiner der beiden Wege verwendet den open3e-Codec oder die Datenpunkt-Datenbank, auf dem Gateway wird also nichts dekodiert oder geprüft. Im Gateway-Betrieb nutzt ioBroker.e3oncan diese Schnittstelle, und der eigene Codec entscheidet, was die Bytes bedeuten. Protokolldetails und die Scan-Endpunkte stehen in [docs/raw-gateway-api.md](docs/raw-gateway-api.md).
+
 ## Datenpunkte und Metadaten
 
 Ausführliche Informationen zur Struktur der Datenpunkte, zur Funktionsweise von Varianten-Datenpunkten und Metadaten sowie zur Handhabung von Temperatur-, Datums- und Zeitformaten sind in [data-points.md](lib/data-points.md) (englisch) zu finden.

package/README.md

@@ -19,13 +19,11 @@
 ## Table of contents
 
 - [Overview](#overview)
-- [What's new in v1.1.0](#whats-new-in-v110)
-- [What's new in v1.0.3](#whats-new-in-v103)
-- [What's new in v1.0.0](#whats-new-in-v100)
-- [What's new in v0.11.x](#whats-new-in-v011x)
+- [What's new in v1.2.0](#whats-new-in-v120)
 - [Quick start](#quick-start)
 - [Configuration guide](#configuration-guide)
   - [Step 1 – CAN adapter](#step-1--can-adapter)
+  - [Alternative: open3e-esp32 gateway](#alternative-open3e-esp32-gateway)
   - [Step 2 – Device scan and energy meter detection](#step-2--device-scan-and-energy-meter-detection)
   - [Step 3 – Data point scan](#step-3--data-point-scan)
   - [Step 4 – Assignments and schedules](#step-4--assignments-and-schedules)
@@ -33,6 +31,7 @@
 - [e3oncan datapoints tab](#e3oncan-datapoints-tab)
 - [Reading data points](#reading-data-points)
 - [Writing data points](#writing-data-points)
+- [Raw interface of the gateway](#raw-interface-of-the-gateway)
 - [Data points and metadata](#data-points-and-metadata)
 - [Energy meters](#energy-meters)
   - [E380 data and units](#e380-data-and-units)
@@ -61,76 +60,19 @@ Which modes are available depends on your device topology. See the [device topol
 
 ---
 
-## What's new in v1.1.1
+## What's new in v1.2.0
 
-### Updated data point definitions
+### Only an ESP32 on the CAN bus, everything over TCP/IP
 
-Data point definitions have been updated to version 20260705 (common) and 20260630 (variant).
+With the [open3e-esp32](https://github.com/boonkerz/open3e-esp32) gateway, the Viessmann CAN bus needs only an ESP32 with a CAN transceiver. The ioBroker host needs no CAN adapter: it communicates with the gateway completely over TCP/IP, through the gateway's REST API (UDS reads and writes) and an MQTT broker (passively received frames). The adapter's functionality stays the same: device and data point scan, Collect, energy meters, schedules and writes. Writes additionally require *Raw write* to be enabled on the gateway. Local CAN adapters keep working unchanged. Setup is described in [Alternative: open3e-esp32 gateway](#alternative-open3e-esp32-gateway).
 
-### New O3ESwitch codec
+### Raw interface for external decoders
 
-A new codec `O3ESwitch` has been added for data points whose structure depends on a device type discriminator byte. The first byte selects the active variant from a set of predefined codec branches. This enables full structured decoding of ZigBee device slot DIDs (2086–2143, 2262), where the decoded fields differ by device type (e.g. climate sensor, TRV, floor thermostat, actuator).
+The gateway exposes raw UDS data and raw CAN frames for software that decodes them on its own. In gateway mode the adapter uses this path; the meaning of the bytes stays with ioBroker's own codec. See [Raw interface of the gateway](#raw-interface-of-the-gateway).
 
-### Decimal rounding for numeric codecs
+### Gateway health and self-healing
 
-Numeric codecs (`O3EInt8`, `O3EInt16`, `O3EInt32`, `O3EInt64`, `O3EFloat32`) now support an optional `decimals` parameter. When set to a value greater than 0, the decoded result is rounded to that number of decimal places. This is used, for example, for `SignalLevel` (scale 2.55, decimals 2) to avoid excessively long floating-point values.
-
-### Units and metadata set at startup when data point structure changes
-
-When the adapter detects at startup that a data point's structure has changed (new version in `didsE3var.json` or `didsE3.json`), it now correctly registers units and descriptions for all sub-states of the rebuilt tree. Previously, units were only set during a data point scan; a subsequent scan was required to populate them after a structure update.
-
----
-
-## What's new in v1.0.3
-
-### No more rebuild after a Node.js upgrade
-
-The native CAN module `socketcan` has been updated to version 4.2.1, which uses the stable **N-API** interface. The module no longer needs to be recompiled when the Node.js version changes. Upgrading Node.js (e.g. from 22 to 24) no longer requires running `iob rebuild` afterwards — the adapter starts without any additional steps.
-
-### Scheduled data point filter in the datapoints tab
-
-Clicking the green badge that shows the number of scheduled data points on a device card now **filters the card to show only scheduled data points**. This makes it easy to review or adjust scheduling for a specific device. Clicking the badge again or the card header restores the full view.
-
-### Protecting custom variant data point definitions
-
-User-defined structures in `e3oncan.0.<DEVICE>.info.udsDidsSpecific` can now be **protected from automatic updates** by adding `"protected": true` to the entry. An optional `"reason"` field is logged whenever the protection takes effect. Without protection, variant data point definitions (those also listed in `didsE3var.json`) are updated automatically when a newer definition is available — this behaviour is unchanged. See the [documentation](lib/data-points.md#user-defined-data-point-structures-in-udsdidsspecific) for details.
-
-### Updated data point definitions
-
-Data point definitions have been updated to version 20260528 (common) and 20260527 (variant). Highlights:
-- ZigBee DIDs 2084–2319 fully structured (device properties, current values in 57-byte and 68-byte variants)
-- Room DIDs 1884–1943 structured (name, type, temperature control, window detection, min/max humidity)
-- New ViGuide-derived DID structures for fuel cell metrics, energy coverage, and battery/inverter subscriptions
-- `Unknown*` fields now consistently use `RawCodec`
-
----
-
-## What's new in v1.0.0
-
-### Datapoints tab
-
-A new **e3oncan datapoints** page is pinned directly to the adapter's instance row in the ioBroker instances view. Click the <img src="admin/icon_open_tab.svg" height="20"> button in the instance row to open it. It provides a dedicated UI for managing schedules and Collect settings per device and data point — no need to open the full adapter configuration dialog for day-to-day changes.
-
-### Auto-detection of energy meters
-
-Energy meters (E380 and E3100CB) are now **automatically detected** during the device scan by passive CAN listening on both CAN channels. State names are assigned automatically based on the detected CAN address and channel. The active/inactive toggle and the collect delay for each energy meter are configured exclusively in the datapoints tab.
-
-On first start after an upgrade from an earlier version, the previous energy meter configuration is migrated automatically.
-
-### Auto-detection of Collect-capable devices
-
-During the data point scan, the adapter now passively listens on the CAN bus to detect which devices support Collect mode. Detected devices are highlighted with a pin icon in the device card header of the datapoints tab.
-
-### Flexible data point scan
-
-A new option **Save data point values to object tree during scan** controls whether the current values are written to the object tree during the scan. When disabled, the adapter still updates values and metadata for all existing data point objects — only new objects are not created during the scan. This is useful to refresh metadata after a migration without rewriting all state values.
-
-### Bus topology analysis
-
-After the data point scan, the adapter automatically analyses the bus topology data collected during the scan and generates a summary. The result is stored in two new states in the `info` channel:
-
-- `info.topology` – structured JSON with all discovered UDS-accessible devices and topology elements (deduplicated across all topology matrices).
-- `info.topologyHtml` – a rendered HTML table, color-coded by bus type (CanInternal, CanExternal, CanRaw, ModBus, ServiceBus), with a UDS badge on devices that are also accessible via UDS. Ready for display in vis, jarvis, or any HTML-capable widget.
+The connection state follows the gateway's own health. If the gateway becomes unhealthy, the log says whether the broker or the CAN bus is at fault, and the connection is marked as down. When the gateway recovers, the adapter restarts itself to reconnect.
 
 ---
 
@@ -169,6 +111,24 @@ Open the adapter configuration dialog and go to the **CAN Adapter** tab.
 
 If you have a second CAN bus (e.g. internal bus), configure it as the second adapter here. A second **Assignments** tab will appear once the second adapter is configured.
 
+### Alternative: open3e-esp32 gateway
+
+Instead of a local CAN adapter, a bus can be read through an [open3e-esp32](https://github.com/boonkerz/open3e-esp32) gateway. Set **Connection type** to *open3e-esp32 gateway* for that bus and fill in:
+
+- **Gateway REST URL**, e.g. `http://open3e-esp32.local`
+- **Gateway MQTT broker URL**, e.g. `mqtt://broker.local`, and the **MQTT base topic**. The base topic must match the gateway's own `mqtt.baseTopic` setting (default `open3e`).
+- **MQTT username and password**, if the broker needs them.
+
+On every start the adapter tells the gateway which CAN IDs to relay raw. The list is derived from the energy meters and the Collect IDs of your devices, so you don't configure it on the gateway.
+
+The gateway needs open3e-esp32 version 0.2.0 or newer. That version provides the raw API version 1 this adapter expects, and the adapter logs the firmware version it finds at each start.
+
+Rules for gateway mode:
+
+- **The gateway's own data point selection (Datenpunkte tab) is independent of ioBroker's.** Configure the data points to read and their schedules in ioBroker as usual; open3e-esp32 polls and publishes its own selection to its own decoded MQTT topics at the same time, and the two don't interfere. The one setting the adapter does manage on the gateway is the relayed raw CAN ID list (see above): a change made there by hand in the gateway's web UI stays only until the next adapter restart.
+- **Writing data points requires Rohes Schreiben on the gateway.** In gateway mode every write goes through the gateway's raw write path. Enable **Rohes Schreiben freigeben** under the gateway's **Settings → Bus** tab, next to *Schreiben freigeben*. The adapter never sets this switch itself, because it bypasses the open3e data point checks.
+- **Only one master may talk on a bus.** Don't run another open3e instance, for example on a Raspberry Pi, on the same bus.
+
 ### Step 2 – Device scan and energy meter detection
 
 Go to the **List of UDS Devices** tab and press the **Scan** button.
@@ -201,6 +161,8 @@ What the scan does:
 
 This step is not strictly mandatory for read-only use, but it is **strongly recommended** – and **required** if you want to write to any data point.
 
+> **Restart after the scan if you plan to write.** A data point newly discovered by this scan is recorded on disk right away, but the running adapter instance keeps using the data point dictionary it loaded at startup until it restarts. Writing to a data point the scan *just* found will fail with an "Encoding of data failed" error until you restart the adapter once. Data points that were already known before the scan are unaffected.
+
 **Save data point values to object tree during scan**
 
 By default the scan also writes the current value of each data point into the object tree (`json`, `raw`, `tree` states). You can adjust the behavior using the option **Save data point values ​​in the object tree during scan** above the scan button. If this option is disabled, the adapter updates values and metadata for already existing data point objects, but does not create new ones – those are created automatically the first time data is received after the scan.
@@ -319,6 +281,15 @@ Some data points cannot be changed even if whitelisted – the device will retur
 
 ---
 
+## Raw interface of the gateway
+
+The open3e-esp32 gateway offers two raw paths for software that decodes CAN data on its own:
+
+- **REST:** `GET /api/rawread` returns the unmodified UDS response bytes for up to 10 data point IDs per request. `POST /api/rawwrite` sends raw value bytes with service `0x2E`, and only while *Rohes Schreiben freigeben* is enabled on the gateway.
+- **MQTT:** CAN IDs listed in the gateway's `rawCanIds` setting are published unchanged to `<base topic>/raw/<id-hex>`, as `{"dlc": 8, "data": "21fa01b3...", "ts": 1725455669123}`.
+
+Neither path uses the open3e codec or the data point database, so nothing is decoded or validated on the gateway. In gateway mode, ioBroker.e3oncan uses this interface, and its own codec decides what the bytes mean. Protocol details and the scan endpoints are in [docs/raw-gateway-api.md](docs/raw-gateway-api.md).
+
 ## Data points and metadata
 
 For detailed information about how data points are structured, how variant data points and metadata work, and how temperature/date/time formats are handled, please refer to [data-points.md](lib/data-points.md).
@@ -427,6 +398,15 @@ If you enjoyed this project — or just feeling generous, consider buying me a b
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 1.2.0 (2026-10-15)
+* (MyHomeMyData) Added open3e-esp32 gateway as optional connection type per CAN bus (REST for UDS, MQTT for passively received frames)
+* (MyHomeMyData) Gateway: device and data point scan run on the gateway's scan engine, with progress in the log
+* (MyHomeMyData) Gateway: energy meters and Collect devices are detected as on a local bus
+* (MyHomeMyData) Gateway: relayed CAN IDs are configured automatically on each start
+* (MyHomeMyData) Gateway: connection state follows the gateway's health; the adapter restarts itself when the gateway recovers
+* (MyHomeMyData) Requires Node.js 22.22.2 or newer, or Node.js 24.15 or newer. The adapter is tested with Node.js 22, 24 and 26
+* (MyHomeMyData) Fixed the connection state after a reconnect during the device scan: a local CAN bus that stops afterwards is now reported and sets the connection state to disconnected
+
 ### 1.1.3 (2026-09-11)
 * (MyHomeMyData) Fixed CAN connection dropping unexpectedly and never recovering on a healthy bus (updated `socketcan` to 4.3.1, which stops treating a recoverable socket error the same as a real disconnect). Refer to issue #255.
 
@@ -443,12 +423,6 @@ If you enjoyed this project — or just feeling generous, consider buying me a b
 * (MyHomeMyData) Added optional `decimals` parameter to numeric codecs to round decoded values
 * (MyHomeMyData) Added update of meta data during startup, when structure of data point has changed
 
-### 1.0.3 (2026-06-02)
-* (MyHomeMyData) Update of list of data points for E3 devices to version 20260528 for common and 20260527 for variant data points; For details see this [changelog](lib/data-points.md#changelog-of-data-point-definitions)
-* (MyHomeMyData) Suppress spurious variant-did warning when common dict covers the length
-* (MyHomeMyData) User-defined variant data point structures in `udsDidsSpecific` can now be protected from automatic updates by adding `"protected": true` (and an optional `"reason"` text) to the entry; see [documentation](lib/data-points.md#user-defined-data-point-structures-in-udsdidsspecific)
-* (MyHomeMyData) Updated socketcan dependency to 4.2.1 (N-API) — the native CAN module no longer needs to be rebuilt after a Node.js upgrade
-
 ### Older versions
 
 Older changelog entries are available in [CHANGELOG_OLD.md](CHANGELOG_OLD.md).

package/admin/i18n/de.json

@@ -88,5 +88,21 @@
     "active": "aktiv",
     "n/a": "n/a",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Konfigurieren und verwalten Sie nach dem Scan die erkannten Datenpunkte mithilfe der „Datenpunktseite“, die über die Link-Schaltfläche in der Instanzzeile des Adapters zugänglich ist.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativ können Sie innerhalb dieses Konfigurationsdialogs den Reiter „Zuordnungen zum UDS CAN-Adapter“ nutzen."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativ können Sie innerhalb dieses Konfigurationsdialogs den Reiter „Zuordnungen zum UDS CAN-Adapter“ nutzen.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "Basis-URL der REST-API des open3e-esp32-Gateways, z. B. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "Basis-URL der REST-API des open3e-esp32-Gateways, z. B. http://open3e-esp32.local",
+    "Connection type": "Verbindungsart",
+    "Energy meters on CAN bus": "Energiezähler am CAN-Bus",
+    "Gateway MQTT broker URL": "MQTT-Broker-URL des Gateways",
+    "Gateway REST URL": "REST-URL des Gateways",
+    "Local CAN interface": "Lokale CAN-Schnittstelle",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Lokale CAN-Schnittstelle oder ein über das Netzwerk erreichbares open3e-esp32-Gateway.",
+    "MQTT base topic": "MQTT-Basis-Topic",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "MQTT-Broker-URL, an den das Gateway Rohframes und Status sendet, z. B. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "MQTT-Broker-URL, an den das Gateway Rohframes und Status sendet, z. B. mqtt://open3e-esp32.local",
+    "MQTT password": "MQTT-Passwort",
+    "MQTT username": "MQTT-Benutzername",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Muss mit der Einstellung mqtt.baseTopic des Gateways übereinstimmen (siehe /api/settings), nicht zwingend mit dem Standard der Firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "Das Symbol „.“ ist im „Geräte State-Name“ nicht erlaubt!",
+    "open3e-esp32 gateway": "open3e-esp32-Gateway"
 }

package/admin/i18n/en.json

@@ -88,5 +88,21 @@
     "active": "active",
     "n/a": "n/a",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local",
+    "Connection type": "Connection type",
+    "Energy meters on CAN bus": "Energy meters on CAN bus",
+    "Gateway MQTT broker URL": "Gateway MQTT broker URL",
+    "Gateway REST URL": "Gateway REST URL",
+    "Local CAN interface": "Local CAN interface",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Local CAN interface, or an open3e-esp32 gateway reached over the network.",
+    "MQTT base topic": "MQTT base topic",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local",
+    "MQTT password": "MQTT password",
+    "MQTT username": "MQTT username",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.",
+    "Symbol '.' not allowed in 'Device state name'!": "Symbol '.' not allowed in 'Device state name'!",
+    "open3e-esp32 gateway": "open3e-esp32 gateway"
 }

package/admin/i18n/es.json

@@ -88,5 +88,21 @@
     "active": "activo",
     "n/a": "n / A",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Después del análisis, explore y administre los puntos de datos descubiertos utilizando la 'página de puntos de datos', a la que se puede acceder mediante el botón de enlace en la fila de instancia del adaptador.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativamente, puede utilizar la pestaña 'Asignaciones al Adaptador UDS CAN' dentro de este diálogo de configuración."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativamente, puede utilizar la pestaña 'Asignaciones al Adaptador UDS CAN' dentro de este diálogo de configuración.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "URL base de la API REST de la pasarela open3e-esp32, p. ej. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "URL base de la API REST de la pasarela open3e-esp32, p. ej. http://open3e-esp32.local",
+    "Connection type": "Tipo de conexión",
+    "Energy meters on CAN bus": "Contadores de energía en el bus CAN",
+    "Gateway MQTT broker URL": "URL del broker MQTT de la pasarela",
+    "Gateway REST URL": "URL REST de la pasarela",
+    "Local CAN interface": "Interfaz CAN local",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Interfaz CAN local o una pasarela open3e-esp32 accesible por red.",
+    "MQTT base topic": "Topic base MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "URL del broker MQTT al que la pasarela publica tramas brutas y estado, p. ej. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "URL del broker MQTT al que la pasarela publica tramas brutas y estado, p. ej. mqtt://open3e-esp32.local",
+    "MQTT password": "Contraseña MQTT",
+    "MQTT username": "Usuario MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Debe coincidir con el ajuste mqtt.baseTopic de la pasarela (ver /api/settings), no necesariamente con el valor predeterminado del firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "El símbolo «.» no está permitido en el «Nombre de estado del dispositivo».",
+    "open3e-esp32 gateway": "Pasarela open3e-esp32"
 }

package/admin/i18n/fr.json

@@ -88,5 +88,21 @@
     "active": "actif",
     "n/a": "n / A",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Après l'analyse, parcourez et gérez les points de données découverts à l'aide de la « page des points de données », accessible via le bouton de lien dans la ligne d'instance de l'adaptateur.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Vous pouvez également utiliser l'onglet « Affectations à l'adaptateur CAN UDS » dans cette boîte de dialogue de configuration."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Vous pouvez également utiliser l'onglet « Affectations à l'adaptateur CAN UDS » dans cette boîte de dialogue de configuration.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "URL de base de l'API REST de la passerelle open3e-esp32, par ex. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "URL de base de l'API REST de la passerelle open3e-esp32, par ex. http://open3e-esp32.local",
+    "Connection type": "Type de connexion",
+    "Energy meters on CAN bus": "Compteurs d'énergie sur le bus CAN",
+    "Gateway MQTT broker URL": "URL du broker MQTT de la passerelle",
+    "Gateway REST URL": "URL REST de la passerelle",
+    "Local CAN interface": "Interface CAN locale",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Interface CAN locale ou passerelle open3e-esp32 joignable via le réseau.",
+    "MQTT base topic": "Topic de base MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "URL du broker MQTT vers lequel la passerelle publie les trames brutes et l'état, par ex. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "URL du broker MQTT vers lequel la passerelle publie les trames brutes et l'état, par ex. mqtt://open3e-esp32.local",
+    "MQTT password": "Mot de passe MQTT",
+    "MQTT username": "Nom d'utilisateur MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Doit correspondre au paramètre mqtt.baseTopic de la passerelle (voir /api/settings), pas forcément à la valeur par défaut du firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "Le symbole « . » n'est pas autorisé dans le « Nom d'état de l'appareil » !",
+    "open3e-esp32 gateway": "Passerelle open3e-esp32"
 }

package/admin/i18n/it.json

@@ -88,5 +88,21 @@
     "active": "attivo",
     "n/a": "n / a",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Dopo la scansione, sfoglia e gestisci i punti dati rilevati utilizzando la \"pagina dei punti dati\", accessibile tramite il pulsante di collegamento nella riga dell'istanza dell'adattatore.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► In alternativa è possibile utilizzare la scheda 'Assegnazioni all'adattatore CAN UDS' all'interno di questa finestra di configurazione."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► In alternativa è possibile utilizzare la scheda 'Assegnazioni all'adattatore CAN UDS' all'interno di questa finestra di configurazione.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "URL base dell'API REST del gateway open3e-esp32, es. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "URL base dell'API REST del gateway open3e-esp32, es. http://open3e-esp32.local",
+    "Connection type": "Tipo di connessione",
+    "Energy meters on CAN bus": "Contatori di energia sul bus CAN",
+    "Gateway MQTT broker URL": "URL del broker MQTT del gateway",
+    "Gateway REST URL": "URL REST del gateway",
+    "Local CAN interface": "Interfaccia CAN locale",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Interfaccia CAN locale oppure un gateway open3e-esp32 raggiungibile in rete.",
+    "MQTT base topic": "Topic di base MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "URL del broker MQTT a cui il gateway pubblica frame grezzi e stato, es. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "URL del broker MQTT a cui il gateway pubblica frame grezzi e stato, es. mqtt://open3e-esp32.local",
+    "MQTT password": "Password MQTT",
+    "MQTT username": "Nome utente MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Deve corrispondere all'impostazione mqtt.baseTopic del gateway (vedi /api/settings), non necessariamente al valore predefinito del firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "Il simbolo «.» non è consentito nel «Nome di stato del dispositivo»!",
+    "open3e-esp32 gateway": "Gateway open3e-esp32"
 }

package/admin/i18n/nl.json

@@ -88,5 +88,21 @@
     "active": "actief",
     "n/a": "n.v.t",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Blader en beheer na de scan de ontdekte datapunten met behulp van de 'datapuntenpagina', die toegankelijk is via de linkknop in de exemplaarrij van de adapter.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Als alternatief kunt u in dit configuratiedialoogvenster het tabblad 'Toewijzingen aan UDS CAN-adapter' gebruiken."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Als alternatief kunt u in dit configuratiedialoogvenster het tabblad 'Toewijzingen aan UDS CAN-adapter' gebruiken.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "Basis-URL van de REST-API van de open3e-esp32-gateway, bijv. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "Basis-URL van de REST-API van de open3e-esp32-gateway, bijv. http://open3e-esp32.local",
+    "Connection type": "Verbindingstype",
+    "Energy meters on CAN bus": "Energiemeters op de CAN-bus",
+    "Gateway MQTT broker URL": "MQTT-brokeradres van de gateway",
+    "Gateway REST URL": "REST-URL van de gateway",
+    "Local CAN interface": "Lokale CAN-interface",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Lokale CAN-interface of een via het netwerk bereikbare open3e-esp32-gateway.",
+    "MQTT base topic": "MQTT-basistopic",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "MQTT-brokeradres waarnaar de gateway ruwe frames en status publiceert, bijv. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "MQTT-brokeradres waarnaar de gateway ruwe frames en status publiceert, bijv. mqtt://open3e-esp32.local",
+    "MQTT password": "MQTT-wachtwoord",
+    "MQTT username": "MQTT-gebruikersnaam",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Moet overeenkomen met de instelling mqtt.baseTopic van de gateway (zie /api/settings), niet noodzakelijk met de standaardwaarde van de firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "Het symbool „.“ is niet toegestaan in „Apparaat-statusnaam“!",
+    "open3e-esp32 gateway": "open3e-esp32-gateway"
 }

package/admin/i18n/pl.json

@@ -88,5 +88,21 @@
     "active": "aktywny",
     "n/a": "nie dotyczy",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Po skanowaniu przeglądaj wykryte punkty danych i zarządzaj nimi za pomocą „strony punktów danych”, która jest dostępna za pośrednictwem przycisku łącza w wierszu instancji adaptera.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternatywnie możesz skorzystać z zakładki „Przypisania do adaptera UDS CAN” znajdującej się w tym oknie dialogowym konfiguracji."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternatywnie możesz skorzystać z zakładki „Przypisania do adaptera UDS CAN” znajdującej się w tym oknie dialogowym konfiguracji.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "Adres bazowy REST API bramy open3e-esp32, np. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "Adres bazowy REST API bramy open3e-esp32, np. http://open3e-esp32.local",
+    "Connection type": "Typ połączenia",
+    "Energy meters on CAN bus": "Liczniki energii na magistrali CAN",
+    "Gateway MQTT broker URL": "Adres brokera MQTT bramy",
+    "Gateway REST URL": "Adres REST bramy",
+    "Local CAN interface": "Lokalny interfejs CAN",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Lokalny interfejs CAN lub brama open3e-esp32 dostępna przez sieć.",
+    "MQTT base topic": "Temat bazowy MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "Adres brokera MQTT, na który brama publikuje surowe ramki i status, np. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "Adres brokera MQTT, na który brama publikuje surowe ramki i status, np. mqtt://open3e-esp32.local",
+    "MQTT password": "Hasło MQTT",
+    "MQTT username": "Nazwa użytkownika MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Musi odpowiadać ustawieniu mqtt.baseTopic bramy (patrz /api/settings), niekoniecznie wartości domyślnej firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "Znak „.” nie jest dozwolony w „Nazwie stanu urządzenia”!",
+    "open3e-esp32 gateway": "Brama open3e-esp32"
 }

package/admin/i18n/pt.json

@@ -88,5 +88,21 @@
     "active": "ativo",
     "n/a": "n / D",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► Após a varredura, navegue e gerencie os pontos de dados descobertos usando a 'página de pontos de dados', que pode ser acessada por meio do botão de link na linha da instância do adaptador.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativamente, você pode usar a guia 'Atribuições ao adaptador CAN UDS' nesta caixa de diálogo de configuração."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Alternativamente, você pode usar a guia 'Atribuições ao adaptador CAN UDS' nesta caixa de diálogo de configuração.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "URL base da API REST do gateway open3e-esp32, p. ex. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "URL base da API REST do gateway open3e-esp32, p. ex. http://open3e-esp32.local",
+    "Connection type": "Tipo de ligação",
+    "Energy meters on CAN bus": "Contadores de energia no barramento CAN",
+    "Gateway MQTT broker URL": "URL do broker MQTT do gateway",
+    "Gateway REST URL": "URL REST do gateway",
+    "Local CAN interface": "Interface CAN local",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Interface CAN local ou um gateway open3e-esp32 acessível pela rede.",
+    "MQTT base topic": "Tópico base MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "URL do broker MQTT para o qual o gateway publica tramas brutas e estado, p. ex. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "URL do broker MQTT para o qual o gateway publica tramas brutas e estado, p. ex. mqtt://open3e-esp32.local",
+    "MQTT password": "Palavra-passe MQTT",
+    "MQTT username": "Nome de utilizador MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Tem de corresponder à definição mqtt.baseTopic do gateway (ver /api/settings), não necessariamente ao valor predefinido do firmware.",
+    "Symbol '.' not allowed in 'Device state name'!": "O símbolo «.» não é permitido em «Nome de estado do dispositivo»!",
+    "open3e-esp32 gateway": "Gateway open3e-esp32"
 }

package/admin/i18n/ru.json

@@ -88,5 +88,21 @@
     "active": "активный",
     "n/a": "н/д",
     "► After the scan, browse and manage the discovered data points using the 'datapoints page', which is accessible via the link button in the adapter's instance row.": "► После сканирования просматривайте обнаруженные точки данных и управляйте ими с помощью «страницы точек данных», доступной по кнопке ссылки в строке экземпляра адаптера.",
-    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Альтернативно вы можете использовать вкладку «Назначения адаптеру UDS CAN» в этом диалоговом окне конфигурации."
+    "► Alternatively, you can use the tab 'Assignments to UDS CAN Adapter' within this configuration dialog.": "► Альтернативно вы можете использовать вкладку «Назначения адаптеру UDS CAN» в этом диалоговом окне конфигурации.",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32-2.local": "Базовый URL REST-API шлюза open3e-esp32, напр. http://open3e-esp32-2.local",
+    "Base URL of the open3e-esp32 gateway's REST API, e.g. http://open3e-esp32.local": "Базовый URL REST-API шлюза open3e-esp32, напр. http://open3e-esp32.local",
+    "Connection type": "Тип подключения",
+    "Energy meters on CAN bus": "Счётчики энергии на шине CAN",
+    "Gateway MQTT broker URL": "URL брокера MQTT шлюза",
+    "Gateway REST URL": "REST-URL шлюза",
+    "Local CAN interface": "Локальный интерфейс CAN",
+    "Local CAN interface, or an open3e-esp32 gateway reached over the network.": "Локальный интерфейс CAN или шлюз open3e-esp32, доступный по сети.",
+    "MQTT base topic": "Базовый топик MQTT",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32-2.local": "URL брокера MQTT, на который шлюз публикует необработанные кадры и статус, напр. mqtt://open3e-esp32-2.local",
+    "MQTT broker URL the gateway publishes raw frames and status to, e.g. mqtt://open3e-esp32.local": "URL брокера MQTT, на который шлюз публикует необработанные кадры и статус, напр. mqtt://open3e-esp32.local",
+    "MQTT password": "Пароль MQTT",
+    "MQTT username": "Имя пользователя MQTT",
+    "Must match the gateway's own mqtt.baseTopic setting (its /api/settings), not necessarily the firmware default.": "Должно совпадать с настройкой mqtt.baseTopic шлюза (см. /api/settings), необязательно со значением по умолчанию прошивки.",
+    "Symbol '.' not allowed in 'Device state name'!": "Символ «.» не допускается в «Имени состояния устройства»!",
+    "open3e-esp32 gateway": "Шлюз open3e-esp32"
 }