Skip to content

Prometheus exporter for Bosch Sensortec temperature, atmospheric pressure and humidity sensors

License

Notifications You must be signed in to change notification settings

David-Igou/bsbmp-exporter

Repository files navigation

bsbmp-exporter

GitHub Workflow Status Go Report Card MIT License

This exporter is made to export readings from Bosch Sensortec BMP180, BMP280, BME280, and BMP388 sensors into a format that can scraped by Prometheus

Currently it exports temperature in Celsius, Percent humidity, Pressure in mmHg and Pascal, and Altitude in Meters above sea level.

Usage

Command line:

./bsbmp-exporter -h
Usage of ./bsbmp-exporter:
  -address="0x76": i2c address of BME/BMP sensor - Verify with i2cdetect -y [bus] - Also can use environment variable MODEL
  -bus=1: Bus of i2c interface (ie 1 for /dev/i2c-1). Also can use environment variable BUS
  -metricspath="/metrics": Path under which to expose metrics. Also can use environment variable METRICSPATH 
  -model="BME280": Model of probe - Current supported models: [bmp180, bme280, bmp280, bmp388] - Also can use environment variable MODEL
  -port="9756": Address to listen on for web interface and telemetry. Also can use environment variable PORT

Docker run

# Currently privileged is required to access /dev/i2c
docker run -p 9756:9756 -v /dev:/dev --privileged quay.io/igou/bsbmp-exporter:latest

Installation

image

To install the sensors onto a Pi, honestly for each model I just googled "[Model number] Raspberry Pi"

Enable the i2c interface via raspi-config

To get the address of the device:

# ls /dev/i2c* #Note device number
/dev/i2c-1
# i2cdetect -y 1 #Because /dev/i2c-1
     0  1  2  3  4  5  6  7  8  9  a  b  c  d  e  f
00:          -- -- -- -- -- -- -- -- -- -- -- -- -- 
10: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- 
70: -- -- -- -- -- -- 76 --                         

This has not (yet!) been tested on Orange/Banana Pis.

Grafana

docs/ contains two dashboards, one requiring a target label bsbmp_group being applied, and a basic one that should work out of the box.

image

Thanks

This exporter heavily relys on d2r2/go-i2c and d2r2/go-bsbmp to talk to the i2c bus and wouldn't have been possible for me without them as I am no expert on that subject.

About

Prometheus exporter for Bosch Sensortec temperature, atmospheric pressure and humidity sensors

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published