Download
Share
Print this page
  1. Manuals
  2. Brands
  3. RAK Manuals
  4. Computer Hardware
  5. RAK3372
  6. Quick start manual

RAK RAK3372 Quick Start Manual

Hide thumbs

Advertisement

Quick Links

Download this manual
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
Following this guide successfully ensures that you have a working RAK3372 WisBlock Core.
This guide also includes instructions on how to perform
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
⚠
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
of Arduino IDE with the JSON URL below.
https://raw.githubusercontent.com/RAKWireless/RAKwireless-Arduino-BSP-Index/main/package_rakwirel
After that, you can then add RAKwireless RUI STM32 Boards via Arduino board manager.
Product Configuration
Hardware Setup
example.
Arduino IDE
.
firmware
update.
by updating Board Manager URLs in Preferences settings
json

Advertisement

loading
Need help?

Need help?

Do you have a question about the RAK3372 and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Related Manuals for RAK RAK3372

Summary of Contents for RAK RAK3372

  • Page 1 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.
  • Page 2 Documentation Center Your RAK3372 will not work on its own. It needs at least to be connected to a WisBlock Base together with an antenna. You can then interface various WisBlock Modules via the available slots in the WisBlock Base. You can also add a battery as a power source and optional solar charging.
  • Page 3 You can access the AT command via UART2 by default (and also possible via UART1). Firmware update is only possible via UART2. A built-in USB-Serial converter is on the board to easily connect the RAK3372 to the USB port of the PC.
  • Page 4 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 it is properly connected to have a good LoRa signal. Also, note that you can damage the...
  • Page 5 Make sure to fix the module with screws to ensure proper function. Battery and Solar Connection RAK3372 can be powered via the USB cable or Li-Ion/LiPo battery via the dedicated connectors, as shown in Figure 9. The matching connector for the battery wires is a JST PHR-2 2 mm pitch female This illustration uses RAK19007 as WisBlock Base.
  • Page 6 Arduino IDE by getting it from the Arduino official website. The Arduino app from the Microsoft App Store has problems using third-party Board Support Packages. Once the Arduino IDE has been installed successfully, you can now configure the IDE to add the RAK3372 to its board selection by following these steps.
  • Page 7 Documentation Center Figure 11: Arduino preferences 2. To add the RAK3372 to your Arduino Boards list, edit the Additional Board Manager URLs. Click the 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 on the next line.
  • Page 8 Documentation Center Figure 13: Add additional board manager URLs 4. Restart the Arduino IDE. 5. Open the Boards Manager from Tools Menu. Figure 14: Opening Arduino boards manager 6. Write 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.
  • Page 9 8. Once the BSP is installed, select Tools > 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.
  • Page 10 Compile an Example with Arduino LED Breathing 1. After completing the steps on adding your RAK3372 WisBlock Core to the Arduino IDE, you can now try to run a simple program to test your setup. There is a built-in LED in the WisBlock Base board that you can control via RUI3 custom firmware.
  • Page 11 Documentation Center Figure 19: Open Arduino serial monitor 6. If the connection is successful, you can send AT Commands to RAK3372. For example: To check the RUI version, type on the text area, then click on the Send button, as shown in Figure 20. If there is no AT+VER=? reply, make sure you have selected the right COM port or double-check the USB connection.
  • Page 12 8. Click on the Verify icon to check if 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 the WisBlock Core should automatically go to BOOT mode when the firmware is...
  • Page 13 This example illustrates how to program RAK3372 WisBlock Core as a stand-alone LoRaWAN end-device via RUI3 Arduino APIs . To use the RAK3372 WisBlock Core module as a LoRaWAN end-device, it needs to be within reach of a working LoRaWAN gateway registered to a LoRaWAN network server (LNS) or with a built-in...
  • Page 14 Documentation Center NOTE: If you are new to LoRaWAN, here are a few good references about LoRaWAN and gateways: LoRaWAN 101 What is a LoRaWAN Gateway How do LoRaWAN Gateways work? Things to Consider When Picking A LoRaWAN Gateway RAKwireless LoRaWAN gateway models like WisGate Edge have built-in network servers.
  • Page 15 Documentation Center Figure 26: TTNv3 gateway registration and configuration 4. Select the 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.
  • Page 16 Documentation Center Figure 28: Selecting Cluster in TTN V3 You can use the same 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 next page, as shown in Figure 29 and Figure 30.
  • Page 17 Documentation Center Figure 30: Registration of new account 3. You should now be on the step of 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 Submit, as shown in Figure 31.
  • Page 18 Documentation Center Figure 32: Authorization to TTN 6. Now that you are logged in to the platform, 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 specific details and necessary information about your application then click Create application.
  • Page 19 Documentation Center Figure 34: Details of the TTN application 8. If you had no error during the previous step, you should now be on the application console page. The next step is to add end-devices to your TTN application. LoRaWAN specification enforces that each end-device has to be personalized and activated.
  • Page 20 Documentation Center Figure 36: Manually register the device to TTN Figure 37: Device activation configuration 3. Then you need to put a unique End device ID and 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 descriptive End device name and End device description about your device.
  • Page 21 It is advisable to use a meaningful end-device ID, end-device name, and end-device description that will match your device's purpose. The end-device ID is for illustration purposes only. rak-device Figure 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.
  • Page 22 Documentation Center Figure 40: OTAA AppKey generation and device registration You should now be able to see the device on the TTN console after you fully register your device, as shown in Figure 41. NOTE: The AppEUI, DevEUI, and AppKey are the parameters that you will need to activate your LoRaWAN end-device via OTAA.
  • Page 23 The OTAA_DEVEUI parameter should match the device EUI registered in your network server. Note that your RAK3372 module has a sticker with a QR code printed on it. You can use the QR code information to configure the OTAA_DEVEUI parameter. The OTAA_DEVEUI format is MSB first.
  • Page 24 Figure 43: Configuring DEVEUI, APPEUI and APPKEY 3. Depending on the Regional Band you selected, you might need to configure the sub-band of your RAK module to match the gateway and LoRaWAN network server. This is especially important for Regional Bands like US915, AU915, and CN470.
  • Page 25 RAK_REGION_AS923 = 8 RAK_REGION_AS923-2 = 9 RAK_REGION_AS923-3 = 10 RAK_REGION_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 section.
  • Page 26 Documentation Center Figure 44: Select COM port 5. The last step is to upload the code by clicking the Upload icon on Arduino IDE. Take note that you should select the right board and COM port. Figure 45: Uploading the code 6.
  • Page 27 RAK3172 Datasheet. NOTE: What if the RAK3372 WisBlock Core module stops responding to AT commands and/or firmware updates? You can recover your device by using the file in the datasheet and uploading it using .hex...

  • Page 28: Firmware Upgrade Procedure

    Select Port button. NOTE: If your firmware upload always fails, check your current baud rate setting using the command AT+BAUD=? and use that baud rate value in the RAK DFU Tool. You can also check if you selected the right COM port.
  • Page 29 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 RAK3372 will be ready to work with the new firmware.
  • Page 30 Documentation Center Figure 50: Firmware upgrading Figure 51: Upgrade successful Last Updated: 3/18/2023, 12:43:08 PM...