To configure your WWAN connection, go to the Network > WWAN page.

Insert and unlock your SIM card

No SIM inserted

If no SIM card is inserted, you will get the following page, showing the modem IMEI and asking for SIM insertion.

To list the available modem, run:

$ mmcli -L
BASH

Example

$ mmcli -L
/org/freedesktop/ModemManager1/Modem/4 [Fibocom Wireless Inc.] MC610-EU
BASH

To see the modem details, run:

mmcli -m <index>
CODE

Where index correspond to the modem index from the above list output.

Example

$ mmcli -m 4
  -----------------------------
  General  |              path: /org/freedesktop/ModemManager1/Modem/4
           |         device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  -----------------------------
  Hardware |      manufacturer: Fibocom Wireless Inc.
           |             model: MC610-EU
           | firmware revision: 16000.1000.00.98.91.04
           |         supported: gsm-umts
           |           current: gsm-umts
           |      equipment id: 864054060001387
  -----------------------------
  System   |            device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           drivers: option, cdc_ether
           |            plugin: fibocom
           |      primary port: ttyUSB0
           |             ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                    ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  -----------------------------
  Status   |             state: failed
           |     failed reason: sim-missing
           |       power state: on
  -----------------------------
  Modes    |         supported: allowed: cs; preferred: none
           |                    allowed: 4g; preferred: none
           |                    allowed: cs, 4g; preferred: cs
           |                    allowed: cs, 4g; preferred: 4g
           |                    allowed: any; preferred: cs
           |                    allowed: any; preferred: 4g
           |           current: allowed: any; preferred: 4g
  -----------------------------
  IP       |         supported: ipv4, ipv6, ipv4v6, non-ip
  -----------------------------
  3GPP     |              imei: 864054060001387
BASH

Here, the state failed with the failed reason sim-missing indicated the SIM is not detected.

SIM inserted

If the SIM is inserted, you will get some extra info about the SIM.

As you insert the SIM, the modem instance is reinitialized and gets a new index. List the modems again to find out the new modem index.

Example : modem with SIM inserted and locked

$ mmcli -m 5
  -----------------------------
  General  |              path: /org/freedesktop/ModemManager1/Modem/5
           |         device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  -----------------------------
  Hardware |      manufacturer: Fibocom Wireless Inc.
           |             model: MC610-EU
           | firmware revision: 16000.1000.00.98.91.04
           |         supported: gsm-umts
           |           current: gsm-umts
           |      equipment id: 864054060001387
  -----------------------------
  System   |            device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           drivers: option, cdc_ether
           |            plugin: fibocom
           |      primary port: ttyUSB0
           |             ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                    ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  -----------------------------
  Status   |              lock: sim-pin
           |    unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
           |             state: locked
           |       power state: on
  -----------------------------
  Modes    |         supported: allowed: cs; preferred: none
           |                    allowed: 4g; preferred: none
           |                    allowed: cs, 4g; preferred: cs
           |                    allowed: cs, 4g; preferred: 4g
           |                    allowed: any; preferred: cs
           |                    allowed: any; preferred: 4g
           |           current: allowed: any; preferred: 4g
  -----------------------------
  IP       |         supported: ipv4, ipv6, ipv4v6, non-ip
  -----------------------------
  3GPP     |              imei: 864054060001387
           |     enabled locks: sim
  -----------------------------
  SIM      |  primary sim path: /org/freedesktop/ModemManager1/SIM/3
BASH

SIM locked

If the SIM has a PIN defined, you will need to send the PIN code to the SIM.

To unlock the SIM (and therefore the modem), click the "key" (1) button.

Enter the SIM PIM and press unlock.


The PIN code is automatically stored into the WWAN profile on the gateway and will be used at system start to unlock the SIM.

Check the modem state to find the SIM index:

$ mmcli -L   
    /org/freedesktop/ModemManager1/Modem/13 [Fibocom Wireless Inc.] MC610-EU
