RAK1901 WisBlock Temperature and Humidity Sensor User Guide

June 5, 2024
RAK

RAK1901 logo RAK1901 Quick Start Guide
Prerequisite
What Do You Need?

Before going through each and every step on using the RAK1901 WisBlock module, make sure to prepare the necessary items listed below:

Hardware

Software

Arduino
Download and install ArduinoIDE.
To add the RAKwireless Core boards to your Arduino Boards Manager, install the RAKwireless Arduino BSP

Product Configuration

Hardware Setup

WisBlock can integrate this module which makes it easy to build up an environmental temperature and humidity data acquisition system.
For more information about the RAK1901, refer to the Datasheet.
The RAK1901 module gives information about:

  • Environment Temperature
  • Environment Humidity

RAK1901 module can be connected to any slot of WisBlock Base to communicate with the WisBlock Core. It will work on SLOT A to D. Also, always secure the connection of the WisBlock module by using compatible screws.RAK1901
WisBlock Temperature and Humidity Sensor

Figure 1: RAK1901 connection to WisBlock Base

Assembling and Disassembling of WisBlock Modules Assembling

As shown in Figure 2, the location for Slots A, B, C, and D are properly marked by silkscreen. Follow carefully the procedure defined in RAK5005-O module assembly/disassembly instructions to attach a WisBlock module.
Once attached, carefully fix the module with one or more pieces of M1.2 x 3 mm screws depending on the module.RAK1901 WisBlock Temperature and Humidity
Sensor - Assembling

Figure 2: RAK1901 connection to WisBlock Base

Disassembling

The procedure in disassembling any type of WisBlock module is the same.
First, remove the screws.RAK1901 WisBlock Temperature and Humidity Sensor -
Disassembling

Figure 3: Removing screws from the WisBlock module

2. Once the screws are removed, check the silkscreen of the module to find the correct location where force can be applied.RAK1901 WisBlock Temperature
and Humidity Sensor - applied

Figure 4: Detaching silkscreen on the WisBlock module

3. Apply force to the module at the position of the connector, as shown in Figure 5, to detach the module from the baseboard.RAK1901 WisBlock
Temperature and Humidity Sensor - baseboard

Figure 5: Applying even forces on the proper location of a WisBlock module

NOTE
If you will connect other modules to the remaining WisBlock Base slots, check on the WisBlock Pin
Mapper tool for possible conflicts. RAK1901 uses I2C communication lines, and it can cause possible conflict especially on some IO modules.
After all this setup, you can now connect the battery and USB cable to start programming your WisBlock Core.

Software Configuration and Example

The RAK1901 is a Temperature & Humidity sensor board that contains the SHTC3 chip. The SHTC3 is a digital temperature and humidity sensor designed especially for battery-driven high-volume consumer electronics applications. The device comprises a sensing element and an IC interface that communicates through I2C from the sensing element to the application.
These are the quick links that go directly to the software guide for the specific WisBlock Core module you use:

  • RAK1901 in RAK4631 WisBlock Core Guide
  • RAK1901 in RAK11200 WisBlock Core Guide
  • RAK1901 in RAK11310 WisBlock Core Guide
  • LoRaWAN Weather Monitoring with RAK1901

RAK1901 in RAK4631 WisBlock Core Guide

If you already installed the RAKwireless Arduino BSP , the WisBlock Core and example code should now be available on the Arduino IDE.

  1. First, you need to select the RAK4631 WisBlock Core.RAK1901 WisBlock Temperature and Humidity Sensor - example
  2. The Basic Sample Code for RAK1901 in Github will work on all WisBlock Core. You can open the example codes depending on your WisBlock Core, as shown in Figure 7.RAK1901 WisBlock Temperature and Humidity Sensor - Figure 14Figure 7: Opening RAK1901 example code for RAK4631 WisBlock Core
  3. Once the example code is open, install the SparkFun SHTC3 library by clicking the yellow highlighted link, as shown in Figure 8.
  4. Figure 8: Accessing the library used for RAK1901 ModuleRAK1901 WisBlock Temperature and Humidity Sensor - compatible Figure 9: Installing the compatible library for RAK1901 Module****
  5. After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 10 and Figure 11.RAK1901 WisBlock Temperature and Humidity Sensor - successful Figure 10: Selecting the correct Serial PortRAK1901 WisBlock Temperature and Humidity Sensor - Figure 11
  6. When you successfully uploaded the example sketch, open the Serial Monitor of the Arduino IDE to see the sensor’s reading logs. If you see the logs, as shown in Figure  12, then your RAK1901 is properly communicating to the WisBlock coreRAK1901 WisBlock Temperature and Humidity Sensor - Figure 12 Figure 12: RAK1901 temperature and humidity data logs

