@homebridge-plugins/homebridge-ewelink 12.14.1 → 12.15.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 All notable changes to `@homebridge-plugins/homebridge-ewelink` will be documented in this file.
 
+## v12.15.0 (2026-07-12)
+
+### Changed
+
+- feat: add a per-device `invertGarageState` option to swap the reported open/closed state on garage doors without a contact sensor (#787)
+- feat: add support for UIID 20006 dimmable LED controller (#780), the SONOFF AirGuard TH sensor (7038) (#767) and the SONOFF MINI DUO 2-gang switch (7040) (#768)
+- chore: update `actions/checkout` workflow action to v7
+- chore: remove stray `exit 1` from the deprecation workflow script
+- chore: dependency updates
+- docs: note homebridge v2 support in the prerequisites
+
 ## v12.14.1 (2026-06-03)
 
 ### Changed

package/README.md

@@ -30,7 +30,7 @@ Homebridge plugin to integrate eWeLink devices into HomeKit
 
 - To use this plugin, you will need to already have:
   - [Node](https://nodejs.org): latest version of `v22` or `v24` - any other major version is not supported.
-  - [Homebridge](https://homebridge.io): `v1.6` - refer to link for more information and installation instructions.
+  - [Homebridge](https://homebridge.io): `v1.6` or above - refer to link for more information and installation instructions.
 
 ### Setup
 

package/config.schema.json

@@ -423,6 +423,14 @@
                 "functionBody": "return (model.singleDevices && model.singleDevices[arrayIndices] && ['garage'].includes(model.singleDevices[arrayIndices].showAs) && !model.singleDevices[arrayIndices].ignoreDevice);"
               }
             },
+            "invertGarageState": {
+              "type": "boolean",
+              "title": "Invert Garage State",
+              "description": "Swap the reported open and closed states for this garage door. Useful if HomeKit shows the door as open when it is physically closed (and vice versa). This applies to garage doors without a defined contact sensor.",
+              "condition": {
+                "functionBody": "return (model.singleDevices && model.singleDevices[arrayIndices] && ['garage'].includes(model.singleDevices[arrayIndices].showAs) && !model.singleDevices[arrayIndices].sensorId && !model.singleDevices[arrayIndices].ignoreDevice);"
+              }
+            },
             "sensorId": {
               "type": "string",
               "title": "Sensor",

package/eslint.config.js

@@ -35,7 +35,6 @@ export default antfu(
       'style/brace-style': ['error', '1tbs', { allowSingleLine: true }],
       'style/quote-props': ['error', 'consistent-as-needed'],
       'test/no-only-tests': 'error',
-      'unicorn/no-useless-spread': 'error',
       'unused-imports/no-unused-vars': ['error', { caughtErrors: 'none' }],
     },
     typescript: false,

package/lib/device/simulation/garage-one.js

@@ -25,6 +25,11 @@ export default class {
     this.operationTimeUp = deviceConf.operationTime || platformConsts.defaultValues.operationTime
     this.operationTimeDown = deviceConf.operationTimeDown || this.operationTimeUp
 
+    // Some users' garage door reports the opposite state to reality (e.g. a
+    // MINI-D wired to the NO contact). This option swaps the reported open and
+    // closed states for this device.
+    this.invertGarage = deviceConf.invertGarageState === true
+
     // Set the correct logging variables for this accessory
     switch (deviceConf.overrideLogging) {
       case 'standard':
@@ -64,8 +69,8 @@ export default class {
     this.service = this.accessory.getService(this.hapServ.GarageDoorOpener)
     if (!this.service) {
       this.service = this.accessory.addService(this.hapServ.GarageDoorOpener)
-      this.service.updateCharacteristic(this.hapChar.CurrentDoorState, 1)
-      this.service.updateCharacteristic(this.hapChar.TargetDoorState, 1)
+      this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(1))
+      this.service.updateCharacteristic(this.hapChar.TargetDoorState, this.invPos(1))
       this.service.updateCharacteristic(this.hapChar.ObstructionDetected, false)
       this.service.addCharacteristic(this.eveChar.LastActivation)
       this.service.addCharacteristic(this.eveChar.ResetTotal)
@@ -134,8 +139,9 @@ export default class {
 
     // Add the set handler to the target position characteristic
     this.service.getCharacteristic(this.hapChar.TargetDoorState).onSet((value) => {
-      // We don't use await as we want the callback to be run straight away
-      this.internalUpdate(value)
+      // We don't use await as we want the callback to be run straight away.
+      // Map the HomeKit target to the internal logical position first.
+      this.internalUpdate(this.invPos(value))
     })
 
     // Add the get handlers only if the user hasn't disabled the disableNoResponse setting
@@ -184,27 +190,49 @@ export default class {
     this.log('[%s] %s %s.', this.name, this.lang.devInitOpts, opts)
   }
 
+  // Swap Open<->Closed and Opening<->Closing when this device is inverted.
+  // This is an involution, so the same function maps a HomeKit-facing value to
+  // the internal logical value and back. A no-op when inversion is disabled, or
+  // when a contact sensor is defined (the sensor already reports the real state).
+  invPos(pos) {
+    if (!this.invertGarage || this.definedSensor) {
+      return pos
+    }
+    switch (pos) {
+      case 0:
+        return 1
+      case 1:
+        return 0
+      case 2:
+        return 3
+      case 3:
+        return 2
+      default:
+        return pos
+    }
+  }
+
   async internalUpdate(value) {
     try {
       const newPos = value
       const params = {}
       let delay = 0
-      const prevState = this.service.getCharacteristic(this.hapChar.CurrentDoorState).value
+      const prevState = this.invPos(this.service.getCharacteristic(this.hapChar.CurrentDoorState).value)
       if (newPos === prevState % 2) {
         return
       }
       this.inUse = true
       this.cacheState = value
       if (this.setup === 'switchSingle' && [2, 3].includes(prevState)) {
-        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, ((prevState * 2) % 3) + 2)
+        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(((prevState * 2) % 3) + 2))
         delay = 1500
       }
       if (this.cacheState !== newPos) {
         return
       }
       await sleep(delay)
-      this.service.updateCharacteristic(this.hapChar.TargetDoorState, newPos)
-      this.service.updateCharacteristic(this.hapChar.CurrentDoorState, newPos + 2)
+      this.service.updateCharacteristic(this.hapChar.TargetDoorState, this.invPos(newPos))
+      this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(newPos + 2))
       // SCM (single-channel multi-format) devices use the switches[] array
       // but only expose outlet 0. True dual-channel garage controllers
       // (e.g. DUALR3) use separate outlets for open/close relay action.
@@ -254,7 +282,7 @@ export default class {
       const operationTime = newPos === 0 ? this.operationTimeUp : this.operationTimeDown
       await sleep(Math.max((operationTime - 20) * 100, 0))
       if (!this.definedSensor) {
-        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, newPos)
+        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(newPos))
         if (newPos === 1) {
           this.accessory.eveService.addEntry({ status: 1 })
         }
@@ -263,7 +291,7 @@ export default class {
             '[%s] %s [%s].',
             this.name,
             this.lang.curState,
-            newPos === 0 ? this.lang.doorOpen : this.lang.doorClosed,
+            this.invPos(newPos) === 0 ? this.lang.doorOpen : this.lang.doorClosed,
           )
         }
       }
@@ -344,7 +372,7 @@ export default class {
       }
 
       if (!this.inUse && !this.definedSensor) {
-        const prevState = this.service.getCharacteristic(this.hapChar.CurrentDoorState).value
+        const prevState = this.invPos(this.service.getCharacteristic(this.hapChar.CurrentDoorState).value)
         const newPos = [0, 2].includes(prevState) ? 3 : 2
         if (this.setup === 'switchMulti' && params.switches?.length >= 2) {
           if (
@@ -361,8 +389,8 @@ export default class {
           return
         }
         this.inUse = true
-        this.service.updateCharacteristic(this.hapChar.TargetDoorState, newPos - 2)
-        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, newPos)
+        this.service.updateCharacteristic(this.hapChar.TargetDoorState, this.invPos(newPos - 2))
+        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(newPos))
         await sleep(2000)
         this.inUse = false
         if (newPos === 2) {
@@ -379,7 +407,7 @@ export default class {
         }
         const operationTime = newPos === 2 ? this.operationTimeUp : this.operationTimeDown
         await sleep(Math.max((operationTime - 20) * 100, 0))
-        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, newPos - 2)
+        this.service.updateCharacteristic(this.hapChar.CurrentDoorState, this.invPos(newPos - 2))
         if (newPos === 3) {
           this.accessory.eveService.addEntry({ status: 1 })
         }

package/lib/platform.js

@@ -306,6 +306,7 @@ export default class {
                   case 'hideSensor':
                   case 'hideSwitch':
                   case 'humidityOffsetFactor':
+                  case 'invertGarageState':
                   case 'isInched':
                   case 'offlineAsOff':
                   case 'offsetFactor':

package/lib/utils/constants.js

@@ -95,6 +95,7 @@ export default {
       'hideSensor',
       'obstructId',
       'sensorType',
+      'invertGarageState',
       'ipAddress',
     ],
     multiDevices: [
@@ -114,6 +115,7 @@ export default {
       'sensorId',
       'hideSensor',
       'obstructId',
+      'invertGarageState',
       'ipAddress',
     ],
     lightDevices: [
@@ -324,12 +326,13 @@ export default {
       4256,
       7029,
       7030,
+      7040,
       20004,
     ],
     switchMultiPower: [126, 165, 262],
     switchMate: [177],
     switchMan: [174],
-    lightDimmer: [36, 44, 57, 277],
+    lightDimmer: [36, 44, 57, 277, 20006],
     lightRGB: [22],
     lightCCT: [52, 103],
     lightRGBCCT: [33, 59, 104, 135, 136, 137, 173],
@@ -353,7 +356,7 @@ export default {
     zbLightCCT: [1258],
     zbLightRGBCCT: [3258, 7009],
     zbMotor: [1514, 7006, 7034],
-    zbSensorAmbient: [1770, 1771, 7014, 7033],
+    zbSensorAmbient: [1770, 1771, 7014, 7033, 7038],
     zbSensorMotion: [2026, 7002],
     zbSensorOccupancy: [7016],
     zbSensorContact: [3026, 7003],
@@ -575,8 +578,11 @@ export default {
     7030: 3, // ZBM5-3C-80/86 Zigbee 3-gang switch
     7032: 1, // Zigbee Power Monitoring Switch
     7033: 1, // SNZB-02WD Zigbee Temperature and Humidity Display Sensor
+    7038: 1, // SONOFF AirGuard TH Zigbee temperature and humidity sensor (#767)
+    7040: 2, // SONOFF MINI DUO 2-gang Zigbee switch (#768)
     20001: 1, // iHost sub-device single switch
     20004: 4, // iHost sub-device 4-channel switch
+    20006: 1, // single-colour dimmable LED controller (#780)
   },
 
   cannotSupportDevices: {

package/package.json

@@ -3,7 +3,7 @@
   "displayName": "Homebridge eWeLink",
   "alias": "eWeLink",
   "type": "module",
-  "version": "12.14.1",
+  "version": "12.15.0",
   "description": "Homebridge plugin to integrate eWeLink devices into HomeKit.",
   "author": {
     "name": "bwp91",
@@ -61,14 +61,14 @@
     "lint:fix": "npm run lint -- --fix"
   },
   "dependencies": {
-    "@homebridge/plugin-ui-utils": "^2.2.4",
-    "axios": "^1.17.0",
+    "@homebridge/plugin-ui-utils": "^2.2.5",
+    "axios": "^1.18.1",
     "node-persist": "^4.0.4",
-    "p-queue": "^9.3.0",
+    "p-queue": "^9.3.1",
     "websocket-as-promised": "^3.0.1",
     "ws": "^8.21.0"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^9.0.0"
+    "@antfu/eslint-config": "^9.1.0"
   }
 }