Raspberry Pi 5 额外 PMIC 计算模块 4
版权页
2020-2023 Raspberry Pi Ltd（以前称为 Raspberry Pi (Trading) Ltd.）本文档根据知识共享署名-禁止演绎 4.0 国际 (CC BY-ND 4.0) 许可证进行许可。
- 构建日期：2024-07-09
- 构建版本：githash：3d961bb-clean
法律免责声明
RASPBERRY PI 产品（包括数据表）的技术和可靠性数据（包括不时修改的“资源”）由 RASPBERRY PI LTD（“RPL”）“按原样”提供，并且不承担任何明示或暗示的保证，包括但不限于适销性和针对特定用途的适用性的暗示保证。在适用法律允许的最大范围内，在任何情况下，RPL 均不对任何直接、间接、偶然、特殊、惩戒性或后果性损害（包括但不限于采购替代货物或服务；使用、数据或利润损失；或业务中断）承担责任，不论该等损害是如何造成的，也不论是基于何种责任理论，无论是合同、严格责任还是侵权（包括疏忽或其他），无论该等损害是否因使用资源而以任何方式引起，即使 RPL 已被告知有此类损害的可能性。 RPL 保留随时对资源或其中描述的任何产品进行任何增强、改进、更正或任何其他修改的权利，恕不另行通知。资源适用于具有适当设计知识水平的熟练用户。用户对其对资源的选择和使用以及其中描述的产品的任何应用负全部责任。用户同意赔偿并免除 RPL 因其使用资源而产生的所有责任、费用、损害或其他损失。RPL 仅允许用户将资源与 Raspberry Pi 产品结合使用。禁止将资源用于其他任何用途。未授予任何其他 RPL 或其他第三方知识产权的许可。高风险活动。 Raspberry Pi 产品并非设计、制造或预期用于需要故障安全性能的危险环境，例如核设施、飞机导航或通信系统、空中交通管制、武器系统或安全关键型应用（包括生命支持系统和其他医疗设备）的运行，在这些环境中，产品故障可能直接导致死亡、人身伤害或严重的物理或环境损害（“高风险活动”）。RPL 明确否认任何明示或暗示的高风险活动适用性保证，并且对于在高风险活动中使用或包含 Raspberry Pi 产品不承担任何责任。Raspberry Pi 产品受 RPL 标准条款的约束。RPL 提供的资源不会扩展或以其他方式修改 RPL 标准条款，包括但不限于其中表达的免责声明和保证。
文档版本历史
| 发布 | 日期 | 描述 |
| 1.0 | 16 年 2022 月 XNUMX 日 | • 初始发行 |
| 1.1 | 7 七月 2024 | • 修复 vcgencmd 命令中的拼写错误，添加了 Raspberry Pi
5 细节。 |
文件范围
本文档适用于以下树莓派产品：
| Pi 零 | 树莓派 1 | 树莓派 2 | 树莓派 3 | 树莓派 4 | 树莓派 5 | Pi 400 | CM1 | CM3 | CM4 | 微微 | ||||||||
| 零 | W | H | A | B | A+ | B+ | A | B | B | A+ | B+ | 全部 | 全部 | 全部 | 全部 | 全部 | 全部 | 全部 |
| * | * | * | * | |||||||||||||||
介绍
Raspberry Pi 4/5 和 Raspberry Pi Compute Module 4 设备使用电源管理集成电路 (PMIC) 为各种电压供电tagPCB 上各种组件所需的电源。它们还能对上电进行排序，以确保设备按正确顺序启动。在这些型号的生产过程中，我们使用了多种不同的 PMIC 器件。所有 PMICS 都提供了超出卷的额外功能。tag供应：
- 两个可在 CM4 上使用的 ADC 通道。
- 在 Raspberry Pi 4 和 Raspberry Pi 400 的后续版本以及 Raspberry Pi 5 的所有型号中，ADC 都连接到 CC1 和 CC2 上的 USB-C 电源连接器。
- 可用于监测 PMIC 温度的片上传感器，可在 Raspberry Pi 4 和 5 以及 CM4 上使用。
本文档介绍了如何在软件中访问这些功能。
警告
无法保证此功能将在 PMIC 的未来版本中保留，因此应谨慎使用。
您可能还希望参考以下文档：
- Raspberry Pi CM4 数据表： https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
- Raspberry Pi 4 简化原理图： https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf
本白皮书假设 Raspberry Pi 运行 Raspberry Pi OS，并且完全更新最新的固件和内核。
使用功能
最初，这些功能只能通过直接读取 PMIC 本身的寄存器来实现。然而，寄存器地址会根据所使用的 PMIC（以及电路板版本）而变化，因此 Raspberry Pi Ltd 提供了一种与版本无关的获取这些信息的方法。这需要使用命令行工具 vcgencmd，该程序允许用户空间应用程序访问存储在 Raspberry Pi Ltd 设备固件中或从其访问的信息。
可用的 vcgencmd 命令如下：
| 命令 | 描述 |
| vcgencmd 测量电压 usb_pd | 测量音量tag位于标有 usb_pd 的引脚上（参见 CM4 IO 原理图）。仅限 CM4。 |
| vcgencmd 测量电压 ain1 | 测量音量tag位于标记为 ain1 的引脚上（参见 CM 4 IO 原理图）。仅限 CM4。 |
| vcgencmd 测量温度 pmic | 测量 PMIC 芯片的温度。CM4 以及 Raspberry Pi 4 和 5。 |
所有这些命令都是从 Linux 命令行运行的。
使用程序代码中的功能
如果您需要应用程序内部的信息，可以通过编程方式使用这些 vcgencmd 命令。在 Python 和 C 语言中，都可以使用 OS 调用来运行命令并以字符串形式返回结果。以下是一些示例amp可用于调用 vcgencmd 命令的 Python 代码：
此代码使用 Python subprocess 模块调用 vcgencmd 命令，并传入针对 pmic 的measure_temp 命令，该命令将测量 PMIC 芯片的温度。该命令的输出将打印到控制台。
这是一个类似的示例ampC 中的 le：
C 代码使用 popen（而不是 system()，这也是一种选择），并且可能比需要的更冗长一些，因为它可以处理来自调用的多行结果，而 vcgencmd 仅返回一行文本。
笔记
这些代码摘录仅作为示例提供amp文件，你可能需要根据具体需求进行修改。例如ample，您可能想要解析 vcgencmd 命令的输出以提取温度值以供稍后使用。
常见问题
- 问：我可以在所有 Raspberry Pi 型号上使用这些功能吗？
- 答：不，这些功能专门适用于 Raspberry Pi 4、Raspberry Pi 5 和 Compute Module 4 设备。
- 问：将来使用这些功能是否安全？
- 答：无法保证此功能将在未来的 PMIC 版本中保留，因此建议在使用这些功能时要小心。
文件/资源
 |
树莓派 Raspberry Pi 5 Extra PMIC 计算模块 4 [pdf] 使用说明书 Raspberry Pi 4、Raspberry Pi 5、计算模块 4、Raspberry Pi 5 额外 PMIC 计算模块 4、Raspberry Pi 5、额外 PMIC 计算模块 4、计算模块 4 |