# Stand-Alone Multitech Conduit AP/AEP

This section describes the steps necessary to connect a stand-alone Multitech Conduit AP or AEP LoRa gateway to the Radio Bridge console. In the stand-alone configuration, the network server is located on the local gateway and a Python script is used to pass messages to the Radio Bridge Console.

You will be following the below steps to connect your gateway and devices to Radio Bridge console:

  • Add gateway to the Console
  • Update firmware & configure Multitech gateway - LoRa Network server
  • Install python script (console package) in the Multitech Gateway
  • Add devices to the Radio Bridge Console
  • Add devices to the Multitech gateway

# Add Gateway to the Console

Log into the Radio Bridge console at console.radiobridge.com, select the Gateways tab on the left side, and click “Add Gateway”. Follow the menu to select Multitech and give the gateway a name. Click on “Register Gateway” and note the link to the installation script that will be used in future steps.

# Bring the Gateway Online

To bring the gateway online, refer to the standard setup instructions from Multitech. Note that the gateway may default to a static IP of 192.168.2.1.

Be sure to set the DNS correctly in the network setup, as future steps will fail if the DNS is not correct.

# Update Gateway Firmware

Verify that the gateway is running firmware version 5.3.0 or later. If it is not, follow the Multitech instructions for upgrading the system firmware before proceeding to the next steps.

# Enable the LoRa Network Server

Navigate to the LoRaWAN tab on the left side of the screen, select network settings, and under Mode select “Network Sever”. The default settings should be in the correct state, but double check that the Channel Plan is “US915”, the frequency sub-band set to 1, and the network mode is set to “Public LoRaWAN”. Click on Submit.

LoRa Network Server Configuration

Click on Administration -> Access Configuration and check the box “Via WAN” under the SSH heading. Click Submit.

Access Configuration

Go to Firewall->Settings and check the box “Allow Outbound”. Click Submit.

Firewall Configuration

Click Save and Apply.

# Install Python Script

Note: Following steps require the superuser access, so you must be allowed to run the sudo commands.

Log into the gateway via SSH. You can use a program such as PUTTY on Windows or the Terminal on a Mac. The command will usually take the form:

ssh <user>@<gateway IP address>

Enable the Superuser terminal & navigate to the home folder.

sudo -s

cd /opt

Now, you need to put the Multitech Gateway installation package to the gateway. Navigate to the Radio Bridge console window, copy the "Gateway setup package" link and run.

wget <gateway setup package link>

Extract the files with the command:

tar -xzvf multitech_sdk.tar.gz

Navigate to the extracted folder and execute the following commands to run the setup:

cd multitech_sdk

sudo chmod +x ./mqtt_gateway.sh

sudo ./mqtt_gateway.sh

sudo reboot

If you are prompted for a password in the above commands, use the admin password set for the gateway. You can close the SSH session.

After the gateway reboots, login through the web interface, click on LoRaWAN, and under network settings verify that the LoRa mode is set to “network server” and the status shows “running” in green.

# Add Devices to the Radio Bridge Console

Log into the console and select the Devices tab on the left side of the page and click “Add New Device”. Select the Multitech stand-alone gateway in the Select Network screen. For the ID and Key, use the numbers found on the sensor label which is the same ID/Key pair entered on the gateway.

Note that this only adds the devices to the console, they will still need to be added to the Multitech gateway. Adding a device to the Console does not automatically add to the gateway, and adding to the gateway does not automatically add them to the Console, so they must be added separately.

# Add Devices to Gateway

As mentioned in the previous step, even though the devices have been added to the Console, they will still need to be added to the Multitech gateway.

Log into the gateway and go to LoRaWAN -> Key Management. Under Location select “Local Keys”.

  1. You can export the devices from Console and upload the device in the Multitech gateway as shown in the below image.

    • Export the devices from console.

    Console device download

    • Upload the devices in the Multitech Gateway.

    Multitech device upload

OR

  1. You can add the device manually through "Add New" option.

    Enter the fields as shown in the following table.

    Table 6: Parameters for Device Setup

    Parameter Description
    Dev EUI The Device EUI listed on your sensor
    App EUI See section on AppEUI/JoinEUI above
    App Key Enter the Key listed on your sensor

    Click OK.

Note: Make sure the Enabled box is NOT checked under Local Network Settings. Once you have added all of your devices click on Submit then click Save.

Radio Bridge sensors can now connect to the console through the stand-alone gateway. Try creating sensor events and verify that you see messages in the console.

# Enable Debug Mode

If you don't see the messages in the Console then you can enable the debugging to view the logs to troubleshoot the issue.

To enable the log you need to modify the console config file. Log in to Multitech gateway via SSH and run the below command to edit the config file:

sudo vi /opt/multitech_sdk/console_config.json

Press the i key on your keyboard to enable the edit mode and Change the debug_mode attribute to true. Once done press ESC and then type :wq, press Enter to save the changes. Your configuration file will look like below sample config.

Debug Mode On Configuration

# Start/Stop the service

Run following command to stop the service

sudo /etc/init.d/radiobridge_mqtt_service stop

Run following command to start the service

sudo /etc/init.d/radiobridge_mqtt_service start

# View the Logs

Run following command to view the log on console.

sudo tail -f /var/log/console.log