@homebridge-plugins/homebridge-firstalert 0.0.1-beta.0

package/src/devices/device.ts

@@ -0,0 +1,226 @@
+// Static regexes for version parsing (for lint rule e18e/prefer-static-regex)
+/* Copyright(C) 2022-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * device.ts: homebridge-firstalert.
+ */
+import type { API, HAP, Logging, PlatformAccessory } from 'homebridge'
+
+import type { ResideoDevice } from '../api/resideoClient.js'
+import type { ResideoPlatform } from '../platform.js'
+import type { ResideoPlatformConfig } from '../settings.js'
+
+export abstract class deviceBase {
+  public readonly api: API
+  public readonly log: Logging
+  public readonly config!: ResideoPlatformConfig
+  protected readonly hap: HAP
+
+  // Config
+  protected deviceLogging!: string
+  protected deviceRefreshRate!: number
+  protected deviceUpdateRate!: number
+  protected devicePushRate!: number
+  protected deviceFirmwareVersion!: string
+  protected deviceMaxRetries!: number
+  protected deviceDelayBetweenRetries!: number
+
+  constructor(
+    protected readonly platform: ResideoPlatform,
+    protected accessory: PlatformAccessory,
+    protected device: ResideoDevice,
+  ) {
+    this.api = (platform as any).api
+    this.log = (platform as any).log
+    this.config = (platform as any).config as ResideoPlatformConfig
+    this.hap = (platform as any).api.hap
+
+    this.getDeviceLogSettings()
+    this.getDeviceRateSettings()
+    this.getDeviceConfigSettings(device)
+    this.getDeviceContext(accessory, device)
+
+    // Set accessory information
+    accessory
+      .getService(this.hap.Service.AccessoryInformation)!
+      .setCharacteristic(this.hap.Characteristic.Manufacturer, 'FirstAlert')
+      .setCharacteristic(this.hap.Characteristic.Name, accessory.displayName)
+      .setCharacteristic(this.hap.Characteristic.ConfiguredName, accessory.displayName)
+      .setCharacteristic(this.hap.Characteristic.Model, accessory.context.model)
+      .setCharacteristic(this.hap.Characteristic.SerialNumber, accessory.context.deviceID)
+      .setCharacteristic(this.hap.Characteristic.FirmwareRevision, this.deviceFirmwareVersion)
+      .getCharacteristic(this.hap.Characteristic.FirmwareRevision)
+      .updateValue(this.deviceFirmwareVersion)
+  }
+
+  async getDeviceLogSettings(): Promise<void> {
+    this.deviceLogging = 'standard'
+    await this.debugLog(`Using Device Logging: ${this.deviceLogging}`)
+  }
+
+  async getDeviceRateSettings(): Promise<void> {
+    // Use default values; ResideoDevice does not have these properties
+    this.deviceRefreshRate = 120
+    this.deviceUpdateRate = 5
+    this.devicePushRate = 0.1
+    await this.debugLog(`Using refreshRate: ${this.deviceRefreshRate}, updateRate: ${this.deviceUpdateRate}, pushRate: ${this.devicePushRate}`)
+    this.deviceMaxRetries = 5
+    await this.debugLog(`Using maxRetries: ${this.deviceMaxRetries}`)
+    this.deviceDelayBetweenRetries = 3 * 1000
+    await this.debugLog(`Using delayBetweenRetries: ${this.deviceDelayBetweenRetries}`)
+  }
+
+  async getDeviceConfigSettings(device: ResideoDevice): Promise<void> {
+    // No config merging; ResideoDevice does not have these properties
+    this.debugSuccessLog(`Config: ${JSON.stringify(device)}`)
+  }
+
+  async getDeviceContext(accessory: PlatformAccessory, device: ResideoDevice): Promise<void> {
+    // Context Information
+    accessory.context.model = device.globalDeviceType
+    accessory.context.deviceID = device.deviceId
+    accessory.context.deviceType = device.globalDeviceType
+    // FirmwareRevision
+    const version = '0.0.0'
+    this.deviceFirmwareVersion = version
+    accessory
+      .getService(this.hap.Service.AccessoryInformation)!
+      .setCharacteristic(this.hap.Characteristic.HardwareRevision, this.deviceFirmwareVersion)
+      .setCharacteristic(this.hap.Characteristic.SoftwareRevision, this.deviceFirmwareVersion)
+      .setCharacteristic(this.hap.Characteristic.FirmwareRevision, this.deviceFirmwareVersion)
+      .getCharacteristic(this.hap.Characteristic.FirmwareRevision)
+      .updateValue(this.deviceFirmwareVersion)
+    this.debugSuccessLog(`deviceFirmwareVersion: ${this.deviceFirmwareVersion}`)
+  }
+
+  async statusCode(statusCode: number, action: string): Promise<void> {
+    switch (statusCode) {
+      case 200:
+        this.debugLog(`${this.device.name}: ${this.accessory.displayName} Standard Response, statusCode: ${statusCode}, Action: ${action}`)
+        break
+      case 400:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Bad Request, statusCode: ${statusCode}, Action: ${action}`)
+        break
+      case 401:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Unauthorized, statusCode: ${statusCode}, Action: ${action}`)
+        break
+      case 403:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Forbidden, The request has been authenticated but does not have appropriate permissions, or a requested resource is not found, statusCode: ${statusCode}`)
+        break
+      case 404:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Not Found, statusCode: ${statusCode}, Action: ${action}`)
+        break
+      case 429:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Too Many Requests, statusCode: ${statusCode}, Action: ${action}`)
+        break
+      case 500:
+        this.errorLog(`${this.device.name}: ${this.accessory.displayName} Internal Server Error (Meater Server), statusCode: ${statusCode}, Action: ${action}`)
+        break
+      default:
+        this.infoLog(`${this.device.name}: ${this.accessory.displayName} Unknown statusCode: ${statusCode}, Action: ${action}, Report Bugs Here: https://bit.ly/homebridge-firstalert-bug-report`)
+    }
+  }
+
+  async resideoAPIError(e: any, action: string): Promise<void> {
+    if (e.message.includes('400')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Bad Request`)
+      this.debugLog('The client has issued an invalid request. This is commonly used to specify validation errors in a request payload.')
+    } else if (e.message.includes('401')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Unauthorized Request`)
+      this.debugLog('Authorization for the API is required, but the request has not been authenticated.')
+    } else if (e.message.includes('403')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Forbidden Request`)
+      this.debugLog('The request has been authenticated but does not have appropriate permissions, or a requested resource is not found.')
+    } else if (e.message.includes('404')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Requst Not Found`)
+      this.debugLog('Specifies the requested path does not exist.')
+    } else if (e.message.includes('406')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Request Not Acceptable`)
+      this.debugLog('The client has requested a MIME type via the Accept header for a value not supported by the server.')
+    } else if (e.message.includes('415')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Unsupported Requst Header`)
+      this.debugLog('The client has defined a contentType header that is not supported by the server.')
+    } else if (e.message.includes('422')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Unprocessable Entity`)
+      this.debugLog(
+        'The client has made a valid request, but the server cannot process it.'
+        + ' This is often used for APIs for which certain limits have been exceeded.',
+      )
+    } else if (e.message.includes('429')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Too Many Requests`)
+      this.debugLog('The client has exceeded the number of requests allowed for a given time window.')
+    } else if (e.message.includes('500')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action}, Internal Server Error`)
+      this.debugLog('An unexpected error on the SmartThings servers has occurred. These errors should be rare.')
+    } else {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to ${action},`)
+    }
+    if (this.deviceLogging.includes('debug')) {
+      this.errorLog(`${this.device.name}: ${this.accessory.displayName} failed to pushChanges, Error Message: ${JSON.stringify(e.message)}`)
+    }
+  }
+
+  /**
+   * Logging for Device
+   */
+  async infoLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      this.log.info(`${this.device.name}: ${this.accessory.displayName}`, String(...log))
+    }
+  }
+
+  async successLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      this.log.success(`${this.device.name}: ${this.accessory.displayName}`, String(...log))
+    }
+  }
+
+  async debugSuccessLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      if (this.deviceLogging?.includes('debug')) {
+        this.log.success(`[DEBUG] ${this.device.name}: ${this.accessory.displayName}`, String(...log))
+      }
+    }
+  }
+
+  async warnLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      this.log.warn(`${this.device.name}: ${this.accessory.displayName}`, String(...log))
+    }
+  }
+
+  async debugWarnLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      if (this.deviceLogging?.includes('debug')) {
+        this.log.warn(`[DEBUG] ${this.device.name}: ${this.accessory.displayName}`, String(...log))
+      }
+    }
+  }
+
+  async errorLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      this.log.error(`${this.device.name}: ${this.accessory.displayName}`, String(...log))
+    }
+  }
+
+  async debugErrorLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      if (this.deviceLogging?.includes('debug')) {
+        this.log.error(`[DEBUG] ${this.device.name}: ${this.accessory.displayName}`, String(...log))
+      }
+    }
+  }
+
+  async debugLog(...log: any[]): Promise<void> {
+    if (await this.enablingDeviceLogging()) {
+      if (this.deviceLogging === 'debug') {
+        this.log.info(`[DEBUG] ${this.device.name}: ${this.accessory.displayName}`, String(...log))
+      } else {
+        this.log.debug(`${this.device.name}: ${this.accessory.displayName}`, String(...log))
+      }
+    }
+  }
+
+  async enablingDeviceLogging(): Promise<boolean> {
+    return this.deviceLogging.includes('debug') ?? this.deviceLogging === 'standard'
+  }
+}

