Add initial Aqara TVOC Sensor Support

Add initial Aqara TVOC Sensor support. This PR does not include Eve History support for PPM values.
ebaauw · Aug 31, 2021 · f2eede2 · f2eede2
1 parent bac18d5
commit f2eede2
Showing 1 changed file with 79 additions and 2 deletions.
diff --git a/lib/HueSensor.js b/lib/HueSensor.js
@@ -919,11 +919,13 @@ function HueSensor (accessory, id, obj) {
       } else if (
         this.obj.manufacturername === 'LUMI' && (
           this.obj.modelid === 'lumi.weather' ||
-          this.obj.modelid === 'lumi.sensor_ht'
+          this.obj.modelid === 'lumi.sensor_ht' ||
+          this.obj.modelid === 'lumi.airmonitor.acn01'
         )
       ) {
         // Xiaomi temperature/humidity sensor
         // Xiaomi Aqara weather sensor
+        // Xiaomi Aqara airquality sensor
       } else if (
         this.obj.manufacturername === 'Heiman' &&
         (this.obj.modelid === 'TH-H_V15' || this.obj.modelid === 'TH-T_V15')
@@ -966,6 +968,37 @@ function HueSensor (accessory, id, obj) {
         homekitValue: function (v) { return v ? Math.round(v / 10) / 10 : 0 }
       }
       break
+    case 'ZHAAirQuality':
+      if (
+        this.obj.manufacturername === 'LUMI' &&
+        this.obj.modelid === 'lumi.airmonitor.acn01'
+      ) {
+        // Xiaomi Aqara airquality sensor
+      } else {
+        this.log.warn(
+          '%s: %s: warning: unknown %s sensor %j',
+          this.bridge.name, this.resource, this.obj.type, this.obj
+        )
+      }
+      // falls through
+    case 'CLIPAirQuality':
+      this.service = new Service.AirQualitySensor(this.name, this.subtype)
+      this.serviceList.push(this.service)
+      this.service
+        .addOptionalCharacteristic(Characteristic.AirQuality)
+      this.service
+        .addOptionalCharacteristic(eve.Characteristics.AirParticulateDensity)
+      this.type = {
+        Characteristic: Characteristic.VOCDensity,
+        key: 'airqualityppb',
+        name: 'Air Quality',
+        unit: 'ppb',
+        history: 'room',
+        homekitValue: function (v) {
+          return v ? Math.round(v + 450) : 0
+        }
+      }
+      break
     case 'ZLLLightLevel': // 2.7 - Hue Motion Sensor
     case 'ZHALightLevel':
       if (
@@ -1043,7 +1076,8 @@ function HueSensor (accessory, id, obj) {
       if (
         this.obj.manufacturername === 'LUMI' && (
           this.obj.modelid === 'lumi.weather' ||
-          this.obj.modelid === 'lumi.sensor_ht'
+          this.obj.modelid === 'lumi.sensor_ht' ||
+          this.obj.modelid === 'lumi.airmonitor.acn01'
         )
       ) {
         // Xiaomi Aqara weather sensor
@@ -1520,6 +1554,10 @@ function HueSensor (accessory, id, obj) {
             this.history.entry.humidity = 0
             this.history.entry.pressure = 0
             break
+          case 'room':
+            this.history.entry.temp = 0
+            this.history.entry.humidity = 0
+            this.history.entry.ppm = 0
           default:
             break
         }
@@ -1752,6 +1790,8 @@ HueSensor.prototype.checkAttr = function (attr, event) {
 HueSensor.prototype.checkState = function (state, event) {
   for (const key in state) {
     switch (key) {
+      case 'airquality':
+        this.checkAirQuality(state.airquality)
       case 'angle':
         break
       case 'battery':
@@ -1996,6 +2036,8 @@ HueSensor.prototype.addEntry = function (changed) {
         }
       }
       break
+    case 'room':
+      this.history.entry.ppm = this.hk.airqualityppm
     default:
       return
   }
@@ -2340,6 +2382,41 @@ HueSensor.prototype.checkVoltage = function (voltage) {
   }
 }
 
+HueSensor.prototype.checkAirQuality = function (airquality) {
+  if (this.obj.state.airquality !== airquality) {
+    this.log.debug(
+      '%s: airquality changed from %j to %j', this.name,
+      this.obj.state.airquality, airquality
+    )
+    this.obj.state.airquality = airquality
+  }
+  var hkAirQuality;
+  if (airquality == 'excellent') {
+    hkAirQuality = Characteristic.AirQuality.EXCELLENT
+  } else if (airquality == 'good') {
+    hkAirQuality = Characteristic.AirQuality.GOOD
+  } else if (airquality == 'moderate') {
+    hkAirQuality = Characteristic.AirQuality.FAIR
+  } else if (airquality == 'poor') {
+    hkAirQuality = Characteristic.AirQuality.INFERIOR
+  } else if (airquality == 'unhealthy') {
+    hkAirQuality = Characteristic.AirQuality.POOR
+  } else {
+    hkAirQuality = Characteristic.AirQuality.UNKNOWN
+  }
+  if (this.hk.airquality !== hkAirQuality) {
+    if (this.hk.airquality !== undefined) {
+      this.log.info(
+        '%s: set homekit airquality from %s V to %s V', this.name,
+        this.hk.airquality, hkAirQuality
+      )
+    }
+    this.hk.airquality = hkAirQuality
+    this.service.getCharacteristic(Characteristic.AirQuality)
+      .updateValue(this.hk.airquality)
+  }
+}
+
 HueSensor.prototype.checkConfig = function (config) {
   for (const key in config) {
     switch (key) {