@homebridge-plugins/homebridge-govee 11.36.1-beta.0 → 11.36.1-beta.2

package/CHANGELOG.md

@@ -7,6 +7,8 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 ### Changed
 
 - fix: give the H1310 and R1310 ceiling fans their own handler, with the light they were missing (#1352)
+- fix: scale the H1310 and R1310 fan speed to the six steps they have, not the H1370's twelve (#1352)
+- fix: stop a fan ignoring the first speed asked of it after a restart
 
 ## v11.36.0 (2026-08-11)
 

package/lib/device/fan-H1370.js

@@ -1,3 +1,4 @@
+import { getDeviceCapabilities } from '../utils/device-capabilities.js'
 import {
   base64ToHex,
   fanSpeedToHkPercent,
@@ -15,10 +16,13 @@ import GoveeDevice from './base.js'
 /*
   Codes below were decoded from a real device's AWS status reports in
   https://github.com/homebridge-plugins/homebridge-govee/issues/1307
-  Status aa 31 01 [speed] = fan speed (1-12)
+  Status aa 31 01 [speed] = fan speed (1 to the model's step count)
   Status aa 36 01 01 / aa 36 00 00 = fan power on/off
   The light reports through the standard state/brightness/kelvin fields
   (colour temperature only, 2700-6500K)
+
+  The H1310 and R1310 share this handler. They report six speeds against the
+  H1370's twelve, so the scale comes from the capabilities table (#1352)
 */
 export default class GoveeFanH1370 extends GoveeDevice {
   constructor(platform, accessory) {
@@ -46,8 +50,9 @@ export default class GoveeFanH1370 extends GoveeDevice {
       .onSet(async value => this.internalStateUpdate(value))
     this.cacheState = this.service.getCharacteristic(this.hapChar.Active).value ? 'on' : 'off'
 
-    // Real speed steps - HomeKit percentages map onto these
-    this.speedSteps = 12
+    // Real speed steps - HomeKit percentages map onto these, and they differ
+    // per model, so the scale comes from the capabilities table
+    this.speedSteps = getDeviceCapabilities(accessory.context.gvModel).fanSpeedSteps
 
     // Add the set handler to the fan rotation speed characteristic
     this.service
@@ -59,7 +64,13 @@ export default class GoveeFanH1370 extends GoveeDevice {
         unit: 'unitless',
       })
       .onSet(async value => this.internalSpeedUpdate(value))
-    this.cacheSpeed = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+
+    // cacheSpeed holds a device speed step everywhere else, but the restored
+    // characteristic is a HomeKit percentage, so it has to be converted back.
+    // Left as a percentage it would sometimes equal a real step and silently
+    // swallow the first speed the owner asked for.
+    const restoredPercent = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+    this.cacheSpeed = restoredPercent ? hkPercentToFanSpeed(restoredPercent, this.speedSteps) : 0
 
     if (this.hideLight) {
       if (this.accessory.getService(this.hapServ.Lightbulb)) {

package/lib/device/fan-H7100.js

@@ -78,7 +78,15 @@ export default class GoveeFanH7100 extends GoveeDevice {
         unit: 'unitless',
       })
       .onSet(async value => this.internalSpeedUpdate(value))
-    this.cacheSpeed = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+
+    // cacheSpeed holds a device speed step everywhere else, but the restored
+    // characteristic is a HomeKit percentage, so it has to be converted back.
+    // Left as a percentage it would sometimes equal a real step and silently
+    // swallow the first speed the owner asked for. A restored 100% stays
+    // ambiguous between auto and top speed - both report 100 - so it settles on
+    // top speed rather than guessing.
+    const restoredPercent = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+    this.cacheSpeed = restoredPercent ? hkPercentToFanSpeed(restoredPercent, this.speedSteps) : 0
 
     // Add the set handler to the fan swing mode
     this.service

package/lib/device/fan-H7105.js

@@ -75,7 +75,15 @@ export default class extends GoveeDevice {
         unit: 'unitless', // This is actually from HAP for Bluetooth LE Specification, but fits
       })
       .onSet(async value => this.internalSpeedUpdate(value))
-    this.cacheSpeed = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+
+    // cacheSpeed holds a device speed step everywhere else, but the restored
+    // characteristic is a HomeKit percentage, so it has to be converted back.
+    // Left as a percentage it would sometimes equal a real step and silently
+    // swallow the first speed the owner asked for. A restored 100% stays
+    // ambiguous between auto and top speed - both report 100 - so it settles on
+    // top speed rather than guessing.
+    const restoredPercent = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+    this.cacheSpeed = restoredPercent ? hkPercentToFanSpeed(restoredPercent, this.speedSteps) : 0
 
     // Add the set handler to the fan swing mode
     this.service

package/lib/device/fan-H7107.js

@@ -75,7 +75,15 @@ export default class extends GoveeDevice {
         unit: 'unitless', // This is actually from HAP for Bluetooth LE Specification, but fits
       })
       .onSet(async value => this.internalSpeedUpdate(value))
-    this.cacheSpeed = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+
+    // cacheSpeed holds a device speed step everywhere else, but the restored
+    // characteristic is a HomeKit percentage, so it has to be converted back.
+    // Left as a percentage it would sometimes equal a real step and silently
+    // swallow the first speed the owner asked for. A restored 100% stays
+    // ambiguous between auto and top speed - both report 100 - so it settles on
+    // top speed rather than guessing.
+    const restoredPercent = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
+    this.cacheSpeed = restoredPercent ? hkPercentToFanSpeed(restoredPercent, this.speedSteps) : 0
 
     // Add the set handler to the fan swing mode
     this.service

package/lib/utils/device-capabilities.js

@@ -40,6 +40,13 @@ const modelOverrides = {
   H8121: { iceSizeAscending: true },
   H8122: { iceSizeAscending: true },
 
+  // The H1310 shares the H1370's ceiling fan handler but is a different
+  // product - Govee's own catalogue gives it goodsType 359 against the
+  // H1370's 368. Its owner reports six fan speeds in the app rather than
+  // twelve, so the two need separate scales (#1352)
+  H1310: { fanSpeedSteps: 6 },
+  R1310: { fanSpeedSteps: 6 },
+
   // AWS outlet uses 17/16 for on/off instead of 1/0
   H5080: { awsPowerOn: 17, awsPowerOff: 16 },
   H5083: { awsPowerOn: 17, awsPowerOff: 16 },
@@ -130,6 +137,9 @@ const defaults = {
   awsBrightnessNoScale: false,
   readsSwingStatus: true,
   iceSizeAscending: false,
+  // Ceiling fan speed steps. 12 is what the H1370 reports, from a real
+  // device's status in #1307
+  fanSpeedSteps: 12,
   // false for the great majority of models, which take the plain 20-byte frame.
   // 'v2' selects the AES-128-GCM transport in ble-crypto.js.
   bleEncryption: false,

package/package.json

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