@homebridge-plugins/homebridge-govee 11.32.2-beta.5 → 11.32.2-beta.7

package/CHANGELOG.md

@@ -18,6 +18,8 @@ All notable changes to `@homebridge-plugins/homebridge-govee` will be documented
 - feat: add support for 85 more light models, covering everything currently sold that was missing
 - feat: add 24 more light models, three thermo-hygrometers and a leak detector
 - feat: add the H7103 and H7112 fans and the H5085 plug, with unknown controls saying so instead of guessing
+- feat: give every appliance type a starting handler, so a new model works for on and off and asks for the rest
+- refactor: point models that behave identically at one shared handler instead of copies of the same file
 
 ## v11.32.1 (2026-08-02)
 

package/CONTRIBUTING-STRUCTURE.md

@@ -0,0 +1,66 @@
+# How this plugin is put together, and how to extend it
+
+This is the working reference for adding models and functionality. It exists so
+that the next change follows the same shape as the last, whoever makes it.
+
+## The three ways a model gets support
+
+**1. It shares behaviour with a model already handled — alias it.**
+Nothing new is written. `lib/device/index.js` maps the new model's key to the
+existing handler:
+
+```text
+deviceHumidifierH7147: deviceHumidifierH7143,
+```
+
+This is the common case. Several Govee models are the same device with a
+different name, and a handler copied per model is a handler that has to be fixed
+per model.
+
+**2. It is a new model of a known type, but the details are unknown — let it
+say so.** Add it to the model list in `lib/utils/constants.js` and nothing else.
+The dispatch falls back to `appliance-basic.js`, which offers on and off (that
+command is identical across every Govee appliance) and makes every other control
+report what it needs and then fail, so the owner sees it in the Home app, checks
+the log, and finds a line to paste into an issue.
+
+**3. It genuinely behaves differently — write a handler.**
+Only when the controls or their commands really differ.
+
+## Where model knowledge lives
+
+Per-model differences belong in data, not in a copied file:
+
+| File | Holds |
+|---|---|
+| `lib/utils/constants.js` | which models are which type |
+| `lib/utils/device-capabilities.js` | protocol quirks — colour command, brightness scale, and firmware-dependent behaviour |
+| `lib/utils/appliance-capabilities.js` | which controls a model actually has |
+
+If a change means copying a file and editing two lines, it belongs in one of
+these instead.
+
+## Reporting anything unknown
+
+Never log an unrecognised payload by hand. Use `lib/utils/report-unknown.js`:
+
+- `logUnknownData` — something arrived that is not understood
+- `reportUnsupportedControl` — the user asked for something not worked out yet
+
+Both produce one line carrying the model, firmware, hardware, connection and
+payload, so a single copy-paste is enough to act on. Both warn once and then
+drop to debug, so a device repeating itself does not flood the log.
+
+## Things worth knowing before changing appliance code
+
+- **The power command is universal.** `33 01 01` on, `33 01 00` off, on every
+  appliance. Safe to send for an untested model.
+- **Frames are 20 bytes with an XOR checksum** — byte 20 is the XOR of bytes
+  1–19. All 407 shipped appliance commands have been verified against this.
+- **A control that silently does nothing is worse than one that fails.** Failing
+  shows up in the Home app and sends the owner to the log.
+- **Do not remove a control a model has offered for a long time** on evidence
+  alone. Someone may be using it. Confirm with an owner first.
+- **HomeKit tiles have requirements.** A humidifier must report a current
+  humidity, which many Govee humidifiers never send — hence the plain fan tile
+  by default, and the richer one only when the device says it has the sensor.

package/lib/device/appliance-basic.js

