简介：移远通信GobiNet驱动V1.6.2.9，面向Linux与Android平台，用于驱动移远Gobi系列无线网卡模块，使系统能够识别并建立3G/4G/LTE移动数据连接。该驱动源码支持在Linux环境下编译生成Gobinet.ko内核模块，并已在海思平台实测通过，适用于工业路由器、车载信息娱乐系统、物联网网关等嵌入式场景，也可作为驱动开发者在USB网络设备适配方面的参考实现。压缩包共9个文件、61KB，以3个C源码与3个头文件为主，配合makefile编译脚本和txt说明文档，结构精炼，便于快速定位驱动核心逻辑、编译选项与模块加载方式。目前已有892人学习/下载，适合需要集成移远Gobi模块或基于海思等平台进行移动网络功能开发的软硬件工程师。通过阅读源码与说明，可掌握QMI设备注册、USB网络适配、内核接口对接等关键实现，结合提供的makefile与文档可快速完成目标平台编译与加载验证，有效缩短驱动适配和调试周期。 拿到 Quectel_Linux&Android_GobiNet_Driver_V1.6.2.9.zip 这个压缩包，说明你多半正在搞移远的4G模组，而且大概率是 EC20、EC25 这类基于高通平台的设备。我第一次碰这个驱动是在一款电力终端上，模组是 EC20，内核是 3.18，当时为了把这颗模组在 Linux 下跑起来，连编译带调试折腾了快一周，最后发现很多坑其实都在驱动版本和内核 API 的匹配上。
GobiNet 驱动的核心任务很明确：把高通的 USB Modem 抽象成一个虚拟网卡，让上层 Linux/Android 网络协议栈把它当成普通 eth0/wwan0 来用。也就是说，你不需要在业务代码里去拼 PPP 报文，也不用自己处理 QMI 消息，驱动内部已经把数据面和控制面都包装好了。这篇博文我从解压源码开始，把编译、安装、拨号、Android 适配和排错流程完整过一遍，顺便把我在实际项目里踩过的坑一并交代清楚。适合做嵌入式 Linux 网关、车机、工业路由器和安卓终端集成的朋友参考。
1. GobiNet 驱动到底解决了什么问题
1.1 为什么高通模组不能只靠串口驱动跑业务
移远模组插上 USB 后，系统里默认会枚举出几个串口，常见的是 ttyUSB0 到 ttyUSB3，分别对应 DM、AT、Modem 和 NMEA 口。AT 指令交互走 ttyUSB1 没问题，但 IP 数据业务如果也走串口，带宽会被 USB 串口驱动的实现方式卡死，而且协议栈还要自己去封装 PPP 或 HDLC 帧，效率和稳定性都很难看。
GobiNet 的思路是把数据面从串口剥离开来：USB Bulk 端点直接被驱动捕获，然后注册成一个虚拟网络接口，IP 包从这个接口进，经过驱动封装成 USB 请求块发到模组，模组侧再通过 LTE 空口发出去。控制面则走 QMI 消息，比如拨号、查信号、设 APN，都是 QMI 指令完成。这样一来，上层根本不需要关心模组是 USB 还是 PCIe 接口，对它来说这就是一张普通的网卡。
1.2 GobiNet、qmi_wwan、ECM 三者的区别
很多新手会把这三个名词混在一起，实际上它们解决的是同一类问题，但技术路线不一样。
ECM 是 USB-IF 定义的 CDC Ethernet Control Model 标准，模组把自己模拟成一张 USB 网卡，驱动直接用内核自带的 cdc_ether 就能识别，Linux 和 Windows 都不用额外装驱动。问题在于它走的是 USB 标准以太网路径，报文头开销大，吞吐和延迟表现一般。
qmi_wwan 是内核主线里的驱动，也把模组抽象成网卡，但控制面使用 QMI 协议。它和移远这个 GobiNet 驱动功能重叠度很高，新内核基本首选 qmi_wwan，因为维护活跃，跟主线 API 同步。
GobiNet 是移远随模组发布的闭源驱动包里的源码版本，编译方式和 qmi_wwan 类似，但加载的模块名、设备节点、QMI 通道初始化细节有差异。在老内核上，移远官方会建议客户用 GobiNet，因为 qmi_wwan 在老内核上对某些 PID/VID 的支持不完整。
我个人的选择标准是这样：内核版本在 4.14 以下，优先用厂商的 GobiNet，省去自己移植 qmi_wwan 到老内核的功夫；内核在 4.19 以上，直接启用 qmi_wwan，配合 libqmi 使用更省事。
1.3 解压后的源码结构
解压这个 zip 后，目录里没有预编译的 .ko，全是源码和脚本，核心文件大概有这几个：
GobiNet.c // 网络设备驱动主逻辑 GobiUSBNet.c // USB 传输层处理 QMIDevice.c // QMI 设备管理 QMI.c // QMI 消息编解码 QMIThread.c // 控制面消息收发线程 QMIDevice.h // 头文件 MakefileGobiNet.c 负责注册 net_device_ops，也就是 open、stop、start_xmit 这些函数；GobiUSBNet.c 管 USB 的 URBs 提交和完成回调；QMI.cs 和 QMIThread.c 处理 AT 之外的控制指令。这个版本源码写的年代比较早，结构上不像主线内核驱动那样规整，但逻辑不复杂，改起来反而直白。
2. 编译前必须搞定的三件事
2.1 确定内核版本和交叉编译工具链
驱动能不能编过，第一关是内核版本。V1.6.2.9 这个版本出来的时间很早，源码里针对的是 2.6.x 到 3.x 时代的内核 API。我实测在 4.9 内核上编译能过，但 5.10 之后就开始报错，主要原因是 net_device_ops 里的 ndo_poll_controller 在新内核中被移除，还有 alloc_netdev 的参数类型也有调整。
编译目标平台决定你要不要用交叉编译工具链。如果只是在 x86 的工控机上插模组调试，那直接用当前内核头文件编就行；如果是 ARM 嵌入式板子，必须用板子对应的交叉编译器，否则编出来的 .ko 加载时直接报 invalid module format。
先确认当前环境：
uname -r cat /proc/version如果是交叉编译，Makefile 里要指定 ARCH 和 CROSS_COMPILE。
2.2 内核头文件与 build 目录的准备
加载 .ko 时内核会校验 vermagic，版本号不匹配就拒绝加载。所以编译前必须在板子的内核源码树上执行 modules_prepare，确保生成 Module.symvers 和头文件相关的中间文件。
我踩过很蠢的坑：为了省事直接用 uname -r 对应的 linux-headers 包去编，结果板子的内核源码是厂商改过的，EXTRAVERSION 和 config 都对不上，编完 insmod 就报 version magic 错误。正确的做法是把完整内核源码放到开发机上：
cd /path/to/kernel_source make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- modules_prepare这样生成的目标文件就和目标板上运行的内核完全同源。
2.3 适配新版内核的代码修改
如果你内核对 GobiNet 比较新，编译时一般会遇到几个典型报错：
第一个是 undefined reference tondo_poll_controller。这个钩子函数在 5.15 之后被删了，处理办法简单粗暴，把 net_device_ops 结构体里对应的赋值行注释掉，驱动运行不受影响。
第二个是 alloc_netdev 的初始化。老版本驱动里经常直接用 alloc_netdev(0, "usb%d", NET_NAME_UNKNOWN, ether_setup) 之类的方式，新内核要求传入 priv 大小和 setup 函数，需要按内核源码里其他网络驱动的写法修正。
第三个问题是 set_current_state 从 EXPORT_SYMBOL 变成内联后，偶尔会出现链接警告，有时加个宏定义就行。这块没有一个通用的补丁，最好的方法是先直接 make 一次，根据报错逐行改，内核源码资料很全，百度一下都能找到对应 API。
3. Linux 平台编译安装全流程实录
3.1 修改 Makefile 指定内核路径
解压驱动包，进入源码目录看到 Makefile 后，先别急着 make，大概率会编译失败。打开 Makefile 找到下面几行：
obj-m := GobiNet.o GobiNet-objs := QMIDevice.o QMI.o QMIThread.o GobiNet.o GobiUSBNet.o KERNELDIR ?= /lib/modules/$(shell uname -r)/build PWD := $(shell pwd) default: $(MAKE) -C $(KERNELDIR) M=$(PWD) modules如果是本地 x86 直接编，KERNELDIR 默认路径没问题。如果是交叉编译，改成：
KERNELDIR := /home/user/your_kernel_source ARCH := arm64 CROSS_COMPILE := aarch64-linux-gnu-然后执行：
make clean make3.2 加载模块并确认虚拟网卡出现
编译成功后会生成 GobiNet.ko。加载前先把 Modem 插上 USB，确认设备枚举正常：
dmesg | tail看到类似 usb 1-1: GSM modem (1-port) converter now attached to ttyUSB 这样的输出，说明模组被 USB 串口驱动正常识别了。但这里有个隐藏坑：GobiNet 和 usb_wwan 驱动可能同时匹配这个设备的 PID/VID，如果你想让 GobiNet 接管数据端点，可能需要先卸载默认的 usb_wwan 驱动，或者根据自己的驱动参数确认加载顺序，否则后面会有设备节点冲突。
加载驱动：
sudo insmod GobiNet.ko dmesg | tail -30正常情况下能看到注册了 GobiNet 网络设备，比如 usb0 或 wwan0。执行 ifconfig -a 确认接口存在。
3.3 拨号与网络配置，让它真正能上网
驱动加载只是第一步，接下来要让模组拨号。先用 AT 口确认 SIM 卡状态：
echo -e "AT+CPIN?\r" > /dev/ttyUSB1如果返回 +CPIN: READY，说明 SIM 卡正常。接着配置 APN 和拨号协议，因为 GobiNet 的默认数据行为由模组侧的 usbnet 模式决定：
echo -e "AT+QCFG=\"usbnet\",1\r" > /dev/ttyUSB1然后执行 QMI 拨号。注意 GobiNet 驱动本身不带拨号工具，需要借助移远的 QMI 拨号脚本，或者用内核模块导出的接口直接激活网络。实际操作中我用过两种方式：一种是写个简单的 GobiAPI 调用程序，另一种是直接用高通提供的 gobinet_dail 示例。简单起见，可以先给网卡配置静态 IP 或 DHCP 获取：
sudo udhcpc -i usb0如果 DHCP 不通，检查 AT+QCFG 有没有正确设置，或者手动设置：
sudo ifconfig usb0 10.0.0.2 netmask 255.255.255.0 up sudo ip route add default via 10.0.0.1 dev usb0ping 一下外网确认通不通。一般走到这步，数据业务就通了。
4. Android 平台集成 GobiNet 的差异点
4.1 内核编译环节的调整
Android 设备上集成这个驱动，本质跟 Linux 一样，都是把源码编进内核或编译成 ko，但有几个地方很不一样。
首先，Android 使用 vendor 内核，编译时要走 Android 的 build 系统，而不是直接在驱动目录 make。通常要把 GobiNet 源码放到 kernel/drivers/net/usb/ 下，然后在 Kconfig 和 Makefile 里添加上，或者直接把 GobiNet.c 等文件加入 obj-y 编进内核，避免模块加载权限和签名的问题。
其次，Android 内核一般会用 clang 编译器，和用 GCC 编译的驱动源码偶尔会有告警差异，常见的是未初始化变量告警会变成编译错误（-Werror）。我看到过 Werror 把整个内核编挂的情况，所以记得在对应目录 Makefile 里临时加一行 ccflags-y += -Wno-error，免得卡在对业务没啥影响的告警上。
4.2 RIL 层和数据通路的协同
Android 上，打电话、发短信、注册网络这些控制面功能统一由 RIL（Radio Interface Layer）管理。RIL 进程 rild 会打开对应的串口设备（比如 /dev/ttyUSB1），通过 AT 指令与模组交互。业务数据则不走串口，而是走 GobiNet 虚拟出来的网卡接口，由 netd 管理。
一个关键配置是模组的工作模式。先用 AT 指令查询当前模式：
AT+QCFG="usbnet"如果返回 0，说明数据面走的是串口 PPP；要改成网卡模式，执行：
AT+QCFG="usbnet",1改完重启模组，系统里就会出现网卡接口。Android 的 ConnectivityService 会通过 EthernetNetworkFactory 这个接口来管理它，如果设备出厂不带以太网管理逻辑，需要自己写个小的 network agent，或者用 ethernet-service 模块来把它注册成系统管理的网络。
4.3 SELinux 策略和权限地狱
Android 8.0 之后 SELinux 强制模式非常严格。rild 默认的 policy 只允许访问串口和 socket，一旦要打开由 GobiNet 创建的网络设备节点，或者访问 /sys/class/net/usb0 下的文件，就会被 avc denied 挡住。
排查方法：
adb shell dmesg | grep avc adb shell logcat -b events | grep avc看到 denied 信息后，在 device 目录下的 SEPolicy 里加对应的 allow 规则。我在一个项目里遇到过 rild 需要读取 signal strength 的 QMI 消息，但 GobiNet 的 QMI 通道节点权限是 0600 root 所有，rild 没权限打开，最后在 file_contexts 和 rild.te 里单独加了权限才解决。
如果只是快速验证功能，可以先临时把系统切到 permissive：
adb root adb shell setenforce 0但产品发布时不允许这样，必须把必要的权限补进 SEPolicy。
5. 常见问题与排查技巧实录
以下问题都是我在不同项目里实际遇到过的，整理成速查表方便大家对照。
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| insmod 报 invalid module format | 内核版本或 vermagic 不匹配 | 用目标板同源内核源码重新编译，确认 ARCH 和 CROSS_COMPILE 正确 |
| 加载后没有 usb0/wwan0 接口 | USB PID/VID 没有匹配到 GobiNet 驱动 | dmesg 检查是否被 usb_wwan 或其他驱动占用，手动 bind 到 GobiNet 或在源码中增加设备 ID |
| dmesg 报 unknown symbol | 驱动引用的内核符号未导出 | 检查 Module.symvers，确认依赖的其他模块已经提前加载 |
| 拨号成功但 ping 不通外网 | 路由或 DNS 配置错误、APN 缺失 | 检查 ifconfig、route -n、/etc/resolv.conf，用 AT+CGDCONT 设 APN 后重新拨号 |
| 传输速率明显偏低 | USB 端点工作模式不对，或内核 USB 电源管理开启自动挂起 | 检查 USB 是否运行在 high-speed，禁用 autosuspend：echo -1 > /sys/module/usbcore/parameters/autosuspend |
| Android 下 rild 打开串口失败 | SELinux 权限限制 | 查看 avc denied，补齐 SEPolicy 规则，或者临时 setenforce 0 定位 |
| 内核 5.15 以上编译不过 | 旧版 net_device_ops API 不兼容 | 删除 ndo_poll_controller 赋值，按新内核 API 修改 alloc_netdev |
另外还有两个容易被忽视的地方：
第一是驱动加载顺序。系统里如果同时存在 qmi_wwan 和 GobiNet，两者会竞争同一个 USB 设备。解决办法是在驱动源码的 USB ID 表中删掉其中一个驱动的 ID，或者在 modprobe 配置里 blacklist 掉不用的驱动。我之前调试时两个驱动抢设备，导致网卡接口一会是 eth1 一会是 wwan0，数据面时断时续，排查了很久才发现是两个驱动的匹配 ID 重叠。
第二是电源管理。笔记本或嵌入式板卡上如果 USB 总线开启了 autosuspend，模组在待机后经常出现网卡 link 丢失，表现为 ping 不通、ifconfig 看到大量 dropped packets。可以这样关闭：
echo -1 > /sys/module/usbcore/parameters/autosuspend或者更精细一点，在驱动的 USB probe 函数里对 quirk 标志位加上 USB_QUIRK_RESET_RESUME。
再补充一个成功率极高的调优经验：用 GobiNet 时把网卡 rx/tx 的 ring buffer 调大一点，可以明显改善批量小包场景下的吞吐。方法：
ethtool -G usb0 rx 4096 tx 4096但这个不是所有内核版本都支持，如果报错就跳过。
6. 版本选择与替代方案的思考
GobiNet 这个版本我用下来最大的感受是：它不是不能跑，而是对内核版本的敏感度太高。同一个源码，换个内核小版本，API 可能就变了。所以如果你的项目还在早期选型阶段，我更建议优先考虑内核主线里的 qmi_wwan 方案，配合 libqmi 和 ModemManager，社区资料多、维护活跃、出问题好搜方案。但如果你和我一样是维护老项目，内核版本被产品基线锁死，那继续用 GobiNet 也完全没问题，只要把源码在本项目内核上修好一次，以后直接用就行。
另外提示一下，移远的新款模组，比如 EC200A、EG915U 这些，走的不是高通 Gobi 架构，GobiNet 驱动不适用，需要用模组官方文档里指定的 RNDIS、ECM 或者专用 USB 驱动。所以拿到一个驱动包先别急着编，先查模组平台和官方手册，避免白折腾。
最后分享一个排查建议：加载任何模组驱动前，先备份一份 dmesg 输出，把所有 USB 枚举信息和内核模块加载日志存档，出问题的时候对照着看，比盲目改代码高效得多。我自己做过一套通用调试脚本，自动抓 dmesg、lsusb -v、ifconfig -a、route -n、ls /sys/bus/usb/devices/，发布前跑一遍，可以节省大量售后排查时间。
本文还有配套的精品资源，点击获取
