嵌入式Linux下MT7601U无线网卡驱动移植与网络配置实战

1. 项目概述

最近在做一个基于Linux 3.5内核的嵌入式项目，需要让开发板通过USB接口连接无线网络。手头正好有几个闲置的360随身WiFi，查了一下，它的核心芯片是联发科（MediaTek）的MT7601U，这是一款非常经典的USB无线网卡方案。在PC上用它很简单，官网下个驱动插上就能用，但在嵌入式Linux环境下，就没那么现成了。你得自己动手，把驱动源码“移植”到你的目标板上，还得配上相应的网络管理工具，才能让这个小玩意儿真正跑起来。这个过程，说白了就是一次典型的嵌入式Linux外设驱动开发实战，涉及驱动编译、内核配置、交叉编译工具链使用，以及一系列用户空间网络工具的部署。如果你也在为类似的项目头疼，或者想深入了解Linux驱动和无线网络配置的底层细节，那这篇从零开始的踩坑记录或许能给你一些参考。

2. 开发环境与物料准备

在动手之前，得先把“战场”布置好。嵌入式开发的特点就是“宿主-目标”分离，绝大部分编译、配置工作都在性能更强的PC（宿主机）上完成，生成的可执行文件再放到资源受限的开发板（目标机）上运行。

2.1 软硬件环境清单

我的具体环境如下，你的环境可能不同，但核心组件和思路是相通的：

• 目标机（开发板）：
  • CPU架构：ARM
  • Linux内核版本：3.5.0
  • 文件系统：基于BusyBox构建的简易根文件系统，通过NFS从宿主机挂载，方便调试。
• 宿主机（开发PC）：
  • 操作系统：Red Hat Enterprise Linux (或其他Linux发行版均可，如Ubuntu)
  • 交叉编译工具链：arm-linux-gcc-4.5.1
    • 这是最关键的工具，它运行在x86的宿主机上，但生成的是ARM架构的可执行代码。你需要根据你的开发板CPU型号（如ARMv7, Cortex-A系列等）从芯片厂商或工具链提供商（如Linaro， ARM官方）获取对应的工具链。
• 硬件：
  • 360随身WiFi（一代），芯片确认是MT7601U。
  • 开发板需具备可用的USB Host接口。

2.2 核心物料获取

兵马未动，粮草先行。我们需要准备好三样东西：驱动源码、无线配置工具、以及可能的加密库。

1. MT7601U驱动源码： 驱动是硬件和操作系统沟通的桥梁。联发科为MT7601U提供了Linux版的“STA”（Station，客户端模式）驱动源码包。虽然原链接可能失效，但你可以在搜索引擎中搜索“DPO_MT7601U_LinuxSTA_3.0.0.4_20130913.tar.bz2”这个文件名，通常能在开源社区或一些技术论坛找到备份。这个版本虽然老，但对Linux 3.5内核兼容性较好。

2. Wireless Tools工具集： 这是一套经典的、基于命令行配置无线网卡的工具，由Jean Tourrilhes维护。我们主要用它进行基础的网络扫描、连接和信息查看。可以通过其官网或镜像站点下载，例如wireless_tools.29.tar.gz。

3. WPA Supplicant工具： 现在家庭WiFi普遍使用WPA/WPA2加密，而基础的wireless_tools对WPA支持有限。wpa_supplicant就是一个专门处理WPA/WPA2认证的守护进程和客户端工具，要连接加密热点，它几乎是必需品。可以从w1.fi官网下载，例如wpa_supplicant-2.5.tar.gz。

4. 依赖库（可选但常见）：

   • OpenSSL：wpa_supplicant在编译WPA2部分时可能需要加密库支持。
   • libnl：一个用于Netlink通信的库，某些wpa_supplicant的配置（如CONFIG_LIBNL32=y）需要它来提供更先进的网络控制功能。
   • Flex & Bison：语法分析器生成器，在编译一些较新版本的libnl或wpa_supplicant时，如果系统自带的版本太旧，可能需要手动安装新版本。

