iobroker.anthbot-genie 0.1.3 → 0.1.4

package/README.md

@@ -30,13 +30,13 @@ An example ioBroker Blockly with conditions for mower automation is available in
 - Region and IoT endpoint lookup per mower
 - Polling of property and service shadows
 - Detailed status states for connection, online state, battery, mower status, charging state, mowing time, mowing area, map status, errors, active mowing mode, point mowing, and zone counts
-- Diagnostic states for RTK fix, RTK base station, moved antenna warnings, firmware versions, OTA progress, WiFi, cellular, SIM, Bluetooth, camera/map flags, obstacle avoidance, security flags, system timestamps, and mower error data
+- Diagnostic states for RTK fix, RTK base station, moved antenna warnings, firmware versions, OTA progress, WiFi, cellular, SIM, Bluetooth, camera/map flags, obstacle avoidance, security flags, system timestamps, and cloud-backed mower error data
 - Location states for anti-loss GPS coordinates and local mower pose
 - Consumable lifetime states and reset buttons for charging port, cameras, and blades
 - Writable control states for full-map mowing, zone mowing, cutting height, voice volume, custom mowing direction, obstacle avoidance, rain settings, and mowing near the charging pile
 - Command states for full mowing, stop, return to dock, pause return to dock, grass dump, disk maintenance mode, edge mowing, mowing near the charging pile, point mowing, refresh, manual zone mowing, and automatic zone mowing
 - Manual and automatic zone metadata as JSON states, including active manual zone IDs
-- Raw property shadow, service shadow, and area definition payloads for troubleshooting and automation debugging
+- Raw property shadow, service shadow, Anthbot event-code translations, and area definition payloads for troubleshooting and automation debugging
 
 ## Requirements
 
@@ -56,7 +56,8 @@ Open the adapter instance configuration in ioBroker Admin and set:
 | Anthbot account password | Anthbot account password, stored encrypted by ioBroker | empty |
 | Area code | Phone or account area code, for example `49` for Germany | `49` |
 | API host | Anthbot cloud API host | `api.anthbot.com` |
-| Poll interval in seconds | Polling interval for mower data. The adapter enforces at least 10 seconds. | `30` |
+| Poll interval in seconds | Polling interval for mower data. The adapter enforces at least 10 seconds. | `60` |
+| Error description language | Language used for Anthbot cloud error descriptions | `English` |
 
 After saving the configuration, start or restart the adapter instance.
 
@@ -102,7 +103,7 @@ anthbot-genie.<instance>.<serial>.*
 | `<serial>.metrics.map.totalArea` | number | `m2` | Total mapped area |
 | `<serial>.metrics.map.status` | string | | Raw map status |
 | `<serial>.metrics.error.code` | number | | Last mower error code |
-| `<serial>.metrics.error.description` | string | | Human-readable error description when known |
+| `<serial>.metrics.error.description` | string | | Human-readable error description from the cached Anthbot event-code list when known |
 | `<serial>.metrics.error.active` | boolean | | Whether a non-zero mower error is active |
 
 ### Location
