树莓派硬件
介绍
树莓派推出多个不同 系列 的计算机:
经典型单板计算机(SBC)。经典的树莓派 SBC 系列搭载高性能硬件、完整的 Linux 操作系统及多种常见接口,外形尺寸与信用卡大小相当。
Zero。外形小巧、价格实惠的型号,提供完整的 Linux 操作系统和基本接口,功耗低。
键盘计算机(X00)。将 SBC 硬件、完整的 Linux 操作系统及常见接口集成在紧凑的键盘机箱中。
计算模块(CM)。为嵌入式和工业应用设计的板卡,硬件与经典型 SBC 相同,但外形更小且没有板载接口。计算模块需连接到一块单独的基板上,由基板提供必要的端口和引脚。
树莓派 Pico。小巧多用途的微控制器开发板,不运行 Linux。Pico 不使用可移动存储,而是将程序直接刷写到板载存储器中。Pico 微控制器非常适合实时控制和轻量级嵌入式项目。
产品合规性和安全性
所有树莓派产品都经过充分的合规测试。更多信息,请参阅产品信息门户。
阻燃等级
树莓派设备使用的 PCB 符合 UL94-V0 标准。
注意
仅适用于 PCB。
树莓派合规支持
合规支持计划旨在消除处理合规问题的负担,让公司更容易将新产品推向消费者。该计划让你能够联系到在树莓派设备合规测试期间负责测试的同一批测试工程师,并为你对接 UL的专门团队。他们凭借对树莓派的深入了解,评估和测试你的产品。
了解更多关于树莓派合规支持计划的信息。
由树莓派提供支持
Powered by Raspberry Pi 计划为希望以某种形式使用树莓派 logo 的公司提供了一个流程,涵盖内置树莓派计算机或芯片的产品,以及由树莓派设备提供的服务。如果你希望申请,可以在线操作。
已审批的设计合作伙伴
我们的已审批的设计合作伙伴名单列出了一组与我们密切合作并提供支持的咨询公司,这些公司能够在硬件、软件和机械领域提供付费设计服务。
频率管理和发热控制
在重负荷情况下,所有树莓派型号都会进行一定程度的发热管理,以避免过热。SoC 内置了温度传感器,GPU 上的软件会对其进行轮询,确保温度不超过我们设定的上限:所有型号均为 85°C。可以将此值设定为较低值,但不能提高上限。当设备接近上限时,芯片(Arm、GPU)使用的各种频率,有时还有电压,都会降低。这会减少产生的热量,使温度保持在可控范围内。
当核心温度在 80°C 到 85°C 之间时,Arm 核心会逐渐降频。如果温度达到 85°C,Arm 核心和 GPU 都会降频。
树莓派 3B+ 更换了 PCB 技术,以提供更好的散热性能,并增大热质量。此外还引入了软温度限制,目的是尽可能延长设备在达到 85°C 硬限制之前“冲刺”运行的时间。达到软限制时,时钟速度从 1.4 GHz 降至 1.2 GHz,并略微降低工作电压。这减缓了温度升高的速度:以短暂的 1.4 GHz 运行换取更长时间的 1.2 GHz 运行。默认情况下,软限制为 60°C,可通过 config.txt 中的 temp_soft_limit 参数更改。
树莓派 4B 沿用了树莓派 3B+ 的 PCB 技术,以帮助散发热量。目前没有定义软限制。
使用 DVFS
注意
此 DVFS 讨论仅适用于 4 系列设备(树莓派 4B、计算模块 4、计算模块 4S 和树莓派 400)。
树莓派 4 系列设备实现了动态电压频率调节(DVFS)。这项技术让 4 系列设备在保持相同性能的同时以更低的温度运行。
固件会监控 SoC 内部的各种时钟(例如 Arm、Core、V3D、ISP、H264、HEVC)。只要它们未全速运行,供给该时钟所驱动芯片部分的电压就会相应降低。实际上,只需提供足够的电压,就能让该模块以当前速度正常运行。这可以显著降低 SoC 的功耗,从而减少总发热量。
由于欠压运行可能引发系统稳定性问题,尤其是在使用欠压的固定时钟外设(例如 PCIe)时,因此提供了三种 DVFS 模式,可在 /boot/firmware/config.txt 中通过以下属性配置。大多数设备应使用 dvfs=3;无显示设备的系统可能会因功耗略有降低而从 dvfs=1 受益,但会面临 PCIe 稳定性问题的风险。
属性=值
说明
dvfs=1
允许欠压
dvfs=2
固定默认操作频率的电压
dvfs=3
按需增加超频电压(默认)。如在 config.txt 中指定了 over_voltage,则会禁用动态电压调节,即让设备退回 dvfs=2。
注意
5 系列设备移除了该设置,实际上始终为模式 3。
此外,还采用了步进更多的 CPU 调频策略(governor),以便更精细地控制 Arm 核心频率,从而让 DVFS 更有效。现在的步进频率为 1500 MHz、1000 MHz、750 MHz 和 600 MHz。这些步进在 SoC 降频时也可能有帮助,意味着降频时几乎不会一路降到 600 MHz,从而整体提升满载性能。
默认的 CPU 调频策略是 ondemand。可以使用 cpufrequtils 软件包中的 cpufreq-set 命令手动更改调频策略,以减少空闲功耗:
测量温度
由于树莓派设备所用 SoC 的架构,以及树莓派系统发行版使用上游温度监控代码,基于 Linux 的温度测量可能并不准确。不过,vcgencmd 命令能提供准确且即时的当前 SoC 温度读数,因为它直接与 GPU 通信:
添加散热片
得益于内置的降频功能,不安装散热片也不会导致 SoC 过热损坏。不过,散热片或小型风扇可以减少热降频并提升性能。将树莓派竖直放置可获得最佳气流,从而略微改善散热效果。
风扇机箱
为确保树莓派发挥最佳性能,请使用主动散热方案,例如风扇。树莓派固件会管理所有官方风扇的转速。
树莓派 4 风扇
对于树莓派 4,请将树莓派 4 机箱风扇安装到树莓派 4 机箱的顶盖上。
该风扇额定电流为 0.18 A,通过 40 针 GPIO 排针以 5 V 直流供电,通常消耗 60 mA(300 mW)。
树莓派 5 风扇
对于树莓派 5,请使用以下官方风扇之一:
两款树莓派 5 风扇都插在主板右上方的四针 JST-SH PWM 风扇连接器上,该连接器位于 40 针 GPIO 排针和 USB 2.0 端口之间。
风扇连接器与 USB 外设共用同一电流限额。
官方机箱风扇在 5 V 下约消耗 60 mA(300 mW)。
鉴于主动散热器具有更强的散热性能,我们推荐希望超频树莓派 5 的用户使用它。
风扇会根据 SoC 温度按计划开启和关闭。默认温度映射如下:
低于 50°C:风扇完全不转(0% 速度)。
50°C:风扇以低速开启(30% 速度)。
60°C:风扇转速提高到中速(50% 速度)。
67.5°C:风扇转速提高到高速(70% 速度)。
75°C:风扇达到全速(100% 速度)。
温度下降时采用相同的映射,并带有 5°C 的 滞后;只有当温度降到上述每个阈值以下 5°C 时,风扇转速才会降低。
注意
上述温度、滞后和转速数值可通过各种
fan_tempN、fan_tempN_hyst和fan_tempN_speeddtoverlay 设置调整(其中N为 0、1、2 或 3)。完整详情请参阅叠加层 README。例如,向/boot/firmware/config.txt添加dtparam=fan_temp0=55000后,树莓派 5 的温度达到 55°C 之前风扇将保持关闭。
启动时,风扇会开启,系统随后检查转速计输入,以确认风扇是否在转动。如果风扇在转,就启用 cooling_fan 设备树叠加层。该叠加层默认位于 bcm2712-rpi-5-b.dtb 中,但状态为 status=disabled。
树莓派 5 风扇连接器引脚图
树莓派 5 风扇连接器是一个间距 1 mm 的 JST-SH 插座,包含以下四个引脚:
1
+5V
红
2
PWM
蓝
3
GND
黑
4
Tach
黄
树莓派引导 EEPROM
以下树莓派型号使用 EEPROM 来启动系统:
树莓派 4B 起的旗舰型号
CM4 起的计算模块型号(包括 CM4S)
树莓派 400 起的键盘型号
其他所有型号的树莓派计算机使用位于启动文件系统中的 bootcode.bin 文件。
注意
你可以在 rpi-eeprom GitHub 仓库中找到用于创建
rpi-eeprom的脚本和预编译二进制文件。
重置树莓派引导加载程序
本节介绍通过重新烧录引导加载程序来将其重置的操作步骤。你通常在系统无法启动或想重置引导加载程序配置时执行此操作。
如果你不想重置引导加载程序,而是想升级引导加载程序版本或选择不同的引导顺序,请参阅系统配置页面中的更新引导加载程序。
以下说明仅适用于将引导加载程序存储在板载 SPI 闪存 EEPROM 中的较新树莓派型号:
树莓派 4B 起的旗舰单板计算机(SBC)。
CM4 起(包括 CM4S)的计算模块。
所有键盘计算机(树莓派 400、500 和 500+)。
在其他树莓派型号上,引导 ROM 始终从启动介质的启动分区中加载 bootcode.bin 文件。
诊断引导加载程序问题
如果你的树莓派设备无法启动,引导加载程序会通过以下方式提供反馈:
LED 活动:树莓派上的绿色 LED 会以特定模式闪烁,以指示特定错误。请参阅查看 LED 警告代码,根据闪烁模式识别错误。例如,绿色 LED 短闪七次表示未找到内核镜像。
HDMI 诊断屏幕:在较新的设备上,引导加载程序可以在启动过程中通过 HDMI 显示诊断屏幕。如果你为树莓派连接了显示器,该屏幕会提供诸如引导加载程序版本和构建日期、检测到的引导顺序等信息,以及操作系统加载失败时的特定错误代码。更多信息,请参阅树莓派 4 的启动诊断。
重新烧录引导加载程序
如果系统无法启动,或者你想重置引导加载程序配置,请重新烧录引导加载程序。重新烧录引导加载程序会清除所有可能阻止树莓派启动的本地引导加载程序配置。
注意
你也可以使用 USB
rpiboot重新烧录引导加载程序。此方法通常用于批量预配计算模块。通过 USB 重新烧录引导加载程序也是 CM4 和 CM4S 唯一可用的方式。更多信息,请参阅计算模块硬件。
要在树莓派设备上重新烧录引导加载程序:
将一张备用或空的存储卡连接到你的主机计算机。
在主机计算机上找到并打开树莓派启动盘制作工具。
在 设备(Device) 选项卡中,从列表中选择你的树莓派型号,然后选择 下一步(Next)。
在 操作系统(OS) 选项卡中,滚动到列表底部,选择 其他工具镜像(Misc utility images)> 引导加载程序(Bootloader)> 存储卡启动(SD Card Boot),然后选择 下一步(Next)。
在 存储(Storage) 选项卡中,选择你的存储设备,然后选择 下一步(Next)。
在 写入(Writing) 选项卡中,选择 写入(Write)。
选择 我明白,擦除并写入(I understand, erase and write);等待写入完成,然后选择 完成(Finish)。
从主机计算机中弹出存储设备,然后将其插入你的树莓派。
通过接通电源来启动你的树莓派。
当绿色活动 LED 开始以固定节奏闪烁,且 HDMI 显示器显示绿屏后,断开电源并取出启动介质,关闭树莓派。
更新引导加载程序配置
引导加载程序的 default 版本即最新的出厂默认固件镜像。它会持续更新,以提供关键的错误修复和硬件支持,并在新功能于 latest 版本中经过测试后定期跟进。latest 引导加载程序的更新更为频繁,包含最新的修复和改进。
高级用户可以切换到 latest 引导加载程序以获取最新功能。
首先,确保你的树莓派运行最新的软件。运行以下命令进行更新:
接下来,运行以下命令打开 raspi-config:
导航到 Advanced Options > Bootloader Version。选择 Latest,然后选择 Yes 确认。选择 Finish 并确认你要重启。
如果你运行 sudo rpi-eeprom-update,应该会看到有更新版本的引导加载程序可用,且它是 latest 发布版本:
现在你可以更新引导加载程序了。
重启,然后运行 sudo rpi-eeprom-update。现在你应该看到 CURRENT 日期已更新为引导加载程序的最新版本:
查看当前引导加载程序配置
要查看当前运行的引导加载程序使用的配置,请运行以下命令:
从引导加载程序镜像中读取配置
要从引导加载程序镜像中读取配置:
编辑当前引导加载程序配置
以下命令会把当前引导加载程序配置加载到文本编辑器中。当编辑器关闭时,rpi-eeprom-config 会将更新后的配置应用到最新的可用引导加载程序版本,并使用 rpi-eeprom-update 安排在系统重启时进行更新:
如果更新后的配置相同或为空,则不会进行任何更改。
应用已保存的配置
以下命令将 boot.conf 应用到最新的可用引导加载程序镜像,并使用 rpi-eeprom-update 安排在系统重启时进行更新:
自动更新
rpi-eeprom-update 的 systemd 服务会在启动时运行,并在有新镜像可用时自动迁移当前的引导加载程序配置并应用更新。
要禁用自动更新:
要重新启用自动更新:
注意
如果设置了引导加载程序配置
FREEZE_VERSION,更新服务会跳过所有自动更新。这样就无需在安装了多个操作系统、或更换存储卡时逐个禁用更新服务。
rpi-eeprom-update
树莓派系统使用 rpi-eeprom-update 脚本实现自动更新服务。该脚本也可以交互式运行,或进行封装以创建自定义的引导加载程序更新服务。
读取当前引导加载程序版本:
检查是否有可用更新:
安装更新:
取消待处理的更新:
安装特定的引导加载程序镜像:
-d 参数让 rpi-eeprom-update 使用指定镜像文件中的配置,而不是自动迁移当前配置。
显示内置文档:
A/B 引导加载程序更新
A/B EEPROM 引导加载程序更新可避免树莓派设备在更新中断后无法启动,即使更新过程中断电也能保护设备。
支持 A/B 的固件会将 EEPROM 分为 A 和 B 两个分区。任何时候,都有一个分区处于“已提交”状态,即设备默认从中启动的分区。更新会写入另一个分区,在新镜像完整写入并检查完毕之前,保持已提交的分区不变。
它仅兼容树莓派 5、树莓派计算模块 5 和树莓派 5 键盘计算机设备。
支持 A/B 的固件还支持 tryboot 回退机制,可以在提交到新分区之前先测试该分区。更多信息,请参阅 rpi-eeprom-ab README。
有关树莓派系统的 A/B 更新信息,请参阅A/B 启动更新。
启用 A/B 引导加载程序更新
注意
启用 A/B 固件更新后,直接写入 EEPROM 的工具(例如
flashrom)将无法工作。
要通过 raspi-config 启用或禁用 A/B 固件更新:
在命令行中运行以下命令,将树莓派软件更新到最新版本:
在命令行中运行以下命令打开
raspi-config:导航到
6 Advanced Options > A14 AB Firmware,选择Enable或Disable。选择
Finish,并在出现提示时重启。在命令行中运行以下命令执行 A/B 更新:
引导加载程序发布状态
固件发布状态对应于引导加载程序固件镜像(/lib/firmware/raspberrypi/bootloader/...)的特定子目录,可以更改它以选择不同的发布流。
default——在需要新硬件支持、关键错误修复时更新,并定期纳入已在latest版本中测试过的新功能。latest——在有新功能可用时更新。
由于发布状态字符串只是一个子目录名,你可以创建自己的发布流,例如固定的发布版本或自定义网络引导配置。
更改引导加载程序发布版本
注意
你可以编辑
/etc/default/rpi-eeprom-update文件,将FIRMWARE_RELEASE_STATUS条目改为相应的发布流,从而更改更新期间使用的发布流。
更新引导加载程序镜像文件中的引导加载程序配置
以下命令将 pieeprom.bin 中的引导加载程序配置替换为 boot.conf,并将新镜像写入 new.bin:
recovery.bin
开机时,BCM2711 和 BCM2712 上的 ROM 会在存储卡启动分区的根目录中查找名为 recovery.bin 的文件。如果找到有效的 recovery.bin,ROM 会执行它,而不是 EEPROM 中的内容。该机制确保引导加载程序闪存镜像始终能通过出厂默认设置重置为有效镜像。
有关更多信息,请参阅EEPROM 引导流程。
引导加载程序更新文件
recovery.bin
引导加载程序恢复可执行文件
pieeprom.upd
引导加载程序 EEPROM 镜像
pieeprom.bin
引导加载程序 EEPROM 镜像——与 pieeprom.upd 相同,但会改变 recovery.bin 的行为,使其不再将自己重命名为 RECOVERY.000
pieeprom.sig
引导加载程序镜像(pieeprom.upd/pieeprom.bin)的 sha256 校验和(及可选的时间戳)
vl805.bin
VLI805 USB 固件 EEPROM 镜像——仅适用于树莓派 4B 修订版 1.3 及更早版本
vl805.sig
vl805.bin 的 sha256 校验和
如果引导加载程序更新镜像名为
pieeprom.upd,则更新完成后recovery.bin会被重命名为recovery.000,然后系统重启。由于recovery.bin不再存在,ROM 会从 SPI 闪存加载新更新的引导加载程序,并正常启动操作系统。如果引导加载程序更新镜像名为
pieeprom.bin,则更新完成后recovery.bin会停止运行。成功时 HDMI 输出为绿屏,绿色活动 LED 快速闪烁;失败时 HDMI 输出为红屏,且活动 LED 会显示错误代码。.sig文件的第一行包含相应镜像文件的十六进制 sha256 校验和,下一行可选地包含镜像的时间戳(ts: unixtime);将来可能会添加其他字段。BCM2711 和 BCM2712 上的 ROM 不支持从 USB 大容量存储设备或 TFTP 加载
recovery.bin。相反,较新版本的引导加载程序支持自更新机制,引导加载程序可以自己重新烧写 SPI 闪存。请参阅树莓派引导加载程序配置中的ENABLE_SELF_UPDATE。EEPROM 更新的临时文件会在启动时由
rpi-eeprom-update服务自动删除。
要获取有关 rpi-eeprom-update 配置文件的更多信息,请参阅 rpi-eeprom-update -h。
EEPROM 写保护
引导加载程序和 VLI EEPROM 都支持硬件写保护。有关如何在烧录 EEPROM 时启用此功能的更多信息,请参阅 eeprom_write_protect 选项。
树莓派 4 的启动诊断
树莓派 4 及之后旗舰型号上的引导加载程序可以在启动时通过 HDMI 显示器显示诊断信息。要查看诊断信息,请关闭树莓派,断开启动介质(通常是存储卡或固态硬盘),然后重新开机。如果树莓派连接了显示器,你应该会看到类似如下的诊断信息:

