homebridge-easy-mqtt 1.4.0-beta.8 → 1.4.0

package/CHANGELOG.md

@@ -2,20 +2,34 @@
 
 All notable changes to homebridge-dummy will be documented in this file.
 
-## 1.4.0-beta.8 (2025-09-22)
+## 1.4.0 (2025-10-08)
 
 ### Added
-- Support for Air Purifier, HeaterCooler, LightSensor, and Valve
+- New accessory types:
+    - `Air Purifier`
+    - `Air Quality Sensor`
+    - `Fanv2`
+    - `GarageDoorOpener`
+    - `HeaterCooler`
+    - `LightSensor`
+    - `StatelessProgrammableSwitch`
+    - `Valve`
+    - `Window Covering`
 - Broker, username, and password can be set via environment variables ([documentation](https://github.com/mpatfield/homebridge-easy-mqtt#environment-variables))
+- Publish arbitrary MQTT messages on connect ([documentation] (https://github.com/mpatfield/homebridge-easy-mqtt#mqtt-onconnect))
+- Lightbulb `maximumBrightness` to use values (i.e. 1, 2, 3) rather than a percentage for lightbulb brightness
 - Traduceri în limba română. Mulțumesc, [@rursache](https://github.com/sponsors/rursache)!
+- Bản dịch tiếng Việt. Cảm ơn [@khanhnd88](https://github.com/sponsors/khanhnd88)!
 
 ### Changed
+- ⚠️ Accessory states are now saved across plugin/Homebridge restarts
+    - If you want to keep the old behavior, select the `Reset on Restart` option for each accessory you want to reset
+- MQTT `options` JSON can now also include both client and publish options, such as `retain`
 - Optimized MQTT connections by sharing across multiple accessories when possible
-    - Previously, every accessory had its own connection
+    - Previously, every accessory always had its own dedicated connection
 - Better field validation in config UI (Thank you, [@justjam2013](https://github.com/sponsors/justjam2013) for teaching me this!)
-
-### Fixed
-- Config UI rendering issue when migrating deprecated fields
+- Significant under-the-hood cleanup to speed future development
+- Traductions françaises mises à jour. Merci, [@7ute](https://github.com/sponsors/7ute)!
 
 ### Notes
 Would you like to see Homebridge Easy MQTT in your language? Please consider [getting involved](https://github.com/mpatfield/homebridge-easy-mqtt/issues/4). No coding experience required!

package/README.md

@@ -25,21 +25,30 @@ This plugin is designed to be a simple replacement for the fantastic [homebridge
 
 **HomebridgeEasyMQTT** currently supports the following accessory types but will be expanded over time as more use cases are requested. If there is an accessory type you'd like to see supported, please [create an issue in GitHub](https://github.com/mpatfield/homebridge-easy-mqtt/issues/new/choose).
 
+  - `AirPurifier`
+  - `AirQualitySensor`
   - `CarbonDioxideSensor`
   - `CarbonMonoxideSensor`
   - `ContactSensor`
+  - `Fanv2`
+  - `GarageDoorOpener`
+  - `HeaterCooler`
   - `HumiditySensor`
   - `LeakSensor`
   - `Lightbulb`
+  - `LightSensor`
   - `LockMechanism`
   - `MotionSensor`
   - `OccupancySensor`
   - `Outlet`
   - `SecuritySystem`
   - `SmokeSensor`
+  - `StatelessProgrammableSwitch`
   - `Switch`
   - `TemperatureSensor`
   - `Thermostat`
+  - `Valve`
+  - `WindowCovering`
 
 ## Configuration
 
@@ -64,7 +73,14 @@ Using the Homebridge Config UI is the easiest way to set up this plugin. However
         "broker": "string",
         "username": "string",
         "password": "string",
-        "options": "string"
+        "options": "string",
+        "onConnect": [
+          {
+            "topic": "string",
+            "message": "string",
+          }
+          …
+        ]
       },
       "customCharacteristics": [
         {
@@ -75,6 +91,7 @@ Using the Homebridge Config UI is the easiest way to set up this plugin. However
         }
         …
       ],
+      "resetOnRestart": false,
       "disableLogging": false,
       … // See Topics & Values below for additional attributes for each accessory type
   ],
@@ -88,7 +105,7 @@ Required fields are marked with an asterisk (*)
 ### Info
 - `id*` - A unique ID to identify this accessory. Changing this value will result in a new accessory.
 - `name*` - The display name for the accessory in HomeKit
-- `type*` - The type of accessory, currently Lightbulb, LockMechanism, Outlet, SecuritySystem, Switch, and Temperature Sensor are supported
+- `type*` - The type of accessory. See list of currently supported types above.
 - `group` - Items sharing the same group name will be grouped together in the Home app UI
     - ⚠️ Changing the group name will require you to reconfigure any HomeKit scenes/automations for those accessories
 - `manufacturer` - The accessory manufacturer which will display in HomeKit device details
@@ -101,6 +118,7 @@ Required fields are marked with an asterisk (*)
 - `username` - Username
 - `password` - Password
 - `options` - See [MQTT Options](#mqtt-options) below
+- `onConnect` - See [MQTT OnConnect](#mqtt-onconnect) below
 
 #### Environment Variables
 
@@ -120,6 +138,8 @@ You may define topics using a JSONPath dot notation to assist the parser in find
 
 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.
 
+These values are used for both determining current state and, where appropriate, publishing the new state to MQTT
+
 ### General Purpose
 - `topicGetStatusActive` - Whether or not the accessory is connected/reachable
 - `topicGetBatteryLow` - Wether or not the accessory has a low battery
@@ -128,12 +148,13 @@ As with topics, you will also need to populate the appropriate values based on t
 - `valueBatteryLow` - Accessory has a low battery level
 
 ### On/Off Accessories
+
+#### Lightbulb
+- `maximumBrightness` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for brightness
 - `topicGetOn*` - The current state of the outlet, i.e. on/off
 - `topicSetOn*` - For setting the state of the outlet
 - `valueOn*` - Turned on, e.g. "true", or "1", or "On"
 - `valueOff*` - Turned off, e.g. "false", or "0", or "Off"
-
-#### Lightbulb
 - `topicGetBrightness` - The current brightness as a percent
 - `topicSetBrightness` - For setting the brightness
 - `topicGetColorTemperature` - The current color temperature of the lightbulb
@@ -144,15 +165,60 @@ As with topics, you will also need to populate the appropriate values based on t
 - `topicSetSaturation` - For setting the saturation setting of the lightbulb
 
 #### Outlet
+- `topicGetOn*` - The current state of the outlet, i.e. on/off
+- `topicSetOn*` - For setting the state of the outlet
+- `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"
 
 #### Switch
--
+- `topicGetOn*` - The current state of the outlet, i.e. on/off
+- `topicSetOn*` - For setting the state of the outlet
+- `valueOn*` - Turned on, e.g. "true", or "1", or "On"
+- `valueOff*` - Turned off, e.g. "false", or "0", or "Off"
+
+### Position Accessories
+
+#### WindowCovering
+- `maximumPosition` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for position
+- `topicGetPositionState*` - Get position state (Decreasing, Increasing, Stopped)
+- `topicGetCurrentPosition*` - Get current position percent
+- `topicGetTargetPosition*` - Get target position percent
+- `topicSetTargetPosition*` - Set target position percent
+- `topicGetCurrentHorizontalTiltAngle` - Get current horizontal angle (-90° to 90°)
+- `topicGetTargetHorizontalTiltAngle` - Get target horizontal angle (-90° to 90°)
+- `topicSetTargetHorizontalTiltAngle` - Set target horizontal angle (-90° to 90°)
+- `topicGetCurrentVerticalTiltAngle` - Get current vertical angle (-90° to 90°)
+- `topicGetTargetVerticalTiltAngle` - Get target vertical angle (-90° to 90°)
+- `topicSetTargetVerticalTiltAngle` - Set target vertical angle (-90° to 90°)
+- `topicSetHoldPosition` - Set hold (true/false)
+- `topicGetObstructionDetected` - Get obstruction detected
+- `valuePositionDecreasing` - Closing
+- `valuePositionIncreasing` - Opening
+- `valuePositionStopped` - Stopped
+- `valuePositionHold` - Hold
+- `valuePositionResume` - Resume
+- `valuePositionObstructed` - Obstruction detected
 
 ### Sensors
+
+#### AirQualitySensor
+- `topicGetAirQuality*` - Get air quality
+- `topicGetNitrogenDioxideDensity` - Get nitrogen dioxide density in µg/m³
+- `topicGetOzoneDensity` - Get ozone density in µg/m³
+- `topicGetPM2_5Density` - Get PM2.5 density in µg/m³
+- `topicGetPM10Density` - Get PM10 density in µg/m³
+- `topicGetSulphurDioxideDensity` - Get sulphur dioxide density in µg/m³
+- `topicGetVOCDensity` - Get VOC density in µg/m³
 - `topicGetStatusFault` - Whether or not the sensor has a generic fault
 - `topicGetStatusTampered` - Whether or not the sensor has been tampered with
+- `valueAQExcellent` - Air quality excellent
+- `valueAQGood` - Air quality good
+- `valueAQFair` - Air quality fair
+- `valueAQInferior` - Air quality inferior
+- `valueAQPoor` - Air quality poor
+- `valueAQUnknown` - Air quality unknown
 - `valueFault` - Accessory has a fault
 - `valueTampered` - Accessory has been tampered with
 
@@ -160,105 +226,223 @@ As with topics, you will also need to populate the appropriate values based on t
 - `topicGetCarbonDioxideDetected*` - Whether or not the sensor has detected carbon dioxide
 - `topicGetCarbonDioxideLevel` - The current carbon dioxide level
 - `topicGetCarbonDioxidePeakLevel` - The peak carbon dioxide level
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueCarbonDioxideDetected*` - Accessory has detected carbon dioxide
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### CarbonMonoxideSensor
 - `topicGetCarbonMonoxideDetected*` - Whether or not the sensor has detected carbon monoxide
 - `topicGetCarbonMonoxideLevel` - The current carbon monoxide level
 - `topicGetCarbonMonoxidePeakLevel` - The peak carbon monoxide level
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueCarbonMonoxideDetected*` - Accessory has detected carbon monoxide
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### ContactSensor
 - `topicGetContactSensorState*` - Whether or not sensor has detected contact
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueContactDetected*` - Accessory has detected contact
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 ### HumiditySensor
 - `topicGetCurrentRelativeHumidity*` - The current relatively humidity
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### LeakSensor
 - `topicGetLeakDetected*` - Whether or not sensor has detected a leak
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueLeakDetected*` - Accessory has detected a leak
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### LightSensor
 - `topicGetCurrentAmbientLightLevel*` - The current light level in lux units
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### MotionSensor
 - `topicGetMotionDetected*` - Whether or not sensor has detected motion
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueMotionDetected*` - Accessory has detected motion
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### OccupancySensor
 - `topicGetOccupancyDetected*` - Whether or not sensor has detected occupancy
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueOccupancyDetected*` - Accessory has detected occupancy
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### SmokeSensor
 - `topicGetSmokeDetected*` - Whether or not sensor has detected smoke
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
 - `valueSmokeDetected*` - Accessory has detected smoke
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
 #### TemperatureSensor
 - `topicGetCurrentTemperature*` - The current temperature of the sensor
 - `temperatureUnits` - The temperature units of the incoming value supplied by the sensor, `C` for Celsius  (default) `F` for Fahrenheit
+- `topicGetStatusFault` - Whether or not the sensor has a generic fault
+- `topicGetStatusTampered` - Whether or not the sensor has been tampered with
+- `valueFault` - Accessory has a fault
+- `valueTampered` - Accessory has been tampered with
 
-### Temperature Control
-- `temperatureUnits` - The temperature units of the incoming value supplied by the thermostat, `C` for Celsius  (default) `F` for Fahrenheit
-- `topicGetCurrentTemperature*` - Get the current temperature
-- `topicGetCoolingThresholdTemperature` - Get the cooling threshold temperature
-- `topicSetCoolingThresholdTemperature` - Set the cooling threshold temparture
-- `topicGetHeatingThresholdTemperature` - Get the heating threshold temperature
-- `topicSetHeatingThresholdTemperature` - Set the heating threshold temperature
+### Climate Controllers
 
 #### Thermostat
+- `temperatureUnits` - The temperature units of the incoming value supplied by the thermostat, `C` for Celsius  (default) `F` for Fahrenheit
+- `topicGetCurrentTemperature*` - Get the current temperature
 - `topicGetCurrentHeatingCoolingState*` - Get the current mode (i.e. cooling, heating, off)
 - `topicGetTargetHeatingCoolingState*` - Get the target mode (i.e. auto, cooling, heating, off)
 - `topicSetTargetHeatingCoolingState*` - Set the target mode (i.e. auto, cooling, heating, off)
 - `topicGetTargetTemperature*` - Get the target temperature
 - `topicSetTargetTemperature*` - Set the target temperature
+- `topicGetCoolingThresholdTemperature` - Get the cooling threshold temperature
+- `topicSetCoolingThresholdTemperature` - Set the cooling threshold temparture
+- `topicGetHeatingThresholdTemperature` - Get the heating threshold temperature
+- `topicSetHeatingThresholdTemperature` - Set the heating threshold temperature
 - `topicGetCurrentRelativeHumidity` - Get the current humidity
 - `topicGetTargetRelativeHumidity` - Get the target humidity
 - `topicSetTargetRelativeHumidity` - Set the target humidity
+- `topicGetFilterChangeIndication` - Whether or not the filter needs to be changed. *Required if other filter topics are defined.
+- `topicGetFilterLifeLevel` - Filter life remaining as a percentage
+- `topicResetFilterIndication` - Used to reset the filter
 - `valueModeAuto` - Auto mode
 - `valueModeCool` - Cool mode
 - `valueModeHeat` - Heat mode
 - `valueModeOff` - Thermostat off
+- `valueFilterChange` - Indicates that the filter needs to be changed. *Required if `topicGetFilterChangeIndication` is defined.
 
-### Active Climate Control
-`Temperature Control` topics above plus…
+#### AirPurifier
+- `maximumRotationSpeed` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for rotation speed
 - `topicGetActive*` - Get whether or not the accessory is currently active
 - `topicSetActive*` - Set whether or not the accessory is currently active
+- `topicGetCurrentPurifierState*` - Get the current mode (i.e. inactive, idle, purifying)
+- `topicGetTargetPurifierState*` - Get the target mode (i.e. auto, manual)
+- `topicSetTargetPurifierState*` - Set the target mode (i.e. auto, manual)
 - `topicGetLockPhysicalControls` - Get whether or not the physical controls are locked
 - `topicSetLockPhysicalControls` - Set whether or not the physical controls are locked
 - `topicGetRotationSpeed` - Get the rotation speed as a percentage
 - `topicSetRotationSpeed` - Set the rotation speed as a percentage
 - `topicGetSwingMode` - Get whether or not accessory is oscillating
 - `topicSetSwingMode` - Set whether or not accessory is oscillating
+- `topicGetFilterChangeIndication` - Whether or not the filter needs to be changed. *Required if other filter topics are defined.
+- `topicGetFilterLifeLevel` - Filter life remaining as a percentage
+- `topicResetFilterIndication` - Used to reset the filter
 - `valueStateActive*` - Accessory is currently active
 - `valueStateInactive*` - Accessory is currently inactive
+- `valueModeAuto` - Auto target mode
+- `valueModeIdle` - Idle mode
+- `valueModeInactive` - Inactive mode
+- `valueModeManual` - Manual target mode
+- `valueModePurifying` - Purifying mode
 - `valueControlLock` - Physical controls are locked
 - `valueControlUnlock` - Physical controls are unlocked
 - `valueSwingEnabled` - Accessory is oscillating
 - `valueSwingDisabled` - Accessory is not oscillating
+- `valueFilterChange` - Indicates that the filter needs to be changed. *Required if `topicGetFilterChangeIndication` is defined.
 
-#### Air Purifier
-- `topicGetCurrentPurifierState*` - Get the current mode (i.e. inactive, idle, purifying)
-- `topicGetTargetPurifierState*` - Get the target mode (i.e. auto, manual)
-- `topicSetTargetPurifierState*` - Set the target mode (i.e. auto, manual)
-- `valueModeAuto` - Auto target mode
+#### Fanv2
+- `maximumRotationSpeed` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for rotation speed
+- `topicGetActive*` - Get whether or not the accessory is currently active
+- `topicSetActive*` - Set whether or not the accessory is currently active
+- `topicGetCurrentFanState` - Get current fan mode (blowing, idle, inactive)
+- `topicGetTargetFanState` - Get target fan mode (auto, manual)
+- `topicSetTargetFanState` - Set target fan mode (auto, manual)
+- `topicGetLockPhysicalControls` - Get whether or not the physical controls are locked
+- `topicSetLockPhysicalControls` - Set whether or not the physical controls are locked
+- `topicGetRotationDirection` - Get the fan rotation direction (clockwise, counter clockwise)
+- `topicSetRotationDirection` - Set the fan rotation direction (clockwise, counter clockwise)
+- `topicGetRotationSpeed` - Get the rotation speed as a percentage
+- `topicSetRotationSpeed` - Set the rotation speed as a percentage
+- `topicGetSwingMode` - Get whether or not accessory is oscillating
+- `topicSetSwingMode` - Set whether or not accessory is oscillating
+- `valueStateActive*` - Accessory is currently active
+- `valueStateInactive*` - Accessory is currently inactive
+- `valueModeBlowing` - Air blowing mode
 - `valueModeIdle` - Idle mode
 - `valueModeInactive` - Inactive mode
+- `valueModeAuto` - Auto target mode
 - `valueModeManual` - Manual target mode
-- `valueModePurifying` - Purifying mode
+- `valueDirectionClockwise` - Rotating clockwise
+- `valueDirectionCounterClockwise` - Rotating counter clockwise
+- `valueControlLock` - Physical controls are locked
+- `valueControlUnlock` - Physical controls are unlocked
+- `valueSwingEnabled` - Accessory is oscillating
+- `valueSwingDisabled` - Accessory is not oscillating
 
 #### HeaterCooler
+- `maximumRotationSpeed` - Set a maximum to use values (i.e. 1, 2, 3) rather than a percentage for rotation speed
+- `temperatureUnits` - The temperature units of the incoming value supplied by the thermostat, `C` for Celsius  (default) `F` for Fahrenheit
+- `topicGetActive*` - Get whether or not the accessory is currently active
+- `topicSetActive*` - Set whether or not the accessory is currently active
+- `topicGetCurrentTemperature*` - Get the current temperature
 - `topicGetCurrentHeaterCoolerState*` - Get the current mode (i.e. inactive, idle, heating, cooling)
 - `topicGetTargetHeaterCoolerState*` - Get the target mode (i.e. auto, heat, cool)
 - `topicSetTargetHeaterCoolerState*` - Set the target mode (i.e. auto, heat, cool)
+- `topicGetCoolingThresholdTemperature` - Get the cooling threshold temperature
+- `topicSetCoolingThresholdTemperature` - Set the cooling threshold temparture
+- `topicGetHeatingThresholdTemperature` - Get the heating threshold temperature
+- `topicSetHeatingThresholdTemperature` - Set the heating threshold temperature
+- `topicGetLockPhysicalControls` - Get whether or not the physical controls are locked
+- `topicSetLockPhysicalControls` - Set whether or not the physical controls are locked
+- `topicGetRotationSpeed` - Get the rotation speed as a percentage
+- `topicSetRotationSpeed` - Set the rotation speed as a percentage
+- `topicGetSwingMode` - Get whether or not accessory is oscillating
+- `topicSetSwingMode` - Set whether or not accessory is oscillating
+- `topicGetFilterChangeIndication` - Whether or not the filter needs to be changed. *Required if other filter topics are defined.
+- `topicGetFilterLifeLevel` - Filter life remaining as a percentage
+- `topicResetFilterIndication` - Used to reset the filter
+- `valueStateActive*` - Accessory is currently active
+- `valueStateInactive*` - Accessory is currently inactive
 - `valueModeAuto` - Mode is auto
 - `valueModeCool` - Mode is cool/cooling
 - `valueModeHeat` - Mode is heat/heating
 - `valueModeIdle` - Mode is idle
 - `valueModeInactive` - Mode is inactive
+- `valueControlLock` - Physical controls are locked
+- `valueControlUnlock` - Physical controls are unlocked
+- `valueSwingEnabled` - Accessory is oscillating
+- `valueSwingDisabled` - Accessory is not oscillating
+- `valueFilterChange` - Indicates that the filter needs to be changed. *Required if `topicGetFilterChangeIndication` is defined.
 
 ### Others
 
+#### GarageDoorOpener
+- `topicGetCurrentDoorState*` - Current state of the garage door, i.e. open/opening/closed/closing/stopped
+- `topicGetTargetDoorState*` - Target state of the garage door, i.e. open/closed
+- `topicSetTargetDoorState*` - Set the target door state, i.e. open/closed
+- `topicGetObstructionDetected*` - Whether or not the garage door is obstructed
+- `topicGetCurrentLockState` - The current state of the garage lock, i.e. locked/unlocked
+- `topicGetTargetLockState` - The target (i.e. desired) state of the garage lock
+- `topicSetTargetLockState` - For setting the target (i.e. desired) state of the garage lock
+- `valueDoorObstructed*` - Door is obstructed
+- `valueDoorStateClosed` - Door is closed
+- `valueDoorStateClosing` - Door is closing
+- `valueDoorStateOpen` - Door is open
+- `valueDoorStateOpening` - Door is opening
+- `valueDoorStateStopped` - Door is stopped
+- `valueLockStateJammed` - Door lock is jammed
+- `valueLockStateSecured` - Door is locked
+- `valueLockStateUnsecured` - Door is unlocked
+
 #### LockMechanism
 - `topicGetCurrentLockState*` - The current state of the lock, i.e. locked/unlocked
 - `topicGetTargetLockState*` - The target (i.e. desired) state of the lock
@@ -281,6 +465,12 @@ As with topics, you will also need to populate the appropriate values based on t
 - `valueFault` - Accessory has a fault
 - `valueTampered` - Accessory has been tampered with
 
+#### StatelessProgrammableSwitch
+- `topicEventButtonPress` - Event for button press event
+- `valueSinglePress` - Single press event
+- `valueDoublePress` - Double press event
+- `valueLongPress` - Long press event
+
 #### Valve
 - `valveType` -  One of `GENERIC_VALVE` (default), `IRRIGATION`, `SHOWER_HEAD`, or `WATER_FAUCET`
 - `topicGetValveActive*` - For getting whether or not the valve is active
@@ -313,10 +503,29 @@ You may also turn on additional logging if you'd like to see the MQTT messages p
 
 ## MQTT Options
 
-You are able to pass in any arbitrary MQTT options via `mqtt.options` in the config. This can include, for example, such as clientId, protocolVersion, etc. Just make sure the value provided is valid JSON. For example:
+You are able to pass in any arbitrary MQTT options via `mqtt.options` in the config. This can be a combination of [client options](https://github.com/mqttjs/MQTT.js?tab=readme-ov-file#mqttclientstreambuilder-options) and [publish options](https://github.com/mqttjs/MQTT.js?tab=readme-ov-file#mqttclientpublishtopic-message-options-callback). Just make sure the value provided is valid JSON. For example:
 
 ```
-"options": "{ \"protocolVersion\": \"4\", \"clientId\": \"my-client-id\", \"rejectUnauthorized\": true }"
+"options": "{ \"protocolVersion\": \"4\", \"clientId\": \"my-client-id\", \"retain\": true }"
+```
+
+## MQTT OnConnect
+
+Accessories can be configured to publish any number of arbitratry messages to the MQTT server on connect. This can be useful to invoke accessories to give updates on their current status.
+
+Each entry should have a topic and a message:
+
+```
+"onConnect": [
+  {
+    "topic": "some/arbitrary/topic",
+    "message": "connected",
+  },
+  {
+    "topic": "another/arbitrary/topic",
+    "message": "{ \"value\": \"can also be json\" }",
+  }
+]
 ```
 
 ## JSONPaths
@@ -415,6 +624,12 @@ Due to the complexity, this was intentionally left out of the plugin config UI,
 
 Since `customCharacteristics` is an array, you may define as many custom characteristics as you wish.
 
+## Persistance
+
+By default, all accessory values are saved and reloaded when the plugin restarts. However, you may override this behavior by selecting `Reset on Restart` option and accessories will be reset to defaults whenever the plugin or Homebridge restarts.
+
+- `"resetOnRestart": true`
+
 ## Credits
 
 [@arachnetech](https://github.com/arachnetech) for the fantastic [homebridge-mqttthing](https://github.com/arachnetech/homebridge-mqttthing) plugin which serves as the main inspiration for this project