Download
Share
Print this page
  1. Manuals
  2. Brands
  3. RAK Manuals
  4. Test Equipment
  5. RAK10701-P
  6. Quick start manual

RAK RAK10701-P Quick Start Manual

Field tester pro for lorawan
Hide thumbs

Advertisement

Quick Links

Download this manual
Documentation Center
RAK10701-P Field Tester Pro for LoRaWAN
Quick Start Guide
Prerequisites
What Do You Need?
Before going through each and every step in the installation guide of the RAK10701-P Field Tester Pro for
LoRaWAN, make sure to prepare the necessary items listed below:
Hardware Tools
1.
RAK10701-P Field Tester Pro for LoRaWAN
2. LoRa SubGhz Antenna with RP-SMA connector
3. USB Type-C Cable
4. Windows/Linux/macOS for PC or iOS/Android for mobile
Software Tools
WisToolBox
for configuration and firmware update.
NOTE:
It is mandatory that you are within the coverage of the LoRaWAN Gateway of the network you are trying to
join. Without the coverage, the Field Tester will not be useable.
Product Configuration
RAK10701-P Field Tester Pro Physical Interface
The user interface of the RAK10701-P Field Tester Pro for LoRaWAN is via TFT Touchscreen LCD and one
pushbutton at the side. There is also an external LoRA antenna port via RP-SMA connector and USB-C port for
charging and configuration if connected to a PC.

Advertisement

loading

