Skip to content

Device Configurator User Guide

The Device Configurator is a desktop tool for configuring NeoGT LoRaWAN sensor devices over a serial connection. It stores reusable profiles, connects to a device, reads the current device parameters, and applies the selected profile to the device.

This page explains how profiles work and what each profile field controls.

Profiles

A profile is a saved set of LoRaWAN and sampling settings that can be applied to one or more devices. Profiles are useful when multiple devices must use the same gateway, LoRaWAN application, frequency plan, and reporting interval.

In the profile editor, users can:

  • Create a new profile.
  • Edit an existing profile.
  • Import or export a profile as JSON.
  • Select the active profile.
  • Apply the selected profile to a connected device.

When a profile is applied, the tool compares the profile values with the current device values and writes the changed fields to the device.

Profile fields

  • Name: A local name for identifying the profile in the configurator. Use a name that describes the site, project, or gateway configuration.
  • APPEUI: The LoRaWAN Application EUI. It must be exactly 16 hexadecimal characters. This value must match the application configured for the device in the gateway/network server.
  • APPKEY: The LoRaWAN Application Key. It must be exactly 32 hexadecimal characters. This key is used during OTAA join and must match the key configured in the gateway/network server.
  • BAND: The LoRaWAN regional frequency band. For standard Australian WisGate deployments, select AU915 - 915 MHz Australia (6).
  • MASK: A 4-character hexadecimal channel mask. For standard NeoGT AU915/WisGate deployments, use 0003.
  • Uplink Period: The reporting interval in seconds. This controls how often the device sends a normal uplink sample.
  • GPS Decimation Factor: Controls how often GPS is acquired compared with normal uplinks. For example, a higher value reduces how often GPS is requested, which can reduce power use.

BAND and MASK for WisGate

For Australian WisGate deployments, the device and gateway must use matching AU915 channel settings.

  • Set BAND to AU915 - 915 MHz Australia (6).
  • Set MASK to 0003 for the standard NeoGT WisGate configuration.
  • In the WisGate frequency sub-band setting, use the option for channel 0-15, channel 64-65.

AU915 has 72 uplink channels in total. The main data channels are CH0 to CH63, and they are grouped into 8 sub-bands of 8 channels each. A 16-channel WisGate can listen to two 8-channel sub-bands at the same time.

The MASK value selects which sub-bands the device may use:

MASKBinarySelected AU915 channels
00010000 0000 0000 0001CH0-CH7
00020000 0000 0000 0010CH8-CH15
00030000 0000 0000 0011CH0-CH15

Standard setting

For the default NeoGT WisGate setup, use BAND = AU915 (6) and MASK = 0003. Change the MASK only when the WisGate frequency sub-band configuration is intentionally changed.

Neotech Geotechnical Engineering documentation.