SDS011 library for Raspberry Pi

===========================================================

A program to set instructions and get information from an SDS-011 running on linux.
V1 was written in C and contains a flexible command-line options.
V2 is optimized and written in C++
A detailed description of the many options and findings are in sds011.odt

Getting Started

As part of a larger project I am looking at analyzing and understanding the air quality. I have done a number of projects on air-sensors. The SDS-011 sensor has been around for a longer time and there are many articles and drivers to connect to Arduino and/or from Python. However I wanted to create a C-language version to connect the DYLOS 1700 and SCD30 at the same time and compare the results. The challenge was larger than expected.

I have tested this on a Raspberry PI running Raspbian Jessie release and Ubunut 18.04. It has been adjusted and extended for stable working.

Prerequisites

No dependency on other libraries

Software installation

• Copy the files in a directory
• 'make' command will create an executable call sds

Program usage

• To get help type ./sds -h
• to get output: connect the SDS011 to USB and type sudo ./sds -o

Program options

SDS-011 Options:

• -m get current working mode
• -p get current working period
• -r get current reporting mode
• -d get Device ID
• -f get firmware version
• -q use query reporting mode (default : continous)

SDS-011 setting:

• -M [ S / W ] Set working mode (sleep or work)
• -P [ 0 - 30 ] Set working period (minutes)
• -R [ Q / R ] Set reporting mode (query or reporting)
• -D [ 0xaabb ] Set new device ID

Program setting:

• -l x loop x times ( 0 = endless) (default : 10 loops)
• -w x x seconds between query data (default : 5 seconds)
• -H # set correction for humidity (e.g. 33.5 for 33.5%)
• -u device set new device (default : /dev/ttyUSB0)
• -b set no color output (default : color)
• -h show help info
• -v set verbose / debug info (default : NOT set)

Versioning

version 2.1 /October 2023

• fixed issue with failing wakeup after setting to sleep

version 2.0 / May 2019

• changed to better sturuct between user level and supporting library
• change to C++ file structure
• enhanced debugging

version 1.1 / February 2019

• set reporting mode to query included in -q option
• set reporting mode to stream included in -o option

version 1.0 / January 2019

• Initial version for Raspberry Pi and Ubuntu

Author

• Paul van Haastrecht (paulvha@hotmail.com)

License

This project is licensed under the GNU GENERAL PUBLIC LICENSE 3.0

Acknowledgements

A starting point and still small part of this code is based on the work by karl, found on: github https://github.com/karlchen86/SDS011