安装和使用4G拨号重连软件

文档说明

当前版本：A

修改记录

版本说明时间
A初始版本2025.03.27

1 概述

介绍在ED-IPC和ED-HMI系列等产品上安装和使用4G拨号重连软件。

1.1 背景

部分客户在使用ED-IPC和ED-HMI系列等产品的4G功能时，经常会遇到4G断开后无法自动拨号重连，导致4G信号不稳定。针对这一问题，我司开发了4G重连软件，帮助用户更好的实现4G自动连接。

我司的4G拨号重连软件包支持使用Quectel-CM或NetworkManager服务拨号，其主要功能如下：

  • 支持4G自动连接
  • 支持控制4G指示灯
  • 支持自定义4G网络名称
  • 支持配置APN
  • 支持配置网络优先级
  • 支持自定义ping网络连接状态检测条件

提示

  • 4G拨号重连软件包默认使用Quectel-CM拨号和关闭DEBUG模式。
  • 4G拨号重连软件将会持续开发和更新。

1.2 适用范围

本应用适用于所有的带4G功能的ED-IPC和ED-HMI系列产品，包含的具体产品型号如下：

类型产品型号
ED-IPCED-IPC2000
ED-IPC2100
ED-IPC2200
ED-IPC2400
ED-IPC2600
ED-CM4SEN
ED-CM4IND
ED-HMIED-HMI2020-070C
ED-HMI2020-101C
ED-HMI2120-070C
ED-HMI2120-101C
ED-HMI2220-070C
ED-HMI2220-101C
ED-HMI2630-101C

2 应用指导

下文仅以ED-IPC2100设备为例，介绍安装和使用4G拨号重连软件的具体操作。

2.1 安装4G拨号重连软件

提示

如果已经安装了我司老版本的4G拨号重连软件，无需单独卸载，直接安装新版本的软件即可。

前提条件：

  • ED-IPC2100设备已正确安装4G模块、已正确安装4G天线、已插入可正常使用的SIM卡。
  • 已准备1个12V 2A的适配器（3.5mm凤凰端子接口）和1条网线。

操作步骤：

  1. ED-IPC2100设备已正常启动和接入网络。

  2. 在命令窗格依次执行如下命令，添加edatec apt源。

curl -sS https://apt.edatec.cn/pubkey.gpg | sudo apt-key add -
echo "deb https://apt.edatec.cn/raspbian stable main" | sudo tee /etc/apt/sources.list.d/edatec.list
sudo apt update

注意

如果直接复制命令，粘贴时若出现换行，请删除换行符并在该位置补充空格。

092327
  1. 执行如下命令安装4G拨号重连软件包。
sudo apt install -y  ed-ec20-qmi  ed-lte-tools
image-20250307144345060

  1. 执行如下命令检查4G拨号重连软件包是否安装成功，出现图中红框所示即为安装成功。

    07 144741

2.2 使用4G拨号重连软件连接网络

介绍如何在设备上使用4G拨号重连软件。

2.2.1 无需配置APN场景

完成安装4G拨号重连软件包后，如果不需要APN配置的SIM卡会自动连接到4G网络，可以通过观察4G指示灯的状态来确定是否已接入网络。

  • 4G指示灯点亮表示已经连接到4G网络。
  • 4G指示灯熄灭表示未连接到网络。

同时支持通过ifconfig命令查看4G网络是否连接，如下图wwan分配到IP地址表示4G网络已连接。

44450243

2.2.2 需配置APN场景

完成安装4G拨号重连软件包后，如果需要配置APN，则需要先进入4G拨号重连软件配置文件，再配置APN和重启设备。

  1. 执行如下命令进入4G拨号重连软件包的配置文件。
sudo nano  /usr/share/ed-lte-tools/ed_config.ini
  1. 如下图在apn= 后输入自定义的APN号，再保存文件。
image-20250314112933089
  1. 执行如下命令重启设备。
sudo reboot

提示

  • 如果设备带有4G指示灯，使用4G拨号重连软件成功连接到4G网络后，可通过4G指示灯的状态来确定是否已接入网络。
    • 4G指示灯点亮表示已经连接到4G网络。
    • 4G指示灯熄灭表示未连接到网络。
  • 如果设备不带4G指示灯，使用4G拨号重连软件成功连接到4G网络后，则可通过执行ifconfig命令查看是4G网络是否被分配IP来判断是否成功连接到网络。
    • wwan分配到IP地址表示已经连接到4G网络。
    • wwan未分配到IP地址表示未连接到4G网络。

2.3 配置4G网络参数

通过4G拨号重连软件正常连接网络后，用户可按需配置DEBUG模式、NetworkManager拨号、白名单、4G网络名称、两次ping的间隔时间、4G网络优先级和ping网络连接状态检测条件等4G网络参数。

