hoffmation-base 3.0.0-alpha.9 → 3.0.0-alpha.90

package/lib/server/devices/hmIPDevices/hmIpLampe.js

@@ -11,23 +11,27 @@ const sharedFunctions_1 = require("../sharedFunctions");
 class HmIpLampe extends hmIpDevice_1.HmIPDevice {
     constructor(pInfo) {
         super(pInfo, deviceType_1.DeviceType.HmIpLampe);
-        this.lightOn = false;
+        /** @inheritDoc */
+        this._actuatorOn = false;
+        /** @inheritDoc */
         this.settings = new models_1.ActuatorSettings();
         this.lightOnSwitchID = '';
+        /** @inheritDoc */
         this.queuedValue = null;
+        /** @inheritDoc */
         this.targetAutomaticState = false;
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.lamp);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.blockAutomatic);
         this.lightOnSwitchID = `${this.info.fullID}.2.STATE`;
-        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this));
+        this.blockAutomationHandler = new blockAutomaticHandler_1.BlockAutomaticHandler(this.restoreTargetAutomaticValue.bind(this), this.log.bind(this));
     }
     get actuatorOn() {
-        return this.lightOn;
+        return this._actuatorOn;
     }
     restoreTargetAutomaticValue(c) {
-        this.log(models_1.LogLevel.Debug, c.logMessage);
-        this.setLight(new models_1.LampSetLightCommand(c, this.targetAutomaticState, 'Lampen RestoreTargetAutomaticValue'));
+        this.setLight(new models_1.LampSetLightCommand(c, this.targetAutomaticState));
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_1.LogLevel.DeepTrace, `Lampen Update : ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
         this.queuedValue = null;
@@ -35,7 +39,7 @@ class HmIpLampe extends hmIpDevice_1.HmIPDevice {
         switch (idSplit[3]) {
             case '1':
                 if (idSplit[4] === 'STATE') {
-                    this.lightOn = state.val;
+                    this._actuatorOn = state.val;
                     this.persist();
                 }
                 break;
@@ -52,7 +56,7 @@ class HmIpLampe extends hmIpDevice_1.HmIPDevice {
     /** @inheritdoc */
     setLight(c) {
         if (this.lightOnSwitchID === '') {
-            this.log(models_1.LogLevel.Error, `Keine Switch ID bekannt.`);
+            this.log(models_1.LogLevel.Error, 'Keine Switch ID bekannt.');
             return;
         }
         sharedFunctions_1.LampUtils.setActuator(this, c);

package/lib/server/devices/hmIPDevices/hmIpPraezenz.d.ts

@@ -1,31 +1,32 @@
 import { HmIPDevice } from './hmIpDevice';
-import { MotionSensorSettings } from '../../../models';
+import { MotionSensorAction, MotionSensorSettings } from '../../../models';
 import { iBatteryDevice, iIlluminationSensor, iMotionSensor } from '../baseDeviceInterfaces';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
+import { Battery } from '../sharedFunctions';
 export declare class HmIpPraezenz extends HmIPDevice implements iIlluminationSensor, iBatteryDevice, iMotionSensor {
-    private _battery;
-    private _lastBatteryPersist;
-    get lastBatteryPersist(): number;
+    /** @inheritDoc */
+    readonly battery: Battery;
     private static PRESENCE_DETECTION;
     private static CURRENT_ILLUMINATION;
-    excludeFromNightAlarm: boolean;
+    /** @inheritDoc */
     movementDetected: boolean;
-    get battery(): number;
+    /** @inheritDoc */
     settings: MotionSensorSettings;
     private _movementDetectedCallback;
     private initialized;
     private _lastMotionTime;
+    private _detectionsToday;
+    private _currentIllumination;
     constructor(pInfo: IoBrokerDeviceInfo);
+    get batteryLevel(): number;
     get timeSinceLastMotion(): number;
-    private _detectionsToday;
     get detectionsToday(): number;
     set detectionsToday(pVal: number);
-    private _currentIllumination;
     get currentIllumination(): number;
     private set currentIllumination(value);
-    addMovementCallback(pCallback: (pValue: boolean) => void): void;
+    addMovementCallback(pCallback: (action: MotionSensorAction) => void): void;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
     updatePresence(pVal: boolean): void;
     persistMotionSensor(): void;
-    persistBatteryDevice(): void;
 }

package/lib/server/devices/hmIPDevices/hmIpPraezenz.js

@@ -6,20 +6,16 @@ const deviceType_1 = require("../deviceType");
 const models_1 = require("../../../models");
 const services_1 = require("../../services");
 const DeviceCapability_1 = require("../DeviceCapability");
+const sharedFunctions_1 = require("../sharedFunctions");
 class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
-    get lastBatteryPersist() {
-        return this._lastBatteryPersist;
-    }
-    get battery() {
-        return this._battery;
-    }
     constructor(pInfo) {
         var _a;
         super(pInfo, deviceType_1.DeviceType.HmIpPraezenz);
-        this._battery = -99;
-        this._lastBatteryPersist = 0;
-        this.excludeFromNightAlarm = false;
+        /** @inheritDoc */
+        this.battery = new sharedFunctions_1.Battery(this);
+        /** @inheritDoc */
         this.movementDetected = false;
+        /** @inheritDoc */
         this.settings = new models_1.MotionSensorSettings();
         this._movementDetectedCallback = [];
         // private presenceStateID: string;
@@ -45,6 +41,9 @@ class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
             });
         }
     }
+    get batteryLevel() {
+        return this.battery.level;
+    }
     get timeSinceLastMotion() {
         return Math.floor((services_1.Utils.nowMS() - this._lastMotionTime) / 1000);
     }
@@ -65,6 +64,7 @@ class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
     addMovementCallback(pCallback) {
         this._movementDetectedCallback.push(pCallback);
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_1.LogLevel.DeepTrace, `Präzens Update: JSON: ${JSON.stringify(state)}ID: ${idSplit.join('.')}`);
         super.update(idSplit, state, initial, true);
@@ -72,8 +72,7 @@ class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
             case '0':
                 switch (idSplit[4]) {
                     case 'OPERATING_VOLTAGE':
-                        this._battery = 100 * ((state.val - 1.8) / 1.2);
-                        this.persistBatteryDevice();
+                        this.battery.level = 100 * ((state.val - 1.8) / 1.2);
                         break;
                 }
                 break;
@@ -91,7 +90,7 @@ class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
     }
     updatePresence(pVal) {
         if (!this.initialized && pVal) {
-            this.log(models_1.LogLevel.Debug, `Präsenz erkannt aber die Initialisierung aus der DB ist noch nicht erfolgt --> verzögern`);
+            this.log(models_1.LogLevel.Debug, 'Präsenz erkannt aber die Initialisierung aus der DB ist noch nicht erfolgt --> verzögern');
             services_1.Utils.guardedTimeout(() => {
                 this.updatePresence(pVal);
             }, 1000, this);
@@ -110,22 +109,13 @@ class HmIpPraezenz extends hmIpDevice_1.HmIPDevice {
             this.log(models_1.LogLevel.Trace, `Dies ist die ${this.detectionsToday} Bewegung `);
         }
         for (const c of this._movementDetectedCallback) {
-            c(pVal);
+            c(new models_1.MotionSensorAction(this));
         }
     }
     persistMotionSensor() {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistMotionSensor(this);
     }
-    persistBatteryDevice() {
-        var _a;
-        const now = services_1.Utils.nowMS();
-        if (this._lastBatteryPersist + 60000 > now) {
-            return;
-        }
-        (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistBatteryDevice(this);
-        this._lastBatteryPersist = now;
-    }
 }
 exports.HmIpPraezenz = HmIpPraezenz;
 // TODO: Add iPresenceSensor

package/lib/server/devices/hmIPDevices/hmIpRoll.d.ts

@@ -5,6 +5,7 @@ import { iShutter } from '../baseDeviceInterfaces';
 import { IoBrokerBaseDevice } from '../IoBrokerBaseDevice';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
 export declare class HmIpRoll extends HmIPDevice implements iShutter {
+    /** @inheritDoc */
     settings: ShutterSettings;
     private _setLevelSwitchID;
     private _firstCommandRecieved;
@@ -13,13 +14,14 @@ export declare class HmIpRoll extends HmIPDevice implements iShutter {
     constructor(pInfo: IoBrokerDeviceInfo);
     private _currentLevel;
     get currentLevel(): number;
-    set currentLevel(value: number);
+    /** @inheritDoc */
+    update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
     private _window?;
     get window(): Window | undefined;
     set window(value: Window | undefined);
     get desiredWindowShutterLevel(): number;
     persist(): void;
-    update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
+    private setCurrentLevel;
     setLevel(command: ShutterSetLevelCommand): void;
     toJSON(): Partial<IoBrokerBaseDevice>;
 }

package/lib/server/devices/hmIPDevices/hmIpRoll.js

@@ -15,6 +15,7 @@ class HmIpRoll extends hmIpDevice_1.HmIPDevice {
     constructor(pInfo) {
         var _a;
         super(pInfo, deviceType_1.DeviceType.HmIpRoll);
+        /** @inheritDoc */
         this.settings = new models_2.ShutterSettings();
         this._firstCommandRecieved = false;
         this._setLevel = -1;
@@ -36,18 +37,17 @@ class HmIpRoll extends hmIpDevice_1.HmIPDevice {
         }
         return this._currentLevel;
     }
-    set currentLevel(value) {
-        if (value !== this._setLevel && services_1.Utils.nowMS() - this._setLevelTime < 60 * 10000) {
-            value = this._setLevel;
-        }
-        if (value !== this._currentLevel && this._window) {
-            services_1.Utils.guardedNewThread(() => {
-                var _a;
-                (_a = this._window) === null || _a === void 0 ? void 0 : _a.rolloPositionChange(value);
-            }, this);
-            this.persist();
+    /** @inheritDoc */
+    update(idSplit, state, initial = false) {
+        this.log(models_2.LogLevel.DeepTrace, `Rollo Update : ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
+        super.update(idSplit, state, initial, true);
+        switch (idSplit[3]) {
+            case '3':
+                if (idSplit[4] === 'LEVEL') {
+                    this.setCurrentLevel(state.val, true);
+                }
+                break;
         }
-        this._currentLevel = value;
     }
     get window() {
         return this._window;
@@ -65,16 +65,18 @@ class HmIpRoll extends hmIpDevice_1.HmIPDevice {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistShutter(this);
     }
-    update(idSplit, state, initial = false) {
-        this.log(models_2.LogLevel.DeepTrace, `Rollo Update : ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
-        super.update(idSplit, state, initial, true);
-        switch (idSplit[3]) {
-            case '3':
-                if (idSplit[4] === 'LEVEL') {
-                    this.currentLevel = state.val;
-                }
-                break;
+    setCurrentLevel(value, initial = false) {
+        if (value !== this._setLevel && services_1.Utils.nowMS() - this._setLevelTime < 60 * 10000) {
+            value = this._setLevel;
+        }
+        if (value !== this._currentLevel && this._window && !initial) {
+            services_1.Utils.guardedNewThread(() => {
+                var _a;
+                (_a = this._window) === null || _a === void 0 ? void 0 : _a.rolloPositionChange(new models_2.ShutterPositionChangedAction(this, value));
+            }, this);
+            this.persist();
         }
+        this._currentLevel = value;
     }
     setLevel(command) {
         let targetLevel = command.level;
@@ -90,7 +92,7 @@ class HmIpRoll extends hmIpDevice_1.HmIPDevice {
             return;
         }
         if (this._setLevelSwitchID === '') {
-            this.log(models_2.LogLevel.Error, `Keine Switch ID bekannt.`);
+            this.log(models_2.LogLevel.Error, 'Keine Switch ID bekannt.');
             return;
         }
         if (!this.checkIoConnection(true)) {
@@ -98,16 +100,16 @@ class HmIpRoll extends hmIpDevice_1.HmIPDevice {
         }
         this.log(models_2.LogLevel.Debug, command.logMessage);
         if (this._window !== undefined) {
-            if (this._window.griffeInPosition(models_1.WindowPosition.offen) > 0 && command.level < 100) {
+            if (this._window.griffeInPosition(models_1.WindowPosition.open) > 0 && command.level < 100) {
                 if (!command.skipOpenWarning) {
-                    this.log(models_2.LogLevel.Alert, `Not closing the shutter, as the window is open!`);
+                    this.log(models_2.LogLevel.Alert, 'Not closing the shutter, as the window is open!');
                 }
                 return;
             }
-            if (this._window.griffeInPosition(models_1.WindowPosition.kipp) > 0 && targetLevel < 50) {
+            if (this._window.griffeInPosition(models_1.WindowPosition.tilted) > 0 && targetLevel < 50) {
                 targetLevel = 50;
                 if (!command.skipOpenWarning) {
-                    this.log(models_2.LogLevel.Alert, `Not closing the shutter, as the window is half open!`);
+                    this.log(models_2.LogLevel.Alert, 'Not closing the shutter, as the window is half open!');
                 }
             }
         }

package/lib/server/devices/hmIPDevices/hmIpTaster.d.ts

@@ -2,24 +2,38 @@ import { HmIPDevice } from './hmIpDevice';
 import { iBatteryDevice, iButtonSwitch } from '../baseDeviceInterfaces';
 import { Button, ButtonPosition, ButtonPressType } from '../button';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
+import { Battery } from '../sharedFunctions';
 export declare class HmIpTaster extends HmIPDevice implements iButtonSwitch, iBatteryDevice {
-    private _battery;
-    private _lastBatteryPersist;
-    get lastBatteryPersist(): number;
+    /** @inheritDoc */
+    readonly battery: Battery;
     private static readonly BUTTON_CAPABILLITIES;
+    /** @inheritDoc */
     buttonTopLeft: Button;
+    /** @inheritDoc */
     buttonMidLeft: Button;
+    /** @inheritDoc */
     buttonBotLeft: Button;
+    /** @inheritDoc */
     buttonTopRight: Button;
+    /** @inheritDoc */
     buttonMidRight: Button;
+    /** @inheritDoc */
     buttonBotRight: Button;
+    /**
+     * Not present for HM-IP-Taster
+     * @inheritDoc
+     */
     buttonBot: undefined;
+    /**
+     * Not present for HM-IP-Taster
+     * @inheritDoc
+     */
     buttonTop: undefined;
-    get battery(): number;
     constructor(pInfo: IoBrokerDeviceInfo);
+    get batteryLevel(): number;
     persist(buttonName: string, pressType: ButtonPressType): void;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
     getButtonAssignment(): string;
-    persistBatteryDevice(): void;
     pressButton(position: ButtonPosition, pressType: ButtonPressType): Error | null;
 }

package/lib/server/devices/hmIPDevices/hmIpTaster.js

@@ -7,18 +7,21 @@ const button_1 = require("../button");
 const models_1 = require("../../../models");
 const DeviceCapability_1 = require("../DeviceCapability");
 const services_1 = require("../../services");
+const sharedFunctions_1 = require("../sharedFunctions");
 class HmIpTaster extends hmIpDevice_1.HmIPDevice {
-    get lastBatteryPersist() {
-        return this._lastBatteryPersist;
-    }
-    get battery() {
-        return this._battery;
-    }
     constructor(pInfo) {
         super(pInfo, deviceType_1.DeviceType.HmIpTaster);
-        this._battery = -99;
-        this._lastBatteryPersist = 0;
+        /** @inheritDoc */
+        this.battery = new sharedFunctions_1.Battery(this);
+        /**
+         * Not present for HM-IP-Taster
+         * @inheritDoc
+         */
         this.buttonBot = undefined;
+        /**
+         * Not present for HM-IP-Taster
+         * @inheritDoc
+         */
         this.buttonTop = undefined;
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.buttonSwitch);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.batteryDriven);
@@ -29,10 +32,14 @@ class HmIpTaster extends hmIpDevice_1.HmIPDevice {
         this.buttonMidRight = new button_1.Button('MidRight', HmIpTaster.BUTTON_CAPABILLITIES);
         this.buttonBotRight = new button_1.Button('BotRight', HmIpTaster.BUTTON_CAPABILLITIES);
     }
+    get batteryLevel() {
+        return this.battery.level;
+    }
     persist(buttonName, pressType) {
         var _a;
         (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistSwitchInput(this, pressType, buttonName);
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_1.LogLevel.DeepTrace, `Taster Update: JSON: ${JSON.stringify(state)}ID: ${idSplit.join('.')}`);
         super.update(idSplit, state, initial, true);
@@ -41,8 +48,7 @@ class HmIpTaster extends hmIpDevice_1.HmIPDevice {
             case '0':
                 switch (idSplit[4]) {
                     case 'OPERATING_VOLTAGE':
-                        this._battery = 100 * ((state.val - 1.8) / 1.2);
-                        this.persistBatteryDevice();
+                        this.battery.level = 100 * ((state.val - 1.8) / 1.2);
                         break;
                 }
                 break;
@@ -113,15 +119,6 @@ class HmIpTaster extends hmIpDevice_1.HmIPDevice {
         result.push('____________');
         return result.join('\n');
     }
-    persistBatteryDevice() {
-        var _a;
-        const now = services_1.Utils.nowMS();
-        if (this._lastBatteryPersist + 60000 > now) {
-            return;
-        }
-        (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistBatteryDevice(this);
-        this._lastBatteryPersist = now;
-    }
     pressButton(position, pressType) {
         let taste;
         switch (position) {

package/lib/server/devices/hmIPDevices/hmIpTherm.d.ts

@@ -1,12 +1,12 @@
 import { HmIPDevice } from './hmIpDevice';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
 import { iBatteryDevice } from '../baseDeviceInterfaces';
+import { Battery } from '../sharedFunctions';
 export declare class HmIpTherm extends HmIPDevice implements iBatteryDevice {
-    private _battery;
-    private _lastBatteryPersist;
-    get lastBatteryPersist(): number;
-    get battery(): number;
+    /** @inheritDoc */
+    readonly battery: Battery;
     constructor(pInfo: IoBrokerDeviceInfo);
+    get batteryLevel(): number;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
-    persistBatteryDevice(): void;
 }

package/lib/server/devices/hmIPDevices/hmIpTherm.js

@@ -5,20 +5,18 @@ const hmIpDevice_1 = require("./hmIpDevice");
 const deviceType_1 = require("../deviceType");
 const models_1 = require("../../../models");
 const DeviceCapability_1 = require("../DeviceCapability");
-const services_1 = require("../../services");
+const sharedFunctions_1 = require("../sharedFunctions");
 class HmIpTherm extends hmIpDevice_1.HmIPDevice {
-    get lastBatteryPersist() {
-        return this._lastBatteryPersist;
-    }
-    get battery() {
-        return this._battery;
-    }
     constructor(pInfo) {
         super(pInfo, deviceType_1.DeviceType.HmIpTherm);
-        this._battery = -99;
-        this._lastBatteryPersist = 0;
+        /** @inheritDoc */
+        this.battery = new sharedFunctions_1.Battery(this);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.batteryDriven);
     }
+    get batteryLevel() {
+        return this.battery.level;
+    }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_1.LogLevel.DeepTrace, `Thermostat Update: ID: ${idSplit.join('.')} JSON: ${JSON.stringify(state)}`);
         super.update(idSplit, state, initial, true);
@@ -26,21 +24,11 @@ class HmIpTherm extends hmIpDevice_1.HmIPDevice {
             case '0':
                 switch (idSplit[4]) {
                     case 'OPERATING_VOLTAGE':
-                        this._battery = 100 * ((state.val - 1.8) / 1.2);
-                        this.persistBatteryDevice();
+                        this.battery.level = 100 * ((state.val - 1.8) / 1.2);
                         break;
                 }
                 break;
         }
     }
-    persistBatteryDevice() {
-        var _a;
-        const now = services_1.Utils.nowMS();
-        if (this._lastBatteryPersist + 60000 > now) {
-            return;
-        }
-        (_a = services_1.Utils.dbo) === null || _a === void 0 ? void 0 : _a.persistBatteryDevice(this);
-        this._lastBatteryPersist = now;
-    }
 }
 exports.HmIpTherm = HmIpTherm;

package/lib/server/devices/hmIPDevices/hmIpTuer.d.ts

@@ -2,8 +2,14 @@ import { HmIPDevice } from './hmIpDevice';
 import { iDisposable } from '../../services';
 import { MagnetPosition } from '../models';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
-export declare class HmIpTuer extends HmIPDevice implements iDisposable {
+import { iMagnetSensor } from '../baseDeviceInterfaces';
+export declare class HmIpTuer extends HmIPDevice implements iDisposable, iMagnetSensor {
+    /** @inheritDoc */
     position: MagnetPosition;
+    /** @inheritDoc */
+    telegramOnOpen: boolean;
+    /** @inheritDoc */
+    speakOnOpen: boolean;
     private _closedCallback;
     private _openCallback;
     private _iOpenTimeout;
@@ -11,7 +17,9 @@ export declare class HmIpTuer extends HmIPDevice implements iDisposable {
     constructor(pInfo: IoBrokerDeviceInfo);
     addOpenCallback(pCallback: (pValue: boolean) => void): void;
     addClosedCallback(pCallback: (pValue: boolean) => void): void;
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
     updatePosition(pValue: MagnetPosition): void;
+    /** @inheritDoc */
     dispose(): void;
 }

package/lib/server/devices/hmIPDevices/hmIpTuer.js

@@ -9,7 +9,12 @@ const models_2 = require("../../../models");
 class HmIpTuer extends hmIpDevice_1.HmIPDevice {
     constructor(pInfo) {
         super(pInfo, deviceType_1.DeviceType.HmIpTuer);
+        /** @inheritDoc */
         this.position = models_1.MagnetPosition.closed;
+        /** @inheritDoc */
+        this.telegramOnOpen = false;
+        /** @inheritDoc */
+        this.speakOnOpen = false;
         this._closedCallback = [];
         this._openCallback = [];
         this.minutesOpen = 0;
@@ -20,6 +25,7 @@ class HmIpTuer extends hmIpDevice_1.HmIPDevice {
     addClosedCallback(pCallback) {
         this._closedCallback.push(pCallback);
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_2.LogLevel.DeepTrace, `Tuer Update: JSON: ${JSON.stringify(state)}ID: ${idSplit.join('.')}`);
         super.update(idSplit, state, initial, true);
@@ -52,10 +58,12 @@ class HmIpTuer extends hmIpDevice_1.HmIPDevice {
                 clearInterval(this._iOpenTimeout);
                 let message = `${this.info.customName} closed after ${this.minutesOpen} minutes!`;
                 if (this.minutesOpen === 0) {
-                    message = `just closed`;
+                    message = 'just closed';
                 }
                 this.log(models_2.LogLevel.Info, message);
-                services_1.TelegramService.inform(message);
+                if (this.telegramOnOpen) {
+                    services_1.TelegramService.inform(message);
+                }
                 this.minutesOpen = 0;
                 this._iOpenTimeout = undefined;
             }
@@ -64,8 +72,12 @@ class HmIpTuer extends hmIpDevice_1.HmIPDevice {
         else if (this._iOpenTimeout === undefined) {
             const message = services_1.Res.wasOpened(this.info.customName);
             //const message: string = `Die Tür mit dem Namen wurde geöfnet!`
-            services_1.TelegramService.inform(message);
-            services_1.SonosService.speakOnAll(message, 40);
+            if (this.telegramOnOpen) {
+                services_1.TelegramService.inform(message);
+            }
+            if (this.speakOnOpen) {
+                services_1.SonosService.speakOnAll(message, 40);
+            }
             this._iOpenTimeout = services_1.Utils.guardedInterval(() => {
                 this.minutesOpen++;
                 const message = `Contact is  ${models_1.MagnetPosition[this.position]} since ${this.minutesOpen} minutes`;
@@ -86,6 +98,7 @@ class HmIpTuer extends hmIpDevice_1.HmIPDevice {
             }, 60000, this);
         }
     }
+    /** @inheritDoc */
     dispose() {
         if (this._iOpenTimeout) {
             clearInterval(this._iOpenTimeout);

package/lib/server/devices/hmIPDevices/hmIpWippe.d.ts

@@ -4,15 +4,42 @@ import { iButtonSwitch } from '../baseDeviceInterfaces';
 import { IoBrokerDeviceInfo } from '../IoBrokerDeviceInfo';
 export declare class HmIpWippe extends HmIPDevice implements iButtonSwitch {
     private static readonly BUTTON_CAPABILLITIES;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonTopLeft: undefined;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonMidLeft: undefined;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonBotLeft: undefined;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonTopRight: undefined;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonMidRight: undefined;
+    /**
+     * Not present for HM-IP-Wippe
+     * @inheritDoc
+     */
     buttonBotRight: undefined;
+    /** @inheritDoc */
     buttonBot: Button;
+    /** @inheritDoc */
     buttonTop: Button;
     constructor(pInfo: IoBrokerDeviceInfo);
+    /** @inheritDoc */
     update(idSplit: string[], state: ioBroker.State, initial?: boolean): void;
     persist(buttonName: string, pressType: ButtonPressType): void;
     getButtonAssignment(): string;

package/lib/server/devices/hmIPDevices/hmIpWippe.js

@@ -10,10 +10,13 @@ const services_1 = require("../../services");
 class HmIpWippe extends hmIpDevice_1.HmIPDevice {
     constructor(pInfo) {
         super(pInfo, deviceType_1.DeviceType.HmIpWippe);
+        /** @inheritDoc */
         this.buttonBot = new button_1.Button('Bottom', HmIpWippe.BUTTON_CAPABILLITIES);
+        /** @inheritDoc */
         this.buttonTop = new button_1.Button('Top', HmIpWippe.BUTTON_CAPABILLITIES);
         this.deviceCapabilities.push(DeviceCapability_1.DeviceCapability.buttonSwitch);
     }
+    /** @inheritDoc */
     update(idSplit, state, initial = false) {
         this.log(models_1.LogLevel.DeepTrace, `Wippe Update: JSON: ${JSON.stringify(state)}ID: ${idSplit.join('.')}`);
         super.update(idSplit, state, initial, true);

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

@@ -1,4 +1,18 @@
+/**
+ * Service to update the state of any device
+ */
 export interface IDeviceUpdater {
+    /**
+     * Updates the state of a device
+     * @param id - The id of the device
+     * @param state - The new state
+     * @param initial - Whether this is an initial state update
+     */
     updateState(id: string, state: ioBroker.State, initial?: boolean): void;
+    /**
+     * Updates the given object
+     * @param pId - The id of the object
+     * @param pObj - The new object
+     */
     updateObject(pId: string, pObj: ioBroker.Object): void;
 }