@homebridge-plugins/homebridge-govee 11.32.2-beta.2 → 11.32.2-beta.21

package/lib/device/humidifier-H714E.js

@@ -1,187 +0,0 @@
-import {
-  base64ToHex,
-  getTwoItemPosition,
-  hexToTwoItems,
-  parseError,
-} from '../utils/functions.js'
-import platformLang from '../utils/lang-en.js'
-
-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
-
-    // Speed codes
-    this.value2Code = {
-      1: 'MwUBAQAAAAAAAAAAAAAAAAAAADY=',
-      2: 'MwUBAgAAAAAAAAAAAAAAAAAAADU=',
-      3: 'MwUBAwAAAAAAAAAAAAAAAAAAADQ=',
-      4: 'MwUBBAAAAAAAAAAAAAAAAAAAADM=',
-      5: 'MwUBBQAAAAAAAAAAAAAAAAAAADI=',
-      6: 'MwUBBgAAAAAAAAAAAAAAAAAAADE=',
-      7: 'MwUBBwAAAAAAAAAAAAAAAAAAADA=',
-      8: 'MwUBCAAAAAAAAAAAAAAAAAAAAD8=',
-    }
-
-    // Migrate old %-rotation speed to unitless
-    const existingFanService = this.accessory.getService(this.hapServ.Fan)
-    if (existingFanService) {
-      if (existingFanService.getCharacteristic(this.hapChar.RotationSpeed).props.unit === 'percentage') {
-        this.accessory.removeService(existingFanService)
-      }
-    }
-
-    // Add the fan service if it doesn't already exist
-    this.service = this.accessory.getService(this.hapServ.Fan) || this.accessory.addService(this.hapServ.Fan)
-
-    // Add the set handler to the fan on/off characteristic
-    this.service
-      .getCharacteristic(this.hapChar.On)
-      .onSet(async value => this.internalStateUpdate(value))
-    this.cacheState = this.service.getCharacteristic(this.hapChar.On).value ? 'on' : 'off'
-
-    // Add the set handler to the fan rotation speed characteristic
-    this.service
-      .getCharacteristic(this.hapChar.RotationSpeed)
-      .setProps({
-        maxValue: 8,
-        minStep: 1,
-        minValue: 0,
-        unit: 'unitless',
-      })
-      .onSet(async value => this.internalSpeedUpdate(value))
-    this.cacheSpeed = this.service.getCharacteristic(this.hapChar.RotationSpeed).value
-
-    // Output the customised options to the log
-    const opts = JSON.stringify({})
-    platform.log('[%s] %s %s.', accessory.displayName, platformLang.devInitOpts, opts)
-  }
-
-  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
-      }
-
-      // Send the request to the platform sender function
-      await this.platform.sendDeviceUpdate(this.accessory, {
-        cmd: 'stateHumi',
-        value: value ? 1 : 0,
-      })
-
-      // Cache the new state and log if appropriate
-      this.cacheState = newValue
-      this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
-    } 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.On, this.cacheState === 'on')
-      }, 2000)
-      throw new this.hapErr(-70402)
-    }
-  }
-
-  async internalSpeedUpdate(value) {
-    try {
-      // Don't continue if the speed is 0
-      if (value === 0) {
-        return
-      }
-
-      // Don't continue if the speed value won't have effect
-      if (value === this.cacheSpeed) {
-        return
-      }
-
-      // Get the scene code for this value
-      const newCode = this.value2Code[value]
-
-      // Send the request to the platform sender function
-      await this.platform.sendDeviceUpdate(this.accessory, {
-        cmd: 'ptReal',
-        value: newCode,
-        openApi: this.accessory.context.openApiCapabilities?.workMode
-          ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: 1, modeValue: value } }
-          : undefined,
-      })
-
-      // Cache the new state and log if appropriate
-      this.cacheSpeed = value
-      this.accessory.log(`${platformLang.curSpeed} [${value}]`)
-    } 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.RotationSpeed, this.cacheSpeed)
-      }, 2000)
-      throw new this.hapErr(-70402)
-    }
-  }
-
-  externalUpdate(params) {
-    // Check for an ON/OFF change
-    if (params.state && params.state !== this.cacheState) {
-      this.cacheState = params.state
-      this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
-
-      // Log the change
-      this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
-    }
-
-    // Handle OpenAPI workMode (speed)
-    if (params.workMode) {
-      const speed = params.workMode.modeValue
-      if (speed >= 1 && speed <= 8) {
-        this.cacheSpeed = speed
-        this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSpeed)
-      }
-    }
-
-    // Check for some other scene/mode change
-    (params.commands || []).forEach((command) => {
-      const hexString = base64ToHex(command)
-      const hexParts = hexToTwoItems(hexString)
-
-      // Return now if not a device query update code
-      if (getTwoItemPosition(hexParts, 1) !== 'aa') {
-        return
-      }
-
-      const deviceFunction = `${getTwoItemPosition(hexParts, 2)}${getTwoItemPosition(hexParts, 3)}`
-
-      switch (deviceFunction) {
-        case '0501':
-        case '0502': {
-          // Speed update
-          const newSpeedRaw = getTwoItemPosition(hexParts, 4)
-          const newSpeedValue = Number.parseInt(newSpeedRaw, 16)
-          if (newSpeedValue >= 1 && newSpeedValue <= 8) {
-            if (newSpeedValue !== this.cacheSpeed) {
-              this.cacheSpeed = newSpeedValue
-              this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSpeed)
-              this.accessory.log(`${platformLang.curSpeed} [${this.cacheSpeed}]`)
-            }
-          }
-          break
-        }
-        default:
-          this.accessory.logDebugWarn(`${platformLang.newScene}: [${command}] [${hexString}]`)
-          break
-      }
-    })
-  }
-}