如果引导加载程序无法从任何启动介质或网络引导,也会显示该诊断页面。原因可能是启动介质上没有可引导的镜像、启动介质已损坏,或网络引导参数不正确。
要在显示诊断页面的同时重启,请对设备断电再上电:可以断开电源后再重新接上;如果你的设备有电源按钮,也可以长按电源按钮。
诊断页面最顶部的一行说明了树莓派型号和内存容量。二维码是指向下载页面的链接。
诊断信息如下:
bootloader
引导加载程序 git 版本—RO(如果 EEPROM 受写保护)—软件构建日期
update-ts
更新 EEPROM 配置的时间戳。在自更新模式下检查此时间戳,以避免更新到旧配置。
secure-boot
如果启用了安全启动,则显示处理器版本(B0/C0)和签名启动状态标志。否则,此行为空。
board
主板版本–序列号–以太网 MAC 地址
boot
模式(当前启动模式的名称和编号)、顺序(BOOT_ORDER 配置)、重试(当前启动模式的重试次数)、重启(遍历启动模式列表的循环次数)。
SD
SD 卡检测状态(已检测/未检测)。
part
主引导记录主分区类型:LBA。
fw
如果存在,则显示 start.elf 和 fixup.dat 的文件名(例如 start4x.elf、fixup4x.dat)。
net
网络引导:链路状态(上/下)、客户端 IP 地址(ip)、子网(sn)、默认网关(gw)
tftp
网络引导:TFTP 服务器 IP 地址
display
指示是否检测到热插拔(HPD=1),以及每个 HDMI 输出是否成功读取 EDID(EDID=ok)。
要禁用该诊断显示,请使用引导加载程序配置中的 DISABLE_HDMI 选项。
树莓派引导模式
树莓派有多种不同的引导阶段。本文档解释了引导模式的工作原理,以及哪些引导模式支持 Linux 引导。
特殊的仅 bootcode.bin 启动模式
基于 BCM2837 的树莓派可以进行 USB 主机引导和以太网引导——也就是说,树莓派 2B v1.2、树莓派 3B 和树莓派 3B+(树莓派 3A+ 没有内置以太网接口,因此无法进行网络引导)。此外,所有早于树莓派 4 的树莓派型号都可以使用仅依赖 bootcode.bin 的方法启用 USB 主机引导。
注意
从树莓派 4 开始,旗舰级设备不再使用
bootcode.bin这个文件,而是改用板载 EEPROM 芯片中的引导加载程序。更多信息,请参阅 EEPROM 引导流程和 SPI 引导 EEPROM 的文档。
将存储卡格式化为 FAT32,并把最新的 bootcode.bin 复制进去。树莓派启动时必须插着这张存储卡。从存储卡加载 bootcode.bin 后,树莓派会继续以 USB 主机模式启动。
这对基于 BCM2835 和 BCM2836 芯片的树莓派 1、2 和 Zero 型号很有用,也适用于树莓派 3 无法启动的情况(与烧录在 BCM2837A0 中的启动代码相比,最新的 bootcode.bin 为树莓派 3B 提供了额外的错误修复)。
如果用了这个 bootcode.bin 之后,大容量存储设备仍然无法正常工作,请在存储卡上新建一个名为 timeout 的文件。这会把等待大容量存储设备初始化的时间延长到 6 秒。
启用 bootcode.bin 串口
注意
适用于树莓派 4 之前发布的开发板。
有关使用 EEPROM 引导加载程序启用串口的信息,请参阅引导加载程序配置文档。
可以启用早期阶段的串口来调试引导问题(对上述仅 bootcode.bin 引导模式很有用)。为此,请确保固件是最新版本(包括 bootcode.bin)。要检查当前固件是否支持串口:
要从 bootcode.bin 启用串口:
接下来,将合适的 USB 串口线连接到主机(树莓派本身也可以作为主机,不过最简单的办法往往是直接用 USB 串口线,因为它开箱即用,无需任何 config.txt 设置)。在树莓派或计算模块上使用标准引脚 6、8 和 10(GND、GPIO14、GPIO15)。
然后在 Linux 或 macOS 上使用 screen,在 Windows 上使用 putty 连接串口。
将串口接收参数设置为 115200-8-N-1,然后启动树莓派。bootcode.bin 运行时,你应该会立即从设备收到串口输出。
USB 启动模式
USB 有两种独立的启动模式:
USB 设备启动
USB 主机启动
固件在启动时会根据 OTP 位在两种模式之间选择。USB 引导由两个位控制:第一位启用 USB 设备引导,默认已启用;第二位启用 USB 主机引导。
如果设置了 USB 主机引导模式位,处理器会读取 OTGID 引脚,决定是作为主机引导(零电平,与所有树莓派 B/B+ 型号一样)还是作为设备引导(保持悬空)。树莓派 Zero 通过 USB 连接器引出 OTGID 引脚;计算模块通过边缘连接器引出 OTGID 引脚。
其他某些 OTP 位可允许某些 GPIO 引脚选择引导模式。
USB 设备引导模式
注意
USB 设备引导适用于计算模块系列、Zero 系列,以及经典型单板计算机的 A 款型号。
启用此引导模式后(通常是在无法从存储卡启动之后),树莓派会把 USB 端口置于设备模式,等待主机发出 USB 复位。在 GitHub 上可以找到示例代码,说明主机如何与树莓派通信。
主机首先通过控制端点 0 向设备发送一个结构体,其中包含引导镜像的大小和签名(未启用安全机制,因此不需要签名)。随后,代码通过端点 1 传输(bootcode.bin)。最后,设备会返回以下代码之一:
0:成功0x80:失败
USB 主机引导模式
注意
主机引导适用于计算模块 3 及之后的计算模块系列、Zero 2 W 及之后的 Zero 系列、树莓派 2B(1.2 版)、树莓派 3B,以及树莓派 3B+ 及之后的所有经典型单板计算机。树莓派 3A+ 支持大容量存储引导,但不支持网络引导。
USB 主机引导模式采用以下逻辑:
启用 USB 端口并等待 D+ 线被拉高,表示连接了 USB 2.0 设备(我们只支持 USB 2.0)
如果设备是集线器:
为集线器的所有下游端口供电
对于每个端口,最多等待两秒(如果设置了
program_usb_boot_timeout=1,则为五秒)解除复位并等待 D+ 被拉高,以指示设备已连接
如果检测到设备:
发送“获取设备描述符”
如果
VID == SMSC并且PID == 9500将设备添加到以太网设备列表
如果接口类别为大容量存储类
将设备添加到大容量存储设备列表
否则
枚举单个设备
遍历大容量存储设备列表
从大容量存储设备启动
遍历以太网设备列表
从以太网启动
在树莓派 3B、3A+ 和 3B+ 上,默认禁用主机引导。要启用 USB 主机引导,请在 /boot/firmware/config.txt 末尾添加一行 program_usb_boot_mode=1。
警告
你对 OTP 所做的任何修改都是永久性的,无法撤销。
在树莓派 3A+ 上,将 OTP 位设置为启用 USB 主机引导模式,会永久性地禁止该树莓派以 USB 设备模式启动。
USB 大容量存储启动
注意
适用于计算模块 3 及之后的计算模块系列、Zero 2 W 及之后的 Zero 系列,以及树莓派 2B(1.2 版)及之后的所有经典型单板计算机。
USB 大容量存储启动能让你从 USB 大容量存储设备(如闪存驱动器、USB 磁盘)启动树莓派。连接 USB 设备时(尤其是硬盘和 SSD),要注意它们的功耗要求。接入多个磁盘通常需要额外的外部电源,例如带电源的硬盘盒或带供电的 USB 集线器。
注意
树莓派 4B 之前的型号存在已知问题,会导致无法从某些 USB 设备启动。
带有 EEPROM 引导加载程序的设备
树莓派 4 及更新的经典型单板计算机,以及计算模块 4 和 4S 及之后的计算模块设备,默认支持 USB 引导,只需在 BOOT_ORDER 配置中指定 USB 引导。
注意
早期版本的树莓派 4 可能需要更新引导加载程序才能从 USB 启动。
注意
计算模块 4 的早期版本可能需要更新引导加载程序才能从 USB 启动。
树莓派 3B+、Zero 2 W
树莓派 3B+ 和 Zero 2 W 开箱即支持 USB 大容量存储启动。
注意
树莓派 Zero 2 W 不支持网络引导。
树莓派 2B、3A+、3B、CM3、CM3+
在树莓派 2B v1.2 和 v1.3、3A+、3B,以及计算模块 3 和 3+ 上,必须先启用 USB 主机引导模式。启用后才能进行 USB 大容量存储引导和网络引导。
注意
树莓派 3A+ 不支持网络引导。
要启用这些设备的 USB 主机引导模式,请在 OTP(一次性可编程)内存中设置 USB 主机位。要设置该位,请从一张存储卡启动,并让卡上的 /boot/firmware/config.txt 包含 program_usb_boot_mode=1 这一行。设置该位后,你无需存储卡即可从 USB 启动。
使用 OTP 启用 USB 主机启动模式
警告
你对 OTP(一次性可编程)内存所做的任何修改都是永久性的,无法撤销。
在树莓派 3A+ 上,设置 OTP 位来启用 USB 主机引导模式,会永久禁止该树莓派以 USB 设备模式启动。
用任意一张烧录了树莓派系统的存储卡来烧写 OTP 位。
要启用 USB 主机引导模式,请将以下行添加到 config.txt 中:
然后使用 sudo reboot 重启你的树莓派。要检查 OTP 是否已正确烧写,请运行以下命令:
如果输出显示 0x3020000a,则 OTP 已成功烧写。如果看到不同的输出,请重新执行烧写步骤。确保 config.txt 末尾没有空行。
你现在可以像从存储卡启动一样从 USB 大容量存储设备启动。有关更多信息,请参阅以下部分。
从 USB 大容量存储设备启动
过程与存储卡相同:把操作系统镜像写入 USB 存储设备。
存储设备准备就绪后,连接驱动器并启动树莓派,需注意外部驱动器的额外 USB 电源需求。
大约 5 到 10 秒后,树莓派应该开始启动,并在接入的显示器上显示彩虹屏。请确保树莓派中没有插入存储卡,否则它会优先从存储卡启动。
关于引导顺序和其他引导模式(网络、USB 设备、GPIO 或存储卡),请参阅引导模式文档。
已知问题
检查可引导 USB 设备的默认超时时间为 2 秒。某些闪存驱动器和硬盘启动速度过慢。可以将此超时时间延长到 5 秒(需在存储卡中新建文件
timeout),但要注意某些设备可能需要更长时间来响应。某些闪存驱动器有非常特殊的协议要求,引导代码无法处理,因此可能不兼容。
特殊的仅 bootcode.bin 引导模式
对于树莓派 2B v1.2、3A+、3B 和 3B+,如果某台 USB 设备无法用于启动树莓派,你可以改用仅依赖 bootcode.bin 的引导模式。树莓派仍会从存储卡启动,但只从存储卡读取 bootcode.bin;操作系统的其余部分仍位于 USB 设备上。
硬件兼容性
在从 USB 大容量存储设备启动之前,请验证该设备在 Linux 下能否正常工作。先用存储卡启动,再插入 USB 大容量存储设备,它应该显示为可移动驱动器。这对 USB SATA 转接器尤其重要:引导加载程序在大容量存储模式下可能支持这类设备,但如果 Linux 选择 USB Attached SCSI-UAS 模式,就会失败。
使用硬盘驱动器(HDD)通常需要带供电的 USB 集线器。即使一切看起来正常,如果没有带供电的 USB 集线器,仍可能遇到间歇性故障。
多个可引导驱动器
在搜索可引导分区时,引导加载程序会并行扫描所有 USB 大容量存储设备,并选择首个响应的设备。如果引导分区中没有合适的 start.elf 文件,引导加载程序会尝试下一个可用设备。无法根据 USB 拓扑结构指定引导设备;这样做会拖慢启动,并增加不必要的配置复杂性。
注意
可使用
config.txt文件的条件过滤器来选择复杂设备配置中的备用固件。
网络引导
本节描述了树莓派 3B、3B+ 和 2B v1.2 上的网络引导工作原理。
在树莓派 4 和树莓派 5 上,网络引导是在 EEPROM 中的第二阶段引导加载程序中实现的。更多信息,请参阅树莓派引导加载程序配置。
我们还有一篇设置网络引导系统的教程。
网络引导仅适用于上述树莓派型号内置的有线网卡。不支持通过无线局域网引导,也不支持从其他有线网络设备引导。
网络引导流程
要进行网络引导,引导 ROM 执行以下操作:
初始化板载以太网设备(Microchip LAN9500 或 LAN7500)
发送 DHCP 请求(将厂商类别标识符 DHCP 选项 60 设置为
PXEClient:Arch:00000:UNDI:002001)接收 DHCP 回复
(可选)接收 DHCP 代理回复
向
tftpboot服务器发送 ARPARP 回复中包含
tftpboot服务器的以太网地址TFTP RRQ
bootcode.bin文件不存在:服务器返回 TFTP 错误响应,并附带文本错误消息
文件存在:服务器回复该文件的第一个数据块(512 B),并在头部带上块编号
树莓派回复包含块编号的 TFTP ACK 数据包,如此重复,直到最后一个不足 512 B 的块
TFTP RRQ
bootsig.bin这通常会产生报错
file not found。这是预料之中的,TFTP 引导服务器应该能够处理它。
从此刻开始,bootcode.bin 代码继续加载系统。它将尝试访问的第一个文件是 <serial_number>/start.elf。如果这次访问没有出错,之后要读取的其他文件都会加上 serial_number 前缀。这很有用,因为你可以为不同的树莓派设备分别创建目录,放置各自的 start.elf 和内核。
要获取设备的序列号,你可以用这种引导模式启动,并通过 tcpdump 或 Wireshark 查看访问了哪个文件;也可以用一张装有树莓派系统的标准存储卡启动,然后运行 cat /proc/cpuinfo。
如果你把所有文件都放在 TFTP 目录的根目录下,那么后续文件都会从那里读取。
调试网络引导模式
首先要检查的是 OTP 位是否被正确编程。为此,你需要将 program_usb_boot_mode=1 添加到 config.txt,然后重启(使用可以正确引导到树莓派系统的标准存储卡)。完成后,你应该可以执行以下操作:
如果第 17 行包含 3020000a,则 OTP 已正确编程。现在,你可以拔掉存储卡,插入以太网了,然后在树莓派上电约 5 秒后,以太网指示灯应该被点亮。
要在服务器上捕获以太网数据包,请在 tftpboot 服务器上(如果未使用,则在 DHCP 服务器上)使用 tcpdump。否则,你将无法看到发送的数据包,因为网络交换机不是集线器!
将从 eth0 写入文件 dump.pcap 中的所有内容。然后,你可以对数据包进行后处理或上传到 cloudshark 进行通信。
DHCP 请求/响应
至少你应该看到一个类似以下内容的 DHCP 请求和回复:
Vendor-Option Option 43 包含了回复的重要部分。这个部分必须包含字符串“Raspberry Pi Boot”。由于引导 ROM 中的一个错误,你可能需要在字符串末尾添加三个空格。
TFTP 文件读取
当供应商参数被正确指定时,你将看到随后发送的 TFTP RRQ 数据包。RRQ 可以通过第一个数据块或错误消息来回复,表明文件未找到。在少数情况下,他们甚至会收到第一个数据包,然后由 树莓派 中止传输(当检查文件是否存在时会发生这种情况)。下面的示例仅包括三个数据包:原始读取请求、第一个数据块(始终是包含一个标头和 512 B 数据的 516 B,尽管最后一个块始终少于 512 B 且可能为零长度),以及第三个数据包(包含与数据块中帧编号匹配的确认帧号)。
已知问题
以太网引导模式有一些已知问题。由于引导模式的实现在芯片本身,除了使用仅包含 bootcode.bin 文件的存储卡外,没有其他解决方法。
DHCP 请求在五次尝试后超时
树莓派将尝试进行五次 DHCP 请求,每次间隔五秒,总共持续 25 秒。如果服务器在此期间无法响应,树莓派将进入低功耗状态。除非使用存储卡上的 bootcode.bin,否则没有解决办法。
不支持在不同子网上的 TFTP 服务器
在树莓派 3B+ (BCM2837B0) 中已修复。
DHCP 中继故障
DHCP 检查还检查了跳数值是否为 1,而在 DHCP 中继情况下,它不会这样。
在树莓派 3A+ 中已修复。
树莓派启动字符串
在 DHCP 回复中,字符串“Raspberry Pi Boot”由于计算字符串长度的错误而需要占用额外三个空格。
在树莓派 3B+ 中已修复。
DHCP UUID 常量
DHCP UUID 设置为常量值。
已在树莓派 3A+ 修复;该值设置为 32 位序列号。
ARP 检查可能在 TFTP 事务中间无法响应
树莓派只会在初始化阶段响应 ARP 请求;一旦开始传输数据,它将无法继续响应。
已在树莓派 3 A+ 修复。
DHCP 请求/回复/确认序列未正确实现
在启动时,树莓派广播 DHCPDISCOVER 数据包。DHCP 服务器回复一个 DHCPOFFER 数据包。然后树莓派继续启动而不执行 DHCPREQUEST 或等待 DHCPACK。这可能导致两个不同设备被提供相同的 IP 地址并在未正确分配给客户端的情况下使用它。
不同的 DHCP 服务器在这种情况下有不同的行为。dnsmasq(取决于设置)将散列 MAC 地址以确定 IP 地址,并 ping 该 IP 地址以确保它尚未被使用。这减少了这种情况发生的机会,因为这需要在散列中发生碰撞。
GPIO 启动模式
注意
GPIO 引导模式仅适用于树莓派 3A+、3B、3B+,计算模块 3、3+。
老的树莓派可以配置:以在接通电源时使用连接到 GPIO 连接器的硬件选择启动模式。这是通过在 SoC 的 OTP 存储器中设置位来完成的。一旦设置了这些位,它们会永久性分配五个 GPIO,以便进行选择。只要设置了 OTP 位,就无法撤销。你应该仔细考虑是否启用此功能,因为这五个 GPIO 针脚将始终控制引导。尽管在树莓派引导后可以使用这些 GPIO 进行其他功能,但你必须进行额外设置,才能在树莓派引导时启用所需的启动模式。
要启用 GPIO 引导模式,请将以下行添加到 config.txt 文件中:
其中 n 是你希望使用的 GPIO 的 bank。然后重启树莓派一次,以使用此设置编程 OTP。Bank 1 是 GPIO 22-26,Bank 2 是 GPIO 39-43。除非你有一个计算模块,否则必须使用 bank 1:Bank 2 上的 GPIO 仅在计算模块上可用。由于 OTP 位的排列方式,如果你首先为 Bank 1 编程 GPIO 引导模式,那么稍后可以选择 Bank 2。反之不成立:一旦选择 Bank 2 作为 GPIO 引导模式,就无法选择 Bank 1。
一旦启用了 GPIO 引导模式,树莓派将不再启动。你必须拉高至少有关一个引导模式的 GPIO 引脚,才能启动树莓派。
引脚分配
树莓派 3B 和计算模块 3
22
39
SD0
23
40
SD1
24
41
NAND(尚不支持 Linux)
25
42
SPI (尚不支持 Linux)
26
43
USB
以上表格中的 USB 选项同时选择 USB 设备引导模式和 USB 主机引导模式。要使用 USB 引导模式,必须在 OTP 存储器中启用。有关更多信息,请参阅 USB 设备引导和 USB 主机引导。
后续的树莓派 3B(带金属盖的 BCM2837B0)、树莓派 3A+、3B+ 和计算模块 3+
20
37
SD0
21
38
SD1
22
39
NAND(尚不支持 Linux)
23
40
SPI(尚不支持 Linux)
24
41
USB 设备
25
42
USB 主机:大容量存储设备
26
43
USB 主机:以太网
注意
各种启动模式按照 GPIO 线的数字顺序尝试,即 SD0,然后 SD1,然后 NAND 等等。
启动流程
SD0 是博通的存储卡/MMC 接口。当 SoC 内部的引导 ROM 运行时,SD0 将始终连接到内置的 microSD 卡。在带有 eMMC 设备的计算模块上,SD0 连接到该设备;在精简版(Lite)计算模块上,SD0 可用于边缘连接器,并连接到 CMIO 载板上的 microSD 卡。SD1 是 Arasan 存储卡/MMC 接口,亦支持 SDIO。所有具有内置无线局域网的树莓派都使用 SD1 通过 SDIO 连接到无线芯片。
GPIO 针脚的默认上拉电阻为 50KΩ,详见 BCM2835 ARM 外围设备数据表第 102 页。推荐使用 5KΩ 的上拉电阻将 GPIO 针脚拉高:这样既可使 GPIO 正常工作,同时不会产生太多功耗。
NVMe 固态硬盘引导
NVMe(非易失性快速存储器)是通过 PCIe 总线进行外部存储访问的标准。你可以通过计算模块 4(CM4)IO 板、树莓派 5 上的 PCIe 槽连接 NVMe 驱动器。再通过一些额外配置,你就可以从 NVMe 驱动器启动了。
准备工作
硬件
NVMe M.2 固态硬盘
一款 PCIe 转标准 M.2 的转接器
对于树莓派 5,我们推荐使用 M.2 HAT+,它能把树莓派的 PCIe FFC 槽转换为 M 键(Key)接口。
对于 CM4,可搜索“PCIe 3.0 ×1 转 M.2 NGFF M 键 SSD NVMe PCIe 转接器”
要检查你的 NVMe 驱动器是否正确连接,请从其他存储设备(如存储卡)引导你的树莓派,并运行 ls -l /dev/nvme*。示例输出如下所示。
软件
运行以下命令可查看你正在运行的固件版本:
对于树莓派 5,你需要使用 2023 年 12 月 6 日及之后发布的固件。
为了 CM4,NVMe 引导支持于 2021 年 7 月引入。你需要自那时起发布的以下版本的软件:
引导加载程序
VideoCore 固件
树莓派系统 Linux 内核
最新的树莓派系统发布包含你所需的一切。使用树莓派镜像制作工具可将树莓派系统镜像安装到你的驱动器上。
编辑 EEPROM 启动顺序
对于树莓派 5,你需要启动树莓派系统以编辑启动顺序。你可以从存储卡或 USB 驱动器启动树莓派来完成此步骤。即使更改启动设备,EEPROM 配置也会持久保留,因为 EEPROM 配置存储在板上本身。
使用树莓派配置命令行界面来更新启动加载程序:
在 Advanced Options > Bootloader Version 下,选择 Latest。然后,单击 Finish 或按 Escape 键 可退出 raspi-config。
运行以下命令可将固件更新至最新版本:
然后,使用 sudo reboot 重启。你的树莓派 5 应该会从 NVMe 启动。
对于 CM4,请使用 rpiboot 更新引导加载程序。你可以在 USB 启动 GitHub 存储库中找到构建 rpiboot 并配置 IO 板切换 ROM 到 usbboot 模式的说明。
对于搭载了 eMMC 的 CM4 版本,请确保你已将 NVMe 设置为引导顺序中的第一项。请记住在 recovery/boot.conf 中将 NVMe 引导模式 6 添加到 BOOT_ORDER 中。
当 SD 卡插槽为空时,CM4 Lite 会自动从 NVMe 引导。
NVMe BOOT_ORDER
EEPROM 配置中的 BOOT_ORDER 设置控制引导行为。对于 NVMe 引导,请使用引导模式 6。有关更多信息,请参见树莓派引导加载程序配置。
例子
以下是引导加载程序检测到 NVMe 驱动器时的串口输出示例:
然后它将找到一个 FAT 分区并加载 start4.elf :
然后加载内核并引导操作系统:
在 Linux 中,SSD 显示为 /dev/nvme0,而在“namespace(命名空间)”中显示为 /dev/nvme0n1。将会有两个分区 /dev/nvme0n1p1 (FAT)和 /dev/nvme0n1p2 (EXT4)。使用 lsblk 来检查分区分配:
故障排除
如果引导过程失败,请在 GitHub 存储库 rpi-eeprom 上提交问题,确保附上控制台输出以及引导过程中所有屏幕显示的内容。
HTTP 引导
网络安装功能使用以太网上的 HTTP 引导树莓派进入嵌入式树莓派启动盘制作工具。
除了网络安装,你还可能用 HTTP 下载的文件显式引导设备启动,即使禁用引导,网络安装也能用。
例如,你可以将这添加到你的 BOOT_ORDER 作为备用引导方法,或者将其放在 GPIO 条件后,在 GPIO 引脚拉低时从你自己的服务器启动 HTTP 引导。
例如,如果将以下内容添加到你的 EEPROM 配置中,且 GPIO 8(默认状态为 1 或高电平)被拉低,将下载文件 http://downloads.raspberrypi.org:80/net_install/boot.img、http://downloads.raspberrypi.org:80/net_install/boot.sig。如果启用开机网络安装,则会使用相同的网址。如果 GPIO 8 未被拉低,则行为将保持不变。
boot.img 和签名文件 boot.sig 是个包含引导文件系统的内存盘。详情请参阅 boot_ramdisk。
如果启用安全启动并且未设置 HTTP_HOST,则将忽略 BOOT_ORDER 中的 HTTP。
要求
要使用 HTTP 引导,请更新至 2022 年 3 月 10 日和后续版本的引导程序。HTTP 引导需要有线以太网连接。
要使用定制 CA 证书,请更新至 2024 年 4 月 5 日和后续版本的引导程序。只有运行 BCM2712 CPU 的设备支持才定制 CA 证书。
键
所有 HTTP 下载必须签名。引导加载程序包含一个用于默认主机 fw-download-alias1.raspberrypi.com 上文件的公钥。除非设置了 HTTP_HOST,并在 EEPROM 中内置公钥,否则该密钥将用于验证网络安装镜像。这能让你在自己的服务器上托管树莓派网络安装镜像。
警告
使用你自己的网络安装镜像将需要你对镜像进行签名,并将你的公钥添加到 EEPROM。如果你后续进行了公版 EEPROM 更新,你的密钥将丢失,并且需要重新添加。
USBBOOT 包含了编程公钥所需的全部工具。
使用以下命令将你的公钥添加到 EEPROM。boot.conf 包含你的修改:
使用以下命令可为你的 EEPROM 生成签名:
然后,使用以下命令使用你的私钥对网络安装镜像进行签名:
最后,将 boot.img 和 boot.sig 放在你的网络服务器上,以使用自己签名的网络安装镜像。
证书
为了安全起见,网络安装使用 HTTPS 从树莓派网站下载操作系统镜像。此功能使用我们在引导程序中内置的自有 CA 根证书来验证主机。
你可以将你自己的定制 CA 证书添加到设备的 EEPROM,以安全地从你自己的网站下载镜像。使用工具 rpi-eeprom-config 的参数 --cacertder 能添加 DER 编码的证书。你必须在 EEPROM 配置设置中放置证书的哈希值,以确保证书未经篡改。
运行以下命令生成 DER 编码的证书:
然后,运行以下命令生成证书的 SHA-256 哈希:
应该会看到类似如下输出:
接下来,更新 boot.conf 以包含证书的哈希值:
在 [gpio8=0] 部分配置以下设置,替换为:
将
<你的网站>替换为你的网站,例如yourserver.org将
<文件路径>替换为托管在你的网站上的操作系统镜像的路径,例如path/to/files使用上面生成的哈希值 701bd97f67b0f5483a9734e6e5cf72f9a123407b346088638f597878563193fc,例如
<哈希值>
当你指定 HTTP_CACERT_HASH 时,网络安装将通过 HTTPS 下载镜像。没有哈希时,网络安装将使用 HTTP 下载镜像。
最后,使用以下命令将所有内容加载到 EEPROM 中:
在网络启动过程中,你的树莓派应该使用 HTTPS 而非 HTTP。要查看由网络安装解析的完整的 HTTPS 下载链接,请查看引导输出:
安全启动
如果启用了安全启动,则树莓派只能运行由客户私钥签名的代码。因此,如果你想要在安全启动的情况下使用网络安装、HTTP 启动模式,你必须使用自己的密钥签署 boot.img 并生成 boot.sig,并在某处托管这些文件供下载。EEPROM 中的公钥将用于验证镜像。
如果启用安全启动且未设置 HTTP_HOST,则网络安装和 HTTP 引导将被禁用。
有关安全启动的更多信息,请参阅 USBBOOT。
引导顺序
重要
此启动顺序仅适用于基于 BCM2837、BCM2837B0 的树莓派。在此之前的型号,树莓派将尝试存储卡引导,然后是 USB 设备模式引导。有关树莓派 4 和树莓派 5 的引导顺序,请参阅 EEPROM 引导流程部分。
树莓派 3 上的 USB 引导默认取决于所使用的版本。如果默认未启用 USB 引导模式,请参阅此页面获取有关启用 USB 引导模式的信息。
当 BCM2837 引导时,它使用两个不同的来源来确定要启用哪些引导模式。首先,会检查一次性可编程(OTP)存储器块,看哪些引导模式已启用。如果启用了 GPIO 引导模式设置,则会测试相关的 GPIO 线,以选择应尝试哪个已在 OTP 中启用的引导模式。请注意,GPIO 引导模式仅可用于选择已在 OTP 中启用的引导模式。有关配置 GPIO 引导模式的详细信息,请参阅 GPIO 引导模式。在默认情况下,GPIO 引导模式已禁用。
接下来,启动 ROM 会在每个启动源中检查名为bootcode.bin的文件;如果找到,它会将代码加载到本地 128K 缓存并跳转到该代码。总体启动模式过程如下:
BCM2837 启动
读取 OTP 以确定启用哪些启动模式
如果启用了 GPIO 启动模式,请使用 GPIO 启动模式来细化启用的启动模式列表
如果启用:检查 GPIO 48-53 上的主 SD 是否存在 bootcode.bin
成功 - 启动
失败 - 超时(五秒)
如果启用:检查辅助 SD
成功 - 启动
失败 - 超时(五秒)
如果启用:检查 NAND
如果启用:检查 SPI
如果启用:检查 USB
如果 OTG 引脚 == 0
启用 USB,等待有效的 USB 2.0 设备(2 秒)
设备已找到:
如果设备类型 == hub
递归每个设备
如果设备类型 == (大容量存储或 LAN951x)
存储在设备列表中
递归遍历每个大容量存储设备
如果找到
bootcode.bin引导
递归遍历每个 LAN951x
DHCP / TFTP 引导
其他(设备模式启动)
启用设备模式,等待主机 PC 枚举
我们用 VID: 0a5c PID: 0x2763 回复 PC(树莓派 1、树莓派 2)或 0x2764 (树莓派 3)
注意
如果没有插入存储卡,SD 引导模式将在 5 秒钟后失败。为了缩短这个时间并更快地切换到 USB 模式,你可以插入空白的存储卡,或者使用上面描述的 GPIO 引导模式 OTP 设置,仅启用 USB。GPIO 的默认拉取在 ARM 外围设备数据手册的第 102 页上有定义。如果引导时的值不等于默认拉取值,则启用该引导模式。USB 枚举是一种使下游设备在集线器上获取电源,然后等待设备拉动 D+ 和 D- 线以指示其是 USB 1 还是 USB 2 的方法。这可能需要一段时间:对于某些设备,硬盘驱动器可能需要长达 3 秒的时间来启动并开始枚举过程。因为这是唯一能检测硬件连接的方法,所以我们必须等待的最短时间为两秒。如果设备在最大超时时间后仍未响应,则可以使用
program_usb_boot_timeout=1在config.txt中增加超时时间至五秒。大容量存储引导优先于以太网引导。不再需要第一个分区是 FAT 分区,因为大容量存储引导将继续搜索第一个分区之外的 FAT 分区。引导 ROM 现在还支持 GUID 分区,并已测试过使用 Mac、Windows 和 Linux 分区的硬盘。使用供应商 ID 0x0424 和产品 ID 0xec00 可以检测 LAN951x,这与独立的 LAN9500 设备不同,后者的产品 ID 是 0x9500/0x9e00。要使用独立的 LAN9500,需要添加 I²C EEPROM 以更改这些 ID 以匹配 LAN951x。
主要存储卡引导模式默认设置为 GPIO 49-53。可以在第二组引脚上从次要存储卡引导,即将次要存储卡连接到 GPIO 引脚。但是,我们尚未启用此功能。
NAND 引导和 SPI 引导模式的确能用,尽管它们还未完全支持 GPU。
USB 设备引导模式在出厂时默认启用,但 USB 主机引导模式只有在 program_usb_boot_mode=1 时才启用。一旦启用,处理器将使用处理器上的 OTGID 引脚的值来在这两种模式之间做出决定。在所有树莓派 B/B+ 上,OTGID 引脚被驱动为 0,因此一旦启用,就只能通过主机模式引导(无法再使用设备模式引导,因为 LAN951x 设备阻挡了路径)。
如果将 OTGID 引脚浮置(例如,插入 PC),则树莓派 Zero 或计算模块将作为 USB 设备引导启动,因此你可以将 bootcode.bin 推入设备中。相关 usbboot 代码可在 GitHub 上找到。
EEPROM 引导流程
自树莓派 4 起,树莓派 旗舰设备使用 EEPROM 启动加载程序。与以前的产品相比,主要区别在于第二阶段启动加载程序是从 SPI 闪存 EEPROM 加载,而不是像以前的产品一样从 bootcode.bin 文件加载。
第一阶段启动加载程序
ROM(第一阶段)的引导流程如下:
SoC 上电
读取 OTP(一次性可编程存储器)以确定是否配置了
nRPIBOOTGPIO如果
nRPIBOOTGPIO 为高电平或 OTP 未定义nRPIBOOTGPIO检查 OTP 以查看是否可以从 SD/EMMC 加载
recovery.bin如果启用了 SD
recovery.bin,则检查主 SD/EMMC 中的recovery.bin成功:运行
recovery.bin并更新 SPI EEPROM失败:继续
检查 SPI EEPROM 中的第二阶段加载程序
成功:运行第二阶段启动加载程序
失败:继续
如果成功
尝试从 USB 设备启动 加载
recovery.bin成功:运行
recovery.bin并更新 SPI EEPROM 或切换到 USB 大容量存储设备模式失败:重试 USB 设备启动
注意
recovery.bin是一款用于更新引导加载程序 SPI EEPROM 镜像的最小第二阶段程序。
第二阶段引导程序
本节介绍了第二阶段引导程序的高级流程。
请参阅引导程序配置 页面以获取有关每种引导模式的更多信息,以及引导文件夹 页面以了解此阶段加载的 GPU 固件文件的描述。
初始化时钟和 SDRAM
读取 EEPROM 配置文件
检查
PM_RSTS寄存器以确定是否请求 HALT检查
POWER_OFF_ON_HALT和WAKE_ON_GPIO的 EEPROM 配置设置如果
POWER_OFF_ON_HALT为1且WAKE_ON_GPIO为0,则使用电源管理芯片(PMIC)关闭系统电源
否则,如果
WAKE_ON_GPIO为1,则启用 GPIO3 的下降沿中断以便在 GPIO3 被拉低时唤醒
进入休眠
当为
True(真)从 EEPROM 配置文件中的
BOOT_ORDER参数读取下一个引导模式如果引导模式为
RESTART,则跳回到
BOOT_ORDER字段中的第一个引导模式
否则如果引导模式为
STOP,则显示
start.elf未找到的错误模式 并永久等待。
否则如果引导模式为
SD CARD,则尝试从存储卡加载固件
成功:运行固件
失败:继续
否则如果引导模式为
NETWORK,则使用 DHCP 协议请求 IP 地址
从 DHCP 或静态定义的 TFTP 服务器加载固件
如果未找到固件或发生超时或网络错误,则继续
否则如果引导模式为
USB-MSD或引导模式为BCM-USB-MSD,则当 USB 发现未超时时
检查 USB 大容量存储设备
如果找到新的大容量存储设备,则
对每个驱动器(LUN)
尝试加载固件
成功:运行固件
失败:前进到下一个驱动器(LUN)
否则如果引导模式为
NVME,则扫描 PCIe 以查找 NVMe 设备,如果找到
尝试从 NVMe 设备加载固件
成功:运行固件
失败:继续
否则如果引导模式为
RPIBOOT,则尝试使用 USB 设备模式从 USB OTG 端口加载固件 ——参见USB 引导。
RPIBOOT模式没有超时。
树莓派 5 的不同
电源按钮用于从 PMIC STANDBY、HALT 唤醒,而非 GPIO 3。
固件加载
start.elf而不是start.elf。实际上,引导加载程序内置了嵌入版本的start.elf。连接到 3A 电源时,默认禁用 USB 启动。在
/boot/firmware/config.txt中设置usb_max_current_enable=1可启用 USB 启动。或者你可以在 USB 启动失败时,按一下电源按钮来临时启用usb_max_current_enable并继续引导。但是,如果是按电源按钮启用的,该设置在重启后将失效。
引导加载程序更新
如果找到 pieeprom.upd 文件,固件启动之前也可以更新引导加载程序。有关引导加载程序更新的更多信息,请参阅引导加载程序 EEPROM 页面。
安全模式操作系统更新(tryboot )
引导加载程序/固件提供了一个一次性标志,如果设置了该标志,会清除,但会导致加载 tryboot.txt 而不是 config.txt。这种备用配置将指定待处理的操作系统更新固件、cmdline、内核和 os_prefix 参数。因为在启动固件之前清除了该标志,所以崩溃或重置会导致在下次重启时加载原始的 config.txt 文件。
要设置 tryboot 标志,请在 reboot 命令中的分区号后添加 tryboot。通常,分区号默认为 0。但如果要添加额外的参数,则必须指定分区号。传递参数给 reboot 时始终使用引号:它只接受一个参数:
所有树莓派型号都支持 tryboot,但是在树莓派 4 A 1.0 版本和 1.1 版本上,EEPROM 不能被写保护。这是因为旧款树莓派 4B 设备必须重置电源供应(会丢失 tryboot 状态),而这些信息正存储在 EEPROM。
若启用安全启动,则 tryboot 模式将导致加载 tryboot.img 而不是 boot.img。
tryboot_a_b 模式
如果 autoboot.txt 中的 tryboot_a_b 属性设置为 1,则加载的是 config.txt 而不是 tryboot.txt。这是因为在更高级别(分区)已经进行了 tryboot 切换,因此在备用分区本身内部不需要具有 tryboot.txt 文件。
当从内置的 boot.img 镜像加载文件,tryboot_a_b 属性会被隐式设置为 1。
树莓派引导加载程序配置
编辑配置
在编辑引导加载程序配置之前,请更新你的系统以获取 rpi-eeprom 软件包的最新版本。
要查看当前的 EEPROM 配置,请运行以下命令:
要编辑当前的 EEPROM 配置并将更新应用于最新的 EEPROM 版本,请运行以下命令:
关于 EEPROM 更新过程的更多信息,请参阅启动 EEPROM。
配置属性
本节描述引导加载程序中所有可用的配置项。语法与 config.txt 相同,但属性是特定于引导加载程序的。条件过滤器也受支持,除了 EDID 之外。
BOOT_UART
如果 1 则启用 GPIO 14 和 15 上的 UART 调试输出。将接收调试终端配置为 115200bps,8 位,无奇偶校验位,1 个停止位。
默认: 0
UART_BAUD
仅适用于树莓派 5。
更改引导加载程序 UART 的波特率。
支持的值: 9600、19200、38400、57600、115200、230400、460800、921600
默认: 115200
WAKE_ON_GPIO
若为 1 则 sudo halt 将在较低功耗模式下运行,直到 GPIO3 或 GLOBAL_EN 短接至地。
在树莓派 5 上,此设置并不相关,因为专用电源按钮可以始终用于唤醒来自 HALT 或 STANDBY。
默认: 1
POWER_OFF_ON_HALT
如果 1 和 WAKE_ON_GPIO=0,那么 sudo halt 将关闭所有电源管理芯片(PMIC)输出。这是 halt 的最低功耗状态,但可能会导致某些扩展板出现问题,因为 5V 仍将处于开启状态。GLOBAL_EN 必须短接地来启动。
树莓派 400 有一个专用的电源按钮,即使处理器关闭也能工作。这个功能默认启用,但可设置 WAKE_ON_GPIO=2 来使用外部 GPIO 电源按钮,而不是专用电源按钮。
在树莓派 5 上,这将把 PMIC 置于 STANDBY 模式,其中所有输出都被关闭。无需设置 WAKE_ON_GPIO,按下专用电源按钮将启动设备。
默认: 0
BOOT_ORDER
BOOT_ORDER 设置能对不同启动模式的优先级进行灵活配置。它表示为一个 32 位无符号整数,其中每个半 B 代表一个启动模式。启动模式按照从最低有效半 B 到最高有效半 B 的顺序尝试。
BOOT_ORDER 字段
BOOT_ORDER 属性定义了不同引导模式的顺序。它是从右到左读取的,最多可以定义八位数字。
0x0
SD CARD DETECT
尝试 SD 卡,然后等待卡检测指示卡已更改。现在已弃用,因为 0xf ( RESTART ) 可用。
0x1
SD CARD
SD 卡 (或计算模块 4 上的 eMMC)。
0x2
NETWORK
网络引导:请参阅网络引导服务器教程。
0x3
RPIBOOT
RPIBOOT:请参阅 usbboot。
0x4
USB-MSD
USB 大容量存储引导:请参阅 USB 大容量存储引导。
0x5
BCM-USB-MSD
通过 USB-C 插口从 USB 2.0 启动(CM4:CM4IO 板上的 USB-A 插口)。在树莓派 5 上不可用。
0x6
NVME
仅限于 CM4 和 Pi 5:从连接到 PCIe 接口的 NVMe SSD 启动。有关更多详细信息,请参阅 NVMe 启动。
0x7
HTTP
通过以太网上的 HTTP 引导。有关更多详细信息,请参阅 HTTP 引导。
0xe
STOP
停止并显示错误模式。需要电源循环以退出此状态。
0xf
RESTART
从 BOOT_ORDER 字段中的第一个引导模式重启,即循环。
RPIBOOT 与计算模块 4 同时使用,加载自定义调试镜像(例如,Linux RAM-disk)而不是正常的引导。这应该是最后的引导选项,因为它目前不支持超时或重试。
BOOT_ORDER 示例
BOOT_ORDER
说明
0xf41
首先尝试存储卡,然后是 USB-MSD,再重复(如果 BOOT_ORDER 为空时默认)
0xf14
首先尝试 USB,然后是存储卡,然后重复
0xf21
首先尝试存储卡,然后是网络,然后重复
0xf46
首先尝试 NVMe,然后是 USB 大容量存储设备,然后重复
MAX_RESTARTS
如果遇到 0xf 重启 ( RESTART ) 引导模式超过 MAX_RESTARTS 次数,则会触发看门狗复位。不建议一般使用这个,但在需要完全重置以解决硬件/网络接口故障的测试和远程系统上可能会有用。
默认值: -1 (无限)
SD_BOOT_MAX_RETRIES
在移动到由 BOOT_ORDER 定义的下一个引导模式之前,在 SD 引导失败后重试的次数。
-1 意味着无限重试。
默认值: 0
NET_BOOT_MAX_RETRIES
失败后在移动到下一个由 BOOT_ORDER 定义的引导模式之前,网络引导将重试的次数。
-1 表示无限重试。
默认: 0
DHCP_TIMEOUT
整个 DHCP 序列在失败当前迭代之前的超时时间(毫秒)。
最小值: 5000
默认值: 45000
DHCP_REQ_TIMEOUT
DHCP DISCOVER 或 DHCP REQ 重试之前的超时时间(毫秒)。
最小值: 500
默认值: 4000
TFTP_FILE_TIMEOUT
通过 TFTP 单个文件下载的超时时间(毫秒)。
最小值: 5000
默认值: 30000
TFTP_IP
可选的点分十进制 IP 地址(例如 192.168.1.99)用于 TFTP 服务器,覆盖来自 DHCP 请求的服务器 IP。
在家庭网络上,可能会发现这很有用,因为可以使用 tftpd-hpa 代替 dnsmasq,其中宽带路由器是 DHCP 服务器。
默认: ""
TFTP_PREFIX
为了让每个树莓派都有唯一 TFTP 启动目录,引导加载程序会将文件名前缀添加到特定于设备的目录。如果在带前缀的目录中找不到 start4.elf/start.elf,则会清除前缀。
在早期型号上,序列号被用作前缀,但在树莓派 4 和 5 上,MAC 地址不再由序列号生成,这使得通过检查 DHCPDISCOVER 包自动创建 tftpboot 目录在服务器上变得困难。为了方便,TFTP_PREFIX 可以定义为 MAC 地址、固定值或序列号(默认)。
0
使用序列号,例如 9ffefdef/
1
使用 TFTP_PREFIX_STR 指定的字符串
2
使用 MAC 地址,例如 dc-a6-32-01-36-c2/
默认值: 0
TFTP_PREFIX_STR
当 TFTP_PREFIX 设置为 1 时,指定用于自定义目录前缀的字符串。例如:TFTP_PREFIX_STR=tftp_test/
默认: ""
最大长度:32 个字符
PXE_OPTION43
使用不同的字符串覆盖 PXE Option43 匹配字符串。通常最好将定制应用于 DHCP 服务器,而不是更改客户端行为,但在无法进行更改的情况下提供此选项。
默认:Raspberry Pi Boot
DHCP_OPTION97
在之前的版本中,客户端 GUID(Option97)只是将序列号重复四次。默认情况下,新的 GUID 格式为四字符码(FourCC)的串联(RPi4 0x34695052 适用于 树莓派 4 或 RPi5 0x35695052 适用于树莓派 5),板子版本(例如 0x00c03111、0x00d04170)(4 B),MAC 地址的最低有效 4 B 以及 4 B 的序列号。这旨在是独一无二的,同时也向 DHCP 服务器提供结构化信息,使得可以识别树莓派 4 和 5 计算机,而无需依赖以太网 MAC OUID。
指定 DHCP_OPTION97=0 可恢复旧行为,或指定非零十六进制值以指定自定义的 4 字节前缀。
默认值: 0x34695052
MAC_ADDRESS
用给定的值覆盖树莓派以太网 MAC 地址。例如 dc:a6:32:01:36:c2
默认: ""
MAC_ADDRESS_OTP
使用存储在客户 OTP 寄存器中的值覆盖树莓派以太网 MAC 地址。
例如,要使用存储在 Customer OTP 的行 0 和 1 中的 MAC 地址。
第一个值(例如中的第 0 行)包含 OUI 和 MAC 地址的最高 8 位。第二个值(例如中的第 1 行)存储 MAC 地址的剩余 16 位。这与在制造时用于树莓派 MAC 地址的格式相同。
可以选择并以任意顺序组合任意两个客户行。
Customer OTP 行是 OTP 寄存器 36 到 43,在 vcgencmd otp_dump 输出中,所以如果前两行被编程如下,则 MAC_ADDRESS_OTP=0,1 就会给出一个 MAC 地址为 e4:5f:01:20:24:7e。
默认: ""
静态 IP 地址配置
如果设置了 TFTP_IP 和以下选项,则跳过 DHCP,并应用静态 IP 配置。如果 TFTP 服务器与客户端在同一子网上,则可省略网关(GATEWAY)。
CLIENT_IP
客户端的 IP 地址,例如 192.168.0.32
默认: ""
SUBNET
子网地址掩码,例如 255.255.255.0
默认: ""
GATEWAY
如果 TFTP 服务器位于不同子网上,则要使用的网关地址,例如 192.168.0.1
默认: ""
DISABLE_HDMI
如果 DISABLE_HDMI=1,HDMI 启动诊断显示将被禁用。其他非零值保留供将来使用。
默认: 0
HDMI_DELAY
跳过 HDMI 诊断显示,最多 N 秒(默认值 5),除非发生致命错误。默认行为旨在避免在正常 SD/USB 引导时,引导加载程序诊断屏幕短暂出现。
默认: 5
ENABLE_SELF_UPDATE
启用引导加载程序从 TFTP/USB 大容量存储设备(MSD)引导文件系统中更新自身。
如果自更新已启用,则引导加载程序将在引导文件系统中查找更新文件(.sig/.upd)。如果更新镜像与当前镜像不同,则应用更新并重置系统。否则,如果 EEPROM 镜像是逐字节相同的,则引导将继续正常进行。
注:
2021 年之前的引导加载程序版本不支持
self-update。2022 年之前,SD 启动中未启用自更新功能。在树莓派 4 上,ROM 已经可以从存储卡加载
recovery.bin。在 CM4 上,自更新和recovery.bin均不生效,需要使用 USB 启动(请参阅计算模块 EEPROM 引导程序文档)。从 2022 年开始(beta 和稳定版),可以启用存储卡的自更新功能。
对于网络启动,请确保 TFTP 的
boot目录可以通过 NFS 挂载,并且rpi-eeprom-update可以写入其中。
默认值: 1
FREEZE_VERSION
以前,此属性仅由 rpi-eeprom-update 脚本检查。但是,现在自更新已启用,引导加载程序还将检查此属性。如果设置为 1,则将覆盖 ENABLE_SELF_UPDATE 以停止自动更新。要禁用 FREEZE_VERSION,你必须使用带有 recovery.bin 的存储卡引导。
自定义 EEPROM 更新脚本也必须检查此标志。
默认: 0
HTTP_HOST
如果启动网络安装或 HTTP 引导,则会从此服务器下载 boot.img 和 boot.sig。
无效的主机名将被忽略。它们应仅包含小写字母数字字符和 - 或 .。如果设置了 HTTP_HOST,则将禁用 HTTPS 并改用普通的 HTTP。你可以指定 IP 地址以避免 DNS 查找的需要。在主机名中不要包含 HTTP 方案及正斜杠。
默认: fw-download-alias1.raspberrypi.com
HTTP_PORT
你可以使用此属性来更改用于网络安装和 HTTP 引导的端口。当使用默认主机 fw-download-alias1.raspberrypi.com 时,启用 HTTPS。如果更改了 HTTP_HOST,则禁用 HTTPS 并使用普通 HTTP。
当禁用 HTTPS 时,即使将 HTTP_PORT 更改为 443,仍将使用普通 HTTP。
默认值:如果启用 HTTPS,则为443,否则为80
HTTP_PATH
用于网络安装和 HTTP 引导的路径。
区分大小写。路径分隔符使用正斜杠(Linux 样式)。前导和尾部的正斜杠不是必需的。
如果未设置 HTTP_HOST,则忽略 HTTP_PATH,URL 将为 https://fw-download-alias1.raspberrypi.com:443/net_install/boot.img。如果设置了 HTTP_HOST,URL 将为 http://<HTTP_HOST>:<HTTP_PORT>/<HTTP_PATH>/boot.img
默认值:net_install
IMAGER_REPO_URL
嵌入式树莓派制造者应用程序会在启动时下载一个 JSON 文件进行配置。
你可以更改内嵌的树莓派制作程序应用程序使用的 JSON 文件的网址,以便提供你自己的镜像。你可以通过参数 --repo 传递网址来测试标准的 树莓派 制作程序应用程序。
默认: http://downloads.raspberrypi.org/os_list_imagingutility_v3.json
NET_INSTALL_ENABLED
当启用网络安装时,如果检测到了键盘,引导加载程序会在启动时显示网络安装界面。
为了启用网络安装,请添加 NET_INSTALL_ENABLED=1,或者为了禁用网络安装,请添加 NET_INSTALL_ENABLED=0。
如果设置 DISABLE_HDMI=1,则此设置将被忽略,网络安装将被禁用。
为了检测键盘,网络安装必须初始化 USB 控制器并枚举设备。这会增加约 1 秒的启动时间,因此在某些嵌入式应用中禁用网络安装可能更为有利。
在树莓派 4 和树莓派 400 上默认为 1,在计算模块 4 上为 0。
NET_INSTALL_KEYBOARD_WAIT
如果启用了网络安装,则引导加载程序会尝试检测键盘和按 SHIFT 键以启动网络安装。你可以使用此属性更改此等待时间的长度(以毫秒为单位)。
将此设置为 0 将禁用对键盘的等待,尽管如果找不到引导文件且 USB 引导模式为 4 且处于 BOOT_ORDER 中,则仍可以启动网络安装。
注意
测试表明检测键盘和 SHIFT 至少需要 750 毫秒。
默认: 900
NETCONSOLE - 高级日志记录
NETCONSOLE 复制调试消息到网络接口。IP 地址和接口由 NETCONSOLE 字符串定义。
注意
NETCONSOLE阻塞,直到以太网连接建立或超时发生。超时值为DHCP_TIMEOUT,尽管除非请求网络引导,否则不会尝试 DHCP。
格式
有关更多信息,请参阅 Netconsole 文档。
为了简化解析,引导加载程序要求每个字段分隔符都存在。必须指定源 IP 地址,但以下字段可以留空并分配默认值。
src_port - 6665
dev_name -
""(设备名称始终被忽略)dst_port - 6666
dst_ip - 255.255.255.255
dst_mac - 00:00:00:00:00
通过将测试树莓派 4 连接到运行 WireShark 的另一个树莓派,并选择“udp.srcport == 6665”作为过滤器,然后选择 分析 → 跟随 → UDP 数据流 以 ASCII 日志形式查看数据的一种方式。
默认情况下不应启用 NETCONSOLE,因为这可能会导致网络问题。可以通过 GPIO 过滤器按需启用。
默认: "" (未启用)
最大长度: 32 个字符
PARTITION
如果未显式地由 reboot 命令 (例如 sudo reboot N) 或 boot_partition=N 在 autoboot.txt 中设置,则可以使用 PARTITION 选项来指定引导分区号。用户可以按下按钮来从救援分区启动。
最新固件还允许覆盖较大的分区号(> 31)。这允许自定义设置系统硬件看门狗,以特殊的大分区号(例如 62)触发重启,引导加载程序可以通过条件筛选器检测到该分区号,并将其重映射到恢复分区。
示例:
默认值: 0
PSU_MAX_CURRENT
仅适用于树莓派 5。
如果设置,该参数指示固件跳过 USB 供电握手,并假定连接到了具有给定电流等级的电源。通常设置为 3000(小电流电源) 或 5000(大电流电源)。
默认: ""
USB_MSD_EXCLUDE_VID_PID
一个包含最多四个 VID/PID 对的列表,指定引导加载程序应忽略的设备。如果这与 HUB 匹配,则该 HUB 不会被枚举,导致所有下游设备被排除。这旨在允许在引导枚举期间忽略有问题的设备(例如,枚举速度非常慢)。这是引导加载程序特有的,并不传递给操作系统。
格式是一个以 VID 为最高有效半字节的十六进制值的逗号分隔列表。不允许有空格。例如 034700a0,a4231234
默认: ""
USB_MSD_DISCOVER_TIMEOUT
如果在此超时期间未找到 USB 大容量存储设备,则停止 USB-MSD 并选择下一个引导模式。
最小值: 5000 (5 秒)
默认: 20000 (20 秒)
USB_MSD_LUN_TIMEOUT
在前进到下一个 LUN 之前等待的毫秒数,例如多槽 SD-CARD 读卡器。这仍在调整中,但可能有助于加快启动速度,如果连接了旧、慢设备以及包含 OS 的快速 USB-MSD 设备。
最小值: 100
默认: 2000 (2 秒)
USB_MSD_PWR_OFF_TIME
仅适用于树莓派 4。
在树莓派重启时,硬件会关闭 USB 电源。短暂的断电时间可能会导致某些 USB 设备出现问题,因此可以使用此参数强制执行较长的断电时间,就像在物理上拔掉电线一样。
在树莓派 4 版本 1.3 及更早版本上,要配置长关机需要启用 XHCI 控制器,因此实际上会先进行短关机,然后是较长的可配置关机。通过将此参数设置为 0,可以跳过较长的可配置关机。
在更新的版本中,硬件会确保 USB 电源在重启后关闭,引导加载程序仅在此经过超时后才启用电源。这是在内存初始化后发生的,确保 USB 电源至少被断开 2 秒。因此,此参数一般对新的硬件版本没有影响。
最小值: 0
最大值: 5000
默认值: 1000 (1 秒)
USB_MSD_STARTUP_DELAY
如果定义了,那么在 USB 主控制器初始化后,延迟给定的超时时间进行 USB 枚举。如果 USB 硬盘驱动器需要很长时间初始化,随即触发 USB 超时,那么可以使用此延迟给驱动程序额外的初始化时间。可能还需要增加总体 USB 超时时间 ( USB_MSD_DISCOVER_TIMEOUT )。
最小值: 0
最大值: 30000 (30 秒)
默认值: 0
VL805
仅适用于计算模块 4。
如果 VL805 属性设置为 1,则引导加载程序将搜索 VL805 PCIe XHCI 控制器,并尝试使用嵌入在引导加载程序 EEPROM 中的 VL805 固件进行初始化。这使得工业设计可以使用 VL805 XHCI 控制器而无需提供专用的 SPI EEPROM 来存储 VL805 固件。
在计算模块 4 上,引导加载程序永远不会写入专用的 VL805 SPI EEPROM。此选项仅配置控制器从 SDRAM 加载固件。
如果 VL805 XHCI 控制器有专用的 EEPROM,请勿使用此选项。它将无法初始化,因为 VL805 ROM 将尝试使用专用的 SPI EEPROM(如果已安装)。
嵌入式 VL805 固件假定与树莓派 4B 相同的 USB 配置(两个 USB 3.0 端口和四个 USB 2.0 端口)。不支持加载替代的 VL805 固件镜像,应该改用专用的 VL805 SPI EEPROM 来替换这样的配置。
默认: 0
XHCI_DEBUG
此属性是一个位字段,用于控制 USB 调试消息在大容量存储引导模式下的冗长程度。启用所有这些消息会生成大量日志数据,会降低启动速度,甚至可能导致启动失败。对于详细日志,最好使用 NETCONSOLE。
0x1
USB 描述符
0x2
大容量存储模式状态机
0x4
大容量存储模式状态机:详细
0x8
所有的 USB 请求
0x10
设备和集线器状态机
0x20
所有的 xHCI TRB (极为详细)
0x40
所有 xHCI 事件(极为冗长)
要合并值,请将它们相加。例如:
默认: 0x0 (未启用 USB 调试消息)
[config.txt] 部分
在读取 config.txt GPU 固件 start4.elf 后,读取引导加载程序 EEPROM 配置并检查是否存在名为 [config.txt] 的部分。如果 [config.txt] 部分存在,则将从此部分开头到文件末尾的内容附加到内存中,以便与从引导分区读取的 config.txt 文件的内容组合。这可用于自动应用设置到每个操作系统,例如 dtoverlays。
警告
如果你配置引导加载程序时出现无法引导的无效配置,则必须重新刷新引导加载程序 EEPROM 为有效配置以引导。
技巧
一些配置属性存储在
config.txt中。有关这些属性的更多信息,请参阅配置属性。
显示并行接口 (DPI)
在树莓派上使用 DPI 显示
在树莓派上使用 DPI 显示器
40 针通用输入/输出(GPIO)连接器可用于将显示并行接口(DPI)显示器连接到树莓派设备,作为使用专用显示串行接口(DSI)或高清多媒体接口(HDMI)的替代方案。
所有带有 40 针排针和计算模块的树莓派板都提供了高达 24 位并行 RGB 接口。此接口允许将并行 RGB 显示器连接到树莓派的 GPIO,无论是在 RGB24(每种红、绿和蓝色各 8 位)还是 RGB666(每种颜色 6 位)或 RGB565(5 位红色,6 位绿色和 5 位蓝色)模式下。
此接口由 GPU 固件控制,并可以通过用户通过特殊 config.txt 参数和启用正确的 Linux 设备树叠加层来进行编程。
GPIO 引脚
树莓派 GPIO 的 Bank 0 上可选择的一个替代功能是 DPI(显示并行接口),这是一个简单的时钟并行接口(最多可提供 R、G 和 B 的 8 位;时钟、使能、水平同步和垂直同步)。此接口在 GPIO Bank 0 上作为替代功能 2(ALT2)可用:
GPIO0
PCLK
GPIO1
DE
GPIO2
LCD_VSYNC
GPIO3
LCD_HSYNC
GPIO4
DPI_D0
GPIO5
DPI_D1
GPIO6
DPI_D2
GPIO7
DPI_D3
GPIO8
DPI_D4
GPIO9
DPI_D5
GPIO10
DPI_D6
GPIO11
DPI_D7
GPIO12
DPI_D8
GPIO13
DPI_D9
GPIO14
DPI_D10
GPIO15
DPI_D11
GPIO16
DPI_D12
GPIO17
DPI_D13
GPIO18
DPI_D14
GPIO19
DPI_D15
GPIO20
DPI_D16
GPIO21
DPI_D17
GPIO22
DPI_D18
GPIO23
DPI_D19
GPIO24
DPI_D20
GPIO25
DPI_D21
GPIO26
DPI_D22
GPIO27
DPI_D23
注意
DPI 输出引脚上的颜色值可以以 565、666 或 24 位模式显示(请参阅下表和参数
output_format的dpi_output_format部分)的多种方式:
Mode
RGB bits
GPIO
27
26
25
24
23
22
21
20
19
18
17
16
15
14
13
12
11
10
9
8
7
6
5
4
1
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
2
565
-
-
-
-
-
-
-
-
7
6
5
4
3
7
6
5
4
3
2
7
6
5
4
3
3
565
-
-
-
7
6
5
4
3
-
-
7
6
5
4
3
2
-
-
-
7
6
5
4
3
4
565
-
-
7
6
5
4
3
-
-
-
7
6
5
4
3
2
-
-
7
6
5
4
3
-
5
666
-
-
-
-
-
-
7
6
5
4
3
2
7
6
5
4
3
2
7
6
5
4
3
2
6
666
-
-
7
6
5
4
3
2
-
-
7
6
5
4
3
2
-
-
7
6
5
4
3
2
7
888
7
6
5
4
3
2
1
0
7
6
5
4
3
2
1
0
7
6
5
4
3
2
1
0
禁用其他 GPIO 外设
必须禁用使用冲突 GPIO 引脚的所有其他外设叠加层。在 config.txt 中,请注意注释/关闭所有已启用的 I²C/SPI dtparams:
配置显示器
内核模式设置(KMS)通用显示接口使输出能够接入任意显示器,只要你有合适的驱动程序。
自动检测
自动检测能让你的树莓派与显示器连接,而无需手动配置设备树叠加层。在默认情况下已启用自动检测。你可以通过将以下行添加到 config.txt 来启用显示器自动检测:
用 0 替换 1 可禁用自动检测。当你连接启用自动检测的官方树莓派显示器时,KMS 会自动确定显示器,配置适当的显示设置。
手动配置显示器
注意
在树莓派系统 Bookworm 及更高版本中,先前用于设置 DPI 的
dpi_output_format和dpi_timings条目已被叠加层vc4-kms-dpi-generic取代。
要使用除树莓派官方显示屏之外的其他显示屏,必须在配置文件中指定 dtoverlay 条目。面板制造商应在 Linux 内核代码中配置你的显示屏的时序,并提供叠加层来启用这些设置。请参阅 Adafruit Kippah 显示屏条目获取示例。以下示例演示如何在你的 txt 文件中为 Kippah 显示屏设置 dtoverlay 条目:
显示是时序通常在内核中定义,但你也可以在提供的 BSD 驱动程序中定义它们。如果你的面板在内核代码中缺乏定义的叠加层,则可以使用 BSD 驱动程序将显示定时定义为参数。这使你能够为显示屏手动配置设备树条目。
以下示例演示如何使用设备树参数定义定时:
注意
设备树行长度不得超过 80 个字符。当设置的行需要超过 80 个字符时,请将该参数的赋值拆分为多行。
参数显示树定义支持以下参数:
clock-frequency
显示时钟频率(Hz)
hactive
水平活动像素
hfp
水平上沿
hsync
水平同步脉冲宽度
hbp
水平下沿
vactive
纵向活动线
vfp
纵向上沿
vsync
纵向同步脉冲宽度
vbp
垂直下沿
hsync-invert
水平同步低电平
vsync-invert
垂直同步低电平
de-invert
数据使能低电平
pixclk-invert
负边沿像素时钟
rgb565
在 GPIO 0-19 上改变为 RGB565 输出
rgb666-padhi
在 GPIO 0-9,12-17 和 20-25 上改变为 RGB666 输出
rgb888
在 GPIOs 0-27 上更改为 RGB888 输出
bus-format
覆盖 MEDIA_BUS_FMT_* 值的总线格式,也被 rgbXXX 覆盖
backlight-gpio
定义用于背光控制的 GPIO(默认值:无)
GPIO 和 40 脚排针
你可以在所有当前的树莓派主板上找到一个 40 脚 GPIO(通用输入/输出)排针。主板上所有的 GPIO 排针间距均为 0.1 英寸(2.54 mm)。
注意
有 “H”后缀的 Zero 和 Pico 不带排针。

