“Read SGP30” Command-Line Tool

I published another small command-line tool for Raspberry-Pi. This time one to read data from the Sensirion SGP30 sensor.

While you can communicate over I2C with sensors using Python, I found it not as reliable as using compiled C or C++ programs. To combine the two worlds, I started writing really small command-line tools, which do the communication with the sensors.

These tools give you a lot of flexibility. You can call them on the command-line directory, to test if the sensors are working as expected. Or, you call them from your python scripts and parse the returned JSON data.

Usage

If you call the tool with no arguments, it will read the current measurements.

pi:~ $ read_sgp30 
{ "co2_ppm": 861, "tvoc_ppb": 145 }

With the argument -h or --help, you will get a list of possible actions and options.

pi:~ $ read_sgp30 --help
Usage: read_sgp30 [arguments]
 -h --help    Display this help.
 -v --version Display the application version.
 -r           Read the measurements (default).
 -i           Initialize the measurements.
 -t           Perform a measurement test.
 -s           Read serial number.
 -z           Reset the sensor (and other sensors on the same bus!).
 -xs          Store the iAQ baseline.
 -xr          Restore the iAQ baseline.
 -b0 -b1      Select the bus. 1 is the default.
 -d           Show debugging messages.

How to Compile and Install the Tool

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

pi:~ $ sudo apt install gcc cmake i2c-tools

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

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

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 using sudo make install.

pi:~/ $ cd build_read_sgp30
pi:~/build_read_sgp30/ $ cmake ../read_sgp30
pi:~/build_read_sgp30/ $ make
pi:~/build_read_sgp30/ $ sudo make install

Download

Download or clone the repository from GitHub:

License

The code is licensed under the GPL license version 3.

Available Sensors

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

• Pimoroni SGP30 Board
• Adafruit SGP30 Board

Conclusion

As a software-architect, I always split large software into small and easy to maintain modules. It makes my life, and the life of the support staff easier. Using small tools, which can be combined into a large complex system, is one of the main philosophies of Unix. 😎

I hope, if this tool may not be exactly what you need, it will at least inspire you to write modular software. Have a look at the well documented code, it will provide you a good base to write similar tools.

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

Let’s Print a Cat/Pet Feeding Device (Part 4)

This is the fourth part of the series. In this part we insert the insets in the previously printed parts, print the lids and talk about the front panel. If you missed one of the ...
Read More

Regular Storage Boxes Update

The regular storage boxes set got an update today. All existing boxes are now available in a new revision with an improved corner design and there are four new boxes in the set. The title ...
Read More

Pet Feeder Update

A short update about the progress with the sensor panel and photos of the final input panel board. I assembled the new boards and are testing the sensors. As soon as all tests are done, ...
Read More

Storage Box for 45º Belt Printer?

I created a version of my storage box for 45º belt printing. It would be ideal for mass production. Because I do not own a belt printer, this design is a wild guess. If you ...
Read More

Pet Feeder – Position Sensor Tests

I worked on testing the sensor board. The first tests I did were about the position sensor. Recap Let me recap the design of the position sensor in the device: The turntable has five position ...
Read More

Electronics Invisibly Embedded in 3D Prints

After successfully embedding magnets, I started experimenting embedding whole PCB boards into prints. I am sure, this is no new idea, but I found it very interesting. From the outside, the printed object looks solid ...
Read More