hoffmation-base 3.0.0-alpha.2 → 3.0.0-alpha.21

package/lib/models/deviceSettings/actuatorSettings.d.ts

@@ -1,28 +1,37 @@
 import { DeviceSettings } from './deviceSettings';
 export declare class ActuatorSettings extends DeviceSettings {
+    /**
+     * Whether to turn on the device at dawn in time-based commands or automatic.
+     */
     dawnOn: boolean;
+    /**
+     * Whether to turn on the device at dusk in time-based commands or automatic.
+     */
     duskOn: boolean;
+    /**
+     * Whether to turn on the device at night in time-based commands or automatic.
+     */
     nightOn: boolean;
+    /**
+     * Whether to turn on the device at day in time-based commands or automatic.
+     */
+    dayOn: boolean;
     /**
      * Indicates if this device controls e.g. an Eltako, which has it's own Turn Off Time logic.
-     * @type {boolean}
      */
     isStromStoss: boolean;
     /**
      * Whether after manually turning off a previously manually turned on device, fall back to automatic mode.
      * Instead of switching to a forced off state.
-     * @type {boolean}
      */
     resetToAutomaticOnForceOffAfterForceOn: boolean;
     /**
      * If this is an Actuator controling a time based relais,
      * this indicates the time after which we retrigger the relais.
-     * @type {number}
      */
     stromStossResendTime: number;
     /**
      * Whether to include this device in the ambient light option.
-     * @type {boolean}
      */
     includeInAmbientLight: boolean;
     fromPartialObject(data: Partial<ActuatorSettings>): void;

package/lib/models/deviceSettings/actuatorSettings.js

@@ -6,42 +6,52 @@ const server_1 = require("../../server");
 class ActuatorSettings extends deviceSettings_1.DeviceSettings {
     constructor() {
         super(...arguments);
+        /**
+         * Whether to turn on the device at dawn in time-based commands or automatic.
+         */
         this.dawnOn = true;
+        /**
+         * Whether to turn on the device at dusk in time-based commands or automatic.
+         */
         this.duskOn = true;
+        /**
+         * Whether to turn on the device at night in time-based commands or automatic.
+         */
         this.nightOn = true;
+        /**
+         * Whether to turn on the device at day in time-based commands or automatic.
+         */
+        this.dayOn = false;
         /**
          * Indicates if this device controls e.g. an Eltako, which has it's own Turn Off Time logic.
-         * @type {boolean}
          */
         this.isStromStoss = false;
         /**
          * Whether after manually turning off a previously manually turned on device, fall back to automatic mode.
          * Instead of switching to a forced off state.
-         * @type {boolean}
          */
         this.resetToAutomaticOnForceOffAfterForceOn = true;
         /**
          * If this is an Actuator controling a time based relais,
          * this indicates the time after which we retrigger the relais.
-         * @type {number}
          */
         this.stromStossResendTime = 180;
         /**
          * Whether to include this device in the ambient light option.
-         * @type {boolean}
          */
         this.includeInAmbientLight = false;
     }
     fromPartialObject(data) {
-        var _a, _b, _c, _d, _e, _f, _g;
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         this.dawnOn = (_a = data.dawnOn) !== null && _a !== void 0 ? _a : this.dawnOn;
         this.duskOn = (_b = data.duskOn) !== null && _b !== void 0 ? _b : this.duskOn;
         this.nightOn = (_c = data.nightOn) !== null && _c !== void 0 ? _c : this.nightOn;
-        this.isStromStoss = (_d = data.isStromStoss) !== null && _d !== void 0 ? _d : this.isStromStoss;
-        this.stromStossResendTime = (_e = data.stromStossResendTime) !== null && _e !== void 0 ? _e : this.stromStossResendTime;
+        this.dayOn = (_d = data.dayOn) !== null && _d !== void 0 ? _d : this.dayOn;
+        this.isStromStoss = (_e = data.isStromStoss) !== null && _e !== void 0 ? _e : this.isStromStoss;
+        this.stromStossResendTime = (_f = data.stromStossResendTime) !== null && _f !== void 0 ? _f : this.stromStossResendTime;
         this.resetToAutomaticOnForceOffAfterForceOn =
-            (_f = data.resetToAutomaticOnForceOffAfterForceOn) !== null && _f !== void 0 ? _f : this.resetToAutomaticOnForceOffAfterForceOn;
-        this.includeInAmbientLight = (_g = data.includeInAmbientLight) !== null && _g !== void 0 ? _g : this.includeInAmbientLight;
+            (_g = data.resetToAutomaticOnForceOffAfterForceOn) !== null && _g !== void 0 ? _g : this.resetToAutomaticOnForceOffAfterForceOn;
+        this.includeInAmbientLight = (_h = data.includeInAmbientLight) !== null && _h !== void 0 ? _h : this.includeInAmbientLight;
         super.fromPartialObject(data);
     }
     toJSON() {

package/lib/models/deviceSettings/garageDoorOpenerSettings.d.ts

@@ -2,7 +2,6 @@ import { DeviceSettings } from './deviceSettings';
 export declare class GarageDoorOpenerSettings extends DeviceSettings {
     /**
      * In case the sensor detects open door instead of closed
-     * @type {boolean}
      */
     invertSensor: boolean;
     fromPartialObject(data: Partial<GarageDoorOpenerSettings>): void;

package/lib/models/deviceSettings/garageDoorOpenerSettings.js

@@ -8,7 +8,6 @@ class GarageDoorOpenerSettings extends deviceSettings_1.DeviceSettings {
         super(...arguments);
         /**
          * In case the sensor detects open door instead of closed
-         * @type {boolean}
          */
         this.invertSensor = false;
     }

package/lib/models/deviceSettings/heaterSettings.d.ts

@@ -5,34 +5,28 @@ export declare class HeaterSettings extends DeviceSettings {
     /**
      * Whether this device should be controlled using only valve position
      * !! Only certain devices allow direct controlling of valve Position !!
-     * @type {boolean}
      */
     controlByPid: boolean;
     controlByTempDiff: boolean;
     /**
      * Whether this device should turn off at Start of summer season and only heat in winter
-     * @type {boolean}
      */
     seasonalTurnOffActive: boolean;
     /**
      *
      * The day in a year after which SeasonalHeater should be turned off completly
-     * @type {number}
      */
     seasonTurnOffDay: number;
     /**
      * The day in a year after which SeasonalHeater should be turned to automatic
-     * @type {number}
      */
     seasonTurnOnDay: number;
     /**
      * In case of pid Control the forced minimum percentage for this heater valve
-     * @type {number}
      */
     pidForcedMinimum: number;
     /**
      * Whether this AC should be turned off for some time manually
-     * @type {boolean}
      */
     manualDisabled: boolean;
     fromPartialObject(data: Partial<HeaterSettings>): void;

package/lib/models/deviceSettings/heaterSettings.js

@@ -11,34 +11,28 @@ class HeaterSettings extends deviceSettings_1.DeviceSettings {
         /**
          * Whether this device should be controlled using only valve position
          * !! Only certain devices allow direct controlling of valve Position !!
-         * @type {boolean}
          */
         this.controlByPid = false;
         this.controlByTempDiff = false;
         /**
          * Whether this device should turn off at Start of summer season and only heat in winter
-         * @type {boolean}
          */
         this.seasonalTurnOffActive = true;
         /**
          *
          * The day in a year after which SeasonalHeater should be turned off completly
-         * @type {number}
          */
         this.seasonTurnOffDay = 99;
         /**
          * The day in a year after which SeasonalHeater should be turned to automatic
-         * @type {number}
          */
         this.seasonTurnOnDay = 267;
         /**
          * In case of pid Control the forced minimum percentage for this heater valve
-         * @type {number}
          */
         this.pidForcedMinimum = 1;
         /**
          * Whether this AC should be turned off for some time manually
-         * @type {boolean}
          */
         this.manualDisabled = false;
     }

package/lib/models/deviceSettings/ledSettings.js

@@ -25,24 +25,16 @@ class LedSettings extends dimmerSettings_1.DimmerSettings {
         this.nightColorTemp = -1;
     }
     fromPartialObject(data) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x;
-        this.dayOn = (_a = data.dayOn) !== null && _a !== void 0 ? _a : this.dayOn;
-        this.dayBrightness = (_b = data.dayBrightness) !== null && _b !== void 0 ? _b : this.dayBrightness;
-        this.dayColorTemp = (_c = data.dayColorTemp) !== null && _c !== void 0 ? _c : this.dayColorTemp;
-        this.dawnOn = (_d = data.dawnOn) !== null && _d !== void 0 ? _d : this.dawnOn;
-        this.dawnBrightness = (_e = data.dawnBrightness) !== null && _e !== void 0 ? _e : this.dawnBrightness;
-        this.dawnColorTemp = (_f = data.dawnColorTemp) !== null && _f !== void 0 ? _f : this.dawnColorTemp;
-        this.duskOn = (_g = data.duskOn) !== null && _g !== void 0 ? _g : this.duskOn;
-        this.duskBrightness = (_h = data.duskBrightness) !== null && _h !== void 0 ? _h : this.duskBrightness;
-        this.duskColorTemp = (_j = data.duskColorTemp) !== null && _j !== void 0 ? _j : this.duskColorTemp;
-        this.nightOn = (_k = data.nightOn) !== null && _k !== void 0 ? _k : this.nightOn;
-        this.nightBrightness = (_l = data.nightBrightness) !== null && _l !== void 0 ? _l : this.nightBrightness;
-        this.nightColorTemp = (_m = data.nightColorTemp) !== null && _m !== void 0 ? _m : this.nightColorTemp;
-        this.defaultColor = (_p = server_1.Utils.formatHex((_o = data.defaultColor) !== null && _o !== void 0 ? _o : this.defaultColor)) !== null && _p !== void 0 ? _p : LedSettings.fallbackColor;
-        this.dayColor = (_r = server_1.Utils.formatHex((_q = data.dayColor) !== null && _q !== void 0 ? _q : this.dayColor)) !== null && _r !== void 0 ? _r : LedSettings.fallbackColor;
-        this.dawnColor = (_t = server_1.Utils.formatHex((_s = data.dawnColor) !== null && _s !== void 0 ? _s : this.dawnColor)) !== null && _t !== void 0 ? _t : LedSettings.fallbackColor;
-        this.duskColor = (_v = server_1.Utils.formatHex((_u = data.duskColor) !== null && _u !== void 0 ? _u : this.duskColor)) !== null && _v !== void 0 ? _v : LedSettings.fallbackColor;
-        this.nightColor = (_x = server_1.Utils.formatHex((_w = data.nightColor) !== null && _w !== void 0 ? _w : this.nightColor)) !== null && _x !== void 0 ? _x : LedSettings.fallbackColor;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p;
+        this.dayColorTemp = (_a = data.dayColorTemp) !== null && _a !== void 0 ? _a : this.dayColorTemp;
+        this.dawnColorTemp = (_b = data.dawnColorTemp) !== null && _b !== void 0 ? _b : this.dawnColorTemp;
+        this.duskColorTemp = (_c = data.duskColorTemp) !== null && _c !== void 0 ? _c : this.duskColorTemp;
+        this.nightColorTemp = (_d = data.nightColorTemp) !== null && _d !== void 0 ? _d : this.nightColorTemp;
+        this.defaultColor = (_f = server_1.Utils.formatHex((_e = data.defaultColor) !== null && _e !== void 0 ? _e : this.defaultColor)) !== null && _f !== void 0 ? _f : LedSettings.fallbackColor;
+        this.dayColor = (_h = server_1.Utils.formatHex((_g = data.dayColor) !== null && _g !== void 0 ? _g : this.dayColor)) !== null && _h !== void 0 ? _h : LedSettings.fallbackColor;
+        this.dawnColor = (_k = server_1.Utils.formatHex((_j = data.dawnColor) !== null && _j !== void 0 ? _j : this.dawnColor)) !== null && _k !== void 0 ? _k : LedSettings.fallbackColor;
+        this.duskColor = (_m = server_1.Utils.formatHex((_l = data.duskColor) !== null && _l !== void 0 ? _l : this.duskColor)) !== null && _m !== void 0 ? _m : LedSettings.fallbackColor;
+        this.nightColor = (_p = server_1.Utils.formatHex((_o = data.nightColor) !== null && _o !== void 0 ? _o : this.nightColor)) !== null && _p !== void 0 ? _p : LedSettings.fallbackColor;
         super.fromPartialObject(data);
     }
     toJSON() {

package/lib/models/deviceSettings/motionSensorSettings.d.ts

@@ -2,7 +2,6 @@ import { DeviceSettings } from './deviceSettings';
 export declare class MotionSensorSettings extends DeviceSettings {
     /**
      * If set to false, a detected movement on this sensor will block certain alarms on windows in this room
-     * @type {boolean}
      */
     seesWindow: boolean;
     excludeFromNightAlarm: boolean;

package/lib/models/deviceSettings/motionSensorSettings.js

@@ -8,7 +8,6 @@ class MotionSensorSettings extends deviceSettings_1.DeviceSettings {
         super(...arguments);
         /**
          * If set to false, a detected movement on this sensor will block certain alarms on windows in this room
-         * @type {boolean}
          */
         this.seesWindow = true;
         this.excludeFromNightAlarm = false;

package/lib/models/deviceSettings/shutterSettings.d.ts

@@ -4,18 +4,15 @@ export declare class ShutterSettings extends DeviceSettings {
     msTilBot: number;
     /**
      * The direction this shutter is facing (0 = North, 180 = South)
-     * @type {number}
      */
     direction: number;
     /**
      * The desired position, when the shutter should perform a heat reduction.
-     * @type {number}
      */
     heatReductionPosition: number;
     /**
      * Some shutter give no position feedback on their own, so by knowing the durations in either direction,
      * we can programmatically trigger the callbacks.
-     * @type {boolean}
      */
     triggerPositionUpdateByTime: boolean;
     fromPartialObject(data: Partial<ShutterSettings>): void;

package/lib/models/deviceSettings/shutterSettings.js

@@ -10,18 +10,15 @@ class ShutterSettings extends deviceSettings_1.DeviceSettings {
         this.msTilBot = -1;
         /**
          * The direction this shutter is facing (0 = North, 180 = South)
-         * @type {number}
          */
         this.direction = 180;
         /**
          * The desired position, when the shutter should perform a heat reduction.
-         * @type {number}
          */
         this.heatReductionPosition = 40;
         /**
          * Some shutter give no position feedback on their own, so by knowing the durations in either direction,
          * we can programmatically trigger the callbacks.
-         * @type {boolean}
          */
         this.triggerPositionUpdateByTime = false;
     }

package/lib/models/deviceSettings/wledSettings.js

@@ -16,19 +16,11 @@ class WledSettings extends dimmerSettings_1.DimmerSettings {
         this.nightBrightness = 2;
     }
     fromPartialObject(data) {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
-        this.dayOn = (_a = data.dayOn) !== null && _a !== void 0 ? _a : this.dayOn;
-        this.dayBrightness = (_b = data.dayBrightness) !== null && _b !== void 0 ? _b : this.dayBrightness;
-        this.dawnOn = (_c = data.dawnOn) !== null && _c !== void 0 ? _c : this.dawnOn;
-        this.dawnBrightness = (_d = data.dawnBrightness) !== null && _d !== void 0 ? _d : this.dawnBrightness;
-        this.duskOn = (_e = data.duskOn) !== null && _e !== void 0 ? _e : this.duskOn;
-        this.duskBrightness = (_f = data.duskBrightness) !== null && _f !== void 0 ? _f : this.duskBrightness;
-        this.nightOn = (_g = data.nightOn) !== null && _g !== void 0 ? _g : this.nightOn;
-        this.nightBrightness = (_h = data.nightBrightness) !== null && _h !== void 0 ? _h : this.nightBrightness;
-        this.dawnPreset = (_j = data.dawnPreset) !== null && _j !== void 0 ? _j : this.dawnPreset;
-        this.dayPreset = (_k = data.dayPreset) !== null && _k !== void 0 ? _k : this.dayPreset;
-        this.duskPreset = (_l = data.duskPreset) !== null && _l !== void 0 ? _l : this.duskPreset;
-        this.nightPreset = (_m = data.nightPreset) !== null && _m !== void 0 ? _m : this.nightPreset;
+        var _a, _b, _c, _d;
+        this.dawnPreset = (_a = data.dawnPreset) !== null && _a !== void 0 ? _a : this.dawnPreset;
+        this.dayPreset = (_b = data.dayPreset) !== null && _b !== void 0 ? _b : this.dayPreset;
+        this.duskPreset = (_c = data.duskPreset) !== null && _c !== void 0 ? _c : this.duskPreset;
+        this.nightPreset = (_d = data.nightPreset) !== null && _d !== void 0 ? _d : this.nightPreset;
         super.fromPartialObject(data);
     }
     toJSON() {

package/lib/models/groupSettings/heatGroupSettings.d.ts

@@ -3,11 +3,13 @@ import { iIdHolder } from '../iIdHolder';
 import { GroupSettings } from './groupSettings';
 export declare class HeatGroupSettings extends GroupSettings {
     automaticPoints: TemperatureSettings[];
+    /**
+     * Whether the temperature should be calculated automatically, or the manualTemperature should be used
+     */
     automaticMode: boolean;
     automaticFallBackTemperatur: number;
     /**
      * Target temperature when automaticMode is disabled
-     * @type {number}
      */
     manualTemperature: number;
     fromPartialObject(data: Partial<HeatGroupSettings>): void;

package/lib/models/groupSettings/heatGroupSettings.js

@@ -7,11 +7,13 @@ class HeatGroupSettings extends groupSettings_1.GroupSettings {
     constructor() {
         super(...arguments);
         this.automaticPoints = [];
+        /**
+         * Whether the temperature should be calculated automatically, or the manualTemperature should be used
+         */
         this.automaticMode = true;
         this.automaticFallBackTemperatur = 20;
         /**
          * Target temperature when automaticMode is disabled
-         * @type {number}
          */
         this.manualTemperature = 20;
     }

package/lib/models/iIdHolder.d.ts

@@ -3,5 +3,11 @@ import { LogDebugType } from '../server';
 export interface iIdHolder {
     readonly id: string;
     readonly customName: string;
+    /**
+     * Logs a message for this idHolder
+     * @param {LogLevel} level - The log level
+     * @param {string} message - The message to log
+     * @param {LogDebugType} logDebugType - If provided, this message will only be logged if the debug type is enabled in the settings
+     */
     log(level: LogLevel, message: string, logDebugType?: LogDebugType): void;
 }

package/lib/models/objectSettings.d.ts

@@ -4,8 +4,8 @@ export declare abstract class ObjectSettings {
     persist(holder: iIdHolder): void;
     /**
      * Loads the settings from the database
-     * @param {iIdHolder} holder The holder of the settings (e.g. a device)
-     * @param {() => void} loadDoneCb Callback when loading is done
+     * @param holder - The holder of the settings (e.g. a device)
+     * @param loadDoneCb - Callback when loading is done
      */
     initializeFromDb(holder: iIdHolder, loadDoneCb?: () => void): void;
     fromPartialObject(_obj: Partial<ObjectSettings>): void;

package/lib/models/objectSettings.js

@@ -14,8 +14,8 @@ class ObjectSettings {
     }
     /**
      * Loads the settings from the database
-     * @param {iIdHolder} holder The holder of the settings (e.g. a device)
-     * @param {() => void} loadDoneCb Callback when loading is done
+     * @param holder - The holder of the settings (e.g. a device)
+     * @param loadDoneCb - Callback when loading is done
      */
     initializeFromDb(holder, loadDoneCb) {
         var _a;

package/lib/models/rooms/RoomBase.d.ts

@@ -18,7 +18,7 @@ export declare class RoomBase implements iRoomBase, iIdHolder {
     get sunsetShutterCallback(): TimeCallback | undefined;
     /**
      * For Rooms the id is itss name
-     * @returns {string} The Roomname
+     * @returns The Roomname
      */
     get id(): string;
     get customName(): string;
@@ -39,6 +39,7 @@ export declare class RoomBase implements iRoomBase, iIdHolder {
     recalcTimeCallbacks(): void;
     /**
      * Sets the light based on the current time, rollo Position and room Settings
+     * @param c - The command to execute
      */
     setLightTimeBased(c: RoomSetLightTimeBasedCommand): void;
     isNowLightTime(): boolean;

package/lib/models/rooms/RoomBase.js

@@ -41,7 +41,7 @@ class RoomBase {
     }
     /**
      * For Rooms the id is itss name
-     * @returns {string} The Roomname
+     * @returns The Roomname
      */
     get id() {
         return this.roomName;
@@ -106,6 +106,7 @@ class RoomBase {
     }
     /**
      * Sets the light based on the current time, rollo Position and room Settings
+     * @param c - The command to execute
      */
     setLightTimeBased(c) {
         var _a, _b;
@@ -115,7 +116,7 @@ class RoomBase {
         }
         if (c.movementDependant && this.PraesenzGroup && !((_a = this.PraesenzGroup) === null || _a === void 0 ? void 0 : _a.anyPresent())) {
             this.log(logLevel_1.LogLevel.Trace, 'Turn off lights as no-one is present.');
-            this.LightGroup.switchAll(new command_1.ActuatorSetStateCommand(c, false, 'Room.setLightTimeBased but no one is present'));
+            this.LightGroup.switchAll(new command_1.ActuatorSetStateCommand(c, false, 'No one is present --> Turn off lights.'));
             return;
         }
         if (!this.settings.lampOffset && !this.settings.roomIsAlwaysDark) {
@@ -132,7 +133,7 @@ class RoomBase {
                 })))) {
             timeOfDay = server_1.Utils.nowTime().hours > 16 ? timeCallback_1.TimeOfDay.AfterSunset : timeCallback_1.TimeOfDay.BeforeSunrise;
         }
-        this.LightGroup.switchTimeConditional(new command_1.LightGroupSwitchTimeConditionalCommand(c, timeOfDay, 'Roombase.setLightTimeBased'));
+        this.LightGroup.switchTimeConditional(new command_1.LightGroupSwitchTimeConditionalCommand(c, timeOfDay));
     }
     isNowLightTime() {
         var _a;

package/lib/models/rooms/iRoomBase.d.ts

@@ -7,9 +7,26 @@ export interface iRoomBase {
     sonnenUntergangLichtCallback: TimeCallback | undefined;
     skipNextRolloUp: boolean;
     roomName: string;
+    /**
+     * This function initializes the roomBase object of this room
+     */
     initializeBase(): void;
+    /**
+     * This function stores the roominformation to the database
+     */
     persist(): void;
+    /**
+     * This function recalculates the timecallbacks (e.g. sunset, sunrise handling)
+     */
     recalcTimeCallbacks(): void;
+    /**
+     * This function sets the light in the room based on the command
+     * @param {RoomSetLightTimeBasedCommand} c - The command to execute
+     */
     setLightTimeBased(c: RoomSetLightTimeBasedCommand): void;
+    /**
+     * This function checks if it is now light time respecting the room settings, the current time and the daylight hours for this location.
+     * @returns {boolean}
+     */
     isNowLightTime(): boolean;
 }

package/lib/models/rooms/iRoomImportEnforcer.d.ts

@@ -1,3 +1,7 @@
 export interface iRoomImportEnforcer {
+    /**
+     * This function is called before initializing single devices,
+     * to ensure they can be added to the respective room.
+     */
     addRoomConstructor(): void;
 }

package/lib/server/devices/Griffe.js

@@ -8,7 +8,6 @@ class Griffe {
     static getGriffPosition() {
         const griffe = Griffe.getAllGriffe();
         griffe.sort((a, b) => {
-            a.position;
             return b.position - a.position;
         });
         const response = [`These are the current handle positions:`];

package/lib/server/devices/IoBrokerBaseDevice.d.ts

@@ -14,6 +14,8 @@ export declare abstract class IoBrokerBaseDevice implements iRoomDevice {
     };
     private _room;
     readonly deviceCapabilities: DeviceCapability[];
+    protected _debounceStateDelay: number;
+    protected _lastWrite: number;
     get customName(): string;
     get room(): RoomBase;
     protected readonly individualStateCallbacks: Map<string, Array<(val: ioBroker.StateValue) => void>>;
@@ -21,31 +23,24 @@ export declare abstract class IoBrokerBaseDevice implements iRoomDevice {
     get id(): string;
     /**
      * Getter info
-     * @return {IoBrokerDeviceInfo}
+     * @returns The device info
      */
     get info(): IoBrokerDeviceInfo;
-    /**
-     * Setter info
-     * @param {IoBrokerDeviceInfo} value
-     */
     set info(value: IoBrokerDeviceInfo);
-    /**
-     * Getter ioConn
-     * @return {IOBrokerConnection}
-     */
     get ioConn(): IOBrokerConnection | undefined;
     static addRoom(shortName: string, settings: RoomDeviceAddingSettings): void;
     static checkMissing(): void;
     loadDeviceSettings(): void;
     /**
      * Allows to react on the state change of a given state with the passed cb
-     * @param {string} stateName Last part of the id e.g. "available" not "zigbee.0.00158d00053d3e4b.available"
-     * @param {(val: ioBroker.StateValue) => void} cb Desired Callback Action, with passed ioBroker.StateValue
+     * @param stateName - Last part of the id e.g. "available" not "zigbee.0.00158d00053d3e4b.available"
+     * @param cb - Desired Callback Action, with passed ioBroker.StateValue
      */
     addIndividualStateCallback(stateName: string, cb: (val: ioBroker.StateValue) => void): void;
     /**
      * Returns whether a connection to ioBroker is established or not
-     * @param showError If true, an error message will be written to the log if the connection is not established
+     * @param showError - If true, an error message will be written to the log if the connection is not established
+     * @returns Whether a connection exists
      */
     checkIoConnection(showError?: boolean): boolean;
     abstract update(idSplit: string[], state: ioBroker.State, initial: boolean, pOverride: boolean): void;
@@ -55,10 +50,10 @@ export declare abstract class IoBrokerBaseDevice implements iRoomDevice {
     protected addToCorrectRoom(): void;
     /**
      * Sets the state of a given data point and returns true if that was successful.
-     * @param pointId Data point to write to
-     * @param state Data to write
-     * @param onSuccess Callback to run on successfully written data
-     * @param onError Callback to run if an error has occurred during writing the data
+     * @param pointId - Data point to write to
+     * @param state - Data to write
+     * @param onSuccess - Callback to run on successfully written data
+     * @param onError - Callback to run if an error has occurred during writing the data
      */
     protected setState(pointId: string, state: string | number | boolean | ioBroker.State | ioBroker.SettableState | null, onSuccess?: (() => void) | undefined, onError?: ((error: Error) => void) | undefined): void;
 }

package/lib/server/devices/IoBrokerBaseDevice.js

@@ -20,6 +20,9 @@ class IoBrokerBaseDevice {
         this.settings = undefined;
         this._room = undefined;
         this.deviceCapabilities = [];
+        // If configured > 0, this indicates the minimum time between state writes in ms
+        this._debounceStateDelay = 0;
+        this._lastWrite = 0;
         this.individualStateCallbacks = new Map();
         this.addToCorrectRoom();
         this.persistDeviceInfo();
@@ -34,22 +37,14 @@ class IoBrokerBaseDevice {
     }
     /**
      * Getter info
-     * @return {IoBrokerDeviceInfo}
+     * @returns The device info
      */
     get info() {
         return this._info;
     }
-    /**
-     * Setter info
-     * @param {IoBrokerDeviceInfo} value
-     */
     set info(value) {
         this._info = value;
     }
-    /**
-     * Getter ioConn
-     * @return {IOBrokerConnection}
-     */
     get ioConn() {
         return ioBroker_1.ioBrokerMain.iOConnection;
     }
@@ -71,8 +66,8 @@ class IoBrokerBaseDevice {
     }
     /**
      * Allows to react on the state change of a given state with the passed cb
-     * @param {string} stateName Last part of the id e.g. "available" not "zigbee.0.00158d00053d3e4b.available"
-     * @param {(val: ioBroker.StateValue) => void} cb Desired Callback Action, with passed ioBroker.StateValue
+     * @param stateName - Last part of the id e.g. "available" not "zigbee.0.00158d00053d3e4b.available"
+     * @param cb - Desired Callback Action, with passed ioBroker.StateValue
      */
     addIndividualStateCallback(stateName, cb) {
         let arr = this.individualStateCallbacks.get(stateName);
@@ -86,7 +81,8 @@ class IoBrokerBaseDevice {
     }
     /**
      * Returns whether a connection to ioBroker is established or not
-     * @param showError If true, an error message will be written to the log if the connection is not established
+     * @param showError - If true, an error message will be written to the log if the connection is not established
+     * @returns Whether a connection exists
      */
     checkIoConnection(showError = false) {
         if (!this.ioConn && showError) {
@@ -142,23 +138,31 @@ class IoBrokerBaseDevice {
     }
     /**
      * Sets the state of a given data point and returns true if that was successful.
-     * @param pointId Data point to write to
-     * @param state Data to write
-     * @param onSuccess Callback to run on successfully written data
-     * @param onError Callback to run if an error has occurred during writing the data
+     * @param pointId - Data point to write to
+     * @param state - Data to write
+     * @param onSuccess - Callback to run on successfully written data
+     * @param onError - Callback to run if an error has occurred during writing the data
      */
     setState(pointId, state, onSuccess = undefined, onError = undefined) {
         var _a;
         if (!this.checkIoConnection(true)) {
             return;
         }
+        if (this._debounceStateDelay > 0 && services_1.Utils.nowMS() - this._lastWrite < this._debounceStateDelay) {
+            services_1.Utils.guardedTimeout(() => {
+                this.log(models_1.LogLevel.Trace, `Debounced write for ${pointId} to ${state}`);
+                this.setState(pointId, state, onSuccess, onError);
+            }, this._debounceStateDelay, this);
+            return;
+        }
+        this._lastWrite = services_1.Utils.nowMS();
         (_a = this.ioConn) === null || _a === void 0 ? void 0 : _a.setState(pointId, state, (err) => {
             if (err) {
                 if (onError) {
                     onError(err);
                 }
                 else {
-                    console.log(`Error occured while setting state "${pointId}" to "${state}": ${err}`);
+                    this.log(models_1.LogLevel.Error, `Error occured while setting state "${pointId}" to "${state}": ${err}`);
                 }
                 return;
             }

package/lib/server/devices/IoBrokerDeviceInfo.d.ts

@@ -13,8 +13,8 @@ export declare class IoBrokerDeviceInfo extends DeviceInfo {
     private static replaceInvalidIdChars;
     /**
      * Extracts the relevant infos from the passed deviceConfig and combines them in a new Info object
-     * @param {deviceConfig} pDevConf The device Config based on the extracted devices.json from ioBroker
-     * @param {boolean} isJsStateChildObject Within JS Objects, creating devices is limited,
+     * @param pDevConf - The device Config based on the extracted devices.json from ioBroker
+     * @param isJsStateChildObject - Within JS Objects, creating devices is limited,
      * so we name the first child state for the object creation (e.g. javascript.0.00-EnergyManager.CurrentProduction)
      */
     constructor(pDevConf: deviceConfig, isJsStateChildObject?: boolean);