通用 I/O (GPIO) 引脚可配置为通用输入、通用输出,或者最多六种特殊交替设置之一,其功能取决于引脚。

注意
GPIO 引脚编号方案不按数字顺序排列。GPIO 引脚 0 和 1 位于板上(物理引脚 27 和 28),但保留供高级用途。
输出
作为输出引脚指定的 GPIO 引脚可以设置为高电平(3.3V)/低电平(0V)。
输入
作为输入引脚指定的 GPIO 引脚可以读取为高电平(3.3V)/低电平(0V)。使用内部上拉/下拉电阻器可以更轻松地实现其功能。GPIO2 和 GPIO3 引脚内置上拉电阻器,但对于其他引脚,可以在软件中进行配置。
查看树莓派的 GPIO 引脚布局
可以通过打开终端窗口并运行命令 pinout 在树莓派上访问 GPIO 参考。此工具由 GPIO Zero Python 库提供,在树莓派系统中预装。
警告
尽管把简单的组件接入 GPIO 引脚是安全的,但要小心线路的连接方式。应该用电阻限制流经 LED 的电流。不要给 3.3V 的组件用 5V。不要把电机直连到 GPIO 引脚,应该使用 H 桥电路、电机控制板。
权限
为了使用 GPIO 接口,你的用户必须是 gpio 组的成员。默认用户账户已经如此,但对于其他用户,你须使用以下命令手动加入:
GPIO 引脚
BCM2835 封装的 GPIO 在外设数据表中有时被称为“pads”,这是一个半导体设计术语,即“连接到外部世界的芯片”。
这些 pads 是可配置的 CMOS 推挽输出驱动器/输入缓冲器。可用于寄存器控制设置的包括:
内部上拉/下拉使能/失能
输出驱动强度
输入施密特触发器滤波
上电状态
所有 GPIO 引脚在上电复位时恢复为通用输入。还应用了默认拉电状态,详细信息请参阅 Arm 外设数据手册中的备用功能表。大多数 GPIO 引脚都应用了默认拉电。
中断
每个 GPIO 引脚在配置为通用输入时,可以配置为 Arm 的中断源。可配置多个中断产生源:
边沿敏感(高/低)
上升/下降沿
异步上升/下降沿
水平中断会保持中断状态,直到系统软件清除该中断(例如通过处理产生中断的附加外围设备)。
普通的上升/下降沿检测在检测中内置了少量的同步。在系统时钟频率下,引脚在三个周期窗口内采样,生成中断的标准是在稳定的转换中,即记录为 1 0 0 或 0 1 1。异步检测绕过此同步,以便检测非常窄的事件。
备用功能
几乎所有的 GPIO 引脚的功能都能被修改。SoC 内部的外设模块可以选择出现在一组 GPIO 引脚中的一个及多个上,例如,I²C 总线可以配置为至少三个独立位置之一。当引脚配置为替代功能时,例如,控制驱动强度或施密特触发器等仍然适用。
大部分功能适用于所有引脚,个别仅适用于特定引脚:
PWM(脉冲宽度调制)
所有引脚都支持软件 PWM
GPIO12、GPIO13、GPIO18、GPIO19 支持硬件 PWM
SPI
SPI0:MOSI(GPIO10);MISO(GPIO9);SCLK(GPIO11);CE0(GPIO8),CE1(GPIO7)
SPI1:MOSI(GPIO20);MISO(GPIO19);SCLK(GPIO21);CE0(GPIO18);CE1(GPIO17);CE2(GPIO16)
I²C
数据: (GPIO2); 时钟 (GPIO3)
EEPROM 数据: (GPIO0); EEPROM 时钟 (GPIO1)
串行
TX(GPIO14); RX(GPIO15)
电压规格
主板上有两个 5V 针脚、两个 3.3V 针脚,以及一些接地针脚(GND),这些不能被重新配置。剩余的针脚都是通用的 3.3V 针脚,意味着输出被设置为 3.3V,输入是 3.3V 兼容的。
下表列出了针对 BCM2835、BCM2836、BCM2837 和 RP3A0 系列产品(例如树莓派 Zero 或树莓派 3+)的 GPIO 针脚的各种电压规格。有关计算模块的信息,请参阅相应的数据表。
Vɪʟ
低电压输入
-
-
-
0.9
V
Vɪʜ
高电压输入①
-
1.6
-
-
V
Iɪʟ
输入泄漏电流
Tᴀ = +85°C
-
-
5
μA
Cɪɴ
输入电容
-
-
5
-
电源
音量
输出低电压
Iᴏʟ = -2mA
-
-
0.14
V
Vᴏʜ
输出高电压②
Iᴏʜ = 2 mA
3.0
-
-
V
Iᴏʟ
输出低电流③
电压 = 0.4V
18
-
-
mA
Iᴏʜ
输出高电流③
Vᴏ = 2.3V
17
-
-
mA
上拉电阻
上拉电阻
-
50
-
65
kΩ
下拉电阻
下拉电阻
-
50
-
65
kΩ
①: 滞后效应已启用
②: 默认驱动强度 (8mA)
③: 最大驱动强度 (16mA)
下表显示了 BCM2711 系列产品(例如树莓派 4、400)上 GPIO 引脚的电压规格。有关计算模块的信息,请参阅相关数据表。
低电压输入
输入低电压
-
-
-
0.8
V
高电压输入
输入高电压①
-
2.0
-
-
V
Iɪʟ
输入漏电流
Tᴀ = +85℃
-
-
10
μA
Vᴏʟ
输出低电压②
Iᴏʟ = -4mA
-
-
0.4
V
Vᴏʜ
输出高电位②
Iᴏʜ = 4mA
2.6
-
-
V
Iᴏʟ
输出低电流③
Vᴏ = 0.4V
7
-
-
mA
输出高电流
输出高电流
Vᴏ = 2.6V
7
-
-
mA
Rᴘᴜ
上拉电阻
-
33
-
73
kΩ
Rᴘᴅ
下拉电阻
-
33
-
73
kΩ
①: 滞后效应已启用
②: 默认驱动强度 (4mA)
③: 最大驱动强度 (8mA)
GPIO 控制器
GPIO 驱动强度并不表示最大电流,仅表示在此电流下 pad 仍将符合规范。你应该设置 GPIO 驱动强度以匹配所连接的设备,以便设备能够正常工作。
控制驱动强度
在 pad 内部有多个并联驱动器。如果将驱动强度设置为低(0b000),则大多数驱动器将处于三态状态,因此不会对输出电流产生影响。如果增加驱动强度,则会并联更多驱动器。图表显示了该行为。
警告
对于树莓派 4、400,计算模块 4,当前级别是图表中显示数值的一半。

