Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Use this to read and submit sensor values from sensors attached to a Raspberry Pi.

Measurements are read directly through sysfs files provided by the drivers included in the Industrial I/O and Hwmon kernel subsystems.

Supported Sensors

Type Subsystem/Bus required Linux version Raspbian Version
bmp280 (Pressure) IIO/I2C 4.9.60 November 2017
hdc100x (Humidity/Temperature) IIO/I2C 4.9.60 November 2017
tsl4531 (Light intensity) IIO/I2C 4.9.60 November 2017
veml6070 (UV light intensity) IIO/I2C 4.9.60 November 2017
sht3x (Humidity/Temperature) Hwmon/I2C 4.9.65 November 2017


Update your Raspbian. Edit your /boot/config.txt. Enable I2C by uncommenting dtparam=i2c_arm=on.

Add the required device tree overlay instructions. bmp280 and hdc100x support an additional addr argument for changing the I2C address.


Poweroff your Pi, connect the sensors with the Pi. Check your sensors if they need 3.3V or 5V. (Standard senseBox sensors are fine with 5V). Wire the sensors SDA and SCL to the Pis SDA and SCL Pins (usually 3 and 5). Wire 5V and GND.

Boot your pi.

Check if the iio devices are populated $ ls /sys/bus/iio/devices/. If the output says at least iio:device0 iio:device1 iio:device2 iio:device3, you're good to go! Hwmon devices are populated under /sys/class/hwmon.


Download the latest version from the releases page

From source

Install Go, then

$ go get -u


senseboxpi reads its configuration from a json file. By default, it expects a json file called senseboxpi_config.json next to the senseboxpi binary.

Commandline flags

Usage of senseboxpi:
  -c string
    	path of the configuration json (shorthand) (default "senseboxpi_config.json")
  -config string
    	path of the configuration json (default "senseboxpi_config.json")
  -csv-output string
    	path to file where measurements in csv format will be appended
    	operate offline. Do not upload to server

Configuration JSON

The root keys should be _id, postDomain with string values and sensors as array of objects. Each object in sensors has the keys _id, sensorType and phenomenon with string values. Here is an example:

  "_id": "5912f2f051d3460011f57fdd",
  "postDomain": "",
  "sensors": [
      "_id": "5912f2f051d3460011f57fde",
      "phenomenon": "temperature",
      "sensorType": "hdc100x"
      "_id": "5912f2f051d3460011f57fdf",
      "phenomenon": "humidity",
      "sensorType": "hdc100x"
      "_id": "5912f2f051d3460011f57fe0",
      "phenomenon": "pressure",
      "sensorType": "bmp280"
      "_id": "5912f2f051d3460011f57fe1",
      "phenomenon": "light",
      "sensorType": "tsl4531"
      "_id": "5912f2f051d3460011f57fe2",
      "phenomenon": "uv",
      "sensorType": "veml6070"