Skip to content

Network Testing

This chapter only describes how to perform network testing via the command line. In the graphical interface, open the system's built-in browser and visit any domestic website (the default search engine of the browser may be Google, replace it with Baidu or other domestic search engines). When conducting mobile network testing, please ensure that the development board you purchased has a 4G/5G network module interface and a SIM card slot.

Mobile Network (Rockchip Series)

When conducting mobile network testing, please ensure that the development board you purchased has a 4G/5G network module interface and a SIM card slot.

Tools Preparation

  • 4G/5G network module
  • SIM card (must be able to access the network normally, avoid insufficient credit)

Hardware Installation

This subsection uses K7 as an operation example, only showing the connection details of the 4G/5G network module and SIM card. Different motherboard models have different interface positions. Please refer to the specification sheet to find the corresponding interfaces.

1. Install the 4G/5G network module and SIM card.

Warning

The network module must be installed or removed when the device is powered off.

image-20260526145001152

image-20260526145105133

Script Configuration

The 4G/5G network module is automatically configured at boot. It detects whether the module exists and performs configuration and dialing.

Tip

By default, dialing is attempted only once at boot. In cases of poor signal or communication anomalies, dialing may fail. If there is no network, you can manually run the dialing script to retry.

$ cat /usr/bin/hardware-optimization 
4g_config() {
    wait_time=30
        for((i=1;i<=$wait_time;i++));
        do 
                if [ -c /dev/ttyUSB2 ]; then
                        echo "$i: 4g /dev/ttyUSB2 exists and is a character device." >> $LOG_FILE
                        /usr/bin/4G_dialing.sh
            break;
                else
                        echo "$i: 4g /dev/ttyUSB2 does not exist or is not a character device." >> $LOG_FILE
                        sleep 1
                fi
        done
}

Dialing script, adapted for RG200U / EC20 / EC200

$ ls /usr/bin/4G_dialing.sh

Network Testing

After installing the network module and SIM card, the device will automatically dial and connect to the network at boot.

1. Check whether the module is recognized by viewing the logs.

Tip

/dev/ttyUSB2 exists and is a character device. indicates that the device is recognized successfully.

$ cat /tmp/kickpi-hardware.log 
1: 4g /dev/ttyUSB2 does not exist or is not a character device.
2: 4g /dev/ttyUSB2 does not exist or is not a character device.
...
24: 4g /dev/ttyUSB2 does not exist or is not a character device.
25: 4g /dev/ttyUSB2 exists and is a character device.

Or check whether /dev/ttyUSB2 exists.

$ ls /dev/ttyUSB*
/dev/ttyUSB0  /dev/ttyUSB1  /dev/ttyUSB2  /dev/ttyUSB3  /dev/ttyUSB4

2. Check whether dialing is successful.

Tip

The device name format is enx* (where * is a variable suffix). Please refer to the actual environment for the specific name.

(console)$ ifconfig
enxca7f24fb0e94: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 10.138.192.102  netmask 255.255.255.0  broadcast 10.138.192.255
        inet6 fe80::583f:ed51:782d:318d  prefixlen 64  scopeid 0x20<link>
        ether ca:7f:24:fb:0e:94  txqueuelen 1000  (Ethernet)
        RX packets 181  bytes 15185 (14.8 KiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 194  bytes 17394 (16.9 KiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

3. Ping network test.

Tip

Specify the device enx3e003a5bd6ad to perform the ping network test.

(console)$ ping www.baidu.com -I enxca7f24fb0e94
PING www.wshifen.com (103.235.46.115) from 10.138.192.102 enxca7f24fb0e94: 56(84) bytes of data.
64 bytes from 103.235.46.115 (103.235.46.115): icmp_seq=1 ttl=45 time=1094 ms
64 bytes from 103.235.46.115 (103.235.46.115): icmp_seq=2 ttl=45 time=3924 ms
64 bytes from 103.235.46.115 (103.235.46.115): icmp_seq=3 ttl=45 time=1870 ms

Custom Dialing

The board uses the official Quectel-CM tool for dialing by default. If you need to modify or customize the dialing function, download the Quectel official Linux software for customization.

# Pull the code on the board
git clone https://github.com/quectel-open-source/Quectel_QConnectManager_Linux.git
make

Mobile Network (Allwinner Series)

When conducting mobile network testing, please ensure that the development board you purchased has a 4G network module interface and a SIM card slot.

Tools Preparation

  • 4G network module
  • SIM card (must be able to access the network normally, avoid insufficient credit)
  • System environment: Ubuntu

Hardware Installation

This subsection uses K2C as an operation example, only showing the connection details of the 4G network module and SIM card. Different motherboard models have different interface positions. Please refer to the specification sheet to find the corresponding interfaces.

1. Install the 4G network module and SIM card.

Warning

The network module must be installed or removed when the device is powered off.

image-20260527153916626

image-20260527154127731

2. Verify that the network module is loaded.

lsusb

3. Re-dial after inserting or removing the SIM card.

sudo pppd call quectel-ppp &

If dialing fails, check the process ID with ps -ef | grep pppd, terminate the process with kill -9 <process ID>, then re-dial.

4. External network ping test.

ping www.baidu.com

If DNS resolution fails, add the corresponding DNS.

vim /etc/resolv.conf
// Add the following content
nameserver 8.8.8.8
nameserver 8.8.4.4