Home

Awesome

Sensirion UART SVM4X Arduino Library

This is the Sensirion SVM4X library for Arduino allowing you to communicate with a SVM4X evaluation kit over UART using the SHDLC protocol.

<img src="images/svm4x.png" width="300px">

Click here to learn more about the Sensirion SVM4X evaluation kit.

The SVM4x evaluation kit covers evaluation of the SGP40 and SGP41 sensors. This driver supports SVM4x firmware version 3.1.0 and above.

Installation of the library

This library can be installed using the Arduino Library manager: Start the Arduino IDE and open the Library Manager via

SketchInclude LibraryManage Libraries...

Search for the Sensirion UART SVM4X library in the Filter your search... field and install it by clicking the install button.

If you cannot find it in the library manager, download the latest release as .zip file and add it to your Arduino IDE via

SketchInclude LibraryAdd .ZIP Library...

Don't forget to install the dependencies listed below the same way via library manager or Add .ZIP Library

Dependencies

Sensor wiring

Connecting the Sensor

Use the following pin description to connect your SVM4X to your Arduino board:

<img src="images/svm41-pinout-uart.png" width="300px">
PinCable ColorNameDescriptionComments
1redVDDSupply Voltage3.3 or 5V
2blackGNDGround
3greenRXUART: Transmission pin for communication
4yellowTXUART: Receiving pin for communication
5blueSELInterface selectLeave floating or pull to VDD to select UART
6purpleNCDo not connect

Board-specific wiring

We recommend using Arduino Boards or an ESP supporting two or more hardware serial connections to run the example code. One serial port is needed to connect the SVM4X sensor and the other one (over USB) for logging to the Serial Monitor of the Arduino IDE.

Arduino Uno, Micro and Nano have only one hardware serial connection and are therefore not recommended to use. There is the option to use the SoftwareSerial library to emulate a serial connection, but it does not work reliably to communicate with the sensor at the required baudrate of 115200 baud. However, you can connect your sensor over the hardware serial connection and use the SoftwareSerial library to set up a connection for logging to the host.

You will find pinout schematics for recommended board models below:

<details><summary>Arduino Mega 2560 Rev3 Pinout</summary> <p>
SVM4XSVM4X PinCable ColorBoard Pin
VDD1red5V
GND2blackGND
RX3greenD18 (TX1)
TX4yellowD19 (RX1)
SEL5blueDo not connect

Note: Make sure to connect serial pins as cross-over (RX pin of sensor -> TX pin on Arduino; TX pin of sensor -> RX pin on Ardunio)

<img src="images/Arduino-Mega-2560-Rev3-uart-pinout-5V.png" width="600px"> </p> </details> <details><summary>Espressif ESP32-DevKitC Pinout</summary> <p>
SVM4XSVM4X PinCable ColorBoard Pin
VDD1red5V
GND2blackGND
RX3greenGPIO17 (TXD 2)
TX4yellowGPIO16 (RXD 2)
SEL5blueDo not connect

Note: Make sure to connect serial pins as cross-over (RX pin of sensor -> TX pin on ESP; TX pin of sensor -> RX pin on ESP)

<img src="images/esp32-devkitc-uart-pinout-5V.png" width="600px"> </p> </details>

Quick start example

  1. Install the libraries and dependencies according to Installation of the library

  2. Connect the SVM4X sensor as explained in Sensor wiring

  3. Load the exampleUsage sample project within the Arduino IDE:

    FileExamplesSensirion UART SVM4XexampleUsage

  4. Depending on your Arduino board you may need to adapt the code sample. See the board specific instruction section for more information.

  5. Make sure to select the correct board model under ToolsBoards and the connected USB port under ToolsPort.

  6. Click the Upload button in the Arduino IDE or SketchUpload

  7. When the upload process has finished, open the Serial Monitor or Serial Plotter via the Tools menu to observe the measurement values. Note that the Baud Rate in the used tool has to be set to 115200 baud.

Board-specific instructions

<details><summary>Arduino Mega 2560</summary> <p>

Serial Interface

The provided wiring instructed you to connect the SVM4X to Serial Port 1. Therefore, the following line needs to be used in the usage example code:

#define SENSOR_SERIAL_INTERFACE Serial1

</p> </details> <details><summary>Espressif ESP32-DevKitC</summary> <p>

ESP32 Library

The ESP32 board is not supported by default with Arduino IDE. If it is your first time using an ESP32 board, you should follow this guide from Espressif itself.

Serial Interface

The provided wiring instructed you to connect the sensor to Serial Port 2.

Since ESP boards require HardwareSerial implementation, you need to include the following lines in the usage example code:

#include <HardwareSerial.h>
HardwareSerial HwSerial(2);
#define SENSOR_SERIAL_INTERFACE HwSerial
</p> </details> <details><summary>Emulated serial connection for logging (Arduino Uno, Arduino Nano, Arduino Micro)</summary> <p> Use following instructions if your board has only one hardware serial port and you want to emulated a serial connection for logging to the host using the SoftwareSerial library. </p> </details>

Contributing

Contributions are welcome!

We develop and test this driver using our company internal tools (version control, continuous integration, code review etc.) and automatically synchronize the master branch with GitHub. But this doesn't mean that we don't respond to issues or don't accept pull requests on GitHub. In fact, you're very welcome to open issues or create pull requests :)

This Sensirion library uses clang-format to standardize the formatting of all our .cpp and .h files. Make sure your contributions are formatted accordingly:

The -i flag will apply the format changes to the files listed.

clang-format -i src/*.cpp src/*.h

Note that differences from this formatting will result in a failed build until they are fixed.

License

See LICENSE.