@homebridge-plugins/homebridge-govee 11.32.0 → 11.32.2-beta.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.32.2 (Pending Release)
+
+### Changed
+
+- fix: implement the H7107's oscillation toggle, which threw a not-implemented error when tapped (#1334)
+
+## v11.32.1 (2026-08-02)
+
+### Changed
+
+- docs: add node 26 to the supported node versions
+- fix: read the H5106 monitor's temperature and humidity from the http device list too, so accounts whose aws channel never delivers still get readings (#1322)
+
 ## v11.32.0 (2026-08-02)
 
 ### Changed

package/README.md

@@ -27,7 +27,7 @@ Homebridge plugin to integrate Govee devices into HomeKit
 ### Prerequisites
 
 - 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.
+  - [Node](https://nodejs.org): latest version of `v22`, `v24` or `v26` - any other major version is not supported.
   - [Homebridge](https://homebridge.io): `v1.6` or above - refer to link for more information and installation instructions.
   - For bluetooth connectivity, it may be necessary to install extra packages on your system, see [Bluetooth Control](https://github.com/homebridge-plugins/homebridge-govee/wiki/Bluetooth-Control). Bluetooth works best when using a Raspberry Pi, not been tested on Windows, and Mac devices are unsupported.
 

package/lib/device/fan-H7107.js

@@ -204,33 +204,33 @@ export default class {
 
   async internalSwingUpdate(value) {
     try {
+      const newValue = value ? 'on' : 'off'
       // Don't continue if the new value is the same as before
-      if (this.cacheSwing === value) {
+      if (this.cacheSwing === newValue) {
         return
       }
 
-      throw new Error('Swing mode update not implemented yet')
-
-      // const newValue = value ? 'on' : 'off'
-      // The existing cacheSwingCode might be something like aa1d0101960384000000000000000000000000a6
-      // We need to change the third hex value to 00 for off or 01 for on
-      // const hexValues = [
-      //   0x3A,
-      //   0x1D,
-      //   value ? 0x01 : 0x00,
-      //   ...this.cacheSwingCode.slice(6, 14).match(/.{1,2}/g).map(byte => Number.parseInt(byte, 16)),
-      // ]
-      //
-      // await this.platform.sendDeviceUpdate(this.accessory, {
-      //   cmd: 'multiSync',
-      //   value: generateCodeFromHexValues(hexValues),
-      // })
+      // The AWS code mirrors the device's own `aa1d..` oscillation report,
+      // carrying over the extra bytes from the last report seen (#1334).
+      // Mirroring a status code is not guaranteed on every model, so the
+      // documented OpenAPI oscillation toggle is also sent when the device
+      // advertises it
+      const tailBytes = this.cacheSwingCode
+        ? this.cacheSwingCode.slice(6, 14).match(/.{1,2}/g).map(byte => Number.parseInt(byte, 16))
+        : []
+      await this.platform.sendDeviceUpdate(this.accessory, {
+        cmd: 'ptReal',
+        value: generateCodeFromHexValues([0x33, 0x1D, value ? 0x01 : 0x00, ...tailBytes]),
+        openApi: this.accessory.context.openApiCapabilities?.oscillationToggle
+          ? { instance: 'oscillationToggle', capabilityType: 'devices.capabilities.toggle', value: value ? 1 : 0 }
+          : undefined,
+      })
 
       // Cache the new state and log if appropriate
-      // if (this.cacheSwing !== newValue) {
-      //   this.cacheSwing = newValue
-      //   this.accessory.log(`${platformLang.curSwing} [${newValue}]`)
-      // }
+      if (this.cacheSwing !== newValue) {
+        this.cacheSwing = newValue
+        this.accessory.log(`${platformLang.curSwing} [${newValue}]`)
+      }
     } catch (err) {
       // Catch any errors during the process
       this.accessory.logWarn(`${platformLang.devNotUpdated} ${parseError(err)}`)

package/lib/device/sensor-monitor.js

@@ -3,6 +3,7 @@ import {
   base64ToHex,
   cenToFar,
   getTwoItemPosition,
+  hasProperty,
   hexToDecimal,
   hexToTwoItems,
   parseError,
@@ -61,6 +62,39 @@ export default class {
   }
 
   async externalUpdate(params) {
+    // Readings can also arrive from the HTTP device list (#1322), for accounts
+    // where the AWS channel never delivers for this model. The fields use the
+    // same semantics as the thermo-hygrometer sensors: hundredths of a degree
+    // and hundredths of a percent
+    if (hasProperty(params, 'temperature')) {
+      let newTemp = Number.parseInt(params.temperature + this.accessory.context.offTemp, 10)
+      newTemp /= 100
+      if (Number.isFinite(newTemp) && newTemp !== this.cacheTemp) {
+        this.cacheTemp = newTemp
+        this.tempService.updateCharacteristic(this.hapChar.CurrentTemperature, this.cacheTemp)
+        this.accessory.eveService.addEntry({ temp: this.cacheTemp })
+
+        // Log the change
+        this.accessory.log(`${platformLang.curTemp} [${this.cacheTemp}°C / ${cenToFar(this.cacheTemp)}°F]`)
+
+        // Update the cache file with the new temperature
+        this.updateCache()
+      }
+    }
+    if (hasProperty(params, 'humidity')) {
+      let newHumi = Number.parseInt(params.humidity + this.accessory.context.offHumi, 10)
+      newHumi /= 100
+      newHumi = Math.max(Math.min(newHumi, 100), 0)
+      if (Number.isFinite(newHumi) && newHumi !== this.cacheHumi) {
+        this.cacheHumi = newHumi
+        this.humiService.updateCharacteristic(this.hapChar.CurrentRelativeHumidity, this.cacheHumi)
+        this.accessory.eveService.addEntry({ humidity: this.cacheHumi })
+
+        // Log the change
+        this.accessory.log(`${platformLang.curHumi} [${this.cacheHumi}%]`)
+      }
+    }
+
     // Check for some other scene/mode change
     (params.commands || []).forEach((command) => {
       const hexString = base64ToHex(command)

package/lib/homebridge-ui/public/index.html

@@ -246,7 +246,7 @@
 <ul>
   <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li><a href="https://nodejs.org" target="_blank">Node</a>: latest version of <code>v22</code> or <code>v24</code> - any other major version is not supported.</li>
+    <li><a href="https://nodejs.org" target="_blank">Node</a>: latest version of <code>v22</code>, <code>v24</code> or <code>v26</code> - any other major version is not supported.</li>
     <li><a href="https://homebridge.io" target="_blank">Homebridge</a>: <code>v1.6</code> or above - refer to link for more information and installation instructions.</li>
     <li>For bluetooth connectivity, it may be necessary to install extra packages on your system, see <a href="https://github.com/homebridge-plugins/homebridge-govee/wiki/Bluetooth-Control" target="_blank">Bluetooth Control</a>. Bluetooth works best when using a Raspberry Pi, not been tested on Windows, and Mac devices are unsupported.</li>
   </ul>

package/lib/platform.js

@@ -1576,7 +1576,7 @@ export default class {
 
       // Filter those which are leak sensors
       for (const device1 of devices
-        .filter(device => [...platformConsts.models.sensorLeak, ...platformConsts.models.sensorThermo].includes(device.sku))) {
+        .filter(device => [...platformConsts.models.sensorLeak, ...platformConsts.models.sensorThermo, ...platformConsts.models.sensorMonitor].includes(device.sku))) {
         try {
           // Reformat the device id
           if (!device1.device.includes(':')) {
@@ -1650,6 +1650,27 @@ export default class {
             // distinguishes those accounts before converting anything.
             accessory.logDebug(`[HTTP] raw sensor data: ${JSON.stringify(parsedData)}`)
 
+            if (hasProperty(parsedSettings, 'battery')) {
+              toReturn.battery = parsedSettings.battery
+            }
+            if (hasProperty(parsedData, 'tem')) {
+              toReturn.temperature = parsedData.tem
+            }
+            if (hasProperty(parsedData, 'hum')) {
+              toReturn.humidity = parsedData.hum
+            }
+            if (hasProperty(parsedData, 'online')) {
+              toReturn.online = parsedData.online
+            }
+          } else if (platformConsts.models.sensorMonitor.includes(device1.sku)) {
+            // The H5106 normally reports over AWS, but some accounts never
+            // receive those messages, leaving the readings at zero (#1322).
+            // The HTTP device list carries the same readings, so use it as a
+            // second source. Every field is guarded and the raw payload is
+            // logged, since the format for this model is not confirmed on
+            // every account
+            accessory.logDebug(`[HTTP] raw sensor data: ${JSON.stringify(parsedData)}`)
+
             if (hasProperty(parsedSettings, 'battery')) {
               toReturn.battery = parsedSettings.battery
             }

package/package.json

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