Raspberry Pi 计算模块4 USB 大容量存储驱动程序

本页面提供了用于 Raspberry Pi 计算模块 4 的 USB 大容量存储驱动程序的相关信息。这些驱动程序允许您使用 Linux gadget-fs 驱动程序将常见的块设备（如 EMMC 和 NVMe）导出为 USB 大容量存储设备。

使用场景

使用这些驱动程序的主要用例是能够在主机计算机上运行 Raspberry Pi Imager，并将操作系统映像写入计算模块的块设备。

运行

要通过 RPIBOOT 加载 USB MSD 设备驱动程序，请运行以下命令：

cd mass-storage-gadget
../rpiboot -d .

注意： 与之前的大容量存储实现相比，这需要更长的时间来初始化。但是，由于所有文件系统代码都在 ARM 处理器上运行，因此写入速度应该更快。

调试

大容量存储设备映像会自动启用 UART 控制台以进行调试（用户名 root，密码为空）。

安全启动

如果已通过 OTP 锁定安全启动模式，则引导加载程序和 rpiboot bootcode4.bin 将仅加载使用客户私钥签名的 boot.img 文件。因此，将禁用对 rpiboot 大容量存储模式的访问。

您可以通过签署包含固件大容量存储驱动程序的引导映像来重新启用大容量存储模式。

注意： 通常应保护已签名的映像，因为它可以用于任何使用相同客户密钥签名的设备。

要签署大容量存储模式引导映像，请运行：

KEY_FILE=$HOME/private.pem
../tools/rpi-eeprom-digest -i boot.img -o boot.sig -k '${KEY_FILE}'

源代码

buildroot 配置和支持补丁可在 Raspberry Pi buildroot 存储库的 mass-storage-gadget 分支中找到。

构建

git clone --branch mass-storage-gadget git@github.com:raspberrypi/buildroot.git
cd buildroot
make raspberrypicm4io_initrd_defconfig
make

输出将写入 output/target/images/sdcard.img，您可以将其复制到 boot.img。