#prometheus #sensor #co2 #raspberry-pi #raspberry #mh-z19c

app rpi-mh-z19c-exporter

将Raspberry Pi上 Winsen MH-Z19C传感器测量的CO2浓度导出到Prometheus

6个版本

0.2.2 2023年2月17日
0.2.1 2022年9月24日
0.1.4 2021年10月28日
0.1.3 2021年4月22日

#1725 in 嵌入式开发

MIT/Apache

27KB
372

rpi-mh-z19c-exporter

将连接到Raspberry Pi的 Winsen MH-Z19C CO2传感器测量的CO2读数导出到Prometheus。传感器需要通过UART接口连接。

以下指标将在 https://127.0.0.1:1202/metrics 端点提供

  • co2_ppm:每百万份测量的CO2浓度(ppm)。

端口号的助记符:12在十六进制中是C,0是O,因此1202是CO2。

实现

导出器使用异步Tokio和单个线程实现。对/metrics端点的请求将触发从传感器读取新的测量值。多个并发请求只会触发单个测量,并等待该测量完成。

安装

  1. 从GitHub下载二进制文件或自行编译。
  2. 将其放置在您的Raspberry Pi上,例如在/usr/local/bin/rpi-mh-z19c-exporter,并确保设置了可执行权限。
  3. 使用roles目录中提供的Ansible角色设置服务用户并添加systemd服务。(或者如果您愿意,可以手动进行。)

配置

导出器使用环境变量进行配置

  • RPI_MHZ19C_UART_PATH:连接传感器的UART设备的路径。默认:/dev/ttyAMA0
  • RPI_MHZ19C_EXPORTER_LISTEN_ADDRS:要监听的地址(用空格分隔)。默认:localhost:1202

依赖项

~17–30MB
~481K SLoC