@homebridge-plugins/homebridge-ewelink 12.3.3

package/lib/device/switch-single-inched.js

@@ -0,0 +1,332 @@
+import platformConsts from '../utils/constants.js'
+import { hasProperty } from '../utils/functions.js'
+
+export default class {
+  constructor(platform, accessory) {
+    // Set up variables from the platform
+    this.cusChar = platform.cusChar
+    this.eveChar = platform.eveChar
+    this.hapChar = platform.api.hap.Characteristic
+    this.hapErr = platform.api.hap.HapStatusError
+    this.hapServ = platform.api.hap.Service
+    this.lang = platform.lang
+    this.log = platform.log
+    this.platform = platform
+
+    // Set up variables from the accessory
+    this.name = accessory.displayName
+    this.accessory = accessory
+
+    // Initially set the online flag as true (to be then updated as false if necessary)
+    this.isOnline = true
+
+    /*
+    UIID 1/6/14/24/27/112/1009/1256/7004: single switch, no power readings
+    UIID 5: single switch, with wattage readings
+    UIID 32: single switch, with wattage, voltage and amp readings
+    UIID 77/78/81/107/112/138/160: single switch but firmware uses multiple channels (only need CH0)
+    UIID 182/190: single switch but multiple channels with wattage, voltage and amp readings
+    */
+
+    // Set up custom variables for this device type
+    const deviceConf = platform.deviceConf[accessory.context.eweDeviceId] || {}
+    this.inUsePowerThreshold = deviceConf.inUsePowerThreshold || platformConsts.defaultValues.inUsePowerThreshold
+
+    // Set the correct logging variables for this accessory
+    switch (deviceConf.overrideLogging) {
+      case 'standard':
+        this.enableLogging = true
+        this.enableDebugLogging = false
+        break
+      case 'debug':
+        this.enableLogging = true
+        this.enableDebugLogging = true
+        break
+      case 'disable':
+        this.enableLogging = false
+        this.enableDebugLogging = false
+        break
+      default:
+        this.enableLogging = !platform.config.disableDeviceLogging
+        this.enableDebugLogging = platform.config.debug
+        break
+    }
+
+    // If the accessory has a outlet service then remove it
+    if (this.accessory.getService(this.hapServ.Outlet)) {
+      this.accessory.removeService(this.accessory.getService(this.hapServ.Outlet))
+    }
+
+    // Add the switch service if it doesn't already exist
+    this.service = this.accessory.getService(this.hapServ.Switch)
+    || this.accessory.addService(this.hapServ.Switch)
+
+    switch (this.accessory.context.eweUIID) {
+      case 5:
+        // Add Eve power characteristics
+        this.powerReadings = true
+        if (!this.service.testCharacteristic(this.hapChar.OutletInUse)) {
+          this.service.addCharacteristic(this.hapChar.OutletInUse)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.addCharacteristic(this.eveChar.CurrentConsumption)
+        }
+
+        // Remove unused Eve characteristics
+        if (this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.ElectricCurrent),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.removeCharacteristic(this.service.getCharacteristic(this.eveChar.Voltage))
+        }
+        break
+      case 32:
+      case 182:
+      case 190:
+        // Add Eve power characteristics
+        this.powerReadings = true
+        if (!this.service.testCharacteristic(this.hapChar.OutletInUse)) {
+          this.service.addCharacteristic(this.hapChar.OutletInUse)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.addCharacteristic(this.eveChar.CurrentConsumption)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.addCharacteristic(this.eveChar.ElectricCurrent)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.addCharacteristic(this.eveChar.Voltage)
+        }
+        break
+      default:
+        // Remove unused Eve characteristics
+        if (this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.CurrentConsumption),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.ElectricCurrent),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.removeCharacteristic(this.service.getCharacteristic(this.eveChar.Voltage))
+        }
+        break
+    }
+
+    // Set a flag for devices with hardware that use multi-channel format
+    if (
+      platformConsts.devices.switchSCM.includes(this.accessory.context.eweUIID)
+      || platformConsts.devices.switchSCMPower.includes(this.accessory.context.eweUIID)
+    ) {
+      this.isSCM = true
+    }
+
+    // Add the set handler to the switch 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 a custom characteristic for inverting the switch
+    if (!this.service.testCharacteristic(this.cusChar.InvertSwitch)) {
+      this.service.addCharacteristic(this.cusChar.InvertSwitch)
+    }
+    this.service.updateCharacteristic(this.cusChar.InvertSwitch, this.cacheState === 'on')
+
+    // Add the set handler to invert the switch
+    this.service.getCharacteristic(this.cusChar.InvertSwitch).onSet((value) => {
+      this.service.updateCharacteristic(this.hapChar.On, value)
+      this.cacheState = value ? 'on' : 'off'
+      this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+    })
+
+    // Add the get handlers only if the user hasn't disabled the disableNoResponse setting
+    if (!platform.config.disableNoResponse) {
+      this.service.getCharacteristic(this.hapChar.On).onGet(() => {
+        if (!this.isOnline) {
+          throw new this.hapErr(-70402)
+        }
+        return this.service.getCharacteristic(this.hapChar.On).value
+      })
+    }
+
+    // Pass the accessory to Fakegato to set up with Eve
+    this.accessory.eveService = new platform.eveService('switch', this.accessory, {
+      log: () => {},
+    })
+
+    // Set up extra features for outlets that provide power readings
+    if (this.powerReadings) {
+      // Set up an interval to get eWeLink to send power updates
+      setTimeout(() => {
+        this.internalUIUpdate()
+        this.intervalPoll = setInterval(() => this.internalUIUpdate(), 120000)
+      }, 5000)
+
+      // Stop the intervals on Homebridge shutdown
+      platform.api.on('shutdown', () => clearInterval(this.intervalPoll))
+    }
+
+    // Output the customised options to the log
+    const normalLogging = this.enableLogging ? 'standard' : 'disable'
+    const opts = JSON.stringify({
+      inUsePowerThreshold: this.inUsePowerThreshold,
+      isInched: true,
+      logging: this.enableDebugLogging ? 'debug' : normalLogging,
+      showAs: 'default',
+    })
+    this.log('[%s] %s %s.', this.name, this.lang.devInitOpts, opts)
+  }
+
+  async internalStateUpdate(value) {
+    try {
+      const newValue = this.cacheState === 'on' ? 'off' : 'on'
+      const params = {}
+      if (this.isSCM) {
+        params.switches = [{ switch: 'on', outlet: 0 }]
+      } else {
+        params.switch = 'on'
+      }
+      this.ignoreUpdates = true
+      setTimeout(() => {
+        this.ignoreUpdates = false
+      }, 1500)
+      await this.platform.sendDeviceUpdate(this.accessory, params)
+      this.cacheState = newValue
+      this.service.updateCharacteristic(this.cusChar.InvertSwitch, value)
+      this.accessory.eveService.addEntry({ status: this.cacheState === 'on' ? 1 : 0 })
+      if (this.enableLogging) {
+        this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+      }
+    } catch (err) {
+      this.platform.deviceUpdateError(this.accessory, err, true)
+      setTimeout(() => {
+        this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+      }, 2000)
+      throw new this.hapErr(-70402)
+    }
+  }
+
+  async internalUIUpdate() {
+    try {
+      // Skip polling if device isn't online
+      if (!this.isOnline) {
+        return
+      }
+
+      // Send the params to request the updates
+      await this.platform.sendDeviceUpdate(this.accessory, { uiActive: 120 })
+    } catch (err) {
+      // Suppress errors here
+    }
+  }
+
+  async externalUpdate(params) {
+    try {
+      if (!this.isSCM && params.switch === 'on') {
+        if (!this.ignoreUpdates) {
+          this.ignoreUpdates = true
+          setTimeout(() => {
+            this.ignoreUpdates = false
+          }, 1500)
+          this.cacheState = this.cacheState === 'on' ? 'off' : 'on'
+          this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+          this.service.updateCharacteristic(this.cusChar.InvertSwitch, this.cacheState === 'on')
+          this.accessory.eveService.addEntry({ status: this.cacheState === 'on' ? 1 : 0 })
+          if (params.updateSource && this.enableLogging) {
+            this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+          }
+        }
+      }
+      if (this.isSCM && params.switches && params.switches[0].switch === 'on') {
+        if (!this.ignoreUpdates) {
+          this.ignoreUpdates = true
+          setTimeout(() => {
+            this.ignoreUpdates = false
+          }, 1500)
+          this.cacheState = this.cacheState === 'on' ? 'off' : 'on'
+          this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+          this.service.updateCharacteristic(this.cusChar.InvertSwitch, this.cacheState === 'on')
+          this.accessory.eveService.addEntry({ status: this.cacheState === 'on' ? 1 : 0 })
+          if (params.updateSource && this.enableLogging) {
+            this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+          }
+        }
+      }
+      if (!this.powerReadings) {
+        return
+      }
+      let logger = false
+      if (hasProperty(params, 'power')) {
+        this.service.updateCharacteristic(this.eveChar.CurrentConsumption, Number.parseFloat(params.power))
+        this.service.updateCharacteristic(
+          this.hapChar.OutletInUse,
+          this.cacheState === 'on' && Number.parseFloat(params.power) > this.inUsePowerThreshold,
+        )
+        logger = true
+      }
+      if (hasProperty(params, 'voltage')) {
+        this.service.updateCharacteristic(this.eveChar.Voltage, Number.parseFloat(params.voltage))
+        logger = true
+      }
+      if (hasProperty(params, 'current')) {
+        this.service.updateCharacteristic(this.eveChar.ElectricCurrent, Number.parseFloat(params.current))
+        logger = true
+      }
+      if (params.updateSource && logger && this.enableLogging) {
+        this.log(
+          '[%s] %s%s%s.',
+          this.name,
+          hasProperty(params, 'power')
+            ? `${this.lang.curPower} [${params.power}W]`
+            : '',
+          hasProperty(params, 'voltage')
+            ? ` ${this.lang.curVolt} [${params.voltage}V]`
+            : '',
+          hasProperty(params, 'current')
+            ? ` ${this.lang.curCurr} [${params.current}A]`
+            : '',
+        )
+      }
+    } catch (err) {
+      this.platform.deviceUpdateError(this.accessory, err, false)
+    }
+  }
+
+  markStatus(isOnline) {
+    this.isOnline = isOnline
+  }
+
+  async currentState() {
+    const toReturn = {}
+    toReturn.services = ['switch']
+    toReturn.switch = {
+      state: this.service.getCharacteristic(this.hapChar.On).value ? 'on' : 'off',
+    }
+    if (this.powerReadings) {
+      try {
+        toReturn.services.push('power')
+        toReturn.power = {
+          state: await this.platform.sendDeviceUpdate(this.accessory, { hundredDaysKwh: 'get' }),
+          voltage: this.service.testCharacteristic(this.eveChar.Voltage)
+            ? this.service.getCharacteristic(this.eveChar.Voltage).value
+            : undefined,
+          power: this.service.testCharacteristic(this.eveChar.CurrentConsumption)
+            ? this.service.getCharacteristic(this.eveChar.CurrentConsumption).value
+            : undefined,
+          current: this.service.testCharacteristic(this.eveChar.ElectricCurrent)
+            ? this.service.getCharacteristic(this.eveChar.ElectricCurrent).value
+            : undefined,
+        }
+      } catch (err) {
+        // Suppress errors here
+      }
+    }
+    return toReturn
+  }
+}

