SHT2X with STM32

First, log in to your Simuli account and navigate to the Simuli Virtual Lab. Here we will create a new emulated instance of the STM32. Click on the Launch button under STM32 to get started.

This will open the configuration menu. First, provide a name for the project. Then, we will add the SHT21 Temperature and Humidity Sensor by selecting it from the list of available components. Finally, review that the name for the project and the selected sensors are correct and click on the Launch button.

Once we have clicked on the Launch button, a new instance of the STM32 will be created. It can take a few minutes, so be patient. Once the new instance is ready, an Open button will be visible. Click on this button to open and start working with our STM32.

A new tab with the built-in development environment opens up. On the left side, we have the code editor window along with the terminal at the bottom. On the right side, we have our STM32 Nucleo board with a terminal for interacting with the board and the SHT21 Temperature and Humidity Sensor.

The STM32 instances come with support for Platform IO Core (CLI). We will be using it for working on our projects. To know more about Platform IO Core (CLI) and the different commands go to the Platform IO documentation.

First, we need to initialise a new project using Platform IO. Let's create a new folder called STM32-SHT which will hold all our code related to the project. You can right-click anywhere in the File Explorer pane, select New Folder, name the folder and click on OK. Now that our Folder is ready, let's go to the terminal and open the newly created folder. Use the following command:

cd /workspace/STM32-SHT/

Now we will initialise a new project using Platform IO. Type the following command in the terminal:

pio project init --board nucleo_f411re

The pio project init command is used to initialise the project. Then we need to specify the board which we want to use with the --board flag.

Once the project init command has run successfully, we will see some new folders inside the STM32-SHT folder. We will store the files related to the project in the src folder.

After running the project init command, if you can't see the new files, you may have to reload the project files by clicking on PROJECT in the File Explorer pane.

Create a new file called main.cpp inside the src folder. This file will hold the code for the BMP180 program. Click on the main.cpp file to open it up in our code editor. Now, paste the following code in the editor and save the main.cpp file.

#include <Arduino.h>
#include <Wire.h>
#include <Sodaq_SHT2x.h>

void setup()

void loop()
  Serial.print("Humidity(%RH): ");
  Serial.print("Temperature(C): ");

We also need to Install the Sodaq_SHT2x library for this project. We will use Platform IO to search and install this library. Go to your terminal and type:

pio lib search Sodaq_SHT2x

Platform IO will now search for the relevant libraries and provide us the results. Here we can see that we got the library we were looking for. We can see the Library ID at the top, in this case it is 803. We will use this ID to install the library.

Type the following command in the terminal:

pio lib install 803

This will install the Sodaq_SHT2x Library along with all of it's dependencies. Now we are ready to compile our code. Save the main.cpp file. We will again use Platform IO to compile our code. Go to your terminal and type the following command.

pio run

The first time this command is run, Platform IO will download and install the relevant framework and toolchains required for the STM32. This process will take a few seconds.

Now Platform IO will compile our code and output a firmware.bin file. We need to copy this firmware file from the .pio/build/nucleo_f411re to /workspace. Usually you would need to use the cp command, but we have created a custom command called load-firmware for ease of use. Just write the following command and the firmware.bin file will be copied to the workspace folder.


Once we have copied the firmware.bin file, all we need to do is to reset the STM32 by pressing the red button above the STM32. The new firmware will now be loaded and we can see the readings from the SHT21 sensor in our terminal.

You can also use the Arduino IDE to work with the STM32. Follow our guide on Using STM32 with Arduino IDE and IoTIFY Virtual Lab.

Now that you know how to get the readings from the SHT2X sensor, you could try to make an alert system, which would turn on LEDs when the temperature goes above a certain threshold. You need an if statement to compare the current temperature value with the threshold and then switch on the LED if the condition is satisfied Keep building and have fun! 🎉

Last updated