Skip to content

08-SCD4x_BLE_Gadget_Tutorial.md

Latest commit

 

History

History
100 lines (67 loc) · 4.68 KB

08-SCD4x_BLE_Gadget_Tutorial.md

File metadata and controls

100 lines (67 loc) · 4.68 KB

Tutorial: SCD4x BLE Gadget

Summary

This tutorial enables you to setup a CO2-Monitor sending Temperature, Humidity and Carbon Dioxide (CO2) measurements via Bluetooth to nearby mobile phones. All steps necessary and links to the compatible app for the interaction with the created Gadget are provided here.

The tutorial is structured in 3 parts

  • Hardware Setup: Learn how to wire the sensor to the development board.
  • Software Setup: Learn how to setup your computer to program the development board.
  • Monitor Setup: Learn how to monitor your CO2 levels on your computer and via the Sensirion MyAmbience app.

Hardware Setup

To complete this tutorial, you'll need:

Connect the SEK-SCD41 module to the ESP32 DevKitC as depicted below. Please note, that your developer kit may have a different pin layout. If you're using different pins or have a different layout, you might have to adjust the code accordingly.

  • VDD of the SEK-SCD41 to the 3.3V of the ESP32
  • GND of the SEK-SCD41 to the GND of the ESP32
  • SCL of the SEK-SCD41 to the IO22 of the ESP32
  • SDA of the SEK-SCD41 to the IO21 of the ESP32

Software Setup

Setup the Arduino IDE for the ESP32 platform

The following instructions originate from here.

  1. Install the current version of the Arduino IDE.
  2. Start the Arduino IDE and open the Preferences window from File -> Preferences.
  3. Enter the following link into the Additional Board Manager URLs field. You can add multiple URLs, separating them with commas.
    • https://dl.espressif.com/dl/package_esp32_index.json
  4. Open the Boards Manager from Tools -> Board -> Board Manager and install the esp32 platform.
  5. Select your ESP32 board from the Tools -> Board menu after the successfull installation.
    • E.g. ESP32 Dev Module

Setup the required libraries

You will need to install the following libraries using the library manager included with Arduino IDE:

Once it is done, restart the Arduino IDE.

Launch the Gadget Firmware

  1. Open the Arduino IDE.
  2. Go to File -> Examples -> Sensirion Gadget BLE Lib -> Example8_SCD4x_BLE_Gadget_with_RHT.
  3. Make sure the ESP32 is connected to your computer.
  4. Press the Upload button on the top left corner of the Arduino IDE.

Monitor Setup

Value plotting on your Computer

To verify that everything is working fine, open the Serial Plotter, while your ESP32 ist still connected to your computer to see the sensor values measured by the SCD41 module:

  1. Go to Tools -> Serial Plotter
  2. Make sure on the bottom left corner 115200 baud is selected, as depicted in the image below

You should see the measured values plotted in the opened window. Alternatively you can choose Tools -> Serial Monitor to see the values in text form.

Monitor your Temperature, Humidity and CO2 levels via Mobile App

Download the Sensirion MyAmbience app to monitor your sensor signals, download history values and export and share the data with your friends.

Note that on Android devices the Location services need to be enabled and the corresponding permissions granted to the application. This is required to allow the app to continuously scan for nearby Bluetooth devices. This is a requirement of the Android OS for Bluetooth scanning. The app itself does not use your location.

PlatformIO Support

The folder Example8_SCD4x_BLE_Gadget_with_RHT contains a platformio.ini file which allows you to use PlatformIO instead of ArduinoIDE if you wish to do so.