background image

Documentation Center

RAK3372 Quick Start Guide

This quick start guide shows how can you use the RAK3372 as a WisBlock Core module. It is a step-by-step guide
on how to prepare your hardware as well as how to set up the needed software.

There are more features and applications possible for RAK3372 WisBlock Core but this guide only demonstrates

LED Breathing

 and 

LoRaWAN OTAA example

.

Following this guide successfully ensures that you have a working RAK3372 WisBlock Core.

This guide also includes instructions on how to perform 

firmware update

.

Prerequisite

What Do You Need?

Before going through each step in the installation guide of the RAK3372 WisBlock Core Module, make sure to
prepare the necessary items listed below:

Hardware

RAK3372 WisBlock Core

Your choice of 

WisBlock Base

USB Cable

Li-Ion/LiPo battery (optional)
Solar charger (optional)

Software

Arduino IDE

Download and install the 

Arduino IDE  

.

 WARNING

If you are using Windows 10
Do NOT install the Arduino IDE from the Microsoft App Store. Instead, install the original Arduino IDE from
the Arduino official website. The Arduino app from the Microsoft App Store has problems using third-party
Board Support Packages.

Add 

RAK3172 as a supported board in Arduino IDE

 by updating Board Manager URLs in Preferences settings

of Arduino IDE with the JSON URL below.

After that, you can then add RAKwireless RUI STM32 Boards via Arduino board manager.

Product Configuration

Hardware Setup

https

:

//raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSP-Index/main/package_rakwirel

 

json

Summary of Contents for RAK3372

Page 1: ...ake sure to prepare the necessary items listed below Hardware RAK3372 WisBlock Core Your choice of WisBlock Base USB Cable Li Ion LiPo battery optional Solar charger optional Software Arduino IDE Down...

Page 2: ...and various interfaces to RAK3372 so that it can be connected to other WisBlock Modules via different module slots RAKwireless offers many WisBlock Base Boards compatible with WisBlock Core It is high...

Page 3: ...AK3372 to the USB port of the PC There are useable LEDs as well in the WisBlock Base You can control them in your code via the GREEN_LED and BLUE_RED macro Assembling and Disassembling of WisBlock Mod...

Page 4: ...he baseboard Figure 6 Applying even forces on the proper location of a WisBlock module LoRa Antenna Another important component of RAK3372 is the antenna Figure 7 LoRa antenna You need to ensure that...

Page 5: ...for the battery wires is a JST PHR 2 2 mm pitch female This illustration uses RAK19007 as WisBlock Base There are other WisBlock Base boards available and you need to check the datasheet of the specif...

Page 6: ...can then use RUI3 APIs for your intended application You can upload the custom firmware via UART The AT commands of RAK3372 is still available even if you compile custom firmware via RUI3 You can send...

Page 7: ...e icon as shown in Figure 12 Figure 12 Modifying Additional Board Manager URLs 3 Copy the URL below and paste it on the field as shown in Figure 13 If there are other URLs already there just add them...

Page 8: ...g Arduino boards manager 6 Write RAK in the search bar as shown in Figure 15 This will show the available RAKwireless module boards that you can add to your Arduino Board list 7 Click on the area high...

Page 9: ...ols Boards Manager RAKWireless RUI STM32 Modules WisDuo RAK3172 Evaluation Board The RAK3372 WisBlock Core uses the RAK3172 WisDuo module so you must select that board as shown in Figure 16 Figure 16...

Page 10: ...in LED in the WisBlock Base board that you can control via RUI3 custom firmware 2 Launch Arduino IDE and configure WisDuo RAK3172 Evaluation Board on board selection See Figure 16 3 Connect the RAK337...

Page 11: ...372 For example To check the RUI version type AT VER on the text area then click on the Send button as shown in Figure 20 If there is no reply make sure you have selected the right COM port or double...

Page 12: ...f you have successfully compiled the example code Figure 22 Verify the example code 9 Click the Upload icon to send the compiled firmware to your RAK3372 WisBlock Core module NOTE RAK3172 module in th...

Page 13: ...ogrammed is completed you will see that LEDs are blinking LoRaWAN Example This example illustrates how to program RAK3372 WisBlock Core as a stand alone LoRaWAN end device via RUI3 Arduino APIs To use...

Page 14: ...ctly run this example it is necessary to configure the LoRaWAN parameters and create an OTAA application on your LoRaWAN gateway Register the LoRaWAN Gateway on TTNv3 Community Edition After configuri...

Page 15: ...Frequency plan for your region used by TTN then click on the Create gateway button This will add a new gateway to TTNv3 Figure 27 TTNv3 add new Gateway Creating LoRaWAN Applications in TTN 1 The first...

Page 16: ...me login credentials on the TTN V2 if you have one If you have no account yet you need to create one 2 To register as a new user to TTN click on Login with The Things ID then select register on the ne...

Page 17: ...creating your TTN account Fill in all the necessary details and activate your account 4 After creating an account you should log in on the platform using your username email and password then click S...

Page 18: ...orm the next step is to create an application Click Create an application Figure 33 Creating TTN application for your LoRaWAN devices 7 To have an application registered you need to input first the sp...

Page 19: ...activation mode you select Activation can be done either via Over The Air Activation OTAA or Activation By Personalization ABP This guide will show OTAA TTN OTAA Device Registration 1 Go to your appl...

Page 20: ...d EUIs DevEUI and AppEUI as shown in Figure 38 Check if your module has a DevEUI on the sticker or QR that you can scan then use this as the device unique DevEUI Optionally you can add a more descript...

Page 21: ...e 38 OTAA Device Information 5 The next step is to set up the Frequency plan a compatible Regional Parameter version and the LoRaWAN class supported Then you can click Join settings Figure 39 OTAA Con...

Page 22: ...d AppKey are the parameters that you will need to activate your LoRaWAN end device via OTAA The AppKey is hidden by default for security reasons but you can easily show it by clicking the show button...

Page 23: ...AK3372 COM Port See Figure 17 3 Open the example code under RAK WisBlock RUI examples File Examples RAK WisBlock RUI examples Example LoRaWan_OTAA Figure 42 OTAA LoRaWAN application example 4 In the e...

Page 24: ...s especially important for Regional Bands like US915 AU915 and CN470 This guide uses EU868 However if you use other regional bands you need to update the band and possibly the channels For example if...

Page 25: ...EGION_AS923 4 11 NOTE Make sure you have configured the correct RAK board before uploading the code See Configure RAK3372 on Boards Manager section Also check RAK3372 COM Port on Device Manager sectio...

Page 26: ...hould select the right board and COM port Figure 45 Uploading the code 6 You should now be able to see the console logs using the serial monitor of Arduino IDE Sometimes COM port will be disconnected...

Page 27: ...the module you can follow this section The latest firmware can be found in the software section of RAK3172 Datasheet NOTE What if the RAK3372 WisBlock Core module stops responding to AT commands and o...

Page 28: ...Download the latest application firmware of the RAK3172 RAK3172 Firmware 2 Download the RAK Device Firmware Upgrade DFU tool RAK Device Firmware Upgrade DFU Tool 3 Connect the RAK3372 module with a co...

Page 29: ...Upgrade Tool 5 Select the application firmware file of the module with the suffix bin Figure 49 Select firmware 6 Click the Upgrade button to upgrade the device After the upgrade is complete the RAK33...

Page 30: ...Documentation Center Figure 50 Firmware upgrading Figure 51 Upgrade successful Last Updated 3 18 2023 12 43 08 PM...

Reviews: