“Read SHT31” Command-Line Tool

For various sensors, attached to Raspberry-Pi computers, I wrote small command-line tools to read the sensor values over the I2C connection. While you can do this with a Python script directly, I found using a compiled C or C++ program accessing the low-level device more reliable.

The program I publish today, reads temperature and humidity data from a SHT31 sensor. It outputs a simple JSON document you can parse in your script.

Usage

There are a number of arguments you can use:

Usage: read_sht31 [-h][-v]
 -h|--help   Display this help.
 -s          Get the sensor status.
 -t1 -t0     Enable/disable heater.
 -a0 -a1     Select the chip address. 0 is the default.
 -b0 -b1     Select the bus. 1 is the default.
 -d          Show debugging messages.

If you call the command, you will get JSON output:

$ read_sht32
{ "temperature_celsius": 24.8, "relative_humidity": 28.4 }

The idea is to call this command from your script and parse the returned JSON output.

Compile and Install

In order to compile and install the tool on your Raspberry-Pi, you need to install the compiler, CMake and the I2C-Tools first:

sudo apt install gcc cmake i2c-tools

Download the files of this git repository to a subdirectory in your home directory. In this example, I downloaded the files to the directory /home/pi/read_sht31.

Now create a separate build directory. In this example, I create the directory /home/pi/build_read_sht31.

Next switch to the build directory, execute cmake to create the build script. Build the executable with make and install the executable in your system with sudo make install.

cd build_read_sht31
cmake ../read_sht31
make
sudo make install

Download

Download or clone the files from GitHub:

License

The code is licensed under the GPL license version 3.

Available Sensors

The SHT31 sensor is available from various sources as breakout board. Here two examples:

• Adafruit Breakout
• Breakout from DFRobot

Conclusion

Hopefully this small tool will help with your next Raspberry-Pi project. 😄

If you have any questions, missed information, or simply want to provide feedback, feel free to comment below or contact me on Twitter. 😄

More Posts

Huge Storage Boxes Update

Today I release a huge update of my storage boxes system for 3d-print. This update not only further improves the geometries of the models, but also extend the available sizes and variants. There are now ...
Read More

Flawless PCB by Eurocircuits

I got another flawless, perfectly produced PCB by Eurocircuits. This is Revision A of the input panel board I published in the last post. There are only minor changes in the silkscreen and a little ...
Read More

Logic Gates Puzzle 10

The shown logic circuit performs a handy function; can you discover what it is? The circuit was not optimised for functionality, but to create a nice artwork and interesting puzzle. If you need to know ...
Read More

Round Corner Template Set for Woodworking

Sometimes I like to have rounded corners in my woodworking projects. It seems many people like to soften the spiky ends of their panels because there is a huge range of templates for routing. If ...
Read More

Adafruit PowerBoost 1000C Enclosure (LR2165)

I made a simple 3d printed enclosure for Adafruit's PowerBoost 1000C and a 1200mAh or smaller LiPo battery. This post contains all the files you need for the print, a list of components, and assembly ...
Read More

Decorative, Massive, Modular Box

This design is not for everyone. 😅 A decorative and modular, but quite massive box. Built from 3d-printed parts, 5mm plywood panels and plenty 3x10mm wood screws. The instructions in this post show a basic ...
Read More