iobroker.absolutehumidity 0.0.3 → 0.0.4

package/README.md

@@ -14,17 +14,38 @@
 
 build absolute humidity from actual temperature and relative humidity
 
+## Calculation method
+
+The adapter uses empirical Magnus approximation formulas to calculate the
+saturation vapor pressure from temperature and relative humidity.
+
+* Absolute humidity is calculated from the saturation vapor pressure using the
+  Magnus/Bolton approximation and the ideal gas law. The result is returned in
+  g/m³.
+* Dew point temperature is calculated using the Magnus formula with Sonntag
+  coefficients. The result is returned in °C.
+
+Small deviations from online tables are expected because different tables often
+use different Magnus, Tetens, Sonntag, Bolton or Buck coefficient sets.
+
+![Kachel](image.png)
+
 ## Changelog
 <!--
 	Placeholder for the next version (at the beginning of the line):
 	### **WORK IN PROGRESS**
 -->
+### 0.0.4 (2026-07-05)
+* (BenAhrdt) Build Config in adapter own device object
+
 ### 0.0.3 (2026-07-05)
 * (BenAhrdt) Add new features and icons to deviceManager
 
 ### 0.0.2 (2026-07-05)
 * (BenAhrdt) initial release
 
+[Older changes can be found there](CHANGELOG_OLD.md)
+
 ## License
 MIT License
 
@@ -46,4 +67,4 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.

package/io-package.json

@@ -1,8 +1,21 @@
 {
   "common": {
     "name": "absolutehumidity",
-    "version": "0.0.3",
+    "version": "0.0.4",
     "news": {
+      "0.0.4": {
+        "en": "Build Config in adapter own device object",
+        "de": "Konfiguration im eigenen Geräteobjekt des Adapters erstellen",
+        "ru": "Создайте конфигурацию в собственном объекте устройства адаптера.",
+        "pt": "Configuração de construção no objeto de dispositivo próprio do adaptador",
+        "nl": "Bouw de configuratie in het eigen apparaatobject van de adapter.",
+        "fr": "Configurer l'objet périphérique propre à l'adaptateur",
+        "it": "Costruisci la configurazione nell'oggetto dispositivo dell'adattatore",
+        "es": "Construir la configuración en el objeto de dispositivo propio del adaptador",
+        "pl": "Konfiguracja kompilacji w obiekcie własnego urządzenia adaptera",
+        "uk": "Збірка конфігурації у власному об'єкті пристрою адаптера",
+        "zh-cn": "适配器自身设备对象中的构建配置"
+      },
       "0.0.3": {
         "en": "Add new features and icons to deviceManager",
         "de": "Füge dem Gerätemanager neue Funktionen und Symbole hinzu.",
@@ -127,9 +140,18 @@
       }
     ]
   },
-  "native": {
-    "devices": []
-  },
+  "native": {},
   "objects": [],
-  "instanceObjects": []
+  "instanceObjects": [
+    {
+      "_id": "devices",
+      "type": "folder",
+      "common": {
+        "name": "Devices"
+      },
+      "native": {
+        "devices": []
+      }
+    }
+  ]
 }

package/lib/modules/deviceManager.js

