Skip to main content

Quick Install - Linux / OpenWrt

Navigation bar

EG25-G Installation​

Quickly get started with the EG25-G LTE Cat 4 Dongle on Linux / OpenWrt

Prerequisites​

  1. A Linux device (this article uses an OpenWrt / ImmortalWrt router as an example)
  2. Dongle EG25-G and a USB data cable
  3. A Nano-SIM card with Internet service
  4. The router's WAN port has working Internet access (for downloading drivers)
Tip

If the router is not yet online, you can download the corresponding IPK/APK packages on a computer with Internet access and install them from a USB flash drive. Router architectures differ, so look up the matching version in the OpenWrt package repository.


Connecting the Device​

Installing the Nano-SIM Card​

Image

  1. If the device has a USB protective cover, remove it first (skip this step for bare-board devices without an enclosure)
  2. Push the Nano-SIM card into the slot in the direction indicated on the slot

Connecting to the Router USB Port​

Plug the Dongle into the router's USB-A port.

Note: Some routers cannot supply enough power over USB. A USB hub with an independent power supply is recommended to prevent the module from rebooting repeatedly.


Configuring the Dongle - Router Side​

Connecting to the Router​

ssh root@192.168.1.1

The management address depends on the actual router.

Checking the USB Device​

First confirm that the system has detected the module:

root@OpenWrt:~# lsusb

You should see the Quectel device (the EG25-G and EC25 share the same USB PID, so appearing as EC25 LTE modem is normal):

Bus 001 Device 002: ID 2c7c:0125 Quectel Wireless Solutions Co., Ltd. EC25 LTE modem

If lsusb: not found is reported, install usbutils first:

# OpenWrt 24.10 and earlier
opkg update
opkg install usbutils

# Versions using apk, such as ImmortalWrt 25.12
apk update
apk add usbutils

Installing Drivers and Tools​

Installing the USB serial driver (for AT commands):

# opkg
opkg update
opkg install kmod-usb-serial-option

# apk
apk update
apk add kmod-usb-serial-option

Installing the ECM network adapter driver (for usb0 connectivity):

# opkg
opkg install kmod-usb-net-cdc-ether

# apk
apk add kmod-usb-net-cdc-ether

Installing the serial terminal tool:

# opkg
opkg install minicom

# apk
apk add minicom

Checking the Serial Ports​

root@OpenWrt:~# ls /dev/ttyUSB*

Expected output:

/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3

The AT command port of the EG25-G is /dev/ttyUSB2; the baud rate measured on this device is 9600.

If /dev/ttyUSB* does not exist, confirm that kmod-usb-serial-option is installed and replug the Dongle.


Optional: Factory Reset​

Note

A reset clears the historical configuration in the module (APN, USB mode, band lock, etc.). It is recommended for new devices or when the configuration is in disarray; if the module is currently working properly, you can skip this section and go directly to Setting the USB Operating Mode.

1. Enter the AT Terminal​

minicom -D /dev/ttyUSB2 -b 9600

Send AT; a reply of OK means communication is working:

AT
OK

2. Restore Factory Settings and Reboot​

AT&F
OK

AT+QPRTPARA=3
OK

AT+CFUN=1,1

AT+CFUN=1,1 reboots the module; USB re-enumerates and the serial ports disappear briefly for 30~60 seconds.

3. Exit minicom​

Press Ctrl + A, then X, and select Yes.

Tip

After the reset, usbnet returns to the module default; follow the next section to set ECM mode again.


Setting the USB Operating Mode​

Open the AT terminal again:

minicom -D /dev/ttyUSB2 -b 9600

Checking the Current Mode​

AT+QCFG="usbnet"
+QCFG: "usbnet",3
OK

Mode Description​

ParameterModeDescription
0QMI / RMNETRequires kmod-usb-net-qmi-wwan + uqmi
1ECMNatively supported by Linux/OpenWrt; recommended
2MBIMRequires kmod-usb-net-cdc-mbim + umbim
3RNDISRequires kmod-usb-net-rndis

