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
- Pair your computer with the device using the UI of your operating system (Windows, Linux).
- Open the BeeHive App in your Chrome browser.
- Click the
Connect a BLE Devicebutton and wait until your device name, starting with the "AB" prefix, appears on the screen. - Select the device and click on
Pair.
Connecting over USB
- Open the casing of the device.
- Remove the PCB from the device.
- Find the USB port on the PCB and connect it to your computer with a USB cable.
- Open the BeeHive App in your Chrome browser.
- Click the
Connect a USB Devicebutton and wait until the device serial port appears on the screen. - 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
Geolocgroup, which defines which geolocation technologies are used and when they are triggered. - Then review the technology-specific groups such as
GNSS,LR11xx, andBLE Scan. - Finally, look at the connectivity-related groups such as
Network,LoRaWAN, andCellular.
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.
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.