@@ -40,6 +40,11 @@ const STATE_ICONS = {
 	`),
 };
 
+const TEMPERATURE_STATE_FILTER =
+	"const unit = String(obj.common?.unit || '').trim().toLowerCase().replace(/\\s+/g, ''); return obj.type === 'state' && obj.common?.type === 'number' && (unit === '' || unit === '°c' || unit === 'c' || unit === '°f' || unit === 'f');";
+const RELATIVE_HUMIDITY_STATE_FILTER =
+	"const unit = String(obj.common?.unit || '').trim().toLowerCase().replace(/\\s+/g, ''); return obj.type === 'state' && obj.common?.type === 'number' && (unit === '' || unit === '%');";
+
 class AbsoluteHumidityDeviceManagement extends DeviceManagement {
 	/**
 	 * @param {import('../../main')} adapter
@@ -322,6 +327,7 @@ function getDeviceFormSchema() {
 						type: 'number',
 					},
 				},
+				filterFunc: TEMPERATURE_STATE_FILTER,
 			},
 			createTemperatureState: {
 				type: 'checkbox',
@@ -342,6 +348,7 @@ function getDeviceFormSchema() {
 						type: 'number',
 					},
 				},
+				filterFunc: RELATIVE_HUMIDITY_STATE_FILTER,
 			},
 			createRelativeHumidityState: {
 				type: 'checkbox',

package/main.js

@@ -27,6 +27,7 @@ class Absolutehumidity extends utils.Adapter {
 		});
 
 		this.deviceManagement = null;
+		this.devices = [];
 		this.subscribedSourceIds = new Set();
 
 		this.on('ready', this.onReady.bind(this));
@@ -42,6 +43,8 @@ class Absolutehumidity extends utils.Adapter {
 	async onReady() {
 		this.deviceManagement = new AbsoluteHumidityDeviceManagement(this);
 		await this.ensureInfoStates();
+		await this.ensureDeviceRootObject();
+		await this.loadDevices();
 		await this.migrateLegacyDeviceIds();
 		await this.rebuildAllDevices();
 		await this.refreshSubscriptions();
@@ -52,7 +55,7 @@ class Absolutehumidity extends utils.Adapter {
 	 * @returns {Array<Record<string, any>>}
 	 */
 	getConfiguredDevices() {
-		return Array.isArray(this.config.devices) ? this.config.devices : [];
+		return this.devices;
 	}
 
 	/**
@@ -71,7 +74,6 @@ class Absolutehumidity extends utils.Adapter {
 		const device = this.normalizeDeviceFormData(data, createUniqueDeviceId(data.name, devices));
 		const updatedDevices = [...devices, device];
 
-		await this.validateDeviceSourceIds(device);
 		await this.ensureDeviceObjects(device);
 		await this.updateDeviceValues(device);
 		await this.refreshSubscriptions(updatedDevices);
@@ -88,8 +90,6 @@ class Absolutehumidity extends utils.Adapter {
 		const device = this.normalizeDeviceFormData(data, id);
 		const updatedDevices = devices.map(existingDevice => (existingDevice.id === id ? device : existingDevice));
 
-		await this.validateDeviceSourceIds(device);
-
 		if (oldDevice) {
 			await this.deleteObsoleteDeviceStates(oldDevice, device);
 		}
@@ -161,8 +161,8 @@ class Absolutehumidity extends utils.Adapter {
 	 * @param {Record<string, any>} device
 	 */
 	async getDeviceSourceValidation(device) {
-		const temperatureStateValid = await this.isUsableSourceStateId(device.temperatureStateId);
-		const relativeHumidityStateValid = await this.isUsableSourceStateId(device.relativeHumidityStateId);
+		const temperatureStateValid = await this.isUsableTemperatureStateId(device.temperatureStateId);
+		const relativeHumidityStateValid = await this.isUsableRelativeHumidityStateId(device.relativeHumidityStateId);
 
 		return {
 			valid: temperatureStateValid && relativeHumidityStateValid,
@@ -184,26 +184,122 @@ class Absolutehumidity extends utils.Adapter {
 	 * @returns {Promise<boolean>}
 	 */
 	async isUsableSourceStateId(stateId) {
+		const object = await this.getUsableSourceStateObject(stateId);
+
+		return object?.type === 'state' && object.common?.type === 'number';
+	}
+
+	/**
+	 * @param {unknown} stateId
+	 * @returns {Promise<boolean>}
+	 */
+	async isUsableTemperatureStateId(stateId) {
+		const object = await this.getUsableSourceStateObject(stateId);
+
+		return (
+			object?.type === 'state' &&
+			object.common?.type === 'number' &&
+			this.isSupportedTemperatureUnit(object.common.unit)
+		);
+	}
+
+	/**
+	 * @param {unknown} stateId
+	 * @returns {Promise<boolean>}
+	 */
+	async isUsableRelativeHumidityStateId(stateId) {
+		const object = await this.getUsableSourceStateObject(stateId);
+
+		return (
+			object?.type === 'state' &&
+			object.common?.type === 'number' &&
+			this.isSupportedRelativeHumidityUnit(object.common.unit)
+		);
+	}
+
+	/**
+	 * @param {unknown} stateId
+	 */
+	async getUsableSourceStateObject(stateId) {
 		if (!this.isValidForeignStateId(stateId)) {
-			return false;
+			return null;
 		}
 
-		let object;
-
 		try {
-			object = await this.getForeignObjectAsync(stateId);
+			return await this.getForeignObjectAsync(stateId);
 		} catch (error) {
 			this.log.warn(`Cannot validate state ID "${stateId}": ${error.message}`);
-			return false;
+			return null;
 		}
+	}
 
-		return object?.type === 'state' && object.common?.type === 'number';
+	/**
+	 * @param {unknown} unit
+	 */
+	isSupportedTemperatureUnit(unit) {
+		const normalizedUnit = this.normalizeUnit(unit);
+
+		return (
+			normalizedUnit === '' || normalizedUnit === '°c' || normalizedUnit === 'c' || this.isFahrenheitUnit(unit)
+		);
+	}
+
+	/**
+	 * @param {unknown} unit
+	 */
+	isSupportedRelativeHumidityUnit(unit) {
+		const normalizedUnit = this.normalizeUnit(unit);
+
+		return normalizedUnit === '' || normalizedUnit === '%';
+	}
+
+	/**
+	 * @param {unknown} unit
+	 */
+	isFahrenheitUnit(unit) {
+		const normalizedUnit = this.normalizeUnit(unit);
+
+		return normalizedUnit === '°f' || normalizedUnit === 'f';
+	}
+
+	/**
+	 * @param {unknown} unit
+	 */
+	normalizeUnit(unit) {
+		return typeof unit === 'string' ? unit.trim().toLowerCase().replace(/\s+/g, '') : '';
 	}
 
 	/**
 	 * @param {Record<string, any>[]} devices
 	 */
 	async saveDevices(devices) {
+		await this.extendObjectAsync(DEVICE_ROOT, {
+			native: {
+				devices,
+			},
+		});
+		this.devices = devices;
+	}
+
+	async loadDevices() {
+		const legacyDevices = Array.isArray(this.config.devices) ? this.config.devices : [];
+		const hasLegacyDevicesConfig = Object.prototype.hasOwnProperty.call(this.config, 'devices');
+
+		if (legacyDevices.length) {
+			await this.saveDevices(legacyDevices);
+			await this.deleteLegacyConfiguredDevices();
+			return;
+		}
+
+		const deviceRootObject = await this.getObjectAsync(DEVICE_ROOT);
+		this.devices = Array.isArray(deviceRootObject?.native?.devices) ? deviceRootObject.native.devices : [];
+
+		if (hasLegacyDevicesConfig) {
+			await this.deleteLegacyConfiguredDevices();
+		}
+	}
+
+	async deleteLegacyConfiguredDevices() {
 		const adapterObjectId = `system.adapter.${this.namespace}`;
 		const adapterObject = await this.getForeignObjectAsync(adapterObjectId);
 
@@ -211,13 +307,15 @@ class Absolutehumidity extends utils.Adapter {
 			throw new Error(`Could not find adapter object ${adapterObjectId}`);
 		}
 
-		adapterObject.native = {
-			...adapterObject.native,
-			devices,
-		};
+		if (!Object.prototype.hasOwnProperty.call(adapterObject.native || {}, 'devices')) {
+			delete this.config.devices;
+			return;
+		}
+
+		delete adapterObject.native.devices;
 
 		await this.setForeignObjectAsync(adapterObjectId, adapterObject);
-		this.config.devices = devices;
+		delete this.config.devices;
 	}
 
 	async rebuildAllDevices() {
@@ -281,6 +379,18 @@ class Absolutehumidity extends utils.Adapter {
 		});
 	}
 
+	async ensureDeviceRootObject() {
+		await this.setObjectNotExistsAsync(DEVICE_ROOT, {
+			type: 'folder',
+			common: {
+				name: 'Devices',
+			},
+			native: {
+				devices: [],
+			},
+		});
+	}
+
 	/**
 	 * @param {Record<string, any>} device
 	 */
@@ -499,7 +609,7 @@ class Absolutehumidity extends utils.Adapter {
 			return;
 		}
 
-		const temperature = await this.readNumberState(device.temperatureStateId);
+		const temperature = await this.readTemperatureStateAsCelsius(device.temperatureStateId);
 		const relativeHumidity = await this.readNumberState(device.relativeHumidityStateId);
 		const absoluteHumidity = calculateAbsoluteHumidity(temperature, relativeHumidity);
 		const dewPointTemperature = calculateDewPointTemperature(temperature, relativeHumidity);
@@ -529,6 +639,25 @@ class Absolutehumidity extends utils.Adapter {
 		});
 	}
 
+	/**
+	 * @param {string} stateId
+	 */
+	async readTemperatureStateAsCelsius(stateId) {
+		const temperature = await this.readNumberState(stateId);
+
+		if (temperature === null) {
+			return null;
+		}
+
+		const object = await this.getUsableSourceStateObject(stateId);
+
+		if (this.isFahrenheitUnit(object?.common?.unit)) {
+			return ((temperature - 32) * 5) / 9;
+		}
+
+		return temperature;
+	}
+
 	/**
 	 * @param {string} stateId
 	 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iobroker.absolutehumidity",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "build absolute humidity from actual temperature and relative humidity",
   "author": {
     "name": "BenAhrdt",