@homebridge-plugins/homebridge-govee 11.32.1 → 11.32.2-beta.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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)
+- fix: also send the H7107's oscillation command as the multiSync frame the fan itself uses, since the first shape only turned it off sometimes (#1334)
+
 ## v11.32.1 (2026-08-02)
 
 ### Changed

package/lib/device/fan-H7107.js

@@ -204,33 +204,43 @@ 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,
+      })
+
+      // Hardware testing showed the `331d..` frame above turns oscillation ON
+      // reliably but OFF only sometimes - and the fan's own oscillation state
+      // travels as multiSync traffic, which is what the `3a`-prefixed frame
+      // belongs to. Both shapes mean the same thing, so the one the fan
+      // ignores is harmless, and one test tells us which it honours (#1334)
+      await this.platform.sendDeviceUpdate(this.accessory, {
+        cmd: 'multiSync',
+        value: generateCodeFromHexValues([0x3A, 0x1D, value ? 0x01 : 0x00, ...tailBytes]),
+      })
 
       // 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/package.json

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