@homebridge-plugins/homebridge-govee 11.22.0 → 11.22.1-beta.0

package/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.22.1 (Pending Release)
+
+### Changes
+
+- feat: add support for Floor Lamp H16B0 and Table Lamp H1741 (#1279) (@gzimbric)
+- feat: add H5140 Smart CO2 Monitor support (closes #1179) (#1281) (@itskevinb)
+- chore: dependency updates
+- fix: self-heal invalid TTR token without full re-login
+
 ## v11.22.0 (2026-05-05)
 
 ### Changed

package/lib/connection/http.js

@@ -107,20 +107,11 @@ export default class {
         throw new Error(res.data.message || platformLang.noToken)
       }
 
-      // Also grab an access token specifically for the get tap to run endpoint
-      const ttrRes = await axios({
-        url: 'https://community-api.govee.com/os/v1/login',
-        method: 'post',
-        data: {
-          email: this.username,
-          password: this.password,
-        },
-        timeout: 30000,
-      })
-
       // Make the token available in other functions
       this.token = res.data.client.token
-      this.tokenTTR = ttrRes.data?.data?.token
+
+      // Also grab an access token specifically for the get-tap-to-run endpoint
+      await this.loginTTR()
 
       // Mark this request complete if in debug mode
       this.log.debug('[HTTP] %s.', platformLang.loginSuccess)
@@ -166,6 +157,24 @@ 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({
@@ -232,7 +241,17 @@ export default class {
     }
   }
 
-  async getTapToRuns() {
+  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
+    }
+
     // Build and send the request
     const res = await axios({
       url: 'https://app2.govee.com/bff-app/v1/exec-plat/home',
@@ -251,6 +270,13 @@ 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')
     }
 

package/lib/device/index.js

@@ -46,6 +46,7 @@ import devicePurifierH7128 from './purifier-H7128.js'
 import devicePurifierH7129 from './purifier-H7129.js'
 import devicePurifierSingle from './purifier-single.js'
 import deviceSensorButton from './sensor-button.js'
+import deviceSensorCO2 from './sensor-co2.js'
 import deviceSensorContact from './sensor-contact.js'
 import deviceSensorLeak from './sensor-leak.js'
 import deviceSensorMonitor from './sensor-monitor.js'
@@ -110,6 +111,7 @@ export default {
   devicePurifierH7129,
   devicePurifierSingle,
   deviceSensorButton,
+  deviceSensorCO2,
   deviceSensorContact,
   deviceSensorLeak,
   deviceSensorMonitor,

package/lib/device/sensor-co2.js

@@ -0,0 +1,156 @@
+import {
+  base64ToHex,
+  cenToFar,
+  getTwoItemPosition,
+  hexToTwoItems,
+  parseError,
+} from '../utils/functions.js'
+import platformLang from '../utils/lang-en.js'
+
+// HomeKit triggers "CO2 detected" abnormal flag at this threshold (ppm).
+// Govee app default warn level is 1000 ppm; override via deviceConf.co2AbnormalThreshold.
+const DEFAULT_CO2_ABNORMAL_PPM = 1000
+
+export default class {
+  constructor(platform, accessory) {
+    // Set up variables from the platform
+    this.hapChar = platform.api.hap.Characteristic
+    this.hapErr = platform.api.hap.HapStatusError
+    this.hapServ = platform.api.hap.Service
+    this.platform = platform
+
+    // Set up variables from the accessory
+    this.accessory = accessory
+
+    // Set up custom variables for this device type
+    const deviceConf = platform.deviceConf[accessory.context.gvDeviceId] || {}
+    this.co2AbnormalThreshold = deviceConf.co2AbnormalThreshold || DEFAULT_CO2_ABNORMAL_PPM
+
+    // Add the CO2 sensor service (with level + peak characteristics) if it doesn't already exist
+    this.co2Service = this.accessory.getService(this.hapServ.CarbonDioxideSensor)
+      || this.accessory.addService(this.hapServ.CarbonDioxideSensor)
+    if (!this.co2Service.testCharacteristic(this.hapChar.CarbonDioxideLevel)) {
+      this.co2Service.addCharacteristic(this.hapChar.CarbonDioxideLevel)
+    }
+    if (!this.co2Service.testCharacteristic(this.hapChar.CarbonDioxidePeakLevel)) {
+      this.co2Service.addCharacteristic(this.hapChar.CarbonDioxidePeakLevel)
+    }
+    this.cacheCO2 = this.co2Service.getCharacteristic(this.hapChar.CarbonDioxideLevel).value || 0
+    this.cacheCO2Peak = this.co2Service.getCharacteristic(this.hapChar.CarbonDioxidePeakLevel).value || 0
+    this.cacheCO2Detected = this.co2Service.getCharacteristic(this.hapChar.CarbonDioxideDetected).value || 0
+
+    // Add the temperature service if it doesn't already exist
+    this.tempService = this.accessory.getService(this.hapServ.TemperatureSensor)
+      || this.accessory.addService(this.hapServ.TemperatureSensor)
+    this.cacheTemp = this.tempService.getCharacteristic(this.hapChar.CurrentTemperature).value
+
+    // Add the humidity service if it doesn't already exist
+    this.humiService = this.accessory.getService(this.hapServ.HumiditySensor)
+      || this.accessory.addService(this.hapServ.HumiditySensor)
+    this.cacheHumi = this.humiService.getCharacteristic(this.hapChar.CurrentRelativeHumidity).value
+
+    // No Battery service — H5140 is mains-powered via USB; the Govee cloud
+    // stream doesn't carry a meaningful battery level. Remove any stale service
+    // left over from earlier versions of this handler.
+    const staleBattery = this.accessory.getService(this.hapServ.Battery)
+    if (staleBattery) {
+      this.accessory.removeService(staleBattery)
+    }
+
+    this.updateCache()
+
+    // Pass the accessory to Fakegato to set up with Eve
+    this.accessory.eveService = new platform.eveService('custom', this.accessory, {
+      log: () => {},
+    })
+
+    // Output the customised options to the log
+    const opts = JSON.stringify({
+      co2AbnormalThreshold: this.co2AbnormalThreshold,
+    })
+    platform.log('[%s] %s %s.', accessory.displayName, platformLang.devInitOpts, opts)
+  }
+
+  async externalUpdate(params) {
+    // Parse AWS reading packets — opcode 0x0A carries live CO2 / temp / humidity
+    const commands = params.commands || []
+    commands.forEach((command) => {
+      const hexString = base64ToHex(command)
+      const hexParts = hexToTwoItems(hexString)
+      if (!hexParts || hexParts.length < 20) {
+        return
+      }
+      if (getTwoItemPosition(hexParts, 1) !== 'aa') {
+        return
+      }
+      if (getTwoItemPosition(hexParts, 2) !== '0a') {
+        return
+      }
+
+      // 1-indexed: position N -> byte (N-1). LE u16: low byte at lower position.
+      const u16le = (lsbPos, msbPos) => Number.parseInt(
+        `${getTwoItemPosition(hexParts, msbPos)}${getTwoItemPosition(hexParts, lsbPos)}`,
+        16,
+      )
+
+      const offTemp = this.accessory.context.offTemp || 0
+      const offHumi = this.accessory.context.offHumi || 0
+
+      const tempRaw = u16le(3, 4) // bytes 2-3 of packet, °C × 100
+      const humiRaw = u16le(5, 6) // bytes 4-5, %RH × 100
+      const co2Raw = u16le(7, 8) // bytes 6-7, ppm
+
+      const newTemp = Math.round(tempRaw + offTemp) / 100
+      const newHumi = Math.max(0, Math.min(100, Math.round((humiRaw + offHumi) / 100)))
+      const newCO2 = co2Raw
+
+      if (newTemp !== this.cacheTemp && newTemp > -40 && newTemp < 100) {
+        this.cacheTemp = newTemp
+        this.tempService.updateCharacteristic(this.hapChar.CurrentTemperature, this.cacheTemp)
+        this.accessory.eveService.addEntry({ temp: this.cacheTemp })
+        this.accessory.log(`${platformLang.curTemp} [${this.cacheTemp}°C / ${cenToFar(this.cacheTemp)}°F]`)
+        this.updateCache()
+      }
+
+      if (newHumi !== this.cacheHumi) {
+        this.cacheHumi = newHumi
+        this.humiService.updateCharacteristic(this.hapChar.CurrentRelativeHumidity, this.cacheHumi)
+        this.accessory.eveService.addEntry({ humidity: this.cacheHumi })
+        this.accessory.log(`${platformLang.curHumi} [${this.cacheHumi}%]`)
+      }
+
+      if (newCO2 !== this.cacheCO2 && newCO2 >= 0 && newCO2 <= 40000) {
+        this.cacheCO2 = newCO2
+        this.co2Service.updateCharacteristic(this.hapChar.CarbonDioxideLevel, this.cacheCO2)
+
+        if (newCO2 > this.cacheCO2Peak) {
+          this.cacheCO2Peak = newCO2
+          this.co2Service.updateCharacteristic(this.hapChar.CarbonDioxidePeakLevel, this.cacheCO2Peak)
+        }
+
+        const detected = newCO2 >= this.co2AbnormalThreshold ? 1 : 0
+        if (detected !== this.cacheCO2Detected) {
+          this.cacheCO2Detected = detected
+          this.co2Service.updateCharacteristic(this.hapChar.CarbonDioxideDetected, detected)
+        }
+
+        this.accessory.eveService.addEntry({ ppm: this.cacheCO2 })
+        this.accessory.log(`${platformLang.curCO2} [${this.cacheCO2} ppm]`)
+      }
+    })
+  }
+
+  async updateCache() {
+    if (!this.platform.storageClientData) {
+      return
+    }
+    try {
+      await this.platform.storageData.setItem(
+        `${this.accessory.context.gvDeviceId}_temp`,
+        this.cacheTemp,
+      )
+    } catch (err) {
+      this.accessory.logWarn(`${platformLang.storageWriteErr} ${parseError(err)}`)
+    }
+  }
+}

package/lib/platform.js

@@ -479,8 +479,8 @@ export default class {
 
           this.accountId = data.accountId
           this.accountTopic = data.topic
-          const accountToken = data.token
-          const accountTokenTTR = data.tokenTTR
+          this.accountToken = data.token
+          this.accountTokenTTR = data.tokenTTR
           this.clientId = data.client
           this.iotEndpoint = data.endpoint
           this.iotPass = data.iotPass
@@ -489,14 +489,7 @@ export default class {
           await promises.writeFile(iotFile, Buffer.from(data.iot, 'base64'))
 
           // Try and save these to the cache for future reference
-          try {
-            await this.storageData.setItem(
-              'Govee_All_Devices_temp',
-              `${this.accountTopic}:::${accountToken}:::${this.config.username}:::${this.accountId}:::${this.iotEndpoint}:::${this.iotPass}:::${accountTokenTTR}`,
-            )
-          } catch (e) {
-            this.log.warn('[HTTP] %s %s.', platformLang.accTokenStoreErr, parseError(e))
-          }
+          await this.persistAccountCache()
           await getDevices()
         }
 
@@ -806,6 +799,16 @@ export default class {
       if (this.httpClient) {
         try {
           const scenes = await this.httpClient.getTapToRuns()
+
+          // If the TTR token had to be refreshed (eg. it was missing or expired
+          // in the cache), write the new one back so the next startup is fixed
+          if (this.httpClient.tokenTTRRefreshed) {
+            this.accountTokenTTR = this.httpClient.tokenTTR
+            this.httpClient.tokenTTRRefreshed = false
+            await this.persistAccountCache()
+            this.log.debug('[HTTP] refreshed TTR token saved to cache.')
+          }
+
           scenes.forEach((scene) => {
             if (scene.oneClicks) {
               scene.oneClicks.forEach((oneClick) => {
@@ -946,6 +949,20 @@ export default class {
     this.log('----------------------------')
   }
 
+  async persistAccountCache() {
+    // Persist the account details to the cache for future startups, so we can
+    // skip a full login. Kept in one place so the TTR self-heal path can also
+    // re-save once it has refreshed the (separate, shorter-lived) TTR token.
+    try {
+      await this.storageData.setItem(
+        'Govee_All_Devices_temp',
+        `${this.accountTopic}:::${this.accountToken}:::${this.config.username}:::${this.accountId}:::${this.iotEndpoint}:::${this.iotPass}:::${this.accountTokenTTR}`,
+      )
+    } catch (err) {
+      this.log.warn('[HTTP] %s %s.', platformLang.accTokenStoreErr, parseError(err))
+    }
+  }
+
   pluginShutdown() {
     // A function that is called when the plugin fails to load or Homebridge restarts
     try {
@@ -1150,6 +1167,11 @@ export default class {
         devInstance = deviceTypes.deviceSensorMonitor
         doAWSPolling = true
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
+      } else if (platformConsts.models.sensorCO2.includes(device.model)) {
+        // Device is a CO2 + temperature + humidity monitor (H5140)
+        devInstance = deviceTypes.deviceSensorCO2
+        doAWSPolling = true
+        accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.fan.includes(device.model)) {
         // Device is a fan
         devInstance = deviceTypes[`deviceFan${device.model}`]

package/lib/utils/constants.js

@@ -129,6 +129,8 @@ export default {
   models: {
     rgb: [
       'H1401',
+      'H16B0', // https://github.com/homebridge-plugins/homebridge-govee/issues/1278
+      'H1741', // https://github.com/homebridge-plugins/homebridge-govee/issues/1278
       'H6001',
       'H6002',
       'H6003',
@@ -515,6 +517,7 @@ export default {
     ],
     sensorThermo4: ['H5198'],
     sensorMonitor: ['H5106'],
+    sensorCO2: ['H5140'], // CO2 + temp + humidity monitor, AWS opcode 0x0A — closes #1179
     fan: ['H7100', 'H7101', 'H7102', 'H7105', 'H7106', 'H7107', 'H7111'],
     heater1: ['H7130', 'H713A', 'H713B', 'H713C'],
     heater2: ['H7131', 'H7132', 'H7133', 'H7134', 'H7135'],
@@ -542,7 +545,6 @@ export default {
       'H5126', // https://github.com/homebridge-plugins/homebridge-govee/issues/910
       'H5129', // https://github.com/homebridge-plugins/homebridge-govee/issues/1084
       'H5125', // https://github.com/homebridge-plugins/homebridge-govee/issues/981
-      'H5140', // https://github.com/homebridge-plugins/homebridge-govee/issues/1179
       'H5185', // https://github.com/homebridge-plugins/homebridge-govee/issues/804
       'H5191', // https://github.com/homebridge-plugins/homebridge-govee/issues/1121
     ],

package/lib/utils/lang-en.js

@@ -44,6 +44,7 @@ export default {
   curAmp: 'current amperage',
   curBatt: 'current battery',
   curBright: 'current brightness',
+  curCO2: 'current CO2',
   curColour: 'current colour',
   curCool: 'current cooling',
   curDisplay: 'current display',

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-govee",
   "alias": "Govee",
   "type": "module",
-  "version": "11.22.0",
+  "version": "11.22.1-beta.0",
   "description": "Homebridge plugin to integrate Govee devices into HomeKit.",
   "author": {
     "name": "bwp91",
@@ -58,19 +58,19 @@
   "dependencies": {
     "@homebridge/plugin-ui-utils": "^2.2.3",
     "aws-iot-device-sdk": "^2.2.16",
-    "axios": "^1.16.0",
+    "axios": "^1.16.1",
     "mqtt": "^5.12.1",
     "node-persist": "^4.0.4",
     "node-rsa": "^1.1.1",
-    "p-queue": "^9.2.0",
+    "p-queue": "^9.3.0",
     "patch-package": "^8.0.1",
     "pem": "^1.14.8"
   },
   "optionalDependencies": {
     "@stoprocent/bluetooth-hci-socket": "^2.2.6",
-    "@stoprocent/noble": "^2.4.1"
+    "@stoprocent/noble": "^2.5.3"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "^8.2.0"
+    "@antfu/eslint-config": "^9.0.0"
   }
 }