Search

How to Enable Cellular Connectivity on WisGate Edge and WisGate Soho Gateways Using ChirpStack Gateway OS for Mesh

 

This guide shows the steps to enable and use the Cellular connection on WisGate Edge and WisGate Soho gateways running the ChirpStack Gateway OS for Mesh.

For How to Set Up Gateway Mesh, check the guide - How to Set Up Gateway Mesh - Quick Start Using ChirpStackOS on RAK Gateways

Before starting, ensure that:

  • A valid SIM card is inserted.
  • The SIM card has an active data plan.
  • You know the APN settings provided by your mobile network operator.
  • You have administrative access to the gateway web UI.

Step 1: Open the Network Interfaces Page

  1. Log in to the gateway web interface.
  2. Navigate to:

Network → Interfaces

Step 2: Create a New Cellular Interface

  1. Click Add New Interface.

       2. Configure the following:

Setting Value
Name Cellular (or any preferred name)
Protocol QMI Cellular
  1. Click Create Interface.

Step 3: Configure Cellular Settings

On the General Settings tab, configure the cellular modem.

Required Settings

Setting Value
Modem Device /dev/cdc-wdm0
APN Your carrier APN

Optional Settings

Configure the following only if required by your mobile operator:

Setting Description
PIN SIM PIN code
IPv6 APN IPv6 APN value
Authentication Type Operator-specific authentication
PDP Type IPv4 / IPv6 configuration

 

Step 4: Assign the Interface to the WAN Firewall Zone

  1. Open the Firewall Settings tab.
  2. Under Create / Assign Firewall Zone, select:

WAN

This allows the cellular interface to be used as an Internet uplink.

Step 5: Save the Configuration

  1. Click Save.
  2. Click Save & Apply.

Step 6: Verify the Cellular Connection

The connection process may take several minutes.

Note: You may need to refresh the page after the modem connects.

Once connected, the new cellular interface will appear in the Interfaces list and display:

  • Interface status
  • Assigned IP address
  • Uptime
  • Traffic statistics

Troubleshooting

Cellular Interface Does Not Connect

Verify the following:

  • The SIM card is properly inserted.
  • The SIM card has an active data subscription.
  • The APN is correct.
  • The modem is detected by the system.
  • Cellular antennas are properly connected.

Modem Device Not Available

If /dev/cdc-wdm0 is not present:

  1. Verify the modem is correctly installed.
  2. Confirm the modem is supported by the gateway image.
  3. Reboot the gateway.
  4. Check the system logs for modem-related errors.

 

Updated