Add Aqara TVOC Sensor Support with history

Add Aqara TVOC Sensor support and support for Eve's history.
ebaauw · Sep 9, 2021 · 615314f · 615314f
1 parent b4cd70e
commit 615314f
Show file tree

Hide file tree

Showing 2 changed files with 88 additions and 5 deletions.
diff --git a/lib/HueSensor.js b/lib/HueSensor.js
@@ -928,11 +928,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')
@@ -971,10 +973,39 @@ function HueSensor (accessory, id, obj) {
         key: 'temperature',
         name: 'temperature',
         unit: '°C',
-        history: 'weather',
+        history: this.obj.modelid === 'lumi.airmonitor.acn01' ? 'room2' : 'weather',
         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.type = {
+        Characteristic: Characteristic.VOCDensity,
+        key: 'airqualityppb',
+        name: 'Air Quality',
+        unit: 'voc',
+        history: 'room2',
+        homekitValue: function (v) {
+          return v ? Math.round(v) * 4.56 : 0
+        }
+      }
+      break
     case 'ZLLLightLevel': // 2.7 - Hue Motion Sensor
     case 'ZHALightLevel':
       if (
@@ -1052,7 +1083,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
@@ -1077,7 +1109,7 @@ function HueSensor (accessory, id, obj) {
         key: 'humidity',
         name: 'humidity',
         unit: '%',
-        history: 'weather',
+        history: this.obj.modelid === 'lumi.airmonitor.acn01' ? 'room2' : 'weather',
         homekitValue: function (v) { return v ? Math.round(v / 100) : 0 }
       }
       break
@@ -1529,6 +1561,10 @@ function HueSensor (accessory, id, obj) {
             this.history.entry.humidity = 0
             this.history.entry.pressure = 0
             break
+          case 'room2':
+            this.history.entry.temp = 0
+            this.history.entry.humidity = 0
+            this.history.entry.voc = 0
           default:
             break
         }
@@ -1761,6 +1797,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':
@@ -2005,6 +2043,16 @@ HueSensor.prototype.addEntry = function (changed) {
         }
       }
       break
+    case 'room2':
+      {
+        var key = this.type.key === 'airqualityppb' ? 'voc' : this.type.key
+        key = this.type.key === 'temperature' ? 'temp' : key
+        this.history.entry[key] = this.hk[this.type.key]
+        if (changed || this.type.key !== this.history.resource.type.key) {
+          return
+        }
+      }
+      break
     default:
       return
   }
@@ -2349,6 +2397,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) {

diff --git a/package.json b/package.json
@@ -28,7 +28,7 @@
     "node": "^14.17.6"
   },
   "dependencies": {
-    "fakegato-history": "~0.6.1",
+    "fakegato-history": "~0.6.2",
     "homebridge-lib": "~5.1.13",
     "semver": "^7.3.5",
     "ws": "^8.2.1",