@homebridge-plugins/homebridge-govee 11.36.0 → 11.36.1-beta.1

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.36.1 (Pending Release)
+
+### 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)
+
 ## v11.36.0 (2026-08-11)
 
 ### Changed

package/lib/device/fan-H1370.js

@@ -1,3 +1,4 @@
+import { getDeviceCapabilities } from '../utils/device-capabilities.js'
 import {
   base64ToHex,
   fanSpeedToHkPercent,
@@ -15,12 +16,15 @@ 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 extends GoveeDevice {
+export default class GoveeFanH1370 extends GoveeDevice {
   constructor(platform, accessory) {
     super(platform, accessory)
     // Set up custom variables for this device type
@@ -46,8 +50,9 @@ export default class 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

package/lib/device/fan-H7100.js

@@ -16,8 +16,9 @@ import GoveeDevice from './base.js'
   H7100, H7102, H7106 -> Sleep, Nature, Custom, Auto
   H7101               -> Sleep, Nature, Turbo, Custom, Auto
   H7111               -> Sleep, Nature, Custom, Auto
-  H1310, R1310        -> as the H7100, but its oscillation status message has
-                         never been confirmed, so it is not read back
+
+  The H1310 and R1310 were once on this handler as "the same fan". They are
+  not - they are ceiling fans with lights, and moved to fan-H1370 in #1352.
  */
 
 export default class GoveeFanH7100 extends GoveeDevice {

package/lib/device/index.js

@@ -60,9 +60,15 @@ export default {
   deviceDehumidifierBasic,
   deviceDiffuserBasic,
   deviceFanBasic,
-  deviceFanH1310: deviceFanH7100, // same fan, minus a confirmed swing status message
+  // Ceiling fans, not tower fans. They were on the H7100 tower fan handler,
+  // which is a different product entirely: Govee's own app files them under
+  // Indoor Lighting as "Govee Ceiling Fan", while every H71xx is Air Treatment.
+  // The H7100 handler builds no light at all and speaks the tower fan's speed
+  // codes, so an owner got a fan tile that did nothing, an oscillation control
+  // for a fan that cannot oscillate, and no light (#1352)
+  deviceFanH1310: deviceFanH1370,
   deviceFanH1370,
-  deviceFanR1310: deviceFanH7100, // R1310 is the newer naming of the H1310
+  deviceFanR1310: deviceFanH1370, // R1310 is the newer naming of the H1310
   deviceFanH7100,
   deviceFanH7102: deviceFanH7100, // identical to the H7100
   deviceFanH7106: deviceFanH7100, // identical to the H7100

package/lib/utils/device-capabilities.js

@@ -34,19 +34,19 @@ const modelOverrides = {
   // and only the brightness scale is fixed here (#1332)
   H6102: { bleBrightnessScale: 0x64 },
 
-  // The H1310 ceiling fan shares the H7100's handler, but its oscillation
-  // status message has never been confirmed to mean the same thing, so reading
-  // it back stays off. While it is off, an owner's fan reporting one produces a
-  // line in the log saying so - which is the evidence needed to turn this on
-  H1310: { readsSwingStatus: false },
-  R1310: { readsSwingStatus: false },
-
   // Later ice makers number their ice sizes the natural way round. The older
   // ones run the other way, small being the highest byte, so the two families
   // share a handler and differ only here
   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 },
@@ -137,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.0",
+  "version": "11.36.1-beta.1",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",