当前数值
当前数值指定了在此电路板仍能满足规范的最大电流。
当前值不是垫片将提供的电流,也不是电流限制。
触点片输出是一个电压源:
如果设置为高电平,触点片将尝试将输出驱动到电源电压(3.3V)
该触点将尝试将输出引至高电平/低电平。成功取决于所连接设备的要求。如果该触点短接至地线,则无法输出高电平。它将尽可能输送尽可能多的电流,电流仅受内部电阻限制。
如果该触点输出高电平且短接至地线,在一段时间后将损坏。如果你将其连接至 3.3V 并输出低电平同样也是如此。
符合规格是由保证的电压水平确定的。由于引脚是数字的,因此有两个电压级别,高电平和低电平。I/O 接口有两个处理输出电平的参数:
Vᴏʟ,最大低电平电压(在 3.3V VDD IO 时为 0.14V)
Vᴏʜ,最小高电平电压(在 3.3V VDD IO 时为 3.0V)
Vᴏʟ=0.14V 意味着如果输出为低电平,则电压将 <= 0.14V。Vᴏʜ=3.0V 意味着如果输出为高电平,则电压将 >= 3.0V。
例如,驱动强度为 16mA 表示如果你将端口设置为高电平,可以吸收高达 16mA 电流,并且输出电压保证 >=Vᴏʜ。这也意味着,如果你将驱动强度设置为 2mA,但吸收了 16mA 电流,则电压将不会达到 Vᴏʜ,而会更低。事实上,可能不足以被外部设备识别为高电平。
GPIO 引脚的物理特性有更多信息。
注意
在计算模块设备上,可以将 VDD IO 从标准的 3.3V 更改。在这种情况下,Vᴏʟ 和 Vᴏʜ 将根据 GPIO 部分的表格进行更改。
树莓派 的 3.3V 电源为每个 GPIO 引脚的设计最大电流是 ~3mA。如果你将每个引脚的负载设定为 16mA,则总电流为 272mA。在此负载水平下,3.3V 电源将崩溃。会引发大电流脉冲,特别是如果有电容负载。脉冲将在附近的其他引脚之间反弹。这可能会对存储卡乃至内存行为造成干扰。
安全电流
所有的键盘的电子元件均设计为 16mA。这是一个安全值,在此范围内你不会损坏设备。即使你将驱动强度设置为 2mA,然后负载为 16mA,也不会损坏设备。除此之外的最大安全电流都不保证。
GPIO 地址
0x 7e10 002c PADS (GPIO 0-27)
0x 7e10 0030 PADS(GPIO 28-45)
0x 7e10 0034 PADS(GPIO 46-53)
31:24
PASSWRD
写入时必须为 0x5A;意外写保护密码
W
0
23:5
保留 - 写入为 0,读取不影响
4
SLEW
斜坡率; 0 = 斜坡率受限; 1 = 斜坡率不受限制
RW
1
3
HYST
启用输入滞后; 0 = 禁用; 1 = 启用
RW
1
2:0
DRIVE
驱动强度,请参见下面的详细列表
RW
3
请当心同时切换输出(SSO)限制,这些限制取决于设备以及 PCB 的质量和布局,去耦电容器的数量和质量,触点子上的负载类型(电阻,电容)以及树莓派无法控制的其他因素。
驱动强度列表
0 = 2mA
1 = 4mA
2 = 6mA
3 = 8mA
4 = 10mA
5 = 12mA
6 = 14mA
7 = 16mA
树莓派的工业用途
树莓派经常被用作其他产品的组件。本文档介绍了一些额外的功能,以便于使用你树莓派的其他功能。
一次性可编程设置
在树莓派单板计算机上使用一次性可编程内存
在树莓派开发板计算机上使用一次性可编程内存
所有树莓派单板计算机(SBC)都内置了一次编程(OTP)存储器区域,实际上是主片上的一部分。正如其名称(one-time,一次性)暗示的那样,OTP 存储器只能被写入一次(即二进制 0 只能改为 1)。一旦某位置 1,就永远无法恢复为 0。可将 OTP 的每一位都视为一根保险丝。对其进行编程即代表有意地熔断保险丝:这是一种不可逆的过程,因为你无法进入芯片内部去替换它!
本白皮书假定树莓派正在运行树莓派操作系统(OS),并且已完全更新最新固件和内核。
有许多可以使用的 OTP 值。要查看所有 OTP 值的列表,请运行以下命令:
这个转储中的一些有趣的行:
28 - 序列号
29 - 序列号的补码
30 - 板子修订号码
此外,从 36 到 43(包括 36 和 43),有八行 32 位供客户使用。
注意
在 BCM2712 设备上,这些数字是不同的。第 31 行是序列号,第 32 行是板子修订号码。客户行是 77 到 84(包括 77 和 84)。
一些这些行可以使用 vcmailbox 进行编程。这是一个 Linux 驱动程序界面,用于处理行的编程。要执行此操作,请参考文档和 vcmailbox 示例应用程序。
vcmailbox 应用程序可以直接在树莓派系统的命令行上使用。一个示例用法是:
...会返回类似于:
以上使用邮箱属性接口 GET_BOARD_SERIAL,请求大小为 8 B,响应大小为 8 B(发送两个整数作为请求 0,0)。对此的响应将是两个整数(0x00000020 和 0x80000000),后跟标签代码、请求长度、响应长度(第 31 位设为 1 表示它是响应),然后是 64 位序列号(其中最高 32 位始终为 0)。
编写和读取客户 OTP 值
警告
OTP 值是一次性可编程的。一旦将位从 0 更改为 1,则无法改回。
要设置定制 OTP 值,你需要使用 SET_CUSTOMER_OTP (0x38021) 标签如下:
start_num = 要从 0-7 编程的第一行
number = 要编程的行数
value = 每个值到程序
因此,要将 OTP 客户行 4、5 和 6 编程为分别为 0x11111111、0x22222222、0x33333333,你将使用:
然后将会编程第 40、41、42 行。
要读回值,你可以使用:
这应该显示:
如果你想将此功能集成到你自己的代码中,你应该能够通过使用 vcmailbox.c 代码作为示例来实现这一点。
在非 BCM2712 设备上锁定 OTP
可以锁定 OTP 更改,以避免它们再次被编辑。
这可以通过使用带有 OTP 写邮箱的特殊参数来完成。
只要锁定,客户 OTP 值就无法修改。请注意,这个锁定操作是不可逆的。
在 BCM2712 设备上锁定 OTP
可以使用以下命令将客户区域标记为只读。
一次性密码仅在设备重置前锁定,因此每次启动时都需要重新应用一次性密码锁定。
使非 BCM2712 设备上的客户一次性密码位不可读
可以完全阻止读取客户一次性密码位。这可以通过在一次性密码写邮箱中使用特殊参数来实现:
这个操作对于绝大多数用户来说可能没有什么用处,并且是不可逆的。
定制 MAC 地址对于 BCM2712 设备
在 BCM2712 设备上,以太网、Wi-Fi 和蓝牙 MAC 地址在 OTP 存储器中设置。这些值可以随客户值而改变。
获取客户端的 MAC 地址 vcmailbox 0x00030082/3/4 6 6 0 0,其中 2 是以太网,3 是 WiFi,4 是蓝牙:
要设置客户端的 MAC 地址,必须按正确顺序将其发送为两个 32 字的单词。你可以运行一个命令来检查它是否格式正确:
检查日志以查看 MAC 地址是否符合你的预期:
多播地址不被视为有效。MAC 地址中最高位的最低有效位是多播位,因此确保这个位未设置。
然后可以使用命令 vcmailbox 0x00038082/3/4 6 6 <row1> <row0> 设置客户 MAC 地址:
如果客户 MAC 地址设置为 ff:ff:ff:ff:ff:ff,则将被忽略。
设备特定的私钥
使用 Broadcom BCM2712 处理器的设备具有 16 行 OTP 数据(512 位),用于支持文件系统加密。不使用 BCM2712 的设备具有可用于设备特定的私钥的 8 行 OTP(256 位)。
可以使用类似于管理客户 OTP 行所使用的相似 vcmailbox 命令来编程和读取这些行。如果不需要安全引导 / 文件系统加密,则可以使用设备私钥行来存储通用信息。
设备专用密钥行只能通过命令
vcmailbox读取,该命令需要访问/dev/vcio,该访问权限仅限于树莓派系统上的video组。树莓派计算机没有硬件保护密钥存储。建议将此功能与安全启动结合使用,以限制对这些数据的访问。
树莓派系统不支持加密根文件系统。
有关开源磁盘加密的更多信息,请参见 Cryptsetup。
使用 rpi-otp-private-key 将密钥编程到 OTP 中
rpi-otp-private-key 脚本包装设备私钥 vcmailbox API,使得更容易以 OpenSSL 格式读取和写入密钥。
注意
usbboot 库包含你需要的所有工具,rpi-eeprom 作为 Git 子模块。
把这个 32 字节的密钥读取为 64 个字符的十六进制数:
示例输出:
将 32 字节的随机生成数字写入设备私钥。
警告
此操作无法撤销。
注意
要指定要使用的 OTP 行数,请传参
-l <word count>。要指定密钥存储中的起始位置,请传参-o <word offset>。
读取/写入密钥的邮箱 API
读取所有行。
示例输出:
将所有行写入(用密钥数据替换末尾的八个零):
写入前一个示例中显示的密钥:
OTP 寄存器和位定义
所有树莓派范围使用的 SoC 都具有内置的一次可编程(OTP)存储器块。少数位置具有出厂程序化的数据。
OTP 存储器大小:
非 BCM2712 设备:66 个 32 位值
BCM2712 设备:192 个 32 位值
要显示 OTP 的内容,请运行以下命令:
针对非 BCM2712 设备的 OTP 寄存器
此列表包含关于寄存器的公开信息。如果某个寄存器或位未在此定义,则表示它未公开。
16 OTP 控制寄存器 - BCM2711
第 26 位:禁用 VC JTAG
位 27: 禁用 VC JTAG 17 引导模式寄存器
位 1: 将振荡器频率设置为 19.2MHz
位 3: 启用 SDIO 引脚上的上拉电阻
位 15: 禁用 ROM RSA 密钥 0 -(如果设置,则启用安全启动)(BCM2711)
位 19: 启用 GPIO 引导模式
位 20:设置用于检查 GPIO 引导模式的银行
位 21:启用从存储卡引导
位 22:设置用于引导的银行
位 28:启用 USB 设备引导
位 29:启用 USB 主机引导(以太网和大容量存储)
注意
在 BCM2711 上,引导模式由引导加载程序 EEPROM 配置而不是 OTP 定义。
18 启动模式寄存器的副本 28 序列号 29 ~(序列号) 30 修订代码 ① 33 电路板修订扩展 - 意义取决于电路板型号。这通过设备树在 /proc/device-tree/chosen/rpi-boardrev-ext 中提供,并且可以通过在 config.txt 中设置 board_rev_ext 来临时覆盖测试目的中的 OTP 值。
*计算模块 4
位 30:计算模块是否安装了 WiFi 模块
0 - Wi-Fi
1 - 没有 Wi-Fi
Bit 31:计算模块是否安装了 EMMC 模块
0 - EMMC
1 - 无 EMMC(Lite)
树莓派 400
位 0-7:piwiz 使用的默认键盘国家代码 36-43 客户 OTP 值 45 MPG2 解码密钥 46 WVC1 解码密钥
47-54 SHA256 RSA 公钥的安全引导
55 安全启动标志(由引导加载程序保留使用)
56-63 256 位设备特定私钥
64-65 MAC 地址;如果设置,系统将优先使用此地址,而不是基于序列号自动生成的地址
66 高级启动寄存器(非 BCM2711)
位 0-6:ETH_CLK 输出引脚的 GPIO
位 7:启用 ETH_CLK 输出
位 8-14:LAN_RUN 输出引脚的 GPIO
位 15:启用 LAN_RUN 输出
位 24:延长 USB HUB 超时参数
位 25: ETH_CLK 频率:
0 - 25MHz
1 - 24MHz
①还包含禁用过压、OTP 编程和 OTP 读取的位。
BCM2712 设备上的 OTP 寄存器
此列表包含关于寄存器的公开信息。如果此处未定义寄存器或位,则表示其非公开。
22 引导模式寄存器
第 1 位:从存储卡启动
第 2-4 位:从 SPI EEPROM 启动(以及哪些 GPIO)
位 10: 禁止从存储卡引导
位 11: 禁止从 SPI 引导
位 12: 禁止从 USB 引导
23 引导模式寄存器的副本
29 高级引导模式
0-7 位:SD 卡检测的 GPIO
位 8-15:用于 RPIBOOT 的 GPIO
序列号的低 32 位为 31
32 板上修订版本
33 板属性 - 其含义取决于板。这可通过设备树在 /proc/device-tree/chosen/rpi-boardrev-ext 中获取
35 序列号的高 32 位 全 64 位序列号可在 /proc/device-tree/serial-number 中获取
50-51 以太网 MAC 地址 这会传递到操作系统中的设备树中,例如 /proc/device-tree/axi/pcie@120000/rp1/ethernet@100000/local-mac-address
52-53 Wi-Fi MAC 地址 这将传递给操作系统中的设备树,例如 /proc/device-tree/axi/mmc@1100000/wifi@1/local-mac-address
54-55 蓝牙 MAC 地址 这将传递给操作系统中的设备树,例如 /proc/device-tree/soc/serial@7d50c000/bluetooth/local-bd-address
77-84 客户 OTP 值
86board 区域 - piwiz 使用的默认键盘区域代码。如果设置,则可通过设备树在 /proc/device-tree/chosen/rpi-country-code 中获取。
87-88 客户以太网 MAC 地址。如果设置,将覆盖 OTP 行 50-51。
89-90 客户 WiFi MAC 地址。如果设置,将覆盖 OTP 行 52-53。
89-90 客户蓝牙 MAC 地址 如果设置,将覆盖 OTP 行 54-55
109-114 工厂设备 UUID 目前是一个 16 位数字 id,应与设备上的条形码匹配。使用零字符填充并进行 c40 编码。
此项信息可通过设备树在 /proc/device-tree/chosen/rpi-duid 中获取。
树莓派连接器用于 PCIe

