Skip to main content

Connecting your gateway to ioX-Bridge

Registering a gateway in ioX-Pulse records it in your Inventory. It does not configure the physical hardware. To get uplinks flowing, you point the gateway's packet forwarder at ioX-Bridge, the network server behind ioX-Pulse.

This page covers that one-time hardware configuration.

note

Where to find it: the connection details appear right after you register a gateway, and again any time on the gateway's Overview tab under Connection instructions.

Hiding connection instructions from your customers​

If you manage gateway setup yourself and would rather your sub-account customers never see the network server details, you can hide the Connection instructions panel.

Open Administration -> White Label, and under Portal options on the Branding tab turn off Show connection instructions, then Save. The panel is then hidden on every gateway's Overview tab for everyone in your workspace. The one-time connection details still appear right after you register a gateway, since registration is done by your team, not your customers. Turn it back on at any time. It is on by default.

What you configure​

Every gateway ships with a configuration interface, a local web page, an installer app, or a vendor cloud portal. Whichever yours uses, you are looking for the LoRaWAN network server or packet forwarder settings. Enter the ioX-Bridge values there.

SettingValue
ProtocolSemtech UDP packet forwarder
Server addressioxbridgelns.ioxapp.net
Port (uplink and downlink)1700
Frequency planMust match the region you selected when registering

The exact server address and port are always shown in the app, so copy them from there rather than from this page in case they change for your deployment.

Step by step​

  1. Register the gateway in ioX-Pulse (Settings -> Gateways -> + Register Gateway). Pick the correct Frequency for your region.
  2. On the success screen, copy the UDP packet-forwarder endpoint.
  3. Open your gateway's configuration interface and find the packet forwarder or network server settings.
  4. Set the protocol to Semtech UDP packet forwarder (sometimes called "Semtech UDP GWMP" or "legacy packet forwarder").
  5. Enter the server address and set both the uplink and downlink port to 1700.
  6. Set the gateway's frequency plan / region to match the frequency you registered.
  7. Save and reboot the gateway.

Within a minute or two of the reboot, an assigned gateway starts reporting in and its health turns Online in ioX-Pulse.

Match the frequency plan​

caution

The region you pick in ioX-Pulse and the frequency plan on the gateway must be the same. If they differ, the gateway and ioX-Bridge speak on different channels and packets are silently dropped. There is no error message, the gateway simply never appears online. Double-check this first if a gateway will not connect.

Troubleshooting​

Gateway stays offline after configuration

  • Confirm the frequency plan on the gateway matches the region you registered.
  • Confirm the server address and port were entered exactly, with port 1700 for both uplink and downlink.
  • Confirm the gateway has internet access and its outbound UDP on port 1700 is not blocked by a firewall.
  • Reboot the gateway after saving, some models only apply network settings on restart.

Gateway is online but devices do not appear

  • Gateway connectivity and device joins are separate. A gateway only forwards traffic; the devices themselves still need to be registered and joined. See the Devices guide.

Basic Station and TLS​

Some gateways prefer the LoRa Basic Station protocol over a TLS connection instead of the UDP packet forwarder. Support for Basic Station, including the ioX-Bridge trust certificate, is coming soon. For now, use the UDP packet forwarder settings above, which every LoRaWAN gateway supports.