iobroker.lorawan 1.22.31 → 1.22.32

package/README.md

@@ -19,11 +19,18 @@ 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
 
@@ -37,12 +44,18 @@ 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)
 
+## 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.
+
+
 ## License
 MIT License
 

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "lorawan",
-    "version": "1.22.31",
+    "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",
@@ -80,19 +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为名称的一部分添加子分配"
       }
     },
     "titleLang": {

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.lorawan",
-  "version": "1.22.31",
+  "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",