@homebridge-plugins/homebridge-govee 11.36.1-beta.13 → 11.36.1-beta.14

package/CHANGELOG.md

@@ -22,6 +22,7 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 - fix: stop calling a ceiling fan's speed report unrecognised while the fan is off (#1352)
 - fix: read a ceiling fan's airflow direction from what the fan reports, so the tile follows the govee app (#1352)
 - fix: show each of a ceiling fan's two lights as on or off from what the fan reports (#1352)
+- fix: lead a ceiling fan's tile with the fan rather than one of its lights (#1352)
 
 ## v11.36.0 (2026-08-11)
 

package/lib/device/fan-H1370.js

@@ -17,7 +17,7 @@ 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 [running] [speed] = fan speed (1 to the model's step count)
+  Status aa 31 [?] [speed] [direction] = fan speed and airflow direction
   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)
@@ -45,6 +45,12 @@ export default class GoveeFanH1370 extends GoveeDevice {
     // Add the fan service if it doesn't already exist
     this.service = this.accessory.getService(this.hapServ.Fanv2) || this.accessory.addService(this.hapServ.Fanv2)
 
+    // This accessory is a fan that happens to have lights on it, so the fan is
+    // what its tile should lead with. Without saying so the Home app picks for
+    // itself and lands on a light, leaving an owner tapping through to reach
+    // the fan they came for (#1352)
+    this.service.setPrimaryService(true)
+
     // Add the set handler to the fan on/off characteristic
     this.service
       .getCharacteristic(this.hapChar.Active)
@@ -319,11 +325,12 @@ export default class GoveeFanH1370 extends GoveeDevice {
       const deviceFunction = `${getTwoItemPosition(hexParts, 2)}${getTwoItemPosition(hexParts, 3)}`
 
       switch (deviceFunction) {
-        // aa 31 <running> <speed>. The third byte is the fan's running flag,
-        // not part of the code - a stopped fan reports 3100 and still names the
-        // speed it will return to. Reading only 3101 meant that every status
-        // sent while the fan was off was announced as unrecognised, which is
-        // the noise that sent this model's owner to the issue tracker (#1352)
+        // aa 31 <?> <speed> <direction>. The third byte is not part of the
+        // code: an H1310 has been seen reporting both 00 and 01 for it with the
+        // fan running either way, so what it means is still unknown - but
+        // matching only 3101 announced every other status as unrecognised,
+        // which is the noise that sent this model's owner here (#1352).
+        // `aa 36` is the reliable word on whether the fan is running.
         case '3100':
         case '3101': {
           // Fan speed

package/package.json

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