Brands / Manufacturers

How to Add AirGradient Smart Devices to Apple HomeKit

Amanda Jones

— 6 min read
How to Add AirGradient Smart Devices to Apple HomeKit

Breath easy with smarter air at home! Connecting your AirGradient smart devices to Apple HomeKit makes monitoring and improving your indoor air quality easier than ever. With just a few steps, you can control your air quality devices right from your iPhone or ask Siri to help. 

In this guide, I'll show you how to add your AirGradient devices to HomeKit and take full advantage of smart automation and voice control. Let’s get started! 

AddtoHomeKit – Editor's Pick

AddToHomeKit is a third- party solution to add any device to Apple HomeKit. It offers HomeKit configuration plugins and step-by-step guides to follow when adding AirGradient devices to HomeKit. It gives you web solution and app solution also to integrate your incompatible devices with Apple Home Kit.  

Connect AirGradient to HomeKit Using AddtoHomeKit

  1. Go to the AddtoHomeKit official website.
  2. Select the AirGradient ecosystem.
  3. Once you are directed to the next page, select your preferred solution.
  4. Now select the operating system.
  5. Install the HomeBridge Plugin.
  6. Tap on Add to HomeKit.
  7. Click on the Activation package to activate your account.
  8. Follow the instructions displayed on screen.

ATH Bridge - Affordable Solution

ATH Bridge is the most affordable method to integrate AirGradient devices with Apple Home Kit. In simple words the ATH Bridge is a plug and play solution that provides you Air Gradient Apple Home Kit integration. It is a pre-flashed and compiled server which is designed to have perfect integration. 

AirGradient ONE - Indoor Air Quality Monitor

airgradient-one
AirGradient ONE

The AirGradient ONE (Model I-9PSL) is an indoor air quality monitor enabling you to know if the air quality is healthy or not. It’s fully open-source and customizable, so you can extend it in whatever way you like. 

This is important because AirGradient brings fresh, clean air and a pleasant atmosphere to your home. 

Technical Data

Model I-9PSL (AirGradient ONE, 9th Generation)
Microcontroller ESP32-C3-MINI (32-bit RISC-V single-core processor, up to 160MHz, 384 KB ROM, 400 KB SRAM, 8 KB SRAM in RTC, 4 MB flash in chip package)
Wi-Fi 2.4GHz IEEE 802.11 b/g/n-compliant
Display OLED display 1.3 inch (I2C 128x64px)
Bluetooth Bluetooth LE: Bluetooth 5, Bluetooth mesh
Extensions Broken out on PCB: I2C, 3 GPIO, 2 UART
Peripherals 11 RGB-LEDs, Push Button, Reset Button, USB C Connector
External Hardware Watchdog Texas Instruments TPL5010
CO2 Sensor Module Sense Air S8 (NDIR). 0 to 10000ppm. Accuracy: ±40 ppm ±3% of reading at 5 to 30°C, 0-85% RH (400 - 2000ppm range)
Particle Sensor Module Plantower PMS5003 (laser scattering principle). Accuracy: ±10%@100~500μ g/m³, ±10μg/m³@0~100μ g/m³
Temperature and Humidity Module Sensirion SHT40. Accuracy: Temperature ±0.2°C @ -40 to + 125°C; Humidity ±2% RH @ 0 - 100% RH
TVOC/NOX Module Sensirion SGP41. Accuracy: TVOC <±15 @ 0 to 500 VOC Index; NOX ±50 @ 0 - 500 NOX Index
Enclosure ASA Plastic, UV Resistant and Weatherproof
Cable 2m USB C Cable including Data Lines for Flashing
Power Plug 2A 5V USB A Power Plug is Required
Dimensions & Weight 130 x 130 x 35mm, 350 grams
Certifications CE, RoHS, REACH, RESET Air, FCC ID: 2AC7Z-ESPC3MINI

Key Characteristics

key-features-airgradient-one
Key Features of AirGradient ONE

Connect AirGradient Devices with Apple Home using Home Assistant

Home Assistant is an open-source software to integrate many devices with the home app. So, you should integrate AirGradient Home Assistant with the Home app. Then you can monitor the air quality sensor on the home app. 

  1. Browse to your Home Assistant instance.
  2. Go to Settings > Devices & Services.
  3. In the bottom right corner, select the Add Integration button.
  4. From the list, select AirGradient.
  5. Follow the instructions on screen to complete the setup.

