Is Apollo Automation AIR-1 Sensor Node Compatible with Home Assistant (ESPHome)?
Compatibility Overview
All-in-one open-source smart home sensor node integrating mmWave presence particulate matter CO2 and environmental sensors.
Technical Specification Matrix
| Feature / Attribute | Specification / Status |
|---|---|
| Hardware Protocol | Wi-Fi (ESPHome) |
| Bridge Required | NO |
| Border Router Needed | None |
| Hardware Capabilities & Peripherals | PM2.5 Dust CO2 PPM SEN0395 mmWave Presence RGB Status LED Note: these entities come from the ESPHome configuration you flash — each one needs its matching component in that YAML before it appears. |
| Pairing Complexity | Plug-and-Play |
| Factory Reset Instruction | Hold onboard BOOT button for 10 seconds to enter AP mode. |
Wire, Flash, Adopt, Check
Wire it up
Follow the bus reference above. The host pins in the configuration are defaults — any free GPIO of the right kind will do, as long as the YAML names the pin you actually used.
Flash the configuration
Create a new device in the ESPHome dashboard (the Home Assistant add-on) and paste the configuration below into it, or save it as emb_esp32_apollo_air1.yaml and run esphome run emb_esp32_apollo_air1.yaml. The first flash goes over USB. If it is not detected, hold onboard BOOT button for 10 seconds to enter AP mode to put it in download mode. Every update after that is over the air.
Adopt it in Home Assistant
Settings → Devices & Services. A node on the same network shows up as a discovered ESPHome device within a minute of joining Wi-Fi; choose Configure and enter the API encryption key from your secrets.yaml. If discovery does not find it, add the ESPHome integration by hand with the node's IP address.
Check it works
The entities on this page appear under the device in Home Assistant and update at the configured interval. The ESPHome log (Logs in the dashboard, or esphome logs) reports the setup of each component and any bus scan results at boot.
ESPHome Configuration
Starting configuration for Apollo Automation AIR-1 Sensor Node on the board named in the vendor package. Untested on hardware — verify wiring and pins against your own board.
# ESPHome configuration for Apollo Automation AIR-1 Sensor Node
# Host: the board named in the vendor package. Pin numbers below are host-side defaults — any free
# GPIO will do, and you should change them to match your own wiring.
esphome:
name: emb_esp32_apollo_air1
friendly_name: "Apollo Automation AIR-1 Sensor Node"
# The esp32 / esp8266 block comes from the imported package below.
logger:
api:
encryption:
key: !secret api_encryption_key
# ota: is declared by the imported package, with the password the vendor ships.
wifi:
ssid: !secret wifi_ssid
password: !secret wifi_password
# Apollo publishes the AIR-1's full configuration; a packages: import is
# how it is meant to be used. Everything above this line is the standard
# node boilerplate the package expects you to supply. The package brings
# its own ota: block, so none is declared here — two with different
# passwords fail validation.
packages:
apollo_air1: github://ApolloAutomation/AIR-1/Integrations/ESPHome/AIR-1.yaml
Before you flash:
the !secret values come from your
secrets.yaml, and the GPIO numbers are host-side
defaults rather than properties of this part — change them to match how you actually wired it.
Report a Pinout Error or Submit Tested Code Snippets
Found a pin mapping quirk or built a custom ESPHome YAML driver for Apollo Automation AIR-1 Sensor Node? Submit a pull request or report corrections to our index.