iobroker.lorawan 1.22.30 → 1.22.32

package/README.md

@@ -19,11 +19,21 @@ The documentation Wiki is here: https://github.com/BenAhrdt/ioBroker.lorawan/wik
 <br/>
 For now there is documentation in English here: https://wiki.hafenmeister.de
 
+### Home Assistant sensor discovery
+
+For numeric sensor entities, the bridge assigns Home Assistant `device_class` and `state_class` attributes according to the adapter's counter-first convention. Current measurements use `measurement`. Energy values in `Wh`, `kWh`, or `MWh`, as well as values identified by an ioBroker energy or consumption role, are treated as consumption counters and use `total_increasing` for Home Assistant energy statistics. If a quantity cannot be distinguished reliably from a consumption reading, the bridge prefers counter semantics: `m³` and `ft³` are published as `gas` with `total_increasing`, and `L` as `water` with `total_increasing`. `mL` and `gal` remain generic `volume` values. Ambiguous concentration units such as `ppm`, `ppb`, or `µg/m³` do not imply a specific substance. `L/min`, `L/s`, and `m³/h` use `volume_flow_rate`.
+
 ## Changelog
 <!--
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 1.22.32 (2026-08-19)
+- (BenAhrdt) Align Home Assistant sensor device classes, state classes, and units with the current specification
+
+### 1.22.31 (2026-07-09)
+- (BenAhrdt) Add selection of ToIob source id
+
 ### 1.22.30 (2026-07-07)
 - (BenAhrdt) Add PIR Mini device Profile
 - (BenAhrdt) Add possibillity to ad states to downlink numbers
@@ -34,14 +44,17 @@ For now there is documentation in English here: https://wiki.hafenmeister.de
 ### 1.22.28 (2026-07-05)
 - (BenAhrdt) Add DewPointTemperature to assignhandler
 
-### 1.22.27 (2026-07-04)
-- (BenAhrdt) Bugfix warning for wrong id
-- (BenAhrdt) Add Profile to downloadconfig
+[Older changes can be found there](CHANGELOG_OLD.md)
 
-### 1.22.26 (2026-07-04)
-- (BenAhrdt) Add ststes into Lock entity for ToIob devices
+## DISCLAIMER
+The rights of the trademarks and company names, remain with their owners and have no relation to this adapter. The fairuse policy must continue to be adhered to by the operator of the adapter. If this repository is forked, it must be cited as the source.
+
+LoRa® is a registered trademark or service mark of Semtech Corporation or its affilantes.
+
+LoRaWAN® is a licensed mark.
+
+I have no affiliation with the mentioned brands or their subsidiaries, logos, or trademarks, nor am I endorsed by them.
 
-[Older changes can be found there](CHANGELOG_OLD.md)
 
 ## License
 MIT License

package/admin/i18n/de.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "aus",
     "BridgeTypeSH": "Smart Home",
     "BridgeTypeTooltip": "Wählen Sie den Typ des Fremdsystems aus",
+    "BridgeToIobIdSource": "ToIob-ID Quelle",
+    "BridgeToIobIdSourceTooltip": "Wählen Sie, ob ToIob-Geräte ihre ioBroker-State-ID aus der entity_id oder unique_id bilden",
     "BridgenotificationActivation": "Benachrichtigungsaktivierung",
     "BridgenotificationTooltip": "Aktivieren oder deaktivieren Sie die Benachrichtigung",
     "ClimateActTemperatureText": "Isttemperatur",

package/admin/i18n/en.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "off",
     "BridgeTypeSH": "Smart Home",
     "BridgeTypeTooltip": "Select the Type of the foreign System",
+    "BridgeToIobIdSource": "ToIob ID source",
+    "BridgeToIobIdSourceTooltip": "Select whether ToIob devices build their ioBroker state ID from entity_id or unique_id",
     "BridgenotificationActivation": "notification activation",
     "BridgenotificationTooltip": "activate or deactivate the notification",
     "ClimateActTemperatureText": "Target Temperature",

package/admin/i18n/es.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "apagado",
     "BridgeTypeSH": "Hogar inteligente",
     "BridgeTypeTooltip": "Seleccione el tipo de sistema externo",
+    "BridgeToIobIdSource": "Fuente de ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Seleccione si los dispositivos ToIob crean su ID de estado de ioBroker desde entity_id o unique_id",
     "BridgenotificationActivation": "activación de notificación",
     "BridgenotificationTooltip": "activar o desactivar la notificación",
     "ClimateActTemperatureText": "Temperatura objetivo",

