https://github.com/sensirion/raspberry-pi-i2c-sgp40
The SGP40 is Sensirion’s new digital VOC (volatile organic compounds) sensor designed for easy integration into air purifiers or demand-controlled ventilation.
https://github.com/sensirion/raspberry-pi-i2c-sgp40
driver i2c raspberry-pi sensirion sgp sgp40 sgp40-sensor voc
Last synced: 6 months ago
JSON representation
The SGP40 is Sensirion’s new digital VOC (volatile organic compounds) sensor designed for easy integration into air purifiers or demand-controlled ventilation.
- Host: GitHub
- URL: https://github.com/sensirion/raspberry-pi-i2c-sgp40
- Owner: Sensirion
- License: bsd-3-clause
- Created: 2021-08-09T07:11:31.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-05-23T18:21:29.000Z (about 2 years ago)
- Last Synced: 2025-01-30T02:11:10.528Z (over 1 year ago)
- Topics: driver, i2c, raspberry-pi, sensirion, sgp, sgp40, sgp40-sensor, voc
- Language: C
- Size: 331 KB
- Stars: 2
- Watchers: 5
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Sensirion Raspberry Pi I2C SGP40 Driver
This document explains how to set up the SGP40 sensor to run on a Raspberry Pi
using the provided code.
[
](https://www.sensirion.com/en/environmental-sensors/gas-sensors/sgp40)
Click [here](https://www.sensirion.com/en/environmental-sensors/gas-sensors/sgp40) to learn more about the SGP40 Sensor.
## Setup Guide
### Connecting the Sensor
Your sensor has the four different connectors: VCC, GND, SDA, SCL. Use
the following pins to connect your SGP40:
*SGP40* | *Raspberry Pi*
:------: | :------------------:
VCC | Pin 1 (3.3V)
GND | Pin 6
SDA | Pin 3
SCL | Pin 5
### Raspberry Pi
- [Install the Raspberry Pi OS on to your Raspberry Pi](https://projects.raspberrypi.org/en/projects/raspberry-pi-setting-up)
- [Enable the I2C interface in the raspi-config](https://www.raspberrypi.org/documentation/configuration/raspi-config.md)
- Download the driver for the [Sensirion Github Page](https://github.com/Sensirion/raspberry-pi-i2c-sgp40) and extract the `.zip` on your Raspberry Pi
- Compile the driver
1. Open a [terminal](https://www.raspberrypi.org/documentation/usage/terminal/?)
2. Navigate to the driver directory. E.g. `cd ~/raspberry-pi-i2c-sgp40`
3. Run the `make` command to compile the driver
Output:
```
rm -f sgp40_i2c_example_usage
cc -Os -Wall -fstrict-aliasing -Wstrict-aliasing=1 -Wsign-conversion -fPIC -I. -o sgp40_i2c_example_usage sgp40_i2c.h sgp40_i2c.c sensirion_i2c_hal.h sensirion_i2c.h sensirion_i2c.c \
sensirion_i2c_hal.c sensirion_config.h sensirion_common.h sensirion_common.c sgp40_i2c_example_usage.c
```
- Test your connected sensor
- Run `./sgp40_i2c_example_usage` in the same directory you used to
compile the driver.
Output:
```
SRAW VOC: 19720
SRAW VOC: 20956
SRAW VOC: 21622
SRAW VOC: 22076
SRAW VOC: 22314
SRAW VOC: 22566
...
```
## Troubleshooting
### Initialization failed
- Ensure that you connected the sensor correctly: All cables are fully
plugged in and connected to the correct pin.
- Ensure that I2C is enabled on the Raspberry Pi. For this redo the steps on
"Enable the I2C interface in the raspi-config" in the guide above.
- Ensure that your user account has read and write access to the I2C device.
If it only works with user root (`sudo ./sgp40_i2c_example_usage`), it's
typically due to wrong permission settings.
## License
This work is dual-licensed under BSD-3 and GPL 2.0 (or any later version).
You can choose between one of them if you use this work.
`SPDX-License-Identifier: BSD-3-Clause OR GPL-2.0-or-later`