Qingping Pro AQM [CGS1] integration for Home Assistant

This custom component integrates the Qingping Pro Air Quality Monitor [CGS1] with Home Assistant, allowing you to monitor various environmental parameters in realtime.

Requirements

MQTT integration installed and configured.
Enable MQTT on Qingping AQM devices using instructions below.
HACS installed.

Features

Automatic discovery of Qingping CGS1 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

Installation

[!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

Configuration

How it Works

Device Discovery: The integration uses MQTT to discover Qingping CGS1 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 for the device and confirm its MAC address.
Sensors: The integration creates several sensors for each Qingping CGS1 device:
- Temperature
- Humidity
- CO2 level
- PM2.5
- PM10
- TVOC (ppb, ppm and mg/m³)
- 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)
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).

Troubleshooting

If you encounter any issues:

Check that your Qingping CGS1 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