# Arm飞牛手动编译 `mt7601u` 无线网卡模块（针对Linux 6.12.41-trim 内核）

最近购买了一块**明创控能 IOT-MKC3568-Main-v1.1**开发板（基于RK3568-EVB1-DDR4-V10设计），但是这个开发板没有任何资料支持，连明创控能的官网都无法访问。经过一段时间的逆向研究，初步适配了Arm版本的飞牛v1.0.0固件，但开发板上的两个网口目前还处于无法使用的状态，设备树的适配仍在缓慢推进。

```bash
dutyc@MKC3568:/$ ip addr
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
2: end1: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
3: end0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
    link/ether _ brd ff:ff:ff:ff:ff:ff
4: docker0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc noqueue state DOWN group default
    link/ether _ brd _
    inet 172.17.0.1/16 brd 172.17.255.255 scope global docker0
       valid_lft forever preferred_lft forever
# 可以看到end0和end1都是未连接状态
```

于是决定先插上USB无线网卡初步测试飞牛的功能完整性(我的网卡为MT7601U芯片方案)。可惜arm飞牛并没有编译`MT7601U`模块，看来只能自行编译了。

> **注意**：由于开发板网口无法使用，编译时需要下载源码，此时要依赖互联网连接。不用着急，用数据线将开发板的`USB-HOST`口和手机连接，通过安卓手机的`USB网络共享`功能就可以让开发板实现联网，兼容性不错

通过串口连接进入arm飞牛的控制台，查看内核信息：

```bash
root@MKC3568:/# uname -a
Linux MKC3568 6.12.41-trim #1 SMP PREEMPT Wed Dec 31 02:09:11 UTC 2025 aarch64 GNU/Linux

root@MKC3568:/# sudo modprobe mt7601u
modprobe: FATAL: Module mt7601u not found in directory /lib/modules/6.12.41-trim
# 可以看到并没有编译MT7601U模块
```

Linux内核从 **v4.2开始已将`mt7601u`驱动合并进主线**，位于：`drivers/net/wireless/mediatek/mt7601u/`，但飞牛系统提供的内核镜像未包含无线驱动模块。

## 下载内核源码

我们需要使用**完全匹配6.12.41**的内核源码。

```bash
mkdir /home/kernel
cd /home/kernel

# 克隆时直接指定tag v6.12.41（深度为1，只下载该版本）
git clone --depth=1 --branch v6.12.41 https://mirrors.tuna.tsinghua.edu.cn/git/linux-stable.git

cd linux
```

## 为什么使用内核源码中的驱动？

> [!NOTE]
>
> 优先选择同版本内核源码进行编译，原因如下：
>
> 1. **版本严格匹配**：确保模块与当前运行内核的 `vermagic`、配置及符号表完全一致
> 2. **稳定性与兼容性**：主线代码经过充分测试，与内核其他组件兼容性最佳
> 3. **配置继承**：可直接基于当前内核配置（`/proc/config.gz`）启用模块
> 4. **维护便捷**：内核升级后可快速用相同方法重新编译对应版本驱动
>
> 第三方驱动（如 GitHub 项目）可能包含未经验证的补丁，容易引发兼容性问题，且不易随内核升级同步维护。


## 配置编译环境

确认当前系统中存在`/proc/config.gz`默认配置文件，这个文件很关键，飞牛的内核有`-trim`后缀。

```bash
root@MKC3568:/home/kernel/linux# ls /proc/config.gz
/proc/config.gz
```

我们这一次是在arm平台上原生编译，不需要交叉编译器。

首先安装编译工具链

```bash
apt update
apt install -y build-essential flex bison libssl-dev libelf-dev bc
```

设置编译参数

```bash
# 设置编译架构（必须设置！否则可能编译出错误架构的模块）
export ARCH=arm64
export CROSS_COMPILE=

# 使用系统当前的内核配置
zcat /proc/config.gz > .config

# 添加正确的 LOCALVERSION
echo 'CONFIG_LOCALVERSION="-trim"' >> .config

# 强制启用MT7601U驱动为模块
echo 'CONFIG_MT7601U=m' >> .config

# 自动处理依赖和新选项
make olddefconfig
```

## 准备构建环境

```bash
make modules_prepare
```

## 编译mt7601u模块

```bash
KBUILD_MODPOST_WARN=1 make M=drivers/net/wireless/mediatek/mt7601u modules
```

> **重要说明**：为什么要加`KBUILD_MODPOST_WARN=1`参数？
>
> 虽然我们在上面执行了`make modules_prepare`，但**`modules_prepare`并不会生成完整的`Module.symvers`**——它只准备头文件。而`Module.symvers`必须在**完整编译内核或至少编译所有built-in模块**后才会生成。直接编译会报`ERROR`。
>
> 但在当前场景中，我们**并不需要重新编译整个内核**，只需要让模块构建系统知道当前运行内核的符号表。
>
> 由于`mt7601u`是**纯外部模块**（不依赖其他内核模块），且我们使用的是**主线内核源码+完全匹配的`.config`**，这些"未定义符号"其实都存在于内核中（只是`modpost`找不到`Module.symvers`来验证）。我们可以**临时允许未解析符号**。
>
> `KBUILD_MODPOST_WARN=1`会将`ERROR`降级为`WARNING`，最终仍会生成`.ko`文件。

