AirGradient Integrations

MallocArray · October 6, 2023, 9:30pm

In your HA Dashboard, you could add a “gauge card” with a config something like this:

scriven33 · October 22, 2023, 9:08pm

I have just received the new " Open Air Outdoor Monitor O-1PST CO2 Version" - will these integrations work with the additional sensor, or do I need to add something?
Primarily looking to switch to ESPHOME, with the additional upload to the Air Gradient API, so I can integrate in to Home Assistant.

Thanks.

MallocArray · October 23, 2023, 12:12am

I’m working on a config for ESPHome for that model right now, so if you can wait a few days I hope to have something ready soon.

Achim_AirGradient · October 23, 2023, 2:43am

@MallocArray many thanks for this. Very appreciated!

scriven33 · October 23, 2023, 9:50am

Thanks for the update - as a newcomer to this community I can see your efforts are appreciated.
Does it include control of the blue light? That is already generating comments within the family and I haven’t even mounted it yet!

Achim_AirGradient · October 23, 2023, 10:07am

What blue light do you refer to?

scriven33 · October 23, 2023, 10:22am

Blue LED next to the USB port. Keeps coming on.

MallocArray · October 23, 2023, 9:39pm

My initial release of an ESPHome config for the new AirGradient One with the v9 board is now available:

airgradient_esphome/airgradient-one.yaml at main · MallocArray/airgradient_esphome (github.com)

Supports all included sensors and the LED bar, based on CO2 values, as well as sending data to AirGradient’s dashboard in addition to your own HomeAssistant

Achim_AirGradient · October 24, 2023, 3:29am

We will most likely make the blue light only blink during the WiFi setup and if the monitor has some problem. Would that make your family happy ?

scriven33 · October 24, 2023, 9:43am

That would make the most obvious use of the LED in my mind. My children are used to things with lights on around the house and outside, and if something is showing a light which shouldn’t do I usually get a report very quickly. Therefore it being used for error conditions only would probably make the most sense.

Although I will be switching over to the ESPHome config as soon as it is ready…

investigatorno56 · December 22, 2023, 6:35pm

I’ve updated gohai’s HomeKit port to work with DIY_PRO_V4_2. If anyone runs into any bugs or issues feel free to let me know and I’ll do my best to help out if I can. I haven’t run into any problems yet but I also haven’t done any extensive tests.

Here is the link to my repo - https://github.com/brian-gee/arduino-homekit-enabled/tree/master/examples

Alan_Ng · December 28, 2023, 8:53am

@investigatorno56 Thanks for your great work on HomeKit integration for DIY PRO V4.2
I would like to know can I upload the same firmware to two Boards which is DIY PRO V4.2 with the same setup password and added to the same HomKit network ?

Are the 2 units detected under the same HomeKit then they can added on the same Apple Home network such as the same Home Name and same WIFI network?

I found that only one unit can be detected on the Add Accessory Screen, the 2nd unit must be power off. Simply speaking only ONE unit can be detected on the same Home network, even I try to changed the Setup password with difference number. Do you have any idea to fix that?

Thanks!
Alan

investigatorno56 · December 29, 2023, 3:23am

Hey @Alan_Ng, I’m not sure as I only have one device that I can test this with. I think possibly setting a different serial number within the homekit.c file might resolve this issue. Give it a try and let me know if it works. If not maybe something in the below accessory options needs to be changed.

