background image

Documentation Center

RAK3172 Module Quick Start Guide

This guide covers the following topics:

TheThingsNetwork Guide

 - How to login, register new accounts and create new applications on TTN.

RAK3172 TTN OTAA Guide

 - How to add OTAA device on TTN and what AT commands to use on RAK3172

OTAA activation.

RAK3172 TTN ABP Guide

 - How to add ABP device on TTN and what AT commands to use on RAK3172 ABP

activation.

Chirpstack Guide

 - How to create new applications on Chirpstack.

RAK3172 Chirpstack OTAA Guide

 - How to add OTAA device to Chirpstack and what AT commands to use on

RAK3172 OTAA activation.

RAK3172 Chirpstack ABP Guide

 - How to add ABP device on Chirpstack and what AT commands to use on

RAK3172 ABP activation.

LoRa P2P

 - Point to point communication between two RAK3172 modules.

Updating RAK3172-Module FW

 - Procedures on how to update RAK3172 module firmware.

Prerequisites

What Do You Need?

Before going through the steps in the installation guide of the RAK3172 WisDuo LPWAN Module, make sure to
prepare the necessary items listed below:

Hardware Tools

1. RAK3172 WisDuo LPWAN Module
2. Computer
3. USB to UART TTL adapter

Software Tools

1. 

RAK Serial Port Tool

List of Acronyms

Summary of Contents for RAK3172

Page 1: ...OTAA Guide How to add OTAA device to Chirpstack and what AT commands to use on RAK3172 OTAA activation RAK3172 Chirpstack ABP Guide How to add ABP device on Chirpstack and what AT commands to use on R...

Page 2: ...output Connect to the RAK3172 1 Connect the RAK3172 to the serial port of a general purpose computer USB port using a USB to UART TTL adapter like RAKDAP1 as shown in Figure 1 Acronym Definition DFU D...

Page 3: ...communication tool you can now send commands to the RAK3172 For example sending AT will display OK For the details of all supported AT commands refer to AT Commands for RAK3172 Connecting to The Thin...

Page 4: ...hings Stack using the LoRaWAN protocol To achieve this the RAK3172 WisDuo module must be located inside the coverage of a LoRaWAN gateway connected to The Things Stack server Registration to TTN and C...

Page 5: ...ion of new account You should now be on the step of creating your TTN account Fill all the necessary details and activate your account After creating an account you should login on the platform using...

Page 6: ...r Figure 6 Logging in to TTN platform You need to click Authorize to proceed Figure 7 Authorization to TTN Now that you are logged in to the platform the next step is to create an application Click Cr...

Page 7: ...cation 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 There are two options for regis...

Page 8: ...ter the module you need to click first Manually then configure the activation method by selecting Over the air activation OTAA and compatible LoRaWAN version then click Start button as shown on figure...

Page 9: ...and End device description about your device After putting all the details you need to click Network layer settings to proceed to the next step NOTE It is advisable to use a meaningful end device ID e...

Page 10: ...n the registration of a new OTAA end device is the configuration of the AppKey To get the AppKey you must click the generate button Then you need to click Add end device to finish your new device regi...

Page 11: ...e device console page as shown on Figure 16 Figure 16 OTAA device successfully registered to TTN OTAA Configuration for TTN The RAK3172 module supports a series of AT commands to configure its interna...

Page 12: ...our UART lines is correct and if the baud is correctly configured to 9600 Also you can check if the device is powered correctly If you are getting power from USB port ensure that you have a good USB c...

Page 13: ...ant for Regional Bands like US915 AU915 and CN470 To configure the masking of channels for the sub bands you can use the AT MASK command that can be found on the AT Commands Manual To illustrate you c...

Page 14: ...EUIs and key You need the use the values from the TTN console Device EUI 1133557799224466 Application EUI 1000000000000009 Application Key 04FA4E626EF5CF227C969601176275C2 Set the Device EUI Set the A...

Page 15: ...rking LoRaWAN gateway that is configured to connect to TTN It is also important to check that all your OTAA parameters DEVEUI APPEUI and APPKEY are correct using the AT DEVEUI AT APPEUI and AT APPKEY...

Page 16: ...ce console Live data section Also the Last seen info should be a few seconds or minutes ago Figure 21 OTAA Test Sample Data Sent Viewed in TTN TTN ABP Device Registration To register an ABP device you...

Page 17: ...ister the module you need to click first Manually then configure the activation method by selecting Activation by personalization ABP compatible LoRaWAN version and click Start button as shown in figu...

Page 18: ...as the device unique DevEUI Optionally you can add a more descriptive End device name and End device description about your device After putting all the details you need to click Network layer settin...

Page 19: ...set up the Frequency plan a compatible Regional Parameter version and the LoRaWAN class supported In an ABP device you also need to generate a Device Address and a NwkSKey Network Session Key Then you...

Page 20: ...to see the device on the TTN console after you fully register your device as shown in Figure 28 Figure 28 ABP device successfully registered to TTN ABP Configuration for TTN To set up the RAK3172 modu...

Page 21: ...shown in Figure 17 NOTE If do not receive an OK or any reply you need to check if the wiring of your UART lines is correct and if the baud is correctly configured to 9600 Also you can check if the de...