@@ -0,0 +1,280 @@
+import { base64ToHex, getTwoItemPosition, hexToTwoItems, parseError } from '../utils/functions.js'
+import platformLang from '../utils/lang-en.js'
+import { logUnknownData, reportUnsupportedControl } from '../utils/report-unknown.js'
+
+/**
+ * A starting point for any appliance whose power command is known but whose
+ * other controls are not.
+ *
+ * Govee uses the same on/off command for every appliance the plugin handles, so
+ * power can be offered with confidence for a model nobody has tested. The
+ * settings that differ per model - speeds, modes, sizes - are the risky part,
+ * and getting one wrong is worse than not offering it. So those controls appear
+ * but report what they need and fail the request, rather than sending a guess.
+ *
+ * Failing rather than doing nothing is deliberate: HomeKit shows the control as
+ * not responding, which is what sends the owner to the log, where they find a
+ * line to paste into an issue. That turns every owner of an untested model into
+ * the source of the data needed to finish it.
+ *
+ * Once that data arrives the model gets a proper handler and stops using this.
+ */
+class ApplianceBasic {
+  constructor(platform, accessory, config) {
+    // 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
+    this.config = config
+
+    // Some appliances can have a richer tile, but only if the device reports
+    // the reading that tile needs - HomeKit's humidifier, for example, has to
+    // show a current humidity, and plenty of Govee humidifiers never send one.
+    // Where Govee tells us the device has that sensor, use the better tile;
+    // otherwise fall back to the plain one, which needs nothing extra.
+    const hasSensor = config.richCapability
+      && !!accessory.context.openApiCapabilities?.[config.richCapability]
+    const serviceName = (config.richService && hasSensor) ? config.richService : config.service
+    this.usingRichService = serviceName === config.richService
+
+    // Drop the other service if this device has switched between the two
+    const otherName = this.usingRichService ? config.service : config.richService
+    if (otherName && this.hapServ[otherName]) {
+      const stale = this.accessory.getService(this.hapServ[otherName])
+      if (stale) {
+        this.accessory.removeService(stale)
+      }
+    }
+
+    const serviceType = this.hapServ[serviceName]
+    this.service = this.accessory.getService(serviceType)
+      || this.accessory.addService(serviceType)
+
+    // The plain Fan service switches on a boolean `On`, while Fanv2 and
+    // AirPurifier use `Active`. Follow whichever this service uses, so these
+    // tiles behave like the hand-written handlers for the same kind of device.
+    const usesOn = serviceName === 'Fan'
+    this.powerChar = usesOn ? this.hapChar.On : this.hapChar.Active
+    this.powerOn = usesOn ? true : 1
+    this.powerOff = usesOn ? false : 0
+
+    // Add the set handler to the power characteristic
+    this.service
+      .getCharacteristic(this.powerChar)
+      .onSet(async value => this.internalStateUpdate(value))
+    this.cacheState = this.service.getCharacteristic(this.powerChar).value ? 'on' : 'off'
+
+    // Some services need a current-state characteristic to look right in the
+    // Home app. It belongs to the richer tile, so it is skipped when a device
+    // has fallen back to the plain fan for want of a sensor.
+    const fellBackToPlain = !!config.richService && !this.usingRichService
+    if (config.currentStateChar && !fellBackToPlain) {
+      this.currentStateChar = this.hapChar[config.currentStateChar]
+      this.service.updateCharacteristic(
+        this.currentStateChar,
+        this.cacheState === 'on' ? config.currentStateOn : config.currentStateOff,
+      )
+    }
+
+    // Offer the variable control so the device can be asked about it, but make
+    // it clear it does nothing yet rather than sending a guessed command. The
+    // richer services name this control differently, so follow the service.
+    const variableChar = this.usingRichService && config.richVariableChar
+      ? config.richVariableChar
+      : config.variableChar
+    if (variableChar) {
+      this.variableChar = this.hapChar[variableChar]
+      this.service
+        .getCharacteristic(this.variableChar)
+        .onSet(async value => this.internalVariableUpdate(value))
+      this.cacheVariable = this.service.getCharacteristic(this.variableChar).value
+    }
+
+    // Output the customised options to the log
+    const opts = JSON.stringify({})
+    platform.log('[%s] %s %s.', accessory.displayName, platformLang.devInitOpts, opts)
+    this.accessory.log(`on and off are supported for this model, the ${config.variableLabel || 'other settings'} are not known yet`)
+  }
+
+  async internalStateUpdate(value) {
+    try {
+      const newValue = value ? 'on' : 'off'
+
+      // Don't continue if the new value is the same as before
+      if (this.cacheState === newValue) {
+        return
+      }
+
+      // This power command is the same for every govee appliance, so it is safe
+      // to send for a model that has not been tested
+      await this.platform.sendDeviceUpdate(this.accessory, {
+        cmd: 'ptReal',
+        value: value ? 'MwEBAAAAAAAAAAAAAAAAAAAAADM=' : 'MwEAAAAAAAAAAAAAAAAAAAAAADI=',
+        openApi: this.accessory.context.openApiCapabilities?.powerSwitch
+          ? { instance: 'powerSwitch', capabilityType: 'devices.capabilities.on_off', value: value ? 1 : 0 }
+          : undefined,
+      })
+
+      // Cache the new state and log if appropriate
+      this.cacheState = newValue
+      if (this.currentStateChar) {
+        this.service.updateCharacteristic(
+          this.currentStateChar,
+          value ? this.config.currentStateOn : this.config.currentStateOff,
+        )
+      }
+      this.accessory.log(`${platformLang.curState} [${newValue}]`)
+    } catch (err) {
+      // Catch any errors during the process
+      this.accessory.logWarn(`${platformLang.devNotUpdated} ${parseError(err)}`)
+
+      // Throw a 'no response' error and set a timeout to revert this after 2 seconds
+      setTimeout(() => {
+        this.service.updateCharacteristic(this.hapChar.Active, this.cacheState === 'on' ? 1 : 0)
+      }, 2000)
+      throw new this.hapErr(-70402)
+    }
+  }
+
+  async internalVariableUpdate(value) {
+    // 0 is the control following the device being turned off, not a request
+    if (value === 0) {
+      return
+    }
+
+    reportUnsupportedControl(this.accessory, {
+      control: this.config.variableLabel || 'setting',
+      value,
+    })
+
+    // Put the control back, and fail the request so HomeKit shows it as not
+    // responding - that is what sends the owner to the log
+    setTimeout(() => {
+      this.service.updateCharacteristic(this.variableChar, this.cacheVariable)
+    }, 2000)
+    throw new this.hapErr(-70402)
+  }
+
+  externalUpdate(params) {
+    // Feed the sensor reading through when the richer tile is in use - HomeKit
+    // needs it, and it is the reason that tile was chosen
+    if (this.usingRichService && this.config.richReadingChar && params.humidity !== undefined) {
+      const reading = Number(params.humidity)
+      if (Number.isFinite(reading) && reading !== this.cacheReading) {
+        this.cacheReading = reading
+        this.service.updateCharacteristic(this.hapChar[this.config.richReadingChar], reading)
+      }
+    }
+
+    // Power is the one thing that can be read back with confidence
+    if (params.state && params.state !== this.cacheState) {
+      this.cacheState = params.state
+      this.service.updateCharacteristic(this.hapChar.Active, this.cacheState === 'on' ? 1 : 0)
+      if (this.currentStateChar) {
+        this.service.updateCharacteristic(
+          this.currentStateChar,
+          this.cacheState === 'on' ? this.config.currentStateOn : this.config.currentStateOff,
+        )
+      }
+      this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
+    }
+
+    // Everything else gets reported so the model can be finished off
+    ;(params.commands || []).forEach((command) => {
+      const hexString = base64ToHex(command)
+      const hexParts = hexToTwoItems(hexString)
+
+      if (getTwoItemPosition(hexParts, 1) !== 'aa') {
+        return
+      }
+
+      // The power report is understood, anything else is worth sending in
+      if (getTwoItemPosition(hexParts, 2) === '01') {
+        const newState = getTwoItemPosition(hexParts, 3) === '01' ? 'on' : 'off'
+        if (this.cacheState !== newState) {
+          this.cacheState = newState
+          this.service.updateCharacteristic(this.hapChar.Active, this.cacheState === 'on' ? 1 : 0)
+          this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
+        }
+        return
+      }
+
+      logUnknownData(this.accessory, {
+        kind: 'scene',
+        source: params.source,
+        raw: command,
+        hex: hexString,
+      })
+    })
+  }
+}
+
+/**
+ * Build a basic handler for a kind of appliance.
+ *
+ * @param {object} config how this kind of appliance should appear
+ * @returns {Function} a handler class the platform can construct
+ */
+export function makeBasicAppliance(config) {
+  return class extends ApplianceBasic {
+    constructor(platform, accessory) {
+      super(platform, accessory, config)
+    }
+  }
+}
+
+// Fan-shaped appliances: a speed slider that is not worked out yet
+export const deviceFanBasic = makeBasicAppliance({
+  service: 'Fanv2',
+  variableChar: 'RotationSpeed',
+  variableLabel: 'fan speed',
+})
+
+// Ice makers reuse the fan tile, with the slider standing in for ice size
+export const deviceIceMakerBasic = makeBasicAppliance({
+  service: 'Fanv2',
+  variableChar: 'RotationSpeed',
+  variableLabel: 'ice size',
+})
+
+// Humidifiers get the plain fan tile by default, because HomeKit's humidifier
+// has to show a current humidity and many Govee humidifiers never report one.
+// A model that does report it gets the proper humidifier tile instead.
+export const deviceHumidifierBasic = makeBasicAppliance({
+  service: 'Fan',
+  variableChar: 'RotationSpeed',
+  variableLabel: 'mist level',
+  richService: 'HumidifierDehumidifier',
+  richCapability: 'sensorHumidity',
+  richVariableChar: 'RelativeHumidityHumidifierThreshold',
+  richReadingChar: 'CurrentRelativeHumidity',
+  currentStateChar: 'CurrentHumidifierDehumidifierState',
+  currentStateOn: 2, // humidifying
+  currentStateOff: 0, // inactive
+})
+
+export const deviceDehumidifierBasic = makeBasicAppliance({
+  service: 'Fan',
+  variableChar: 'RotationSpeed',
+  variableLabel: 'fan speed',
+  richService: 'HumidifierDehumidifier',
+  richCapability: 'sensorHumidity',
+  richVariableChar: 'RelativeHumidityDehumidifierThreshold',
+  richReadingChar: 'CurrentRelativeHumidity',
+  currentStateChar: 'CurrentHumidifierDehumidifierState',
+  currentStateOn: 3, // dehumidifying
+  currentStateOff: 0, // inactive
+})
+
+export const devicePurifierBasic = makeBasicAppliance({
+  service: 'AirPurifier',
+  variableChar: 'RotationSpeed',
+  variableLabel: 'fan speed',
+  currentStateChar: 'CurrentAirPurifierState',
+  currentStateOn: 2, // purifying air
+  currentStateOff: 0, // inactive
+})

