A-HAP v2 Sensor Library

These are the built-in sensor presets included in A-HAP v2. ESP32 sketches should send the listed raw telemetry channel names to A-HAP. Trigger logic, alerts, calculations, and output actions are then handled centrally by the A-HAP server.

Back to Setup Guide Download Trial Features & Roadmap

Current built-in library

A-HAP v2 currently includes 35 built-in sensor presets across 12 categories. Use the channel keys shown below in ESP32 telemetry payloads.

Air / Gas 6 sensor presets Distance / Level 2 sensor presets Environment 5 sensor presets Fire / Flame 1 sensor preset Garden / Soil 1 sensor preset Generic / Custom 3 sensor presets Light 2 sensor presets Load / Weight 5 sensor presets Motion / Orientation 1 sensor preset Motion / Security 3 sensor presets Power Monitoring 2 sensor presets Water 4 sensor presets

How sensor readings are used

A-HAP stores readings under sensor channels. Any triggerable channel can be used for output triggers, schedule conditions, or email alert rules inside the server. Keep the ESP32 sketch focused on reading the sensor and sending the value; keep thresholds and actions in A-HAP.

Gas, smoke, CO, flame, load, and estimated values depend on the hardware, calibration, and installation. They are useful for automation and monitoring, but they are not a replacement for certified safety alarms.

Air / Gas

Sensor preset	Common use	Default poll	Channels sent to A-HAP
MH-Z19B CO2 Sensor	CO2 sensor with ppm output.	30 sec	CO2 `co2_ppm` — Number / ppm triggerable Temperature `temperature` — Number / °C triggerable
MQ-135 Air Quality Sensor	General air quality sensor for air quality, CO2 estimate and common gas estimate values.	30 sec	Raw Air Quality Level `raw_air_quality` — Number triggerable Estimated Air Quality `air_quality_estimate` — Number triggerable Estimated CO2 `co2_estimate` — Number / ppm triggerable Estimated Gas Level `gas_estimate` — Number triggerable
MQ-2 Gas / Smoke Sensor	Smoke, LPG and combustible gas level sensor. Readings are estimates and not certified safety alarm values.	30 sec	Raw Gas Level `raw_gas` — Number triggerable Estimated Smoke Level `smoke_estimate` — Number triggerable Estimated LPG / Combustible Gas Level `lpg_estimate` — Number triggerable
MQ-7 Carbon Monoxide Sensor	Carbon monoxide gas level sensor. Readings are estimates and not certified safety alarm values.	30 sec	Raw CO Level `raw_co` — Number triggerable Estimated CO Level `co_estimate` — Number / ppm triggerable
PMS5003 / PMS7003 Particulate Sensor	Particulate matter air quality sensor.	30 sec	PM1.0 `pm1_0` — Number / µg/m³ triggerable PM2.5 `pm2_5` — Number / µg/m³ triggerable PM10 `pm10` — Number / µg/m³ triggerable
SGP30 Air Quality Sensor	Digital indoor air quality sensor for TVOC and equivalent CO2.	30 sec	TVOC `tvoc` — Number / ppb triggerable Equivalent CO2 `eco2` — Number / ppm triggerable

Distance / Level

Sensor preset	Common use	Default poll	Channels sent to A-HAP
HC-SR04 Ultrasonic	Ultrasonic distance sensor.	30 sec	Distance `distance_cm` — Number / cm triggerable
JSN-SR04T Waterproof Ultrasonic	Waterproof ultrasonic distance sensor, useful for outdoor distance or tank level monitoring.	30 sec	Distance `distance_cm` — Number / cm triggerable

Environment

Sensor preset	Common use	Default poll	Channels sent to A-HAP
BME280	Temperature, humidity and atmospheric pressure sensor.	60 sec	Temperature `temperature` — Number / °C triggerable Humidity `humidity` — Number / % triggerable Atmospheric Pressure `pressure` — Number / hPa triggerable Altitude Estimate `altitude_estimate` — Number / m stored / calculated
BMP280	Temperature and atmospheric pressure sensor.	60 sec	Temperature `temperature` — Number / °C triggerable Atmospheric Pressure `pressure` — Number / hPa triggerable Altitude Estimate `altitude_estimate` — Number / m stored / calculated
DHT11	Basic temperature and humidity sensor.	60 sec	Temperature `temperature` — Number / °C triggerable Humidity `humidity` — Number / % triggerable
DHT22 / AM2302	Temperature and humidity sensor.	60 sec	Temperature `temperature` — Number / °C triggerable Humidity `humidity` — Number / % triggerable
DS18B20 Waterproof Temperature Sensor	OneWire temperature sensor, commonly used for water or outdoor temperature.	60 sec	Temperature `temperature` — Number / °C triggerable

Fire / Flame

Sensor preset	Common use	Default poll	Channels sent to A-HAP
IR Flame Sensor	Infrared flame detection sensor. Not a certified fire alarm.	10 sec	Flame Detected `flame_detected` — Boolean triggerable Flame Intensity `flame_intensity` — Number / % triggerable Raw Sensor Value `raw_value` — Number triggerable

Garden / Soil

Sensor preset	Common use	Default poll	Channels sent to A-HAP
Capacitive Soil Moisture Sensor	Analog soil moisture sensor for garden and irrigation use.	60 sec	Raw Moisture `raw_moisture` — Number triggerable Moisture Level `moisture_percent` — Number / % triggerable Dry / Wet State `dry_wet_state` — Boolean triggerable

Generic / Custom

