Apollo Automation AIR-1

unverified library/esphome/apollo-air-1.hal.yaml

Id	apollo-air-1
Manufacturer	Apollo Automation
Model	AIR-1
Driver	esphome
Hazard	low
Limits	unconfirmed The library file holds suggested limits for rgb_light, rgb_light_brightness, and no person has confirmed those limits yet. How a person confirms the limits

Control channels

Channel	Min	Max	Step	Rate per s	Unit	Confirm	Limit
rgb_light					bool	none	suggested
rgb_light_brightness	0	50	1		%	none	suggested

Read channels

Channel	Type	Unit	Every
co2	number	ppm	60 s
temperature	number	degC	30 s
humidity	number	%	30 s
pressure	number	hPa	60 s
voc_index	number	dimensionless	60 s
nox_index	number	dimensionless	60 s

openhal: "0.1"
device: { name: Apollo AIR-1 air quality sensor, model: AIR-1, manufacturer: Apollo Automation }
id: apollo-air-1
match:
  mdns: _esphomelib._tcp
  esphome: { project_name: ApolloAutomation.AIR-1 }
connect: { esphome: apollo-air-1.local, port: 6053, timeout: 5 s }
read:
  co2: { unit: ppm, every: 60 s, map: { object_id: co2 } }
  temperature: { unit: degC, every: 30 s, range: [-10, 50], map: { object_id: sen55_temperature } }
  humidity: { unit: percent, every: 30 s, range: [0, 100], map: { object_id: sen55_humidity } }
  pressure: { unit: hPa, every: 60 s, range: [870, 1085], map: { object_id: dps310_pressure } }
  voc_index: { unit: dimensionless, every: 60 s, range: [1, 500], map: { object_id: sen55_voc } }
  nox_index: { unit: dimensionless, every: 60 s, range: [1, 500], map: { object_id: sen55_nox } }
write:
  rgb_light: { type: bool, suggested: true }
  rgb_light_brightness: { unit: percent, min: 0, max: 50, step: 1, suggested: true }
safe_state: { rgb_light: false }
hazard: low
notes: >-
  Suggested limits. A person must confirm every limit before this device can be written.
  Entity names come from Apollo's ESPHome configuration for the AIR-1. The device adds the end of its MAC
  address to its name, so set host to the name openhal discover shows, such as apollo-air-1-a1b2c3.local.
  The SEN55 VOC and NOx readings are indexes from 1 to 500, not concentrations.
provenance: { source: library, by: OpenHAL starter library, at: 2026-10-25, verification: { status: unverified } }