This is a fork of co2mon with docker support
Build docker image:
docker build . -t co2-image --no-cache
Run:
docker run -d --name co2 -p 23123:80 --device=/dev/bus/usb/001/004 debug-image
Also, you can run this image using docker-compose (customize device path and exposed port):
docker-compose up -d
After that, you can access metrics exposed at http://host_ip:23123/metrics
Notice, that you have to forward usb device into container. You can use lsusb to find out which device should be forwarded. For example, my device shows as Bus 001 Device 004: ID 04d9:a052 Holtek Semiconductor, Inc. USB-zyTemp. This means my device path is /dev/bus/usb/001/004.
This service exposes prometheus metrics, so it's very easy to collect them and visualize using grafana:
This software supports compact USB-powered CO2 meters that identify as:
idVendor 0x04d9 Holtek Semiconductor, Inc.
idProduct 0xa052 USB-zyTemp
A of 2023, there are two revisions of these product on the market, that can be distinguished by its serial and release numbers:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
old new
――――――――――――――――――――――――――――――――――
serial_number 1.40 2.00
release_number 0x0100 0x0200
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
(where serial_number == iSerial and release_number == bcdDevice)
The co2mon software tries to auto-detect them, but its also possible to
override the detection (cf. the -N and -n options).
Note that these devices are rebranded by vendors such as TFA and thus are available online under different product names (e.g. sold by Amazon, as of 2023). Even if one user reported success with a certain product, the vendor might have silently switched to a completely different and unsupported hardware without changing the product name, at any time.
List of user reported devices that worked in the past:
- TFA AIRCO2NTROL MINI CO2 Monitor (EAN 4009816027351), via Amazon.de, 2023
There is PKGBUILD in AUR. The simplest way to install is using yaourt:
yaourt -S co2mon-git
co2mon packages can be installed from official repo:
dnf install co2mon
# macOS
brew install cmake pkg-config hidapi
# Ubuntu
apt-get install cmake g++ pkg-config libhidapi-dev
mkdir build
cd build
cmake ..
make
./co2mond/co2mond