Sensor preset	Common use	Default poll	Channels sent to A-HAP
Custom Sensor	User-defined sensor with custom data channels.	60 sec	User-defined channels
Generic Analog Sensor	Generic analog input sensor.	30 sec	Raw Value `raw_value` — Number triggerable Percentage `percentage` — Number / % triggerable Voltage `voltage` — Number / V stored / calculated
Generic Digital Sensor	Generic digital on/off sensor.	10 sec	State `state` — Boolean triggerable

Light

Sensor preset	Common use	Default poll	Channels sent to A-HAP
BH1750 Light Sensor	Digital lux light sensor.	30 sec	Light Level `lux` — Number / lux triggerable
LDR Light Sensor	Analog light-dependent resistor sensor.	30 sec	Raw Light Level `raw_light` — Number triggerable Light Level `light_percent` — Number / % triggerable

Load / Weight

Sensor preset	Common use	Default poll	Channels sent to A-HAP
Force Sensitive Resistor / FSR	Analog force or pressure sensor useful for presence, touch, pressure pad or rough load detection.	10 sec	Raw Force `raw_force` — Number triggerable Force / Pressure `force_percent` — Number / % triggerable Estimated Force `force_n` — Number / N triggerable Pressed / Loaded `pressed` — Boolean triggerable
Generic Load / Weight Sensor	Generic weight, load or strain sensor with user-calibrated output.	10 sec	Weight `weight_kg` — Number / kg triggerable Weight `weight_g` — Number / g triggerable Load Percent `load_percent` — Number / % triggerable Raw Sensor Value `raw_value` — Number stored / calculated Overload `overload` — Boolean triggerable
HX711 Load Cell Amplifier	Common 24-bit ADC module for load cells and strain gauge weight sensors.	10 sec	Weight `weight_kg` — Number / kg triggerable Weight `weight_g` — Number / g triggerable Raw ADC Value `raw_value` — Number stored / calculated Tare Offset `tare_offset` — Number stored / calculated Stable Reading `stable` — Boolean triggerable
HX711 Scale / Four Load Cell Kit	Common bathroom-scale style setup using four load cells through an HX711 amplifier.	10 sec	Weight `weight_kg` — Number / kg triggerable Weight `weight_g` — Number / g triggerable Load Percent `weight_percent` — Number / % triggerable Raw ADC Value `raw_value` — Number stored / calculated Stable Reading `stable` — Boolean triggerable
NAU7802 Load Cell ADC	I2C 24-bit load cell ADC module for weighing, tension and force measurements.	10 sec	Weight `weight_kg` — Number / kg triggerable Weight `weight_g` — Number / g triggerable Raw ADC Value `raw_value` — Number stored / calculated ADC Temperature `temperature` — Number / °C stored / calculated Stable Reading `stable` — Boolean triggerable

Motion / Orientation

Sensor preset	Common use	Default poll	Channels sent to A-HAP
MPU6050 Accelerometer / Gyro	Acceleration, gyroscope and tilt/orientation sensor.	10 sec	Acceleration X `accel_x` — Number / g triggerable Acceleration Y `accel_y` — Number / g triggerable Acceleration Z `accel_z` — Number / g triggerable Gyro X `gyro_x` — Number / °/s triggerable Gyro Y `gyro_y` — Number / °/s triggerable Gyro Z `gyro_z` — Number / °/s triggerable Tilt / Angle Estimate `tilt_angle` — Number / ° triggerable

Motion / Security

Sensor preset	Common use	Default poll	Channels sent to A-HAP
PIR Motion Sensor	Passive infrared motion detection sensor.	10 sec	Motion Detected `motion_detected` — Boolean triggerable
Reed Switch / Door Sensor	Magnetic contact sensor for doors, windows, gates or lids.	10 sec	Open / Closed `open_closed` — Boolean triggerable
SW-420 Vibration Sensor	Vibration or shock detection sensor.	10 sec	Vibration Detected `vibration_detected` — Boolean triggerable Vibration Intensity `vibration_intensity` — Number / % triggerable Raw Sensor Value `raw_value` — Number triggerable

Power Monitoring

Sensor preset	Common use	Default poll	Channels sent to A-HAP
ACS712 Current Sensor	Analog current sensor.	10 sec	Current `current` — Number / A triggerable Raw Voltage `raw_voltage` — Number / V stored / calculated Raw Sensor Value `raw_value` — Number stored / calculated
PZEM-004T Power Sensor	AC voltage, current, power and energy monitoring sensor.	10 sec	Voltage `voltage` — Number / V triggerable Current `current` — Number / A triggerable Power `power` — Number / W triggerable Energy `energy` — Number / kWh stored / calculated Frequency `frequency` — Number / Hz triggerable Power Factor `power_factor` — Number triggerable

Water

Sensor preset	Common use	Default poll	Channels sent to A-HAP
Float Switch	Simple float switch for water level detection.	10 sec	Full / Empty State `full_empty_state` — Boolean triggerable Water Detected `water_detected` — Boolean triggerable
Rain Sensor	Rain or wetness detection module.	30 sec	Rain Detected `rain_detected` — Boolean triggerable Wetness Level `wetness_level` — Number / % triggerable
Water Leak Sensor	Water leak detection sensor.	10 sec	Water Detected `water_detected` — Boolean triggerable Leak State `leak_state` — Boolean triggerable
YF-S201 Flow Sensor	Water flow rate sensor.	10 sec	Flow Rate `flow_rate` — Number / L/min triggerable Total Volume `total_volume` — Number / L triggerable Pulse Count `pulse_count` — Number stored / calculated