https://github.com/vitexsoftware/thermoservice
Temperature sharing service for DS18B20
https://github.com/vitexsoftware/thermoservice
Last synced: about 1 month ago
JSON representation
Temperature sharing service for DS18B20
- Host: GitHub
- URL: https://github.com/vitexsoftware/thermoservice
- Owner: VitexSoftware
- License: mit
- Created: 2022-08-25T21:25:05.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-08-27T23:06:12.000Z (over 3 years ago)
- Last Synced: 2025-02-14T22:38:33.906Z (about 1 year ago)
- Language: Python
- Size: 85 KB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# thermoservice
Temperature sharing service for DS18B20
## Installation
### Debian / Ubuntu
```bash
sudo curl -fsSL http://repo.vitexsoftware.com/KEY.gpg -o /usr/share/keyrings/vitexsoftware-archive-keyring.gpg && \
echo "Types: deb
URIs: http://repo.vitexsoftware.com/
Suites: $(lsb_release -sc)
Components: main
Signed-By: /usr/share/keyrings/vitexsoftware-archive-keyring.gpg" | sudo tee /etc/apt/sources.list.d/vitexsoftware.sources
sudo apt update
sudo apt install thermoservice
```
### Zabbix Integration
To enable Zabbix monitoring of temperature sensors:
```bash
sudo apt install thermometer-zabbix
```
This installs Zabbix Agent configuration that provides the following user parameters:
- `sensor.temp.value` - Current temperature in Celsius
- `sensor.temp.celsius` - Current temperature in Celsius
The Zabbix agent will automatically restart after installation to load the new configuration.
**Zabbix Template:**
A pre-configured Zabbix 7.4 template is available in the repository at `zabbix_template_thermoservice.yaml`. Import this template into your Zabbix server to automatically configure:
- Temperature monitoring items
- Threshold triggers (high temperature, freezing, no data alerts)
- Temperature trend graphs
To use the template:
1. Import `zabbix_template_thermoservice.yaml` into Zabbix
2. Assign the "DS18B20 Temperature Sensor" template to your host
3. Temperature data will be collected automatically
## Usage
Run command `thermo` to print current temperature to stdout:
```bash
$ thermo
23.125
```
The service automatically starts and exposes a web interface on port 5000, displaying the current temperature from the DS18B20 sensor.
## Description
Thermoservice is a lightweight Flask-based web service designed for Raspberry Pi and similar devices equipped with DS18B20 temperature sensors. It reads temperature data from the 1-Wire interface and provides both a command-line tool and a web interface for monitoring temperature readings.
**Features:**
- Simple command-line temperature reading with `thermo` command
- Web interface on port 5000 for real-time temperature display with cyberpunk futuristic design
- Systemd service integration for automatic startup
- Designed for DS18B20 digital temperature sensors
- Graceful handling when no sensor hardware is detected
- Optional Zabbix Agent integration for monitoring (thermometer-zabbix package)
- Pre-configured Zabbix 7.4 template with triggers and graphs
**Requirements:**
- DS18B20 temperature sensor connected via 1-Wire interface
- Raspberry Pi or compatible device with 1-Wire support enabled