在Armbian系统中驱动YUGA 4G模块的完整指南

背景介绍

在嵌入式Linux开发中，为设备添加4G网络支持是常见的需求。本文将详细介绍如何在基于RK3399的SW799设备上，使用Armbian系统驱动YUGA 4G模块的完整过程。我们将探讨两种不同的驱动方式：Gobinet驱动和WWAN驱动，并分析各自的优缺点及适用场景。

硬件准备

首先需要确认硬件环境：

• 开发板：SW799（RK3399 SoC）
• 操作系统：Armbian 24.8.0（内核版本6.1.93-ophub）
• 4G模块：YUGA 4G模块（高通方案）

驱动方案一：Gobinet驱动

驱动编译

Gobinet驱动是高通提供的官方驱动，需要从源码编译。在编译过程中可能会遇到几个关键问题：

1. mstack-protector-guard-offset错误：这个错误是由于内核头文件中的安全保护机制导致的。解决方法是在内核头文件的Makefile中注释掉相关选项。

2. 头文件缺失问题：较旧的内核版本可能会缺少asm相关头文件。建议使用6.1.x或更新的内核版本。

3. 代码兼容性问题：需要修改驱动源码中的几处代码：

   • 修改原子读取操作以适应新版内核API
   • 替换已弃用的随机MAC地址生成函数
   • 处理网络设备结构体的变化

驱动加载与使用

成功编译后，加载驱动需要注意：

1. 先移除可能冲突的模块：rmmod qmi_wwan
2. 加载必要的基础模块：modprobe usbnet
3. 最后加载编译好的驱动：insmod GobiNet.ko

加载成功后，系统会出现usb0网络接口。通过AT指令设置拨号参数后，理论上可以获取IP地址。但在实际测试中发现，虽然能获取IP，但连接会在60秒后断开，dmesg显示"Device unresponsive to QMI"错误。

驱动方案二：WWAN驱动

当Gobinet驱动无法稳定工作时，可以尝试使用Linux内核自带的WWAN驱动框架。

准备工作

安装必要的工具包：

sudo apt install libqmi-utils udhcpc

配置步骤

1. 设置网络接口：

sudo ip link set wwan0 down
echo 'Y' | sudo tee /sys/class/net/wwan0/qmi/raw_ip
sudo ip link set wwan0 up

2. 设置模块工作模式：

sudo qmicli -d /dev/cdc-wdm0 --dms-set-operating-mode='online'

3. 配置数据格式：

sudo qmicli -d /dev/cdc-wdm0 --wda-get-data-format

4. 启动网络连接：

sudo qmicli -p -d /dev/cdc-wdm0 --device-open-net='net-raw-ip|net-no-qos-header' --wds-start-network="apn='your_apn',ip-type=4" --client-no-release-cid

5. 获取IP地址：

sudo udhcpc -q -f -i wwan0

网络测试与问题排查

成功连接后，可能会遇到DNS解析问题。可以通过以下方法验证：

1. 直接ping IP地址（如百度的110.242.68.66）测试基础连接
2. 检查DNS配置是否正确
3. 确认路由表是否正常

如果直接ping IP地址成功但域名解析失败，说明网络连接正常但DNS配置有问题，需要检查/etc/resolv.conf文件或网络管理器的DNS设置。

方案对比与选择建议

1. Gobinet驱动：

   • 优点：官方驱动，功能完整
   • 缺点：兼容性问题多，在新内核上不稳定
   • 适用场景：对功能有特殊需求，且能解决兼容性问题的情况

2. WWAN驱动：

   • 优点：内核原生支持，稳定性好
   • 缺点：配置稍复杂
   • 适用场景：大多数常规使用场景，特别是生产环境

总结

在Armbian系统上驱动YUGA 4G模块，推荐优先尝试WWAN驱动方案。它不仅稳定性更好，而且免去了编译自定义驱动的麻烦。对于特殊需求必须使用Gobinet驱动的情况，需要注意内核版本兼容性和代码适配问题。无论选择哪种方案，都要仔细检查网络配置，特别是DNS和路由设置，这是确保4G网络正常工作的关键。