上位机内存不足时，模组日志如何存储

一、应用场景与核心问题

在 “上位机 + 嵌入式模组” 的架构中（常见于路由器、工业网关、车载设备等），嵌入式模组（如4G/5G/Cat.1通信模组）通过USB或PCIe接口与上位机（一个运行Linux的嵌入式主机）直接连接。模组的调试端口（如Diag口、Log口）并未物理引出，使得日志抓取变得困难。

核心挑战：

日志抓取依赖工具：必须通过在上位机上运行专用的日志抓取工具来访问模组的虚拟端口。

上位机存储资源极端受限：上位机内存和Flash存储通常很小（几十到百兆字节），而模组在长时间挂测（耐久性测试）中产生的AP日志（应用日志）和CP日志（基带信令日志）数据量巨大，极易写满存储空间，导致系统崩溃、业务中断。

二、系统架构与工作流程

本方案通过在第三方PC上建立TFTP服务器，将上位机上的日志抓取工具作为TFTP客户端，实现日志的实时远程存储。

系统组件：

上位机：

角色：日志抓取端、TFTP客户端。

关键组件：

模组驱动：负责识别并创建设备节点（如 /dev/ttyUSB2、/dev/ttyUSB3）。

日志抓取工具：一个预先编译好的二进制程序，部署在指定路径（如 /tmp/debug/modem_log_capture）。

TFTP客户端：集成在日志抓取工具中，或使用BusyBox自带的 tftp 命令。

网络连接：

方式：以太网线直连。

配置：为上位机和第三方PC配置同一网段的静态IP地址，例如：

上位机：192.168.1.10

第三方PC：192.168.1.100

第三方PC：

角色：日志存储与分析端、TFTP服务器。

关键组件：

TFTP服务器软件：如Tftpd64、atftpd或tftpd-hpa。

大容量存储：用于存储长时间测试产生的所有日志文件。

三、关键技术实现细节

1. 日志抓取工具的增强设计

该工具不应只是一个简单的 cat 命令封装，而应具备以下功能：

端口自动发现：工具应能自动扫描 /dev/ 目录，根据设备属性（如通过 ioctl 查询厂商ID、产品ID）或命名规则（如 ttyUSB*）找到正确的Diag和Log端口。

多路日志捕获：可以同时捕获多个端口（如AP Log和CP Log），并写入不同的远程文件。

日志轮转与切片：与TFTP服务器配合，可以按时间（如每小时）或按大小（如每100MB）切分日志文件，避免单个文件过大。

断线重连与缓存：当网络抖动导致TFTP传输中断时，工具应能缓存少量日志并在TFTP服务器恢复后继续传输，同时保证模组端口不因缓冲区满而丢失数据。

信号处理：优雅地响应 SIGTERM 等信号，在工具退出前刷新缓冲区并关闭文件。

2. 资源保护机制

内存保护：工具本身应使用最小的内存缓冲区。推荐使用管道或线程，一个线程负责从串口高速读取数据，另一个线程立即通过TFTP发送，避免数据在内存中堆积。

存储保护：确保 /tmp 或其它上位机本地路径不会被日志缓存写满。可以设置一个严格的本地缓存大小上限（如5MB），达到上限后丢弃最旧的数据（虽然会丢失日志，但能保证系统不死机）。

3. 部署与执行命令示例

在第三方PC上：

# 安装并启动TFTP服务器（以tftpd-hpa为例）
sudo apt-get install tftpd-hpa
sudo systemctl start tftpd-hpa
# 默认服务器目录通常为 /srv/tftp/

在上位机上：

# 1. 部署工具
cp modem_log_capture /tmp/debug/
chmod +x /tmp/debug/modem_log_capture

# 2. 配置网络（假设eth1为连接第三方PC的网卡）
ifconfig eth1 192.168.1.10 netmask 255.255.255.0 up

# 3. 启动工具（示例命令）
/tmp/debug/modem_log_capture 
    --diag-port /dev/ttyUSB2 
    --ap-log-port /dev/ttyUSB3 
    --tftp-server 192.168.1.100 
    --ap-log-file /srv/tftp/ap_log_$(date +%Y%m%d_%H%M%S).log 
    --cp-log-file /srv/tftp/cp_log_$(date +%Y%m%d_%H%M%S).log 
    --buffer-size 1M