RAK1901 in RAK11200 WisBlock Core Guide

If you already installed the RAKwireless Arduino BSP, the WisBlock Core and example code should now be available on the Arduino IDE.

  1. First, you need to select the RAK11200 WisBlock Core.RAK1901 WisBlock Temperature and Humidity Sensor - WisBlock

  2. The Basic Sample Code for RAK1901 in Github will work on all WisBlock Core. You can open the example codes depending on your WisBlock Core, as shown in Figure 14. RAK1901 WisBlock Temperature and Humidity Sensor - Figure 21Figure 14: Opening RAK1901 example code for RAK11200 WisBlock Core

  3. Once the example code is open, install the SparkFun SHTC3 library by clicking the yellow highlighted link, as shown in Figure 15.RAK1901 WisBlock Temperature and Humidity Sensor - Figure 22 Figure 15: Accessing the library used for the RAK1901 ModuleRAK1901 WisBlock Temperature and Humidity Sensor - Figure 16 Figure 16: Installing the compatible library for the RAK1901 Module****

  4.  After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 17 and Figure 18.
    NOTE
    RAK11200 requires the Boot0 pin to be configured properly first before uploading. If not done properly, uploading the source code to RAK11200 will fail. Check the full details on the RAK11200 Quick Start Guide.RAK1901
WisBlock Temperature and Humidity Sensor - Selecting Figure 17: Selecting the correct Serial PortRAK1901
WisBlock Temperature and Humidity Sensor - Figure 18 Figure 18: Uploading the RAK1901 example code****

  5. When you successfully uploaded the example sketch, open the Serial Monitor of the Arduino IDE to see the sensor’s reading logs. If you see the logs, as shown in Figure  19, then your RAK1901 is properly communicating to the WisBlock core.RAK1901 WisBlock Temperature and Humidity Sensor - Figure 26 Figure 19: RAK1901 temperature and humidity data logs

RAK1901 in RAK11310 WisBlock Core Guide

If you already installed the RAKwireless Arduino BSP, the WisBlock Core and example code should now be available on the Arduino IDE.

  1. First, you need to select the RAK11310 WisBlock Core.RAK1901 WisBlock Temperature and Humidity Sensor - Selecting 1 Figure 20: Selecting RAK11310 as WisBlock Core
  2. The WisBlock/examples/common/sensors/RAK1901_Temperature_Humidity_SHTC3 at master · RAKWireless/WisBlock · GitHub in Github will work on all WisBlock Core. You can open the example codes depending on your WisBlock Core, as shown in Figure 21.RAK1901 WisBlock Temperature and Humidity Sensor - Opening

Figure 21: Opening RAK1901 example code for RAK11310 WisBlock Core

3. Once the example code is open, install the SparkFun SHTC3 library by clicking the yellow highlighted link, as shown in Figure 22.RAK1901 WisBlock
Temperature and Humidity Sensor - Figure

Figure 22: Accessing the library used for RAK1901 ModuleRAK1901
WisBlock Temperature and Humidity Sensor - Figure 23

Figure 23: Installing the compatible library for the RAK1901 Module

4. After successful installation of the library, you can now select the right serial port and upload the code, as shown in Figure 24 and Figure 25.RAK1901
WisBlock Temperature and Humidity Sensor - Serial

Figure 24: Selecting the correct Serial PortRAK1901 WisBlock
Temperature and Humidity Sensor - Figure 25

Figure 25: Uploading the RAK1901 example code

When you successfully uploaded the example sketch, open the Serial Monitor of the Arduino IDE to see the sensor’s reading logs. If you see the logs, as shown in Figure 26, then your RAK1901 is properly communicating to the WisBlock core.RAK1901 WisBlock Temperature and Humidity Sensor -
temperature

Figure 26: RAK1901 temperature and humidity data logs

LoRaWAN Weather Monitoring with RAK1901

For WisBlock Core RAK4630, it has an example for LoRaWAN Weather Monitoring with RAK1901 Temperature & Humidity Module.RAK1901 WisBlock Temperature and
Humidity Sensor - Monitoring

Figure 27: LoRaWAN Weather Monitoring example

Documents / Resources

| RAK RAK1901 WisBlock Temperature and Humidity Sensor [pdf] User Guide
RAK1901, WisBlock Temperature and Humidity Sensor, RAK1901 WisBlock Temperature and Humidity Sensor, Temperature and Humidity Sensor Sensirion SHTC3
---|---

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals