Comment on page
Raspberry Pi
Adding cellular connectivity to your Raspberry Pi 3 or 4
Adding cellular connectivity to your Raspberry Pi can be done in a few simple steps.

- Monogoto SIM
- Raspberry Pi 3 or 4
- Mini PCIE cellular modem, for example:
- Sierra Wireless MC7700 (LTE)
- Telit ME910C1-WW mini PCle (LTE-M & NB-IoT)
- Quectel EC25 mini PCle (LTE)
Access the Raspberry Pi by connecting a screen and keyboard (recommended) or connect over SSH.
Open the terminal and validate if the NetworkManager and ModemManager are installed.
NetworkManager -V
ModemManager -V
Make sure that the Raspberry Pi runs NetworkManager version 1.3 or higher and ModemManager version 1.14 or higher. If this is not the case, update or install the NetworkManager and ModemManager using the command:
sudo apt install network-manager modemmanager
In addition, install the libqmi-utils and udhcpc packages.
sudo apt install libqmi-utils udhcpc
Add the mini PCle cellular modem to the USB adapter
Add the Monogoto SIM to the USB adapter
Connect the cellular PCle card to the Raspberry Pi, using the USB port

Open the CLI (Command Line Interface) and see of the USB with cellular modem gets detected:
lsusb
Example response:
Bus 001 Device 004: ID 1199:68a2 Sierra Wireless, Inc. MC7700
The cellular modem requires the driver
qmi_wwan
, to verify if the driver is compatible with the modem, enter lsusb -t
:lsusb -t
|__ Port 2: Dev 4, If 8, Class=Vendor Specific Class, Driver=qmi_wwan, 480M
Check what USB port the cellular modem is connected to.
dmesg | grep tty
Example response:
[ 6.728605] usb 1-1.2: Qualcomm USB modem converter now attached to ttyUSB0
[ 6.823516] usb 1-1.2: Qualcomm USB modem converter now attached to ttyUSB1
[ 6.868118] usb 1-1.2: Qualcomm USB modem converter now attached to ttyUSB2
Start and enable the NetworkManager, when doing so you will be asked to fill out your root password.
systemctl start NetworkManager
systemctl enable NetworkManager
After enabling the NetworkManager, the Wifi connection of your Raspberry Pi breaks.
To activate your Wifi again, enter:
nmcli device wifi connect "<SSID>" password "<PASSWORD>"
Expected response:
Device 'wlan0' successfully activated
Create a new connection with name
monogoto
and set the APN to data.mono
:nmcli c add type gsm ifname '*' con-name monogoto apn data.mono connection.autoconnect yes
Expected response:
Connection `monogoto` (...) successfully added.
To test if the connection was successfully added, a new file with the name
monogoto.nmconnection
is created and added to the directory system-connections
ls /etc/NetworkManager/system-connections
When opening this file (using
sudo vi
) it should show something like:[connection]
id=monogoto
uuid=XXXXX
type=gsm
permissions=
autoconnect=true
[gsm]
apn=data.mono
[ipv4]
dns-search=
method=auto
[ipv6]
addr-gen-mode=stable-privacy
dns-search=
method=auto
Manually start the connection using the command:
nmcli c up monogoto
Expected response:
Connection successfully activated (D-Bus active path: /org/freedesktop/NetworkManager/ActiveConnection/0)
The connection with name
monogoto
should be linked to the device called cdc-wdm0
. If the connection is active, everything is displayed in green.nmcli c
Expected response:
NAME UUID TYPE DEVICE
monogoto ..... gsm cdc-wdm0
wifi-name ..... wifi wlan0
Enter the following command to activate the
cdc-wdm0
device:sudo nmcli device connect cdc-wdm0
Expected response:
Device 'cdc-wdm0' successfully activat
List the connected modems:
mmcli -L
Expected response:
/org/freedesktop/ModemManager1/Modem/0 […]
Replace
0
with the value you found when running mmcli -L
mmcli -m 0
Example response:
...
--------------------------------
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: 86% (recent)
...
Check if the cellular interface is added, and if an IP address was derived. Look for the interface with name
wwan0
ifconfig
Expected response:
wwan0: flags=4305<UP,POINTOPOINT,RUNNING,NOARP,MULTICAST> mtu 1500
inet 10.XXX.XXX.XX netmask 255.255.255.252 destination 10.XXX.XXX.XX
unspec 00-00-00-00-00-00-00-00-00-00-00-00-00-00-00-00 txqueuelen 1000 (UNSPEC)
RX packets 7 bytes 1050 (1.0 KiB)
RX errors 0 dropped 0 overruns 0 frame 0
TX packets 52 bytes 8118 (7.9 KiB)
TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0
If no
wwan0
interface is visible, disconnect the USB with PCIe and reboot the Raspberry Pi. Connect the USB dongle again after the Raspberry Pi has fully booted.ip route
Expected response:
default via 10.xxx.xxx.xx dev wlan0 proto static metric 600
default via 10.xxx.xxx.xx dev wwan0 proto static metric 700
The lower the metric number, the higher the priority of the connection. In the above example, the
wlan0
(wifi) interface has a higher priority than the wwan0
(cellular) interface. Change priority of the connections (optional)
To change the priorities of the connections, the metric numbers needs to be adapted. To do so, go to the directory:
/etc/NetworkManager/system-connections
Open the file (using
sudo vi
) monogoto.nmconnection
Add the line
route-metric=200
under the section [ipv4]
. The file becomes:[connection]
id=monogoto
uuid=.........
type=gsm
permissions=
autoconnect=true
[gsm]
apn=data.mono
[ipv4]
dns-search=
method=auto
route-metric=200
[ipv6]
addr-gen-mode=stable-privacy
dns-search=
method=auto
Restart the NetworkManager
systemctl restart NetworkManager
Validate the connectivity priorities by entering:
ip route
Expected response:
default via 10.xxx.xxx.xx dev wwan0 proto static metric 200
default via 10.xxx.xxx.xx dev wlan0 proto static metric 600
Ping IP address
8.8.8.8
to validate the data connection:When multiple connections are up and running, specify the use of the
wwan0
interface through: ping -I wwan0 8.8.8.8
Optionally, you can disable other interfaces (for example the
wlan0
) using the command: ip link set dev wlan0 down
ping 8.8.8.8
Example response:
PING 8.8.8.8 (8.8.8.8): 56(84) bytes of data
64 bytes from 8.8.8.8: icmp_seq=1 ttl=112 time=72.3 ms
64 bytes from 8.8.8.8: icmp_seq=2 ttl=112 time=70.8 ms
64 bytes from 8.8.8.8: icmp_seq=3 ttl=112 time=82.9 ms
64 bytes from 8.8.8.8: icmp_seq=4 ttl=112 time=78.7 ms
If no
wwan0
interface is visible, or the pings result in errors, disconnect the USB with PCIe and reboot the Raspberry Pi. Connect the USB dongle again after the Raspberry Pi has fully booted.To find NetworkManager logs, enter:
systemctl status NetworkManager
Did you manage to connect your Raspberry Pi to Monogoto? Great work! Have a look at the Things logs in the Monogoto Hub to find more details about the established connection.
Last modified 1yr ago