RAK10701-Plus Field Tester for LoRaWAN Network Setup

Before conducting any field tests, it’s essential to set up the Field Tester Plus, configure your LoRaWAN gateway, and ensure all system components are properly connected.

Prerequisites

Ensure that the following hardware and software components are ready:

Hardware Requirements

• RAK10701-Plus Field Tester (LoRaWAN end device)
• LoRa Sub-GHz Antenna (RP-SMA connector)
• USB Type-C Cable (for charging and optional advanced configuration)
• RAK Gateway running WisGateOS 2 with Field Test Extension installed
  • Example models include:
    • RAK7268V2
    • RAK7289V2
    • RAK7240V2
  • For the full list of compatible gateways, refer to the official WisGate Edge product series.）

NOTE

If you purchased the Field Tester Plus Bundle, the RAK7268V2 comes pre-installed with the required extension.

Software Requirements

• Field Test Data Processor Extension for WisGateOS 2: To install the extension, see the guide: How to Add an Extension

• WisToolBox: Required for configuring OTAA parameters (DevEUI, AppEUI, and AppKey) Used to register the Field Tester Plus on your LoRaWAN Network Server Also supports firmware updates and device-level configuration

Field Tester Plus Configuration

Before configuring the Field Tester Plus, it’s important to understand the physical interfaces, display layout, and basic operations of the device. For detailed specifications, refer to the Field Tester Plus Datasheet.

1. Connect the LoRa Sub-GHz antenna (RP-SMA connector) to the device.
2. Press and hold the side button for 5 seconds to turn on the Field Tester Plus.

Figure 1: Power On Screen

3. Once powered on, the main screen will appear.

NOTE

No data will be shown on first boot until a valid uplink occurs.

Figure 1: Field Tester Main Screen

4. Tap the gear icon on the screen to open the Settings menu.

Figure 1: Field Tester Settings

Parameter Selection & Adjustment:

• Tap the icon to cycle through available parameters (e.g., Band, DR, TX Power). The selected parameter will blink, indicating it is active.
• Tap the icon or icon to adjust and confirm the parameter’s value.

Editable Parameters:

Setting	Description	Values / Notes
Location Labeling	Set a test point label (important for CSV export)	Default: NULL Max Length: 6 characters
Band	LoRaWAN regional frequency band	RU864, IN865, EU868, US915, AU915, KR920, AS923-1/2/3/4
DR (Data Rate)	Affects signal range (lower DR = longer range)	The available DR options vary by LoRaWAN regional frequency band.
TX Power	Transmission power level	The available TX Power options vary by LoRaWAN regional frequency band.
TX Interval	Time between uplinks	6-3600 s
Backlight	Screen brightness	0-10
ADR	Enable/disable Adaptive Data Rate	ON/OFF

5. After adjusting the parameters, select OK. In the confirmation screen, choose OK again to save your settings and exit the configuration interface.

Figure 1: Field Tester Apply Changes

6. (Optional) Set DevEUI, AppEUI, AppKey via WisToolBox.

• Connect the Field Tester Plus to your PC using a USB Type-C cable.
• Launch the WisToolBox for Desktop.
• Click CONNECT to establish a connection with the device.

Figure 1: WisToolBox Connection Settings

NOTE

If the connection fails, refer to the WisToolBox for Desktop | Installation and Setup Guide.

• Select the device and navigate to the ADVANCED tab.

Figure 1: Field Tester Connected To WisToolBox

Figure 1: Field Tester Advanced Commands

• Click OPEN CONSOLE, then enter the following AT commands:

Command	Value Format
AT+DEVEUI=	8 bytes (64-bit hex, e.g. 70B3D57ED0012345)
AT+APPEUI=	8 bytes (64-bit hex)
AT+APPKEY=	16 bytes (128-bit hex)

Figure 1: WisToolBox AT Command Console

Field Test Data Processor Extension Installation

The Field Test Data Processor Extension is an optional application that runs on RAK WisGate Edge gateways powered by WisGateOS 2. It enables local signal analysis, CSV report generation, and heatmap visualization for data collected by the Field Tester Plus.

The extension communicates with LoRaWAN Network Servers via MQTT (subscribe/publish), and supports both Built-In and External LNS:

1. RAK Gateways Built-in LNS

Figure 1: Built-in LNS Setup

In this setup:

