Linux 下 4 步跑通 MT7601U 无线网卡驱动：从编译到验证排错
【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601u
Linux 上插着 MT7601U 芯片的 USB 无线网卡，dmesg 里看得到设备 ID，ifconfig 里却迟迟不出 ra0 接口——这就是这套 MT7601U 无线网卡驱动要解决的问题。它把 Ralink/MT7601U 网卡的 STA、AP 模式都实现成了内核模块，装好之后网卡就能正常扫描和联网。这篇上手教程按环境自检、编译、加载、验证的顺序拆成 4 步，每步都给命令和预期输出，读完直接敲命令就能跑通。适合手里有 MT7601U 网卡、在 Ubuntu/Debian 等发行版上装驱动的新手。
它到底能干什么
笔记本/树莓派直接连 WiFi：插上网卡，驱动以 STA（站点）模式工作，配合 wpa_supplicant 就能像普通笔记本一样连加密 WiFi。
把网卡做成随身热点：同一套代码支持 AP 模式，插上手机或树莓派即可自建 WiFi 热点给别的设备用。
排查无线故障：驱动自带 ATE 测试命令，工厂测试和定位信号问题时用得到，命令说明见 doc/ 下的 iwpriv_usage.txt。
编译驱动前的 3 项环境自检
1. 确认 Linux 系统装了内核头文件。编译（把 C 源码转成内核模块的过程）需要当前内核的头文件，缺了直接报错。执行：
uname -r ls /lib/modules/$(uname -r)/build第二行能列出一堆目录（如 arch、include）就算满足。Ubuntu/Debian 没有就装对应内核头文件包，例如sudo apt install linux-headers-$(uname -r)。
2. 确认编译工具 gcc 和 make 在位：
gcc --version && make --version各自输出版本号即可；缺失用sudo apt install build-essential补上。
3. 确认 MT7601U 网卡已被系统识别：
lsusb | grep -i 14e2输出里带14e2（Ralink/MediaTek 厂商 ID，MT7601U 常见产品 ID 为3431）即满足。没有任何输出，是 USB 接触问题或网卡本身损坏，换个口再查，别急着编译。
一步步装好并跑通 MT7601U 驱动
1. 获取驱动代码
把项目源码拉到本地：
git clone https://gitcode.com/gh_mirrors/mt7/mt7601u.git cd mt7601u预期结果：进入目录后能看到 src、doc、Makefile。没有这个目录，回到 git clone 这一步检查网络和仓库地址。
2. 编译三个内核模块
在项目根目录执行make，它分三趟把源码编译成 .ko 文件（内核模块，Linux 加载后驱动硬件的可插拔代码）：
make预期结果：src/os/linux/下生成mt7601Usta.ko、mtutil7601Usta.ko、mtnet7601Usta.ko三个文件。报No rule to make target或找不到build目录，回到自检第 1 步装内核头文件；某个源文件编译语法报错，说明内核版本超出这份代码的兼容范围，换对应内核或版本编译。
3. 加载模块
内核模块必须按依赖顺序加载，依次执行这三条：
sudo insmod src/os/linux/mtutil7601Usta.ko sudo insmod src/os/linux/mt7601Usta.ko sudo insmod src/os/linux/mtnet7601Usta.ko预期结果：三条命令都无任何输出、也无报错。出现Invalid module format或version mismatch，是模块和当前内核版本对不上，回第 2 步在正确内核下重新编译。
4. 验证驱动生效
查看模块状态和网络接口：
lsmod | grep mt7601Usta ifconfig ra0预期结果：lsmod 列出mtnet7601Usta、mt7601Usta等条目；ifconfig 输出 ra0 接口（MAC 地址和 Link 信息）。lsmod 无输出回第 3 步；模块在但 ifconfig 没有 ra0，跑dmesg | tail -50看驱动初始化日志定位。验证通了之后，连接 WiFi 用 wpa_supplicant，例如wpa_supplicant -i ra0 -c wpa.conf -B，配好 SSID 和密码后即可获取 IP。
驱动编译报错与加载失败的排查方法
| 症状 | 原因 | 解决 |
|---|---|---|
| make 报找不到内核 build 目录 | 内核头文件未安装 | sudo apt install linux-headers-$(uname -r)后重编 |
| insmod 提示 version mismatch / Invalid module format | 模块编译时的内核与当前运行内核不一致（如升级过内核） | 在当前内核下重新 make，再按序 insmod |
| lsusb 里没有 14e2 设备 | 网卡没被 USB 层识别 | 换 USB 口/换线；dmesg 里找usb相关报错 |
| 模块加载成功但 ra0 一直不出现 | 固件或 efuse 初始化卡住 | 执行dmesg | tail -50找最后一条 mt7601Usta 日志，对照报错信息处理 |
| 升级内核后网卡突然失效 | 模块是按旧内核编译的 | 在新内核上重新编译并重新加载 |
进阶配置与相关工具
切换工作模式：编辑 src/Makefile 里的WIFI_MODE，STA是站点模式、AP是热点模式，改完重新 make。
开关功能项：src/os/linux/config.mk 里每个HAS_xxx开关对应一个功能（WPS、wpa_supplicant 等），按需改成y再重编。
熟悉私有命令：iwpriv 命令说明 列出了 WPS、ATE 等全部iwpriv ra0 set参数，配网和测试前值得过一遍。
相关工具，各一句话：
- wpa_supplicant：连接 WPA/WPA2 加密 WiFi 的守护程序
- hostapd：把网卡配成 AP 热点用的服务
- iwpriv：驱动私有参数的配置工具
- dmesg：读内核环形日志，排错第一手材料
下一步建议先打开 doc/iwpriv_usage.txt 通读一遍可用命令，再按自己场景（站点或热点）调整 config.mk，动手时任何异常先看dmesg | tail -50的输出。
【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601u
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
