Linux 下 4 步跑通 MT7601U 无线网卡驱动从编译到验证排错【免费下载链接】mt7601u项目地址: https://gitcode.com/gh_mirrors/mt7/mt7601uLinux 上插着 MT7601U 芯片的 USB 无线网卡dmesg 里看得到设备 IDifconfig 里却迟迟不出 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输出里带14e2Ralink/MediaTek 厂商 IDMT7601U 常见产品 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再按序 insmodlsusb 里没有 14e2 设备网卡没被 USB 层识别换 USB 口/换线dmesg 里找usb相关报错模块加载成功但 ra0 一直不出现固件或 efuse 初始化卡住执行dmesg | tail -50找最后一条 mt7601Usta 日志对照报错信息处理升级内核后网卡突然失效模块是按旧内核编译的在新内核上重新编译并重新加载进阶配置与相关工具切换工作模式编辑 src/Makefile 里的WIFI_MODESTA是站点模式、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），仅供参考