如何快速安装 rpibootRaspberry Pi USB 启动完整指南【免费下载链接】usbbootRaspberry Pi USB device provisioning tool (RPIBOOT)项目地址: https://gitcode.com/gh_mirrors/us/usbbootrpiboot 是树莓派官方的 USB 启动工具来自 usbboot 仓库它让树莓派通过 USB 进入启动模式并在电脑上变成一个标准 U 盘。你可以直接对这个U 盘写入系统镜像也可以刷写 bootloader 固件、读取设备元数据。本文带你按三分钟跑通的节奏在 Linux、macOS、Windows 上完成 rpiboot 安装。哪些树莓派能用 rpiboot设备说明Pi Zero 2 W、Pi 3A、CM3/3/3E直接支持Pi 4B、Pi 400需先做一次 GPIO 设置见 FAQPi 5、Pi 500、Pi 500直接支持需按住电源键进模式CM4/4S、CM5需插上 EMMC-DISABLE 跳线Pi 1A、CM1、Pi Zero太老只能走 msd 旧固件接口三分钟快速上手三个平台的流程其实一样装依赖 → 克隆仓库 → make → 运行差异只在装依赖那一行。先克隆仓库。--recurse-submodules会把刷固件用的 rpi-eeprom 工具一起拉下来缺了它后续无法升级 EEPROMgit clone --recurse-submodules --shallow-submodules --depth1 https://gitcode.com/gh_mirrors/us/usbboot cd usbboot makemake 会自动把仓库里的固件二进制转成 C 头文件再编译不需要额外操作。编译完加 sudo 运行——rpiboot 要直接读写 USB 总线普通权限不够sudo ./rpiboot -d mass-storage-gadget命令不退出后给目标树莓派上电各设备的进入方式见 FAQ几秒内电脑就会出现一个 USB 磁盘。平台差异一张表平台装依赖编译备注Debian / Ubuntusudo apt install git libusb-1.0-0-dev pkg-config build-essentialmake系统时间要正确否则 git 可能报错Fedora / RHELsudo dnf install git libusb1-devel pkg-config glibc-devel g gcc makemake同上macOSbrew install libusb pkg-configmake INSTALL_PREFIX/usr/local装到 /usr/local避免和系统目录打架WindowsCygwin安装 Cygwin 时勾选 libusb1、gcc、makemake克隆前开符号链接并先装一次驱动分平台深水区Debian / Ubuntu一行装好依赖上面表格那行 apt 命令就是全部。make 找不到 xxd 时会改用自带的 bin2c.c 转换固件效果一样不用手动补装。macOSPKG_CONFIG_PATH 与 ARM 编译避坑编译报找不到 libusb.h是 pkg-config 没定位到 Homebrew 的 libusb。把下面这行加进当前终端再重跑 makeexport PKG_CONFIG_PATH$(brew --prefix libusb)/lib/pkgconfigApple Silicon 的 Mac 上如果报found architecture x86_64, required architecture arm64说明 Homebrew 的 libusb 是 x86 版。解决办法从 libusb 官方发布页下载 1.0.27 源码包依次执行./configure、make、make check然后sudo make INSTALL_PREFIX/usr/local install回到 usbboot 目录重新编译即可。WindowsCygwin符号链接和驱动Cygwin 下克隆前必须先开符号链接否则仓库里的软链会变成普通文本文件编译直接失败git config --global core.symlinks true另外到仓库 win32 目录运行一次 rpiboot_setup 驱动安装程序否则 Windows 认不出这条 USB 协议。基本用法与高频命令老设备Pi 1A、Pi Zero走旧固件接口速度慢但兼容性好sudo rpiboot -d msd刷 CM4 的 bootloader EEPROM 就指向 recovery 目录刷 Pi 5 用 recovery5两个目录都带说明文档。读取设备 OTP 元数据MAC、板子版本等cd recovery sudo rpiboot -j metadata -d .跑完会在当前目录生成 metadata/SERIAL_NUMBER.json。不想每次带-d参数把 rpiboot 装进系统目录sudo make installmacOS 记得带INSTALL_PREFIX/usr/local之后直接sudo rpiboot就会默认加载 mass-storage-gadget。仓库升级后记得同步子模块git pull --rebase origin master然后git submodule update --init。FAQ30 秒让 Pi 4B 支持 rpibootPi 4B / Pi 400 没有专用跳线要用工具生成一张 SD 卡写死 GPIO 选择。注意这一步永久写入 OTP、不可逆GPIO 在 2/4/5/6/7/8 里挑8 号一般最空闲sudo apt install kpartx sudo ./rpi-eeprom/imager/make-pi4-rpiboot-gpio-sd 8⚠️ Pi 5 / Pi 500 怎么进 USB 启动模式先彻底断电不是 shutdown按住电源键不放再插上 USB-C 线到主机。⚠️ CM4 / CM5 设备没反应先检查 EMMC-DISABLE / nRPIBOOT 跳线是否插好没插时 ROM 会去读 SPI EEPROMrpiboot 根本收不到设备。⚠️ 权限或 USB 报错优先加 sudo还不行就按 故障排除文档 里设备没反应 / 驱动冲突 / 固件版本三类原因排查。下一步装好 rpiboot 只是拿到钥匙能开的门有这些树莓派 USB 写系统目标设备变成 U 盘后用官方镜像写入工具挑一个系统镜像刷进去重启即得完整系统。刷固件-d recoveryCM4或-d recovery5Pi 5配合 rpi-eeprom 更新 SPI EEPROM。安全启动参考 secure-boot 文档用 secure-boot-recovery 目录配置 OTP 与签名链。嵌入式 Imagerrpi-imager-embedded 目录可让目标设备自己跑图形化写盘界面适合批量部署。【免费下载链接】usbbootRaspberry Pi USB device provisioning tool (RPIBOOT)项目地址: https://gitcode.com/gh_mirrors/us/usbboot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考