diff --git a/CHANGELOG.md b/CHANGELOG.md index 1e276695..bf6f7e24 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,9 @@ All notable changes to this project will be documented in this file. This project uses [Semantic Versioning](https://semver.org/). +## v5.5.7 + * Add the `Verified by Homebridge` badge and update README.md header. + ## v5.5.6 * Minimum Omni occupancy level changed to 48.0dBA per Omni specifications. * Addition of Wiki screenshots. diff --git a/README.md b/README.md index a35e8174..116dae0e 100755 --- a/README.md +++ b/README.md @@ -1,19 +1,28 @@ + + + + + +
HomebridgeHomebridge
+ # homebridge-awair2 +[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins) + This is a second generation Homebridge Dynamic Platform plugin for the Awair family of air quality sensors implemented in TypeScript for Nfarina's [Homebridge project](https://github.com/nfarina/homebridge). The Awair2 plugin is based on the [homebridge-awair](https://github.com/deanlyoung/homebridge-awair#readme) plugin developed by Dean L. Young. The Awair2 plugin will query your Awair account using a Developer Token to determine your registered Awair devices which were setup through the Awair app on your iOS device. While running, the plugin will fetch current sensor conditions for each Awair device (e.g. Awair 1st Edition, Awair Glow, Awair Mint, Awair Omni, Awair 2nd Edition, Awair Glow C, or Awair Element) and provide sensor status and value (e.g. temperature, humidity, carbon dioxide, TVOC, dust/PM2.5/PM10, Omni lux, and Omni battery) to HomeKit. You can look at the current Awair information via HomeKit enabled Apps on your iOS device or even ask Siri for them. -The plugin will fetch new data based on selected `endpoint` and User Account tier. For 'Hobbyist' tier, `15-min-avg` endpoint samples every 15 minutes, `5-min-avg` every 5 minutes, `latest` every 5 minutes and `raw` every 3.3 minutes (200 seconds). The main difference between the `latest` and `raw` endpoints is that you can define a `limit` (i.e. number of consecutive data points) for the `raw` endpoint, in order to create your own averaging (e.g. `.../raw?limit=12` for a 2 minute average). +The plugin will fetch new data based on selected `endpoint` and User Account tier. For 'Hobbyist' tier, `15-min-avg` endpoint samples every 15 minutes, `5-min-avg` every 5 minutes, `latest` every 5 minutes and `raw` every 3.3 minutes (200 seconds). The main difference between the `latest` and `raw` endpoints is that you can define a `limit` (i.e. number of consecutive data points) for the `raw` endpoint, in order to create your own averaging (e.g. `.../raw?limit=12` for a 2 minute average. With iOS14, the icons and status have been refined in the iOS/iPadOS/macOS Home app. Air quality, temperature and humidity are grouped under a single "climate" status icon at the top of the HomeKit screen (first screenshots below). If you touch this icon a screen opens with all of the Climate devices in your HomeKit home (second screenshot). -![iOS14 Screenshots](screenshots/Image.png) +![iOS14 Screenshots](https://github.com/DMBlakeley/homebridge-awair2/blob/master/screenshots/Image.png) For those with multiple Awair devices, you can optionally list the macAddress of the device (found on the back or bottom of the device) which you want to exclude from HomeKit. For Awair Omni, battery charge level, charging status, low battery, light level and occupancy detection based on ambient sound level [experimental] are also provided using the Local Sensors capability which is configured in the Awair App (reference screenshot below). Battery Status does not appear as a separate tile in the HomeKit interface. Battery charge level and status will be found in the Status menu for each of the sensors. A low battery indication will be identified as an alert in the HomeKit status section (see third and fourth screenshots). -![iOS14 Screenshots](screenshots/Image2.png) +![iOS14 Screenshots](https://github.com/DMBlakeley/homebridge-awair2/blob/master/screenshots/Image.png) NOTE: If you are setting up an Awair 1st Edition (i.e. deviceType = `awair`) unit for the first time, it is recommended that you allow 6 to 12 hours after adding to the iOS Awair App for the unit to calibrate, update firmware if necessary and establish connection to the Awair API cloud. @@ -21,7 +30,7 @@ Acknowledgment to @Sunoo for the homebridge-philips-air plugin which was used as # Installation -1. Install homebridge using: `[sudo] npm install -g homebridge` +1. Install homebridge, reference [Homebridge Wiki](https://github.com/homebridge/homebridge/wiki) 2. Install this plugin using: `[sudo] npm install -g homebridge-awair2` 3. Update your configuration file. See the sample below. diff --git a/package-lock.json b/package-lock.json index dfcc8a03..a9134a2c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,6 +1,6 @@ { "name": "homebridge-awair2", - "version": "5.5.6", + "version": "5.5.7", "lockfileVersion": 1, "requires": true, "dependencies": { diff --git a/package.json b/package.json index 943a25cb..0889b8a2 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "private": false, "displayName": "Homebridge Awair2", "name": "homebridge-awair2", - "version": "5.5.6", + "version": "5.5.7", "description": "HomeKit integration of Awair air purifier as Dynamic Platform.", "main": "dist/index.js", "scripts": { diff --git a/screenshots/AWAIR_logo_g.svg b/screenshots/AWAIR_logo_g.svg new file mode 100644 index 00000000..edb2fcff --- /dev/null +++ b/screenshots/AWAIR_logo_g.svg @@ -0,0 +1 @@ +AWAIR Logo_g \ No newline at end of file diff --git a/screenshots/Awair_Element.jpg b/screenshots/Awair_Element.jpg new file mode 100644 index 00000000..f5a29c95 Binary files /dev/null and b/screenshots/Awair_Element.jpg differ diff --git a/screenshots/Awair_Glow_C.jpg b/screenshots/Awair_Glow_C.jpg new file mode 100644 index 00000000..d9d713f0 Binary files /dev/null and b/screenshots/Awair_Glow_C.jpg differ diff --git a/screenshots/Awair_Omni.jpg b/screenshots/Awair_Omni.jpg new file mode 100644 index 00000000..9ba5491d Binary files /dev/null and b/screenshots/Awair_Omni.jpg differ