package/lib/device/switch-single.js

@@ -0,0 +1,307 @@
+import platformConsts from '../utils/constants.js'
+import { hasProperty } from '../utils/functions.js'
+
+export default class {
+  constructor(platform, accessory) {
+    // Set up variables from the platform
+    this.eveChar = platform.eveChar
+    this.hapChar = platform.api.hap.Characteristic
+    this.hapErr = platform.api.hap.HapStatusError
+    this.hapServ = platform.api.hap.Service
+    this.lang = platform.lang
+    this.log = platform.log
+    this.platform = platform
+
+    // Set up variables from the accessory
+    this.name = accessory.displayName
+    this.accessory = accessory
+
+    // Initially set the online flag as true (to be then updated as false if necessary)
+    this.isOnline = true
+
+    /*
+    UIID 1/6/14/24/27/112/1009/1256/7004: single switch, no power readings
+    UIID 5: single switch, with wattage readings
+    UIID 32: single switch, with wattage, voltage and amp readings
+    UIID 77/78/81/107/112/138/160: single switch but firmware uses multiple channels (only need CH0)
+    UIID 182/190: single switch but multiple channels with wattage, voltage and amp readings
+    */
+
+    // Set up custom variables for this device type
+    const deviceConf = platform.deviceConf[accessory.context.eweDeviceId] || {}
+    this.inUsePowerThreshold = deviceConf.inUsePowerThreshold || platformConsts.defaultValues.inUsePowerThreshold
+
+    // Set the correct logging variables for this accessory
+    switch (deviceConf.overrideLogging) {
+      case 'standard':
+        this.enableLogging = true
+        this.enableDebugLogging = false
+        break
+      case 'debug':
+        this.enableLogging = true
+        this.enableDebugLogging = true
+        break
+      case 'disable':
+        this.enableLogging = false
+        this.enableDebugLogging = false
+        break
+      default:
+        this.enableLogging = !platform.config.disableDeviceLogging
+        this.enableDebugLogging = platform.config.debug
+        break
+    }
+
+    // If the accessory has a outlet service then remove it
+    if (this.accessory.getService(this.hapServ.Outlet)) {
+      this.accessory.removeService(this.accessory.getService(this.hapServ.Outlet))
+    }
+
+    // Add the switch service if it doesn't already exist
+    this.service = this.accessory.getService(this.hapServ.Switch)
+    || this.accessory.addService(this.hapServ.Switch)
+
+    // Some models provide a power reading in different decimals
+    this.divisor = 1
+
+    switch (this.accessory.context.eweUIID) {
+      case 5:
+        // Add Eve power characteristics
+        this.powerReadings = true
+        if (!this.service.testCharacteristic(this.hapChar.OutletInUse)) {
+          this.service.addCharacteristic(this.hapChar.OutletInUse)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.addCharacteristic(this.eveChar.CurrentConsumption)
+        }
+
+        // Remove unused Eve characteristics
+        if (this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.ElectricCurrent),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.removeCharacteristic(this.service.getCharacteristic(this.eveChar.Voltage))
+        }
+        break
+      case 32:
+      case 182:
+      case 190:
+        // Add Eve power characteristics
+        this.powerReadings = true
+        if (!this.service.testCharacteristic(this.hapChar.OutletInUse)) {
+          this.service.addCharacteristic(this.hapChar.OutletInUse)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.addCharacteristic(this.eveChar.CurrentConsumption)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.addCharacteristic(this.eveChar.ElectricCurrent)
+        }
+        if (!this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.addCharacteristic(this.eveChar.Voltage)
+        }
+
+        if (this.accessory.context.eweUIID === 190) {
+          this.divisor = 100
+        }
+        break
+      default:
+        // Remove unused Eve characteristics
+        if (this.service.testCharacteristic(this.eveChar.CurrentConsumption)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.CurrentConsumption),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.ElectricCurrent)) {
+          this.service.removeCharacteristic(
+            this.service.getCharacteristic(this.eveChar.ElectricCurrent),
+          )
+        }
+        if (this.service.testCharacteristic(this.eveChar.Voltage)) {
+          this.service.removeCharacteristic(this.service.getCharacteristic(this.eveChar.Voltage))
+        }
+        break
+    }
+
+    // Set a flag for devices with hardware that use multi-channel format
+    if (
+      platformConsts.devices.switchSCM.includes(this.accessory.context.eweUIID)
+      || platformConsts.devices.switchSCMPower.includes(this.accessory.context.eweUIID)
+    ) {
+      this.isSCM = true
+    }
+
+    // Add the set handler to the switch on/off characteristic
+    this.service
+      .getCharacteristic(this.hapChar.On)
+      .onSet(async value => this.internalStateUpdate(value))
+
+    // Add the get handlers only if the user hasn't disabled the disableNoResponse setting
+    if (!platform.config.disableNoResponse) {
+      this.service.getCharacteristic(this.hapChar.On).onGet(() => {
+        if (!this.isOnline) {
+          throw new this.hapErr(-70402)
+        }
+        return this.service.getCharacteristic(this.hapChar.On).value
+      })
+    }
+
+    // Pass the accessory to Fakegato to set up with Eve
+    this.accessory.eveService = new platform.eveService('switch', this.accessory, {
+      log: () => {},
+    })
+
+    // Set up extra features for outlets that provide power readings
+    if (this.powerReadings) {
+      // Set up an interval to get eWeLink to send power updates
+      setTimeout(() => {
+        this.internalUIUpdate()
+        this.intervalPoll = setInterval(() => this.internalUIUpdate(), 120000)
+      }, 5000)
+
+      // Stop the intervals on Homebridge shutdown
+      platform.api.on('shutdown', () => clearInterval(this.intervalPoll))
+    }
+
+    // Output the customised options to the log
+    const normalLogging = this.enableLogging ? 'standard' : 'disable'
+    const opts = JSON.stringify({
+      inUsePowerThreshold: this.inUsePowerThreshold,
+      logging: this.enableDebugLogging ? 'debug' : normalLogging,
+      showAs: 'default',
+    })
+    this.log('[%s] %s %s.', this.name, this.lang.devInitOpts, opts)
+  }
+
+  async internalStateUpdate(value) {
+    try {
+      const newValue = value ? 'on' : 'off'
+      if (newValue === this.cacheState) {
+        return
+      }
+      const params = {}
+      if (this.isSCM) {
+        params.switches = [{ switch: newValue, outlet: 0 }]
+      } else {
+        params.switch = newValue
+      }
+      await this.platform.sendDeviceUpdate(this.accessory, params)
+      this.cacheState = newValue
+      this.accessory.eveService.addEntry({ status: value ? 1 : 0 })
+      if (this.enableLogging) {
+        this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+      }
+    } catch (err) {
+      this.platform.deviceUpdateError(this.accessory, err, true)
+      setTimeout(() => {
+        this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+      }, 2000)
+      throw new this.hapErr(-70402)
+    }
+  }
+
+  async internalUIUpdate() {
+    try {
+      // Skip polling if device isn't online
+      if (!this.isOnline) {
+        return
+      }
+
+      // Send the params to request the updates
+      await this.platform.sendDeviceUpdate(this.accessory, { uiActive: 120 })
+    } catch (err) {
+      // Suppress errors here
+    }
+  }
+
+  async externalUpdate(params) {
+    try {
+      if (!this.isSCM && params.switch && params.switch !== this.cacheState) {
+        this.cacheState = params.switch
+        this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+        this.accessory.eveService.addEntry({ status: this.cacheState === 'on' ? 1 : 0 })
+        if (params.updateSource && this.enableLogging) {
+          this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+        }
+      }
+      if (this.isSCM && params.switches && params.switches[0].switch !== this.cacheState) {
+        this.cacheState = params.switches[0].switch
+        this.service.updateCharacteristic(this.hapChar.On, this.cacheState === 'on')
+        this.accessory.eveService.addEntry({ status: this.cacheState === 'on' ? 1 : 0 })
+        if (params.updateSource && this.enableLogging) {
+          this.log('[%s] %s [%s].', this.name, this.lang.curState, this.cacheState)
+        }
+      }
+      if (!this.powerReadings) {
+        return
+      }
+      let logger = false
+      let power
+      let voltage
+      let current
+      if (hasProperty(params, 'power')) {
+        power = Math.round((Number.parseFloat(params.power) * 100) / this.divisor) / 100
+        this.service.updateCharacteristic(this.eveChar.CurrentConsumption, power)
+        this.service.updateCharacteristic(
+          this.hapChar.OutletInUse,
+          this.cacheState === 'on' && Number.parseFloat(params.power) > this.inUsePowerThreshold,
+        )
+        logger = true
+      }
+      if (hasProperty(params, 'voltage')) {
+        voltage = Math.round((Number.parseFloat(params.voltage) * 100) / this.divisor) / 100
+        this.service.updateCharacteristic(this.eveChar.Voltage, voltage)
+        logger = true
+      }
+      if (hasProperty(params, 'current')) {
+        current = Math.round((Number.parseFloat(params.current) * 100) / this.divisor) / 100
+        this.service.updateCharacteristic(this.eveChar.ElectricCurrent, current)
+        logger = true
+      }
+      if (params.updateSource && logger && this.enableLogging) {
+        this.log(
+          '[%s] %s%s%s.',
+          this.name,
+          power !== undefined ? `${this.lang.curPower} [${power}W]` : '',
+          voltage !== undefined ? ` ${this.lang.curVolt} [${voltage}V]` : '',
+          current !== undefined ? ` ${this.lang.curCurr} [${current}A]` : '',
+        )
+      }
+    } catch (err) {
+      this.platform.deviceUpdateError(this.accessory, err, false)
+    }
+  }
+
+  markStatus(isOnline) {
+    this.isOnline = isOnline
+  }
+
+  async currentState() {
+    const toReturn = {}
+    toReturn.services = ['switch']
+    toReturn.switch = {
+      state: this.service.getCharacteristic(this.hapChar.On).value ? 'on' : 'off',
+    }
+    if (this.powerReadings) {
+      try {
+        toReturn.services.push('power')
+        toReturn.power = {
+          state: await this.platform.sendDeviceUpdate(this.accessory, { hundredDaysKwh: 'get' }),
+          voltage: this.service.testCharacteristic(this.eveChar.Voltage)
+            ? this.service.getCharacteristic(this.eveChar.Voltage).value
+            : undefined,
+          power: this.service.testCharacteristic(this.eveChar.CurrentConsumption)
+            ? this.service.getCharacteristic(this.eveChar.CurrentConsumption).value
+            : undefined,
+          current: this.service.testCharacteristic(this.eveChar.ElectricCurrent)
+            ? this.service.getCharacteristic(this.eveChar.ElectricCurrent).value
+            : undefined,
+        }
+      } catch (err) {
+        // Suppress errors here
+      }
+    }
+    return toReturn
+  }
+}