package/lib/device/appliance-basic.test.js

@@ -0,0 +1,150 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { resetReportedUnknowns } from '../utils/report-unknown.js'
+import { deviceHumidifierBasic, devicePurifierBasic } from './appliance-basic.js'
+
+/**
+ * Minimal stand-ins for the HomeKit objects. Enough to see which service a
+ * device is given and which controls it ends up with.
+ */
+function makeCharacteristic(value) {
+  return {
+    value,
+    onSet(fn) {
+      this.setHandler = fn
+      return this
+    },
+    setProps() {
+      return this
+    },
+  }
+}
+
+function makeService(name) {
+  const chars = new Map()
+  return {
+    name,
+    getCharacteristic(char) {
+      if (!chars.has(char)) {
+        chars.set(char, makeCharacteristic(char === 'On' ? false : 0))
+      }
+      return chars.get(char)
+    },
+    updateCharacteristic(char, value) {
+      this.getCharacteristic(char).value = value
+      return this
+    },
+    testCharacteristic: char => chars.has(char),
+    removeCharacteristic() {},
+    chars,
+  }
+}
+
+function makePlatform() {
+  // Service and characteristic names stand in for themselves, so a test can
+  // assert on which one was picked
+  const proxy = new Proxy({}, { get: (_t, prop) => prop })
+  return {
+    log: Object.assign(vi.fn(), { warn: vi.fn(), debug: vi.fn() }),
+    api: { hap: { Service: proxy, Characteristic: proxy, HapStatusError: class {} } },
+  }
+}
+
+function makeAccessory(capabilities) {
+  const services = new Map()
+  return {
+    displayName: 'Test Appliance',
+    context: {
+      gvModel: 'H7146',
+      gvDeviceId: 'AA:BB',
+      openApiCapabilities: capabilities,
+    },
+    getService: name => services.get(name),
+    addService(name) {
+      const svc = makeService(name)
+      services.set(name, svc)
+      return svc
+    },
+    removeService(svc) {
+      services.delete(svc.name)
+    },
+    log: vi.fn(),
+    logWarn: vi.fn(),
+    logDebug: vi.fn(),
+    services,
+  }
+}
+
+describe('basic appliance handler', () => {
+  beforeEach(() => {
+    resetReportedUnknowns()
+  })
+
+  describe('choosing the tile for a humidifier', () => {
+    it('uses the plain fan when the device reports no humidity', () => {
+      // HomeKit's humidifier must show a current humidity, and many govee
+      // humidifiers never send one - so the safe tile is the plain fan
+      const accessory = makeAccessory({})
+      const device = new deviceHumidifierBasic(makePlatform(), accessory)
+
+      expect(device.service.name).toBe('Fan')
+      expect(accessory.services.has('HumidifierDehumidifier')).toBe(false)
+    })
+
+    it('uses the proper humidifier when the device does report humidity', () => {
+      const accessory = makeAccessory({ sensorHumidity: { type: 'sensor' } })
+      const device = new deviceHumidifierBasic(makePlatform(), accessory)
+
+      expect(device.service.name).toBe('HumidifierDehumidifier')
+    })
+
+    it('switches the power characteristic to suit the tile', () => {
+      // the plain fan switches on a boolean, the humidifier on active
+      const plain = new deviceHumidifierBasic(makePlatform(), makeAccessory({}))
+      const rich = new deviceHumidifierBasic(
+        makePlatform(),
+        makeAccessory({ sensorHumidity: {} }),
+      )
+
+      expect(plain.powerChar).toBe('On')
+      expect(plain.powerOn).toBe(true)
+      expect(rich.powerChar).toBe('Active')
+      expect(rich.powerOn).toBe(1)
+    })
+
+    it('passes a humidity reading through only on the richer tile', () => {
+      const rich = new deviceHumidifierBasic(
+        makePlatform(),
+        makeAccessory({ sensorHumidity: {} }),
+      )
+      rich.externalUpdate({ humidity: 55 })
+
+      expect(rich.service.getCharacteristic('CurrentRelativeHumidity').value).toBe(55)
+    })
+  })
+
+  it('keeps the current-state characteristic on a purifier', () => {
+    // the purifier has no fallback tile, so its state characteristic must stay
+    const device = new devicePurifierBasic(makePlatform(), makeAccessory({}))
+
+    expect(device.service.name).toBe('AirPurifier')
+    expect(device.currentStateChar).toBe('CurrentAirPurifierState')
+  })
+
+  it('reports an unknown control and fails the request', async () => {
+    const accessory = makeAccessory({})
+    const device = new deviceHumidifierBasic(makePlatform(), accessory)
+
+    await expect(device.internalVariableUpdate(50)).rejects.toBeDefined()
+    expect(accessory.logWarn).toHaveBeenCalledTimes(1)
+    expect(accessory.logWarn.mock.calls[0][0]).toContain('mist level')
+  })
+
+  it('ignores the control following the device being switched off', async () => {
+    const accessory = makeAccessory({})
+    const device = new deviceHumidifierBasic(makePlatform(), accessory)
+
+    await expect(device.internalVariableUpdate(0)).resolves.toBeUndefined()
+    expect(accessory.logWarn).not.toHaveBeenCalled()
+  })
+})