Page 22: ...ork server This is specially important on Regional Bands like US915 AU915 and CN470 To configure the masking of channels for the sub bands you can use the AT MASK command that can be found on the AT C...

Page 23: ...eed the use the values from the TTN console Device Address 260BDE80 Application Session Key A585903A949C2B2D44B55E99E94CB533 Network Session Key 433C7A924F7F6947778FE821525F183A Set the Device Address...

Page 24: ...arameter Description With the end device properly activated you can now try to send some payload after successful join Send command format AT SEND port payload w Join command 1 joining 0 stop joining...

Page 25: ...are correct by using AT DEVADDR AT APPSKEY and AT NWKSKEY commands Lastly ensure that the antenna of your device is properly connected After checking all the things above try to send LoRaWAN payloads...

Page 26: ...sing a RAK Gateway and its built in ChirpStack Also the gateway with the ChirpStack must be configured successfully For further information check the RAK documents for more details In summary these ar...

Page 27: ...ers as shown in the Figures 36 and 37 Figure 36 Creating a New Application For this setup create an Application named rak_node_test ChirpStack LoraServer supports multiple system configurations with o...

Page 28: ...select the DEVICES tab as shown in Figures 38 and 39 2 Once done click CREATE Figure 38 List of Applications Created Figure 39 Device Tab of an Application 3 Once inside of the DEVICE tab create a new...

Page 29: ...ically by clicking the generate icon You can also add a specific Device EUI directly in the form Device Profile If you want to join in OTAA mode select DeviceProfile_OTAA If you want to join in ABP mo...

Page 30: ...or a new one can be generated automatically by clicking the icon highlighted in red in Figure 44 Figure 44 Chirpstack OTAA Set Application Keys 3 Once the Application Key is added in the form the proc...

Page 31: ...n for Chirpstack The RAK3172 module supports a series of AT commands to configure its internal parameters and control the functionalities of the module To set up the RAK3172 module to join the Chirpst...

Page 32: ...you are getting power from USB port ensure that you have a good USB cable Figure 47 at version command response The next step is to configure the OTAA LoRaWAN parameters in RAK3172 LoRa work mode LoRa...

Page 33: ...ands like US915 AU915 and CN470 To configure the masking of channels for the sub bands you can use the AT MASK command that can be found on the AT Commands Manual To illustrate you can use use sub ban...

Page 34: ...le NOTE The Application EUI parameter is not required in the ChirpStack platform therefore it possible to use the same id as the Device EUI Device EUI 5E9D1E0857CF25F1 Application EUI 5E9D1E0857CF25F1...

Page 35: ...LoRaWAN gateway that is configured to connect to Chirpstack It is also important to check that all your OTAA parameters DEVEUI and APPKEY are correct using the AT DEVEUI and AT APPKEY commands Lastly...

Page 36: ...convention messages sent from nodes to gateways are considered as Uplinks while messages sent by gateways to nodes are considered as Downlinks Figure 51 Chirpstack Data Received Preview Chirpstack AB...

Page 37: ...me parameters for ABP in the ACTIVATION item Device address Network Session Key Application Session Key Figure 53 Chirpstack ABP Activation Parameters Needed The parameters can be generated as random...

Page 38: ...ceive an OK or any reply you need to check if the wiring of your UART lines is correct and if the baud is correctly configured to 9600 Also you can check if the device is powered correctly If you are...

Page 39: ...ork server This is specially important on Regional Bands like US915 AU915 and CN470 To configure the masking of channels for the sub bands you can use the AT MASK command that can be found on the AT C...

Page 40: ...the use the values from the TTN device console Device Address 26011AF9 Application Session Key 4D42EC5CAF97F03D833CDAf5003F69E1 Network Session Key C280CB8D1DF688BC18601A97025C5488 Set the Device Addr...

Page 41: ...f the request was successfully received by a LoRa gateway then you should see the JOINED status reply You can now try to send some payload after successful join Send command format AT SEND port payloa...

Page 42: ...uire having both units connected simultaneously This could be done by having one computer with two USB ports or two computers with one USB port each It is recommended to start by testing the serial co...

Page 43: ...To setup the RAK3172 to work in LoRa P2P mode you need to input the work mode command on both RAK3172 modules Figure 59 P2P Mode NOTE You might need to input ATE command again to ensure that your suc...

Page 44: ...t the P2P setup on both RAK3172 modules The parameters should be exactly the same on the two modules NOTE Refer to the P2P Mode section of the AT command documentation to learn more about the definiti...

Page 45: ...The device is in TX mode With one module configured as RX the other device will be the TX You can now try to send a P2P payload Figure 61 Configuring P2P in both RAK3172 Module Miscellaneous Upgradin...

Page 46: ...e Upgrade DFU tool RAK Device Firmware Upgrade DFU Tool 3 Connect the RAK3172 module with a computer through a USB to TTL Refer to Figure 1 4 Open the Device Firmware Upgrade tool Select the serial po...

Page 47: ...gure 63 Select Firmware 6 Click the Upgrade button to upgrade the device After the upgrade is complete the RAK3172 module will be ready to work with the new firmware Figure 64 Firmware Upgrading Figur...

Page 48: ...Documentation Center Last Updated 1 10 2022 2 07 11 AM...

Reviews: