查看“2004 CM4 WiFi7（WiFi7和WLANPi）”的源代码

== '''关键词''' ==
树莓派、CM4核心板、系统烧写、、WiFi6、WiFi7、5G、RPiOS、eMMC、OpenWrt、核心板、

== '''一、简介''' ==
CM4_WiFi7扩展板是一款基于树莓派CM4核心板设计的扩展板。CM4_WiFi7扩展板具有一个A-KEY接口用于外扩WiFi7；拥有一个千兆网口；具有一个标准尺寸的HDMI接口，支持4K输出；引出了1路CSI接口。外设扩展方面，扩展了1路原生USB2.0 OTG口，USB-A形态，支持eMMC版本CM4的烧写；1路USB-C供电接口；2路USB2.0主机接口（带1.25mm接口，可用来扩展CM4尺寸4G模组）。除此之外还有与树莓派4B相同定义的2.54mm间距2x20的GPIO引脚，用于常规外设扩展。

== '''二、硬件资源''' ==

== '''三、系统烧写及设置''' ==

=== 3.1 概述 ===
本文档采用树莓派OS、Ubuntu系统和OpenWrt系统进行测试。

树莓派OS的版本为2024-07-04-raspios-bookworm-arm64.img.xz，树莓派OS下载地址：

https://www.raspberrypi.com/software/operating-systems/#raspberry-pi-os-64-bit

Ubuntu系统的版本为ubuntu-24.04-preinstalled-desktop-arm64+raspi.img.xz，Ubuntu OS下载地址：

https://ubuntu.com/download/raspberry-pi

OpenWrt系统版本为：openwrt-bcm27xx-bcm2711-rpi-4-squashfs-sysupgrade-linux-6.1.100-20240805.img.gz

=== 3.2 从TF卡启动 ===
详细烧录方法请[[2003 CM4 Tiny HDMIx2（双HDMI扩展板）#3.2 从TF卡启动|点击这里]]。

=== 3.3 从eMMC启动 ===
详细烧录方法请[[2003 CM4 Tiny HDMIx2（双HDMI扩展板）#3.3. 从eMMC启动|点击这里]]。

=== 3.4 注意事项 ===
1. 如果Ubuntu系统启动后键盘鼠标无法使用，请在PC端打开TF卡系统分区根目录下的config.txt检查USB的初始化脚本，如果是烧写在eMMC上，则请在烧写完毕后，再次使用一次rpiboot工具使系统分区显示出来，然后打开系统分区根目录下的config.txt检查USB的初始化脚本：

http://www.mcuzone.com/wiki/0007_Zero_4G_Cat1/0007_Zero_4G_Cat1_41.jpg

需要确认下图中的两处红框的位置是否都配置成完全，如果没有，请手动添加完整并保存文件：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_10.jpg

2. Ubuntu系统的desktop版本对硬件要求较高，如果核心板只有1G内存，有可能在运行时速度很慢甚至死机，建议使用内存为2G或以上的核心板进行安装使用。

== '''四、树莓派OS下的使用演示''' ==

=== 4.1 WiFi7(BE200)驱动的安装和使用 ===
此操作也适用于AX210和AX200。

==== 4.1.1 更新系统和头文件 ====
在树莓派终端下执行：

<code>sudo apt-get update</code>

<code>sudo apt install -y raspberrypi-kernel-headers firmware-iwlwifi flex yacc</code>

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_01.jpg

==== 4.1.2 下载及解压源码 ====
在树莓派终端下执行：

<code>mkdir wifi && cd wifi</code>

<code>wget <nowiki>http://www.mcuzone.com/wiki/2004_CM4_WiFi7/backport-iwlwifi-20231029.tar.bz2</nowiki></code>

<code>sudo tar -xvf backport-iwlwifi-20231029.tar.bz2</code>

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_02.jpg

==== 4.1.3 准备编译环境 ====
在树莓派终端下执行：

<code>sudo make defconfig-iwlwifi-public</code>

<code>sudo sed -i 's/CPTCFG_IWLMVM_VENDOR_CMDS=y/# CPTCFG_IWLMVM_VENDOR_CMDS is not set/' .config</code>

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_03.jpg

==== 4.1.4 编译源码 ====
在树莓派终端下执行：

<code>sudo make -j 4</code>

<code>sudo make install</code>

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_04.jpg

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_05.jpg

此时提示重启系统。请先不要重启。

==== 4.1.5 安装固件 ====
在树莓派终端下执行：

<code>cd ..</code>

<code>cd Downloads</code>

<code>wget <nowiki>http://www.mcuzone.com/wiki/0011_MPW7/firmware_wifi7.zip</nowiki></code>

<code>unzip firmware_wifi7.zip</code>

<code>sudo cp iwlwifi-gl-c0-fm-c0-86.ucode /lib/firmware</code>

<code>sudo cp iwlwifi-gl-c0-fm-c0.pnvm /lib/firmware</code>

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_06.jpg

最后重启系统：

<code>sudo reboot</code>

==== 4.1.6 WiFi7(BE200)模块测试 ====
重启系统后，我们就可以在网络连接里面使用WiFi7模块连接无线AP了：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_07.jpg

在网络连接的信息中，我们也可以看到这个驱动为iwlwifi的网络连接：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_08.jpg

通过WiFi7模块连接上游路由器进行外网测速，结果如下：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_09.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

== '''五、Ubuntu系统下使用演示''' ==

=== 5.1 WiFi7(BE200)模块测试 ===
此操作也适用于AX210和AX200。

WiFi7(BE200)模块在Ubuntu系统下即插即用，系统启动后在屏幕右上角的“Wi-Fi”里即可看到这个WiFi7模块：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_11.jpg

点击需要连接的热点，连接成功后即可使用：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_12.jpg

通过WiFi7模块连接外网（200M宽带）测速，结果如下：

http://www.mcuzone.com/wiki/2004_CM4_WiFi7/2004_CM4_WiFi7_13.jpg

'''''注意：网络测速受网络环境和测试方法影响，速度请以实际为准，本测试仅供参考。'''''

如果使用Ubuntu内置的Firefox浏览器时运行速度很慢或者经常无响应，建议安装轻量浏览器Falkon：

<code>sudo apt install falkon</code>