提示：建议在宿主机上建立一个清晰的工作目录，例如~/workspace/mt7601_project/，将下载的所有源码包都放在这里，方便管理。

3. MT7601U驱动移植详解

驱动移植是第一步，也是最核心的一步。目标是将针对x86平台编写的驱动源码，修改并编译成能在我们ARM开发板上加载的内核模块（.ko文件）。

3.1 驱动源码解压与初步审视

将下载的驱动压缩包放到工作目录并解压。

tar xvf DPO_MT7601U_LinuxSTA_3.0.0.4_20130913.tar.bz2 cd DPO_MT7601U_LinuxSTA_3.0.0.4_20130913

解压后，先别急着编译。用ls看一下目录结构，通常会有common/,include/,os/,sta/等子目录，以及顶层的Makefile。这个Makefile是我们需要动手术的第一个地方。

3.2 关键修改步骤解析

3.2.1 修改目标平台

打开顶层Makefile，找到定义平台（PLATFORM）的地方。原驱动默认是为PC（x86）编译的，我们需要告诉它，我们要为特定的嵌入式平台（这里以三星SMDK开发板为例）交叉编译。

# 找到类似的行，通常在第30行附近 # PLATFORM = PC # 将这行注释掉 PLATFORM = SMDK # 将这行的注释取消

SMDK是驱动代码里预定义的一个平台标识，它关联着后续的交叉编译器和内核源码路径。

3.2.2 配置交叉编译环境与内核路径

继续在Makefile中寻找针对SMDK平台的配置块。通常是一个ifeq ($(PLATFORM),SMDK)的条件判断语句。

# 找到这个条件块，修改其中的路径和编译器 ifeq ($(PLATFORM),SMDK) LINUX_SRC = /work/linux-3.5/linux-3.5 # 修改为你本地Linux内核源码的绝对路径 CROSS_COMPILE = arm-linux- # 修改为你的交叉编译器前缀，确保末尾有‘-’ endif

• LINUX_SRC：必须指向你为目标板编译所使用的那个Linux内核的源码目录。驱动模块编译时需要内核的头文件来了解内核的数据结构和函数接口。路径错误会导致编译失败或模块无法加载。
• CROSS_COMPILE：指定交叉编译器前缀。arm-linux-意味着编译时会调用arm-linux-gcc，arm-linux-ld等工具。请根据你的工具链实际名称修改（例如可能是arm-none-linux-gnueabi-）。

3.2.3 添加USB设备ID

Linux内核通过USB的Vendor ID和Product ID（合称VID:PID）来识别USB设备，并为其加载对应的驱动。我们需要将360随身WiFi的ID添加到驱动的设备ID表中。

首先，在宿主机上（确保虚拟机已连接该WiFi）使用lsusb命令查看设备ID：

lsusb

插入360WiFi后，再次执行lsusb，对比多出的那一行，例如：

Bus 001 Device 007: ID 148f:760b Ralink Technology, Corp. MT7601U Wireless Adapter

这里148f是厂商ID（VID），760b是产品ID（PID）。

然后，在驱动源码的common/rtusb_dev_id.c文件中，找到RTUSB_DEVICE_ID_T结构体数组，将我们的ID按格式添加进去：

{USB_DEVICE(0x148f,0x760b)}, /* 360 WiFi */

这样，当内核检测到VID:PID为148f:760b的USB设备时，就会尝试加载我们这个驱动。

3.2.4 关闭内核调试信息输出

驱动源码中充满了DBGPRINT宏，用于输出调试信息。在最终产品上，这些信息会刷屏，干扰正常操作。我们需要关闭它。 找到include/os/rt_linux.h文件，在定义DBGPRINT宏的地方（大约1558行）将其重定义为空：

#undef DBGPRINT #define DBGPRINT(...) // 这行让所有调试打印失效

或者，你也可以选择性地关闭，但为了清净，通常直接全部关掉。

3.2.5 编译驱动模块

完成上述修改后，在驱动源码的顶层目录执行make命令。

make