package/lib/device/index.js

@@ -1,36 +1,32 @@
+import {
+  deviceDehumidifierBasic,
+  deviceFanBasic,
+  deviceHumidifierBasic,
+  deviceIceMakerBasic,
+  devicePurifierBasic,
+} from './appliance-basic.js'
 import deviceCoolerSingle from './cooler-single.js'
 import deviceDehumidifierH7150 from './dehumidifier-H7150.js'
 import deviceDehumidifierH7151 from './dehumidifier-H7151.js'
 import deviceDehumidifierH7152 from './dehumidifier-H7152.js'
 import deviceDiffuserH7161 from './diffuser-H7161.js'
-import deviceDiffuserH7162 from './diffuser-H7162.js'
-import deviceFanBasic from './fan-basic.js'
 import deviceFanH1310 from './fan-H1310.js'
 import deviceFanH1370 from './fan-H1370.js'
 import deviceFanH7100 from './fan-H7100.js'
 import deviceFanH7101 from './fan-H7101.js'
-import deviceFanH7102 from './fan-H7102.js'
 import deviceFanH7105 from './fan-H7105.js'
-import deviceFanH7106 from './fan-H7106.js'
 import deviceFanH7107 from './fan-H7107.js'
 import deviceFanH7111 from './fan-H7111.js'
 import deviceHeater1A from './heater1a.js'
 import deviceHeater1B from './heater1b.js'
 import deviceHeater2 from './heater2.js'
 import deviceHeaterSingle from './heater-single.js'