package/src/devices/leaksensors.ts

@@ -0,0 +1,206 @@
+/* Copyright(C) 2022-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * leaksensors.ts: homebridge-firstalert.
+ */
+import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
+import { interval, Subject } from 'rxjs'
+import { skipWhile } from 'rxjs/operators'
+
+import type { ResideoDevice } from '../api/resideoClient.js'
+import type { ResideoPlatform } from '../platform.js'
+import { deviceBase } from './device.js'
+
+/**
+ * Platform Accessory
+ * An instance of this class is created for each accessory your platform registers
+ * Each accessory may expose multiple services of different service types.
+ */
+export class LeakSensor extends deviceBase {
+  // Services
+  private Battery: {
+    Name: CharacteristicValue
+    Service: Service
+    BatteryLevel: CharacteristicValue
+    ChargingState: CharacteristicValue
+    StatusLowBattery: CharacteristicValue
+  }
+
+  private LeakSensor?: {
+    Name: CharacteristicValue
+    Service: Service
+    StatusActive: CharacteristicValue
+    LeakDetected: CharacteristicValue
+  }
+
+  private HumiditySensor?: {
+    Name: CharacteristicValue
+    Service: Service
+    CurrentRelativeHumidity: CharacteristicValue
+  }
+
+  private TemperatureSensor?: {
+    Name: CharacteristicValue
+    Service: Service
+    CurrentTemperature: CharacteristicValue
+  }
+
+  // Sensor Update
+  SensorUpdateInProgress!: boolean
+  doSensorUpdate!: Subject<void>
+
+  constructor(
+    readonly platform: ResideoPlatform,
+    accessory: PlatformAccessory,
+    device: ResideoDevice,
+  ) {
+    super(platform, accessory, device)
+
+    this.doSensorUpdate = new Subject()
+    this.SensorUpdateInProgress = false
+
+    // Initialize Battery Service
+    accessory.context.Battery = accessory.context.Battery ?? {}
+    this.Battery = {
+      Name: accessory.context.Battery.Name ?? `${accessory.displayName} Battery`,
+      Service: accessory.getService(this.hap.Service.Battery) ?? accessory.addService(this.hap.Service.Battery) as Service,
+      BatteryLevel: accessory.context.BatteryLevel ?? 100,
+      ChargingState: accessory.context.ChargingState ?? this.hap.Characteristic.ChargingState.NOT_CHARGEABLE,
+      StatusLowBattery: accessory.context.StatusLowBattery ?? this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL,
+    }
+    accessory.context.Battery = this.Battery as object
+    this.Battery.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.Battery.Name)
+      .setCharacteristic(this.hap.Characteristic.ChargingState, this.hap.Characteristic.ChargingState.NOT_CHARGEABLE)
+      .getCharacteristic(this.hap.Characteristic.BatteryLevel)
+      .onGet(() => this.Battery.BatteryLevel)
+
+    // Leak Sensor Service
+    accessory.context.LeakSensor = accessory.context.LeakSensor ?? {}
+    this.LeakSensor = {
+      Name: accessory.context.LeakSensor.Name ?? `${accessory.displayName} Leak Sensor`,
+      Service: accessory.getService(this.hap.Service.LeakSensor) ?? accessory.addService(this.hap.Service.LeakSensor) as Service,
+      StatusActive: accessory.context.StatusActive ?? false,
+      LeakDetected: accessory.context.LeakDetected ?? this.hap.Characteristic.LeakDetected.LEAK_NOT_DETECTED,
+    }
+    accessory.context.LeakSensor = this.LeakSensor as object
+    this.LeakSensor.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.LeakSensor.Name)
+      .getCharacteristic(this.hap.Characteristic.StatusActive)
+      .onGet(() => this.LeakSensor!.StatusActive)
+    this.LeakSensor.Service
+      .getCharacteristic(this.hap.Characteristic.LeakDetected)
+      .onGet(() => this.LeakSensor!.LeakDetected)
+
+    // Temperature Sensor Service
+    accessory.context.TemperatureSensor = accessory.context.TemperatureSensor ?? {}
+    this.TemperatureSensor = {
+      Name: accessory.context.TemperatureSensor.Name ?? `${accessory.displayName} Temperature Sensor`,
+      Service: accessory.getService(this.hap.Service.TemperatureSensor) ?? accessory.addService(this.hap.Service.TemperatureSensor) as Service,
+      CurrentTemperature: accessory.context.CurrentTemperature ?? 20,
+    }
+    accessory.context.TemperatureSensor = this.TemperatureSensor as object
+    this.TemperatureSensor.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.TemperatureSensor.Name)
+      .getCharacteristic(this.hap.Characteristic.CurrentTemperature)
+      .setProps({
+        minValue: -273.15,
+        maxValue: 100,
+        minStep: 0.1,
+      })
+      .onGet(() => this.TemperatureSensor!.CurrentTemperature)
+
+    // Humidity Sensor Service
+    accessory.context.HumiditySensor = accessory.context.HumiditySensor ?? {}
+    this.HumiditySensor = {
+      Name: accessory.context.HumiditySensor.Name ?? `${accessory.displayName} Humidity Sensor`,
+      Service: accessory.getService(this.hap.Service.HumiditySensor) ?? accessory.addService(this.hap.Service.HumiditySensor) as Service,
+      CurrentRelativeHumidity: accessory.context.CurrentRelativeHumidity ?? 50,
+    }
+    accessory.context.HumiditySensor = this.HumiditySensor as object
+    this.HumiditySensor.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.HumiditySensor.Name)
+    this.HumiditySensor.Service
+      .getCharacteristic(this.hap.Characteristic.CurrentRelativeHumidity)
+      .setProps({ minStep: 0.1 })
+      .onGet(() => this.HumiditySensor!.CurrentRelativeHumidity)
+
+    // Initial refresh
+    this.refreshStatus()
+    this.updateHomeKitCharacteristics()
+    interval(120 * 1000)
+      .pipe(skipWhile(() => this.SensorUpdateInProgress))
+      .subscribe(async () => {
+        await this.refreshStatus()
+      })
+  }
+
+  /**
+   * Parse the device status from the FirstAlert api
+   */
+  async parseStatus(): Promise<void> {
+    // Example: parse state from API response (simulate for now)
+    // In a real implementation, fetch and parse state from the API
+    // For now, just set some dummy values
+    this.Battery.BatteryLevel = 100
+    this.Battery.StatusLowBattery = this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL
+    if (this.LeakSensor) {
+      this.LeakSensor.StatusActive = true
+      this.LeakSensor.LeakDetected = this.hap.Characteristic.LeakDetected.LEAK_NOT_DETECTED
+    }
+    if (this.TemperatureSensor) {
+      this.TemperatureSensor.CurrentTemperature = 20
+    }
+    if (this.HumiditySensor) {
+      this.HumiditySensor.CurrentRelativeHumidity = 50
+    }
+  }
+
+  /**
+   * Asks the FirstAlert Home API for the latest device information
+   */
+  async refreshStatus(): Promise<void> {
+    try {
+      const deviceId = String(this.device.deviceId)
+      await this.platform.client.getDeviceState(deviceId)
+      // In a real implementation, parse deviceState and update class state
+      await this.parseStatus()
+      await this.updateHomeKitCharacteristics()
+    } catch (e: any) {
+      const action = 'refreshStatus'
+      this.resideoAPIError(e, action)
+    }
+  }
+
+  /**
+   * Updates the status for each of the HomeKit Characteristics
+   */
+  async updateHomeKitCharacteristics(): Promise<void> {
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.BatteryLevel, this.Battery.BatteryLevel)
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.StatusLowBattery, this.Battery.StatusLowBattery)
+    if (this.LeakSensor) {
+      this.LeakSensor.Service.updateCharacteristic(this.hap.Characteristic.LeakDetected, this.LeakSensor.LeakDetected)
+      this.LeakSensor.Service.updateCharacteristic(this.hap.Characteristic.StatusActive, this.LeakSensor.StatusActive)
+    }
+    if (this.TemperatureSensor) {
+      this.TemperatureSensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentTemperature, this.TemperatureSensor.CurrentTemperature)
+    }
+    if (this.HumiditySensor) {
+      this.HumiditySensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentRelativeHumidity, this.HumiditySensor.CurrentRelativeHumidity)
+    }
+  }
+
+  async apiError(e: any): Promise<void> {
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.BatteryLevel, e)
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.StatusLowBattery, e)
+    if (this.LeakSensor) {
+      this.LeakSensor.Service.updateCharacteristic(this.hap.Characteristic.LeakDetected, e)
+      this.LeakSensor.Service.updateCharacteristic(this.hap.Characteristic.StatusActive, e)
+    }
+    if (this.TemperatureSensor) {
+      this.TemperatureSensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentTemperature, e)
+    }
+    if (this.HumiditySensor) {
+      this.HumiditySensor.Service.updateCharacteristic(this.hap.Characteristic.CurrentRelativeHumidity, e)
+    }
+  }
+}