package/admin/i18n/fr.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "désactivé",
     "BridgeTypeSH": "Maison intelligente",
     "BridgeTypeTooltip": "Sélectionnez le type du système étranger",
+    "BridgeToIobIdSource": "Source d'ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Choisissez si les appareils ToIob créent leur ID d'état ioBroker à partir de entity_id ou unique_id",
     "BridgenotificationActivation": "activation des notifications",
     "BridgenotificationTooltip": "activer ou désactiver la notification",
     "ClimateActTemperatureText": "Température cible",

package/admin/i18n/it.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "spento",
     "BridgeTypeSH": "Casa intelligente",
     "BridgeTypeTooltip": "Selezionare la Tipologia del Sistema estero",
+    "BridgeToIobIdSource": "Origine ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Scegliere se i dispositivi ToIob creano l'ID stato ioBroker da entity_id o unique_id",
     "BridgenotificationActivation": "attivazione delle notifiche",
     "BridgenotificationTooltip": "attivare o disattivare la notifica",
     "ClimateActTemperatureText": "Temperatura target",

package/admin/i18n/nl.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "uit",
     "BridgeTypeSH": "Slim huis",
     "BridgeTypeTooltip": "Selecteer het type van het buitenlandse systeem",
+    "BridgeToIobIdSource": "ToIob-ID-bron",
+    "BridgeToIobIdSourceTooltip": "Selecteer of ToIob-apparaten hun ioBroker-state-ID maken uit entity_id of unique_id",
     "BridgenotificationActivation": "melding activering",
     "BridgenotificationTooltip": "activeer of deactiveer de melding",
     "ClimateActTemperatureText": "Doeltemperatuur",

package/admin/i18n/pl.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "wyłączony",
     "BridgeTypeSH": "Inteligentny dom",
     "BridgeTypeTooltip": "Wybierz typ obcego systemu",
+    "BridgeToIobIdSource": "Źródło ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Wybierz, czy urządzenia ToIob tworzą ID stanu ioBroker z entity_id czy unique_id",
     "BridgenotificationActivation": "aktywacja powiadomień",
     "BridgenotificationTooltip": "włączyć lub wyłączyć powiadomienie",
     "ClimateActTemperatureText": "Temperatura docelowa",

package/admin/i18n/pt.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "desligado",
     "BridgeTypeSH": "Casa inteligente",
     "BridgeTypeTooltip": "Selecione o tipo do sistema externo",
+    "BridgeToIobIdSource": "Fonte de ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Selecione se os dispositivos ToIob criam o ID de estado ioBroker a partir de entity_id ou unique_id",
     "BridgenotificationActivation": "ativação de notificação",
     "BridgenotificationTooltip": "ativar ou desativar a notificação",
     "ClimateActTemperatureText": "Temperatura alvo",

package/admin/i18n/ru.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "выключенный",
     "BridgeTypeSH": "Умный дом",
     "BridgeTypeTooltip": "Выберите тип сторонней системы",
+    "BridgeToIobIdSource": "Источник ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Выберите, создают ли устройства ToIob ID состояния ioBroker из entity_id или unique_id",
     "BridgenotificationActivation": "активация уведомления",
     "BridgenotificationTooltip": "активировать или деактивировать уведомление",
     "ClimateActTemperatureText": "Целевая температура",

package/admin/i18n/uk.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "вимкнено",
     "BridgeTypeSH": "Розумний будинок",
     "BridgeTypeTooltip": "Виберіть тип сторонньої системи",
+    "BridgeToIobIdSource": "Джерело ID ToIob",
+    "BridgeToIobIdSourceTooltip": "Виберіть, чи пристрої ToIob створюють ID стану ioBroker з entity_id або unique_id",
     "BridgenotificationActivation": "активація сповіщень",
     "BridgenotificationTooltip": "активувати або деактивувати сповіщення",
     "ClimateActTemperatureText": "Цільова температура",

package/admin/i18n/zh-cn.json

@@ -28,6 +28,8 @@
     "BridgeTypeOff": "离开",
     "BridgeTypeSH": "智能家居",
     "BridgeTypeTooltip": "选择外部系统类型",
+    "BridgeToIobIdSource": "ToIob ID 来源",
+    "BridgeToIobIdSourceTooltip": "选择 ToIob 设备从 entity_id 还是 unique_id 创建 ioBroker state ID",
     "BridgenotificationActivation": "通知激活",
     "BridgenotificationTooltip": "激活或停用通知",
     "ClimateActTemperatureText": "目标温度",

package/admin/jsonConfig.json

@@ -878,6 +878,23 @@
                     "lg": 3,
                     "xl": 3
                 },
