iobroker.nuasense 0.2.1 → 0.2.2

package/README.md

@@ -9,11 +9,11 @@
 
 ## NuaSense adapter for ioBroker
 
-What your weather station means for your house and garden, as ioBroker states — and, if you like, your station forwarded from ioBroker to NuaSense. The first three stations on a NuaSense account connect free.
+What your weather station means for your house and garden, as ioBroker states — and, if you like, your station forwarded from ioBroker to [NuaSense](https://nuasense.com). The first three stations on a NuaSense account connect free.
 
 ### Read
 
-Make an API key in the NuaSense console under **API Keys** (scope `ingest:write`; it is what reads your own stations), put it into the adapter, and tell it what the garden mostly is (lawn, vegetables, flower beds and shrubs) and your sprinkler's rate in mm per hour (pop-up sprinkler about 10, drip line 2–4; 0 for millimetres only). Every 15 minutes (configurable) the adapter writes, per station:
+Make an API key in the [NuaSense console](https://platform.nuasense.com) under **API Keys** (scope `ingest:write`; it is what reads your own stations), put it into the adapter, and tell it what the garden mostly is (lawn, vegetables, flower beds and shrubs) and your sprinkler's rate in mm per hour (pop-up sprinkler about 10, drip line 2–4; 0 for millimetres only). Every 15 minutes (configurable) the adapter writes, per station:
 
 | state | meaning |
 |---|---|
@@ -46,6 +46,9 @@ When you connect a station, NuaSense stores its readings and computes your forec
     Placeholder for the next version (at the beginning of the line):
     ### **WORK IN PROGRESS**
 -->
+### 0.2.2 (2026-11-09)
+* (NuaSense) object structure for the review: folders and channels for all states, valid roles, no null values
+
 ### 0.2.1 (2026-11-05)
 * (NuaSense) checker fixes: workflow and tooling
 
@@ -58,6 +61,8 @@ When you connect a station, NuaSense stores its readings and computes your forec
 ### 0.1.0 (2026-11-03)
 * (NuaSense) first release: first look and hourly agronomy as states; optional forwarding of a station from ioBroker to NuaSense
 
+Older changes: [CHANGELOG_OLD.md](CHANGELOG_OLD.md)
+
 ## License
 MIT License
 

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "nuasense",
-    "version": "0.2.1",
+    "version": "0.2.2",
     "news": {
+      "0.2.2": {
+        "en": "Object structure for the review: folders and channels for all states, valid roles, no null values",
+        "de": "Objektstruktur für das Review: Ordner und Kanäle für alle States, gültige Rollen, keine Nullwerte",
+        "ru": "Структура объектов для проверки: папки и каналы для всех состояний, допустимые роли, без значений null",
+        "pt": "Estrutura de objetos para a revisão: pastas e canais para todos os estados, funções válidas, sem valores nulos",
+        "nl": "Objectstructuur voor de review: mappen en kanalen voor alle states, geldige rollen, geen null-waarden",
+        "fr": "Structure des objets pour la revue : dossiers et canaux pour tous les états, rôles valides, aucune valeur nulle",
+        "it": "Struttura degli oggetti per la revisione: cartelle e canali per tutti gli stati, ruoli validi, nessun valore nullo",
+        "es": "Estructura de objetos para la revisión: carpetas y canales para todos los estados, roles válidos, sin valores nulos",
+        "pl": "Struktura obiektów do przeglądu: foldery i kanały dla wszystkich stanów, poprawne role, bez wartości null",
+        "uk": "Структура об'єктів для перевірки: папки та канали для всіх станів, допустимі ролі, без значень null",
+        "zh-cn": "用于审核的对象结构：所有状态都有文件夹和通道，角色有效，没有空值"
+      },
       "0.2.1": {
         "en": "Checker fixes: workflow and tooling",
         "de": "Checker-Korrekturen: Workflow und Werkzeuge",

package/main.js

@@ -20,6 +20,7 @@
 
 const utils = require('@iobroker/adapter-core');
 const { toEcowitt, encodeForm, uploadUrl } = require('./lib/ecowitt');
+const { version } = require('./package.json');
 
 const FORWARD_EVERY_MS = 60_000;
 const MIN_POLL_MINUTES = 5;
@@ -126,11 +127,19 @@ class Nuasense extends utils.Adapter {
 
     async updateStation(station) {
         const id = `stations.${sanitize(station.station_id)}`;
+        await this.setObjectNotExistsAsync('stations', {
+            type: 'folder',
+            common: { name: 'Stations' },
+            native: {},
+        });
         await this.extendObjectAsync(id, {
-            type: 'channel',
+            type: 'device',
             common: { name: station.name || station.station_id },
             native: { station_id: station.station_id },
         });
+        await this.channel(`${id}.tonight`, 'Tonight');
+        await this.channel(`${id}.garden`, 'Garden');
+        await this.channel(`${id}.plausibility`, 'Plausibility');
 
         const push = station.push || {};
         await this.put(`${id}.lastUpload`, push.last_push_at || null, {
@@ -204,7 +213,7 @@ class Nuasense extends utils.Adapter {
         await this.put(`${id}.garden.rainNext24h`, numOrNull(w.rain_next_24h_mm), {
             name: 'Rain forecast, next 24 h',
             type: 'number',
-            role: 'value.precipitation.forecast',
+            role: 'value.precipitation.forecast.0',
             unit: 'mm',
         });
         await this.put(`${id}.garden.rainLast24h`, numOrNull(w.rain_last_24h_mm), {
@@ -253,6 +262,8 @@ class Nuasense extends utils.Adapter {
         if (!this.config.advanced) {
             return;
         }
+        await this.channel(`${id}.spray`, 'Spray window');
+        await this.channel(`${id}.hourly`, 'Hourly agronomy');
         const s = (look && look.spray) || {};
         await this.put(`${id}.spray.window`, s.window ? `${s.window.from}–${s.window.to}` : s.date ? 'none' : null, {
             name: 'Next spray window',
@@ -267,7 +278,7 @@ class Nuasense extends utils.Adapter {
         await this.put(`${id}.spray.windMax`, numOrNull(s.wind_max_ms), {
             name: 'Highest wind in the window',
             type: 'number',
-            role: 'value.speed',
+            role: 'value.speed.max.wind',
             unit: 'm/s',
         });
         await this.put(`${id}.spray.reason`, s.reason || null, {
@@ -366,13 +377,30 @@ class Nuasense extends utils.Adapter {
         }
     }
 
-    /** Create the state if needed, then write it acknowledged. */
+    /** A channel that groups the states below it. */
+    async channel(id, name) {
+        await this.setObjectNotExistsAsync(id, {
+            type: 'channel',
+            common: { name },
+            native: {},
+        });
+    }
+
+    /**
+     * Create the state if needed, then write it acknowledged. With nothing to
+     * report the stored value goes away: null would break the declared type, and
+     * keeping the old value would show yesterday's answer as today's.
+     */
     async put(id, value, common) {
         await this.setObjectNotExistsAsync(id, {
             type: 'state',
             common: { read: true, write: false, ...common },
             native: {},
         });
+        if (value === null || value === undefined) {
+            await this.delStateAsync(id);
+            return;
+        }
         await this.setStateAsync(id, { val: value, ack: true });
     }
 
@@ -420,7 +448,7 @@ class Nuasense extends utils.Adapter {
         };
         const fields = toEcowitt(reading, {
             deviceId: cfg.forwardDeviceId || `iobroker-${this.namespace}`,
-            stationType: 'iobroker.nuasense_V0.2.1',
+            stationType: `iobroker.nuasense_V${version}`,
         });
         if (Object.keys(fields).length <= 3) {
             // PASSKEY, stationtype, dateutc and nothing else: no mapped state had a value.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.nuasense",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "NuaSense for ioBroker: what your weather station means for your house and garden (frost tonight, watering today, rain next 24 h, plausibility), and optionally forward a station from ioBroker to NuaSense",
   "author": {
     "name": "NuaSense",