$ mmcli -m 13
  -----------------------------
  General  |              path: /org/freedesktop/ModemManager1/Modem/13
           |         device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  -----------------------------
  Hardware |      manufacturer: Fibocom Wireless Inc.
           |             model: MC610-EU
           | firmware revision: 16000.1000.00.98.91.04
           |         supported: gsm-umts
           |           current: gsm-umts
           |      equipment id: 864054060001387
  -----------------------------
  System   |            device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           drivers: option, cdc_ether
           |            plugin: fibocom
           |      primary port: ttyUSB0
           |             ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                    ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  -----------------------------
  Status   |              lock: sim-pin
           |    unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
           |             state: locked
           |       power state: on
  -----------------------------
  Modes    |         supported: allowed: cs; preferred: none
           |                    allowed: 4g; preferred: none
           |                    allowed: cs, 4g; preferred: cs
           |                    allowed: cs, 4g; preferred: 4g
           |                    allowed: any; preferred: cs
           |                    allowed: any; preferred: 4g
           |           current: allowed: any; preferred: 4g
  -----------------------------
  IP       |         supported: ipv4, ipv6, ipv4v6, non-ip
  -----------------------------
  3GPP     |              imei: 864054060001387
           |     enabled locks: sim
  -----------------------------
  SIM      |  primary sim path: /org/freedesktop/ModemManager1/SIM/7
BASH

Here, the state locked indicates the SIM is locked.

To unlock the SIM, send the PIN with:

$ mmcli -i <SIM index> --pin=<PIN>
BASH

Example

$ mmcli -i 7 --pin=1234
successfully sent PIN code to the SIM
BASH

The modem is now no longer in the locked state:

$ mmcli -m 13
  -----------------------------
  General  |              path: /org/freedesktop/ModemManager1/Modem/13
           |         device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  -----------------------------
  Hardware |      manufacturer: Fibocom Wireless Inc.
           |             model: MC610-EU
           | firmware revision: 16000.1000.00.98.91.04
           |         supported: gsm-umts
           |           current: gsm-umts
           |      equipment id: 864054060001387
  -----------------------------
  System   |            device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |           drivers: option, cdc_ether
           |            plugin: fibocom
           |      primary port: ttyUSB0
           |             ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                    ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  -----------------------------
  Status   |    unlock retries: sim-pin (2), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
           |             state: enabling
           |       power state: on
  -----------------------------
  Modes    |         supported: allowed: cs; preferred: none
           |                    allowed: 4g; preferred: none
           |                    allowed: cs, 4g; preferred: cs
           |                    allowed: cs, 4g; preferred: 4g
           |                    allowed: any; preferred: cs
           |                    allowed: any; preferred: 4g
           |           current: allowed: any; preferred: 4g
  -----------------------------
  IP       |         supported: ipv4, ipv6, ipv4v6, non-ip
  -----------------------------
  3GPP     |              imei: 864054060001387
  -----------------------------
  SIM      |  primary sim path: /org/freedesktop/ModemManager1/SIM/7
BASH

Register to the operator's cellular network

Connect the default cellular network

By default, the modem will register to the operator's network. If it's not available, it may register to a partnering network (roaming).

When in the "Registered" state (1), the modem is connected to a network cell of the operator. At this stage, it should however not yet be connected to the IP network, and thus not have any connection in the system.

You can check the signal quality details by pressing the (2) button. This will show you a history graph of the signal power and quality.

This allows you to move the gateway to find the best connectivity.

Example of a modem registered to the home network of the SIM

$ mmcli -m 18
  --------------------------------
  General  |                 path: /org/freedesktop/ModemManager1/Modem/18
           |            device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  --------------------------------
  Hardware |         manufacturer: Fibocom Wireless Inc.
           |                model: MC610-EU
           |    firmware revision: 16000.1000.00.98.91.04
           |            supported: gsm-umts
           |              current: gsm-umts
           |         equipment id: 864054060001387
  --------------------------------
  System   |               device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |              physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |              drivers: option, cdc_ether
           |               plugin: fibocom
           |         primary port: ttyUSB0
           |                ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                       ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  --------------------------------
  Status   |       unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
           |                state: registered
           |          power state: on
           |          access tech: lte
           |       signal quality: 64% (recent)
  --------------------------------
  Modes    |            supported: allowed: cs; preferred: none
           |                       allowed: 4g; preferred: none
           |                       allowed: cs, 4g; preferred: cs
           |                       allowed: cs, 4g; preferred: 4g
           |                       allowed: any; preferred: cs
           |                       allowed: any; preferred: 4g
           |              current: allowed: any; preferred: 4g
  --------------------------------
  IP       |            supported: ipv4, ipv6, ipv4v6, non-ip
  --------------------------------
  3GPP     |                 imei: 864054060001387
           |        enabled locks: sim
           |          operator id: 22802
           |        operator name: Sunrise
           |         registration: home
           | packet service state: attached
  --------------------------------
  3GPP EPS | ue mode of operation: csps-2
  --------------------------------
  SIM      |     primary sim path: /org/freedesktop/ModemManager1/SIM/10
  --------------------------------
  Bearer   |                paths: /org/freedesktop/ModemManager1/Bearer/4
