@homebridge-plugins/homebridge-govee 11.39.2-beta.8 → 11.40.0

package/CHANGELOG.md

@@ -2,7 +2,7 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
-## v11.39.2 (Pending Release)
+## v11.40.0 (2026-11-14)
 
 ### Changed
 
@@ -20,7 +20,6 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 - fix(leak): stop the h5059 and h5830 showing an old leak, the app reads their probes (#1381)
 - fix(openapi): clear a leak when the sensor reports it is dry (#1381)
 - fix(aws): start aws without waiting for the openapi live connection, it can retry for ever (#1383)
-- chore(deps): dependency updates
 - fix(lights): keep adaptive lighting on after a restart when it ran while the light was off
 - fix(http): log in even when the tap-to-run server is down
 - fix(aws): give each start its own aws connection id, so two instances on one account both work
@@ -29,6 +28,34 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 - feat(purifiers): show the filter life left, when govee's api reports it
 - fix(lights): keep the h6022 and h60a1 to the colour temperatures they can show
 - feat(humidifiers): show when the water tank has run dry, when govee's api reports it (#1294)
+- fix(h1310): stop the fan light throwing on every switch when there is no api key (#1384)
+- fix(h713b): put the heater back on the handler its controls worked on (#1386)
+- fix(aws): apply a light's aws brightness scale to 254 setting, which was ignored
+- fix(ble): on a mac, point a bluetooth permission error at the privacy setting, not setcap
+- fix(sockets): show a socket as a heater again, it failed with "not a constructor" (#1388)
+- fix(valves): turn a valve off after its duration when it was on before a restart (#1387)
+- fix(ble): connect to bluetooth-only lights on linux (@ldtnz)
+- fix(http): fetch tap-to-runs with the account token (@StefanRiese)
+- fix(ttr): keep the account topic out of the tap-to-run debug line (@StefanRiese)
+- fix(ttr): read scene codes from govee's preset tap-to-runs (@StefanRiese)
+- fix: read the h7142's humidity, which showed 0% (#1294)
+- fix(openapi): keep a toggle's state when govee reports it as empty (#1395)
+- feat: show the h7107's room temperature (#1394)
+- fix: lead the h7107's tile with the fan
+- fix(scenes): cap the scene selector at 97 scenes, so lights with more still show it (#1362)
+- fix(h7107): ask the fan for its status every minute, so its temperature stays current (#1394)
+- fix: treat the h600c and h6008 bulbs as matter models (#1399) (@R-STR)
+- fix(lights): switch a light off when home sets it to 0% (#1397)
+- feat(h60b2): control each head of the tree lamp as its own light (#1395) (@ethanjnrg)
+- fix(lights): name each zone light in the home app (@ethanjnrg)
+- fix(lights): follow a zone light's saturation, as the main light does (@ethanjnrg)
+- fix(lights): send a zone light's white again after a colour (@ethanjnrg)
+- fix(lights): ask for a zone light's state after a whole-light change (@ethanjnrg)
+- feat(h60b2): set a head's white as kelvin, on its white leds (@ethanjnrg)
+- fix(lights): show a zone light's colour in home when it changes elsewhere (@ethanjnrg)
+- feat(lights): switch a sync box's hdmi input from home, when govee's api lists it (#1289)
+- ci: publish releases with node.js v26, the current lts
+- chore(deps): dependency updates
 
 ## v11.39.1 (2026-10-18)
 

package/lib/connection/ble.js

@@ -420,7 +420,7 @@ export default class BLEConnection {
       return await Promise.race([
         process.platform === 'darwin'
           ? this.connectByNameDarwin(address, timeout)
-          : btClient.connectAsync(address),
+          : this.connectAfterScan(address, timeout),
         new Promise((_, reject) => {
           timeoutId = setTimeout(() => reject(new Error('Connection timeout')), timeout)
         }),
@@ -434,6 +434,65 @@ export default class BLEConnection {
   // never resolve. Govee devices advertise a local name whose suffix is the last
   // two bytes of their MAC (e.g. Govee_H617A_325A for ...:32:5A), so scan and
   // match on that instead, then connect to the discovered peripheral directly.
+  // Linux: noble only sends LE Create Connection for a peripheral it has seen
+  // in a scan since the last reset, so connecting by address alone never
+  // reaches the controller. Wait for the adapter after the reset in
+  // updateDevice(), scan until the device advertises, then connect to it.
+  async connectAfterScan(address, timeout) {
+    const wanted = address.toLowerCase()
+    await btClient.waitForPoweredOnAsync(5000).catch(() => {})
+    let peripheral
+    try {
+      peripheral = await this.scanFor(wanted, 2500)
+    } catch {
+      // Some adapters (seen on a Realtek RTL8821C) stop delivering advertising
+      // reports after an LE connection, even though scanning is reported as
+      // enabled. btClient.reset() is a no-op on the hci-socket bindings, so
+      // send a real HCI reset and scan once more.
+      this.log.debug('[BLE] %s not seen, resetting the adapter and scanning again.', address)
+      btClient._bindings?._hci?.reset?.()
+      await new Promise(r => setTimeout(r, 1000))
+      await btClient.waitForPoweredOnAsync(2000).catch(() => {})
+      peripheral = await this.scanFor(wanted, Math.max(timeout - 6000, 3000))
+    }
+    // With a weak signal the link can drop with 0x3e (connection failed to be
+    // established) a few hundred ms after LE Connection Complete. Give it a
+    // moment to settle and try again if it did not hold.
+    for (let attempt = 1; ; attempt += 1) {
+      await peripheral.connectAsync()
+      await new Promise(r => setTimeout(r, 500))
+      if (peripheral.state === 'connected' || attempt >= 3) {
+        return peripheral
+      }
+      this.log.debug('[BLE] %s dropped right after connecting, retrying (%s/3).', address, attempt + 1)
+    }
+  }
+
+  scanFor(wanted, scanTimeout) {
+    return new Promise((resolve, reject) => {
+      let done = false
+      let scanTimeoutId
+      function onDiscover(p) {
+        if (p.address?.toLowerCase() === wanted) {
+          finish(resolve, p)
+        }
+      }
+      function finish(fn, value) {
+        if (done) {
+          return
+        }
+        done = true
+        clearTimeout(scanTimeoutId)
+        btClient.removeListener('discover', onDiscover)
+        btClient.stopScanningAsync().catch(() => {})
+        fn(value)
+      }
+      btClient.on('discover', onDiscover)
+      btClient.startScanningAsync([], true).catch(err => finish(reject, err))
+      scanTimeoutId = setTimeout(() => finish(reject, new Error(`no advertisement from ${wanted} during scan`)), scanTimeout)
+    })
+  }
+
   async connectByNameDarwin(address, timeout) {
     const suffix = address.replace(/:/g, '').slice(-4).toLowerCase()
     this.darwinPeripheralCache = this.darwinPeripheralCache ?? new Map()

package/lib/connection/http.js

@@ -16,7 +16,6 @@ export default class {
     this.log = platform.log
     this.password = platform.config.password
     this.token = platform.accountToken
-    this.tokenTTR = platform.accountTokenTTR
     this.username = platform.config.username
     this.code = platform.config.code
 
@@ -110,18 +109,6 @@ export default class {
       // Make the token available in other functions
       this.token = res.data.client.token
 
-      // Also grab an access token specifically for the get-tap-to-run endpoint.
-      // It comes from a different server to the account login, and tap-to-runs
-      // are optional - the token is fetched again when one is next needed. So a
-      // failure here must not stop the login, or one server being down takes
-      // every cloud device with it
-      try {
-        await this.loginTTR()
-      } catch (err) {
-        this.tokenTTR = undefined
-        this.log.debug('[HTTP] %s %s.', platformLang.ttrLoginFail, parseError(err))
-      }
-
       // Mark this request complete if in debug mode
       this.log.debug('[HTTP] %s.', platformLang.loginSuccess)
 
@@ -148,7 +135,6 @@ export default class {
         iot: iotRes.data.data.p12,
         iotPass: iotRes.data.data.p12Pass,
         token: res.data.client.token,
-        tokenTTR: this.tokenTTR,
         topic: res.data.client.topic,
       }
     } catch (err) {
@@ -166,24 +152,6 @@ export default class {
     }
   }
 
-  async loginTTR() {
-    // The tap-to-run endpoint uses a separate, shorter-lived token obtained from
-    // a different login endpoint to the main Govee account token. This is split
-    // out so it can be refreshed on its own without a full account re-login.
-    const ttrRes = await axios({
-      url: 'https://community-api.govee.com/os/v1/login',
-      method: 'post',
-      data: {
-        email: this.username,
-        password: this.password,
-      },
-      timeout: 30000,
-    })
-
-    this.tokenTTR = ttrRes.data?.data?.token
-    return this.tokenTTR
-  }
-
   async logout() {
     try {
       await axios({
@@ -267,15 +235,12 @@ export default class {
     }
   }
 
-  async getTapToRuns(isRetry = false) {
-    // The TTR token is separate to the main account token and shorter-lived. If
-    // we don't have a usable one (eg. restored from an old cache where it was
-    // never saved, saved as the literal string 'undefined', or expired) then
-    // fetch a fresh one before continuing. This lets a user with a valid main
-    // token but a bad TTR token self-heal without a full account re-login.
-    if (!this.tokenTTR || this.tokenTTR === 'undefined') {
-      await this.loginTTR()
-      this.tokenTTRRefreshed = true
+  async getTapToRuns() {
+    // Make sure we do have the account token. This endpoint used to take a
+    // separate token from community-api.govee.com, but Govee now rejects that
+    // one ('authorization token is invalid') and accepts the account token.
+    if (!this.token) {
+      throw new Error(platformLang.noTokenExists)
     }
 
     // Build and send the request
@@ -283,7 +248,7 @@ export default class {
       url: 'https://app2.govee.com/bff-app/v1/exec-plat/home',
       method: 'get',
       headers: {
-        'Authorization': `Bearer ${this.tokenTTR}`,
+        'Authorization': `Bearer ${this.token}`,
         'appVersion': this.appVersion,
         'clientId': this.clientId,
         'clientType': 1,
@@ -296,14 +261,7 @@ export default class {
 
     // Check to see we got a response
     if (!res?.data?.data?.components) {
-      // The token may have expired since we obtained it - try one fresh TTR
-      // login and retry once before giving up
-      if (!isRetry) {
-        await this.loginTTR()
-        this.tokenTTRRefreshed = true
-        return this.getTapToRuns(true)
-      }
-      throw new Error('not a valid response')
+      throw new Error(`not a valid response (${res.data?.message || `HTTP ${res.status}`})`)
     }
 
     return res.data.data.components

package/lib/connection/openapi.js

@@ -107,6 +107,15 @@ function getCapabilitiesFromPayload(data) {
     || []
 }
 
+/**
+ * Govee sometimes answers with an empty value for a toggle it does not know the
+ * state of (#1395). Read as a number that is 0, so it would show the toggle as
+ * off - leave the last known state alone instead.
+ */
+function hasToggleValue(value) {
+  return value !== undefined && value !== null && value !== ''
+}
+
 function getCapabilityValue(capability) {
   if (capability?.state && Object.hasOwn(capability.state, 'value')) {
     return capability.state.value
@@ -176,12 +185,18 @@ export function normalizeMqttMessage(message) {
       case 'humidity':
         normalized.targetHumidity = Number(value)
         break
+      case 'hdmiSource':
+        // 1 to 4 on the sync boxes, and nothing usable before they report one
+        if (Number.isInteger(Number(value)) && Number(value) > 0) {
+          normalized.hdmiSource = Number(value)
+        }
+        break
       case 'targetTemperature':
       case 'sliderTemperature':
         normalized.targetTemperature = value
         break
       default:
-        if (capability?.instance?.endsWith('Toggle')) {
+        if (capability?.instance?.endsWith('Toggle') && hasToggleValue(value)) {
           normalized.toggles = normalized.toggles || {}
           normalized.toggles[capability.instance] = Number(value) === 1
         }
@@ -496,12 +511,18 @@ export default class {
         case 'humidity':
           normalized.targetHumidity = Number(value)
           break
+        case 'hdmiSource':
+          // 1 to 4 on the sync boxes, and nothing usable before they report one
+          if (Number.isInteger(Number(value)) && Number(value) > 0) {
+            normalized.hdmiSource = Number(value)
+          }
+          break
         case 'targetTemperature':
         case 'sliderTemperature':
           normalized.targetTemperature = value
           break
         default:
-          if (capability?.instance?.endsWith('Toggle')) {
+          if (capability?.instance?.endsWith('Toggle') && hasToggleValue(value)) {
             normalized.toggles = normalized.toggles || {}
             normalized.toggles[capability.instance] = Number(value) === 1
           }

package/lib/device/fan-H7107.js

@@ -59,6 +59,11 @@ export default class extends GoveeDevice {
     // Add the fan service for the fan if it doesn't already exist
     this.service = this.accessory.getService(this.hapServ.Fanv2) || this.accessory.addService(this.hapServ.Fanv2)
 
+    // The fan is what its tile should lead with. It also carries a night light
+    // and a temperature sensor, and without saying so the Home app picks for
+    // itself and can land on one of those instead
+    this.service.setPrimaryService(true)
+
     // Add the set handler to the fan on/off characteristic
     this.service
       .getCharacteristic(this.hapChar.Active)
@@ -139,6 +144,14 @@ export default class extends GoveeDevice {
       this.cacheSat = this.lightService.getCharacteristic(this.hapChar.Saturation).value
     }
 
+    // The fan's own room temperature sensor. The service is only added once the
+    // fan has sent a reading (see updateCurrentTemperature), so a fan that never
+    // reports one is not left with a tile stuck at its starting value
+    this.tempService = this.accessory.getService(this.hapServ.TemperatureSensor)
+    this.cacheTemp = this.tempService
+      ? this.tempService.getCharacteristic(this.hapChar.CurrentTemperature).value
+      : undefined
+
     // Output the customised options to the log
     const opts = JSON.stringify({
       hideLight: this.hideLight,
@@ -412,6 +425,35 @@ export default class extends GoveeDevice {
     }
   }
 
+  /**
+   * Show a reading from the fan's own temperature sensor.
+   *
+   * The reading holds the temperature in tenths of a degree FAHRENHEIT in its
+   * thousands, with bit 23 as the sign, so 0x0aad98 (699800) is 69.9°F, or
+   * 21.1°C. The Govee app reads this model's own sensor as Fahrenheit whatever
+   * the app's unit is set to (ThermometerSensorInfo.parseInfo, device type 297).
+   *
+   * @param {number} reading the 3-byte reading from an `aa 10` status frame
+   */
+  updateCurrentTemperature(reading) {
+    const isNegative = (reading & 0x800000) !== 0
+    const size = Math.floor((reading & 0x7FFFFF) / 1000)
+    const tenthsF = isNegative
+      ? -size
+      : size
+    const newTemp = Math.round(((tenthsF / 10 - 32) / 1.8) * 10) / 10
+
+    if (!this.tempService) {
+      this.tempService = this.accessory.addService(this.hapServ.TemperatureSensor)
+    }
+
+    if (newTemp !== this.cacheTemp) {
+      this.cacheTemp = newTemp
+      this.tempService.updateCharacteristic(this.hapChar.CurrentTemperature, newTemp)
+      this.accessory.log(`${platformLang.curTemp} [${this.cacheTemp}°C]`)
+    }
+  }
+
   externalUpdate(params) {
     // Update the active characteristic
     if (params.state && params.state !== this.cacheState) {
@@ -467,6 +509,18 @@ export default class extends GoveeDevice {
         return
       }
 
+      // Room temperature: aa 10 <flags> <3-byte reading>. Flag bit 7 marks a
+      // reading from the fan's own sensor (bit 0 is a linked thermometer, which
+      // is read differently), and 0xffffff means no reading
+      if (getTwoItemPosition(hexParts, 2) === '10') {
+        const flags = hexToDecimal(getTwoItemPosition(hexParts, 3))
+        const reading = hexToDecimal(`${getTwoItemPosition(hexParts, 4)}${getTwoItemPosition(hexParts, 5)}${getTwoItemPosition(hexParts, 6)}`)
+        if ((flags & 0x80) && reading !== 0xFFFFFF) {
+          this.updateCurrentTemperature(reading)
+        }
+        return
+      }
+
       const deviceFunction = `${getTwoItemPosition(hexParts, 2)}${getTwoItemPosition(hexParts, 3)}`
 
       switch (deviceFunction) {

package/lib/device/fan-ceiling.js

@@ -494,9 +494,15 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
     }
   }
 
+  /**
+   * ⚠️ The per-light handlers below carry their own names on purpose. Named
+   * like the parent's, they replaced the handlers its single fallback light
+   * still calls with just a value - so without an api key that light threw on
+   * every switch (#1384).
+   */
   setupLightService(service, name, carriesSharedControls) {
     service.getCharacteristic(this.hapChar.On).onSet(async (value) => {
-      await this.internalLightStateUpdate(service, name, value)
+      await this.internalNamedLightStateUpdate(service, name, value)
     })
 
     if (!carriesSharedControls) {
@@ -522,26 +528,26 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
       .getCharacteristic(this.hapChar.Brightness)
       .setProps({ minStep: 1 })
       .onSet(async (value) => {
-        await this.internalBrightnessUpdate(service, name, value)
+        await this.internalNamedBrightnessUpdate(service, name, value)
       })
 
     service.getCharacteristic(this.hapChar.Hue).onSet(async (value) => {
-      await this.internalColourUpdate(service, name, value)
+      await this.internalNamedColourUpdate(service, name, value)
     })
 
     service.getCharacteristic(this.hapChar.Saturation).onSet(async () => {
-      await this.internalColourUpdate(service, name, service.getCharacteristic(this.hapChar.Hue).value)
+      await this.internalNamedColourUpdate(service, name, service.getCharacteristic(this.hapChar.Hue).value)
     })
 
     if (!service.testCharacteristic(this.hapChar.ColorTemperature)) {
       service.addCharacteristic(this.hapChar.ColorTemperature)
     }
     service.getCharacteristic(this.hapChar.ColorTemperature).onSet(async (value) => {
-      await this.internalCTUpdate(service, name, value)
+      await this.internalNamedCTUpdate(service, name, value)
     })
   }
 
-  async internalLightStateUpdate(service, name, value) {
+  async internalNamedLightStateUpdate(service, name, value) {
     const newValue = value ? 'on' : 'off'
     const cacheKey = `${name}:state`
     if (this[cacheKey] === newValue) {
@@ -566,7 +572,7 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
     this.accessory.log(`${name} ${newValue}`)
   }
 
-  async internalBrightnessUpdate(service, name, value) {
+  async internalNamedBrightnessUpdate(service, name, value) {
     const updateKey = generateRandomString(5)
     this[`${name}:updateKeyBright`] = updateKey
     await sleep(350)
@@ -579,7 +585,7 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
     // nothing. Switch this light off with its own switch instead, and leave
     // the shared brightness where its owner had it (#1352)
     if (value === 0) {
-      await this.internalLightStateUpdate(service, name, false)
+      await this.internalNamedLightStateUpdate(service, name, false)
       return
     }
 
@@ -597,7 +603,7 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
     this.accessory.log(`${name} brightness [${value}%]`)
   }
 
-  async internalColourUpdate(service, name, hue) {
+  async internalNamedColourUpdate(service, name, hue) {
     const updateKey = generateRandomString(5)
     this[`${name}:updateKeyColour`] = updateKey
     await sleep(300)
@@ -621,7 +627,7 @@ export default class GoveeFanCeiling extends deviceFanCeilingBase {
     this.accessory.log(`${name} colour [rgb ${r} ${g} ${b}]`)
   }
 
-  async internalCTUpdate(service, name, value) {
+  async internalNamedCTUpdate(service, name, value) {
     const updateKey = generateRandomString(5)
     this[`${name}:updateKeyCT`] = updateKey
     await sleep(300)

package/lib/device/humidifier-H7142.js

@@ -428,6 +428,30 @@ export default class extends GoveeDevice {
         return
       }
 
+      // Humidity: aa 10 <flags> <3-byte reading>. Flag bit 7 means the reading is
+      // from the humidifier's own sensor, bit 0 from a linked thermometer. The
+      // reading holds the temperature in its thousands and the humidity in tenths
+      // of a percent below that, so 0x000212 (530) is 53.0%, and 0xffffff is none
+      if (getTwoItemPosition(hexParts, 2) === '10') {
+        const flags = hexToDecimal(getTwoItemPosition(hexParts, 3))
+        const reading = hexToDecimal(`${getTwoItemPosition(hexParts, 4)}${getTwoItemPosition(hexParts, 5)}${getTwoItemPosition(hexParts, 6)}`)
+        if ((flags & 0x81) && reading !== 0xFFFFFF) {
+          const newHumiHKValue = Math.round(((reading & 0x7FFFFF) % 1000) / 10)
+          if (newHumiHKValue !== this.cacheHumi) {
+            this.cacheHumi = newHumiHKValue
+            this.humiService.updateCharacteristic(this.hapChar.CurrentRelativeHumidity, this.cacheHumi)
+            this.accessory.log(`${platformLang.curHumi} [${this.cacheHumi}%]`)
+          }
+        }
+        return
+      }
+
+      // Reports this device sends that Home has no use for: a linked thermometer (08),
+      // timers (12), cleaning reminders (17), humidity calibration (1e) and charts (30)
+      if (['08', '12', '17', '1e', '30'].includes(getTwoItemPosition(hexParts, 2))) {
+        return
+      }
+
       const deviceFunction = `${getTwoItemPosition(hexParts, 2)}${getTwoItemPosition(hexParts, 3)}`
 
       switch (deviceFunction) {
@@ -471,20 +495,6 @@ export default class extends GoveeDevice {
           }
           break
         }
-        case '1001': { // sometimes humidity value
-          const humiCheck = getTwoItemPosition(hexParts, 4)
-          if (humiCheck === '00') {
-            const newHumiHex = `${getTwoItemPosition(hexParts, 5)}${getTwoItemPosition(hexParts, 6)}`
-            const newHumiDec = Math.round(hexToDecimal(newHumiHex)) / 10 // eg 55.5%
-            const newHumiHKValue = Math.round(newHumiDec) // eg 56%
-            if (newHumiHKValue !== this.cacheHumi) {
-              this.cacheHumi = newHumiHKValue
-              this.humiService.updateCharacteristic(this.hapChar.CurrentRelativeHumidity, this.cacheHumi)
-              this.accessory.log(`${platformLang.curHumi} [${this.cacheHumi}%]`)
-            }
-          }
-          break
-        }
         case '1800': // display off
         case '1801': { // display on
           const newDisplay = deviceFunction === '1801'