树莓派连接器用于 PCIe
树莓派 5 在主板的右侧有一个 FPC 连接器。该连接器提供了 PCIe Gen 2.0 ×1 接口,用于连接高速外设。
将 PCIe HAT+ 设备连接到树莓派。你的树莓派应该会自动检测到该设备。要连接非 HAT+ 设备,请将其连接到树莓派,然后手动启用 PCIe。
有关 PCIe FPC 连接器引脚分配和创建第三方设备、配件和扩展板所需的其他详细信息,请参阅树莓派 PCIe 标准文档。建议同时阅读树莓派 HAT+ 规格说明。
注意
目前无法枚举位于在交换机后的 PCIe 设备。
启用 PCIe
默认情况下,除非连接到了 HAT+ 设备,否则不会启用 PCIe 连接器。要启用连接器,请将以下行添加到 /boot/firmware/config.txt :
使用 sudo reboot 重启以使配置更改生效。
注意
你还可以使用别名 nvme。
从 PCIe 启动
默认情况下,树莓派设备不会从 PCIe 存储启动。要启用从 PCIe 启动,请更改引导加载程序配置中的 BOOT_ORDER。使用以下命令编辑 EEPROM 配置:
将 BOOT_ORDER 行替换为如下行:
若要从非 HAT+ 设备启动,还需添加以下行:
保存更改后,使用 sudo reboot 重启你的树莓派以更新 EEPROM。
PCIe 3.0
警告
树莓派 5 未获 3.0 速度认证。PCIe 3.0 连接可能不稳定。
通过 config.txt
连接已被认证符合 Gen 2.0 速度(5 GT/sec),但你可以强制使用 Gen 3.0(10 GT/sec)速度。要启用 PCIe Gen 3.0 速度,请向 /boot/firmware/config.txt 添加以下行:
重启你的树莓派,可使用 sudo reboot 使这些设置生效。
通过 raspi-config
运行以下命令打开树莓派配置 CLI:
完成以下步骤以启用 PCIe Gen 3.0 速度:
选择 Advanced Options。
选择 PCIe Speed。
选择 Yes 以启用 PCIe Gen 3 模式。
选择 Finish 以退出。
使用 sudo reboot 重启你的树莓派,以使这些设置生效。
电源按钮
注意
本小节仅适用于带有电源按钮的树莓派型号,如树莓派 5。
当你首次将树莓派插入电源时,不用按按钮,它可以自动引导并启动到操作系统。
如果你运行着桌面版树莓派,你可以通过短按电源按钮来执行彻底的关机。一个窗口将出现:询问你是否要关机、重启还是注销。
可选择菜单选项或者再次按下电源按钮,直接执行彻底关机。
注意
如果你运行着桌面版树莓派,则可以通过快速连按两下电源按钮来关闭计算机。如果你运行着无桌面界面的树莓派操作系统精简版,则按一下电源按钮即可触发关机流程。
重启
如果树莓派主板已关闭但仍接入电源,按下电源按钮可重启。
注意
重置电源管理芯片(PMIC)也可以重启。连接扩展板会重置 PMIC。在连接扩展板之前,应始终断开设备与电源的连接。
硬关机
要强制执行硬关机,请长按电源按钮。
添加你自己的电源按钮

