iobroker.miele-local 0.3.44 → 0.3.45

package/README.md

@@ -88,7 +88,7 @@ carries the plain-text list, so in most places the text state is no longer neede
 ### `eco` — energy and water
 
 `eco.energy` (kWh), `eco.energyWh` (Wh), `eco.water` (l) where the appliance provides them, plus
-`eco.quelle` naming which source a value came from. Read over DOP2; so far washing machines
+`eco.source` naming which source a value came from. Read over DOP2; so far washing machines
 deliver it. **The value the appliance reports is its own expectation, not a measurement.** For a
 real figure, enter a metering plug's counter state on the **Polling & values** tab — the adapter
 then records what each programme actually drew.
@@ -171,7 +171,7 @@ Everything in this section is **off by default** and is not needed for day-to-da
 exists for one question: which raw field of *your* appliance holds energy and water. The field
 numbers differ per series, and the defaults in the adapter come from a WCR860.
 
-**Raw fields.** Writes all fields of the eco leaf to `eco.felderJson` instead of only the two
+**Raw fields.** Writes all fields of the eco leaf to `eco.fieldsJson` instead of only the two
 evaluated ones.
 
 **Data collection.** Records one dataset per completed programme — model, programme, all raw
@@ -190,10 +190,10 @@ one you are looking for.
 **CSV export.** The button on the Diagnostics tab writes two tables into the instance's file area
 and opens the first:
 
-- `sammlung-<date>.csv` — one row per programme: times, programme, the reference values, every raw
+- `collection-<date>.csv` — one row per programme: times, programme, the reference values, every raw
   field in its own column, and for each leaf field the reading at start, at end and the difference
   between them. For lifetime counters only that difference means anything.
-- `befund-<date>.csv` — one row per field: how well it matches the reference, the best divisor,
+- `finding-<date>.csv` — one row per field: how well it matches the reference, the best divisor,
   the average and the largest deviation. This is the answer the collection exists for.
 
 Semicolon separated, decimal comma, BOM — a double click opens them in a spreadsheet.
@@ -237,6 +237,15 @@ engineering work of the projects `MieleRESTServer` (akappner),
 	### **WORK IN PROGRESS**
 -->
 
+### 0.3.45
+- (SmarthomeElektroniker) The last German state ID is gone: `eco.quelle` is now `eco.source`, its value is always English. Existing installations are migrated on start
+- (SmarthomeElektroniker) `statusText`, `programText`, `programPhaseText`, `programTypeText` and `dryingStepText` follow the "German names" option - with the option off they are English (until now they were always German)
+- (SmarthomeElektroniker) Remaining German log and error messages translated; CSV export files are named `collection-<date>.csv` and `finding-<date>.csv`
+- (SmarthomeElektroniker) All JSDoc comments complete (no lint warnings left); `@iobroker/testing` 6.3.0
+- (SmarthomeElektroniker) `eco.felderJson` is now `eco.fieldsJson` (migrated on start)
+- (SmarthomeElektroniker) Settings use English keys: `sammlerAktiv`/`sammlerCloud`/`sammlerCloudInstanz` became `collectorActive`/`collectorCloud`/`collectorCloudInstance`, `leafDatenpunkte` became `leafStates`, the energy meter table `zaehler` became `energyMeters`. Existing settings are carried over once on start (review 2026-10-03)
+- (SmarthomeElektroniker) Background loops (eco, operating hours, seconds, discovery, push renewal, leaf trend) schedule their next run only after the previous one finished - no overlapping runs when an appliance answers slowly
+
 ### 0.3.44
 - (SmarthomeElektroniker) History objects are only rewritten when they actually changed - this prevents an empty (null) point in the history adapter after every adapter restart
 
@@ -337,7 +346,7 @@ engineering work of the projects `MieleRESTServer` (akappner),
 - **Water: the appliance's own EcoFeedback comes first.** Where DOP2 2/1585 exists, its value for
   the last programme is used; only where it does not does the adapter fall back to counting flow
   meter impulses (field 21 / 200, verified against the house water meter over 24 programmes). The
-  new datapoint `eco.quelle` says which of the two a value came from.
+  new datapoint `eco.source` (called `eco.quelle` before 0.3.45) says which of the two a value came from.
 - **The collector records every leaf.** At the end of a programme the adapter reads each answering
   leaf once, gently (five seconds between requests, in the background), and appends the final state
   to the record. This is what makes the collection useful for appliances that do not answer 2/6195

package/README_de.md

@@ -91,7 +91,7 @@ wird damit an den meisten Stellen entbehrlich.
 ### `eco` – Energie und Wasser
 
 `eco.energy` (kWh), `eco.energyWh` (Wh), `eco.water` (l), soweit das Gerät sie liefert, dazu
-`eco.quelle` mit der Herkunft des Werts. Gelesen wird über DOP2; bislang liefern das
+`eco.source` mit der Herkunft des Werts. Gelesen wird über DOP2; bislang liefern das
 Waschmaschinen. **Der vom Gerät gemeldete Wert ist seine eigene Erwartung, keine Messung.** Wer
 eine echte Zahl will, trägt im Reiter **Abfrage & Werte** den Zähler-Datenpunkt einer
 Messsteckdose ein – dann schreibt der Adapter mit, was ein Programm wirklich gezogen hat.