@@ -198,6 +199,7 @@ Availability of `commands.maintenance.startDiskMaintenance`, `commands.maintenan
 | --- | --- | --- |
 | `<serial>.raw.shadow.property` | JSON string | Raw property shadow payload |
 | `<serial>.raw.shadow.service` | JSON string | Raw service shadow payload |
+| `<serial>.raw.shadow.event-code` | JSON string | Cached Anthbot event-code translation payload used for error descriptions |
 | `<serial>.raw.areaDefinition` | JSON string | Raw area definition payload |
 
 ## Zone Mowing
@@ -272,6 +274,11 @@ Special credit to the Home Assistant Anthbot Genie projects, which made the Anth
 This ioBroker adapter is an independent project, but it builds on public API research and implementation ideas from that Home Assistant integration.
 
 ## Changelog
+### 0.1.4 (2026-05-08)
+
+- Use Anthbot cloud event-code translations for mower error descriptions and add a configurable description language.
+- Store the fetched event-code translation cache in `raw.shadow.event-code` for troubleshooting.
+
 ### 0.1.3 (2026-05-08)
 
 - Fix AWS IoT shadow access by using temporary Anthbot IoT credentials instead of the expired bundled AWS credentials.

package/admin/i18n/de/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Ländervorwahl",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Beispiele: 49 für Deutschland, 32 für Belgien, 1 für USA/Kanada",
   "API host": "API-Host",
-  "Poll interval in seconds": "Abfrageintervall in Sekunden"
+  "Poll interval in seconds": "Abfrageintervall in Sekunden",
+  "Error description language": "Sprache der Fehlerbeschreibung",
+  "Language used for Anthbot cloud error descriptions": "Sprache für Anthbot-Cloud-Fehlerbeschreibungen"
 }

package/admin/i18n/en/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Area code",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada",
   "API host": "API host",
-  "Poll interval in seconds": "Poll interval in seconds"
+  "Poll interval in seconds": "Poll interval in seconds",
+  "Error description language": "Error description language",
+  "Language used for Anthbot cloud error descriptions": "Language used for Anthbot cloud error descriptions"
 }

package/admin/i18n/es/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Código de país",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Ejemplos: 49 para Alemania, 32 para Bélgica, 1 para EE. UU./Canadá",
   "API host": "Host de la API",
-  "Poll interval in seconds": "Intervalo de consulta en segundos"
+  "Poll interval in seconds": "Intervalo de consulta en segundos",
+  "Error description language": "Idioma de la descripción del error",
+  "Language used for Anthbot cloud error descriptions": "Idioma utilizado para las descripciones de errores de la nube Anthbot"
 }

package/admin/i18n/fr/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Indicatif pays",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Exemples : 49 pour l'Allemagne, 32 pour la Belgique, 1 pour les États-Unis/Canada",
   "API host": "Hôte de l'API",
-  "Poll interval in seconds": "Intervalle d'interrogation en secondes"
+  "Poll interval in seconds": "Intervalle d'interrogation en secondes",
+  "Error description language": "Langue de description des erreurs",
+  "Language used for Anthbot cloud error descriptions": "Langue utilisée pour les descriptions d'erreur du cloud Anthbot"
 }

package/admin/i18n/it/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Prefisso internazionale",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Esempi: 49 per Germania, 32 per Belgio, 1 per USA/Canada",
   "API host": "Host API",
-  "Poll interval in seconds": "Intervallo di interrogazione in secondi"
+  "Poll interval in seconds": "Intervallo di interrogazione in secondi",
+  "Error description language": "Lingua della descrizione errore",
+  "Language used for Anthbot cloud error descriptions": "Lingua usata per le descrizioni degli errori cloud Anthbot"
 }

package/admin/i18n/nl/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Landcode",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Voorbeelden: 49 voor Duitsland, 32 voor België, 1 voor VS/Canada",
   "API host": "API-host",
-  "Poll interval in seconds": "Pollinginterval in seconden"
+  "Poll interval in seconds": "Pollinginterval in seconden",
+  "Error description language": "Taal voor foutbeschrijving",
+  "Language used for Anthbot cloud error descriptions": "Taal voor Anthbot-cloudfoutbeschrijvingen"
 }

package/admin/i18n/pl/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Kod kraju",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Przykłady: 49 dla Niemiec, 32 dla Belgii, 1 dla USA/Kanady",
   "API host": "Host API",
-  "Poll interval in seconds": "Interwał odpytywania w sekundach"
+  "Poll interval in seconds": "Interwał odpytywania w sekundach",
+  "Error description language": "Język opisu błędów",
+  "Language used for Anthbot cloud error descriptions": "Język używany dla opisów błędów chmury Anthbot"
 }

package/admin/i18n/pt/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Código do país",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Exemplos: 49 para Alemanha, 32 para Bélgica, 1 para EUA/Canadá",
   "API host": "Host da API",
-  "Poll interval in seconds": "Intervalo de consulta em segundos"
+  "Poll interval in seconds": "Intervalo de consulta em segundos",
+  "Error description language": "Idioma da descrição do erro",
+  "Language used for Anthbot cloud error descriptions": "Idioma usado para descrições de erro da nuvem Anthbot"
 }

package/admin/i18n/ru/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Код страны",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Примеры: 49 для Германии, 32 для Бельгии, 1 для США/Канады",
   "API host": "Хост API",
-  "Poll interval in seconds": "Интервал опроса в секундах"
+  "Poll interval in seconds": "Интервал опроса в секундах",
+  "Error description language": "Язык описания ошибок",
+  "Language used for Anthbot cloud error descriptions": "Язык для описаний ошибок облака Anthbot"
 }

package/admin/i18n/uk/translations.json

@@ -4,5 +4,7 @@
   "Area code": "Код країни",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "Приклади: 49 для Німеччини, 32 для Бельгії, 1 для США/Канади",
   "API host": "Хост API",
-  "Poll interval in seconds": "Інтервал опитування в секундах"
+  "Poll interval in seconds": "Інтервал опитування в секундах",
+  "Error description language": "Мова опису помилок",
+  "Language used for Anthbot cloud error descriptions": "Мова для описів помилок хмари Anthbot"
 }

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

@@ -4,5 +4,7 @@
   "Area code": "国家/地区代码",
   "Examples: 49 for Germany, 32 for Belgium, 1 for US/Canada": "示例：德国为 49，比利时为 32，美国/加拿大为 1",
   "API host": "API 主机",
-  "Poll interval in seconds": "轮询间隔（秒）"
+  "Poll interval in seconds": "轮询间隔（秒）",
+  "Error description language": "错误说明语言",
+  "Language used for Anthbot cloud error descriptions": "用于 Anthbot 云端错误说明的语言"
 }

package/admin/jsonConfig.json

@@ -50,6 +50,70 @@
       "md": 4,
       "lg": 4,
       "xl": 4
+    },
+    "errorDescriptionLanguage": {
+      "type": "select",
+      "label": "Error description language",
+      "help": "Language used for Anthbot cloud error descriptions",
+      "options": [
+        {
+          "label": "English",
+          "value": "English"
+        },
+        {
+          "label": "German",
+          "value": "German"
+        },
+        {
+          "label": "French",
+          "value": "French"
+        },
+        {
+          "label": "Spain",
+          "value": "Spain"
+        },
+        {
+          "label": "Italy",
+          "value": "Italy"
+        },
+        {
+          "label": "Polish",
+          "value": "Polish"
+        },
+        {
+          "label": "Russian",
+          "value": "Russian"
+        },
+        {
+          "label": "Czech",
+          "value": "Czech"
+        },
+        {
+          "label": "Estonian",
+          "value": "Estonian"
+        },
+        {
+          "label": "Latvian",
+          "value": "Latvian"
+        },
+        {
+          "label": "Lithuanian",
+          "value": "Lithuanian"
+        },
+        {
+          "label": "Romanian",
+          "value": "Romanian"
+        },
+        {
+          "label": "Slovakia",
+          "value": "Slovakia"
+        }
+      ],
+      "xs": 12,
+      "sm": 12,
+      "md": 4,
+      "lg": 4,
+      "xl": 4
     }
   }
 }

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "anthbot-genie",
-    "version": "0.1.3",
+    "version": "0.1.4",
     "news": {
+      "0.1.4": {
+        "en": "Use Anthbot cloud event-code translations for mower error descriptions.",
+        "de": "Anthbot-Cloud-Ereigniscode-Übersetzungen für Mäher-Fehlerbeschreibungen verwendet.",
+        "ru": "Использованы облачные переводы кодов событий Anthbot для описаний ошибок косилки.",
+        "pt": "Usadas traduções de códigos de evento da nuvem Anthbot para descrições de erro do cortador.",
+        "nl": "Anthbot-cloudvertalingen van gebeurteniscodes gebruikt voor foutbeschrijvingen van de maaier.",
+        "fr": "Utilisation des traductions cloud Anthbot des codes d'événement pour les descriptions d'erreur de la tondeuse.",
+        "it": "Usate le traduzioni cloud Anthbot dei codici evento per le descrizioni degli errori del rasaerba.",
+        "es": "Se usan traducciones de códigos de evento de la nube Anthbot para descripciones de errores del cortacésped.",
+        "pl": "Użyto chmurowych tłumaczeń kodów zdarzeń Anthbot dla opisów błędów kosiarki.",
+        "uk": "Використано хмарні переклади кодів подій Anthbot для описів помилок косарки.",
+        "zh-cn": "使用 Anthbot 云端事件代码翻译生成割草机错误说明。"
+      },
       "0.1.3": {
         "en": "Fix AWS IoT shadow access.",
         "de": "AWS IoT-Shadow-Zugriff korrigiert.",
@@ -119,7 +132,7 @@
     "platform": "Javascript/Node.js",
     "mode": "daemon",
     "tier": 2,
-    "type": "household",
+    "type": "garden",
     "compact": true,
     "connectionType": "cloud",
     "dataSource": "poll",
@@ -150,7 +163,8 @@
     "password": "",
     "areaCode": "49",
     "apiHost": "api.anthbot.com",
-    "pollInterval": 30
+    "pollInterval": 60,
+    "errorDescriptionLanguage": "English"
   },
   "objects": [
     {

package/lib/anthbot.js

@@ -20,63 +20,6 @@ const MODEL_NAME_BY_CATEGORY = {
     "Genie 5000": "Anthbot Genie 5000",
 };
 
-const ERROR_CODE_DESCRIPTIONS = {
-    0: "No error",
-    1: "Battery low",
-    2: "Battery critically low",
-    3: "Battery over-temperature",
-    4: "Battery under-temperature",
-    5: "Battery overvoltage",
-    10: "Left wheel stuck",
-    11: "Right wheel stuck",
-    12: "Left wheel motor overload",
-    13: "Right wheel motor overload",
-    14: "Left wheel motor overheat",
-    15: "Right wheel motor overheat",
-    20: "Blade motor stuck",
-    21: "Blade motor overload",
-    22: "Blade motor overheat",
-    30: "Device lifted",
-    31: "Device tilted over limit",
-    32: "Device rollover",
-    33: "Device stuck",
-    40: "Bumper sensor triggered",
-    41: "Collision sensor jammed",
-    42: "ToF sensor fault",
-    43: "Structured-light sensor fault",
-    50: "GPS not ready",
-    51: "RTK not ready",
-    52: "IMU bias error",
-    53: "IMU data error",
-    60: "Boundary wire break",
-    61: "Boundary wire too long",
-    62: "Charging pile communication error",
-    63: "Charging pile overcurrent protection",
-    64: "Charging pile wire error",
-    65: "Recharge failure",
-    66: "Docking station return failure",
-    70: "WiFi config error",
-    71: "WiFi connection error",
-    80: "Firmware download error",
-    81: "Firmware upgrade error",
-    100: "Out of bounds",
-    101: "Unreachable mowing area",
-    102: "Started from forbidden zone",
-    103: "Started from virtual wall",
-    226: "Functional safety error",
-    227: "Ground app error",
-    228: "Ground base error",
-    229: "React error",
-    230: "Battery communication error",
-    231: "Drive motor stall",
-    232: "Drive motor overtemperature",
-    233: "Cutting motor stall protection",
-    234: "Mowing motor undervoltage",
-    235: "Mowing motor stuck",
-    236: "Lift up detected",
-    237: "Lift motor fault",
-};
-
 const RTK_STATE_OPTIONS = {
     0: "not_ready",
     1: "single",
@@ -194,12 +137,31 @@ function modelNameByCategory(categoryId) {
     return MODEL_NAME_BY_CATEGORY[raw] || (raw ? `Anthbot ${raw}` : "Anthbot mower");
 }
 
-function errorDescription(data) {
+function eventCodeTranslationsFromCache(cacheOrPayload) {
+    const payload = cacheOrPayload?.payload && typeof cacheOrPayload.payload === "object"
+        ? cacheOrPayload.payload
+        : cacheOrPayload;
+    return payload?.data && typeof payload.data === "object" && !Array.isArray(payload.data)
+        ? payload.data
+        : {};
+}
+
+function errorDescription(data, cacheOrPayload = null, language = "English") {
     const code = asInteger(data?.err_code);
     if (code == null) {
         return null;
     }
-    return ERROR_CODE_DESCRIPTIONS[code] || `Unknown error (${code})`;
+    const translations = eventCodeTranslationsFromCache(cacheOrPayload);
+    const byLanguage = translations[String(code)];
+    if (byLanguage && typeof byLanguage === "object" && !Array.isArray(byLanguage)) {
+        for (const candidateLanguage of [language, "English"]) {
+            const eventMessage = byLanguage[candidateLanguage]?.event_message;
+            if (typeof eventMessage === "string" && eventMessage.trim()) {
+                return eventMessage;
+            }
+        }
+    }
+    return `Unknown error (${code})`;
 }
 
 function rtkStateLabel(data) {
@@ -423,6 +385,58 @@ class AnthbotCloudApiClient {
         return areaDefinition;
     }
 
+    async getEventCodeVersion() {
+        this.requireToken();
+        const response = await this.http.get(`https://${this.host}/api/v1/message/code/version`, {
+            headers: this.authHeaders,
+        });
+        const payload = response.data;
+        if (response.status !== 200) {
+            throw new AnthbotGenieError(`Event code version failed (${response.status}): ${String(payload).slice(0, 300)}`);
+        }
+        if (!payload || typeof payload !== "object") {
+            throw new AnthbotGenieError("Invalid event code version payload type");
+        }
+        if (payload.code !== 0) {
+            throw new AnthbotGenieError(`Event code version returned code=${JSON.stringify(payload.code)}`);
+        }
+
+        const data = payload.data;
+        const version = typeof data === "object" && data !== null
+            ? asInteger(data.version ?? data.event_code_version ?? data.code_version)
+            : asInteger(data);
+        if (version == null) {
+            throw new AnthbotGenieError("Event code version payload missing version");
+        }
+        return version;
+    }
+
+    async getEventCodeTranslations(version) {
+        this.requireToken();
+        const response = await this.http.post(`https://${this.host}/api/v1/message/code/translate`, {
+            version,
+        }, {
+            headers: {
+                ...this.authHeaders,
+                "content-type": "application/json",
+            },
+        });
+        const payload = response.data;
+        if (response.status !== 200) {
+            throw new AnthbotGenieError(`Event code translations failed (${response.status}): ${String(payload).slice(0, 300)}`);
+        }
+        if (!payload || typeof payload !== "object") {
+            throw new AnthbotGenieError("Invalid event code translations payload type");
+        }
+        if (payload.code !== 0) {
+            throw new AnthbotGenieError(`Event code translations returned code=${JSON.stringify(payload.code)}`);
+        }
+        if (!payload.data || typeof payload.data !== "object" || Array.isArray(payload.data)) {
+            throw new AnthbotGenieError("Event code translations payload missing data object");
+        }
+        return payload;
+    }
+
     async getDevicePresignedRegion(serialNumber) {
         this.requireToken();
         const response = await this.http.get(`https://${this.host}/api/v1/device/v2/presigned_url`, {

package/main.js

@@ -198,6 +198,7 @@ const DEVICE_STATE_DEFINITIONS = {
     "zones.autoList": { type: "string", role: "json", read: true, write: false, name: t("Auto zones", "Automatische Zonen") },
     "raw.shadow.property": { type: "string", role: "json", read: true, write: false, name: t("Raw property shadow", "Rohdaten Property Shadow") },
     "raw.shadow.service": { type: "string", role: "json", read: true, write: false, name: t("Raw service shadow", "Rohdaten Service Shadow") },
+    "raw.shadow.event-code": { type: "string", role: "json", read: true, write: false, name: t("Raw event code translations", "Rohdaten Ereigniscode-Übersetzungen") },
     "raw.areaDefinition": { type: "string", role: "json", read: true, write: false, name: t("Raw area definition", "Rohdaten Flächendefinition") },
 };
 
@@ -246,6 +247,8 @@ class AnthbotGenieAdapter extends utils.Adapter {
         this.cloudClient = null;
         this.authToken = null;
         this.deviceContexts = new Map();
+        this.eventCodeCache = null;
+        this.eventCodeCacheInitialized = false;
         this.pollTimer = null;
         this.refreshInFlight = null;
         this.unloaded = false;
@@ -309,7 +312,7 @@ class AnthbotGenieAdapter extends utils.Adapter {
         if (this.pollTimer) {
             this.clearTimeout(this.pollTimer);
         }
-        const intervalSeconds = Math.max(10, Number(this.config.pollInterval) || 30);
+        const intervalSeconds = Math.max(10, Number(this.config.pollInterval) || 60);
         this.pollTimer = this.setTimeout(async () => {
             this.pollTimer = null;
             try {
@@ -342,6 +345,7 @@ class AnthbotGenieAdapter extends utils.Adapter {
         try {
             await this.ensureSession(forceLogin);
             await this.discoverDevices(forceLogin);
+            await this.ensureEventCodeCache();
             for (const context of this.deviceContexts.values()) {
                 try {
                     await this.refreshDevice(context);
@@ -361,6 +365,92 @@ class AnthbotGenieAdapter extends utils.Adapter {
         await this.setStateAsync("info.connection", successful > 0, true);
     }
 
+    async ensureEventCodeCache() {
+        if (this.eventCodeCacheInitialized) {
+            return;
+        }
+        this.eventCodeCacheInitialized = true;
+
+        const cached = await this.readStoredEventCodeCache();
+        this.eventCodeCache = cached;
+
+        let cloudVersion = null;
+        try {
+            cloudVersion = await this.cloudClient.getEventCodeVersion();
+        } catch (error) {
+            if (cached) {
+                this.log.warn(`Failed to fetch event code version, using cached translations: ${error.message}`);
+                await this.writeEventCodeCacheToDevices(cached);
+            } else {
+                this.log.warn(`Failed to fetch event code version and no cached translations are available: ${error.message}`);
+            }
+            return;
+        }
+
+        if (cached && asInteger(cached.version) === cloudVersion) {
+            this.eventCodeCache = cached;
+            await this.writeEventCodeCacheToDevices(cached);
+            return;
+        }
+
+        try {
+            const payload = await this.cloudClient.getEventCodeTranslations(cloudVersion);
+            this.eventCodeCache = {
+                version: cloudVersion,
+                fetchedAt: new Date().toISOString(),
+                payload,
+            };
+            await this.writeEventCodeCacheToDevices(this.eventCodeCache);
+        } catch (error) {
+            if (cached) {
+                this.log.warn(`Failed to fetch event code translations, using cached translations: ${error.message}`);
+                this.eventCodeCache = cached;
+                await this.writeEventCodeCacheToDevices(cached);
+            } else {
+                this.log.warn(`Failed to fetch event code translations and no cached translations are available: ${error.message}`);
+            }
+        }
+    }
+
+    async readStoredEventCodeCache() {
+        for (const context of this.deviceContexts.values()) {
+            const serial = context.device.serialNumber;
+            try {
+                const state = await this.getStateAsync(`${serial}.raw.shadow.event-code`);
+                const raw = typeof state?.val === "string" ? state.val : "";
+                if (!raw) {
+                    continue;
+                }
+                const parsed = JSON.parse(raw);
+                if (this.isValidEventCodeCache(parsed)) {
+                    return parsed;
+                }
+            } catch (error) {
+                this.log.debug(`Stored event code cache could not be read for ${serial}: ${error.message}`);
+            }
+        }
+        return null;
+    }
+
+    isValidEventCodeCache(cache) {
+        return Boolean(cache
+            && typeof cache === "object"
+            && asInteger(cache.version) != null
+            && cache.payload
+            && typeof cache.payload === "object"
+            && !Array.isArray(cache.payload));
+    }
+
+    async writeEventCodeCacheToDevices(cache) {
+        if (!cache) {
+            return;
+        }
+        const value = JSON.stringify(cache);
+        for (const context of this.deviceContexts.values()) {
+            await this.setStateAsync(`${context.device.serialNumber}.raw.shadow.event-code`, { val: value, ack: true });
+        }
+    }
+
     async ensureSession(force = false) {
         if (!this.cloudClient || force) {
             this.cloudClient = new AnthbotCloudApiClient({
@@ -623,7 +713,7 @@ class AnthbotGenieAdapter extends utils.Adapter {
             "metrics.map.totalArea": typeof data.map_area === "number" ? data.map_area : null,
             "metrics.map.status": asText(safeGet(data, "map_sta", "value")),
             "metrics.error.code": asInteger(data.err_code),
-            "metrics.error.description": asText(errorDescription(data)),
+            "metrics.error.description": asText(errorDescription(data, this.eventCodeCache, this.config.errorDescriptionLanguage || "English")),
             "metrics.error.active": isNonZero(data.err_code),
 
             "location.gps.latitude": typeof safeGet(data, "anti_loss_pose", "posegps", "lat") === "number" ? safeGet(data, "anti_loss_pose", "posegps", "lat") : null,
@@ -701,6 +791,7 @@ class AnthbotGenieAdapter extends utils.Adapter {
 
             "raw.shadow.property": JSON.stringify(context.lastReported || {}),
             "raw.shadow.service": JSON.stringify(context.lastService || {}),
+            "raw.shadow.event-code": JSON.stringify(this.eventCodeCache || {}),
             "raw.areaDefinition": JSON.stringify(context.areaDefinition || {}),
         };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.anthbot-genie",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Unofficial ioBroker adapter for Anthbot Genie robotic lawn mowers with cloud telemetry, diagnostics, consumables, zones, and controls.",
   "author": "reloxx13",
   "license": "MIT",