+                "BridgeToIobIdSource": {
+                    "newLine": true,
+                    "type": "select",
+                    "label": "BridgeToIobIdSource",
+                    "hidden": "data.BridgeType === 'off'",
+                    "tooltip": "BridgeToIobIdSourceTooltip",
+                    "options": [
+                        { "label": "Entity Id", "value": "entity_id" },
+                        { "label": "Unique Id", "value": "unique_id" }
+                    ],
+                    "default": "entity_id",
+                    "xs": 12,
+                    "sm": 3,
+                    "md": 3,
+                    "lg": 3,
+                    "xl": 3
+                },
                 "_BridgeServersettingsHeader": {
                     "newLine": true,
                     "type": "header",

package/io-package.json

@@ -1,8 +1,34 @@
 {
   "common": {
     "name": "lorawan",
-    "version": "1.22.30",
+    "version": "1.22.32",
     "news": {
+      "1.22.32": {
+        "en": "Align Home Assistant sensor device classes, state classes, and units with the current specification",
+        "de": "Richten Sie die Sensorgeräteklassen, Statusklassen und Einheiten von Home Assistant an die aktuelle Spezifikation aus.",
+        "ru": "Приведите классы сенсорных устройств Home Assistant, классы состояний и единицы измерения в соответствие с текущими спецификациями.",
+        "pt": "Alinhe as classes de dispositivos de sensores, classes de estado e unidades do Home Assistant com a especificação atual.",
+        "nl": "Stem de apparaatklassen, statusklassen en eenheden van de Home Assistant-sensoren af op de huidige specificaties.",
+        "fr": "Alignez les classes de périphériques de capteurs, les classes d'état et les unités de Home Assistant avec les spécifications actuelles.",
+        "it": "Allineare le classi dei dispositivi sensore di Home Assistant, le classi di stato e le unità con le specifiche attuali",
+        "es": "Alinee las clases de dispositivos de sensores, las clases de estado y las unidades de Home Assistant con la especificación actual.",
+        "pl": "Dostosuj klasy urządzeń czujników Home Assistant, klasy stanów i jednostki do bieżącej specyfikacji",
+        "uk": "Узгодьте класи сенсорних пристроїв, класи станів та одиниці Home Assistant із поточною специфікацією",
+        "zh-cn": "将 Home Assistant 传感器设备类、状态类和单位与当前规范保持一致。"
+      },
+      "1.22.31": {
+        "en": "Add selection of ToIob source id",
+        "de": "Auswahl der ToIob-Quell-ID hinzufügen",
+        "ru": "Добавить выборку идентификатора источника ToIob",
+        "pt": "Adicionar seleção de ID da fonte ToIob",
+        "nl": "Voeg een selectie van de ToIob-bron-ID toe.",
+        "fr": "Ajouter une sélection d'identifiants de source ToIob",
+        "it": "Aggiungi selezione ID sorgente ToIob",
+        "es": "Agregar selección de ID de origen ToIob",
+        "pl": "Dodaj wybór identyfikatora źródłowego obiektu ToIob",
+        "uk": "Додати вибір ідентифікатора джерела ToIob",
+        "zh-cn": "添加 ToIob 源 ID 的选择"
+      },
       "1.22.30": {
         "en": "Add PIR Mini device Profile\nAdd possibillity to ad states to downlink numbers",
         "de": "PIR-Mini-Geräteprofil hinzufügen\nFüge die Möglichkeit hinzu, Anzeigenstatus zu Downlink-Nummern hinzuzufügen",
@@ -67,32 +93,6 @@
         "pl": "Dodaj stacje do encji blokady dla urządzeń ToIob",
         "uk": "Додати станції до сутності блокування для пристроїв ToIob",
         "zh-cn": "将状态添加到锁定实体中，用于 ToIob 设备"
-      },
-      "1.22.25": {
-        "en": "Change Assignhandler for case intensive Check\nAdd subAssign for a part of name",
-        "de": "Ändern Sie den Zuweisungshandler für die fallintensive Prüfung.\nFüge Unterzuweisung für einen Teil des Namens hinzu",
-        "ru": "Изменить обработчик назначений для проверки с интенсивным использованием регистров.\nДобавить подназначение для части имени",
-        "pt": "Alterar o Assignhandler para verificação que exige alta sensibilidade a maiúsculas e minúsculas.\nAdicionar subatribuição para uma parte do nome",
-        "nl": "Wijzig de Assignhandler voor case-intensieve controles.\nVoeg een subtoewijzing toe voor een deel van de naam.",
-        "fr": "Modifier le gestionnaire d'affectation pour la vérification intensive des cas\nAjouter une sous-affectation pour une partie du nom",
-        "it": "Cambia Assegnatore gestore per controllo intensivo dei casi\nAggiungi subAssegna per una parte del nome",
-        "es": "Modificar Assignhandler para comprobación intensiva de casos\nAgregar subAsignación para una parte del nombre",
-        "pl": "Zmień Assignhandler na kontrolę intensywnie wykorzystującą przypadek\nDodaj podprzypisanie dla części nazwy",
-        "uk": "Змінити обробник присвоєння для перевірки з інтенсивним виконанням регістрів\nДодати subAssign для частини імені",
-        "zh-cn": "更改案例密集型检查的分配处理程序\n为名称的一部分添加子分配"
-      },
-      "1.22.24": {
-        "en": "Add Absolute Humidity to device_class",
-        "de": "Füge der Geräteklasse die absolute Luftfeuchtigkeit hinzu.",
-        "ru": "Добавить абсолютную влажность в device_class",
-        "pt": "Adicionar umidade absoluta à classe do dispositivo",
-        "nl": "Voeg absolute luchtvochtigheid toe aan de device_class.",
-        "fr": "Ajouter l'humidité absolue à la classe de périphérique",
-        "it": "Aggiungi l'umidità assoluta alla classe di dispositivi",
-        "es": "Agregar humedad absoluta a device_class",
-        "pl": "Dodaj wilgotność bezwzględną do device_class",
-        "uk": "Додати абсолютну вологість до класу пристроїв",
-        "zh-cn": "将绝对湿度添加到设备类"
       }
     },
     "titleLang": {
@@ -429,6 +429,7 @@
     "RefreshDiscoveryCronJob": "0 * * * *",
     "BridgeEnum": "*",
     "BridgenotificationActivation": "allNotifications, bridgeConnection, newDiscover, deviceState",
+    "BridgeToIobIdSource": "entity_id",
     "BridgeDevicesToGenerate": [
       "toIobDevices",
       "foreignDevices",

package/lib/modules/bridge.js

@@ -115,20 +115,25 @@ class bridgeClass extends EventEmiter {
             var: { device_class: 'reactive_power' },
             kvar: { device_class: 'reactive_power' },
 
+            // Energy values bridged by this adapter represent consumption
+            // counters and need TOTAL_INCREASING for Home Assistant's energy
+            // statistics and Energy Dashboard.
             Wh: { device_class: 'energy', state_class: 'total_increasing' },
             kWh: { device_class: 'energy', state_class: 'total_increasing' },
             MWh: { device_class: 'energy', state_class: 'total_increasing' },
 
+            // For ambiguous consumption units, this adapter deliberately
+            // prefers counter semantics so Home Assistant can evaluate them.
             'm³': { device_class: 'gas', state_class: 'total_increasing' },
             'ft³': { device_class: 'gas', state_class: 'total_increasing' },
 
-            l: { device_class: 'water', state_class: 'total_increasing' },
-            ml: { device_class: 'volume' },
+            L: { device_class: 'water', state_class: 'total_increasing' },
+            mL: { device_class: 'volume' },
             gal: { device_class: 'volume' },
 
-            'L/min': { device_class: 'volumetric_flow_rate' },
-            'L/s': { device_class: 'volumetric_flow_rate' },
-            'm³/h': { device_class: 'volumetric_flow_rate' },
+            'L/min': { device_class: 'volume_flow_rate' },
+            'L/s': { device_class: 'volume_flow_rate' },
+            'm³/h': { device_class: 'volume_flow_rate' },
 
             Pa: { device_class: 'pressure' },
             hPa: { device_class: 'pressure' },
@@ -137,9 +142,11 @@ class bridgeClass extends EventEmiter {
             bar: { device_class: 'pressure' },
             psi: { device_class: 'pressure' },
 
-            ppm: { device_class: 'carbon_dioxide' },
-            ppb: { device_class: 'volatile_organic_compounds_parts' },
-            'µg/m³': { device_class: 'volatile_organic_compounds' },
+            // Concentration units are shared by CO2, CO, VOC and several
+            // other device classes, so a device class cannot be inferred.
+            ppm: {},
+            ppb: {},
+            'µg/m³': {},
 
             'W/m²': { device_class: 'irradiance' },
             mm: { device_class: 'precipitation' },
@@ -1667,6 +1674,9 @@ class bridgeClass extends EventEmiter {
                     (role.includes('power.consumption') && normalizedUnitLower.includes('wh'))
                 ) {
                     attributes.device_class = 'energy';
+                    // Energy and consumption roles represent monotonically
+                    // increasing counters used by Home Assistant's energy
+                    // statistics and Energy Dashboard.
                     attributes.state_class = 'total_increasing';
                     attributes.unit_of_measurement = normalizedUnit || 'Wh';
                 } else if (role.includes('weight')) {
@@ -1683,7 +1693,9 @@ class bridgeClass extends EventEmiter {
                         attributes.unit_of_measurement = normalizedUnit;
 
                         if (this.unitMap[normalizedUnit]) {
-                            attributes.device_class = this.unitMap[normalizedUnit].device_class;
+                            if (this.unitMap[normalizedUnit].device_class) {
+                                attributes.device_class = this.unitMap[normalizedUnit].device_class;
+                            }
 
                             // Falls es in unitMap einen gültigen Eintrag gibt UND noch keine state_class gesetzt wurde
                             if (!attributes.state_class && this.unitMap[normalizedUnit].state_class) {
@@ -1706,11 +1718,29 @@ class bridgeClass extends EventEmiter {
                     attributes.max = common.max;
                 }
 
-                // Es muss eine Device Class zugewiesen sein und der State darf kein String sein.
-                // String ist kein Measurement
-                if (!attributes.state_class && type !== 'string') {
+                // state_class is a sensor-only property. Home Assistant does
+                // not allow MEASUREMENT for classes representing totals.
+                const classesWithoutMeasurement = new Set([
+                    'date',
+                    'energy',
+                    'enum',
+                    'gas',
+                    'monetary',
+                    'timestamp',
+                    'volume',
+                    'water',
+                ]);
+                if (
+                    entityType === 'sensor' &&
+                    !attributes.state_class &&
+                    type !== 'string' &&
+                    !classesWithoutMeasurement.has(attributes.device_class)
+                ) {
                     attributes.state_class = 'measurement';
                 }
+                if (entityType !== 'sensor') {
+                    delete attributes.state_class;
+                }
             }
 
             if (entityType === 'valve') {
@@ -1800,8 +1830,8 @@ class bridgeClass extends EventEmiter {
             .replace(/^mcg\/m3$/i, 'µg/m³')
             .replace(/^um\/m3$/i, 'µg/m³')
 
-            .replace(/^L\/min$/i, 'l/min')
-            .replace(/^L\/s$/i, 'l/s')
+            .replace(/^L\/min$/i, 'L/min')
+            .replace(/^L\/s$/i, 'L/s')
 
             .replace(/^m\^?3\/h$/i, 'm³/h')
 

package/lib/modules/bridgeDeviceHandler.js

@@ -773,8 +773,9 @@ class bridgeDeviceHandlerClass {
         const activeFunction = 'bridgeDeviceHandler.js - buildSafeStateId';
         this.adapter.log.silly(`Function ${activeFunction} started.`);
         try {
-            // 1. Basis: unique_id oder entity_id
-            const baseId = entity.unique_id || entity.entity_id;
+            const idSource = this.adapter.config.BridgeToIobIdSource || 'entity_id';
+            const baseId =
+                idSource === 'unique_id' ? entity.unique_id || entity.entity_id : entity.entity_id || entity.unique_id;
 
             if (!baseId) {
                 return null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.lorawan",
-  "version": "1.22.30",
+  "version": "1.22.32",
   "description": "converts the desired lora gateway data to a ioBroker structure",
   "author": {
     "name": "BenAhrdt",
@@ -26,10 +26,10 @@
   },
   "dependencies": {
     "@iobroker/adapter-core": "^3.4.1",
-    "@iobroker/dm-utils": "^3.0.19",
+    "@iobroker/dm-utils": "^3.1.4",
     "easy-crc": "^1.1.0",
     "lodash": "^4.18.1",
-    "mqtt": "^5.15.1",
+    "mqtt": "^5.15.2",
     "node-schedule": "^2.1.1"
   },
   "devDependencies": {
@@ -39,10 +39,10 @@
     "@alcalzone/release-script-plugin-manual-review": "^5.2.0",
     "@iobroker/adapter-dev": "^1.5.0",
     "@iobroker/eslint-config": "^2.2.0",
-    "@iobroker/testing": "^5.2.2",
+    "@iobroker/testing": "^5.3.0",
     "@tsconfig/node22": "^22.0.5",
     "@types/lodash": "^4.17.24",
-    "@types/node": "^22.19.19",
+    "@types/node": "^22.20.1",
     "typescript": "~5.9.3"
   },
   "main": "main.js",