BASH

Connect to a specific cellular network

To change the configuration, press on the (1) button in the configuration section.

In the Network Configuration, you can choose between Automatic and Manuel network selection (1).

You can disable Roaming to avoid connection to anything else than the home network of the SIM.

In Manual mode, you can either specify directly the Operator code (MNC/MCC code) to use (1) or scan the available networks (2).


Connect to the IP network

Connect to the default IP network

Once connected to the cellular network, the modem will connect to the IP network, using the APN configuration.

By default, the modem is configure with automatic APN settings, this means it will determine automatically which APN to use depending on your operator.

When you are successfully connected to the APN, the modem state is "Connected".

Example when the modem is connected to the APN

$ mmcli -m 0                          
  --------------------------------
  General  |                 path: /org/freedesktop/ModemManager1/Modem/0
           |            device id: 561bcdbb91985dfbee99b15cc73d1a53b206b7c9
  --------------------------------
  Hardware |         manufacturer: Fibocom Wireless Inc.
           |                model: MC610-EU
           |    firmware revision: 16000.1000.00.98.91.04
           |            supported: gsm-umts
           |              current: gsm-umts
           |         equipment id: 864054060001387
  --------------------------------
  System   |               device: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |              physdev: /sys/devices/platform/ahb/600000.ehci/usb1/1-2
           |              drivers: option, cdc_ether
           |               plugin: fibocom
           |         primary port: ttyUSB0
           |                ports: ttyUSB0 (at), ttyUSB1 (ignored), ttyUSB2 (ignored), 
           |                       ttyUSB3 (ignored), ttyUSB4 (at), ttyUSB5 (at), wwan0 (net)
  --------------------------------
  Status   |       unlock retries: sim-pin (3), sim-puk (10), sim-pin2 (3), sim-puk2 (10)
           |                state: connected
           |          power state: on
           |          access tech: lte
           |       signal quality: 87% (recent)
  --------------------------------
  Modes    |            supported: allowed: cs; preferred: none
           |                       allowed: 4g; preferred: none
           |                       allowed: cs, 4g; preferred: cs
           |                       allowed: cs, 4g; preferred: 4g
           |                       allowed: any; preferred: cs
           |                       allowed: any; preferred: 4g
           |              current: allowed: any; preferred: 4g
  --------------------------------
  IP       |            supported: ipv4, ipv6, ipv4v6, non-ip
  --------------------------------
  3GPP     |                 imei: 864054060001387
           |        enabled locks: sim
           |          operator id: 22802
           |        operator name: Sunrise
           |         registration: home
           | packet service state: attached
  --------------------------------
  3GPP EPS | ue mode of operation: csps-2
  --------------------------------
  SIM      |     primary sim path: /org/freedesktop/ModemManager1/SIM/0
  --------------------------------
  Bearer   |                paths: /org/freedesktop/ModemManager1/Bearer/0
BASH

If a DHCP is available in the network, the gateway will retrieve its network configuration from it.

Connect to a custom IP network (custom APN)

Custom APN can only be configured through CLI in this version.

You can set a custom APN with the following commands:

nmcli connection modify wwan gsm.auto-config "false"
nmcli connection modify wwan gsm.apn "<apn name>"
nmcli connection modify wwan gsm.username "<username>"
nmcli connection modify wwan gsm.password "<password>"
BASH

Example

$ nmcli connection modify wwan gsm.auto-config "false"
$ nmcli connection modify wwan gsm.apn "internet"
$ nmcli connection modify wwan gsm.username "wifx"
$ nmcli connection modify wwan gsm.password "4Bmb3S8B7mJU"
BASH

To use the default APN, revert the changes with:

nmcli connection modify wwan gsm.apn ""
nmcli connection modify wwan gsm.username ""
nmcli connection modify wwan gsm.password-flags "2"
nmcli connection modify wwan gsm.password-flags ""
nmcli connection modify wwan gsm.auto-config "true"
BASH