RAK7201V2 WisNode Button 4K User Guide

RAK7201V2 WisNode Button 4K

Product Information

Specifications

• Model: RAK7201V2 WisNode Button 4K
• Included Items:
  • 1 pc RAK7201V2 WisNode Button 4K
  • 1 pc Micro USB cable
  • 1 pc Sticker for attaching the button to a flat surface
• Compatibility: Windows PC
• Baud Rate: 115200 bps (default)

FAQ

• Q: What items are included in the package?
  • A: The package includes:
  • 1 pc RAK7201V2 WisNode Button 4K
  • 1 pc Micro USB cable
  • 1 pc Sticker for attaching the button to a flat surface
• Q: What is the default baud rate of the WisNode Button 4K?
  • A: The default baud rate of the WisNode Button 4K is 115200 bps.
• Q: How can I check if my device is running the latest firmware version?
  • A: To check if the latest firmware version is in use, send the AT+VER=? command using the RAK Serial Port Tool.
• Q: How do I connect the RAK WisNode Button 4K to the built-in server?
  • A: Follow the instructions provided in the “Connecting to the Built-In Network Server” section of the user manual.

Product Usage Instructions

Prerequisites

To successfully install and use the RAK7201V2 WisNode Button, make sure you have the following items:

1. RAK7201V2 WisNode Button 4K
2. Micro USB cable
3. A gateway in range
4. Windows PC

Connecting to the Built-In Network Server

This section provides instructions on how to connect the RAK WisNode Button 4K to the built-in server that is part of all RAK WisGate Series gateways.

Creating an Application:

1. Login into the gateway via the Web UI and select the Application tab in the LoRa menu. (Refer to Figure 6: Application menu in the web UI of the gateway)
2. Click the Add application button and fill out the Application name. Select Unified Application key as Application Type and use the Autogenerate button to generate an Application Key and Application EUI. (Refer to Figure 7: Creating an application)

Adding the Device to the Application:

1. In the created application, click on the End device tab and then the Add end device button. (Refer to Figure 8: Application edit)
2. Fill out the End device name and the LoRaWAN MAC Version (V1.0.3 is the correct one for RAK7201V2). Click on the Add end devices. (Refer to Figure 9: Adding the device)
3. Input the End Device EUI of your device and then click Add to End Devices list. (Refer to Figure 10: Configuring the device’s settings)

What Do You Need And What’s Included

What Do You Need?

Before going through each and every step in the installation guide of the RAK7201V2 WisNode Button, make sure to prepare the necessary items listed below:

1. RAK7201V2 WisNode Button 4K
2. Micro USB cable
3. A gateway in range
4. Windows PC

What’s Included in the Package

• 1 pc RAK7201V2 WisNode Button 4K
• 1 pc Micro USB cable
• 1 pc Sticker for attaching the button to a flat surface

Product Configuration

Interfacing With the RAK7201V2 WisNode Button 4K

For you to be able to interface with the RAK7201V2 WisNode Button 4K with your Windows machine, you need to download the RAK Serial Port Tool.

1. Connect your RAK7201V2 WisNode Button 4K to your Windows machine using the provided Micro USB cable.
2. Open the RAK Serial Port Tool.
3. To choose the correct COM Port number for your device, go to your Device Manager by pressing the Windows key + R and type devmgmt.msc. You can also search for the Device Manager in the Start menu.
4. Once opened, look for Ports (COM & LPT) and find the name USB-SERIAL CH340. The COM Port Number differs, and in this guide, it is COM4.
5. Choose the correct COM port number from the device manager and the correct baud rate, then click Open. The default baud rate of the WisNode Button 4K is 115200 bps.
6. To check if the latest firmware version is in use, send the AT+VER=? command. If your device is not running the latest firmware, you need to upgrade it, following the Firmware Upgrade Guide.

Connecting to the Built-In Network Server

This section provides instructions on how to connect the RAK WisNode Button 4K to the built-in server that is part of all RAK WisGate Series gateways.
You can find more information about RAK’s Edge gateways and how to use the built-in server here:

• RAK7240
• RAK7240V2
• RAK7249
• RAK7258
• RAK7268V2
• RAK7289V2
• RAK7289

NOTE: The following guide showcases the Web UI of WisGateOS 2 which is run by WisGate Edge Version 2 gateways.

Creating an Application And Adding the Device

Creating an Application

1. Login into the gateway via the Web UI and select the Application tab in the LoRa menu.
2. Click the Add application button and fill out the Application name. Select Unified Application key as Application Type and use the Autogenerate button to generate an Application Key and Application EUI.

Adding the Device to the Application

1. In the created application, click on the End device tab and then the Add end device button.
2. Fill out the End device name and the LoRaWAN MAC Version (V1.0.3 is the correct one for RAK7201V2). Click on the Add end devices.
3. Input the End Device EUI of your device and then click Add to “End Devices list”.
4. You will see the device in the End devices list and the Add end devices button will allow you to register your end device in the application.

Configuring the Button in OTAA And ABP Mode

Configuring the Button in OTAA Mode

To use the RAK7201V2 in ABP mode, a change of the activation method is needed.

1. Go to the Device Configuration in the gateway, and select the ABP Join mode.
   • Join Mode (OTAA)
   • at+njm=1
   • Region (EU868 for this example)
   • at+band=2
   • Device EUI (on the sticker at the back of the device)
   • at+deveui=ac1f09fffexxxxxx
   • Application EUI (from the application configuration created previously in the gateway)
   • at+appeui=bf3112d69fxxxxxx
   • Application Key (from the application configuration created previously in the gateway)
   • at+appkey=ea980d6f2e42772550c66ec265xxxxxx
   • NOTE: The Keys and EUIs shown here are just examples, use the ones generated by your system or corresponding to your device.
