The LoRaWAN Device Manager enables users to manage and customize LoRa Packet Forwarder settings and Radio Configurations.
Working with VeeaHubs
To manage LoRaWAN devices:
1. Click the LoRaWAN link on the IoT Device Manager main screen.
This takes you to the LoRaWAN device manager.
On this page you will see a list of all the VeeaHubs that are connected in the mesh. The data displayed is as follows:
- Serial Number of the VeeaHub
- Gateway ID
- Channel Plan attached to it
- Current Status
2. Click a VeeaHub entry in the table to display information about that VeeaHub. The information which follows can be edited:
- Gateway ID
- SW/HW version
- Module Type
- Radio Configuration
- Gateway Bridge IP address
- Gateway Bridge downlink port
- Gateway Bridge uplink port
- Stats interval
Place your cursor on top of the question mark icon after each data item to learn more about the fields you can edit on this page.
3. Click the arrow in the Radio Configurations dropdown menu to select the Radio Configuration you want for that device. Note: You can only select the configurations that are available in your region.
4. After making all your changes, click the Save button and a success message is displayed.
A Radio Configuration is a frequency plan specific to a country or a region. LoRaWAN devices operate within a particular band of frequency channels in each country. A Radio Configuration appropriate to the country or region of operation of your VeeaHub must be selected.
To start working with Radio Configurations:
1. Click Radio Configurations in the left menu bar. The Radio Config page displays.
All the Radio Configurations are listed here. The Radio Configurations that are not supported by the available VeeaHubs are grayed out. A number of Radio Configurations come built-in.
For each Radio Configuration the information is displayed:
- Details (Country/Frequency range)
- Type (built-in or user-defined)
2. Click a Radio Configuration to go to the View Configuration page.
On this page, you see information about the selected Radio Configuration.
- Configuration name
- Details (Country/Frequency range)
- Configuration JSON
3. Click the Download button to download the JSON file for that Radio Configuration. You can use this JSON file as a blueprint to create a new Radio Configuration (see below).
For a user-defined Radio Configuration there is a Delete button. You cannot delete a built-in Radio Configuration or a user-defined configuration that is attached to a VeeaHub.
Creating a new Radio Configuration
To create a new Radio Configuration:
Click the New button on the Radio Configurations page. This displays the New Configuration page.
On this page, enter the following details:
- Name: Enter a name for the new Radio Configuration. The name is prefixed with the regional channel plan automatically.
- Region: The Region dropdown displays a list of frequency plans for different regions. The ones that are not valid for your current VeeaHub are grayed out. Select a plan from the dropdown.
- Details: Add the frequency range for the new radio configuration.
- Configuration JSON: This code box contains the JSON file of the radio configuration plan. You can write one of your own or you can download the JSON of an existing radio configuration and upload it to this new configuration using the Upload JSON button.
Once the JSON has been uploaded, its code populates the code box and the details in the other fields on this form, other than the name, are changed according to the details in this JSON file:
You can modify this JSON file according to your requirements.
Click Save to save the new radio configuration plan. It will available to assign to the VeeaHubs.
Note: Saving causes a number of validations to be done. If you have made mistakes while configuring the JSON file, a warning pop-up appears but the plan is saved. However, because of the incorrect JSON file, it will not be usable and in the Status column on the main Radio Configurations page, you will see it listed as Incomplete. See the next section.
Correcting a Radio Configuration
There are a some validations you must be aware of: schema validations, frequency out of range and Intermediate Frequency offset validations.
Schema validations: These check that all the keys are available inside the JSON file. So, for example, if the “type” key is missing from the code in the image above, we get the following error message:
Frequency out of range: If you enter a frequency that is out of range in the JSON, you will get an error message. The following table shows the frequency ranges for various model types.
900 MHz to 999.99 MHz
800 MHz to 899.99 MHz
400 MHz to 510.00 MHz
Example: In the following image, the frequency range for a model-RG-1008M device lies outside the valid frequency range:
This error message is displayed:
Intermediate Frequency (IF) Offset Validations: The difference between the maximum and minimum intermediate frequencies should not be more than 1MHz. Otherwise, an error message similar to this is displayed:
If you click on an incomplete radio configuration, you are redirected to the View Configuration page. A red exclamation mark at the top of the Configuration JSON block denotes that there is an error in it. You can make changes to the radio configuration plan by clicking the Edit button at the bottom of the page.
On the Edit Configuration page you can make changes to the JSON file.
Note: If the error is a missing key or missing keys, the key(s) are inserted into the configuration file with default value(s). Make sure that these values are replaced with the correct values for the device, as otherwise the file will be saved without an error but will not work with the device.
Click Save to save the changes.
VeeaHub Support for Private Network LoRaWAN Devices
To connect your VeeaHub/s to your LoRaWAN devices that are running on a private network, follow the steps as follows:
In order to get this feature, you must have the following:
- vBus IoT package version 1.8.0 and above
- VeeaHub platform version 2.26.0 and above.
- Go to the Radio Config page.
- Select a Radio Configuration name from the list and then download its JSON file.
- Next, go back to the Radio Config page and click on the New button.
- Fill out the New Configuration form as shown earlier in this document.
- Upload the JSON file.
- The JSON code will populate the Configuration JSON code box.
- Look for the
"lorawan_public"attribute in the JSON.
- If the value of the
true, like in the above image, then change it to
false. Any VeeaHubs that use this Radio Configuration will now support LoRaWAN devices that run on private networks. (
"lorawan_public":true: supports public networks;
"lorawan_public":false: supports private network)
- Click on Save to create the Radio Configuration.
- Return to the LoRaWAN home page and select the VeeaHub/s you want to support private network LoRaWAN devices.
- From the Radio Configuration dropdown, select the config you just created.
- Click on Save. A confirmation dialog will appear to inform you that your VeeaHub/s need/s to restart. Click on Ok and then restart your VeeaHubs.
- Once the VeeaHubs are back online, they will support LoRaWAN devices that run on private networks.
- To learn how to validate all the changes and what the next steps are, click here:
Setting up ChirpStack Application Server
Note. A developer enrollment account is required to view the above page.
For meshes, you will have to individually select the radio configuration that you just created for all the VeeaHubs.