package/lib/device/template.js

@@ -0,0 +1,43 @@
+export default class {
+  constructor(platform, accessory) {
+    // Set up variables from the platform
+    this.eveChar = platform.eveChar
+    this.hapChar = platform.api.hap.Characteristic
+    this.hapErr = platform.api.hap.HapStatusError
+    this.hapServ = platform.api.hap.Service
+    this.lang = platform.lang
+    this.log = platform.log
+    this.platform = platform
+
+    // Set up variables from the accessory
+    this.name = accessory.displayName
+    this.accessory = accessory
+
+    // Initially set the online flag as true (to be then updated as false if necessary)
+    this.isOnline = true
+
+    // Set the correct logging variables for this accessory
+    this.enableLogging = true
+    this.enableDebugLogging = true
+
+    // Output the customised options to the log
+    const normalLogging = this.enableLogging ? 'standard' : 'disable'
+    const opts = JSON.stringify({
+      logging: this.enableDebugLogging ? 'debug' : normalLogging,
+    })
+    this.log('[%s] %s %s.', this.name, this.lang.devInitOpts, opts)
+  }
+
+  async externalUpdate(params) {
+    try {
+      this.log.warn('New Command Received:')
+      this.log(JSON.stringify(params))
+    } catch (err) {
+      this.platform.deviceUpdateError(this.accessory, err, false)
+    }
+  }
+
+  markStatus(isOnline) {
+    this.isOnline = isOnline
+  }
+}