J2 跳线帽
J2 跳线帽位于 RTC 电池连接器和主板边缘间。在此引出可以让你向树莓派 5 添加自己的电源按钮,方法是添加一个常开 (NO) 瞬时开关,将两个焊盘连接起来。短按此开关将执行与板载电源按钮相同的操作。
电源供应
不同款式的树莓派电源供应要求有所不同。所有型号都需要 5.1V 供应,但通常根据型号需要提高电流。到树莓派 3 为止的所有型号需要一个 micro USB 电源连接器,而树莓派 4、树莓派 400 和树莓派 5 使用 USB-C 连接器。
每个树莓派消耗的电流取决于连接的外围设备。
推荐的电源适配器
对于树莓派 1、2、3,我们推荐使用 2.5A micro USB 适配器。对于树莓派 4、400,我们推荐使用 3A Type-C 适配器。对于树莓派 5,我们推荐使用 27W Type-C 电源适配器。
注意
所有型号的树莓派都不支持 USB-PPS。
注意
如果你使用第三方多接口的 USB-PD 电源适配器,在连接树莓派时,再插入其他设备会导致电源适配器与树莓派之间的重新协商。如果树莓派已开机,可无缝进行。但如果树莓派已关机,该协商可能造成树莓派重启。
以太网供电(PoE)连接器

