https://github.com/bitrate16/qingping
python tools for qingping air monitor
https://github.com/bitrate16/qingping
iot library module python qingping qingping-tools tool tools
Last synced: 5 months ago
JSON representation
python tools for qingping air monitor
- Host: GitHub
- URL: https://github.com/bitrate16/qingping
- Owner: bitrate16
- License: agpl-3.0
- Created: 2025-08-04T20:19:43.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-07T09:34:14.000Z (10 months ago)
- Last Synced: 2025-09-29T09:25:49.137Z (9 months ago)
- Topics: iot, library, module, python, qingping, qingping-tools, tool, tools
- Language: Python
- Homepage:
- Size: 27.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# qingping client library
Tool for configuring your Qingping Air Monitor Lite without internet or app.
# WARNING
**Carefully check your device model before use. Author is not responsible for possible damage or device bricking.**
In practive device can not be killed by bluetooth packets, but incompatibilities between firmware and/or hardware may cause fatal damage when operating on unknown opcodes. You must understand and accept the risks before using this utility.
# How to use
Install with
```bash
pip install qingping
```
If you want to connect your device to your MQTT server, put it into pairing mode and do
```bash
python3 -m qingping.bluetooth \
--verbose \
--mac MAC__ADDRESS__HERE \
--wifi-ssid "WIFI__SSID__HERE" \
--wifi-password "WIFI__PASSWORD__HERE" \
--link-token "00112233445566778899AABBCCDDEEFF" \
--mqtt-host "MQTT__HOST__HERE" \
--mqtt-port 1883 \
--mqtt-login qingping \
--mqtt-password qingping \
--mqtt-client "MQTT__CLIENT__HERE" \
--mqtt-read "MQTT__TOPIC__READ__HERE" \
--mqtt-write "MQTT__TOPIC__WRITE__HERE"
```
Optionally change `mqtt-login`, `mqtt-pasword` and `link-token`.
You can export metrics to influxdb with this tool: https://github.com/bitrate16/qingping-influxdb
# Supported devices
Currently supported devices:
- Qingping Air Monitor Lite (CGDN1)
# Features
* Full offline device setup
* Support of all (known) bluetooth commands with docs and examples
* Support of all (known) MQTT configuration commands with docs and examples
* Library and a standalone script
# Bluetooth
See [bluetooth.md](bluetooth.md)
# Pipeline
Connection pipeline described [pipeline.md](pipeline.md)
# TODO:
- Discover other packet types
- Documentation for MQTT commands
- Support cli configuration over MQTT
# License
```
qingping - python tools for air monitor
Copyright (C) 2025 bitrate16 (bitrate16@gmail.com)
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Affero General Public License for more details.
You should have received a copy of the GNU Affero General Public License
along with this program. If not, see .
```