-import deviceHumidifierH714E from './humidifier-H714E.js'
 import deviceHumidifierH7140 from './humidifier-H7140.js'
 import deviceHumidifierH7141 from './humidifier-H7141.js'
 import deviceHumidifierH7142 from './humidifier-H7142.js'
 import deviceHumidifierH7143 from './humidifier-H7143.js'
-import deviceHumidifierH7145 from './humidifier-H7145.js'
-import deviceHumidifierH7147 from './humidifier-H7147.js'
-import deviceHumidifierH7148 from './humidifier-H7148.js'
-import deviceHumidifierH7149 from './humidifier-H7149.js'
 import deviceHumidifierH7160 from './humidifier-H7160.js'
-import deviceIceMakerH717D from './ice-maker-H717D.js'
 import deviceIceMakerH7172 from './ice-maker-H7172.js'
-import deviceIceMakerH8120 from './ice-maker-H8120.js'
 import deviceIceMakerH8121 from './ice-maker-H8121.js'
 import deviceIceMakerH8122 from './ice-maker-H8122.js'
 import deviceKettle from './kettle.js'
@@ -39,16 +35,12 @@ import deviceLight from './light.js'
 import deviceOutletDouble from './outlet-double.js'
 import deviceOutletSingle from './outlet-single.js'
 import deviceOutletTriple from './outlet-triple.js'