树莓派 5 PoE 扩展版
树莓派 5 上的以太网插孔支持 PoE +,符合 IEEE 802.3at-2009 PoE 标准。
树莓派 4B 和 3B+ 上的以太网插孔支持 PoE,符合 IEEE 802.3af-2003 PoE 标准。
所有具有 PoE 兼容以太网插孔的树莓派型号都需要通过以太网端口绘制电源的扩展板。对于支持 PoE 的型号,我们建议使用 PoE 扩展板。对于支持 PoE + 的型号,我们建议使用 PoE + 扩展板。
典型功率要求
树莓派 1A
700mA
500mA
200mA
树莓派 1B
1.2A
500mA
500mA
树莓派 1A+
700mA
500mA
180mA
树莓派 1B+
1.8A
1.2A
330mA
树莓派 2B
1.8A
1.2A
350mA
树莓派 3B
2.5A
1.2A
400mA
树莓派 3A+
2.5A
仅受电源、主板和连接器评级限制。
350mA
树莓派 3B+
2.5A
1.2A
500mA
树莓派 4B
3.0A
1.2A
600mA
树莓派 5
5.0A
1.6A(如果使用 3A 电源则为 600mA)
800mA
树莓派 400
3.0A
1.2A
800mA
树莓派 Zero
1.2A
仅受电源、板卡和连接器评级限制
100mA
树莓派 Zero W
1.2A
受电源、主板和连接器额定值的限制。
150mA
树莓派 Zero 2 W
2A
仅受电源、主板和连接器额定值限制。
350mA
注意
当连接到 5A,+5V(25W)的电源能力的适配器时,树莓派 5 可为下游 USB 外设提供 1.6A 的电源。当连接到其他兼容的电源时,树莓派 5 将限制下游 USB 设备的电源为 600mA。
大多数树莓派能提供足够的电流给 USB 外设,可供应大多数 USB 设备,如键盘、鼠标和适配器。然而,某些设备需要额外的电流,比如调制解调器、外置磁盘和大功率天线。如果要连接某 USB 设备,但是其电力需求超过了上表中指定的数值,请使用带外部供电的 USB 集线器。
如果你在树莓派上使用各种接口,其电力需求会增加。GPIO 引脚总共可安全供给 50mA;每个引脚最多可单独供给 16mA。HDMI 使用 50mA。相机模块需要 250mA。USB 键盘和鼠标可消耗从 100mA 到 1000mA 不等的电流。请检查你准备连接到树莓派的设备的功率,并相应购买适配器。如不确定,请使用带外部供电的 USB 集线器。
运行以下命令检查输出到 USB 的电力状态:
以下表格总结了不同树莓派型号在各种工作负载期间所绘制的功率(A)量:
引导
最大
0.26
0.40
0.75
0.20
0.85
平均
0.22
0.22
0.35
0.15
0.7
闲置
平均
0.20
0.22
0.30
0.10
0.6
视频播放(H.264)
最大
0.30
0.36
0.55
0.23
0.85
平均
0.22
0.28
0.33
0.16
0.78
压力
最大
0.35
0.82
1.34
0.35
1.25
平均
0.32
0.75
0.85
0.23
1.2
停止当前
0.10
0.055
0.023
注意
这些测量基于标准的树莓派系统镜像(截至 2016 年 2 月 26 日,对于树莓派 4 为 2019 年 6 月),室温,树莓派接入了 HDMI 显示器、USB 键盘和 USB 鼠标。树莓派 3A 接入到了无线局域网接入点,树莓派 4 连接到了以太网。所有这些功耗测量均为近似值,并未考虑来自额外 USB 设备的功耗;如果接入了多个额外 USB 设备和扩展板,功耗很容易超过这些测量值。
树莓派 4 和计算模块 4 上附加的电源管理功能
树莓派 4 和计算模块 4 上的额外电源管理功能
树莓派 4 和 CM4 上采用了多种不同的电源管理芯片(PMIC)。所有这些电源管理芯片(PMIC)都提供了额外的功能,除了电压供应之外。本文档概述了如何在软件中使用这些功能。
降低树莓派 5 关机后的功率
在默认情况下,树莓派 5 关机后仍会消耗电力,约 1 至 1.4 瓦。可以减少这种功率消耗:手动编辑 EEPROM 配置:即 sudo rpi-eeprom-config -e。将设置更改为以下内容:
在关机后,功耗应该会降至约 0.01 W。
电源供应警告
自树莓派 B+(2014 年)以降的所有型号,除了 Zero 系列,均配备了低电压检测电路,如检测到供电电压低于 4.63 V(±5%),将在内核日志中打印一行信息。
如果你看到警告,请切换到更高质量的电源适配器和充电线。劣质电源会损坏存储设备甚至诱发树莓派产生未知行为。
电压会因多种原因而降低:你可能已将太多高需求的 USB 设备插入;电源适配器供应可能不足;接入适配器的充电线可能过细。
制作更具弹性的文件系统
创建更具弹性的文件系统
树莓派设备经常用作数据存储和监控设备,通常在可能发生意外断电的地方使用。与所有计算设备一样,电力中断可能造成存储损坏。
本白皮书提供了一些参数,介绍了如何通过选择适当的文件系统和设置来防止在以上以及其他情况下的数据损坏,以确保数据完整性。
电源和树莓派系统
引导加载程序通过设备树 /proc/device-tree/chosen/power 传递有关电源供应的信息。用户通常不会直接阅读此信息。
max_current 最大电流(单位:mA)
PDO 转储——高级用户的调试
是否将电流限制器设置为高或低
在将控制权转移给操作系统之前,启动期间是否发生过 USB 过电流
重置事件电源管理芯片(PMIC)重置原因,如看门狗、过压或欠压、过温
电源管理芯片(PMIC)带有内置 ADC,可以测量供电电压 EXT5V_V 等等。使用以下命令查看 ADC 测量值:
你无法看到 USB 电流或其他直接连接到 5V 的设备,因为这将绕过电源管理芯片(PMIC)。你不应该期望这些值加起来等于电源供应的瓦(w)数。但是,监视核心电压等事项可能很有用。
反向供电
USB 规范要求 USB 设备不能向上游设备供电。如果 USB 设备向上游设备供电,则称为反向供电。通常是因为连接了劣质的带供电的 USB 集线器,并且会导致带电 USB 集线器向主机的 树莓派 供电。不建议这么做,因为通过集线器向树莓派供电会绕过树莓派中内置的保护电路,使其在发生电涌时易受损坏。
实时时钟(RTC)
树莓派 5 内置了一个 RTC 模块。它通过位于 Type-C 电源连接器右侧,主板上的 J5(BAT)连接器接入电池供电。

J5 电池连接器
你可以设置唤醒闹钟,将主板切换至极低功耗状态(约 3mA)。达到闹钟时间时,主板将重新上电。这对像延时摄像这样的周期性任务非常有用。
编辑引导加载程序配置以支持唤醒警报的低功率模式:
添加以下两行。
你可以使用以下方式测试功能:
将会使板子进入极低功耗状态,然后在 10 分钟后唤醒并重启。
RTC 还提供了启动时的时间,如 dmesg,适用于缺乏 NTP 访问权限的用例:
注意
即使备用电池未接入 J5 连接器,RTC 仍然可用。
添加备用电池