2.3.1 配置DEBUG模式/NetworkManager拨号/白名单/网络名称/两次ping的间隔时间

提示

如果非必要使用NetworkManager服务拨号，建议使用默认的Quectel-CM拨号，Quectel-CM拨号较稳定。

操作步骤：

  1. 执行如下命令进入4G拨号重连软件包的配置文件。
sudo nano  /usr/share/ed-lte-tools/ed_config.ini
  1. 参考下表按需修改对应的参数值。
配置项配置说明
DEBUG模式默认状态下DEBUG模式是关闭的，开启后查看日志可以打印更详细的AT指令检测等相关信息。如果需要开启DEBUG模式，则将“debug=”后的false修改为true。
image-20250314115026828
NetworkManager拨号如果需要使用NetworkManager服务拨号，则将“NetworkManager=”后的false修改true。
image-20250314113959367
白名单如果需要增加白名单，则在“whilelist= ”后面增加对应的IP地址，多个地址使用“;”隔开。
image-20250314113108873
网络名称如果需要配置网络名称，则在“connection= ”后输入自定义的网络名称。
image-20250314124253658
两次ping的间隔时间如果需要配置两次ping的间隔时间，则在"intervaltime= "后输入自定义的值。
image-20250314130639767

  1. 配置完成后，输入ctrl+o 保存配置文件，再按Enter，最后输入ctrl+x 退出配置文件。

  2. 执行如下命令重启设备，使配置生效。

sudo reboot

注意

如果未成功连接到4G或者相应配置未生效，可执行journalctl -u ed-lte-tools.service命令查看相关日志信息。

2.3.2 配置网络优先级

在一个设备中可能存在多个网络，例如4G网络、有线网络（eth0或eth1）、Wi-Fi网络，如果需要优先使用某一个网络，可调整某一个网络的优先级。

提示

配置设备网络优先级前，请将对应的网络接口均接入网络。

操作步骤：

  1. 执行如下命令查看设备当前的网络及优先级参数。
route
step1

如上图所示，设备接入的网络包含eth0、eth1、4G和Wi-Fi。

  • 4G网络 (wwan0)优先级参数“Metric”的值为700；
  • eth0网络优先级参数“Metric”的值为100；
  • eth1网络优先级参数“Metric”的值为101；
  • Wi-Fi网络 (wlan0)优先级参数“Metric”的值为600。 优先级参数值越小，优先级越高，所以设备当前优先使用的是eth0网络。
  1. 执行如下命令进入4G拨号重连软件包的配置文件。
sudo nano  /usr/share/ed-lte-tools/ed_config.ini
  1. 按需配置网络优先级参数“Metric”的值。

  • 配置优先使用4G网络

    a. 如果需要优先使用4G网络，修改4G_metric=后的值为小于100的数值，使4G网络的优先级高于eth0网络。

    step3a

    b. 配置完成后，输入ctrl+o 保存配置文件，再按Enter，最后输入ctrl+x 退出配置文件。

    注意

    如果未成功连接到4G或者相应配置未生效，可执行journalctl -u ed-lte-tools.service命令查看相关日志信息。

  • 配置优先使用以太网或WiFi网络

    a. 确定待修改的以太网或Wi-Fi网络名称。

    • net0为eth0的网络名称；
    • net1为eth1的网络名称；
    • net2为Wi-Fi的网络名称。

    b. 如果需要优先使用eth1网络，修改net1=eth1,后的值为小于100的数值，使eth1的网络的优先级高于eth0网络。

    注意

    如果需要配置优先使用Wi-Fi网络，则请修改net2=wlan0,后的值为小于100的数值。

    step3b

    c. 配置完成后，输入ctrl+o 保存配置文件，再按Enter，最后输入ctrl+x 退出配置文件。

    d. 退出配置文件后，依次执行以下命令运行ed-network-config.sh脚本。

    cd /usr/share/ed-lte-tools && ls
sudo ./ed-network-config.sh
    step3d
  1. 执行如下命令重启设备，使配置生效。
sudo reboot

2.3.3 配置ping网络连接状态检测条件

操作步骤：

  1. 执行如下命令进入custom-network-checking配置文件。
sudo nano  /usr/share/ed-lte-tools/custom-network-checking.sh
  1. 在下图红框位置，写入自定义的网络连接检测条件脚本，如下图红框所示。
ertyui1740
  • TFNAME为4G网络名称；
  • t_ip 参数为白名单IP ；
  • return返回0，表示成功；return返回1，表示失败。

  1. 配置完成后，输入ctrl+o 保存配置文件，再按Enter，最后输入ctrl+x 退出配置文件。

  2. 执行如下命令重启设备，使配置生效。

sudo reboot
  1. 执行以下命令查看日志信息，如下图所示，表示配置成功。
journalctl -u ed-lte-tools.service
444182107