-import devicePurifierH712C from './purifier-H712C.js'
 import devicePurifierH7120 from './purifier-H7120.js'
 import devicePurifierH7121 from './purifier-H7121.js'
 import devicePurifierH7122 from './purifier-H7122.js'
 import devicePurifierH7123 from './purifier-H7123.js'
 import devicePurifierH7124 from './purifier-H7124.js'
 import devicePurifierH7126 from './purifier-H7126.js'
-import devicePurifierH7127 from './purifier-H7127.js'
-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'
@@ -73,35 +65,38 @@ export default {
   deviceDehumidifierH7151,
   deviceDehumidifierH7152,
   deviceDiffuserH7161,
-  deviceDiffuserH7162,
+  deviceDiffuserH7162: deviceDiffuserH7161, // identical to the H7161
+  deviceDehumidifierBasic,
   deviceFanBasic,
   deviceFanH1310,
   deviceFanH1370,
   deviceFanR1310: deviceFanH1310, // R1310 is the newer naming of the H1310
   deviceFanH7100,
+  deviceFanH7102: deviceFanH7100, // identical to the H7100
+  deviceFanH7106: deviceFanH7100, // identical to the H7100
   deviceFanH7101,
-  deviceFanH7102,
   deviceFanH7105,
-  deviceFanH7106,
   deviceFanH7107,
   deviceFanH7111,
   deviceHeaterSingle,
   deviceHeater1A,
   deviceHeater1B,
   deviceHeater2,
-  deviceHumidifierH714E,
+  deviceHumidifierBasic,
   deviceHumidifierH7140,
   deviceHumidifierH7141,
   deviceHumidifierH7142,
   deviceHumidifierH7143,
-  deviceHumidifierH7145,
-  deviceHumidifierH7147,
-  deviceHumidifierH7148,
-  deviceHumidifierH7149,
+  deviceHumidifierH7145: deviceHumidifierH7143, // identical to the H7143
+  deviceHumidifierH7147: deviceHumidifierH7143, // identical to the H7143
+  deviceHumidifierH7148: deviceHumidifierH7143, // identical to the H7143
+  deviceHumidifierH7149: deviceHumidifierH7143, // identical to the H7143
+  deviceHumidifierH714E: deviceHumidifierH7143, // identical to the H7143
   deviceHumidifierH7160,
+  deviceIceMakerBasic,
   deviceIceMakerH7172,
-  deviceIceMakerH717D,
-  deviceIceMakerH8120,
+  deviceIceMakerH717D: deviceIceMakerH7172, // identical to the H7172
+  deviceIceMakerH8120: deviceIceMakerH7172, // identical to the H7172
   deviceIceMakerH8121,
   deviceIceMakerH8122,
   deviceKettle,
@@ -110,16 +105,17 @@ export default {
   deviceOutletDouble,
   deviceOutletSingle,
   deviceOutletTriple,
-  devicePurifierH712C,
+  devicePurifierBasic,
   devicePurifierH7120,
   devicePurifierH7121,
   devicePurifierH7122,
   devicePurifierH7123,
   devicePurifierH7124,
   devicePurifierH7126,
-  devicePurifierH7127,
-  devicePurifierH7128,
-  devicePurifierH7129,
+  devicePurifierH7127: devicePurifierH7126, // identical to the H7126
+  devicePurifierH7128: devicePurifierH7126, // identical to the H7126
+  devicePurifierH7129: devicePurifierH7126, // identical to the H7126
+  devicePurifierH712C: devicePurifierH7126, // identical to the H7126
   devicePurifierSingle,
   deviceSensorButton,
   deviceSensorCO2,

package/lib/platform.js

@@ -1265,16 +1265,16 @@ export default class {
       } else if (platformConsts.models.humidifier.includes(device.model)) {
         // Device is a humidifier
         doAWSPolling = true
-        devInstance = deviceTypes[`deviceHumidifier${device.model}`]
+        devInstance = deviceTypes[`deviceHumidifier${device.model}`] || deviceTypes.deviceHumidifierBasic
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.dehumidifier.includes(device.model)) {
         // Device is a dehumidifier
-        devInstance = deviceTypes[`deviceDehumidifier${device.model}`]
+        devInstance = deviceTypes[`deviceDehumidifier${device.model}`] || deviceTypes.deviceDehumidifierBasic
         doAWSPolling = true
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.purifier.includes(device.model)) {
         // Device is a purifier
-        devInstance = deviceTypes[`devicePurifier${device.model}`]
+        devInstance = deviceTypes[`devicePurifier${device.model}`] || deviceTypes.devicePurifierBasic
         doAWSPolling = true
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.diffuser.includes(device.model)) {
@@ -1296,7 +1296,7 @@ export default class {
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.iceMaker.includes(device.model)) {
         // Device is an ice maker
-        devInstance = deviceTypes[`deviceIceMaker${device.model}`]
+        devInstance = deviceTypes[`deviceIceMaker${device.model}`] || deviceTypes.deviceIceMakerBasic
         accessory = devicesInHB.get(uuid) || this.addAccessory(device)
       } else if (platformConsts.models.template.includes(device.model)) {
         // Device is a work-in-progress

package/lib/utils/constants.js

@@ -664,10 +664,10 @@ export default {
     heater1: ['H7130', 'H713A', 'H713B', 'H713C', 'H7137', 'H713E'],
     heater2: ['H7131', 'H7132', 'H7133', 'H7134', 'H7135'],
     dehumidifier: ['H7150', 'H7151', 'H7152'],
-    humidifier: ['H7140', 'H7141', 'H7142', 'H7143', 'H7145', 'H7147', 'H7148', 'H7149', 'H714E', 'H7160'],
+    humidifier: ['H7140', 'H7141', 'H7142', 'H7143', 'H7145', 'H7146', 'H7147', 'H7148', 'H7149', 'H714E', 'H7160'],
     purifier: ['H7120', 'H7121', 'H7122', 'H7123', 'H7124', 'H7126', 'H7127', 'H7128', 'H7129', 'H712C'],
     diffuser: ['H7161', 'H7162'],
-    iceMaker: ['H7172', 'H717D', 'H8120', 'H8121', 'H8122'],
+    iceMaker: ['H7172', 'H717D', 'H8102', 'H8120', 'H8121', 'H8122', 'H8131'],
     sensorButton: ['H5122'],
     sensorContact: ['H5123'],
     sensorPresence: ['H5127'],