package/lib/device/ice-maker-H717D.js

@@ -1,218 +0,0 @@
-import { base64ToHex, getTwoItemPosition, hexToTwoItems, parseError } from '../utils/functions.js'
-import platformLang from '../utils/lang-en.js'
-
-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
-
-    // Ice size codes: small=1, medium=2, large=3 (matching OpenAPI workMode values)
-    this.sizeCodes = {
-      1: 'MwUDAAAAAAAAAAAAAAAAAAAAADU=', // small
-      2: 'MwUCAAAAAAAAAAAAAAAAAAAAADQ=', // medium
-      3: 'MwUBAAAAAAAAAAAAAAAAAAAAADc=', // large
-    }
-
-    this.sizeLabels = {
-      1: 'small',
-      2: 'medium',
-      3: 'large',
-    }
-
-    // Remove old switch service if migrating
-    if (this.accessory.getService(this.hapServ.Switch)) {
-      this.accessory.removeService(this.accessory.getService(this.hapServ.Switch))
-    }
-
-    // Add the fan service for ice size control
-    this.service = this.accessory.getService(this.hapServ.Fanv2)
-      || this.accessory.addService(this.hapServ.Fanv2)
-
-    // Add the set handler to the on/off characteristic
-    this.service.getCharacteristic(this.hapChar.Active).onSet(async (value) => {
-      await this.internalStateUpdate(value)
-    })
-    this.cacheState = this.service.getCharacteristic(this.hapChar.Active).value === 1 ? 'on' : 'off'
-
-    // Add the set handler to the rotation speed characteristic (ice size)
-    this.service
-      .getCharacteristic(this.hapChar.RotationSpeed)
-      .setProps({
-        maxValue: 3,
-        minStep: 1,
-        minValue: 0,
-        unit: 'unitless',
-      })
-      .onSet(async value => this.internalSizeUpdate(value))
-    this.cacheSize = this.service.getCharacteristic(this.hapChar.RotationSpeed).value || 2
-
-    // Keep the characteristic in step with the cache. Without this an accessory
-    // that has never had a size set reports Active=1 with RotationSpeed=0, which
-    // is contradictory and which the Home app renders as "0".
-    if (this.service.getCharacteristic(this.hapChar.RotationSpeed).value !== this.cacheSize) {
-      this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-    }
-
-    // Output the customised options to the log
-    const opts = JSON.stringify({})
-    platform.log('[%s] %s %s.', accessory.displayName, platformLang.devInitOpts, opts)
-  }
-
-  async internalStateUpdate(value) {
-    try {
-      const newState = value ? 'on' : 'off'
-
-      // Don't continue if the new value is the same as before
-      if (newState === this.cacheState) {
-        return
-      }
-
-      if (value) {
-        // Turn on with current cached ice size
-        await this.platform.sendDeviceUpdate(this.accessory, {
-          cmd: 'ptReal',
-          value: this.sizeCodes[this.cacheSize],
-          openApi: this.accessory.context.openApiCapabilities?.workMode
-            ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: this.cacheSize, modeValue: 0 } }
-            : undefined,
-        })
-      } else {
-        // Turn off
-        await this.platform.sendDeviceUpdate(this.accessory, {
-          cmd: 'ptReal',
-          value: 'MxkAAAAAAAAAAAAAAAAAAAAAACo=',
-          openApi: this.accessory.context.openApiCapabilities?.workMode
-            ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: 0, modeValue: 0 } }
-            : undefined,
-        })
-      }
-
-      // Cache the new state and log if appropriate
-      if (this.cacheState !== newState) {
-        this.cacheState = newState
-        this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
-      }
-    } 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 internalSizeUpdate(value) {
-    try {
-      // 0 is not a valid ice size. Put the slider back, otherwise HomeKit keeps 0
-      // while the device carries on at cacheSize - and that 0 is what gets written
-      // to the accessory cache, so it returns on the next restart. Deferred for the
-      // same reason as the error reverts below: an immediate update would be
-      // overwritten by the value HomeKit is currently writing.
-      if (value === 0) {
-        setTimeout(() => {
-          this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-        }, 1000)
-        return
-      }
-
-      // Don't continue if the new value is the same as before
-      if (value === this.cacheSize) {
-        return
-      }
-
-      await this.platform.sendDeviceUpdate(this.accessory, {
-        cmd: 'ptReal',
-        value: this.sizeCodes[value],
-        openApi: this.accessory.context.openApiCapabilities?.workMode
-          ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: value, modeValue: 0 } }
-          : undefined,
-      })
-
-      // Cache the new state and log if appropriate
-      this.cacheSize = value
-      this.cacheState = 'on'
-      this.service.updateCharacteristic(this.hapChar.Active, 1)
-      this.accessory.log(`${platformLang.curSpeed} [${this.sizeLabels[value]}]`)
-    } 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.RotationSpeed, this.cacheSize)
-      }, 2000)
-      throw new this.hapErr(-70402)
-    }
-  }
-
-  externalUpdate(params) {
-    // Handle OpenAPI workMode
-    if (params.workMode) {
-      const mode = params.workMode.workMode
-      if (mode > 0 && mode <= 3) {
-        if (this.cacheState !== 'on') {
-          this.cacheState = 'on'
-          this.service.updateCharacteristic(this.hapChar.Active, 1)
-          this.accessory.log(`${platformLang.curState} [on]`)
-        }
-        if (this.cacheSize !== mode) {
-          this.cacheSize = mode
-          this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-          this.accessory.log(`${platformLang.curSpeed} [${this.sizeLabels[this.cacheSize]}]`)
-        }
-      } else if (mode === 0) {
-        if (this.cacheState !== 'off') {
-          this.cacheState = 'off'
-          this.service.updateCharacteristic(this.hapChar.Active, 0)
-          this.accessory.log(`${platformLang.curState} [off]`)
-        }
-      }
-    }
-
-    // Check for some other scene/mode change
-    (params.commands || []).forEach((command) => {
-      const hexString = base64ToHex(command)
-      const hexParts = hexToTwoItems(hexString)
-
-      // Return now if not a device query update code
-      if (getTwoItemPosition(hexParts, 1) !== 'aa') {
-        return
-      }
-
-      const deviceFunction = `${getTwoItemPosition(hexParts, 1)}${getTwoItemPosition(hexParts, 2)}`
-
-      switch (deviceFunction) {
-        case 'aa19': {
-          // On/Off
-          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}]`)
-          }
-          break
-        }
-        case 'aa05': {
-          // Ice size report. The payload encoding is deliberately NOT decoded here:
-          // sizeCodes runs small=0x03..large=0x01 while the OpenAPI path sends
-          // workMode un-inverted, and which is authoritative is unresolved (#1329).
-          // Claiming a mapping here could silently swap sizes, so this case exists
-          // only to stop a routine status report being logged as a new scene code.
-          break
-        }
-        default:
-          this.accessory.logWarn(`${platformLang.newScene}: [${command}] [${hexString}]`)
-          break
-      }
-    })
-  }
-}

package/lib/device/ice-maker-H8120.js

@@ -1,218 +0,0 @@
-import { base64ToHex, getTwoItemPosition, hexToTwoItems, parseError } from '../utils/functions.js'
-import platformLang from '../utils/lang-en.js'
-
-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
-
-    // Ice size codes: small=1, medium=2, large=3 (matching OpenAPI workMode values)
-    this.sizeCodes = {
-      1: 'MwUDAAAAAAAAAAAAAAAAAAAAADU=', // small
-      2: 'MwUCAAAAAAAAAAAAAAAAAAAAADQ=', // medium
-      3: 'MwUBAAAAAAAAAAAAAAAAAAAAADc=', // large
-    }
-
-    this.sizeLabels = {
-      1: 'small',
-      2: 'medium',
-      3: 'large',
-    }
-
-    // Remove old switch service if migrating
-    if (this.accessory.getService(this.hapServ.Switch)) {
-      this.accessory.removeService(this.accessory.getService(this.hapServ.Switch))
-    }
-
-    // Add the fan service for ice size control
-    this.service = this.accessory.getService(this.hapServ.Fanv2)
-      || this.accessory.addService(this.hapServ.Fanv2)
-
-    // Add the set handler to the on/off characteristic
-    this.service.getCharacteristic(this.hapChar.Active).onSet(async (value) => {
-      await this.internalStateUpdate(value)
-    })
-    this.cacheState = this.service.getCharacteristic(this.hapChar.Active).value === 1 ? 'on' : 'off'
-
-    // Add the set handler to the rotation speed characteristic (ice size)
-    this.service
-      .getCharacteristic(this.hapChar.RotationSpeed)
-      .setProps({
-        maxValue: 3,
-        minStep: 1,
-        minValue: 0,
-        unit: 'unitless',
-      })
-      .onSet(async value => this.internalSizeUpdate(value))
-    this.cacheSize = this.service.getCharacteristic(this.hapChar.RotationSpeed).value || 2
-
-    // Keep the characteristic in step with the cache. Without this an accessory
-    // that has never had a size set reports Active=1 with RotationSpeed=0, which
-    // is contradictory and which the Home app renders as "0".
-    if (this.service.getCharacteristic(this.hapChar.RotationSpeed).value !== this.cacheSize) {
-      this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-    }
-
-    // Output the customised options to the log
-    const opts = JSON.stringify({})
-    platform.log('[%s] %s %s.', accessory.displayName, platformLang.devInitOpts, opts)
-  }
-
-  async internalStateUpdate(value) {
-    try {
-      const newState = value ? 'on' : 'off'
-
-      // Don't continue if the new value is the same as before
-      if (newState === this.cacheState) {
-        return
-      }
-
-      if (value) {
-        // Turn on with current cached ice size
-        await this.platform.sendDeviceUpdate(this.accessory, {
-          cmd: 'ptReal',
-          value: this.sizeCodes[this.cacheSize],
-          openApi: this.accessory.context.openApiCapabilities?.workMode
-            ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: this.cacheSize, modeValue: 0 } }
-            : undefined,
-        })
-      } else {
-        // Turn off
-        await this.platform.sendDeviceUpdate(this.accessory, {
-          cmd: 'ptReal',
-          value: 'MxkAAAAAAAAAAAAAAAAAAAAAACo=',
-          openApi: this.accessory.context.openApiCapabilities?.workMode
-            ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: 0, modeValue: 0 } }
-            : undefined,
-        })
-      }
-
-      // Cache the new state and log if appropriate
-      if (this.cacheState !== newState) {
-        this.cacheState = newState
-        this.accessory.log(`${platformLang.curState} [${this.cacheState}]`)
-      }
-    } 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 internalSizeUpdate(value) {
-    try {
-      // 0 is not a valid ice size. Put the slider back, otherwise HomeKit keeps 0
-      // while the device carries on at cacheSize - and that 0 is what gets written
-      // to the accessory cache, so it returns on the next restart. Deferred for the
-      // same reason as the error reverts below: an immediate update would be
-      // overwritten by the value HomeKit is currently writing.
-      if (value === 0) {
-        setTimeout(() => {
-          this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-        }, 1000)
-        return
-      }
-
-      // Don't continue if the new value is the same as before
-      if (value === this.cacheSize) {
-        return
-      }
-
-      await this.platform.sendDeviceUpdate(this.accessory, {
-        cmd: 'ptReal',
-        value: this.sizeCodes[value],
-        openApi: this.accessory.context.openApiCapabilities?.workMode
-          ? { instance: 'workMode', capabilityType: 'devices.capabilities.work_mode', value: { workMode: value, modeValue: 0 } }
-          : undefined,
-      })
-
-      // Cache the new state and log if appropriate
-      this.cacheSize = value
-      this.cacheState = 'on'
-      this.service.updateCharacteristic(this.hapChar.Active, 1)
-      this.accessory.log(`${platformLang.curSpeed} [${this.sizeLabels[value]}]`)
-    } 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.RotationSpeed, this.cacheSize)
-      }, 2000)
-      throw new this.hapErr(-70402)
-    }
-  }
-
-  externalUpdate(params) {
-    // Handle OpenAPI workMode
-    if (params.workMode) {
-      const mode = params.workMode.workMode
-      if (mode > 0 && mode <= 3) {
-        if (this.cacheState !== 'on') {
-          this.cacheState = 'on'
-          this.service.updateCharacteristic(this.hapChar.Active, 1)
-          this.accessory.log(`${platformLang.curState} [on]`)
-        }
-        if (this.cacheSize !== mode) {
-          this.cacheSize = mode
-          this.service.updateCharacteristic(this.hapChar.RotationSpeed, this.cacheSize)
-          this.accessory.log(`${platformLang.curSpeed} [${this.sizeLabels[this.cacheSize]}]`)
-        }
-      } else if (mode === 0) {
-        if (this.cacheState !== 'off') {
-          this.cacheState = 'off'
-          this.service.updateCharacteristic(this.hapChar.Active, 0)
-          this.accessory.log(`${platformLang.curState} [off]`)
-        }
-      }
-    }
-
-    // Check for some other scene/mode change
-    (params.commands || []).forEach((command) => {
-      const hexString = base64ToHex(command)
-      const hexParts = hexToTwoItems(hexString)
-
-      // Return now if not a device query update code
-      if (getTwoItemPosition(hexParts, 1) !== 'aa') {
-        return
-      }
-
-      const deviceFunction = `${getTwoItemPosition(hexParts, 1)}${getTwoItemPosition(hexParts, 2)}`
-
-      switch (deviceFunction) {
-        case 'aa19': {
-          // On/Off
-          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}]`)
-          }
-          break
-        }
-        case 'aa05': {
-          // Ice size report. The payload encoding is deliberately NOT decoded here:
-          // sizeCodes runs small=0x03..large=0x01 while the OpenAPI path sends
-          // workMode un-inverted, and which is authoritative is unresolved (#1329).
-          // Claiming a mapping here could silently swap sizes, so this case exists
-          // only to stop a routine status report being logged as a new scene code.
-          break
-        }
-        default:
-          this.accessory.logWarn(`${platformLang.newScene}: [${command}] [${hexString}]`)
-          break
-      }
-    })
-  }
-}