查看“2009 CM4/CM5 SSD WiFi6”的源代码

== '''关键词''' ==
树莓派、CM4核心板、千兆以太网、RPiOS、Ubuntu、SSD、NVMe SSD、PCIe、DSI、CSI、OV5647、WiFi6

== '''一、简介''' ==
CM4_SSD+WiFi6扩展板

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

== '''三、烧写系统''' ==
本文档采用树莓派OS和Ubuntu系统进行测试。

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

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

2. Ubuntu系统的版本为ubuntu-24.10-preinstalled-desktop-arm64+raspi.img.xz，

Ubuntu系统下载地址：

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

=== 3.1 TF卡的烧写 ===
树莓派CM4核心板分2个大类，一类是不带eMMC版本，仅限从TF卡启动系统；一类是带eMMC版本，仅限从eMMC启动系统，那对应扩展板上的TF卡将无效。

==== 3.2.1 使用树莓派镜像烧录器烧写 ====
首先在Windows端安装树莓派镜像烧录器，下载地址：https://www.raspberrypi.com/software/

安装完毕后将TF卡插入读卡器，读卡器插入PC的USB口，然后打开软件：

Raspberry Pi Device：选择Raspberry Pi 4；

请选择需要写入的操作系统：选择Raspberry Pi OS(64-bit)，为从树莓派官网下载系统镜像烧写（需联网）；选择Use Custom，则需要自行选择硬盘上已经下载的系统镜像（无需联网）；

储存卡：选择所需烧入的TF卡（即插在PC的USB接口的卡）；

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_01.jpg

选择完毕后按“'''NEXT'''”，建议点击“'''编辑设置'''”，将一些参数预设置进烧写软件，之后在系统启动时就不必再次设置，便于使用。

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_02.jpg

http://www.mcuzone.com/wiki/5001_CM5_WiFi7-PoE/5001_CM5_WiFi7-PoE_08.jpg

http://www.mcuzone.com/wiki/5001_CM5_WiFi7-PoE/5001_CM5_WiFi7-PoE_09.jpg

需要使用预设置的按“'''是'''”，不需要使用预设置的按“'''不'''”，进入下一页。

点击“'''是'''”，就开始烧写及验证完整性。

http://www.mcuzone.com/wiki/0005_MPS2242_2280/0005_MPS2242_2280_04.jpg

以上介绍的是烧写树莓派OS，烧写Ubuntu系统或者OpenWrt系统也是用类似的操作，只是在“请选择需要写入的操作系统”时，需要选择Use Custom，然后选择预先下载的镜像即可。

==== 3.2.2 使用balenaEtcher烧写 ====
首先在Windows端安装balenaEtcher，下载地址：https://etcher.balena.io/#download-etcher

将TF卡插入读卡器，读卡器插入PC的USB口，然后打开软件：

从文件烧录：选择预先下载的树莓派OS或者Ubuntu系统镜像；

选择目标磁盘：选择所需烧入的TF卡（即插在PC的USB接口的卡）；

然后点击“现在烧录！”，就开始烧录了，等待烧录完毕即可。

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_69.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_70.jpg

==== 3.2.3 启动系统 ====
烧写完毕后，将TF卡从读卡器中取下，插入CM4_SSD+WiFi6扩展板的TF卡卡槽，上电后即可进入系统。

=== 3.2 eMMC的烧写 ===
如果核心板具有板载eMMC，则系统将会忽略TF卡，而从eMMC启动。

要烧写系统到eMMC，首先需要在PC上安装驱动包，下载地址：

http://www.mcuzone.com/down/Software.asp?ID=10000623

然后使用跳线帽短接扩展板BOOT脚和GND脚（WiFi6接口旁边）：

01

使用'''''USB Type A-C数据线'''''将扩展板上的USB OTG接口（即扩展板的USB-C口）连接至电脑，连接上电脑之后，打开计算机的设备管理器，查看是否有新的USB设备出现。在下图中的是名称为“BCM2711 Boot”的USB设备：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_65.jpg

PC的开始菜单的所有程序下，Raspberry Pi下面有个rpiboot：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_66.jpg

打开这个软件，计算机会将emmc或者TF卡格式化并分区：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_68.jpg

稍等片刻，在资源管理器中会出现一个分区（本例中的分区名为bootfs，具体名称视实际情况而不同）：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_67.jpg

接下来我们就可以使用balenaEtcher软件对这个分区进行烧写了。

打开balenaEtcher软件，第一项点击“从文件烧录”，选择你要烧录到eMMC的文件，第二项选择上面的那个bootfs分区，然后点击“现在烧录”，就开始烧录文件了：

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_69.jpg

http://www.mcuzone.com/wiki/2001_CM4_Ultra/2001_CM4_Ultra_70.jpg

烧写完成后，把短路帽都拔掉，重新上电，启动系统即可。

=== 3.3 注意事项 ===
1. 如果使用树莓派系统，系统启动后卡死或者键盘鼠标无法使用，请在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/2006_CM4_UART_CAN/2006_CM4_UART_CAN_59.jpg

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

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

http://www.mcuzone.com/wiki/2006_CM4_UART_CAN/2006_CM4_UART_CAN_60.jpg

也可以将红框处这一行删除后保存文件：

http://www.mcuzone.com/wiki/2006_CM4_UART_CAN/2006_CM4_UART_CAN_61.jpg

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

== '''四、树莓派OS的操作''' ==

=== 4.1 测试USB口 ===

=== 4.2 测试SSD硬盘 ===

=== 4.3 测试WiFi6 ===

=== 4.4 测试以太网口 ===

=== 4.5 测试DSI ===

=== 4.6 测试CSI ===