If the queried value is 3 (RNDIS) and the RNDIS driver is not installed, you will see the module detected but no network adapter.

Switching to ECM Mode​

AT+QCFG="usbnet",1
OK

AT+CFUN=1,1

Wait for the module to reboot (about 30~60 seconds), then exit minicom.

Confirming the Network Adapter​

root@OpenWrt:~# ip addr show usb0

Expected output (the IP is assigned automatically by the module):

10: usb0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 state UP qlen 1000
link/ether d2:50:92:ae:52:68 brd ff:ff:ff:ff:ff:ff
inet 192.168.225.49/24 brd 192.168.225.255 scope global usb0

Configuring Internet Access​

Option 1: Command Line (UCI)​

Change the WAN port device to usb0 (the interface names depend on your setup; this article uses wan / wan6):

uci set network.wan.device='usb0'
uci set network.wan6.device='usb0'

uci commit network
service network reload

In a multi-WAN environment (for example, wan1 as the primary link and wan2 as the cellular backup), it is recommended to set a higher metric on the cellular interface to enable failover:

uci set network.wan2.device='usb0'
uci set network.wan26.device='usb0'
uci set network.wan2.metric='20'
uci set network.wan26.metric='20'

uci commit network
service network reload

The smaller the metric value, the higher the priority. Keep wan1 at the default 0 and set cellular to 20, so the wired link is preferred and cellular is the backup; unplugging the network cable switches over automatically.

Option 2: Web Interface​

  1. Open Network → Interfaces → wan → Edit
  2. Select usb0 as the Device
  3. Click Save → Save & Apply
  4. For IPv6, apply the same settings to wan6

Verification​

Checking the Interface Status​

root@OpenWrt:~# ifstatus wan

Confirm "up": true and that a 192.168.225.x address has been obtained.

Checking the Routes​

root@OpenWrt:~# ip route
default via 10.0.0.1 dev eth1 src 10.0.0.43
default via 192.168.225.1 dev usb0 src 192.168.225.49 metric 20

Testing on a Specific Adapter (verify cellular without unplugging the cable)​

root@OpenWrt:~# ping -I usb0 -c 3 223.5.5.5
64 bytes from 223.5.5.5: seq=0 ttl=50 time=45.6 ms
64 bytes from 223.5.5.5: seq=1 ttl=50 time=46.1 ms
64 bytes from 223.5.5.5: seq=2 ttl=50 time=45.8 ms

IPv6 Test​

In a multi-WAN environment the IPv6 default route carries a source address prefix, so the source address must be specified for testing:

root@OpenWrt:~# ip -6 addr show usb0
root@OpenWrt:~# ping -6 -I <IPv6 address of usb0> -c 3 2400:3200::1

FAQ​

SymptomCauseSolution
lsusb shows no Quectel deviceUSB not enumerated / insufficient powerUse another USB port or a powered hub
lsusb shows it, but no /dev/ttyUSB*Serial driver not installedInstall kmod-usb-serial-option
No usb0usbnet=3 but no RNDIS driver installedSwitch to ECM (usbnet=1) or install the corresponding driver
usb0 has no IPDHCP client not runningConfirm the interface proto is dhcp and reload the network
No AT responseWrong serial port or baud rateConfirm /dev/ttyUSB2 and baud rate 9600
No Internet access after resetThe reset restored the default usbnetRe-run AT+QCFG="usbnet",1 + AT+CFUN=1,1
Network adapter present but no Internet accessSIM not registered / no data balanceCheck the SIM and signal with AT+CPIN?, AT+CSQ

For more AT commands, refer to Device Debugging.

AI Translation Notice

This page was translated into English by AI and is provided for reference only. The original document is written in Chinese. If there is any discrepancy, the Chinese version prevails.

本页英文内容由 AI 自动翻译生成,仅供参考;原文为中文,如有差异请以中文原文为准。

查看中文原文 / View the Chinese original →