@homebridge-plugins/homebridge-govee 11.35.0 → 11.35.1-beta.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@homebridge-plugins/homebridge-govee` will be documented in this file.
 
+## v11.35.1 (Pending Release)
+
+### Changed
+
+- fix: stop reading an h7173 startup frame as a kettle preset temperature (#1351)
+
 ## v11.35.0 (2026-08-09)
 
 ### Changed

package/lib/device/kettle.js

@@ -75,6 +75,13 @@ function readingToCelsius(hexParts) {
  * Only these four have been seen, all with keep warm switched on. Anything else
  * falls through to the unknown-data report, which is how these were found.
  */
+// The range a kettle preset can plausibly sit in. The lowest Govee kettles go
+// is around 40°C for delicate teas, and water stops being water at 100°C - so
+// 90°F to 212°F covers every real preset with room to spare, while excluding
+// the 0 and 1 the H7173 puts in that byte (#1351).
+const KETTLE_PRESET_MIN_F = 90
+const KETTLE_PRESET_MAX_F = 212
+
 const HEATING_STATES = {
   '00': { label: 'idle', heating: false },
   '01': { label: 'heating', heating: true },
@@ -391,6 +398,27 @@ export default class extends GoveeDevice {
       if (getTwoItemPosition(hexParts, 2) === '05' && getTwoItemPosition(hexParts, 3) !== '00') {
         const slot = Number.parseInt(getTwoItemPosition(hexParts, 3), 16)
         const tempInF = Number.parseInt(getTwoItemPosition(hexParts, 4), 16)
+
+        // ⚠️ The `aa 05 <slot> <degrees F>` reading came from ONE kettle, the
+        // H7171 in #1337. The H7173 sends the same two leading bytes with a
+        // fourth byte of 0 or 1, which is plainly not a temperature - and the
+        // plugin cheerfully announced "preset 1 is set to 0°F [-18°C]" (#1351).
+        //
+        // So the shape alone is not enough to claim a meaning. A preset a
+        // kettle could actually hold is the test; anything else is a frame this
+        // plugin cannot read yet, and reporting it as such is what gets it
+        // decoded rather than guessed at.
+        if (tempInF < KETTLE_PRESET_MIN_F || tempInF > KETTLE_PRESET_MAX_F) {
+          logUnknownData(this.accessory, {
+            kind: 'status',
+            source: 'AWS',
+            raw: hexString,
+            hex: hexParts.join(''),
+            extra: { note: 'aa 05 frame whose fourth byte is not a preset temperature' },
+          })
+          return
+        }
+
         const line = `preset ${slot} is set to ${tempInF}°F [${Math.round(((tempInF - 32) * 5) / 9)}°C]`
         // Worth seeing in a normal log, but only once each. The kettle sends
         // these when it connects, and if a firmware ever repeats them on a

package/package.json

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