homekit_accessory_t *accessories[] = {
  HOMEKIT_ACCESSORY(.id = 1, .category = homekit_accessory_category_sensor, .services = (homekit_service_t*[]) {
    HOMEKIT_SERVICE(ACCESSORY_INFORMATION, .characteristics = (homekit_characteristic_t*[]) {
      HOMEKIT_CHARACTERISTIC(NAME, "AirGradient DIY PRO"),
      HOMEKIT_CHARACTERISTIC(MANUFACTURER, "Arduino HomeKit"),
      HOMEKIT_CHARACTERISTIC(SERIAL_NUMBER, "0123456"),
      HOMEKIT_CHARACTERISTIC(MODEL, "ESP8266"),
      HOMEKIT_CHARACTERISTIC(FIRMWARE_REVISION, "1.0"),
      HOMEKIT_CHARACTERISTIC(IDENTIFY, my_accessory_identify),
      NULL
    }),

MallocArray · December 29, 2023, 3:39am

For what it is worth, Airgradient uses the last 6 characters of the MAC address as the serial number with the D1 Mini ESP8266 when it comes to their API. (Full MAC for the esp32-c3)

Alan_Ng · December 29, 2023, 5:46am

Hey @investigatorno56 thanks for your response. Let me show you what is my findings as below.

Only 1 unit power on, it can be detected on Add Accessory screen and added to Home success.
When 1st unit is added to Home and working then 2nd unit is not shown on the screen of the Add Accessory.
Power off the 1st unit which is added to Home already, then 2nd unit will be shown on Add Accessory screen and it can be process the adding process but finally it failed with message of “it cannot be added”
Removed the 1st unit from the Home and power off it then add the 2nd unit to Home will be detected and success.

I have built others HomeKit Board, it having the same issue when adding 2nd unit. That mean if you only have 1 unit then you do not discovered that issue.

As I searched for others HomeKit projects that come with Setup QR code which have the Setup ID inside the QR code. I have referred the below document for details and build the QR code.
I have try to use different Setup ID but it look like having the same issue, may be I not good for the program and misunderstand some details of building the QR code.

I have refer to the below information to create a QR code.

This generated setup payload is the actual content of the QR code and can be generated with the HomeKit Accessory Simulator (HAS) as well.

I recalled that I have try this with different SETUP ID but it still not resolve the issue. It may be I am not good for that QR code setup .

I think HomeKit have a record ( Serial number or others information) of the added units and do not allow to add the same HW information to the same HomeKIt network.

May be I try to change the Serial Number and SETUP ID with QR to check it again.

I will let you know my findings. Thanks again!

Jorgen_Austvik · January 9, 2024, 11:00am

I’m working on an AirGradient integration for OpenHAB

It is available in the openhab marketplace, so it should be easy to enable it if you are running OpenHAB 4.
AirGradient API Binding - Add-on Marketplace / Bundles - openHAB Community

All feedback is welcome.

arpix · March 2, 2024, 3:43am

I am new here but can we put the data from an AirGradiant to WAQI.info? I see a lot of PurpleAir but with my students, I would prefer to buy 3 AirGradiant than 1 PurpleAir…

Achim_AirGradient · March 2, 2024, 2:05pm

We don’t have an integration with Waqi but with openAQ which is used by many researchers.

McJoppy · March 24, 2024, 1:06am

Never looked before but it seems that it should be possible - they have info here Publishing Air Quality Data: on the aqicn.org / waqi.info map

Hiigara · March 24, 2024, 6:35pm

Hi,

I succesful send data to WAQI.
I use Home Assistant to do that.
I have the Airgradient firmware with the MQTT set up
I retreive the data in HA by setting a sensors in the config yaml file.

mqtt:
  sensor:
    - name: "AirGradient Outdoor"
      state_topic: "airgradient/readings/<id of the AG>"
      value_template: "{{ value_json.pm02 }}"
      unit_of_measurement: "µg/m3"
      json_attributes_topic: "airgradient/readings/<id of the AG>"

I use pm02 as main value cause, I can calculate US AQI after that (not provided in MQTT stream (could be a nice improvment))
→ It will create a sensors with PM02 as main value and all the other data are attributes to that sensors
Then I setup a node red flow inside Home Assistant to send data to WAQI via the json api

Here the code to import in Node Red (you can delete weather data as I send my Davis Vantage data)
You have to set your lat long in the function box and also your Token from WAQI (works like a charm)
→ You can remove Weatherlink box and AQI box too