README.MD

Home weather station for Raspberry Pi's sensors with Telegram bot and Grafana dashboard

Observe your apartment's humidity, temperature and CO2 level with Raspberry Pi via Telegram bot or Grafana.

Supported sensors:

• Humidity and temperature: SHT3x-DIS
• CO2 level: MH-Z19B NDIR

Preparing bot

• Create Telegram bot and retrieve the token
• If you need Telegram bot, run application with flag 'weather-station.jar --spring.profiles.active=telegram'
• Set Telegram bot token
  • at application.properties
  • by passing as argument: 'weather-station.jar --telegram.bot.token=YOUR_TOKEN'

Preparing Grafana and Prometheus

• Download and unpack ARM version of Grafana
• Download and unpack ARM version of Prometheus
• Set Prometheus scrape config at prometheus.yml:

- targets: ['localhost:8779']

• Start Prometheus and Grafana

Build and run

• Install Pi4J on your Raspberry Pi
• Connect SHT3x-DIS sensor to your Raspberry Pi
• Connect MH-Z19B NDIR sensor to your Raspberry Pi
• Launch Grafana and Prometheus on your Raspberry Pi
• Build binary, copy it to Raspberry Pi and start

mvn clean install
scp target/weather-station.jar pi@address:/opt/weather-station
scp resources/weather-station.service pi@address:/etc/systemd/system
ssh pi@piaddress 'sudo systemctl daemon-reload'
ssh pi@piaddress 'systemctl enable weather-station.service'
ssh pi@piaddress 'systemctl start weather-station.service'
ssh pi@piaddress '/opt/weather-station/weather-station.jar'
or
ssh pi@piaddress '/opt/weather-station/weather-station.jar --telegram.bot.token=YOUR_TOKEN'

Using

• Open your Telegram bot and call for sensor
• Open Grafana at piaddress:3000

Notes

• Tested on this SHT3x-DIS sensor implementation: http://amperka.ru/product/troyka-meteo-sensor?utm_source=man&utm_campaign=troyka-meteo-sensor&utm_medium=wiki