MultiTech Conduit AEP

MultiTech Conduit AEP

The MultiTech MultiConnect® Conduit™ is a configurable, scalable cellular communications gateway for industrial IoT applications. The technical specifications of this Conduit can be found in the software guide in the official documentation page.

This guide will help you set up the Multitech Conduit gateway to communicate over The Things Stack.

MultiTech MultiConnect Conduit AEP Gateway

Prerequisites

  1. User account on The Things Stack with rights to create Gateways.
  2. Multitech Conduit AEP Gateway connected to the internet and running the latest firmware.

This article addresses the minimum configuration required to connect your Multitech Conduit AEP model to The Things Stack. For the first-time hardware and software setup, you can refer to the appropriate configuration guide on the Multitech documentation page.

Registration

Create a gateway by following the instructions for Adding Gateways.

Note: The gateway EUI can be found at the bottom of the gateway under the field "NODE LORA".

Configuration using a Terminal

Firstly, you will need to generate a global_conf.json file required to add a custom channel plan to your gateway. Follow the steps below to generate the required json file.

Warning: The manual configuration of the frequency plan - required to make it work on the The Things (Enterprise) Stack - may result in a mismatch for some of the frequency bands used for the Multitech Gateway.

The Gateway Configuration Server can be used to generate a proper global_conf.json configuration file for your gateway. You will need a Gateway API key with the View gateway information right enabled. The instructions for the same can be found in the Adding Gateways guide.

Open the command prompt in Windows or any Linux terminal to run a curl command (as shown below) to generate the required global_conf.json file in your current working directory.

Make sure you replace thethings.example.com with your server address:

$ curl -XGET \
    "https://thethings.example.com/api/v3/gcs/gateways/{GATEWAY_ID}/semtechudp/global_conf.json" \
    -H "Authorization: Bearer {GTW_API_KEY}" > ~/global_conf.json

Note: Replace the required fields in the above command and run it.

Once the global_conf.json file is generated, you will need to add this to your gateway. In a web browser, open the gateway’s configuration page by navigating to its IP Address obtained from the network it is connected to. Once logged in, you can configure the gateway to connect to The Things Stack by following the steps below:

  • Click on LoRaWAN® in the menu on the left. It opens the Gateway's configuration page.
MultiTech Conduit gateway home page
  • Under Network Settings, select the mode as "Packet Forwarder".
MultiTech Conduit packet forwarder settings
  • On the right side of the "LoRa Packet Forwarder Configuration" section, you can find "Manual Configuration ". Click on it to setup the channel plan manually.
Switch to manual configuration mode
  • The above step will lead you to the gateway configuration editor tagged as "Config".
edit the configuration
  • Copy the contents of the global_conf.json file downloaded earlier and paste them in the gateway console configuration editor.

  • Once pasted, modify the value of clksrc to set it to 0.

  • Click on Submit to save the configuration.

  • Now, click on Save and Restart from the menu.

Saving the Network Interfaces Configuration
  • You will be prompted to confirm the restart. Choose OK to proceed.
Configuration restart prompt

This will apply the custom settings and reboot the gateway. If all the steps have been followed correctly, your gateway will now connect to The Things Stack.

To know more about other features of the MultiTech Conduit gateway, you can refer to the mPower Edge AEP software guide on the Multitech Website.

Troubleshooting

Packet Forwarder Logs

Packet forwarder logs contain the messages received from the devices and the network server. You can use the information to debug the issues.

You can find the packet forwarder logs using the gateway's web console. Do the following to download the logs onto your device:

  • Login to your gateway's web console and navigate to Administration -> Debug Options.
  • Click on the Download Logs button in the Logging section to download the logs.
Packet forwarder

Now, in the downloaded logs, open the lora-pkt-fwd-1.log file to see the packet forwarder logs.

Upgrading the Firmware

If you have an issue with the current firmware version, you can use following steps to upgrade the firmware.

Refer to the top of your configuration software window to check your firmware version. You have to upgrade the device's firmware to the latest version.

You can download the firmware upgrades from the downloads section of the MultiTech website.

Do the following to upgrade the firmware on your device:

  • Before you upgrade your firmware, save your present configuration as a backup.
  • Go to the MultiTech website, locate the firmware upgrade file you want for your device(MTCDT AEP x.x.x in the current case, where x.x.x is the latest version available on the website), and download this file to a known location.
  • Navigate to Administration -> Firmware Upgrade.
  • Click on Choose Firmware Upgrade File button, and
    • Click on Browse to find where the firmware file resides that you want to apply.
    • Select the file and click on Open. The file name appears next to the Choose Firmware Upgrade File button. Make sure you select the correct BIN file; otherwise, your device can become inoperable.
  • Click on Start Upgrade.
Gateway firmware upgrade window
  • A message about the time needed to upgrade appears. Click on OK.
  • A progress bar appears indicating the status of the upgrade. When the upgrade is completed, your device reboots.
  • After the firmware upgrade is completed, verify your configuration to ensure that it is same as what you expected.

Note: The new firmware is written into flash memory. It may take up to 10 minutes to upgrade the firmware. Do not interrupt the devices' power or press the reset button during this time.