@@ -176,7 +176,7 @@ Alles in diesem Abschnitt ist **ab Werk aus** und wird im täglichen Betrieb nic
 dient einer einzigen Frage: Welches Rohfeld *dieses* Geräts trägt Energie und Wasser? Die
 Feldnummern sind je Baureihe verschieden, und die Vorgaben im Adapter stammen von einer WCR860.
 
-**Rohfelder.** Schreibt alle Felder des Eco-Leaf nach `eco.felderJson` statt nur der zwei
+**Rohfelder.** Schreibt alle Felder des Eco-Leaf nach `eco.fieldsJson` statt nur der zwei
 ausgewerteten.
 
 **Datensammlung.** Legt je abgeschlossenem Programm einen Datensatz an – Modell, Programm, alle
@@ -195,10 +195,10 @@ engmaschig mitschreiben – das Feld, dessen Wert mit dem Verbrauch mitwächst,
 **CSV-Ausdruck.** Der Knopf im Diagnose-Reiter legt zwei Tabellen im Dateibereich der Instanz ab
 und öffnet die erste:
 
-- `sammlung-<Datum>.csv` – eine Zeile je Programm: Zeiten, Programm, die Vergleichswerte, jedes
+- `collection-<Datum>.csv` – eine Zeile je Programm: Zeiten, Programm, die Vergleichswerte, jedes
   Rohfeld in einer eigenen Spalte, und je Leaf-Feld der Stand bei Beginn, bei Ende und die
   Differenz dazwischen. Bei Lebenszählern sagt allein die Differenz etwas aus.
-- `befund-<Datum>.csv` – eine Zeile je Feld: Übereinstimmung mit dem Vergleichswert, bester
+- `finding-<Datum>.csv` – eine Zeile je Feld: Übereinstimmung mit dem Vergleichswert, bester
   Teiler, mittlere und größte Abweichung. Das ist die Antwort, wegen der die Sammlung läuft.
 
 Semikolon als Trennzeichen, Komma als Dezimalzeichen, BOM – ein Doppelklick öffnet sie in der
@@ -245,6 +245,15 @@ Reverse-Engineering-Arbeit der Projekte `MieleRESTServer` (akappner),
 	### **WORK IN PROGRESS**
 -->
 
+### 0.3.45
+- Die letzte deutsche Datenpunkt-ID ist weg: `eco.quelle` heißt jetzt `eco.source`, der Wert ist immer englisch. Vorhandene Installationen ziehen beim Start um.
+- `statusText`, `programText`, `programPhaseText`, `programTypeText` und `dryingStepText` folgen der Option „Deutsche Namen“ - ist sie aus, sind die Texte englisch (bisher immer deutsch).
+- Restliche deutsche Log- und Fehlermeldungen übersetzt; die CSV-Dateien heißen `collection-<Datum>.csv` und `finding-<Datum>.csv`.
+- Alle JSDoc-Kommentare vollständig (keine Lint-Warnungen mehr); `@iobroker/testing` 6.3.0.
+- `eco.felderJson` heißt jetzt `eco.fieldsJson` (Umzug beim Start).
+- Einstellungen tragen englische Namen: aus `sammlerAktiv`/`sammlerCloud`/`sammlerCloudInstanz` wurden `collectorActive`/`collectorCloud`/`collectorCloudInstance`, aus `leafDatenpunkte` wurde `leafStates`, aus der Zählertabelle `zaehler` wurde `energyMeters`. Vorhandene Einstellungen werden beim Start einmalig übernommen (Review 03.10.2026).
+- Hintergrundschleifen (Eco, Betriebsstunden, Sekunden, Suche, Push-Erneuerung, Leaf-Verlauf) planen den nächsten Lauf erst nach dem Ende des vorigen – keine überlappenden Läufe mehr, wenn ein Gerät langsam antwortet.
+
 ### 0.3.38
 - **Die Objekt-IDs sind jetzt durchgängig englisch.** Der Diagnosekanal hieß `sammlung` und
   trug ausschließlich deutsche Datenpunktnamen (`befund`, `fortschritt`, `datenJson`,
@@ -321,7 +330,7 @@ Reverse-Engineering-Arbeit der Projekte `MieleRESTServer` (akappner),
 - **Wasser: das EcoFeedback des Geräts hat Vorrang.** Wo es DOP2 2/1585 gibt, gilt dessen Wert für
   das letzte Programm; nur wo es ihn nicht gibt, zählt der Adapter weiter die Impulse des
   Durchflusszählers (Feld 21 / 200, über 24 Programme gegen den Hauswasserzähler belegt). Der neue
-  Datenpunkt `eco.quelle` sagt, aus welcher der beiden Quellen ein Wert stammt.
+  Datenpunkt `eco.source` (bis 0.3.44 `eco.quelle`) sagt, aus welcher der beiden Quellen ein Wert stammt.
 - **Der Datensammler schreibt alle Leafs mit.** Am Programmende liest der Adapter jedes
   antwortende Leaf einmal, schonend (fünf Sekunden zwischen zwei Anfragen, im Hintergrund) und
   hängt den Schlussstand an den Datensatz. Erst das macht die Sammlung für Geräte brauchbar, die

package/admin/i18n/de.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Teilungsfaktor Wasserfeld",
   "Water field index": "Feldindex Wasser",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Ohne Cloud: Nach jedem Programm Energie und Wasser aus der Miele-App in die Punkte \"collection.inputEnergy\" und \"collection.inputWater\" eintragen - sie gehören dann zum zuletzt gesammelten Datensatz. Wie viele noch fehlen, steht in \"collection.progress\".",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Schreibt alle Felder des Eco-Leaf nach eco.felderJson statt nur der zwei ausgewerteten. Hilft, wenn Energie oder Wasser bei Ihrem Modell falsch ankommen.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Schreibt alle Felder des Eco-Leaf nach eco.fieldsJson statt nur der zwei ausgewerteten. Hilft, wenn Energie oder Wasser bei Ihrem Modell falsch ankommen.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Legt zwei Tabellen ab und öffnet die erste: eine Zeile je Programm mit allen Rohfeldern, dazu eine Auswertung mit einer Zeile je Feld. Achtung beim Weitergeben – die Tabelle enthält die Zeitpunkte der Programme.",
   "miele:// redirect URL": "miele://-Redirect-URL"
 }