锂锰可充电 RTC 电池
官方电池配件是一枚可充电的锂锰硬币电池,配有预装的两针 JST-SH 插头和粘性安装触点。适用于在主板的主电源断开时为 RTC 供电。由于关机时的电流吸收为个位数 µA,可使用时间为几个月。
注意
我们不建议使用一次性(不可充电)的锂电池为 RTC 提供电源。RTC 的备用电流消耗比大多数专用 RTC 模块更高,这将导致电池的使用寿命缩短。
警告
不要使用锂离子电池作为 RTC 的电源。
启用电池充电
RTC 配备了恒流(3mA)恒压充电器。
默认情况下,已禁用电池充电。sysfs 文件显示了充电电压和限制:
要设定电压为电池充电,请添加 rtc_bbat_vchg 到 /boot/firmware/config.txt:
sudo reboot 重启来使用新的电压设置。检查 sysfs 文件,确保已正确设置充电电压。
禁用电池充电
要停止充电,请在 config.txt 删除所有 rtc_bbat_vchg 相关行。
串行外围设备接口(SPI)
树莓派计算机配备多个 SPI 总线。SPI 可用于连接各种外围设备:显示器、网络控制器(以太网、CAN 总线)、UART 等。这些设备最好由内核设备驱动程序支持,但 spidev API 允许用多种语言编写用户空间驱动程序。
SPI 硬件
树莓派 Zero、1、2 和 3 都有三个 SPI 控制器:
SPI0,带有两个硬件片选,在所有树莓派的排针上均可用;此外还有一种仅适用于计算模块的备用映射。SPI1,带有三个硬件片选,在除初代树莓派 1 Model A 和 Model B 之外的所有树莓派型号上均可用。SPI2,同样带有三个硬件片选,仅在计算模块 1、3 和 3+ 上可用。
在树莓派 4、400,计算模块 4 上,还有四个额外的 SPI 总线:SPI3 到 SPI6,每个总线都有两个硬件芯片选择器。这些额外的 SPI 总线可通过某些 GPIO 引脚的替代功能分配来使用。有关更多信息,请参阅 BCM2711 Arm 外围设备数据表。
BCM2835 Arm 外围设备数据表的第 10 章介绍了主控制器。第 2.3 章说明了辅助控制器。
树莓派 5、500、500+ 和计算模块 5
在树莓派 5 上,SPI 功能由 RP1 IO 控制器而非主应用处理器提供。
RP1 包含九个同步串行接口(SSI)控制器。其中六个路由到 GPIO 组 0。其余三个——SPI6、SPI7 和 SPI8——位于 RP1 内部,不路由到标准 40 针 GPIO 排针。
SPI0,带有四个硬件片选。SPI1,带有三个硬件片选。SPI2,带有两个硬件片选。SPI3,带有两个硬件片选。SPI4,带有一个硬件片选。SPI5,带有两个硬件片选。
注意
RP1 SPI 控制器不支持 DDR(双倍数据速率)操作。
SPI4和SPI7总线仅支持设备模式。
引脚/GPIO 映射
SPI0
MOSI
19
GPIO10
SPI0_MOSI
MISO
21
GPIO09
SPI0_MISO
SCLK
23
GPIO11
SPI0_SCLK
CE0
24
GPIO08
SPI0_CE0_N
CE1
26
GPIO07
SPI0_CE1_N
SPI0 备用镜像(仅限计算模块,不包括 CM4)
MOSI
GPIO38
SPI0_MOSI
MISO
GPIO37
SPI0_MISO
SCLK
GPIO39
SPI0_SCLK
CE0
GPIO36
SPI0_CE0_N
CE1
GPIO35
SPI0_CE1_N
SPI1
MOSI
38
GPIO20
SPI1_MOSI
MISO
35
GPIO19
SPI1_MISO
SCLK
40
GPIO21
SPI1_SCLK
CE0
12
GPIO18
SPI1_CE0_N
CE1
11
GPIO17
SPI1_CE1_N
CE2
36
GPIO16
SPI1_CE2_N
SPI2(仅适用于计算模块,不含 CM4)
MOSI
GPIO41
SPI2_MOSI
MISO
GPIO40
SPI2_MISO
SCLK
GPIO42
SPI2_SCLK
CE0
GPIO43
SPI2_CE0_N
CE1
GPIO44
SPI2_CE1_N
CE2
GPIO45
SPI2_CE2_N
SPI3(仅限 BCM2711)
MOSI
03
GPIO02
SPI3_MOSI
MISO
28
GPIO01
SPI3_MISO
SCLK
05
GPIO03
SPI3_SCLK
CE0
27
GPIO00
SPI3_CE0_N
CE1
18
GPIO24
SPI3_CE1_N
SPI4(仅限 BCM2711)
MOSI
31
GPIO06
SPI4_MOSI
MISO
29
GPIO05
SPI4_MISO
SCLK
26
GPIO07
SPI4_SCLK
CE0
07
GPIO04
SPI4_CE0_N
CE1
22
GPIO25
SPI4_CE1_N
SPI5(仅限 BCM2711)
MOSI
08
GPIO14
SPI5_MOSI
MISO
33
GPIO13
SPI5_MISO
SCLK
10
GPIO15
SPI5_SCLK
CE0
32
GPIO12
SPI5_CE0_N
CE1
37
GPIO26
SPI5_CE1_N
SPI6(仅限 BCM2711)
MOSI
38
GPIO20
SPI6_MOSI
MISO
35
GPIO19
SPI6_MISO
SCLK
40
GPIO21
SPI6_SCLK
CE0
12
GPIO18
SPI6_CE0_N
CE1
13
GPIO27
SPI6_CE1_N
主模式
信号名称缩写:
SCLK 串行时钟
CEchip 启用(通常称为芯片选择)
MOSI 主发送从接收
MISO 主接收从发送
MOMI 主在主出
标准模式
在标准 SPI 模式下,外设实现标准三线串行协议(SCLK,MOSI 和 MISO)。
双向模式
在双向 SPI 模式中,实现了相同的 SPI 标准,只是使用单根导线传输数据(MOMI),而不是标准模式下使用的两根导线(MISO 和 MOSI)。在这种模式下,MOSI 引脚充当 MOMI 引脚。
低速串行接口(LoSSI)模式
LoSSI 标准允许向外围设备(LCD)发出命令并在它们之间传输数据。LoSSI 命令和参数均为 8 位长,但额外的一位用于指示 B 是命令还是参数/数据。数据时此额外位设置为高位,命令时设置为低位。最终的 9 位值被串行化输出。LoSSI 常与 MIPI DBI 类型 C 兼容的 LCD 控制器一起使用。
注意
某些命令会触发 SPI 控制器自动读取,因此该模式不能用作多功能的 9 位 SPI。
传输模式
轮询
中断
DMA
速度
CLK 寄存器的时钟分频器 (CDIV) 字段设置了 SPI 时钟速度:
SCLK 核心时钟 / CDIV
如果 CDIV 设置为 0,则除数为 65536。除数必须是 2 的倍数,奇数向下舍入。请注意,由于模拟电气问题(上升时间、驱动强度等),并非所有可能的时钟速率都可用。
查看 Linux 驱动程序部分获取更多信息。
芯片选择
在 DMA 模式下操作时,与 CS 线的自动断言和取消断言相关的建立时间和保持时间如下:
CS 线将在传输的第一个字节的 msb 之前至少提前三个核心时钟周期。
CS 线将在最后的时钟脉冲的下降沿后至少延迟一个核心时钟周期取消断言。
SPI 软件
Linux 驱动程序
默认的 Linux 驱动程序是 spi-bcm2835。
在默认情况下,SPI0 已被禁用。要启用,请使用 raspi-config,或确保 dtparam=spi=on 在 /boot/firmware/config.txt 中没有被注释掉。默认情况下,它使用两个芯片选择线,但可以使用 dtoverlay=spi0-1cs 将其减少到一个。还有 dtoverlay=spi0-2cs;没有任何参数时,它等效于 dtparam=spi=on。
要启用 SPI1,你可以使用 1、2 或 3 个芯片选择线。将适当的线添加到 /boot/firmware/config.txt 中:
类似的叠加层也适用于 SPI2、SPI3、SPI4、SPI5 和 SPI6。
驱动程序不使用硬件片选线,因为某些限制。相反,它可以使用任意数量的 GPIO 作为软件/GPIO 片选。这意味着你可以选择任何多余的 GPIO 作为 CS 线,所有这些 SPI 叠加层都包括该控制:详情请见 /boot/firmware/overlays/README,或运行(例如) dtoverlay -h spi0-2cs (可能有助于列出所有这些)。
速度
该驱动程序支持所有是核心时钟的偶数整除数的速度,尽管如上所述,并非所有这些速度都将支持数据传输,因为 GPIO 和连接的设备存在限制。作为经验法则,任何大于 50MHz 的速度都不太可能工作,但具体情况可能有所不同。
支持的模式位
SPI_CPOL 时钟极性
SPI_CPHA 时钟相位
SPI_CS_HIGH 芯片选择高电平
SPI_NO_CS1 每总线一个设备,无芯片选择
SPI_3WIRE 双向模式,数据输入输出引脚共享
双向模式,也称为 3 线模式,由 spi-bcm2835 内核模块支持。请注意,在此模式下,spi_transfer 结构体的 tx 或 rx 字段必须是 NULL 指针之一,因为只支持半双工通信。否则,传输将失败。spidev_test.c 的源代码未正确考虑此情况,因此在 3 线模式下根本无法工作。
支持的每字比特数
8 - 正常
9 - 支持使用 LoSSI 模式
传输模式
所有 SPI 总线均支持中断模式。SPI0 和 SPI3-6 还支持 DMA 传输。
SPI 驱动延迟
此线程讨论延迟问题。
spidev
spidev 提供了一个基于用户空间的单个 SPI CS 线接口。设备树用于指示 CS 线是由内核驱动模块驱动还是由 spidev 代表用户管理;不能同时两者都做。请注意,树莓派自己的内核对于使用设备树启用 spidev 更为宽松——上游内核会打印关于此类用法的警告,最终可能会彻底阻止之。
在 C 语言中使用 spidev
Linux 文档中有一个环回测试程序,可用作起点。请参阅故障排除部分。
在 Python 中使用 spidev
有几个 Python 库能访问 spidev,包括 spidev ( pip install spidev:参见 https://pypi.org/project/spidev/) 和 SPI-Py ( https://github.com/lthiery/SPI-Py)。
使用 spidev 从像 bash 这样的 shell
以下命令写入二进制 1、2 和 3:
其他 SPI 库
还有其他用户空间库可以通过直接操作硬件来提供 SPI 控制:这并不推荐。
故障排除
回环测试
这可以用来测试 SPI 发送和接收。在 MOSI 和 MISO 之间放一根电线。它未不测试 CE0 和 CE1。
上述部分内容是从 elinux SPI 页面复制而来的,该页面也引用了这里。两者都受 CC-SA 许可协议保护。
通用串行总线(USB)
一般来说,所有 Linux 支持的设备,树莓派都能用,尽管在树莓派 4 之前的型号上有一些限制。
最大功率输出
与所有计算机一样,树莓派上的 USB 端口提供的功率有限。USB 设备通常因电力问题而出现故障。要排除电力不足引发问题的可能性,请使用带供电的集线器把 USB 设备接入树莓派。
树莓派 Zero, 1
每端口各 500mA①
树莓派 2, 3, 4
所有端口共 1200mA
树莓派 5
若使用 3A 电源,电流为 600mA;若使用 5A 电源,电流为 1600mA
① 对于旧款树莓派 1 A,每端口限制为各 100mA。
树莓派 5
树莓派 5 需要高质量 Type-C 电源适配器才能启动,最低为 +5V 3A(15W)。然而,用这样的电源适配器会限制外部设备的电流。如果你在首次启动时没有使用 +5V 5A 的电源适配器,操作系统会告警,将外部设备的电流限制为 600mA。
如果用户希望驱动大功率外设(如硬盘和固态硬盘),同时维持面对峰值工作负载仍有余量。应使用能够提供 +5V 5A(25W)的 USB-PD 电源适配器。如果树莓派 5 固件检测到了这样的电源适配器,它会把外设的 USB 电流限制缓解至 1.6A,为下游 USB 设备提供额外 5W 电力,同时为主板上电力预算提供额外的 5W 电力。
注意
USB 和风扇接口共用一笔电力预算。
树莓派 4
树莓派 4 提供了两个 USB 3.0 接口和两个 USB 2.0 端口,它们连接至 VL805 USB 控制器。四个接口上所有的 USB 2.0 均连接到了 VL805 内的单个 USB 2.0 集线器。这限制了 USB 1.1 和 USB 2.0 设备的总可用带宽,即与单个 USB 2.0 端口是一样的。
旧版树莓派 4 上的 USB Type C 接口使用的 USB 控制器,在默认情况下已被禁用。
树莓派 Zero,1,2 和 3
树莓派 1 代 B+、树莓派 2 和树莓派 3 主板提供了四个 USB 2.0 端口。树莓派 Zero 主板配备一个 micro USB on-the-go (OTG) 端口。
树莓派 4 之前的型号上的 USB 控制器仅对某些设备提供基本支持,这会带来较高的软件处理开销。它仅支持一个根 USB 接口:所有连接设备的流量都通过此单一总线传输,该总线的最大速度为 480Mbps。
USB 2.0 规范定义了三种设备速度:低速、全速和高速。大多数鼠标和键盘是低速设备,大多数 USB 声音设备是全速设备,而大多数视频设备(网络摄像头/视频捕捉器)是高速设备。
若把多个高速 USB 设备同时接入树莓派,一般没有问题。
与低速和全速设备通信时产生的软件开销意味着同时活动的低速和全速设备数量会受限制。连接少量这些类型设备到树莓派不会造成问题。
已知的 USB 故障
与 USB 3.0 集线器的互操作性
在使用全速/低速设备(如大多数鼠标和键盘)时,与 USB 3.0 集线器一起使用的问题。大多数 USB 3.0 集线器硬件中存在的一个错误:意味着在连接到 USB 3.0 集线器的全速/低速设备时,树莓派 4 之前的型号无法与这些设备通信。
在通过 USB 3.0 集线器接入时,USB 2.0 高速设备(包括 USB 2.0 集线器)可正确运行。
避免将低速/全速设备连接到 USB 3.0 集线器。作为解决方法,将 USB 2.0 集线器插入 USB 3.0 集线器的下游端口,然后将低速设备连接,或者在树莓派和 USB 3.0 集线器之间使用 USB 2.0 集线器,然后将低速设备插入 USB 2.0 集线器。
USB 1.1 网络摄像头
旧的网络摄像头可能是全速设备。因为这些设备传输大量数据并产生额外的软件开销,无法保证可靠运行。作为解决方法,请尝试通过分辨率调用摄像头。
Esoteric USB 声卡
昂贵的发烧友级声卡通常会占用大量的 USB 带宽。不能保证 96kHz/192kHz DAC 的可靠性。作为一种解决方法,可强制输出流为 CD 音质(44.1kHz/48kHz 16 位),把带宽降低到可靠水平。
单个 TT USB 集线器
USB 2.0 和 3.0 集线器具有一种机制,用于与连接到其下游接口的全速/低速设备通信,即事务转换器 (TT)。此设备可缓冲来自主机的高速请求,并将它们以全速/低速传输给下游设备。USB 规范允许两种集线器配置:单个 TT (所有接口共用一个 TT) 和多个 TT (每端口一个 TT)。由于硬件限制,如果将大量全速/低速设备插入单个 TT 集线器,这些设备可能会表现的不大稳定。建议使用多个 TT 集线器与多个全速/低速设备进行接口处理。作为一种解决方法,可将全速和低速设备分散放置在树莓派自己的 USB 端口和单个 TT 集线器之间。
树莓派修订代码
每个不同款的树莓派修订版都有一个唯一的修订代码。你可以通过运行以下命令,查找树莓派的修订代码:
最后三行显示了硬件类型、修订代码和树莓派的唯一序列号。例如:
注意
所有树莓派计算机都报告为 BCM2835,即使是搭载 BCM2836、BCM2837、BCM2711 和 BCM2712 处理器的也一样。你不应该使用此字符串来检测处理器。可使用下面的信息解码修订代码,或
cat /sys/firmware/devicetree/base/model。
旧式修订代码
树莓派的第一批型号从 0002 到 0015 分配了顺序十六进制修订代码:
0002
B
1.0
256MB
韵动电子
0003
B
1.0
256MB
韵动电子
0004
B
2.0
256MB
索尼英国
0005
B
2.0
256MB
佳世达
0006
B
2.0
256MB
韵动电子
0007
A
2.0
256MB
韵动电子
0008
A
2.0
256MB
索尼英国
0009
A
2.0
256MB
佳世达
000d
B
2.0
512MB
韵动电子
000e
B
2.0
512MB
索尼英国
000f
B
2.0
512MB
韵动电子
0010
B+
1.2
512MB
索尼英国
0011
CM1
1.0
512MB
索尼英国
0012
A+
1.1
256MB
索尼英国
0013
B+
1.2
512MB
英蓓特
0014
CM1
1.0
512MB
英蓓特
0015
A+
1.1
256MB/512MB
英蓓特
新式修订代码
随着使用树莓派 2 的推出,引入了新样式的修订代码。不同于顺序的是,十六进制代码的每一位都代表修订码的一部分信息:
N(位 31)
过压
0:允许过压
1:禁止过压
O (位 30)
OTP 程序①
0:允许 OTP 编程
1:禁止 OTP 编程
Q(位 29)
OTP 读取①
0:允许 OTP 读取
1:OTP 读取不允许
uuu(位 26-28)
未使用
未使用
W(位 25)
保修位②
0: 担保保修有效
1: 因超频而无效的保修保证
u (位 24)
未使用
未使用
F(位 23)
新标志
1:新风格修订
0:旧风格修订
MMM(位于第 20-22 位)
存储器大小
0:256MB
1: 512MB
2: 1GB
3: 2GB
4:4GB
5:8GB
CCCC(位于 16-19 位)
制造商
0: 索尼英国
1: 韵动电子
2: 英蓓特
3: 索尼日本
4: 英蓓特
5:Stadium
PPPP(位 12-15)
处理器
0: BCM2835
1: BCM2836
2: BCM2837
3: BCM2711
4: BCM2712
TTTTTTTT (位于 4-11 位)
类型
0:A
1:B
2:A+
3:B+
4:2B
5:Alpha(早期原型)
6:CM1
8:3B
9:Zero
a:CM3
c:Zero W
d:3B+
ext: e:3A+
f:仅供内部使用
10:CM3+
11:4B
12:Zero 2 W
13: 400
14:CM4
15:CM4S
16:仅供内部使用
17: 5
RRRR(位 0-3)
修订
0、1、2 等。
① 编程 OTP 位的信息。
② 在树莓派 4 上从未设置过保修位。
使用新样式的修订代码
注意
此列表不是详尽无遗的:可能有正在使用的,但未出现在此表中的代码。请参阅下一节,了解如何使用修订代码来识别板子的最佳实践。
900021
A+
1.1
512MB
索尼英国
900032
B+
1.2
512MB
索尼英国
900092
Zero
1.2
512MB
索尼英国
900093
Zero
1.3
512MB
索尼英国
9000c1
Zero W
1.1
512MB
索尼英国
9020
3A+
1.0
512MB
索尼英国
90200
3A+
1.1
512MB
索尼英国
920092
Zero
1.2
512MB
英蓓特
920093
Zero
1.3
512MB
英蓓特
900061
CM1
1.1
512MB
索尼英国
a01040
2B
1.0
1GB
索尼英国
a01041
2B
1.1
1GB
索尼英国
a02082
3B
1.2
1GB
索尼英国
a020a0
CM3
1.0
1GB
索尼英国
a020d3
3B+
1.3
1GB
索尼英国
a020d4
3B+
1.4
1GB
索尼英国
a02042
2B(搭载 BCM2837)
1.2
1GB
索尼英国
a21041
2B
1.1
1GB
英蓓特
a22042
2B(搭载 BCM2837)
1.2
1GB
英蓓特
a22082
3B
1.2
1GB
英蓓特
a220a0
CM3
1.0
1GB
英蓓特
a32082
3B
1.2
1GB
索尼日本
a52082
3B
1.2
1GB
Stadium
a22083
3B
1.3
1GB
英蓓特
a02100
CM3+
1.0
1GB
索尼英国
a03111
4B
1.1
1GB
索尼英国
b03111
4B
1.1
2GB
索尼英国
b03112
4B
1.2
2GB
索尼英国
b03114
4B
1.4
2GB
索尼英国
b03115
4B
1.5
2GB
索尼英国
c03111
4B
1.1
4GB
索尼英国
c03112
4B
1.2
4GB
索尼英国
c03114
4B
1.4
4GB
索尼英国
c03115
4B
1.5
4GB
索尼英国
d03114
4B
1.4
8GB
索尼英国
d03115
4B
1.5
8GB
索尼英国
c03130
400
1.0
4GB
索尼英国
a03140
CM4
1.0
1GB
索尼英国
b03140
CM4
1.0
2GB
索尼英国
c03140
CM4
1.0
4GB
索尼英国
d03140
CM4
1.0
8GB
索尼英国
902120
Zero 2 W
1.0
512MB
索尼英国
b04170
5
1.0
2GB
索尼英国
c04170
5
1.0
4GB
索尼英国
d04170
5
1.0
8GB
索尼英国
使用修订代码进行板卡识别
在命令行,我们可以使用以下命令获取板卡的修订代码:
在以上示例,我们有一个十六进制的修订代码 c03111。将其转换为二进制,我们得到 0 0 0 000 0 0 1 100 0000 0011 00010001 0001。上表已插入空格,为显示修订代码的各部分之间的边界。
从最低阶位开始,底部的四位(0-3)是板子的修订号,所以这块板子的修订号是 1。接下来的八位(4-11)是板子类型,在这种情况下是二进制 00010001,十六进制 11,所以这是个树莓派 4B。使用相同的过程,我们可以确定处理器是 BCM2711,板子由索尼英国制造,并且内存为有 4GB。
在你的程序中获取修订代码
很明显,有如此多的编程语言,不可能为所有的语言都举例,但这里有两个简单的例子,分别面向 C 和 Python。这两个例子都使用系统调用,运行一个 bash 命令,获取 cpuinfo 将结果传送给 awk 来还原所需的修订代码。然后,它们使用位操作来提取代码中的 New、Model 和 Memory 字段。
同样的 Python 代码:
使用修订代码的最佳实践
为了避免在创建新的板卡版本时出现问题,请不要使用版本代码(例如 c03111 )。
一个天真的实现是使用支持的版本代码列表,将检测到的代码与该列表进行比较,以决定该设备是否受支持。当出现新的板卡版本或者生产地点发生变化时,这种方法就会失效:每次都会创建新的版本代码时,都不在支持的版本代码列表中。这将导致同一板卡类型的新版本被拒绝,尽管它们始终保持向后兼容。每当出现新版本时,你都必须发布一个包含新版本代码的新支持的版本代码列表——这是一项繁重的开发负担。
还请使用若干以下方法:
根据板型字段(3A、4B 等)进行过滤,该字段表示型号,但不表示修订版。
根据内存量字段进行过滤,因为内存容量大致对应板子的计算能力。
例如,你可以限制搭载了 2GB 和更大内存的树莓派 4B 型号。上一节的示例即采用这种推荐方法。
注意
请始终检查第 23 位,即“New”标志,确保修订代码是新版本,然后再检查其他字段。
检查树莓派型号和 CPU 跨发行版
在各个 Linux 发行版中,对 /proc/cpuinfo 的支持和格式会有所不同。要检查树莓派设备在 Linux 发行版(包括树莓派系统)上的型号和 CPU,请检查设备树:
输出两个空值分隔的字符串值,每个字符串值包含逗号分隔的制造和型号。例如,树莓派 5 输出上述主板和 CPU 字符串。其对应以下值:
raspberrypi (主板制造商)
5-model-b (主板型号)
brcm (CPU 制造商)
bcm2712 (CPU 型号)
树莓派型号具有以下设备树数值:
树莓派 5
raspberrypi
5-model-b
brcm
bcm2712
树莓派 400
raspberrypi
400
brcm
bcm2711
树莓派计算模块 4
raspberrypi
4-compute-module
brcm
bcm2711
树莓派 4A
raspberrypi
4-model-a
brcm
bcm2711
树莓派 4B
raspberrypi
4-model-b
brcm
bcm2711
树莓派计算模块 3
raspberrypi
3-compute-module
brcm
bcm2837
树莓派 3A+
raspberrypi
3-model-a-plus
brcm
bcm2837
树莓派 3B+
raspberrypi
3-model-b-plus
brcm
bcm2837
树莓派 3B
raspberrypi
3-model-b
brcm
bcm2837
树莓派 2B
raspberrypi
2-model-b
brcm
bcm2836
树莓派计算模块
raspberrypi
compute-module
brcm
bcm2835
树莓派 A+
raspberrypi
model-a-plus
brcm
bcm2835
树莓派 A+
raspberrypi
model-b-plus
brcm
bcm2835
树莓派 A 修订版 2
raspberrypi
model-b-rev2
brcm
bcm2835
树莓派 A
raspberrypi
model-a
brcm
bcm2835
树莓派 A
raspberrypi
model-b
brcm
bcm2835
树莓派 Zero 2 W
raspberrypi
model-zero-2-w
brcm
bcm2837
树莓派 Zero
raspberrypi
model-zero
brcm
bcm2835
树莓派 Zero W
raspberrypi
model-zero-w
brcm
bcm2835
最后更新于