跳转到主要内容

一种专注于读取DS18B20传感器数组的专用数据记录器。

项目描述

ds18b20-datalogger

一种专注于读取DS18B20传感器数组的专用数据记录器。

使用Raspberry Pi、Linux、Python、DS18B20、MQTT、Kotori DAQ和Grafana的蜂箱监控温度矩阵,具有热图可视化。

外部视图 内部视图(传感器尖端详情)
Außen Innen

实验室协议和开发详情: https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102

项目信息

» 文档 | 变更日志 | PyPI | 问题 | 源代码 | 许可证

CI Coverage Status License Downloads per month

Supported Python versions Status Package version

内部内容

  • ds18b20-datalogger 程序,读取 DS18B20 传感器并将读取到的数据以 JSON 格式发布到 MQTT。
  • 配置文件采用 YAML 格式,例如 datalogger.yaml
  • 相应 Grafana 仪表板的 JSON 表示形式 grafana-dashboard.json,当通过 Kotori DAQ 提交和获取测量数据时。

概述

获取单个读取值,并以 JSON 格式在 STDOUT 上输出。

ds18b20-datalogger read datalogger.yaml

获取单个读取值,并将其发布到配置的 MQTT 主题。

ds18b20-datalogger run datalogger.yaml

实时

为了查看运行中的系统,请享受检查 实时 Grafana 仪表板

安装

使用 pip 从 PyPI 安装 ds18b20-datalogger 包。

pip install --upgrade ds18b20-datalogger

请参阅 开发沙盒生产设置 中的替代安装方法和实战教程。

配置

为了成功运行数据记录器,您需要配置两个重要细节

  • 传感器:将单总线传感器的 sysfs 路径映射到自分配的传感器名称。
  • 遥测:调整 MQTT 连接设置和 MQTT 主题。

您可以使用 make-config 子命令创建蓝图配置文件。

ds18b20-datalogger make-config > datalogger.yaml

设备:传感器布线和传感器映射

请注意,您可能需要调整电阻的大小。使用 30 个传感器时,我用 4.7k 电阻进行了不稳定的传感器映射。我使用 2.2k 电阻获取有效的映射。

请在我们的社区论坛上了解更多关于 传感器映射 的信息。在实际应用中,只需根据您的设置编辑配置文件中的 one-wire 部分。

后端:遥测和可视化

数据记录器将测量数据发布到 MQTT 主题,其中 Kotori DAQ 可以获取它,以便合并到时序数据库中,并在 Grafana 仪表板上显示。

该软件包包含相应的 Grafana 仪表板,可以通过调用 make-dashboard 子命令创建。

ds18b20-datalogger make-dashboard > dashboard.json

在我们的社区论坛上,您可以找到关于此主题的相关讨论。

致谢

此实现的原代码已在 element14 社区论坛上发现,请参阅 Multiple DS18B20 Temp sensors interfacing with Raspberry Pi,由 @laluha 分享。谢谢!

贡献

要了解如何开始修改此程序,请参阅有关如何安装 开发沙盒 的文档。

欢迎并感谢任何形式的贡献。

项目详情


下载文件

下载适用于您的平台文件。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源分布

ds18b20_datalogger-0.0.4.tar.gz (64.2 KB 查看哈希

上传于 源代码

构建发行版

ds18b20_datalogger-0.0.4-py3-none-any.whl (48.4 kB 查看哈希值)

上传于 Python 3

支持