## 验证并安装模块

最终编译会得到`drivers/net/wireless/mediatek/mt7601u/mt7601u.ko`模块。

我们验证一下模块的`vermagic`：

```bash
modinfo drivers/net/wireless/mediatek/mt7601u/mt7601u.ko | grep vermagic
```

正常应该输出：

```bash
vermagic: 6.12.41-trim SMP preempt mod_unload aarch64
```

我们的系统内核就是`6.12.41-trim`，完全匹配。

如果你意外获得了`6.12.41 SMP preempt mod_unload aarch64`（缺少`-trim`后缀），请重新进行编译流程，确保系统当前的内核配置被正确继承。

然后就可以安全地安装并加载驱动：

```bash
# 1. 创建目标目录（如果还没创建）
sudo mkdir -p /lib/modules/$(uname -r)/kernel/drivers/net/wireless/mediatek/mt7601u/

# 2. 备份原有模块（如果有的话）
sudo cp /lib/modules/$(uname -r)/kernel/drivers/net/wireless/mediatek/mt7601u/mt7601u.ko ~/mt7601u-6.12.41-trim.ko.bak 2>/dev/null || true

# 3. 复制新编译的模块
sudo cp drivers/net/wireless/mediatek/mt7601u/mt7601u.ko \
   /lib/modules/$(uname -r)/kernel/drivers/net/wireless/mediatek/mt7601u/

# 4. 更新模块依赖
sudo depmod -a

# 5. 安装固件（两个位置都放，确保兼容）
sudo mkdir -p /lib/firmware/mediatek/
sudo wget -O /lib/firmware/mediatek/mt7601u.bin \
   https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/mediatek/mt7601u.bin
sudo cp /lib/firmware/mediatek/mt7601u.bin /lib/firmware/

# 6. 加载驱动
sudo modprobe mt7601u
```

现在我们可以插入网卡看看能否正常使用：

```bash
root@MKC3568:/home/kernel/linux# dmesg | tail -20
mt7601u 1-1:1.0: ASIC revision: 76010001 ...
mt7601u 1-1:1.0: Firmware Version: 0.1.00
```

通过`ip link show`可以看到无线接口`wlx90de80624b0c`。

## 连接Wi-Fi

飞牛默认使用`NetworkManager`，可以使用`nmcli`连接WiFi：

```bash
sudo nmcli dev wifi connect "你的Wi-Fi名称" password "你的Wi-Fi密码"
```

## 设置开机自动加载模块

```bash
echo "mt7601u" | sudo tee /etc/modules-load.d/mt7601u.conf
```

## 异常处理

在飞牛收到新版本的OTA推送后，可能出现更新卡一半进度条的情况，只能被迫重启。重启后发现自行编译并加载的`mt7601u`模块消失了。不必紧张，我们重新加载模块即可。

我们编译后的模块应该还在内核源码中的`drivers/net/wireless/mediatek/mt7601u/mt7601u.ko`位置。

再次重复之前的操作：

```bash
sudo mkdir -p /lib/modules/$(uname -r)/kernel/drivers/net/wireless/mediatek/mt7601u/
sudo cp drivers/net/wireless/mediatek/mt7601u/mt7601u.ko \
   /lib/modules/$(uname -r)/kernel/drivers/net/wireless/mediatek/mt7601u/
sudo depmod -a
# 加载驱动
sudo modprobe mt7601u
```

> **建议**：将编译好的模块备份到安全位置（如`/home/backup/`目录），以便快速恢复。

## 希望以上内容可以帮助到你！

最近购买了一块明创控能 IOT-MKC3568-Main-v1.1开发板（基于RK3568-EVB1-DDR4-V10设计），但是这个开发板没有任何资料支持，连明创控能的官网都无法访问。经过一段时间的逆向研究，初步适配了Arm版本的飞牛v1.0.0固件，但开发板上的两个网口目前还处于无法使用的状态，设备树的适配仍在缓慢推进。

[Arm飞牛实战] 解决mt7601u无线网卡驱动缺失问题（Linux 6.12.41-trim内核编译教程）

硬件

网络与通信

操作系统

如何在明创控能RK3568开发板上编译MT7601U无线网卡驱动？本文详细介绍了在飞牛v1.0.0系统下获取内核源码、配置编译环境、解决模块依赖问题的完整流程，包含USB网络共享、模块安装、WiFi连接等实用技巧，帮助开发者解决开发板网络适配问题。

编译器

GitHub

Linux

ASIC

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

[Arm飞牛实战] 解决mt7601u无线网卡驱动缺失问题（Linux 6.12.41-trim内核编译教程）-腾讯云开发者社区-腾讯云

[Arm飞牛实战] 解决mt7601u无线网卡驱动缺失问题（Linux 6.12.41-trim内核编译教程）

[Arm飞牛实战] 解决mt7601u无线网卡驱动缺失问题（Linux 6.12.41-trim内核编译教程）

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