package/admin/i18n/en.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Water field divisor",
   "Water field index": "Water field index",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.",
   "miele:// redirect URL": "miele:// redirect URL"
 }

package/admin/i18n/es.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Divisor del campo de agua",
   "Water field index": "Índice del campo de agua",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Sin nube: después de cada programa, introduce la energía y el agua de la app de Miele en \"collection.inputEnergy\" y \"collection.inputWater\"; se asignan al último registro. \"collection.progress\" muestra lo que aún falta.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Escribe todos los campos del leaf Eco en eco.felderJson en vez de solo los dos evaluados. Ayuda si la energía o el agua llegan mal en su modelo.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Escribe todos los campos del leaf Eco en eco.fieldsJson en vez de solo los dos evaluados. Ayuda si la energía o el agua llegan mal en su modelo.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Genera dos tablas y abre la primera: una fila por programa con todos los campos en bruto, más un análisis con una fila por campo. Cuidado al compartir: la tabla contiene las horas de los programas.",
   "miele:// redirect URL": "URL de redirección miele://"
 }

package/admin/i18n/fr.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Diviseur du champ d'eau",
   "Water field index": "Index du champ eau",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Sans cloud : après chaque programme, saisissez l'énergie et l'eau de l'application Miele dans « collection.inputEnergy » et « collection.inputWater » ; elles sont rattachées au dernier jeu de données. « collection.progress » indique ce qui manque encore.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Écrit tous les champs du leaf Eco dans eco.felderJson au lieu des deux seuls évalués. Utile si l'énergie ou l'eau arrivent fausses sur votre modèle.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Écrit tous les champs du leaf Eco dans eco.fieldsJson au lieu des deux seuls évalués. Utile si l'énergie ou l'eau arrivent fausses sur votre modèle.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Dépose deux tableaux et ouvre le premier : une ligne par programme avec tous les champs bruts, plus une analyse avec une ligne par champ. Attention en cas de partage – le tableau contient les horodatages des programmes.",
   "miele:// redirect URL": "URL de redirection miele://"
 }

package/admin/i18n/it.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Divisore del campo acqua",
   "Water field index": "Indice del campo acqua",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Senza cloud: dopo ogni programma inserire energia e acqua dall'app Miele in \"collection.inputEnergy\" e \"collection.inputWater\"; vengono associate all'ultimo set di dati. \"collection.progress\" mostra cosa manca ancora.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Scrive tutti i campi del leaf Eco in eco.felderJson invece dei soli due valutati. Aiuta se energia o acqua arrivano errate sul suo modello.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Scrive tutti i campi del leaf Eco in eco.fieldsJson invece dei soli due valutati. Aiuta se energia o acqua arrivano errate sul suo modello.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Crea due tabelle e apre la prima: una riga per programma con tutti i campi grezzi, più un'analisi con una riga per campo. Attenzione nel condividere: la tabella contiene gli orari dei programmi.",
   "miele:// redirect URL": "URL di reindirizzamento miele://"
 }

package/admin/i18n/nl.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Deelfactor waterveld",
   "Water field index": "Veldindex water",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Zonder cloud: voer na elk programma energie en water uit de Miele-app in bij \"collection.inputEnergy\" en \"collection.inputWater\" - ze horen dan bij de laatst verzamelde dataset. \"collection.progress\" toont wat nog ontbreekt.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Schrijft alle velden van het Eco-leaf naar eco.felderJson in plaats van alleen de twee geëvalueerde. Helpt als energie of water bij uw model verkeerd binnenkomen.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Schrijft alle velden van het Eco-leaf naar eco.fieldsJson in plaats van alleen de twee geëvalueerde. Helpt als energie of water bij uw model verkeerd binnenkomen.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Legt twee tabellen aan en opent de eerste: één regel per programma met alle ruwe velden, plus een analyse met één regel per veld. Let op bij delen – de tabel bevat de tijdstippen van de programma's.",
   "miele:// redirect URL": "miele://-omleidings-URL"
 }