如果一切顺利，你会在os/linux/目录下找到生成的mt7601Usta.ko文件。这就是我们需要的驱动模块。

实操心得：编译过程最常见的错误是“找不到头文件”或“函数未定义”。这几乎总是因为LINUX_SRC路径设置错误，或者你使用的内核源码版本与驱动不兼容（3.5.0内核相对较老，这个驱动版本是匹配的）。确保内核源码已经成功编译过（即存在include/generated/autoconf.h等文件）。

3.3 内核与Bootloader配置要点

驱动模块编译好了，但要让它能在开发板上正常工作，内核和Bootloader也需要一些配合。

1. 内核配置：确保你的Linux内核配置中启用了以下关键选项（通过make menuconfig查看）：

   • CONFIG_USB_SUPPORT=y和CONFIG_USB=y(USB核心支持)
   • CONFIG_USB_USBNET=y(USB网络设备支持，虽然MT7601是独立驱动，但通用USB网络框架有时是基础)
   • CONFIG_WIRELESS_EXT=y(无线扩展支持，wireless_tools依赖它)
   • CONFIG_CFG80211=y和CONFIG_MAC80211=y(较新的无线内核子系统，但3.5内核可能仍主要依赖CONFIG_WIRELESS_EXT，具体看驱动要求)
   • CONFIG_MODULES=y(支持可加载模块)
   • CONFIG_MODULE_UNLOAD=y(支持模块卸载)

2. U-Boot环境变量：这是一个非常关键但容易被忽略的坑。MT7601这类USB网卡驱动在初始化时，会通过DMA（直接内存访问）与CPU交换数据。如果内核的coherent_pool（一致性内存池）大小不足，分配DMA缓冲区就会失败，导致驱动加载时报错。 需要在U-Boot的启动参数bootargs中追加coherent_pool=2M。例如：

   setenv bootargs root=/dev/nfs nfsroot=192.168.1.100:/nfsroot ip=192.168.1.10:192.168.1.100:192.168.1.1:255.255.255.0::eth0:off console=ttySAC0,115200 coherent_pool=2M init=/linuxrc saveenv

   2M通常足够，如果遇到其他DMA错误，可以尝试增大此值。

3.4 驱动加载与初步测试

将编译好的mt7601Usta.ko和驱动包中的配置文件RT2870STA.dat拷贝到开发板的文件系统中。

# 在开发板上操作 insmod /path/to/mt7601Usta.ko

使用dmesg命令查看内核日志，如果看到类似usb 1-1.2: New USB device found, idVendor=148f, idProduct=760b以及rt2870: module is from the staging directory, ...和... firmware: direct-loading firmware rt2870.bin等字样，并且没有明显的错误（ERROR），通常表示驱动识别并加载成功。

接着，将RT2870STA.dat文件拷贝到开发板的/etc/Wireless/RT2870STA/目录下（没有则创建）。这个文件包含了驱动的一些默认射频参数。

mkdir -p /etc/Wireless/RT2870STA/ cp RT2870STA.dat /etc/Wireless/RT2870STA/

此时，执行ifconfig -a或ip link show，你应该能看到一个新的网络接口，通常是ra0或wlan0。执行iwconfig，如果该接口显示为“IEEE 802.11”模式，则驱动层面基本就绪。

4. 无线网络管理工具链部署

驱动让系统认识了硬件，接下来需要工具来配置和使用它。我们将部署两套工具：基础的wireless_tools和更强大的wpa_supplicant。

4.1 交叉编译与安装Wireless Tools

wireless_tools编译相对简单，因为它主要依赖C库。

1. 解压与配置：

   tar xvf wireless_tools.29.tar.gz cd wireless_tools.29

   编辑Makefile，主要修改编译器和归档工具为交叉编译版本：

   CC = arm-linux-gcc AR = arm-linux-ar RANLIB = arm-linux-ranlib # 确保这些工具在你的PATH环境变量中，或者使用绝对路径

2. 编译与安装：

   make clean make

   编译成功后，会生成几个关键的可执行文件：iwconfig,iwlist,iwpriv,iwspy,iwevent，以及库文件libiw.so.29。