• Uplinks from the Field Tester are forwarded to the built-in LNS on the RAK Gateway.
• The extension subscribes to the MQTT Broker within the gateway to receive packets.
• This allows fully local processing, even without an external network. Best for offline, indoor, or portable testing setups.

2. External LNS (e.g., ChirpStack, TTN, AWS IoT Core)

Figure 1: External LNS Setup

In this setup:

• The RAK Gateway uses Packet Forwarder or Basic Station mode to connect to an external LNS (e.g., ChirpStack, TTN, AWS IoT Core).
• The extension remains installed locally on the gateway and connects to the external MQTT broker of the LNS to receive packet metadata for analysis.
• Ideal for production deployments with cloud LNS platforms.

Installation Scenarios

• Field Tester Plus Bundle: The included gateway comes pre-installed with the Field Test Extension.
• Other RAK WisGateOS 2 gateways: Manually install the extension via the WisGateOS 2 web interface. See: How to Add an Extension.

Figure 1: WisGateOS 2 Extensions Menu

Set Up the Gateway and the Field Tester Plus for Your LNS

This section provides step-by-step instructions to:

• Connect your LoRaWAN gateway to your chosen LNS platform.
• Register the Field Tester Plus device to the network.
• Install and configure the Field Test Extension to enable local data analysis and reporting.

Built-in LNS (WisGateOS 2)

Set Gateway to the Built-in Network Server

This section demonstrates how to connect your RAK gateway to a LoRaWAN Network Server (LNS).

1. Log into the WisGateOS 2 web UI. Navigate to LoRa > Configuration.
2. In the Work Mode section, select Built-in Network Server.

Figure 1: LoRa Configuration Work Mode

3. Select the log level and frequency band.

Figure 1: Log And Frequency Band Configuration

NOTE

Make sure the frequency band configured on the gateway matches the LoRaWAN Band setting of your Field Tester Plus.

Register the Field Tester Plus

1. Ensure your gateway is configured to use the Built-in LNS. Navigate to LoRa > Applications tab.
2. Click the Add application button (or the add one now link).

Figure 1: Built LNS Application Menu

3. You will be redirected to the application configuration page. Fill in the following fields:

Figure 1: New Application Data Fields

• Application name: Name of the application.
• Application description: Description of the application (optional).
• Application Type
  • Unified Application key: All devices will use the same application key.
  • Separate Application keys: Each device or group of devices has a unique key.
• Auto Add Device: When enabled, devices with matching AppKey and Application EUI will be added automatically after a successful join request.
• Application Key: Required for Unified Application Key setup.
• Application EUI: Required for automatic device registration when Auto Add Device is enabled.

NOTE

Refer to the Field Tester Plus Configuration section for matching AppKey and AppEUI setup.

4. Click Save Application to complete the creation.
5. Once the application is saved, navigate to: Your Application > Configuration. Click End Devices to proceed.

Figure 1: Application End Devices Menu

6. In the End device information interface, fill in the following information.

Figure 1: End Device OTAA Configuration

• Activation Mode: Select OTAA. This value needs to be consistent with the value from the end device.
• End device (group) name: Name of the end device (group).
• End device description (optional) A description of the end device, optional.
• Class: Class A
• Frame Counter Width: Keep the default value.

6. Click Add end devices to enter the device adding page.
7. In the Adding end devices interface, enter the device EUI in the End Device EUI (main) field and click the Add to End Devices list button.

• Correct devices will appear under the End devices list.
• Duplicate devices will appear under End devices with error for correction.

Figure 1: Add New End Device

9. Click Add end devices to add the Field Tester Plus to the application.

Once registered, the Field Tester Plus will begin sending periodic uplinks to the Built-in LNS.

Figure 1: End Device Field Tester Added

The device is currently operating in LinkCheck Mode, as the Field Test Data Processor Extension has not yet been configured. In this mode, the device screen will only display:

• Downlink RSSI/SNR
• Number of responding gateways

Figure 1: Field Tester LinkCheck Mode

Next, install and configure the Field Test Extension to enable full metric reporting (uplinks, packet loss, CSV export).

Configure Field Test Extension for Built-in LNS

For detailed steps on configuring the Field Test Extension for the Built-in LNS, the WisGateOS 2 Extension > Field Test > Built-in Network Server.

The Things Network (TTN)

Connect Gateway to TTN

