hiveeyes / ds18b20-datalogger

A temperature sensor matrix with heatmap visualization for bee hive monitoring, using Raspberry Pi, Linux, Python, DS18B20, MQTT, Kotori DAQ, and Grafana.
https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102
GNU General Public License v3.0
1 stars 0 forks source link
beehive-monitoring ds18b20 grafana kotori-daq linux mqtt raspberry-pi raspberrypi sensor-matrix temperature-sensor

ds18b20-datalogger

A data logger specializing in reading an array of DS18B20 sensors.

A temperature sensor matrix with heatmap visualization for bee hive monitoring, using Raspberry Pi, Linux, Python, DS18B20, MQTT, Kotori DAQ, and Grafana.

View from outside View from inside (sensor tip details)
Außen Innen

Lab protocol and development details: https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102

Project Information

» Documentation | Changelog | PyPI | Issues | Source code | License

CI Coverage Status License Downloads per month

Supported Python versions Status Package version

What's Inside

Synopsis

Acquire single reading, and echo it on STDOUT in JSON format.

ds18b20-datalogger read datalogger.yaml

Take a single reading, and publish it to the configured MQTT topic.

ds18b20-datalogger run datalogger.yaml

Live

In order to see a running system in action, please enjoy inspecting the Live Grafana Dashboard.

Installation

Install the ds18b20-datalogger package from PyPI using pip.

pip install --upgrade ds18b20-datalogger

See also alternative installation methods and hands-on walkthroughs at development sandbox and production setup.

Configuration

In order to operate the data logger successfully, you will need to configure two important details:

You can create a blueprint configuration file by using the make-config subcommand.

ds18b20-datalogger make-config > datalogger.yaml

Appliance: Sensor Wiring and Sensor Mapping

Be aware that you might have to adjust your resistors size. With 30 sensors i had erratic sensor mapping using a 4.7k resistor. I am getting valid mapping using a 2.2k resistor.

Please read more about sensor mapping on our community forum. In practice, just edit the one-wire section within the configuration file according to your setup.

Backend: Telemetry and Visualization

The data logger will publish measurements to an MQTT topic, where Kotori DAQ can pick it up, in order to converge into a timeseries database, and displays it on a Grafana Dashboard.

The package includes a corresponding Grafana Dashboard, which can be created by invoking the make-dashboard subcommand.

ds18b20-datalogger make-dashboard > dashboard.json

On our community forum, you can find relevant discussions about this topic.

Acknowledgements

The original code of this implementation has been discovered on the element14 community forum at [Multiple DS18B20 Temp sensors interfacing with Raspberry Pi], shared by @laluha. Thanks!

Contributing

In order to learn how to start hacking on this program, please have a look at the documentation about how to install a development sandbox.

Contributions of any kind are always welcome and appreciated. Thank you.