3. 部署到目标板：

   • 将libiw.so.29拷贝到开发板根文件系统的/usr/lib/目录。
   • 将iwconfig,iwlist,iwpriv等可执行文件拷贝到开发板的/usr/sbin/或/usr/bin/目录。
   • 可能需要创建符号链接：ln -sf libiw.so.29 /usr/lib/libiw.so

4. 基础功能测试：

   ifconfig ra0 up # 启动无线接口 iwlist ra0 scan # 扫描周围的WiFi网络，如果能列出AP，说明驱动和工具基本正常 iwconfig ra0 # 查看无线接口配置

常见问题：在开发板上运行iwconfig等工具时，可能会报错“can‘t resolve symbol ‘__ctype_b_loc‘”。这是因为工具链的C库版本与开发板运行时的C库版本不兼容。一个快速的解决方法是，在宿主机编译前，编辑wireless_tools.29源码中的iwlib.h文件，找到#include <ctype.h>这一行并注释掉，然后重新编译。但这可能影响某些功能，最根本的解决方法是使用与目标板系统完全匹配的工具链。

4.2 为WPA/WPA2加密移植WPA Supplicant

wpa_supplicant的编译稍复杂，因为它依赖于加密库。

4.2.1 交叉编译OpenSSL库

由于开发板资源有限，我们通常编译OpenSSL的共享库版本。

tar xvf openssl-1.0.2e.tar.gz cd openssl-1.0.2e ./config shared no-asm --prefix=$PWD/install_arm

shared生成动态库，no-asm避免使用汇编代码（提高跨平台兼容性），--prefix指定安装目录。

修改生成的Makefile，将编译器相关变量改为交叉编译器：

CC= arm-linux-gcc AR= arm-linux-ar $(ARFLAGS) r RANLIB= arm-linux-ranlib NM= arm-linux-nm

然后编译并安装到指定目录：

make make install

编译完成后，在install_arm目录下会得到include,lib,bin等子目录。

4.2.2 交叉编译WPA Supplicant

1. 解压与准备配置：

   tar xvf wpa_supplicant-2.5.tar.gz cd wpa_supplicant-2.5/wpa_supplicant cp defconfig .config

2. 配置.config文件： 编辑.config文件，这是编译配置的核心。我们需要指定交叉编译器、头文件和库的路径。

   # 指定交叉编译器 CC=arm-linux-gcc # 添加OpenSSL的头文件和库路径 CFLAGS += -I/path/to/openssl-1.0.2e/install_arm/include LIBS += -L/path/to/openssl-1.0.2e/install_arm/lib # 如果需要libnl支持（用于nl80211驱动后端，比wext更现代），则添加 # CFLAGS += -I/path/to/libnl-3.2.25/install_arm/include/libnl3 # LIBS += -L/path/to/libnl-3.2.25/install_arm/lib # CONFIG_LIBNL32=y # CONFIG_DRIVER_NL80211=y # 启用nl80211驱动 # 对于MT7601U的老驱动，我们通常使用wext（无线扩展）接口 CONFIG_DRIVER_WEXT=y CONFIG_BACKEND=file CONFIG_CTRL_IFACE=y CONFIG_CTRL_IFACE_UNIX=y

   注意将/path/to/替换为你实际的绝对路径。

3. 编译与安装：

   make clean make

   编译成功后，会生成wpa_supplicant（主程序）和wpa_cli（命令行客户端）。将它们拷贝到开发板的/usr/sbin/或/usr/bin/目录。同时，将OpenSSL的库文件（libcrypto.so.*和libssl.so.*）从install_arm/lib/拷贝到开发板的/usr/lib/目录。

4.2.3 配置与使用WPA Supplicant连接加密网络

