1 概述

本文介绍4G LTE连接管理工具的开发背景及其适用产品范围。

1.1 背景

为解决ED-IPC和ED-HMI系列产品在4G网络断开后无法自动重连、导致网络不稳定的问题，EDATEC基于Raspberry Pi OS开发了4G LTE连接管理工具-简称ed-clte，帮助简化并增强4G网络的管理能力。

ed-clte工具是一套完整的4G网络管理方案，包含四大核心组件：

组件	说明
ed-lte-tool	主命令行工具，提供模块信息查询、信号检测、复位、拨号及守护进程等功能
ed-net-monitor	独立的网络优先级监控进程，实时检测网络接口状态并动态调整路由优先级
ed-net-priority	辅助脚本，用于手动设置网络接口的路由metric值，支持等级（1~14）和绝对metric两种模式
ed-lte	底层QMI拨号封装脚本，调用quectel-CM执行实际的拨号与断线操作

ed-clte工具提供自动拨号与重连、两级心跳检测、多级容错恢复、备份模式切换、网络优先级管理、LED状态指示和SIM PIN 管理等核心功能。

• 自动拨号与重连: 守护进程持续监控模块状态，掉线后自动发起重连
• 两级心跳检测: 结合本地IP/进程检测与远端DNS Ping，实现快速且准确的故障判定
• 多级容错恢复: 按顺序执行CFUN软件恢复、硬件复位及定时硬件复位，逐步升级恢复手段
• 备份模式切换: 在ECM模式下可自动启用AT+QNETDEVCTL=3,1,1备用模式，以绕过quectel-CM
• 网络优先级管理: 支持按等级（1-14）配置接口优先级，并提供降级持久化及高优先级恢复后的自动回切功能
• LED状态指示: 支持单色/双色LED，直观显示模块的注册状态与信号强度
• SIM PIN管理: 支持自动解锁SIM卡PIN码，并内置最多3次尝试的防锁卡保护机制
• 在线检测: 支持对多个DNS服务器进行Ping检测，并可集成用户自定义的在线检测脚本
• 模块自动识别: 根据已安装的BSP包自动匹配复位GPIO、LED、串口等默认配置

ed-clte工具支持通过命令行直接操作，也允许用户修改配置文件来自定义 LED、模块复位、APN、网络检测条件及网络优先级等参数。

提示

• ed-clte工具默认使用Quectel QMI拨号。
• 所有出厂带4G功能的设备均已预装ed-clte工具。
• ed-clte工具将持续开发和更新。

1.2 适用范围

ed-clte工具适用于所有带4G功能的ED-IPC、ED-HMI和ED-SBC系列产品，具体型号如下：

类型	产品型号
ED-IPC系列	ED-IPC1100、ED-IPC1200、ED-IPC1220 ED-IPC2100、ED-IPC2200、ED-IPC2600 ED-IPC3100、ED-IPC3200、ED-IPC3600 ED-CM4SEN、ED-CM4IND、ED-CM4MEDIA
ED-HMI系列	ED-HMI2120-070C、ED-HMI2120-101C ED-HMI2220-070C、ED-HMI2220-101C ED-HMI2630-101C ED-HMI3120-070C、ED-HMI3120-101C、ED-HMI3120-116C、ED-HMI3120-133C、ED-HMI3120-156C、ED-HMI3120-185C、ED-HMI3120-215C ED-HMI3630-101C、ED-HMI3630-116C、ED-HMI3630-133C、ED-HMI3630-156C
ED-SBC系列	ED-SBC2300 ED-SBC3300