homebridge-easy-mqtt 1.4.1-beta.0 → 1.5.0-beta.0

package/CHANGELOG.md

@@ -2,9 +2,17 @@
 
 All notable changes to homebridge-dummy will be documented in this file.
 
-## 1.4.1-beta.0 (2025-10-10)
+## 1.5.0-beta.0 (2025-10-20)
 
 ### Added
+- [Value Transformers](https://github.com/mpatfield/homebridge-easy-mqtt#history) (Thank you [@nehmeroumani](https://github.com/sponsors/nehmeroumani) for the code contribution!)
+- `Doorbell` accessory type
+- History and additional characteristics for for [Eve app](https://apps.apple.com/us/app/eve-for-matter-homekit/id917695792) users ([documentation](https://github.com/mpatfield/homebridge-easy-mqtt#history))
+    - Opened/closed history, and times opened count with option to reset for `ContactSensor`
+    - `MotionSensor` history
+    - Temperature history for `HeaterCooler`, `TemperatureSensor`, and `Thermostat`
+    - Humidity history for `HumiditySensor` and `Thermostat`
+    - On/off history and watts/amps/volts/kWh history for `Lightbulb`, `Outlet`, and `Switch`
 - Traduzioni in italiano. Grazie, [@Shikaban](https://github.com/sponsors/Shikaban)!
 
 ### Notes

package/README.md

@@ -30,6 +30,7 @@ This plugin is designed to be a simple replacement for the fantastic [homebridge
   - `CarbonDioxideSensor`
   - `CarbonMonoxideSensor`
   - `ContactSensor`
+  - `Doorbell`
   - `Fanv2`
   - `GarageDoorOpener`
   - `HeaterCooler`
@@ -82,6 +83,11 @@ Using the Homebridge Config UI is the easiest way to set up this plugin. However
           …
         ]
       },
+      "history": {
+        "enabled": true,
+        "disableRepeatLastData": false,
+        "size": 4032,
+      },
       "customCharacteristics": [
         {
           "uuid": "string",
@@ -134,7 +140,7 @@ Note that setting the this information in the JSON config will override the envi
 
 You will need to make sure to populate the appropriate topics based on the accessory type defined below.
 
-You may define topics using a JSONPath dot notation to assist the parser in finding the right value within the message. See [JSONPaths](#jsonpaths) below for more details.
+You may define topics using a JSONPath dot notation to assist the parser in finding the right value within the message. You can also add a value transformer to alter the incoming or outgoing value. See [Advanced Topic Notation](#advanced-topic-notation) below for more details.
 
 As with topics, you will also need to populate the appropriate values based on the type. Note that while they are defined as strings, they will be auto-converted to the appropriate primitives (e.g. boolean or number) where appropriate.
 
@@ -163,18 +169,30 @@ These values are used for both determining current state and, where appropriate,
 - `topicSetHue` - For setting the lightbulb's current hue
 - `topicGetSaturation` - The current saturation setting of the lightbulb
 - `topicSetSaturation` - For setting the saturation setting of the lightbulb
+- `topicGetCurrentConsumption` - Get the current power rate in watts ([Eve only](#eve-app-support))
+- `topicGetElectricCurrent` - Get the electrical current in amps ([Eve only](#eve-app-support))
+- `topicGetTotalConsumption` - Get the total energy use in kWh ([Eve only](#eve-app-support))
+- `topicGetVoltage` - Get the current voltage ([Eve only](#eve-app-support))
 
 #### Outlet
 - `topicGetOn*` - The current state of the outlet, i.e. on/off
 - `topicSetOn*` - For setting the state of the outlet
+- `topicGetOutletInUse` - Whether or not the outlet is
 - `valueOn*` - Turned on, e.g. "true", or "1", or "On"
 - `valueOff*` - Turned off, e.g. "false", or "0", or "Off"
-- `topicGetOutletInUse` - Whether or not the outlet is currently being used
 - `valueOutletInUse` - Currently being used, e.g. "true", or "1", or "On"
+- `topicGetCurrentConsumption` - Get the current power rate in watts ([Eve only](#eve-app-support))
+- `topicGetElectricCurrent` - Get the electrical current in amps ([Eve only](#eve-app-support))
+- `topicGetTotalConsumption` - Get the total energy use in kWh ([Eve only](#eve-app-support))
+- `topicGetVoltage` - Get the current voltage ([Eve only](#eve-app-support))
 
 #### Switch
 - `topicGetOn*` - The current state of the outlet, i.e. on/off
 - `topicSetOn*` - For setting the state of the outlet
+- `topicGetCurrentConsumption` - Get the current power rate in watts ([Eve only](#eve-app-support))
+- `topicGetElectricCurrent` - Get the electrical current in amps ([Eve only](#eve-app-support))
+- `topicGetTotalConsumption` - Get the total energy use in kWh ([Eve only](#eve-app-support))
+- `topicGetVoltage` - Get the current voltage ([Eve only](#eve-app-support))
 - `valueOn*` - Turned on, e.g. "true", or "1", or "On"
 - `valueOff*` - Turned off, e.g. "false", or "0", or "Off"
 
@@ -466,11 +484,27 @@ These values are used for both determining current state and, where appropriate,
 - `valueTampered` - Accessory has been tampered with
 
 #### StatelessProgrammableSwitch
-- `topicEventButtonPress` - Event for button press event
+- `topicEventButtonPress*` - Event for button press event
 - `valueSinglePress` - Single press event
 - `valueDoublePress` - Double press event
 - `valueLongPress` - Long press event
 
+### Doorbell
+- `maximumBrightness` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for brightness
+- `maximumVolume` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for volume
+- `topicEventButtonPress*` - Event for button press event
+- `topicGetBrightness` - Get the brightness
+- `topicSetBrightness` - Set the brightness
+- `topicGetMuted` - Get whether or not the doorbell is muted
+- `topicSetMuted` - Set whether or not the doorbell is muted
+- `topicGetVolume` - Get the volume
+- `topicSetVolume` - Set the volume
+- `valueSinglePress` - Single press event
+- `valueDoublePress` - Double press event
+- `valueLongPress` - Long press event
+- `valueMuted` - Doorbell muted
+- `valueUnmuted` - Doorbell unmuted
+
 #### Valve
 - `valveType` -  One of `GENERIC_VALVE` (default), `IRRIGATION`, `SHOWER_HEAD`, or `WATER_FAUCET`
 - `topicGetValveActive*` - For getting whether or not the valve is active
@@ -528,7 +562,9 @@ Each entry should have a topic and a message:
 ]
 ```
 
-## JSONPaths
+## Advanced Topic Notation
+
+### JSONPaths
 
 For some devices, the desired values in the MQTT messages are embedded within a JSON object. For example, here is the MQTT message for my door lock that is received when the door is locked:
 
@@ -593,9 +629,69 @@ then you would use the topic
 
 `zwave/4/security/set$.target.mode.value`
 
-## Custom Characteristics
+### Value Transformers
+
+There are other situations where the value needs to be adjusted or altered entirely.
+
+For example, you may have an Air Quality Sensor that measures Nitrogen Dioxide in ppm (parts per million) instead of µg/m³ (micrograms per cubic meter) which HomeKit expects. In this case, you need to multiply by the arbitrary number 1883 to get the correct result.
+
+Using the pipe (`|`) notation, you may add a transformer:
+
+`airquality/no2|value * 1883`
+
+This will multiply the value by `1883` to get the desired result.
+
+Note that `value` is a reserved keyword here to indicate the incoming value you'd like to transform.
+
+You can also do the same thing on the publish side to transfer it back to ppm. In this case, you would need to divide by 1883.
+
+`airquality/no2|value / 1883`
+
+### Both JSONPath + Transformer
+
+You can also combine JSONPath and Transformer notation into a single entity
+
+`airquality$.no2|value * 1883`
+
+## Eve App Support
+
+If you use [Eve](https://apps.apple.com/us/app/eve-for-matter-homekit/id917695792), then there are some additional features available:
+- Opened/closed history, and times opened count with option to reset for `ContactSensor`
+- `MotionSensor` history
+- Temperature history for `HeaterCooler`, `TemperatureSensor`, and `Thermostat`
+- Humidity history for `HumiditySensor` and `Thermostat`
+- On/off history for `Lightbulb`, `Outlet`, and `Switch`
+
+You can also add get topics for watts/amps/volts/kWh for `Lightbulb`, `Outlet`, and `Switch`:
+- `topicGetCurrentConsumption` - Get the current power rate in watts
+- `topicGetElectricCurrent` - Get the electrical current in amps
+- `topicGetTotalConsumption` - Get the total energy use in kWh
+- `topicGetVoltage` - Get the current voltage
+
+To enable history, choose the `History Enabled` option in the config UI.
+
+There are a couple of advanced options if configuring via JSON:
+
+```json
+{
+  "info": …
+  "mqtt": …
+  "history": {
+    "enabled": true,
+    "disableRepeatLastData": false,
+    "size": 4032,
+  },
+  … // Topic & Values
+}
+```
+
+- `enabled` — used to enable/disable history
+- `disableRepeatLastData` — See [fakegato-history](https://github.com/simont77/fakegato-history?tab=readme-ov-file#fakegato-history) for info
+- `size` - The maximum number of history entries. Default is 4032 (1 entry every 10 minutes for 28 days)
+
+### Custom Characteristics
 
-If you use a more advanced HomeKit app like [Eve](https://apps.apple.com/us/app/eve-for-matter-homekit/id917695792) or [Controller for Homekit](https://apps.apple.com/us/app/controller-for-homekit/id1198176727), you can add custom characteristics to display any arbitrary numeric information. Unfortunately, Apple currently doesn't offer a way to display this in the Home app.
+Eve users can also add custom characteristics to display any arbitrary numeric information.
 
 <img src="https://raw.githubusercontent.com/mpatfield/homebridge-easy-mqtt/refs/heads/latest/img/screenshot_1.png">
 

package/config.schema.json

@@ -21,8 +21,8 @@
           "type": {
             "type": "string",
             "title": "${config.title.type}",
-            "enum": [ "AirPurifier", "AirQualitySensor", "CarbonMonoxideSensor", "CarbonDioxideSensor", "ContactSensor", "Fanv2", "GarageDoorOpener", "HeaterCooler", "HumiditySensor", "LeakSensor", "Lightbulb", "LightSensor", "LockMechanism", "MotionSensor", "OccupancySensor", "Outlet", "SecuritySystem", "SmokeSensor", "StatelessProgrammableSwitch", "Switch", "TemperatureSensor", "Thermostat", "Valve", "WindowCovering"],
-            "enumNames": ["${config.enumNames.airPurifier}", "${config.enumNames.airQualitySensor}", "${config.enumNames.carbonMonoxideSensor}", "${config.enumNames.carbonDioxideSensor}", "${config.enumNames.contactSensor}", "${config.enumNames.fanv2}", "${config.enumNames.garageDoorOpener}", "${config.enumNames.heaterCooler}", "${config.enumNames.humiditySensor}", "${config.enumNames.leakSensor}", "${config.enumNames.lightbulb}", "${config.enumNames.lightSensor}", "${config.enumNames.lockMechanism}", "${config.enumNames.motionSensor}", "${config.enumNames.occupancySensor}", "${config.enumNames.outlet}", "${config.enumNames.securitySystem}", "${config.enumNames.smokeSensor}", "${config.enumNames.statelessSwitch}", "${config.enumNames.switch}",  "${config.enumNames.temperatureSensor}", "${config.enumNames.thermostat}", "${config.enumNames.valve}", "${config.enumNames.windowCovering}"],
+            "enum": [ "AirPurifier", "AirQualitySensor", "CarbonMonoxideSensor", "CarbonDioxideSensor", "ContactSensor", "Doorbell", "Fanv2", "GarageDoorOpener", "HeaterCooler", "HumiditySensor", "LeakSensor", "Lightbulb", "LightSensor", "LockMechanism", "MotionSensor", "OccupancySensor", "Outlet", "SecuritySystem", "SmokeSensor", "StatelessProgrammableSwitch", "Switch", "TemperatureSensor", "Thermostat", "Valve", "WindowCovering"],
+            "enumNames": ["${config.enumNames.airPurifier}", "${config.enumNames.airQualitySensor}", "${config.enumNames.carbonMonoxideSensor}", "${config.enumNames.carbonDioxideSensor}", "${config.enumNames.contactSensor}", "${config.enumNames.doorbell}", "${config.enumNames.fanv2}", "${config.enumNames.garageDoorOpener}", "${config.enumNames.heaterCooler}", "${config.enumNames.humiditySensor}", "${config.enumNames.leakSensor}", "${config.enumNames.lightbulb}", "${config.enumNames.lightSensor}", "${config.enumNames.lockMechanism}", "${config.enumNames.motionSensor}", "${config.enumNames.occupancySensor}", "${config.enumNames.outlet}", "${config.enumNames.securitySystem}", "${config.enumNames.smokeSensor}", "${config.enumNames.statelessSwitch}", "${config.enumNames.switch}",  "${config.enumNames.temperatureSensor}", "${config.enumNames.thermostat}", "${config.enumNames.valve}", "${config.enumNames.windowCovering}"],
             "required": true
           },
           "group": {
@@ -88,6 +88,15 @@
           }
         }
       },
+      "history": {
+        "type": "object",
+        "properties": {
+          "enabled": {
+            "type": "boolean",
+            "title": "${config.title.historyEnabled}"
+          }
+        }
+      },
       "customCharacteristic": {
         "type": "object",
         "properties": {
@@ -118,6 +127,7 @@
           "properties": {
             "info": { "$ref": "#/definitions/info" },
             "mqtt": { "$ref": "#/definitions/mqtt" },
+            "history": { "$ref": "#/definitions/history" },
             "customCharacteristics": {
               "type": "array",
               "items": { "$ref": "#/definitions/customCharacteristic" }
@@ -134,6 +144,10 @@
               "type": "integer",
               "title": "${config.title.maximum}"
             },
+            "maximumVolume": {
+              "type": "integer",
+              "title": "${config.title.maximum}"
+            },
             "temperatureUnits": {
               "type": "string",
               "title": "${config.title.sourceUnits}",
@@ -546,6 +560,38 @@
               "type": "string",
               "title": "${config.title.topicEventButtonPress}"
             },
+            "topicGetMuted": {
+              "type": "string",
+              "title": "${config.title.topicGetMuted}"
+            },
+            "topicGetVolume": {
+              "type": "string",
+              "title": "${config.title.topicGetVolume}"
+            },
+            "topicSetMuted": {
+              "type": "string",
+              "title": "${config.title.topicSetMuted}"
+            },
+            "topicSetVolume": {
+              "type": "string",
+              "title": "${config.title.topicSetVolume}"
+            },
+            "topicGetCurrentConsumption": {
+              "type": "string",
+              "title": "${config.title.topicGetCurrentConsumption}"
+            },
+            "topicGetElectricCurrent": {
+              "type": "string",
+              "title": "${config.title.topicGetElectricCurrent}"
+            },
+            "topicGetTotalConsumption": {
+              "type": "string",
+              "title": "${config.title.topicGetTotalConsumption}"
+            },
+            "topicGetVoltage": {
+              "type": "string",
+              "title": "${config.title.topicGetVoltage}"
+            },
             "valueBatteryLow": {
               "type": "string",
               "title": "${config.title.valueBatteryLow}"
@@ -814,6 +860,14 @@
               "type": "string",
               "title": "${config.title.valueLongPress}"
             },
+            "valueMuted": {
+              "type": "string",
+              "title": "${config.title.valueMuted}"
+            },
+            "valueUnmuted": {
+              "type": "string",
+              "title": "${config.title.valueUnmuted}"
+            },
             "resetOnRestart": {
               "type": "boolean",
               "title": "${config.title.resetOnRestart}"
@@ -1227,8 +1281,8 @@
                   "info": {
                     "properties": {
                       "type" : {
-                        "const": "StatelessProgrammableSwitch"
-                      }
+                        "enum": ["Doorbell, StatelessProgrammableSwitch"]
+                     }
                     }
                   }
                 }
@@ -1575,7 +1629,10 @@
                 "required": ["topicGetObstructionDetected"]
               },
               "then": {
-                "required": ["valuePositionObstructed"]
+                "anyOf": [
+                  { "required": ["valuePositionObstructed"] },
+                  { "required": ["valueDoorObstructed"] }
+                ]
               }
             },
             {
@@ -1629,6 +1686,32 @@
               "then": {
                 "required": ["topicGetCurrentVerticalTiltAngle"]
               }
+            },
+            {
+              "if": {
+                "properties": {
+                  "topicGetMuted": {
+                    "minLength": 1
+                  }
+                },
+                "required": ["topicGetMuted"]
+              },
+              "then": {
+                "required": ["topicSetMuted", "valueMuted", "valueUnmuted"]
+              }
+            },
+            {
+              "if": {
+                "properties": {
+                  "topicSetMuted": {
+                    "minLength": 1
+                  }
+                },
+                "required": ["topicSetMuted"]
+              },
+              "then": {
+                "required": ["topicGetMuted"]
+              }
             }
           ]
         },
@@ -1719,6 +1802,13 @@
                 {
                   "key": "accessories[].disableLogging",
                   "flex": "0 0 25%"
+                },
+                {
+                  "key": "accessories[].history.enabled",
+                  "flex": "0 0 25%",
+                  "condition": {
+                    "functionBody": "return ['ContactSensor', 'HeaterCooler', 'HumiditySensor', 'Lightbulb', 'MotionSensor', 'Outlet', 'Switch', 'TemperatureSensor', 'Thermostat'].includes(model.accessories?.[arguments[1]]?.info?.type);"
+                  }
                 }
               ]
             },
@@ -1837,7 +1927,7 @@
                   "type": "fieldset",
                   "notitle": true,
                   "condition": {
-                    "functionBody": "return model.accessories?.[arguments[1]]?.info?.type === 'StatelessProgrammableSwitch';"
+                    "functionBody": "return ['Doorbell', 'StatelessProgrammableSwitch'].includes(model.accessories?.[arguments[1]]?.info?.type);"
                   },
                   "items": [
                     {
@@ -1853,6 +1943,68 @@
                     }
                   ]
                 },
+                {
+                  "type": "fieldset",
+                  "notitle": true,
+                  "condition": {
+                    "functionBody": "return model.accessories?.[arguments[1]]?.info?.type === 'Doorbell';"
+                  },
+                  "items": [
+                    {
+                      "type": "div",
+                      "displayFlex": true,
+                      "flex-direction": "row",
+                      "items": [
+                        {
+                          "key": "accessories[].topicGetBrightness",
+                          "flex": "0 0 40%"
+                        },
+                        {
+                          "key": "accessories[].topicSetBrightness",
+                          "flex": "0 0 40%"
+                        },
+                        {
+                          "key": "accessories[].maximumBrightness",
+                          "flex": "0 0 20%"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "div",
+                      "displayFlex": true,
+                      "flex-direction": "row",
+                      "items": [
+                        {
+                          "key": "accessories[].topicGetVolume",
+                          "flex": "0 0 40%"
+                        },
+                        {
+                          "key": "accessories[].topicSetVolume",
+                          "flex": "0 0 40%"
+                        },
+                        {
+                          "key": "accessories[].maximumVolume",
+                          "flex": "0 0 20%"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "div",
+                      "displayFlex": true,
+                      "flex-direction": "row",
+                      "items": [
+                        {
+                          "key": "accessories[].topicGetMuted",
+                          "flex": "0 0 50%"
+                        },
+                        {
+                          "key": "accessories[].topicSetMuted",
+                          "flex": "0 0 50%"
+                        }
+                      ]
+                    }
+                  ]
+                },
                 {
                   "type": "fieldset",
                   "notitle": true,
@@ -2057,6 +2209,45 @@
                     }
                   ]
                 },
+                {
+                  "type": "fieldset",
+                  "notitle": true,
+                  "condition": {
+                    "functionBody": "return ['Lightbulb', 'Outlet', 'Switch'].includes(model.accessories?.[arguments[1]]?.info?.type);"
+                  },
+                  "items": [
+                    {
+                      "type": "div",
+                      "displayFlex": true,
+                      "flex-direction": "row",
+                      "items": [
+                        {
+                          "key": "accessories[].topicGetCurrentConsumption",
+                          "flex": "0 0 50%"
+                        },
+                        {
+                          "key": "accessories[].topicGetTotalConsumption",
+                          "flex": "0 0 50%"
+                        }
+                      ]
+                    },
+                    {
+                      "type": "div",
+                      "displayFlex": true,
+                      "flex-direction": "row",
+                      "items": [
+                        {
+                          "key": "accessories[].topicGetElectricCurrent",
+                          "flex": "0 0 50%"
+                        },
+                        {
+                          "key": "accessories[].topicGetVoltage",
+                          "flex": "0 0 50%"
+                        }
+                      ]
+                    }
+                  ]
+                },
                 {
                   "type": "fieldset",
                   "notitle": true,
@@ -3247,7 +3438,7 @@
                   "type": "fieldset",
                   "notitle": true,
                   "condition": {
-                    "functionBody": "return model.accessories?.[arguments[1]]?.info?.type === 'StatelessProgrammableSwitch';"
+                    "functionBody": "return ['Doorbell', 'StatelessProgrammableSwitch'].includes(model.accessories?.[arguments[1]]?.info?.type);"
                   },
                   "items": [
                     {
@@ -3271,6 +3462,24 @@
                     }
                   ]
                 },
+                {
+                  "type": "div",
+                  "displayFlex": true,
+                  "flex-direction": "row",
+                  "condition": {
+                    "functionBody": "return model.accessories?.[arguments[1]]?.info?.type === 'Doorbell';"
+                  },
+                  "items": [
+                    {
+                      "key": "accessories[].valueMuted",
+                      "flex": "0 0 25%"
+                    },
+                    {
+                      "key": "accessories[].valueUnmuted",
+                      "flex": "0 0 25%"
+                    }
+                  ]
+                },
                 {
                   "type": "fieldset",
                   "notitle": true,

package/dist/accessory/abstract/base.d.ts

@@ -1,9 +1,7 @@
-import { PlatformAccessory } from 'homebridge';
 import { MQTTAccessory } from './mqtt.js';
-import { CharacteristicType, BaseAccessoryConfig, ServiceType } from '../../model/types.js';
-import { Log } from '../../tools/log.js';
+import { CharacteristicKey } from '../../model/enums.js';
+import { BaseAccessoryConfig, MQTTAccessoryDependency } from '../../model/types.js';
 export declare abstract class BaseAccessory<C extends BaseAccessoryConfig = BaseAccessoryConfig> extends MQTTAccessory<C> {
-    constructor(Service: ServiceType, Characteristic: CharacteristicType, accessory: PlatformAccessory, config: C, log: Log, isGrouped: boolean);
-    private onBatteryLowUpdate;
-    private onStatusActiveUpdate;
+    constructor(dependency: MQTTAccessoryDependency<C>);
+    isOptionalCharacteristic(key: CharacteristicKey): boolean;
 }

package/dist/accessory/abstract/base.js

@@ -1,48 +1,28 @@
 import { MQTTAccessory } from './mqtt.js';
 import { PLATFORM_NAME } from '../../homebridge/settings.js';
+import { isOptionalHKCharacteristic } from '../characteristic/characteristic.js';
 import { strings } from '../../i18n/i18n.js';
-import { CharacteristicKey } from '../../model/enums.js';
+import { HKCharacteristicKey } from '../../model/enums.js';
 import { LogType } from '../../tools/log.js';
 import getVersion from '../../tools/version.js';
 export class BaseAccessory extends MQTTAccessory {
-    constructor(Service, Characteristic, accessory, config, log, isGrouped) {
-        super(Service, Characteristic, accessory, config, log, isGrouped);
-        if (!isGrouped) {
-            accessory.getService(Service.AccessoryInformation)
-                .setCharacteristic(Characteristic.Name, config.info.name)
-                .setCharacteristic(Characteristic.ConfiguredName, config.info.name)
-                .setCharacteristic(Characteristic.Manufacturer, config.info.manufacturer ?? PLATFORM_NAME)
-                .setCharacteristic(Characteristic.Model, config.info.model ?? config.info.type)
-                .setCharacteristic(Characteristic.SerialNumber, config.info.serialNumber ?? this.identifier)
-                .setCharacteristic(Characteristic.FirmwareRevision, config.info.version ?? getVersion());
+    constructor(dependency) {
+        super(dependency);
+        if (!dependency.isGrouped) {
+            this.platformAccessory.getService(dependency.Service.AccessoryInformation)
+                .setCharacteristic(dependency.Characteristic.Name, dependency.config.info.name)
+                .setCharacteristic(dependency.Characteristic.ConfiguredName, dependency.config.info.name)
+                .setCharacteristic(dependency.Characteristic.Manufacturer, dependency.config.info.manufacturer ?? PLATFORM_NAME)
+                .setCharacteristic(dependency.Characteristic.Model, dependency.config.info.model ?? dependency.config.info.type)
+                .setCharacteristic(dependency.Characteristic.SerialNumber, dependency.config.info.serialNumber ?? this.identifier)
+                .setCharacteristic(dependency.Characteristic.FirmwareRevision, dependency.config.info.version ?? getVersion());
         }
-        this.setup(CharacteristicKey.BatteryLevel, 100, 'topicGetBatteryLevel', this.bindOnUpdateNumeric(CharacteristicKey.BatteryLevel, strings.accessory.batteryLevel), false);
-        this.setup(CharacteristicKey.StatusLowBattery, Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL, 'topicGetBatteryLow', this.onBatteryLowUpdate.bind(this), false);
-        this.setup(CharacteristicKey.StatusActive, true, 'topicGetStatusActive', this.onStatusActiveUpdate.bind(this), false);
+        this.setup(HKCharacteristicKey.BatteryLevel, 100, 'topicGetBatteryLevel', this.bindOnUpdateNumeric(HKCharacteristicKey.BatteryLevel, strings.accessory.batteryLevel), false);
+        this.setup(HKCharacteristicKey.StatusLowBattery, dependency.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL, 'topicGetBatteryLow', this.bindOnUpdateBooleanSingle(HKCharacteristicKey.StatusLowBattery, 'valueBatteryLow', strings.accessory.batteryLow, strings.accessory.batteryNotLow, LogType.WARNING), false);
+        this.setup(HKCharacteristicKey.StatusActive, true, 'topicGetStatusActive', this.bindOnUpdateBooleanSingle(HKCharacteristicKey.StatusActive, 'valueStatusActive', strings.accessory.statusActive, strings.accessory.statusInactive, LogType.ALWAYS, LogType.WARNING), false);
     }
-    async onBatteryLowUpdate(topic, value) {
-        const batteryLow = value === this.getPrimitiveValue('valueBatteryLow') ? 1 : 0;
-        if (!this.onUpdate(CharacteristicKey.StatusLowBattery, batteryLow)) {
-            return;
-        }
-        if (batteryLow) {
-            this.logIfDesired(LogType.WARNING, strings.accessory.batteryLow);
-        }
-        else {
-            this.logIfDesired(strings.accessory.batteryNotLow);
-        }
-    }
-    async onStatusActiveUpdate(topic, value) {
-        const statusActive = value === this.getPrimitiveValue('valueStatusActive');
-        if (!this.onUpdate(CharacteristicKey.StatusActive, statusActive)) {
-            return;
-        }
-        if (statusActive) {
-            this.logIfDesired(strings.accessory.statusActive);
-        }
-        else {
-            this.logIfDesired(LogType.WARNING, strings.accessory.statusInactive);
-        }
+    isOptionalCharacteristic(key) {
+        return super.isOptionalCharacteristic(key) || isOptionalHKCharacteristic(key, this.config.info.type);
     }
 }
 //# sourceMappingURL=base.js.map

package/dist/accessory/abstract/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/accessory/abstract/base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,OAAO,EAAO,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAEhD,MAAM,OAAgB,aAAmE,SAAQ,aAAgB;IAE/G,YAAY,OAAoB,EAAE,cAAkC,EAAE,SAA4B,EAAE,MAAS,EAAE,GAAQ,EAAE,SAAkB;QACzI,KAAK,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;QAElE,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAE;iBAChD,iBAAiB,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxD,iBAAiB,CAAC,cAAc,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAClE,iBAAiB,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC;iBACzF,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9E,iBAAiB,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC;iBAC3F,iBAAiB,CAAC,cAAc,CAAC,gBAAgB,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAC5C,sBAAsB,EAAE,IAAI,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;QAE3H,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,cAAc,CAAC,gBAAgB,CAAC,oBAAoB,EACjG,oBAAoB,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QAEnE,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,YAAY,EAAE,IAAI,EAC7C,sBAAsB,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,KAAa,EAAE,KAAqB;QAEnE,MAAM,UAAU,GAAG,KAAK,KAAK,IAAI,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,UAAU,CAAC,EAAE,CAAC;YACnE,OAAO;QACT,CAAC;QAED,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,KAAa,EAAE,KAAqB;QAErE,MAAM,YAAY,GAAG,KAAK,KAAK,IAAI,CAAC,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,CAAC;YACjE,OAAO;QACT,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../src/accessory/abstract/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAEjF,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,EAAqB,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,UAAU,MAAM,wBAAwB,CAAC;AAEhD,MAAM,OAAgB,aAAmE,SAAQ,aAAgB;IAE/G,YAAY,UAAsC;QAChD,KAAK,CAAC,UAAU,CAAC,CAAC;QAElB,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC;YAC5B,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,CAAC,oBAAoB,CAAE;iBACxE,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC9E,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBACxF,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC;iBAC/G,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC/G,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,YAAY,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,UAAU,CAAC;iBACjH,iBAAiB,CAAC,UAAU,CAAC,cAAc,CAAC,gBAAgB,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;QACjH,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAC9C,sBAAsB,EAAE,IAAI,CAAC,mBAAmB,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,KAAK,CAAC,CAAC;QAE7H,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,UAAU,CAAC,cAAc,CAAC,gBAAgB,CAAC,oBAAoB,EAC9G,oBAAoB,EACpB,IAAI,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,iBAAiB,EACpF,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,OAAO,CAAC,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,EACjF,KAAK,CACN,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,YAAY,EAAE,IAAI,EAC/C,sBAAsB,EACtB,IAAI,CAAC,yBAAyB,CAAC,mBAAmB,CAAC,YAAY,EAAE,mBAAmB,EAClF,OAAO,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EACpG,KAAK,CAAC,CAAC;IACX,CAAC;IAEQ,wBAAwB,CAAC,GAAsB;QACtD,OAAO,KAAK,CAAC,wBAAwB,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvG,CAAC;CACF"}