package/admin/i18n/pl.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Dzielnik pola wody",
   "Water field index": "Indeks pola wody",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Bez chmury: po każdym programie wpisz energię i wodę z aplikacji Miele do \"collection.inputEnergy\" i \"collection.inputWater\" - zostaną przypisane do ostatniego zestawu danych. \"collection.progress\" pokazuje, czego jeszcze brakuje.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Zapisuje wszystkie pola leafa Eco do eco.felderJson zamiast tylko dwóch ocenianych. Pomaga, gdy energia lub woda docierają błędnie w Twoim modelu.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Zapisuje wszystkie pola leafa Eco do eco.fieldsJson zamiast tylko dwóch ocenianych. Pomaga, gdy energia lub woda docierają błędnie w Twoim modelu.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Tworzy dwie tabele i otwiera pierwszą: jeden wiersz na program ze wszystkimi surowymi polami oraz analizę z jednym wierszem na pole. Uwaga przy udostępnianiu – tabela zawiera godziny programów.",
   "miele:// redirect URL": "URL przekierowania miele://"
 }

package/admin/i18n/pt.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Divisor do campo de água",
   "Water field index": "Índice do campo de água",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Sem nuvem: após cada programa, introduza a energia e a água da app Miele em \"collection.inputEnergy\" e \"collection.inputWater\"; ficam associadas ao último registo. \"collection.progress\" mostra o que ainda falta.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Escreve todos os campos do leaf Eco em eco.felderJson em vez de apenas os dois avaliados. Ajuda se a energia ou a água chegarem erradas no seu modelo.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Escreve todos os campos do leaf Eco em eco.fieldsJson em vez de apenas os dois avaliados. Ajuda se a energia ou a água chegarem erradas no seu modelo.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Cria duas tabelas e abre a primeira: uma linha por programa com todos os campos brutos, mais uma análise com uma linha por campo. Cuidado ao partilhar – a tabela contém as horas dos programas.",
   "miele:// redirect URL": "URL de redirecionamento miele://"
 }

package/admin/i18n/ru.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Делитель поля воды",
   "Water field index": "Индекс поля воды",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Без облака: после каждой программы вводите энергию и воду из приложения Miele в «collection.inputEnergy» и «collection.inputWater» — они относятся к последнему набору данных. «collection.progress» показывает, чего ещё не хватает.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Записывает все поля Eco-leaf в eco.felderJson, а не только два обрабатываемых. Помогает, если энергия или вода на вашей модели приходят неверными.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Записывает все поля Eco-leaf в eco.fieldsJson, а не только два обрабатываемых. Помогает, если энергия или вода на вашей модели приходят неверными.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Создаёт две таблицы и открывает первую: по строке на программу со всеми сырыми полями, плюс разбор по строке на поле. Осторожно при передаче — таблица содержит время выполнения программ.",
   "miele:// redirect URL": "URL перенаправления miele://"
 }

package/admin/i18n/uk.json

@@ -102,7 +102,7 @@
   "Water field divisor": "Дільник поля води",
   "Water field index": "Індекс поля води",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "Без хмари: після кожної програми вводьте енергію та воду з застосунку Miele у «collection.inputEnergy» і «collection.inputWater» — вони належать до останнього набору даних. «collection.progress» показує, чого ще бракує.",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Записує всі поля Eco-leaf у eco.felderJson, а не лише два оброблювані. Допомагає, якщо енергія чи вода на вашій моделі надходять хибними.",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "Записує всі поля Eco-leaf у eco.fieldsJson, а не лише два оброблювані. Допомагає, якщо енергія чи вода на вашій моделі надходять хибними.",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "Створює дві таблиці й відкриває першу: по рядку на програму з усіма сирими полями, а також розбір по рядку на поле. Обережно з передаванням — таблиця містить час виконання програм.",
   "miele:// redirect URL": "URL перенаправлення miele://"
 }

package/admin/i18n/zh-cn.json

@@ -102,7 +102,7 @@
   "Water field divisor": "水量字段除数",
   "Water field index": "用水字段索引",
   "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing.": "不使用云端时：每次程序结束后，将 Miele 应用中的能耗和用水量填入 \"collection.inputEnergy\" 和 \"collection.inputWater\"，它们会归入最近一次收集的数据集。\"collection.progress\" 显示还缺少什么。",
-  "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "将 Eco leaf 的全部字段写入 eco.felderJson，而不仅是已解析的两个。当您的机型能耗或水量数值有误时有帮助。",
+  "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model.": "将 Eco leaf 的全部字段写入 eco.fieldsJson，而不仅是已解析的两个。当您的机型能耗或水量数值有误时有帮助。",
   "Writes two tables and opens the first: one row per programme with all raw fields, plus an analysis with one row per field. Take care when sharing – the table contains the programme timestamps.": "生成两张表并打开第一张：每个程序一行、含全部原始字段，另有一张每个字段一行的分析表。分享时请注意——表中含程序的时间点。",
   "miele:// redirect URL": "miele:// 重定向 URL"
 }

package/admin/jsonConfig.json

@@ -385,7 +385,7 @@
                     "lg": 4,
                     "xl": 4
                 },
-                "zaehler": {
+                "energyMeters": {
                     "type": "table",
                     "label": "Energy meter per appliance (optional)",
                     "newLine": true,
@@ -398,7 +398,7 @@
                         },
                         {
                             "type": "objectId",
-                            "attr": "datenpunkt",
+                            "attr": "stateId",
                             "title": "Meter datapoint (Wh, monotonically increasing)",
                             "width": "60%"
                         }
@@ -410,7 +410,7 @@
                     "xl": 12,
                     "help": "The consumption reported by the appliance is an estimate, not a measurement. If you have a metering plug in front of it, enter its meter state here."
                 },