2. To connect to the LoRaWAN Network after the configuration, the device must be restarted. The restart command is as follows:
   • atz
3. After the restart, you need to issue at+join to join the LoRaWAN network. If all the settings are configured correctly, an +EVT:JOINED message will be displayed in the RAK Serial Port Tool.
4. After the successful connection, the data obtained from pressing the buttons will be transmitted to the application server of the gateway.
5. The received data from RAK7201V2 can be seen in the web UI of the gateway under Application > Device > Live Device Data.

Configuring the Button in ABP Mode

To use the RAK7201V2 in ABP mode, a change of the activation method is needed.

1. Go to the Device Configuration in the gateway, and select the ABP Join mode.
2. The following fields appear: Device Address, Application Session Key, and Network Session Key. Enter the Device Address manually, and it should be in HEX format and 8 digits long.
3. To generate the needed keys automatically, click the Autogenerate button next to the Application Session key and Network Session Key fields. Click Save & Apply.
4. To set the RAK7201V2 in ABP work mode, the following AT commands must be executed in the RAK Serial Port Tool:
   • Join mode (ABP)
   • at+njm=0
   • Device Address (from the device configuration created previously in the gateway)
   • at+devaddr=00000001
   • Application Session Key (from the device configuration created previously in the gateway)
   • at+appskey=bfb959106b004e5a32d8dde9fexxxxxx
   • Network Session Key (from the device configuration created previously in the gateway)
   • at+nwkskey=0a8139122e9e9011c049bcc575xxxxxx
   • NOTE: The Keys and EUIs shown are just examples. Use the ones generated by your system or corresponding to your device.
5. To connect to the LoRaWAN Network after the configuration, the device must be restarted. The restart command is as follows:
   • atz
6. After the restart, the device will be ready to send the information through the LoRaWAN Network.
   • NOTE: There is no Join procedure in ABP mode. To be sure that the Button can send data, you need to press the buttons and see if you have uplinks in the Live Device Data field of the device in the gateway.
7. To test the ABP mode, press the buttons of the device.
8. The received data from RAK7201V2 can be seen in the web UI of the gateway under Application > Device > Live Device Data.

Customized the Data Sent

This section addresses the main functionality of the different keys (buttons) of the device.
The default payload data of the keys:

Key / Data

• Key 1 / A
• Key 2 / B
• Key 3 / C
• Key 4 / D

To customize the data sent by every button, follow the AT command:

• at+button=::

Where:

• : the configured key (range 1-4)
• : the configured port number (range 1-223)
• : the sent data (max length is 10 characters)

Example:

• Change the data sent from the pressing of button 1 to HelloWorld using the command:
  • at+button=1:1:HelloWorld

NOTE

• Refer to the datasheet to view the key functions of the button.

After the button is pressed, if the device is still sending, the user’s subsequent key actions will be ignored until the device has finished sending.

Functions

LEDs Functions

• Refer to the datasheet to view the key functions of the button.

HeartBeat Functions

• The HeartBeat is used to monitor the network connection and to send the battery level information of the RAK7201V2.
• The device can send a HeartBeat packet according to the configured HeartBeat interval. The AT command for configuring the HeartBeat interval is as follows:
  • at+heartbeat=

Where:

• The interval range is 0-120 (in hours), 0 to turn off the function.

Example:

• Set the HeartBeat to one hour using the command:
  • at+heartbeat=1

The HeartBeat message data format is as follows:

Headers / Payload

• 0X48 / Battery level in HEX

The battery level is represented in percentage form in hexadecimal format.

Example:

• If the payload message of the HeartBeat is 48 61, it represents 96% battery level.
• The device will automatically send a low-voltage alarm signal when the battery power is below 20% and again when it is below 10%.

Battery power warning signal:

Battery Power / Warning Signal

• Power is less than 20%. / 57 14
• Power is less than 10%. / 57 0a

Device Restart

Two restart options are available:

1. Using an AT command:
   • atz
2. Hold Key 2 for three (3) seconds. When held, the blue LED will stay lit. It will turn off when the device is restarted.

NOTE

After restarting the device either manually or through the AT command, the RAK7201V2 will attempt to automatically join the network if the OTAA method is configured. You can identify this process through the four blue LEDs that will flash clockwise. The device will make three attempts to join the network. If the first three attempts fail, the red LED on button 4 will flash for a second. If all three attempts are unsuccessful, the device must be restarted either manually or through the AT command to make a new attempt.

References

• RAK7240V2/RAK7240CV2 Quick Start Guide | RAKwireless Documentation Center
• RAK7240 Quick Start Guide | RAKwireless Documentation Center
• RAK7249 Quick Start Guide | RAKwireless Documentation Center
• RAK7258 Quick Start Guide | RAKwireless Documentation Center
• RAK7268V2/RAK7268CV2 Quick Start Guide | RAKwireless Documentation Center
• RAK7289 Quick Start Guide | RAKwireless Documentation Center
• RAK7201V2 Firmware Upgrade Guide | RAKwireless Documentation Center
• RAK7201v2 Button 4K | LoRa Smart Button | LoRa Push Button – RAKwireless Store

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>