This custom component integrates the Qingping Pro Air Quality Monitor [CGS1/CGS2] with Home Assistant, allowing you to monitor various environmental parameters in realtime.
- MQTT integration installed and configured.
- Enable MQTT on Qingping AQM devices using instructions below.
- HACS installed.
- Automatic discovery of Qingping CGS1/CGS2 devices
- Real-time updates of air quality data
- Configurable temperature and humidity offsets
- Adjustable update interval
- Automatic unit conversion for temperature
- Device status monitoring
- Battery level monitoring
Note
Before you begin you must enable mqtt on the device. Follow the instructions provided by GreyEarl here.
Client ID, Up Topic and Down Topic must be filled out extacly as shown in example.
After that is complete continue with HACS installation.
- Use HACS to install this integration:
- Download the Qingping Pro AQM repository.
- Restart Home Assistant
- Go to "Configuration" -> "Integrations" and click "+" to add a new integration
- Search for "Qingping Pro AQM" and follow the configuration steps
The integration supports automatic discovery of Qingping CGS1/CGS2 devices.
If your device is not discovered automatically, you can add it manually by providing the MAC address.
-
Device Discovery: The integration uses MQTT to discover Qingping CGS1/CGS2 devices on your network. It listens for messages on the MQTT topic
qingping/#to identify available devices. -
Configuration: Once a device is discovered, you can add it to your Home Assistant instance through the UI. The integration will prompt you to enter a name and model for the device and confirm its MAC address.
-
Sensors: The integration creates several sensors for each Qingping CGS1/CGS2 device:
- Temperature
- Humidity
- CO2 level
- PM2.5
- PM10
- TVOC (ppb, ppm and mg/m³)
Only on CGS1 - eTVOC (ppb, VOC index and mg/m³)
Only on CGS2 - Noise level
Only on CGS2 - Battery level
- Device status (online/offline)
- Firmware version
- Report type (12 = realtime / 17 = historic)
- MAC address
-
TVOC Sensor: The sensor can be set to 3 different measurement units, by default it is ppb. The component converts from ppb to get ppm and mg/m³.
- ppm = ppb/1000
- mg/m³ = ppb/1000 * 0.0409 * 111.1 (concentration (ppm) x 0.0409 x molecular weight)
eTVOC Sensor: The sensor can be set to 3 different measurement units, by default it is VOC index. The component converts from voc index to get ppb and mg/m³.
- ppb = (index * 5) + 35
- mg/m³ = (index * 0.023) + 0.124
-
Data Updates: The component subscribes to MQTT messages from the device. When new data is received, it updates the relevant sensors in Home Assistant.
-
Offset Adjustments: The integration allows you to set offset values for temperature and humidity readings. These offsets are applied to the raw sensor data before it's displayed in Home Assistant.
-
Update Interval: You can configure how often the device should report new data. This is done through a number entity that allows you to set the update interval in seconds.
-
Configuration Publishing: The integration periodically publishes configuration messages to the device via MQTT. This ensures that the device maintains the correct reporting interval, realtime reporting and other settings.
-
Status Monitoring: The integration tracks the device's online/offline status based on the timestamp of the last received message. If no message is received for 5 minutes, the device is considered offline.
-
Unit Conversion: The integration automatically converts temperature readings to the unit system configured in your Home Assistant instance (Celsius or Fahrenheit).
If you encounter any issues:
- Check that your Qingping CGS1/CGS2 device can send data via MQTT
- Ensure MQTT is set up on each device as instructed
- Ensure that MQTT is properly set up in your Home Assistant instance
- Check the Home Assistant logs for any error messages related to this integration
Contributions to this project are welcome! Please feel free to submit a Pull Request.
If you have any questions or need help, please open an issue on GitHub.