@homebridge-plugins/homebridge-govee 11.27.0 → 11.27.1-beta.1

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.27.1 (Pending Release)
+
+### Changes
+
+- fix: only treat fresh real-time gateway records as leak events, not periodic sync records (#1314)
+- fix: restore the online status update helper for thermo and leak sensors (#1317)
+- fix: skip app device groups found in the http device list (#1317)
+
 ## v11.27.0 (2026-07-13)
 
 ### Changes

package/lib/platform.js

@@ -600,6 +600,12 @@ export default class {
             return
           }
 
+          // Skip Govee app device groups as these are not real devices (#1309)
+          if (['BaseGroup', 'SameModeGroup'].includes(httpDevice.sku)) {
+            this.log.debug('[%s] %s.', httpDevice.deviceName, platformLang.devIsGroup)
+            return
+          }
+
           // Check it's not a matter-ignored device, if the config has been set
           if (platformConsts.matterModels.includes(httpDevice.sku) && this.config.ignoreMatter) {
             return
@@ -1679,6 +1685,24 @@ export default class {
     devicesInHB.set(accessory.UUID, accessory)
   }
 
+  updateAccessoryStatus(accessory, newStatus) {
+    // Log the change, at a warning level if the device is reported offline
+    if (newStatus) {
+      accessory.log(platformLang.onlineHTTP)
+    } else {
+      accessory.logWarn(platformLang.offlineHTTP)
+    }
+
+    // Update the context item for the plugin UI
+    accessory.context.isOnline = newStatus ? 'yes' : 'no'
+
+    // Update any changes to the accessory to the platform
+    if (!accessory.context.isExternal) {
+      this.api.updatePlatformAccessories([accessory])
+    }
+    devicesInHB.set(accessory.UUID, accessory)
+  }
+
   removeAccessory(accessory) {
     // Remove an accessory from Homebridge
     try {
@@ -1843,11 +1867,25 @@ export default class {
         return
       }
 
-      // 0xEE34 is a gateway subdevice status, laid out as:
+      // 0xEE34 is a gateway subdevice record, laid out as:
       // ee 34 [subdevice number] 02 00 64 1e 14 [seq] [unix time x4] [leak flags x4] 80 00 [checksum]
       if (!hexString.startsWith('ee34') || hexString.length < 36) {
         return
       }
+
+      // The gateway also sends batches of other ee34 records, e.g. during its
+      // periodic sync, whose flag bytes are not live leak states (#1314), so
+      // only accept the real-time status type (0x02) with a current timestamp
+      if (hexString.substring(6, 8) !== '02') {
+        this.log.debug('[AWS] %s [%s].', platformLang.gwRecordType, hexString)
+        return
+      }
+      const recordTime = Number.parseInt(hexString.substring(18, 26), 16)
+      if (Math.abs(Math.round(Date.now() / 1000) - recordTime) > 600) {
+        this.log.debug('[AWS] %s [%s].', platformLang.gwRecordStale, hexString)
+        return
+      }
+
       const subdeviceNo = Number.parseInt(hexString.substring(4, 6), 16)
       const leakDetected = hexString.substring(26, 34) !== '00000000'
 

package/lib/utils/lang-en.js

@@ -83,6 +83,8 @@ export default {
   disableClient: 'disabling client as',
   disabledInConfig: 'disabled in config',
   disabling: 'Disabling plugin',
+  gwRecordStale: 'ignoring gateway record with a stale timestamp',
+  gwRecordType: 'ignoring gateway record that is not a real-time status',
   hbVersionFail: 'Your version of Homebridge is too low - please update to v1.6',
   heaterSimNoSensor: 'you must configure a device ID that provides a temperature reading',
   httpRetry: 'Unable to reach Govee, retrying in 30 seconds',
@@ -119,6 +121,8 @@ export default {
   twoFACodeInvalid: '2FA verification code was provided but login still failed - please check the code is correct and has not expired',
   noTokenExists: 'no account token has been retrieved',
   offlineBTConn: 'has been reported [disconnected] via BLE',
+  offlineHTTP: 'has been reported [offline]',
+  onlineHTTP: 'has been reported [online]',
   pluginNotConf: 'Plugin has not been configured',
   receivingUpdate: 'receiving update',
   sendingUpdate: 'sending update',

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-govee",
   "alias": "Govee",
   "type": "module",
-  "version": "11.27.0",
+  "version": "11.27.1-beta.1",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",