-                "leafDatenpunkte": {
+                "leafStates": {
                     "type": "checkbox",
                     "newLine": true,
                     "label": "Create what the device delivers",
@@ -540,11 +540,11 @@
                 }
             }
         },
-        "tabDiagnose": {
+        "tabDiagnostics": {
             "type": "panel",
             "label": "Diagnostics",
             "items": {
-                "_diagIntro": {
+                "_diagnosticsIntro": {
                     "type": "staticText",
                     "newLine": true,
                     "text": "These settings serve troubleshooting and field mapping. They are not needed for daily operation and are off by default. Collected data stays in this instance.",
@@ -564,9 +564,9 @@
                     "md": 4,
                     "lg": 4,
                     "xl": 4,
-                    "help": "Writes all fields of the eco leaf to eco.felderJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model."
+                    "help": "Writes all fields of the eco leaf to eco.fieldsJson instead of only the two evaluated ones. Helps when energy or water arrive wrong on your model."
                 },
-                "_sammlerKopf": {
+                "_collectorHeader": {
                     "xs": 12,
                     "sm": 12,
                     "md": 12,
@@ -577,7 +577,7 @@
                     "newLine": true,
                     "text": "Data collection for other models"
                 },
-                "sammlerAktiv": {
+                "collectorActive": {
                     "xs": 12,
                     "sm": 6,
                     "md": 4,
@@ -599,7 +599,7 @@
                     "label": "Start the leaf search when a device is switched on",
                     "help": "Only for devices whose search has never run. A device that is off most of the time would otherwise never be searched. The search only reads, and stops as soon as the device is off again."
                 },
-                "sammlerCloud": {
+                "collectorCloud": {
                     "xs": 12,
                     "sm": 6,
                     "md": 4,
@@ -607,11 +607,11 @@
                     "xl": 4,
                     "type": "checkbox",
                     "newLine": true,
-                    "hidden": "!data.sammlerAktiv",
+                    "hidden": "!data.collectorActive",
                     "label": "Include cloud values for comparison",
                     "help": "Requires a running instance of the mielecloudservice adapter."
                 },
-                "sammlerCloudInstanz": {
+                "collectorCloudInstance": {
                     "xs": 12,
                     "sm": 12,
                     "md": 6,
@@ -619,12 +619,12 @@
                     "xl": 6,
                     "type": "text",
                     "newLine": true,
-                    "hidden": "!data.sammlerCloud",
+                    "hidden": "!data.collectorCloud",
                     "label": "Cloud adapter instance",
                     "default": "mielecloudservice.0",
                     "help": "Instance of the cloud adapter the reference values come from, for example mielecloudservice.0."
                 },
-                "_sammlerHand": {
+                "_collectorManual": {
                     "xs": 12,
                     "sm": 12,
                     "md": 12,
@@ -632,10 +632,10 @@
                     "xl": 12,
                     "type": "staticText",
                     "newLine": true,
-                    "hidden": "!data.sammlerAktiv",
+                    "hidden": "!data.collectorActive",
                     "text": "Without cloud: after each programme, enter energy and water from the Miele app into \"collection.inputEnergy\" and \"collection.inputWater\" - they are attached to the most recent dataset. \"collection.progress\" shows what is still missing."
                 },
-                "_csvKopf": {
+                "_csvHeader": {
                     "type": "header",
                     "size": 4,
                     "newLine": true,

package/io-package.json

@@ -1,7 +1,7 @@
 {
   "common": {
     "name": "miele-local",
-    "version": "0.3.44",
+    "version": "0.3.45",
     "titleLang": {
       "en": "Miele@local",
       "de": "Miele@local",
@@ -52,6 +52,19 @@
     "readme": "https://github.com/SmarthomeElektroniker/ioBroker.miele-local/blob/main/README.md",
     "loglevel": "info",
     "news": {
+      "0.3.45": {
+        "en": "Only English IDs left: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; settings use English keys (collectorActive, leafStates, energyMeters ...), migrated once on start; text states follow the German names option; background loops never overlap",
+        "de": "Nur noch englische IDs: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; Einstellungen mit englischen Namen (collectorActive, leafStates, energyMeters ...), beim Start einmalig übernommen; Textdatenpunkte folgen der Option „Deutsche Namen“; Hintergrundschleifen überlappen nicht mehr",
+        "ru": "Остались только английские ID: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; настройки с английскими ключами (collectorActive, leafStates, energyMeters ...), переносятся один раз при запуске; текстовые состояния следуют опции немецких имён; фоновые циклы больше не перекрываются",
+        "pt": "Apenas IDs em inglês: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; configurações com chaves em inglês (collectorActive, leafStates, energyMeters ...), migradas uma vez ao iniciar; estados de texto seguem a opção de nomes em alemão; ciclos em segundo plano não se sobrepõem mais",
+        "nl": "Alleen nog Engelse ID's: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; instellingen met Engelse sleutels (collectorActive, leafStates, energyMeters ...), eenmalig bij het starten overgenomen; tekststatussen volgen de optie voor Duitse namen; achtergrondlussen overlappen niet meer",
+        "fr": "Uniquement des ID en anglais : eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson ; paramètres avec des clés anglaises (collectorActive, leafStates, energyMeters ...), migrés une fois au démarrage ; les états texte suivent l'option des noms allemands ; les boucles d'arrière-plan ne se chevauchent plus",
+        "it": "Solo ID in inglese: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; impostazioni con chiavi inglesi (collectorActive, leafStates, energyMeters ...), migrate una volta all'avvio; gli stati di testo seguono l'opzione dei nomi tedeschi; i cicli in background non si sovrappongono più",
+        "es": "Solo ID en inglés: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; ajustes con claves en inglés (collectorActive, leafStates, energyMeters ...), migrados una vez al iniciar; los estados de texto siguen la opción de nombres en alemán; los bucles en segundo plano ya no se solapan",
+        "pl": "Tylko angielskie identyfikatory: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; ustawienia z angielskimi kluczami (collectorActive, leafStates, energyMeters ...), przenoszone jednorazowo przy starcie; stany tekstowe zależą od opcji niemieckich nazw; pętle w tle już się nie nakładają",
+        "uk": "Лише англійські ID: eco.quelle -> eco.source, eco.felderJson -> eco.fieldsJson; налаштування з англійськими ключами (collectorActive, leafStates, energyMeters ...), переносяться один раз під час запуску; текстові стани залежать від опції німецьких назв; фонові цикли більше не перекриваються",
+        "zh-cn": "仅保留英文 ID：eco.quelle -> eco.source，eco.felderJson -> eco.fieldsJson；设置使用英文键（collectorActive、leafStates、energyMeters ...），启动时一次性迁移；文本状态遵循德语名称选项；后台循环不再重叠"
+      },
       "0.3.44": {
         "en": "History objects are only rewritten when they actually changed - no more empty (null) points in the history adapter after every restart",
         "de": "History-Objekte werden nur noch geschrieben, wenn sie sich wirklich geändert haben - keine leeren (null) Punkte mehr im History-Adapter nach jedem Neustart",
@@ -129,19 +142,6 @@
         "pl": "Nieznane numery programów lub faz są wyświetlane jako „Programm 201” zamiast pozostawiać tekst poprzedniego programu. Dodano numery programów zmywarki G7771 (#13).",
         "uk": "Невідомі номери програм або фаз відображаються як «Programm 201», а не зберігають текст попередньої програми. Додано номери програм посудомийної машини G7771 (#13).",
         "zh-cn": "未知的程序或阶段编号显示为“Programm 201”，不再保留上一个程序的文本。新增 G7771 洗碗机的程序编号 (#13)。"
-      },
-      "0.3.38": {
-        "en": "Object IDs are now consistently English: \"sammlung\" became \"collection\", \"befund\" became \"finding\", \"laufendSeit\" became \"runningSince\". On first start the adapter moves existing values to the new IDs; own scripts must follow suit, while recorded history stays under the old ID in the history adapter. Also since 0.3.5: water is read from the verified DOP2 field and taken from the appliance's own EcoFeedback first, device internals can be created as datapoints, a separate diagnostics tab with CSV export collects the raw fields, and the configurable intervals are capped at runtime.",
-        "de": "Objekt-IDs jetzt durchgängig englisch: Aus \"sammlung\" wurde \"collection\", aus \"befund\" wurde \"finding\", aus \"laufendSeit\" wurde \"runningSince\". Beim ersten Start zieht der Adapter vorhandene Werte an die neuen IDs um; eigene Skripte müssen nachgezogen werden, aufgezeichnete Verläufe bleiben unter der alten ID im History-Adapter. Außerdem seit 0.3.5: Wasser kommt aus dem geprüften DOP2-Feld und vorrangig aus dem EcoFeedback des Geräts, geräteinterne Messwerte lassen sich als Datenpunkte anlegen, ein eigener Diagnose-Reiter mit CSV-Ausdruck sammelt die Rohfelder, und die einstellbaren Intervalle sind zur Laufzeit begrenzt.",
-        "ru": "Идентификаторы объектов теперь полностью на английском: \"sammlung\" стало \"collection\", \"befund\" — \"finding\", \"laufendSeit\" — \"runningSince\". При первом запуске адаптер переносит имеющиеся значения на новые идентификаторы; собственные скрипты нужно поправить, а записанная история остаётся под старым идентификатором в адаптере history. Кроме того, начиная с 0.3.5: расход воды считывается из проверенного поля DOP2 и в первую очередь из EcoFeedback самого прибора, внутренние величины прибора можно создавать как состояния, отдельная вкладка диагностики с выгрузкой в CSV собирает сырые поля, а настраиваемые интервалы ограничиваются во время работы.",
-        "pt": "Os IDs de objeto passam a ser totalmente em inglês: \"sammlung\" tornou-se \"collection\", \"befund\" tornou-se \"finding\" e \"laufendSeit\" tornou-se \"runningSince\". No primeiro arranque o adaptador move os valores existentes para os novos IDs; os scripts próprios têm de ser adaptados, enquanto o histórico gravado permanece com o ID antigo no adaptador history. Além disso, desde a 0.3.5: a água é lida do campo DOP2 verificado e obtida primeiro do EcoFeedback do aparelho, os valores internos do aparelho podem ser criados como estados, um separador de diagnóstico próprio com exportação CSV reúne os campos brutos e os intervalos configuráveis são limitados em tempo de execução.",
-        "nl": "Object-ID's zijn nu volledig Engels: \"sammlung\" werd \"collection\", \"befund\" werd \"finding\" en \"laufendSeit\" werd \"runningSince\". Bij de eerste start verplaatst de adapter bestaande waarden naar de nieuwe ID's; eigen scripts moeten worden aangepast, opgenomen historie blijft onder de oude ID in de history-adapter staan. Verder sinds 0.3.5: water wordt uit het geverifieerde DOP2-veld gelezen en bij voorkeur uit de EcoFeedback van het apparaat gehaald, interne meetwaarden van het apparaat kunnen als datapunten worden aangemaakt, een eigen diagnosetabblad met CSV-export verzamelt de ruwe velden en de instelbare intervallen worden tijdens het draaien begrensd.",
-        "fr": "Les identifiants d'objets sont désormais entièrement en anglais : \"sammlung\" est devenu \"collection\", \"befund\" est devenu \"finding\" et \"laufendSeit\" est devenu \"runningSince\". Au premier démarrage, l'adaptateur déplace les valeurs existantes vers les nouveaux identifiants ; les scripts personnels doivent être adaptés, tandis que l'historique enregistré reste sous l'ancien identifiant dans l'adaptateur history. Depuis la 0.3.5 également : l'eau est lue dans le champ DOP2 vérifié et provient en priorité de l'EcoFeedback de l'appareil, les valeurs internes de l'appareil peuvent être créées comme états, un onglet de diagnostic dédié avec export CSV rassemble les champs bruts, et les intervalles configurables sont bornés à l'exécution.",
-        "it": "Gli ID degli oggetti sono ora interamente in inglese: \"sammlung\" è diventato \"collection\", \"befund\" è diventato \"finding\" e \"laufendSeit\" è diventato \"runningSince\". Al primo avvio l'adapter sposta i valori esistenti sui nuovi ID; gli script personali vanno adeguati, mentre lo storico registrato resta con il vecchio ID nell'adapter history. Inoltre dalla 0.3.5: l'acqua viene letta dal campo DOP2 verificato e presa in via prioritaria dall'EcoFeedback dell'apparecchio, i valori interni dell'apparecchio possono essere creati come stati, una scheda di diagnostica dedicata con esportazione CSV raccoglie i campi grezzi e gli intervalli configurabili sono limitati a runtime.",
-        "es": "Los ID de objeto son ahora íntegramente en inglés: \"sammlung\" pasó a \"collection\", \"befund\" a \"finding\" y \"laufendSeit\" a \"runningSince\". En el primer arranque el adaptador traslada los valores existentes a los nuevos ID; los scripts propios deben adaptarse, mientras que el histórico registrado permanece con el ID antiguo en el adaptador history. Además, desde la 0.3.5: el agua se lee del campo DOP2 verificado y se toma primero del EcoFeedback del propio aparato, los valores internos del aparato pueden crearse como estados, una pestaña de diagnóstico propia con exportación CSV reúne los campos en bruto y los intervalos configurables se limitan en tiempo de ejecución.",
-        "pl": "Identyfikatory obiektów są teraz w całości angielskie: \"sammlung\" zmieniono na \"collection\", \"befund\" na \"finding\", a \"laufendSeit\" na \"runningSince\". Przy pierwszym uruchomieniu adapter przenosi istniejące wartości na nowe identyfikatory; własne skrypty trzeba dostosować, a zapisana historia pozostaje pod starym identyfikatorem w adapterze history. Ponadto od wersji 0.3.5: woda jest odczytywana ze sprawdzonego pola DOP2 i pobierana w pierwszej kolejności z EcoFeedback urządzenia, wewnętrzne wartości urządzenia można tworzyć jako stany, osobna zakładka diagnostyczna z eksportem CSV zbiera pola surowe, a konfigurowalne interwały są ograniczane w czasie działania.",
-        "uk": "Ідентифікатори об'єктів тепер повністю англійські: \"sammlung\" стало \"collection\", \"befund\" — \"finding\", \"laufendSeit\" — \"runningSince\". Під час першого запуску адаптер переносить наявні значення на нові ідентифікатори; власні скрипти потрібно оновити, а записана історія залишається зі старим ідентифікатором в адаптері history. Крім того, починаючи з 0.3.5: вода зчитується з перевіреного поля DOP2 і насамперед береться з EcoFeedback самого приладу, внутрішні величини приладу можна створювати як стани, окрема вкладка діагностики з експортом у CSV збирає сирі поля, а налаштовувані інтервали обмежуються під час роботи.",
-        "zh-cn": "对象 ID 现已全部使用英文：\"sammlung\" 改为 \"collection\"，\"befund\" 改为 \"finding\"，\"laufendSeit\" 改为 \"runningSince\"。首次启动时，适配器会把已有数值迁移到新的 ID；自建脚本需要相应调整，已记录的历史数据仍以旧 ID 保留在 history 适配器中。此外自 0.3.5 起：用水量取自经过验证的 DOP2 字段，并优先来自设备自身的 EcoFeedback；设备内部数值可创建为数据点；独立的诊断选项卡支持导出 CSV 以收集原始字段；可配置的轮询间隔在运行时会被限制。"
       }
     },
     "mode": "daemon",
@@ -191,7 +191,11 @@
     "germanNames": true,
     "ecoFeedback": true,
     "ecoRawFields": false,
-    "leafDatenpunkte": true,
+    "leafStates": true,
+    "collectorActive": false,
+    "collectorCloud": false,
+    "collectorCloudInstance": "mielecloudservice.0",
+    "energyMeters": [],
     "ecoEnergyIdx": 25,
     "ecoWaterIdx": 21,
     "ecoWaterDiv": 200,

package/lib/api.js

@@ -31,10 +31,10 @@ class MieleDeviceApi {
      * das Modul ohnehin mehr zu tun hat - ueber 50. Das Geraet war dabei per Ping durchgehend
      * erreichbar, es kam schlicht nicht hinterher.
      *
-     * @param method
-     * @param resource
-     * @param bodyPlain
-     * @param timeoutMs
+     * @param method HTTP-Methode (GET, PUT oder POST)
+     * @param resource Pfad der Ressource auf dem Geraet, etwa "Devices/<route>/State"
+     * @param bodyPlain Klartext-Body, wird gepaddet und verschluesselt; null ohne Body
+     * @param timeoutMs Zeitlimit dieser Anfrage in Millisekunden
      */
     _request(method, resource, bodyPlain, timeoutMs) {
         const starten = () => this._sendeAnfrage(method, resource, bodyPlain, timeoutMs);
@@ -107,7 +107,7 @@ class MieleDeviceApi {
     /**
      * Signierter GET, entschlüsselt & als JSON geparst.
      *
-     * @param resource
+     * @param resource Pfad der Ressource auf dem Geraet
      */
     async get(resource) {
         const res = await this._request('GET', resource);
@@ -137,8 +137,8 @@ class MieleDeviceApi {
     /**
      * Signierter PUT mit verschlüsseltem Body. Gibt Statuscode zurück.
      *
-     * @param resource
-     * @param bodyPlain
+     * @param resource Pfad der Ressource auf dem Geraet
+     * @param bodyPlain Klartext-Body (meist JSON)
      */
     async put(resource, bodyPlain) {
         const res = await this._request('PUT', resource, bodyPlain);
@@ -148,8 +148,8 @@ class MieleDeviceApi {
     /**
      * Signierter POST mit verschlüsseltem Body. Gibt {status, location} zurück.
      *
-     * @param resource
-     * @param bodyPlain
+     * @param resource Pfad der Ressource auf dem Geraet
+     * @param bodyPlain Klartext-Body (meist JSON)
      */
     async post(resource, bodyPlain) {
         const res = await this._request('POST', resource, bodyPlain);
@@ -178,11 +178,11 @@ class MieleDeviceApi {
     /**
      * Ein DOP2-Leaf lesen.
      *
-     * @param route
-     * @param unit
-     * @param attr
-     * @param idx1
-     * @param idx2
+     * @param route Route des Geraets (Seriennummer)
+     * @param unit DOP2-Unit, etwa 2
+     * @param attr DOP2-Attribut, etwa 6195
+     * @param idx1 erster Index, 0 fuer die meisten Leafs
+     * @param idx2 zweiter Index, 0 fuer die meisten Leafs
      * @param {number} [timeoutMs] eigenes Zeitlimit fuer DIESE Anfrage.
      *
      * WOZU DAS EIGENE LIMIT: Der Regelbetrieb fragt bekannte Adressen ab, die antworten -

package/lib/cloud.js

@@ -78,7 +78,7 @@ function httpsRequest(method, urlStr, { headers = {}, body = null } = {}) {
 /**
  * Autorisierungs-URL + PKCE-Challenge erzeugen.
  *
- * @param cc
+ * @param cc Laendercode des Miele-Kontos, etwa "de"
  */
 function buildAuthorizeUrl(cc) {
     cc = String(cc).toLowerCase();
@@ -109,8 +109,8 @@ function buildAuthorizeUrl(cc) {
 /**
  * `code` aus miele://oauth2-code/?code=...&state=... extrahieren (mit state-Prüfung).
  *
- * @param redirectUrl
- * @param expectedState
+ * @param redirectUrl vollstaendige Weiterleitungs-URL aus dem Browser
+ * @param expectedState state-Wert, der beim Erzeugen der Autorisierungs-URL vergeben wurde
  */
 function parseRedirectUrl(redirectUrl, expectedState) {
     // miele:// ist kein von URL() parsebares Schema in allen Node-Versionen → manuell.
@@ -133,8 +133,8 @@ function parseRedirectUrl(redirectUrl, expectedState) {
 /**
  * code → Token.
  *
- * @param challenge
- * @param code
+ * @param challenge PKCE-Daten aus buildAuthorizeUrl (clientId, verifier, cc)
+ * @param code Autorisierungscode aus der Weiterleitung
  */
 async function exchangeCode(challenge, code) {
     const body = new URLSearchParams({
@@ -163,8 +163,8 @@ async function exchangeCode(challenge, code) {
 /**
  * Access-Token erneuern (refresh_token kann rotieren).
  *
- * @param cc
- * @param refreshToken
+ * @param cc Laendercode des Miele-Kontos, etwa "de"
+ * @param refreshToken bisheriger Refresh-Token
  */
 async function refreshAccessToken(cc, refreshToken) {
     cc = String(cc).toLowerCase();
@@ -187,8 +187,8 @@ async function refreshAccessToken(cc, refreshToken) {
 /**
  * GET /V2/GroupKeyId/ → { groupId, groupKey, devices }.
  *
- * @param accessToken
- * @param region
+ * @param accessToken gueltiger Access-Token
+ * @param region Cloud-Region: "EU", "EU2" oder "AS"
  */
 async function fetchGroupKey(accessToken, region = 'EU') {
     const host = REST_HOST_BY_REGION[String(region).toUpperCase()];