hoffmation-base 3.0.0-alpha.4 → 3.0.0-alpha.40

package/lib/server/devices/zigbee/BaseDevices/ZigbeeActuator.js

@@ -8,24 +8,30 @@ const DeviceCapability_1 = require("../../DeviceCapability");
 const blockAutomaticHandler_1 = require("../../../services/blockAutomaticHandler");
 const sharedFunctions_1 = require("../../sharedFunctions");
 class ZigbeeActuator extends zigbeeDevice_1.ZigbeeDevice {
-    get actuatorOn() {
-        return this._actuatorOn;
-    }
-    constructor(pInfo, type, actuatorOnSwitchID) {
+    constructor(pInfo, type) {
         super(pInfo, type);
-        this._actuatorOn = false;
+        /** @inheritDoc */
         this.targetAutomaticState = false;
+        /** @inheritDoc */
         this.settings = new models_1.ActuatorSettings();
+        /** @inheritDoc */
         this.queuedValue = null;
+        this._lastPersist = 0;
+        this._stateNameState = 'state';
+        this._actuatorOn = false;
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.actuator);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.blockAutomatic);
-        this.actuatorOnSwitchID = actuatorOnSwitchID;
-        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this));
+        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this), this.log.bind(this));
     }
+    /** @inheritDoc */
+    get actuatorOn() {
+        return this._actuatorOn;
+    }
+    /** @inheritDoc */
     restoreTargetAutomaticValue(c) {
-        this.log(models_1.LogLevel.Debug, `Restore Target Automatic value`);
-        this.setActuator(new models_1.ActuatorSetStateCommand(c, this.targetAutomaticState, 'Restore Target Automatic value'));
+        this.setActuator(new models_1.ActuatorSetStateCommand(c, this.targetAutomaticState));
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false, handledByChildObject = false) {
         if (!handledByChildObject) {
             this.log(models_1.LogLevel.DeepTrace, `Aktuator Update: ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
@@ -33,7 +39,7 @@ class ZigbeeActuator extends zigbeeDevice_1.ZigbeeDevice {
         this.queuedValue = null;
         super.update(idSplit, state, initial, true);
         switch (idSplit[3]) {
-            case 'state':
+            case this._stateNameState:
                 if (!handledByChildObject) {
                     this.log(models_1.LogLevel.Trace, `Aktor Update für ${this.info.customName} auf ${state.val}`);
                 }
@@ -42,26 +48,35 @@ class ZigbeeActuator extends zigbeeDevice_1.ZigbeeDevice {
                 break;
         }
     }
+    /** @inheritDoc */
     setActuator(command) {
-        if (this.actuatorOnSwitchID === '') {
-            this.log(models_1.LogLevel.Error, `Keine Switch ID bekannt.`);
+        if (this._actuatorOnStateIdState === '') {
+            this.log(models_1.LogLevel.Error, 'Keine Switch ID bekannt.');
             return;
         }
         sharedFunctions_1.LampUtils.setActuator(this, command);
     }
+    /** @inheritDoc */
     persist() {
         var _a;
+        const now = services_1.Utils.nowMS();
+        if (this._lastPersist + 1000 > now) {
+            return;
+        }
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistActuator(this);
+        this._lastPersist = now;
     }
+    /** @inheritDoc */
     toggleActuator(command) {
         const newVal = this.queuedValue !== null ? !this.queuedValue : !this._actuatorOn;
-        const timeout = newVal && command.isForceAction ? 30 * 60 * 1000 : -1;
-        this.setActuator(new models_1.ActuatorSetStateCommand(command, newVal, 'Due to ZigbeeActuatorToggle', timeout));
+        const setStateCommand = models_1.ActuatorSetStateCommand.byActuatorAndToggleCommand(this, command);
+        this.setActuator(setStateCommand);
         return newVal;
     }
+    /** @inheritDoc */
     writeActuatorStateToDevice(c) {
         this.log(models_1.LogLevel.Debug, c.logMessage, services_1.LogDebugType.SetActuator);
-        this.setState(this.actuatorOnSwitchID, c.stateValue, undefined, (err) => {
+        this.setState(this._actuatorOnStateIdState, c.stateValue, undefined, (err) => {
             this.log(models_1.LogLevel.Error, `Lampe schalten ergab Fehler: ${err}`);
         });
     }

package/lib/server/devices/zigbee/BaseDevices/index.d.ts

@@ -7,3 +7,4 @@ export * from './zigbeeMagnetContact';
 export * from './zigbeeMotionSensor';
 export * from './zigbeeShutter';
 export * from './zigbeeSwitch';
+export { ZigbeeLamp } from './zigbeeLamp';

package/lib/server/devices/zigbee/BaseDevices/index.js

@@ -14,6 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZigbeeLamp = void 0;
 __exportStar(require("./ZigbeeActuator"), exports);
 __exportStar(require("./zigbeeDevice"), exports);
 __exportStar(require("./zigbeeDimmer"), exports);
@@ -23,3 +24,5 @@ __exportStar(require("./zigbeeMagnetContact"), exports);
 __exportStar(require("./zigbeeMotionSensor"), exports);
 __exportStar(require("./zigbeeShutter"), exports);
 __exportStar(require("./zigbeeSwitch"), exports);
+var zigbeeLamp_1 = require("./zigbeeLamp");
+Object.defineProperty(exports, "ZigbeeLamp", { enumerable: true, get: function () { return zigbeeLamp_1.ZigbeeLamp; } });

package/lib/server/devices/zigbee/BaseDevices/zigbeeDevice.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="node" />
 import { DeviceType } from '../../deviceType';
 import { IoBrokerBaseDevice } from '../../IoBrokerBaseDevice';
 import { IoBrokerDeviceInfo } from '../../IoBrokerDeviceInfo';
@@ -6,20 +5,20 @@ import { iDisposable } from '../../../services';
 export declare class ZigbeeDevice extends IoBrokerBaseDevice implements iDisposable {
     protected _available: boolean;
     protected _dontSendOnUnavailable: boolean;
-    protected _debounceStateDelay: number;
-    private _lastWrite;
     private readonly _deviceQueryId;
     get available(): boolean;
     protected _linkQuality: number;
-    readonly persistZigbeeInterval: NodeJS.Timeout;
+    private readonly _persistZigbeeInterval;
     get linkQuality(): number;
     private _lastUpdate;
     get lastUpdate(): Date;
-    stateMap: Map<string, ioBroker.State>;
     constructor(pInfo: IoBrokerDeviceInfo, pType: DeviceType);
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean, pOverride?: boolean): void;
     triggerDeviceQuery(): void;
+    /** @inheritDoc */
     dispose(): void;
     persistZigbeeDevice(): void;
+    /** @inheritDoc */
     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/zigbee/BaseDevices/zigbeeDevice.js

@@ -18,17 +18,14 @@ class ZigbeeDevice extends IoBrokerBaseDevice_1.IoBrokerBaseDevice {
         super(pInfo, pType);
         this._available = false;
         this._dontSendOnUnavailable = false;
-        // If configured > 0, this indicates the minimum time between state writes in ms
-        this._debounceStateDelay = 0;
-        this._lastWrite = 0;
         this._linkQuality = 0;
-        this.persistZigbeeInterval = services_1.Utils.guardedInterval(() => {
+        this._persistZigbeeInterval = services_1.Utils.guardedInterval(() => {
             this.persistZigbeeDevice();
         }, 15 * 60 * 1000, this, false);
         this._lastUpdate = new Date(0);
-        this.stateMap = new Map();
         this._deviceQueryId = `${this.info.fullID}.device_query`;
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false, pOverride = false) {
         this.log(models_1.LogLevel.DeepTrace, `Zigbee: ${initial ? 'Initiales ' : ''}Update: ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
         if (!pOverride) {
@@ -40,16 +37,18 @@ class ZigbeeDevice extends IoBrokerBaseDevice_1.IoBrokerBaseDevice {
         }
         switch (idSplit[3]) {
             case 'available':
-                this._available = state.val;
-                if (!this._available) {
-                    this.log(models_1.LogLevel.Debug, `Das Zigbee Gerät ist nicht erreichbar.`);
+                const newAvailability = state.val;
+                if (this._available && !newAvailability) {
+                    this.log(models_1.LogLevel.Debug, 'Device became unavailable.');
                 }
+                this._available = newAvailability;
                 break;
             case 'link_quality':
-                this._linkQuality = state.val;
-                if (this._linkQuality < 5) {
-                    this.log(models_1.LogLevel.Debug, `Das Zigbee Gerät hat eine schlechte Verbindung (${this._linkQuality}).`);
+                const newValue = state.val;
+                if (this._linkQuality > 5 && newValue <= 5) {
+                    this.log(models_1.LogLevel.Debug, `The link-quality dropped to a critical level: ${newValue}`);
                 }
+                this._linkQuality = state.val;
                 break;
         }
         this.stateMap.set(idSplit[3], state);
@@ -61,30 +60,24 @@ class ZigbeeDevice extends IoBrokerBaseDevice_1.IoBrokerBaseDevice {
         }
     }
     triggerDeviceQuery() {
-        this.log(models_1.LogLevel.Info, `Triggering Device Query`);
+        this.log(models_1.LogLevel.Info, 'Triggering Device Query');
         this.setState(this._deviceQueryId, true);
     }
+    /** @inheritDoc */
     dispose() {
-        clearInterval(this.persistZigbeeInterval);
+        clearInterval(this._persistZigbeeInterval);
     }
     persistZigbeeDevice() {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistZigbeeDevice(this);
     }
+    /** @inheritDoc */
     setState(pointId, state, onSuccess = undefined, onError = undefined) {
         if (this._dontSendOnUnavailable && !this._available) {
             this.log(models_1.LogLevel.Warn, `Device unavailable --> Not changing ${pointId} to ${state}`);
             return;
         }
-        if (this._debounceStateDelay === 0 || services_1.Utils.nowMS() - this._lastWrite > this._debounceStateDelay) {
-            this._lastWrite = services_1.Utils.nowMS();
-            super.setState(pointId, state, onSuccess, onError);
-            return;
-        }
-        services_1.Utils.guardedTimeout(() => {
-            this.log(models_1.LogLevel.Trace, `Debounced write to ${pointId} to ${state}`);
-            this.setState(pointId, state, onSuccess, onError);
-        }, this._debounceStateDelay, this);
+        super.setState(pointId, state, onSuccess, onError);
     }
 }
 exports.ZigbeeDevice = ZigbeeDevice;

package/lib/server/devices/zigbee/BaseDevices/zigbeeDimmer.d.ts

@@ -1,41 +1,26 @@
-import { ActuatorSetStateCommand, ActuatorToggleCommand, ActuatorWriteStateToDeviceCommand, DimmerSetLightCommand, DimmerSettings, LampSetTimeBasedCommand, LampToggleLightCommand, RestoreTargetAutomaticValueCommand } from '../../../../models';
+import { DimmerSetLightCommand, DimmerSettings, LampSetTimeBasedCommand } from '../../../../models';
 import { DeviceType } from '../../deviceType';
-import { ZigbeeDevice } from './index';
 import { IoBrokerDeviceInfo } from '../../IoBrokerDeviceInfo';
 import { iDimmableLamp } from '../../baseDeviceInterfaces/iDimmableLamp';
 import { iTemporaryDisableAutomatic } from '../../baseDeviceInterfaces';
-import { BlockAutomaticHandler } from '../../../services/blockAutomaticHandler';
-export declare abstract class ZigbeeDimmer extends ZigbeeDevice implements iDimmableLamp, iTemporaryDisableAutomatic {
-    readonly blockAutomationHandler: BlockAutomaticHandler;
-    queuedValue: boolean | null;
+import { ZigbeeLamp } from './zigbeeLamp';
+export declare abstract class ZigbeeDimmer extends ZigbeeLamp implements iDimmableLamp, iTemporaryDisableAutomatic {
+    /** @inheritDoc */
     settings: DimmerSettings;
-    targetAutomaticState: boolean;
-    protected _lastPersist: number;
     protected abstract readonly _stateIdBrightness: string;
-    protected abstract readonly _stateIdState: string;
     protected abstract readonly _stateIdTransitionTime: string;
     protected abstract readonly _stateNameBrightness: string;
-    protected abstract readonly _stateNameState: string;
     protected abstract readonly _stateNameTransitionTime: string;
-    protected constructor(pInfo: IoBrokerDeviceInfo, deviceType: DeviceType);
     protected _brightness: number;
-    get brightness(): number;
-    protected _lightOn: boolean;
-    get lightOn(): boolean;
     protected _transitionTime: number;
-    get transitionTime(): number;
-    get actuatorOn(): boolean;
-    restoreTargetAutomaticValue(c: RestoreTargetAutomaticValueCommand): void;
+    protected constructor(pInfo: IoBrokerDeviceInfo, deviceType: DeviceType);
+    /** @inheritDoc */
+    get brightness(): number;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
+    /** @inheritDoc */
     setTimeBased(c: LampSetTimeBasedCommand): void;
-    setActuator(c: ActuatorSetStateCommand): void;
-    toggleActuator(c: ActuatorToggleCommand): boolean;
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setLight(c: DimmerSetLightCommand): void;
-    persist(): void;
-    toggleLight(c: LampToggleLightCommand): boolean;
-    writeActuatorStateToDevice(c: ActuatorWriteStateToDeviceCommand): void;
     private setBrightnessState;
 }

package/lib/server/devices/zigbee/BaseDevices/zigbeeDimmer.js

@@ -3,50 +3,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZigbeeDimmer = void 0;
 const models_1 = require("../../../../models");
 const services_1 = require("../../../services");
-const index_1 = require("./index");
 const DeviceCapability_1 = require("../../DeviceCapability");
-const blockAutomaticHandler_1 = require("../../../services/blockAutomaticHandler");
 const sharedFunctions_1 = require("../../sharedFunctions");
-class ZigbeeDimmer extends index_1.ZigbeeDevice {
+const zigbeeLamp_1 = require("./zigbeeLamp");
+class ZigbeeDimmer extends zigbeeLamp_1.ZigbeeLamp {
     constructor(pInfo, deviceType) {
         super(pInfo, deviceType);
-        this.queuedValue = null;
+        /** @inheritDoc */
         this.settings = new models_1.DimmerSettings();
-        this.targetAutomaticState = false;
-        this._lastPersist = 0;
         this._brightness = 0;
-        this._lightOn = false;
         this._transitionTime = 0;
-        this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.lamp);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.dimmablelamp);
-        this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.blockAutomatic);
-        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this));
     }
+    /** @inheritDoc */
     get brightness() {
         return this._brightness;
     }
-    get lightOn() {
-        return this._lightOn;
-    }
-    get transitionTime() {
-        return this._transitionTime;
-    }
-    get actuatorOn() {
-        return this.lightOn;
-    }
-    restoreTargetAutomaticValue(c) {
-        this.setActuator(new models_1.ActuatorSetStateCommand(c, this.targetAutomaticState, 'Restore targetAutomaticState due to BlockAutomaticHandler'));
-    }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.queuedValue = null;
         this.log(models_1.LogLevel.DeepTrace, `Dimmer Update: ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
         super.update(idSplit, state, initial, true);
         switch (idSplit[3]) {
-            case this._stateNameState:
-                this.log(models_1.LogLevel.Trace, `Dimmer Update für ${this.info.customName} auf ${state.val}`);
-                this._lightOn = state.val;
-                this.persist();
-                break;
             case this._stateNameBrightness:
                 this.log(models_1.LogLevel.Trace, `Dimmer Helligkeit Update für ${this.info.customName} auf ${state.val}`);
                 this._brightness = state.val;
@@ -58,77 +36,64 @@ class ZigbeeDimmer extends index_1.ZigbeeDevice {
                 break;
         }
     }
+    /** @inheritDoc */
     setTimeBased(c) {
         this.setLight(models_1.DimmerSetLightCommand.byTimeBased(this.settings, c));
     }
-    setActuator(c) {
-        this.setLight(new models_1.DimmerSetLightCommand(c, c.on, 'Set dimmer due to set ActuactorCommand', c.timeout));
-    }
-    toggleActuator(c) {
-        const setActuatorCommand = models_1.ActuatorSetStateCommand.byActuatorAndToggleCommand(this, c);
-        this.setActuator(setActuatorCommand);
-        return setActuatorCommand.on;
-    }
-    /**
-     * @inheritDoc
-     */
+    /** @inheritDoc */
     setLight(c) {
         var _a;
-        if (this._stateIdState === '') {
-            this.log(models_1.LogLevel.Error, `Keine State ID bekannt.`);
+        if (this._actuatorOnStateIdState === '') {
+            this.log(models_1.LogLevel.Error, 'Keine State ID bekannt.');
             return;
         }
         if (!this.ioConn) {
-            this.log(models_1.LogLevel.Error, `Keine Connection bekannt.`);
+            this.log(models_1.LogLevel.Error, 'Keine Connection bekannt.');
             return;
         }
-        if (c.transitionTime > -1) {
-            this.setState(this._stateIdTransitionTime, c.transitionTime);
-        }
         const dontBlock = sharedFunctions_1.LampUtils.checkUnBlock(this, c);
         if (sharedFunctions_1.LampUtils.checkBlockActive(this, c)) {
             return;
         }
+        if (c.isAutomaticAction) {
+            // Preserve the target state for the automatic handler, as
+            this.targetAutomaticState = c.on;
+        }
+        if (sharedFunctions_1.LampUtils.canDimmerChangeBeSkipped(this, c)) {
+            return;
+        }
+        if (c.transitionTime > -1) {
+            this.setState(this._stateIdTransitionTime, c.transitionTime);
+        }
         if (c.on && c.brightness <= 0 && this.brightness < 10) {
             c.brightness = 10;
         }
-        this.log(models_1.LogLevel.Debug, `Set Light Acutator to "${c.on}" with brightness ${c.brightness}`, services_1.LogDebugType.SetActuator);
-        if (c.timeout > -1 && !dontBlock) {
-            this.blockAutomationHandler.disableAutomatic(c.timeout, models_1.CollisionSolving.overrideIfGreater);
+        if (!dontBlock && c.disableAutomaticCommand !== null) {
+            if (c.disableAutomaticCommand === undefined && c.isForceAction) {
+                c.disableAutomaticCommand = models_1.BlockAutomaticCommand.fromDeviceSettings(c, this.settings);
+            }
+            if (c.disableAutomaticCommand) {
+                this.blockAutomationHandler.disableAutomatic(c.disableAutomaticCommand);
+            }
         }
         if (((_a = services_1.SettingsService.settings.ioBroker) === null || _a === void 0 ? void 0 : _a.useZigbee2mqtt) && !c.on) {
             // With zigbee2mqtt to turn on only setting brighness>0 is needed, so we need state only for turning off
-            this.writeActuatorStateToDevice(new models_1.ActuatorWriteStateToDeviceCommand(c.on, c, 'Set dimmer due to set ActuactorCommand'));
+            this.writeActuatorStateToDevice(new models_1.ActuatorWriteStateToDeviceCommand(c, c.on));
             this.queuedValue = c.on;
             return;
         }
+        this.log(models_1.LogLevel.Debug, c.logMessage, services_1.LogDebugType.SetActuator);
         if (c.brightness >= this.settings.turnOnThreshhold) {
             this.setBrightnessState(c.brightness);
             return;
         }
         this.setBrightnessState(this.settings.turnOnThreshhold, () => {
             services_1.Utils.guardedTimeout(() => {
-                this.log(models_1.LogLevel.Info, `Delayed reduced brightness on ${this.info.customName}`);
+                this.log(models_1.LogLevel.Info, `Delayed reduced brightness on ${this.info.customName} to ${c.brightness} for command: ${c.logMessage}`);
                 this.setBrightnessState(c.brightness);
             }, 1000, this);
         });
     }
-    persist() {
-        var _a;
-        const now = services_1.Utils.nowMS();
-        if (this._lastPersist + 1000 > now) {
-            return;
-        }
-        (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistActuator(this);
-        this._lastPersist = now;
-    }
-    toggleLight(c) {
-        return sharedFunctions_1.LampUtils.toggleLight(this, c);
-    }
-    writeActuatorStateToDevice(c) {
-        this.log(models_1.LogLevel.Debug, c.logMessage, services_1.LogDebugType.SetActuator);
-        this.setState(this._stateIdState, c.stateValue);
-    }
     setBrightnessState(brightness, onSuccess) {
         this.setState(this._stateIdBrightness, Math.max(0, Math.min(brightness, 100)), onSuccess);
     }

package/lib/server/devices/zigbee/BaseDevices/zigbeeHeater.d.ts

@@ -8,9 +8,13 @@ import { PIDController } from '../../../../liquid-pid';
 export declare class ZigbeeHeater extends ZigbeeDevice implements iHeater, iBatteryDevice {
     protected _battery: number;
     private _lastBatteryPersist;
+    /** @inheritDoc */
     get lastBatteryPersist(): number;
+    /** @inheritDoc */
     readonly persistHeaterInterval: NodeJS.Timeout;
+    /** @inheritDoc */
     settings: HeaterSettings;
+    /** @inheritDoc */
     get battery(): number;
     protected _iAutomaticInterval: NodeJS.Timeout | undefined;
     protected _initialSeasonCheckDone: boolean;
@@ -21,26 +25,35 @@ export declare class ZigbeeHeater extends ZigbeeDevice implements iHeater, iBatt
     protected _pidController: PIDController;
     constructor(pInfo: IoBrokerDeviceInfo, pType: DeviceType);
     protected _seasonTurnOff: boolean;
+    /** @inheritDoc */
     get seasonTurnOff(): boolean;
+    /** @inheritDoc */
     set seasonTurnOff(value: boolean);
+    /** @inheritDoc */
     get desiredTemperature(): number;
+    /** @inheritDoc */
     set desiredTemperature(val: number);
-    protected _humidity: number;
-    get humidity(): number;
     get sLevel(): string;
+    /** @inheritDoc */
     get iLevel(): number;
     get sTemperatur(): string;
+    /** @inheritDoc */
     get iTemperature(): number;
     protected _roomTemperature: number;
+    /** @inheritDoc */
     get roomTemperature(): number;
-    set roomTemperatur(val: number);
+    protected set roomTemperatur(val: number);
+    /** @inheritDoc */
     checkAutomaticChange(): void;
-    stopAutomaticCheck(): void;
+    /** @inheritDoc */
     onTemperaturChange(newTemperatur: number): void;
     persistHeater(): void;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean, pOverride?: boolean): void;
     protected getNextPidLevel(): number;
     private checkSeasonTurnOff;
+    /** @inheritDoc */
     persistBatteryDevice(): void;
+    /** @inheritDoc */
     dispose(): void;
 }

package/lib/server/devices/zigbee/BaseDevices/zigbeeHeater.js

@@ -8,9 +8,11 @@ const services_1 = require("../../../services");
 const DeviceCapability_1 = require("../../DeviceCapability");
 const liquid_pid_1 = require("../../../../liquid-pid");
 class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
+    /** @inheritDoc */
     get lastBatteryPersist() {
         return this._lastBatteryPersist;
     }
+    /** @inheritDoc */
     get battery() {
         return this._battery;
     }
@@ -18,9 +20,11 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
         super(pInfo, pType);
         this._battery = -99;
         this._lastBatteryPersist = 0;
+        /** @inheritDoc */
         this.persistHeaterInterval = services_1.Utils.guardedInterval(() => {
             this.persistHeater();
         }, 5 * 60 * 1000, this, false);
+        /** @inheritDoc */
         this.settings = new models_1.HeaterSettings();
         this._initialSeasonCheckDone = false;
         this._level = 0;
@@ -38,7 +42,6 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
             Kd: 9, // PID: Kd in 1/1000
         });
         this._seasonTurnOff = false;
-        this._humidity = 0;
         this._roomTemperature = baseDeviceInterfaces_1.UNDEFINED_TEMP_VALUE;
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.heater);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.batteryDriven);
@@ -47,15 +50,19 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
             this.checkSeasonTurnOff();
         }, 0, 2, 0));
     }
+    /** @inheritDoc */
     get seasonTurnOff() {
         return this._seasonTurnOff;
     }
+    /** @inheritDoc */
     set seasonTurnOff(value) {
         this._seasonTurnOff = value;
     }
+    /** @inheritDoc */
     get desiredTemperature() {
         return this._desiredTemperatur;
     }
+    /** @inheritDoc */
     set desiredTemperature(val) {
         this._desiredTemperatur = val;
         this.setState(this._setPointTemperaturID, val, () => {
@@ -64,18 +71,17 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
             this.log(models_1.LogLevel.Error, `Temperaturänderung ergab Fehler ${err}.`);
         });
     }
-    get humidity() {
-        return this._humidity;
-    }
     get sLevel() {
         return `${this._level * 100}%`;
     }
+    /** @inheritDoc */
     get iLevel() {
         return this._level;
     }
     get sTemperatur() {
         return `${this.iTemperature}°C`;
     }
+    /** @inheritDoc */
     get iTemperature() {
         if (this.settings.useOwnTemperatur) {
             return this._temperatur;
@@ -84,12 +90,14 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
             return this._roomTemperature;
         }
     }
+    /** @inheritDoc */
     get roomTemperature() {
         return this._roomTemperature;
     }
     set roomTemperatur(val) {
         this._roomTemperature = val;
     }
+    /** @inheritDoc */
     checkAutomaticChange() {
         var _a;
         if (!this._initialSeasonCheckDone) {
@@ -113,12 +121,7 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
             this.desiredTemperature = targetTemperature;
         }
     }
-    stopAutomaticCheck() {
-        if (this._iAutomaticInterval !== undefined) {
-            clearInterval(this._iAutomaticInterval);
-            this._iAutomaticInterval = undefined;
-        }
-    }
+    /** @inheritDoc */
     onTemperaturChange(newTemperatur) {
         this.roomTemperatur = newTemperatur;
     }
@@ -126,13 +129,14 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistHeater(this);
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false, pOverride = false) {
         switch (idSplit[3]) {
             case 'battery':
                 this._battery = state.val;
                 this.persistBatteryDevice();
                 if (this._battery < 20) {
-                    this.log(models_1.LogLevel.Warn, `Das Zigbee Gerät hat unter 20% Batterie.`);
+                    this.log(models_1.LogLevel.Warn, 'Das Zigbee Gerät hat unter 20% Batterie.');
                 }
                 break;
         }
@@ -155,6 +159,7 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
         }
         this._initialSeasonCheckDone = true;
     }
+    /** @inheritDoc */
     persistBatteryDevice() {
         var _a;
         const now = services_1.Utils.nowMS();
@@ -164,6 +169,7 @@ class ZigbeeHeater extends zigbeeDevice_1.ZigbeeDevice {
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistBatteryDevice(this);
         this._lastBatteryPersist = now;
     }
+    /** @inheritDoc */
     dispose() {
         if (this.persistHeaterInterval) {
             clearInterval(this.persistHeaterInterval);

package/lib/server/devices/zigbee/BaseDevices/zigbeeLamp.d.ts

@@ -0,0 +1,16 @@
+import { ZigbeeActuator } from './ZigbeeActuator';
+import { iLamp, iTemporaryDisableAutomatic } from '../../baseDeviceInterfaces';
+import { LampSetLightCommand, LampSetTimeBasedCommand, LampToggleLightCommand } from '../../../../models';
+import { IoBrokerDeviceInfo } from '../../IoBrokerDeviceInfo';
+import { DeviceType } from '../../deviceType';
+export declare abstract class ZigbeeLamp extends ZigbeeActuator implements iLamp, iTemporaryDisableAutomatic {
+    constructor(pInfo: IoBrokerDeviceInfo, deviceType: DeviceType);
+    /** @inheritDoc */
+    update(idSplit: string[], state: ioBroker.State, initial?: boolean, handledByChildObject?: boolean): void;
+    /** @inheritDoc */
+    setTimeBased(c: LampSetTimeBasedCommand): void;
+    /** @inheritdoc */
+    setLight(c: LampSetLightCommand): void;
+    /** @inheritDoc */
+    toggleLight(c: LampToggleLightCommand): boolean;
+}