-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
49 additions
and
31 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,59 +1,77 @@ | ||
| # temp-matrix | ||
| Temperature sensor matrix using Raspberry Pi, DS18B20, MQTT, Kotori DAQ, | ||
| and Grafana. For bee hive monitoring. | ||
|
|
||
| | View from outside | View from inside (sensor tip details) | | ||
| |:----:|:----:| | ||
| |  |  | | ||
|
|
||
| # temp-matrix | ||
| temperature matrix based on raspberry pi, python, 5x6 ds18b20, and grafana | ||
|
|
||
| for development details see: [https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102/14](https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102/14) | ||
| Lab protocol and development details: | ||
| https://community.hiveeyes.org/t/laborprotokoll-4x5-temp-matrix-mit-ds18b20/5102 | ||
|
|
||
|
|
||
| ## What's Inside | ||
| * README.md - this file | ||
| * LICENSE | ||
| * temp-matrix_5x6.py - sensor reading and data logging to hiveeyes | ||
| * temp-matrix_5x6-grafana_desktop.json - description of [Grafana Dashboard](https://swarm.hiveeyes.org/grafana/d/T49wHSaIk/mois-ex-wtf-test-ds18b20-5x6-temp-matrix-svg-pixmap?orgId=2&from=1712771622514&to=1712807415379) | ||
|
|
||
|
|
||
| ## Setup | ||
| We recommend to install the program into a Python virtualenv. | ||
| ```shell | ||
| python3 -m venv .venv | ||
| source .venv/bin/activate | ||
| pip install 'ds18b20-datalogger @ git+https://github.com/hiveeyes/temp-matrix.git' | ||
| ``` | ||
|
|
||
| ## files | ||
| * README.md - this file | ||
| * LICENSE | ||
| * temp-matrix_5x6.py - sensor reading and data logging to hiveeyes | ||
| * temp-matrix_5x6-grafana_desktop.json - description of [grafana desktop](https://swarm.hiveeyes.org/grafana/d/T49wHSaIk/mois-ex-wtf-test-ds18b20-5x6-temp-matrix-svg-pixmap?orgId=2&from=1712771622514&to=1712807415379) | ||
| In this spirit, you keep the installation separate from your system Python, so | ||
| you can easily nuke it and start from scratch in case anything goes south. | ||
|
|
||
| ## sensor wiring | ||
| be aware that you might have to ajust 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. | ||
| Prerequisites: This program needs the `paho-mqtt` package. | ||
| https://pypi.org/project/paho-mqtt/#installation | ||
|
|
||
| ## sensor mapping | ||
| [https://community.hiveeyes.org/t/ds18b20-temperatur-sensoren-am-one-wire-bus-anordnen/1399 | ||
| ](https://community.hiveeyes.org/t/ds18b20-temperatur-sensoren-am-one-wire-bus-anordnen/1399) | ||
|
|
||
| ## data publishing | ||
| paho-mqtt required: [https://pypi.org/project/paho-mqtt/#installation](URL) | ||
| ## Operations | ||
|
|
||
| ### Sensor Wiring | ||
| 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. | ||
|
|
||
| ### Sensor Mapping | ||
| https://community.hiveeyes.org/t/ds18b20-temperatur-sensoren-am-one-wire-bus-anordnen/1399 | ||
|
|
||
| ### Data Publishing | ||
|
|
||
| ssh youruser@yourpi | ||
| screen | ||
| cd temp-matrix | ||
| source paho-mqtt/bin/activate | ||
| python temp-matrix_5x6.py` | ||
|
|
||
| ### mqtt data upload to hiveeyes | ||
| [https://community.hiveeyes.org/t/daten-per-mqtt-und-python-ans-backend-auf-swarm-hiveeyes-org-ubertragen/94/6](https://community.hiveeyes.org/t/daten-per-mqtt-und-python-ans-backend-auf-swarm-hiveeyes-org-ubertragen/94/6) | ||
| ### MQTT data upload to Hiveeyes | ||
| https://community.hiveeyes.org/t/daten-per-mqtt-und-python-ans-backend-auf-swarm-hiveeyes-org-ubertragen/94/6 | ||
|
|
||
| ### format your array | ||
| [https://community.hiveeyes.org/t/how-to-visualize-2-dimensional-temperature-data-in-grafana/974/9 | ||
| ](https://community.hiveeyes.org/t/how-to-visualize-2-dimensional-temperature-data-in-grafana/974/9) | ||
| ### Format your array | ||
| https://community.hiveeyes.org/t/how-to-visualize-2-dimensional-temperature-data-in-grafana/974/9 | ||
|
|
||
| matrix = [[temp_ir_1_1, temp_ir_1_2, temp_ir_1_3, temp_ir_1_4, temp_ir_1_5, temp_ir_1_6], \ | ||
| [temp_ir_2_1, temp_ir_2_2, temp_ir_2_3, temp_ir_2_4, temp_ir_2_5, temp_ir_2_6], \ | ||
| [temp_ir_3_1, temp_ir_3_2, temp_ir_3_3, temp_ir_3_4, temp_ir_3_5, temp_ir_3_6], \ | ||
| [temp_ir_4_1, temp_ir_4_2, temp_ir_4_3, temp_ir_4_4, temp_ir_4_5, temp_ir_4_6], \ | ||
| [temp_ir_5_1, temp_ir_5_2, temp_ir_5_3, temp_ir_5_4, temp_ir_5_5, temp_ir_5_6]] | ||
|
|
||
| ## data visualizing (grafana) | ||
| [https://swarm.hiveeyes.org/grafana/d/Y9PcgE4Sz/mois-ex-wtf-test-ir-sensor-svg-pixmap-copy | ||
| ](https://swarm.hiveeyes.org/grafana/d/Y9PcgE4Sz/mois-ex-wtf-test-ir-sensor-svg-pixmap-copy) | ||
|
|
||
| ## bonus: sensors offsets | ||
| [https://community.hiveeyes.org/t/temperatursensoren-justieren-kalibrieren/1744/2 | ||
| ](https://community.hiveeyes.org/t/temperatursensoren-justieren-kalibrieren/1744/2) | ||
|
|
||
|
|
||
| ## Data visualization in Grafana | ||
| https://swarm.hiveeyes.org/grafana/d/Y9PcgE4Sz/mois-ex-wtf-test-ir-sensor-svg-pixmap-copy | ||
|
|
||
| ## Bonus: Sensor offsets | ||
| https://community.hiveeyes.org/t/temperatursensoren-justieren-kalibrieren/1744/2 | ||
|
|
||
| ## 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](./docs/sandbox.md). | ||
|
|
||
| Contributions of any kind are always welcome and appreciated. Thank you. |