Skip to main content

Configuration

The device configuration can be changed in several ways:

  • sending LoRaWAN downlink messages to the device,
  • sending Cellular downlink messages to the device,
  • using the device's Command Line Interface over USB,
  • using the device's Command Line Interface over Bluetooth.

If you want to learn more about these low-level configuration methods, see the links in the "Further Reading" section at the end of this page. For a first hands-on experience, we recommend starting with our configuration tools.

Configuration tools​

Configuring a device with downlink messages or Command Line Interface (CLI) commands can be verbose and is not always the most convenient option. To simplify this process, Abeeway provides web tools that help users prepare, edit, and transfer configuration files.

Instead of sending a separate command for every parameter change, users can work with configuration files and then import or export them through USB or Bluetooth.

The main tools for this are BeeHive and Beequeen:

  • BeeHive can be used to import and export configuration files and to connect to the device CLI over Bluetooth or USB.
  • BeeQueen is a web-based configuration file editor.

Both applications are designed for Chrome. They rely on Chrome's Web Bluetooth and File System APIs, which are not yet available in all browsers.

Further Reading​

More details on how to set configuration parameters can be found under the following links:

BeeHive​

BeeHive is a Chrome application that can be used to import and export configuration files and to connect to the device Command Line Interface over Bluetooth or USB.

Connecting over Bluetooth​

  1. Pair your computer with the device using the UI of your operating system (Windows, Linux).
  2. Open the BeeHive App in your Chrome browser.
  3. Click the Connect a BLE Device button and wait until your device name, starting with the "AB" prefix, appears on the screen.
  4. Select the device and click on Pair.

Connecting over USB​

  1. Open the casing of the device.
  2. Remove the PCB from the device.
  3. Find the USB port on the PCB and connect it to your computer with a USB cable.
  4. Open the BeeHive App in your Chrome browser.
  5. Click the Connect a USB Device button and wait until the device serial port appears on the screen.
  6. Select the port and click on Connect.

Using BeeHive​

After the device is connected, you can use the controls at the top of the screen to import or export configuration files, or to open the CLI interface.

BeeQueen​

BeeQueen is a web-based configuration file editor that runs in Chrome.

It is also a useful way to get familiar with the main device features and configuration options.

To create a new configuration file, open BeeQueen in Chrome and select File -> New (default).

Configuration parameters are grouped into categories such as System, Core, Geoloc, and GNSS as well as several others. These categories can be selected using the tabs at the top of the screen.

If you are new to the device configuration, a good starting point is:

  • Start with the Geoloc group, which defines which geolocation technologies are used and when they are triggered.
  • Then review the technology-specific groups such as GNSS, LR11xx, and BLE Scan.
  • Finally, look at the connectivity-related groups such as Network, LoRaWAN, and Cellular.

When you finish editing the configuration file, select File -> Save as... to save it.

The saved configuration file can then be imported into the device using BeeHive.

tip

If you only want to change the value of a single configuration parameter, you can do so by sending a dedicated payload to the device.

This payload can be sent either through a LoRaWAN network on FPort: 2 or through a cellular network.

To generate the payload in BeeQueen, click the small <double-arrow-down> icon next to the parameter ID.