Back to Tasmota

Sensirion I²C SCD30 Arduino Library

lib/lib_i2c/arduino-i2c-scd30/README.md

15.5.05.4 KB
Original Source

Sensirion I²C SCD30 Arduino Library

This is the Sensirion SCD30 library for Arduino allowing you to communicate with a SCD30 sensor over I²C.

Click here to learn more about the Sensirion SCD30 sensor.

The default I²C address of SCD30 is 0x61.

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 I2C SCD30 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

Connect the sensor

Use the following pin description to connect your SCD30 to the standard I²C bus of your Arduino board:

PinCable ColorNameDescriptionComments
1redVDDSupply Voltage3.3V to 5.5V
2blackGNDGround
3yellowSCLI2C: Serial clock input
4greenSDAI2C: Serial data input / output
5RDYHigh when data is available - do not connect
6PWMdo not connect
7blueSELInterface selectPull to ground or floating for I2C

The recommended voltage is 3.3V.

Board specific wiring

You will find pinout schematics for recommended board models below:

<details><summary>Arduino Uno</summary> <p>
SCD30SCD30 PinCable ColorBoard Pin
VDD1red3.3V
GND2blackGND
SCL3yellowD19/SCL
SDA4greenD18/SDA
RDY5
PWM6
SEL7blueGND
</p> </details> <details><summary>Arduino Nano</summary> <p>
SCD30SCD30 PinCable ColorBoard Pin
VDD1red3.3V
GND2blackGND
SCL3yellowA5
SDA4greenA4
RDY5
PWM6
SEL7blueGND
</p> </details> <details><summary>Arduino Micro</summary> <p>
SCD30SCD30 PinCable ColorBoard Pin
VDD1red3.3V
GND2blackGND
SCL3yellow~D3/SCL
SDA4greenD2/SDA
RDY5
PWM6
SEL7blueGND
</p> </details> <details><summary>Arduino Mega 2560</summary> <p>
SCD30SCD30 PinCable ColorBoard Pin
VDD1red3.3V
GND2blackGND
SCL3yellowD21/SCL
SDA4greenD20/SDA
RDY5
PWM6
SEL7blueGND
</p> </details> <details><summary>ESP32 DevKitC</summary> <p>
SCD30SCD30 PinCable ColorBoard Pin
VDD1red3V3
GND2blackGND
SCL3yellowGPIO 22
SDA4greenGPIO 21
RDY5
PWM6
SEL7blueGND
</p> </details>

Quick Start

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

  2. Connect the SCD30 sensor to your Arduino as explained in Connect the sensor

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

    FileExamplesSensirion I2C SCD30exampleUsage

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

  5. 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.

Contributing

Contributions are welcome!

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.

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

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

Known issues

  • softReset(): After using the softReset() function on an Arduino MKR WIFI 1010, subsequent commands are no longer acknowledged. The I2C line remains low after receiving the first command byte.

    To make the provided example work on the Arduino MKR WIFI 1010, the call to softReset() and the subsequent delay() can be removed.

License

See LICENSE.