1. 创建配置文件：在开发板的/etc/目录下创建wpa_supplicant.conf。

   ctrl_interface=/var/run/wpa_supplicant ap_scan=1 update_config=1 network={ ssid="Your_WiFi_SSID" key_mgmt=WPA-PSK psk="Your_WiFi_Password" }

   • ssid：你的无线网络名称。
   • key_mgmt：密钥管理方式，WPA-PSK适用于个人家庭网络。
   • psk：WiFi密码。明文密码不安全，可以使用wpa_passphrase工具生成加密后的PSK：wpa_passphrase Your_WiFi_SSID Your_WiFi_Password，然后将输出的psk=...行复制到配置文件中。

2. 启动连接：

   # 创建控制接口目录 mkdir -p /var/run/wpa_supplicant # 启动wpa_supplicant守护进程 wpa_supplicant -Dwext -ira0 -c /etc/wpa_supplicant.conf -B

   • -Dwext：指定使用wext驱动接口（Wireless Extensions）。
   • -ira0：指定无线网络接口名。
   • -c：指定配置文件路径。
   • -B：后台运行。

3. 使用wpa_cli监控状态：

   wpa_cli -ira0 status

   如果看到wpa_state=COMPLETED和ip_address被分配，说明连接成功。

5. 网络配置与自动化脚本

成功连接WiFi后，还需要配置IP地址才能访问网络。

5.1 手动配置IP地址

ifconfig ra0 192.168.1.100 netmask 255.255.255.0 up route add default gw 192.168.1.1 # 添加默认网关 echo "nameserver 8.8.8.8" > /etc/resolv.conf # 设置DNS

然后就可以ping 8.8.8.8测试网络连通性了。

5.2 使用DHCP自动获取IP（推荐）

嵌入式系统常用Busybox自带的udhcpc作为DHCP客户端。

1. 确保Busybox已编译udhcpc：在Busybox配置菜单中，选中Networking Utilities -> udhcp Client (udhcpc)。

2. 准备默认脚本：将Busybox源码目录下的examples/udhcp/simple.script脚本拷贝到开发板的/usr/share/udhcpc/default.script，并赋予执行权限。

   chmod +x /usr/share/udhcpc/default.script

   这个脚本负责在收到DHCP服务器响应后，自动设置IP、网关和DNS。

3. 自动获取IP：

   udhcpc -i ra0 -b

   -b表示后台运行。成功后，使用ifconfig ra0查看自动获取的IP地址。

5.3 创建开机自启动脚本

为了让开发板开机自动连接WiFi，可以将一系列命令写入启动脚本，如/etc/init.d/wifi_start.sh，并在/etc/rc.local或系统初始化脚本中调用它。

#!/bin/sh # /etc/init.d/wifi_start.sh # 加载驱动 insmod /path/to/mt7601Usta.ko sleep 2 # 启动WPA连接 wpa_supplicant -Dwext -ira0 -c /etc/wpa_supplicant.conf -B sleep 5 # 自动获取IP udhcpc -i ra0 -b exit 0

记得给脚本加上执行权限：chmod +x /etc/init.d/wifi_start.sh。

6. 故障排查与经验总结

在整个移植和配置过程中，你几乎一定会遇到各种问题。下面是一些常见问题的排查思路：

6.1 驱动加载失败

• 现象：insmod时报错，如“Unknown symbol”、“Invalid module format”。
• 排查：
  1. 检查内核版本是否匹配。使用uname -r查看运行内核版本，确保与编译驱动时使用的LINUX_SRC内核版本一致。
  2. 检查内核配置是否启用了必要的选项（如前文所述）。
  3. 使用dmesg | tail查看详细内核错误信息。

6.2 WiFi接口无法启动或扫描不到网络

• 现象：ifconfig ra0 up成功，但iwlist ra0 scan无结果或报错。
• 排查：
  1. 射频开关/区域码：有些无线网卡默认射频是关闭的，或者区域码（regdomain）不正确。可以尝试iw reg set US（或其他地区代码）并ifconfig ra0 down/up。MT7601驱动可能需要特定的iwpriv命令来开启射频，这需要查阅驱动的私有命令文档（通常在源码包的README或sta目录下的文档中）。
  2. 配置文件：确认RT2870STA.dat文件已正确放置，且权限可读。
  3. 驱动模式：确认驱动编译的是STA（客户端）模式，而不是AP模式。
  4. 硬件问题：检查USB接口供电是否充足，尝试更换USB口或USB线。