Use AirGradient to HomeKit via Homey Pro

If you are a homey pro user, use this guide to automate and control the Monitor on Apple HomeKit.  

  1. First, connect Homey with HomeKit.
  2. Then, unbox the Airgadient device and connect it with a Wi-Fi connection.
  3. Install the AirGradient app on Homey Pro.
  4. Choose the indoor or outdoor monitor.
  5. Next, pair the device with the Homey Air Gradient app.
  6. Then, follow the onscreen prompts.
  7. Now you can automate the AirGradient to HomeKit using Homey Pro.

AirGradient HOOBS Integration

HOOBS stands for "HomeBridge Out of the Box System." It is a plug and play Hub that allows users to easily set up and use a HomeBridge. It is a hardware solution that is an easy method to integrate your incompatible devices to Apple HomeKit.

  1. Click the Bridges option.
  2. Click Add Bridge.
  3. Enter a new bridge name (Ex: “AirGradient Bridge”).
  4. Click Save. After that, you can now see a notification in the bottom right corner.
  5. Tap on the bridge name in the list. then a QR code will appear for HomeKit pairing.
  6. Go through the HomeKit ‘Add Accessory’ and scan the code.
  7. Choose a Room to place the bridge.

AirGradient HomeBridge Integration

HomeBridge is one of the most popular methods used as it is an open-source software platform. You need a little coding knowledge to operate HomeBridge.   

  1. Install HomeBridge
    1. For Windows/Mac/Linux: Install Node.js
    2. For Raspberry Pi: You can use the HomeBridge image, which simplifies the installation.

  2. Install the HomeBridge Config UI X Plugin
  3. Install AirGradient Plugin for HomeBridge 
    4. sudo npm install -g homebridge-airgradient
  4. Configure HomeBridge

    5. Open the HomeBridge configuration file. You can usually find it at ~/.homebridge/config.json.


    Add the AirGradient plugin configuration to the file. 

    
    { 

  "platform": "AirGradient", 

  "devices": [ 

    { 

      "name": "Living Room AirGradient", 

      "ip": "", 

      "pollingInterval": 60, 

      "sensors": { 

        "pm2_5": true, 

        "co2": true, 

        "temperature": true, 

        "humidity": true 

      } 

    } 

  ] 

}
  5. Restart HomeBridge
  6. Add HomeBridge to Apple HomeKit
  7. Verify Device Integration

    8. Once added, your AirGradient devices should appear in the home app. Test them to ensure they are functioning as expected.

If you want to these step-guide with more details check out how to add AirGradient to Apple HomeKit using Homebridge.

What can you do with Air Gradient Apple Home Kit integration?

  • Monitor Air Quality: You can view real-time air quality data directly on your Apple devices.
  • Control Airgradient Devices: You can adjust devices settings from the home app or through Siri.
  • Automate Air Quality Management: Set triggers and automations using the home app to control your Airgradient device based on conditions.
  • Integrate with Other HomeKit Devices: Combine Airgradient devices with other HomeKit-compatible smart devices.
  • Siri Voice Commands

Read also, 

Editor's Pick

In my opinion, AddtoHomeKit stands out as the easiest and most efficient way to connect Airgradient devices to Apple HomeKit, it saves time and effort compared to solutions like HomeBridge and HOOBs, especially if you are not very experienced in the technical side. 

FAQs


Yes, it's possible to integrate AirGradient monitors with Apple HomeKit using custom firmware. It allows your AirGradient device to send data directly to HomeKit and enabling you to monitor air quality parameters through the Apple Home app.

The AirGradient DIY PRO version 3.7.

Yes, you can successfully integrated AirGradient monitors with HomeKit through Home Assistant. By using ESPHome on the monitors and Home Assistant's HomeKit integration.

For the most complete air quality monitoring, I recommend the AirGradient ONE.

Air monitoring uses electronic devices to provide real-time readings of contaminants in the air.


Air sampling involves trapping air over a period of time in a container that is then sent to a laboratory for analysis to identify and quantify specific compounds.

Read more