This section explains how to connect and configure a RAK gateway with The Things Network (TTN), using the RAK7289V2 model as a reference.

NOTE

Make sure the frequency band configured on the gateway matches the LoRaWAN Band setting of your Field Tester Plus.

To complete the TTN gateway setup, follow the instructions in RAK7289V2 LoRaWAN Network Server Guide | The Things Network (TTN)..

Register Field Tester Plus on TTN

To connect your Field Tester Plus to The Things Network (TTN), a community-based LoRaWAN Network Server (LNS), visit the TTN Console at: https://console.cloud.thethings.network/

1. Choose the appropriate cluster for your region. You can either select your country or manually choose the nearest TTN cluster.

Figure 1: The Things Network Cluster Selection

2. On the homepage, click Add application.

Figure 1: The Things Network Add Application

3. Add Application ID, Application name, and Description then click Create application.

Figure 1: The Things Network Create Application

4. Click Register end device within your newly created application.

Figure 1: The Things Network Register End Device

5. Choose Enter end device specifics manually. This will allow you to add the Frequency plan, LoRaWAN version, Regional Parameters version, and JoinEUI. The values of these parameters depend on the hardware you use. If your device has a preconfigured JoinEUI, you must use it. Click Confirm after putting all the details.

Figure 1: The Things Network JoinEUI and Parameters

6. After confirming the JoinEUI, you can proceed on adding other OTAA parameters—DevEUI and AppKey. Use the Generate button if these parameters are not available with the device. Otherwise, use the OTAA parameters provided with the device.

Figure 1: The Things Network DevEUI and AppKey

7. After you register the device, it will be added to the LoRaWAN application.

Figure 1: The Things Network Device Added Successfully

8. Restart the Field Tester Plus. Once registered and connected, it will begin sending periodic uplinks to the TTN LNS.

Figure 1: The Things Network Live Data

The device is currently operating in LinkCheck Mode, as the Field Test Data Processor Extension has not yet been configured. In this mode, the device screen will only display:

• Downlink RSSI/SNR
• Number of responding gateways

Figure 1: Field Tester Uncomplete Menu

Next, install and configure the Field Test Extension to enable full metric reporting (uplinks, packet loss, CSV export).

Configure the Field Test Extension for TTN

For detailed steps on configuring the Field Test Extension for the TTN, refer to the WisGateOS 2 Extension > Field Test > TTN

ChirpStack v4

Connect Gateway to ChirpStack v4

This section explains how to connect and configure a RAK gateway with ChirpStack v4, using the RAK7289V2 model as a reference.

NOTE

Make sure the frequency band configured on the gateway matches the LoRaWAN Band setting of your Field Tester Plus.

To complete the ChirpStack v4 gateway setup, follow the instructions in RAK7289V2 LoRaWAN Network Server Guide | ChirpStack v4.

Register Field Tester Plus on ChirpStack v4

1. Log in to your Chirpstack account and on the main dashboard page click Applications.

Figure 1: ChirpStack Application Dashboard

2. Click Add application and fill in the required fields:

Figure 1: ChirpStack Add Application

3. Click Submit to create the application.

4. Go to Device Profiles and click Add device profile.

Figure 1: ChirpStack Add Device Profile

5. Configure the profile to match your device's specifications:

Figure 1: ChirpStack Match Device Specifications

6. In the device profile configuration, go to the Join (OTAA / ABP) tab.
7. Enable the Device supports OTAA option and click Submit to save the device profile.

Figure 1: ChirpStack Enable Support OTAA

8. Navigate to the Applications > your application and click Add device.

Figure 1: ChirpStack Add Device on Applications

9. On the Add Device page, you must enter the device details, including Name, Description, Device EUI, Join EUI, and Device Profile. You can use the Generate button for the Device EUI and Join EUI if these values are not available with the device. Otherwise, use the OTAA parameters provided by the device. After entering all required information, click Submit to complete the process.

Figure 1: ChirpStack Fill Device Information

10. The next step is to provide the Application Key. Use the key provided with the device, if available; otherwise, click the Generate button to create one. After entering the Application Key, click Submit to proceed.

Figure 1: ChirpStack Add Application Key

Once registered, the Field Tester Plus will begin sending periodic uplinks to the Chirpstack v4 LNS.

Figure 1: Sending Periodic Uplinks to ChripStack