6.3 WPA Supplicant连接失败

• 现象：wpa_supplicant进程启动后，wpa_cli status一直显示ASSOCIATING或4WAY_HANDSHAKE失败。
• 排查：
  1. 密码错误：最常见的原因。使用wpa_passphrase生成PSK并确认配置文件无误。
  2. 加密方式不匹配：确认路由器加密方式是WPA-PSK还是WPA2-PSK，或两者混合。在wpa_supplicant.conf中，proto和pairwise参数可以调整。例如：

     network={ ssid="Your_SSID" key_mgmt=WPA-PSK proto=WPA2 # 强制WPA2 pairwise=CCMP # 强制CCMP(AES) group=CCMP psk="Your_Password" }

  3. 驱动接口：尝试更换驱动后端。-Dwext是通用接口，如果不行，且内核支持nl80211，可以尝试编译wpa_supplicant时启用CONFIG_DRIVER_NL80211并使用-Dnl80211。但MT7601老驱动对nl80211支持可能不好。
  4. 查看详细日志：运行wpa_supplicant时不加-B，在前台运行并加上-dd参数输出详细调试信息：wpa_supplicant -Dwext -ira0 -c /etc/wpa_supplicant.conf -dd。

6.4 能连接AP但无法获取IP或上网

• 现象：wpa_cli status显示COMPLETED，但ifconfig看不到IP，或无法ping通网关。
• 排查：
  1. DHCP问题：手动配置静态IP测试（如ifconfig ra0 192.168.1.100），然后ping网关。如果能通，则是udhcpc或DHCP服务器问题。检查default.script脚本是否有执行权限，内容是否正确。
  2. 路由问题：使用route -n查看路由表，确保默认网关（0.0.0.0）指向正确的接口（ra0）和网关IP。
  3. 防火墙：开发板内核或路由器端是否有防火墙规则阻止了数据包。
  4. DNS问题：能ping通IP（如8.8.8.8）但不能ping通域名（如www.baidu.com），检查/etc/resolv.conf中的DNS服务器设置。

6.5 性能与稳定性问题

• 现象：连接速度慢，吞吐量低，或频繁断线。
• 排查与优化：
  1. 驱动参数：RT2870STA.dat文件中包含功率、频段、速率等参数。可以根据环境进行微调，但需谨慎。可以参考驱动源码包中的配置文件示例或联发科的相关文档。
  2. 电源管理：尝试在驱动加载时或通过iwconfig关闭电源管理：iwconfig ra0 power off。USB无线网卡在省电模式下可能性能下降。
  3. 内核网络参数：调整一些内核网络参数可能有助于稳定性，例如增加Socket缓冲区大小。但这属于高级调优，需要根据具体场景测试。
  4. 信号强度：使用iwconfig ra0查看Link Quality和Signal level。信号太弱是导致不稳定和低速的根本原因。

这次MT7601U驱动移植项目，本质上是一次对Linux无线网络栈从内核驱动到用户空间工具的完整实践。它清晰地展示了嵌入式开发中“硬件驱动-系统接口-用户工具”的协作链条。最大的体会是，耐心和细致的日志分析是关键。每一步，从修改Makefile的一个路径，到添加一个USB ID，再到理解wpa_supplicant的四种握手过程，都可能成为阻塞点。建议在每一步修改后都进行小范围的测试，并用dmesg和工具输出日志来验证，而不是等到最后才统一调试。另外，妥善保存好每个阶段编译成功的二进制文件和配置文件，方便回滚和对比。最后，虽然老旧的wireless_tools和wext接口正在被iw和nl80211取代，但在很多传统嵌入式项目和特定硬件上，这套“老办法”依然是稳定可靠的解决方案。理解这个过程，对于你未来处理其他无线网卡，甚至迁移到更新的驱动框架，都会打下坚实的基础。