Summary of Contents for RAK RAK10701-P

  • Page 1 Quick Start Guide Prerequisites What Do You Need? Before going through each and every step in the installation guide of the RAK10701-P Field Tester Pro for LoRaWAN, make sure to prepare the necessary items listed below: Hardware Tools RAK10701-P Field Tester Pro for LoRaWAN 2.
  • Page 2 Figure 3: RAK10701-P power off 2. When the device initializes, it will show the RAK logo on the screen. If there is any initialization error, it will be shown on the upper right section of the screen as well. A properly working device should not have any errors...
  • Page 3 If you are indoors, there will be no reception of the GPS signal. The latitude and longitude data will be empty. Figure 6: RAK10701-P Main Page waiting for valid data 4. Once fully powered on, the external button at the side can sleep or wake up the display on the LCD screen via a single press on it.
  • Page 4 The field tester supports different network servers and can be used as well on others not listed in this guide as long as the uplink and downlink packets are configured correctly. You can check each guide on how to use the RAK10701-P Field Tester Pro for LoRaWAN in the following network servers.
  • Page 5 Documentation Center Figure 8: Heluim Console Figure 9: Console Home Page 2. Once you are logged in, you can start adding your device. You have two ways to add a device as shown in the image.
  • Page 6 NOTE: The DEVEUI, APPEUI, and APPKEY are important in this step. These values must be configured on your RAK10701-P device using WisToolBox which will be covered later in this guide. Figure 11: Configuring Device Name 4. The device will be added to the blockchain and it will show pending beside its name.
  • Page 7 Documentation Center Figure 12: Pending Device Status 5. While waiting for the device to be added to the blockchain, you can create a . This will allow you to Label group your device to have a common setting. This will be needed to attach the needed integrations to the backend server of .
  • Page 8 Documentation Center Figure 14: Add Label Name Figure 15: Label created successfully 6. Once the is created you have to associate it on the RAK10701 device. You can attach the Label Label the device by clicking the Add Label button. Figure 16: Attach a label to the device...
  • Page 9 Documentation Center 7. A pop-up will be shown and you have to select the correct created for RAK10701 then click Add Label. Label Figure 17: Drop-down on label selection 8. After successful attachment of on the devices, it should show one (1) device is under that .
  • Page 10 Documentation Center Figure 20: HTTP integration 10. Then you must proceed to steps 2 and 3 sections of the settings. You have to select then Integration POST on the Endpoint URL, you must put . It is also needed to https://dev.disk91.com/fieldtester/helium/v3 put the integration name before the clicking Add integration button.
  • Page 11 Documentation Center Figure 22: Setting up the Flows 12. You must select and then drag the correct blocks on the flows canvas. Labels Integrations Figure 23: Drag the rak10701-devices label...
  • Page 12 Documentation Center Figure 24: Drag the RAK1070x_Integration 13. You then have to connect the block to the block via the tiny connector indicated by the Label Integration red arrows by using your mouse cursor and dragging the line connector. NOTE: There is no need to save the changes created on the flows canvas since it is automatically saved as you do changes.
  • Page 13 Documentation Center Figure 26: Creating Packets 15. You must also input a name on the , select and drag the slider so it Packet Config Name Multiple Packets will show . Once done, you can now click on All Available Packets + Create Packet Config Figure 27: Multiple packets configuration...
  • Page 14 RAK10701-P Field Tester Pro Guide for The Things Network This section shows how to use the RAK10701-P Field Tester Pro for LoRaWAN to The Things Stack. 1. First, log in to TTNv3. To do so, head to the TTNv3 site and select your cluster.
  • Page 15 Figure 31: Console page after a successful login NOTE: To connect RAK10701-P Field Tester Pro to TTNv3, you should already have connected a gateway in range to TTNv3. Or, you have to be sure that you are in the range of a public gateway.
  • Page 16 Documentation Center Figure 32: Create an application 3. To have an application registered, you need to input first the specific details and necessary information about your application then click Create application. Figure 33: Creating an Application 4. 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.
  • Page 17 Documentation Center Figure 34: Add end-devices to your TTN application 5. To register the RAK10701-P Field Tester Pro, you need to click Manually first. Figure 35: Adding end devices manually 6. Choose the following configurations in adding the end devices. You must choose the correct Frequency Plan...
  • Page 18 Documentation Center Figure 36: Configurations for adding end devices 7. Click Show advanced activation, LoRaWAN class, and cluster settings, then select Over the air action (OTAA). Figure 37: OTAA settings 8. Then input the LoRaWAN OTAA parameters. For AppEUI, you may click Fill with Zeros. For AppKey and DevEUI, you can click Generate.
  • Page 19 DevEUI AppKey configuration of the RAK10701-P Field Tester Pro hardware later on in this guide. Figure 39: OTAA device successfully registered to TTN 10. After adding the device to the LoRaWAN application, link it to the backend server. The first step is to create an...
  • Page 20 Documentation Center Figure 40: Creating API key Figure 41: Creating API key 11. Configure the API key parameters. You can put any names that will easily track your API. You have to set the expiration date as well. Then you must check .
  • Page 21 Documentation Center Figure 42: API key parameters 12. This step is critical. You need to copy the API key because this will be used on Webhook integration. Figure 43: Copy API key 13. With the API key created, you can proceed with creating the Webhook integration.
  • Page 22 Documentation Center Figure 44: Webhook Integration 14. Select Custom Webhook. Figure 45: Custom Webhook 15. Configure the necessary parameters on the Webhook. You can select any name for the webhook. You then need to set the base URL going to disk19 server , add the API https://dev.disk91.com/fieldtester/ttn/v3 key from the previous step and lastly put a check on the...
  • Page 23 Documentation Center Figure 46: Webhook parameters 16. After setting all the configurations, you can now add the webhook. Figure 47: Add Webhook 17. You should see now the newly created webhook.

  • Page 24: How Does It Work

    BLE. You also have the option to update device parameters directly via RUI3 AT Commands RAK10701-P Field Tester Pro Guide for Chirpstack How Does It Work? There are two steps under the hood of the Field Tester. In step one, the Field Tester is sending out data packets over LoRaWAN.
  • Page 25 Datacake.co 1. To start with Chirpstack, you must create a device profile for your RAK10701-P Field Tester Pro device. You must select which is the LoRaWAN specification version that the RAK10701 LoRaWAN MAC version 1.0.3 Field Tester supports.
  • Page 26 Documentation Center Figure 53: Custom Javascript Decoder for RAK10701 Field Mapper Here's the complete decoder script:...
  • Page 27 Documentation Center function Decode(fPort, bytes, variables) { decoded // avoid sending Downlink ACK to integration (Cargo) ((fPort (fPort 2)){ lonSign (bytes[0] >> & 0x01 latSign (bytes[0] >> & 0x01 encLat ((bytes[0] & 0x3f) << (bytes[1] << (bytes[2] << (bytes[3] >> encLon ((bytes[3] &...
  • Page 28 Documentation Center Figure 54: Create application in Chirpstack Figure 55: Create device in Chirpstack.
  • Page 29 Documentation Center Figure 56: Device APPKEY 5. You also need to secure that you have a Gateway registered in Chirpstack and with the correct Network Server profile. Figure 57: Gateways registered in Chripstack 6. The next step after setting up the network server, devices, and gateway, is the integration of the Chirpstack application to Datacake.
  • Page 30 Documentation Center Figure 58: Creating integration Figure 59: Creating endpoint for Datacake.co 7. The last step on the Chirpstack side, is the creation of the API key. This is needed to allow Datacake in sending downlink packets to the RAK10701 Field Tester. Make sure the key is copied and saved somewhere, it is only retrievable during the key creation.
  • Page 31 Documentation Center Figure 60: Creation of API Key Figure 61: Creation of API Key 8. You can now proceed on Datacake and add a LoRaWAN device that will be linked to your RAK10701 created in ChirpStack. You have to create an account if you do not have one yet. Figure 62: Device list dashboard...
  • Page 32 Documentation Center Figure 63: Selecting LoRaWAN Figure 64: Add new product...
  • Page 33 Documentation Center Figure 65: Selecting chirpstack Figure 66: Adding device name 9. Next step is to enable the downlink. This is the step where you'll be needing the previously created API key in step 7 of this guide. Take note that the should be based on your deployed Chirpstack ChirpStack URL network server.
  • Page 34 Documentation Center Figure 67: Configuration settings Figure 68: Chirpstack downlink configuration Figure 69: Chirpstack URL and API key...
  • Page 35 Documentation Center 10. Just below the section in datacake.co, you'll see the . This is a very critical step LoRaWAN Payload Decoder to ensure that all important data will be covered.
  • Page 36 Documentation Center function distance(lat1, lon1, lat2, lon2) { ((lat1 lat2) && (lon1 lon2)) { return else radlat1 Math.PI lat1 180; radlat2 Math.PI lat2 180; theta lon1 lon2; radtheta Math.PI theta 180; dist Math.sin(radlat1) Math.sin(radlat2) Math.cos(radlat1) Math.cos(radlat2) (dist > 1) { dist dist Math.acos(dist);...
  • Page 37 Documentation Center decoded.raw = rawPayload.uplink_message.rx_metadata[0].location; decoded.num_gw normalizedPayload.gateways.length; decoded.minRSSI decoded.maxRSSI decoded.minSNR decoded.maxSNR decoded.minDistance decoded.maxDistance server_type // Check if payload comes from TTN if (typeof (rawPayload.uplink_message) "undefined") { console.log("Found TTN format"); server_type // Check if payload comes from Helium else if (typeof (rawPayload.hotspots) "undefined") { console.log("Found Helium...
  • Page 38 Documentation Center //TTN case gw_lat[idx] rawPayload.uplink_message.rx_metadata[idx].location.latitude; gw_long[idx] rawPayload.uplink_message.rx_metadata[idx].location.longitude; break; // Helium case gw_lat[idx] rawPayload.hotspots[idx].lat; gw_long[idx] rawPayload.hotspots[idx].long; break; // Chirpstack case gw_lat[idx] rawPayload.rxInfo[idx].location.latitude; gw_long[idx] rawPayload.rxInfo[idx].location.longitude; break; default: console.log("Unknown LNS"); break; console.log("IDX " " lat " gw_lat[idx] " long " gw_long[idx]); // decoded.gw_lat[idx] = gw_lat; // decoded.gw_long[idx] = gw_long;...
  • Page 39 Documentation Center case decoded.hotspot_06 "(" gw_lat[5] "," gw_long[5] ")"; case decoded.hotspot_05 "(" gw_lat[4] "," gw_long[4] ")"; case decoded.hotspot_04 "(" gw_lat[3] "," gw_long[3] ")"; case decoded.hotspot_03 "(" gw_lat[2] "," gw_long[2] ")"; case decoded.hotspot_02 "(" gw_lat[1] "," gw_long[1] ")"; case decoded.hotspot_01 "(" gw_lat[0] ","...
  • Page 40 Documentation Center Once the data is extracted, it calculates the distance between the RAK10701 Field Tester location and the different gateways that received the LoRaWAN packet. This version of the decoder can handle up to 10 gateways, but it can be extended. function distance(lat1, lon1, lat2, lon2) { ((lat1...
  • Page 41 Documentation Center Field Name Identifier (returned value from the decoder) Field Type Field Tester LOCATION Location MinDistance MINDISTANCE Integer MaxDistance MAXDISTANCE Integer MinRSSI MINRSSI Float MaxRSSI MAXRSSI Float MinSNR MINSNR Float MaxSNR MAXSNR Float hotspot_01 HOTSPOT_01 Location hotspot_02 HOTSPOT_01 Location hotspot_0…...
  • Page 42 (measurements.MAXMOD.value 0) { measurements.MAXMOD.value buf[4] measurements.MAXMOD.value; buf[5] measurements.NUM_GW.value; return buf; 13. You can now proceed on device configuration so that the proper EUIs and KEY will match the one in the network server. Configuration of RAK10701-P Using WisToolBox...
  • Page 43 WisToolBox and also with the help of the touchscreen LCD user interface. 1. Connect the RAK10701-P to the PC via USB Type-C cable and open the WisToolBox application. You can find more info on how to install and use the WisToolbox from its documentation 2.
  • Page 44 Documentation Center Figure 75: Detected module by WisToolBox 5. You can now update the APPEUI, DEVEUI, and APPKEY. It must be the same as the parameters you have in Setting up of Network Server. Then you can click APPLY COMMANDS. Figure 76: Changing device parameters NOTE: These are the only parameters that you need to change via WisToolBox.
  • Page 45 TX power, and data rate as needed. You can use the arrows for navigation and click to save changes. Figure 78: RAK10701-P settings button Figure 79: Configurable parameters Miscellaneous This part of the guide shows the Field Tester interface and how to update the firmware.
  • Page 46 Figure 81: Different device status Status: IDLE: RAK10701-P Field Tester Pro state is in between the previous uplink and the next uplink. The duration of IDLE depends on the interval configured on the device. JOINING: RAK10701-P Field Tester Pro is trying to join the network. This status is triggered when a Join request is sent.
  • Page 47 Documentation Center Figure 83: Settings page Data Plots There are four different data plots on the field tester: number of gateways, RSSI, SNR, and approximate distance. These graphs are accessible by touching the respective icons assigned to the parameter. Figure 84: Accessing different data plots Figure 85: Distance plot Figure 86: RSSI plot...

  • Page 48: Upgrading The Firmware

    Figure 89: GPS data Upgrading the Firmware It is recommended to update to the latest version of the firmware. To do this, download the latest RAK10701-P WisNode Field Tester firmware and use the WisToolBox to update the custom firmware. 1. Drag the downloaded firmware to the WisToolBox custom firmware section.
  • Page 49 Documentation Center Figure 90: WisToolBox firmware 2. After the firmware file is uploaded to the application, you can now select UPGRADE DEVICE. Figure 91: Upload the latest firmware Figure 92: Confirm upgrading of firmware...
  • Page 50 Documentation Center 3. If all proceed with no error, you should see notification, and the RAK10701-P Firmware update successful will restart automatically. Figure 93: Ongoing upgrading of firmware Figure 94: Successful upload of latest firmware Last Updated: 11/9/2022, 8:19:58 AM...