package/src/devices/smoke.ts

@@ -0,0 +1,173 @@
+/* Copyright(C) 2022-2024, donavanbecker (https://github.com/donavanbecker). All rights reserved.
+ *
+ * smoke.ts: homebridge-firstalert.
+ */
+import type { CharacteristicValue, PlatformAccessory, Service } from 'homebridge'
+import { interval, Subject } from 'rxjs'
+import { skipWhile } from 'rxjs/operators'
+
+import type { ResideoDevice } from '../api/resideoClient.js'
+import type { ResideoPlatform } from '../platform.js'
+import { deviceBase } from './device.js'
+
+/**
+ * HomeKit Smoke/CO/CO2 Sensor Accessory
+ */
+export class SmokeSensor extends deviceBase {
+  // Services
+  private SmokeSensor: { Name: CharacteristicValue, Service: Service, SmokeDetected: CharacteristicValue }
+  private CarbonMonoxideSensor?: { Name: CharacteristicValue, Service: Service, CarbonMonoxideDetected: CharacteristicValue }
+  private CarbonDioxideSensor?: { Name: CharacteristicValue, Service: Service, CarbonDioxideDetected: CharacteristicValue }
+  private Battery: { Name: CharacteristicValue, Service: Service, BatteryLevel: CharacteristicValue, ChargingState: CharacteristicValue, StatusLowBattery: CharacteristicValue }
+
+  // Update
+  SensorUpdateInProgress!: boolean
+  doSensorUpdate!: Subject<void>
+
+  constructor(
+    readonly platform: ResideoPlatform,
+    accessory: PlatformAccessory,
+    device: ResideoDevice,
+  ) {
+    super(platform, accessory, device)
+    this.doSensorUpdate = new Subject()
+    this.SensorUpdateInProgress = false
+
+    // Battery Service
+    accessory.context.Battery = accessory.context.Battery ?? {}
+    this.Battery = {
+      Name: accessory.context.Battery.Name ?? `${accessory.displayName} Battery`,
+      Service: accessory.getService(this.hap.Service.Battery) ?? accessory.addService(this.hap.Service.Battery) as Service,
+      BatteryLevel: accessory.context.BatteryLevel ?? 100,
+      ChargingState: accessory.context.ChargingState ?? this.hap.Characteristic.ChargingState.NOT_CHARGEABLE,
+      StatusLowBattery: accessory.context.StatusLowBattery ?? this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL,
+    }
+    accessory.context.Battery = this.Battery as object
+    this.Battery.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.Battery.Name)
+      .setCharacteristic(this.hap.Characteristic.ChargingState, this.hap.Characteristic.ChargingState.NOT_CHARGEABLE)
+      .getCharacteristic(this.hap.Characteristic.BatteryLevel)
+      .onGet(() => this.Battery.BatteryLevel)
+
+    // Smoke Sensor Service
+    accessory.context.SmokeSensor = accessory.context.SmokeSensor ?? {}
+    this.SmokeSensor = {
+      Name: accessory.context.SmokeSensor.Name ?? `${accessory.displayName} Smoke Sensor`,
+      Service: accessory.getService(this.hap.Service.SmokeSensor) ?? accessory.addService(this.hap.Service.SmokeSensor) as Service,
+      SmokeDetected: accessory.context.SmokeDetected ?? this.hap.Characteristic.SmokeDetected.SMOKE_NOT_DETECTED,
+    }
+    accessory.context.SmokeSensor = this.SmokeSensor as object
+    this.SmokeSensor.Service
+      .setCharacteristic(this.hap.Characteristic.Name, this.SmokeSensor.Name)
+      .getCharacteristic(this.hap.Characteristic.SmokeDetected)
+      .onGet(() => this.SmokeSensor.SmokeDetected)
+
+    // Carbon Monoxide Sensor Service (optional)
+    if (device.globalDeviceType?.toLowerCase().includes('co')) {
+      accessory.context.CarbonMonoxideSensor = accessory.context.CarbonMonoxideSensor ?? {}
+      this.CarbonMonoxideSensor = {
+        Name: accessory.context.CarbonMonoxideSensor.Name ?? `${accessory.displayName} CO Sensor`,
+        Service: accessory.getService(this.hap.Service.CarbonMonoxideSensor) ?? accessory.addService(this.hap.Service.CarbonMonoxideSensor) as Service,
+        CarbonMonoxideDetected: accessory.context.CarbonMonoxideDetected ?? this.hap.Characteristic.CarbonMonoxideDetected.CO_LEVELS_NORMAL,
+      }
+      accessory.context.CarbonMonoxideSensor = this.CarbonMonoxideSensor as object
+      this.CarbonMonoxideSensor.Service
+        .setCharacteristic(this.hap.Characteristic.Name, this.CarbonMonoxideSensor.Name)
+        .getCharacteristic(this.hap.Characteristic.CarbonMonoxideDetected)
+        .onGet(() => this.CarbonMonoxideSensor!.CarbonMonoxideDetected)
+    }
+
+    // Carbon Dioxide Sensor Service (optional)
+    if (device.globalDeviceType?.toLowerCase().includes('co2')) {
+      accessory.context.CarbonDioxideSensor = accessory.context.CarbonDioxideSensor ?? {}
+      this.CarbonDioxideSensor = {
+        Name: accessory.context.CarbonDioxideSensor.Name ?? `${accessory.displayName} CO2 Sensor`,
+        Service: accessory.getService(this.hap.Service.CarbonDioxideSensor) ?? accessory.addService(this.hap.Service.CarbonDioxideSensor) as Service,
+        CarbonDioxideDetected: accessory.context.CarbonDioxideDetected ?? false,
+      }
+      accessory.context.CarbonDioxideSensor = this.CarbonDioxideSensor as object
+      this.CarbonDioxideSensor.Service
+        .setCharacteristic(this.hap.Characteristic.Name, this.CarbonDioxideSensor.Name)
+        .getCharacteristic(this.hap.Characteristic.CarbonDioxideDetected)
+        .onGet(() => this.CarbonDioxideSensor!.CarbonDioxideDetected)
+    }
+
+    // Initial refresh
+    this.refreshStatus()
+    this.updateHomeKitCharacteristics()
+
+    // Start update interval
+    interval(this.deviceRefreshRate * 1000)
+      .pipe(skipWhile(() => this.SensorUpdateInProgress))
+      .subscribe(async () => {
+        await this.refreshStatus()
+      })
+  }
+
+  /**
+   * Parse the device status from the FirstAlert api
+   */
+  async parseStatus(): Promise<void> {
+    // Use a single variable for dynamic property access
+    const d: any = this.device
+    // Battery
+    this.Battery.BatteryLevel = Number(d.batteryLevel ?? 100)
+    this.Battery.Service.getCharacteristic(this.hap.Characteristic.BatteryLevel).updateValue(this.Battery.BatteryLevel)
+    // Consider battery low if < 15%
+    this.Battery.StatusLowBattery = this.Battery.BatteryLevel < 15 ? this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_LOW : this.hap.Characteristic.StatusLowBattery.BATTERY_LEVEL_NORMAL
+
+    // Smoke
+    this.SmokeSensor.SmokeDetected = (d.smokePresent ?? d.smoke_detected ?? d.smoke ?? false)
+      ? this.hap.Characteristic.SmokeDetected.SMOKE_DETECTED
+      : this.hap.Characteristic.SmokeDetected.SMOKE_NOT_DETECTED
+
+    // CO
+    if (this.CarbonMonoxideSensor) {
+      this.CarbonMonoxideSensor.CarbonMonoxideDetected = (d.coPresent ?? d.co_detected ?? d.co ?? false)
+        ? this.hap.Characteristic.CarbonMonoxideDetected.CO_LEVELS_ABNORMAL
+        : this.hap.Characteristic.CarbonMonoxideDetected.CO_LEVELS_NORMAL
+    }
+    // CO2
+    if (this.CarbonDioxideSensor) {
+      this.CarbonDioxideSensor.CarbonDioxideDetected = !!((d.co2Present ?? d.co2_detected ?? d.co2 ?? false))
+    }
+  }
+
+  /**
+   * Ask the FirstAlert API for the latest device information
+   */
+  async refreshStatus(): Promise<void> {
+    try {
+      const deviceId = String(this.device.deviceId)
+      const deviceState = await this.platform.client.getDeviceState(deviceId)
+      this.device = { ...this.device, ...deviceState }
+      await this.parseStatus()
+      await this.updateHomeKitCharacteristics()
+    } catch (e: any) {
+      const action = 'refreshStatus'
+      this.resideoAPIError(e, action)
+    }
+  }
+
+  /**
+   * Update HomeKit characteristics
+   */
+  async updateHomeKitCharacteristics(): Promise<void> {
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.BatteryLevel, this.Battery.BatteryLevel)
+    this.Battery.Service.updateCharacteristic(this.hap.Characteristic.StatusLowBattery, this.Battery.StatusLowBattery)
+    this.SmokeSensor.Service.updateCharacteristic(this.hap.Characteristic.SmokeDetected, this.SmokeSensor.SmokeDetected)
+    if (this.CarbonMonoxideSensor) {
+      this.CarbonMonoxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonMonoxideDetected, this.CarbonMonoxideSensor.CarbonMonoxideDetected)
+    }
+    if (this.CarbonDioxideSensor) {
+      this.CarbonDioxideSensor.Service.updateCharacteristic(this.hap.Characteristic.CarbonDioxideDetected, this.CarbonDioxideSensor.CarbonDioxideDetected)
+    }
+  }
+
+  /**
+   * Called by platform polling
+   */
+  async updateState(): Promise<void> {
+    await this.refreshStatus()
+  }
+}