Skip to content

Latest commit

 

History

History
104 lines (70 loc) · 3.23 KB

README.md

File metadata and controls

104 lines (70 loc) · 3.23 KB
Raw

Software for CO2 Monitor

Info about fork

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.

Grafana

This service exposes prometheus metrics, so it's very easy to collect them and visualize using grafana:

grafana dashboard preview

Compatible Devices

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

Installation

Arch Linux

There is PKGBUILD in AUR. The simplest way to install is using yaourt:

yaourt -S co2mon-git

Fedora GNU/Linux and RHEL/CentOS/Scientific Linux

co2mon packages can be installed from official repo:

dnf install co2mon

From Source

# 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

See also