The device is currently operating in LinkCheck Mode, as the Field Test Data Processor Extension has not yet been configured. In this mode, the device screen will only display:

• Downlink RSSI/SNR
• Number of responding gateways

Figure 1: Field Tester Only Displays RSSI and SNR

Next, install and configure the Field Test Extension to enable full metric reporting (uplinks, packet loss, CSV export).

Configure Field Test Extension for ChirpStack v4

For detailed steps on configuring the Field Test Extension for the ChirpStack v4, refer to the WisGateOS 2 Extension > Field Test > ChirpStack.

AWS IoT Core for LoRaWAN

Connect Gateway to AWS IoT Core for LoRaWAN

This section explains how to connect and configure WisGateOS 2 with AWS IoT Core, using the RAK7289V2 model as a reference.

NOTE

Make sure the frequency band configured on the gateway matches the LoRaWAN Band setting of your Field Tester Plus.

To complete the AWS IoT Core gateway setup, follow the instructions in RAK7289V2 LoRaWAN Network Server Guide | AWS IoT Core .

Register Field Tester Plus on AWS IoT Core for LoRaWAN

Create a destination role for AWS IoT Core for LoRaWAN

To allow AWS IoT Core for LoRaWAN to forward device data to AWS services (via Destinations), you must assign an IAM role and policy that authorizes the service to publish messages on your behalf. If you've already created this IAM role during gateway setup, there's no need to create it again. Otherwise, follow the official AWS instructions below to set it up: Create a destination role for AWS IoT Core for LoRaWAN

Verify Profiles

1. Navigate to the AWS IoT console.
2. In the navigation pane, go to LPWAN Devices > Profiles.
3. Under Device Profiles, review the pre-defined options.
   • If none fit your device or region, click Add device profile and configure custom parameters.
   • Example: For AS923-1, set parameters accordingly.

Figure 1: AWS Add Device Profile

4. Click Add device profile to save.
5. In the Service Profiles section, click Add service profile and configure service parameters (default values are generally acceptable).

Figure 1: AWS Add Service Profile

6. Once you have created appropriate Device and Service Profiles, proceed to set up a destination for device traffic.

Set Up a Destination for Device Traffic

To use the Field Tester Extension with AWS IoT Core for LoRaWAN, you must associate your device with a Destination—this defines where your uplink data will be sent.

1. Navigate to the AWS IoT console.
2. In the navigation pane, choose LPWAN devices, and then Destinations.
3. Choose Add Destination.
4. Fill in the Destination details:

• For the Destination name, enter ProcessFieldTesterUplink. The name can be customized.
• Destination description (optional): Provide a helpful description.

5. Select Publish to AWS IoT Core message broker. This allows the uplink messages to be published to an MQTT topic for other applications or services to consume.
6. Enter a topic such as RecvFieldTesterUplink.
7. In the Permissions section, choose Select an existing service role and select the IAM role you had created earlier, from the drop-down.
8. Choose Add Destination. You will see a message Destination added, indicating the destination has been successfully added.

Figure 1: AWS Add Destination

Register Device

1. In the navigation pane, go to LPWAN Devices > Devices.
2. Click Add wireless device.
3. On the Add Device page:
4. Select the LoRaWAN specification version in the drop-down under Wireless device specification.
5. Enter the DevEUI.
6. Fill in the AppEUI/JoinEUI and AppKey as per your OTAA settings.
7. Provide a wireless Device name.
8. Under Profiles, select the Device Profile and Service Profile you created earlier.
9. Under Destination, choose the one previously created.

Figure 1: AWS Configure LoRaWAN Device

10. Click Next, then Add device to complete registration.

Once registered, the Field Tester Plus will begin sending periodic uplinks to the AWS IoT Core.

Figure 1: AWS Field Tester Configuration Completed

The device is currently operating in LinkCheck Mode, as the Field Test Data Processor Extension has not yet been configured. In this mode, the device screen will only display:

• Downlink RSSI/SNR
• Number of responding gateways

Figure 1: Field Tester Only Displays RSSI and SNR

Next, install and configure the Field Test Extension to enable full metric reporting (uplinks, packet loss, CSV export).

Configure Field Test Extension for AWS

For detailed steps on configuring the Field Test Extension for the AWS IoT Core, refer to the WisGateOS 2 Extension > Field Test > AWS IoT.