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 授予使用者僅與 Raspberry Pi 產品結合使用資源的權限。禁止對資源進行任何其他使用。未授予任何其他 RPL 或其他第三方智慧財產權許可。高風險活動。 Raspberry Pi 產品並非設計、製造或預期用於需要故障安全性能的危險環境，例如核設施、飛機導航或通訊系統、空中交通管制、武器系統或安全關鍵型應用（包括生命維持系統和其他醫療設備）的運行，在這些環境中，產品故障可能直接導致死亡、人身傷害或嚴重的物理或環境損害（「高風險活動」）。 RPL 明確否認對高風險活動的適用性提供任何明示或暗示的保證，並且對在高風險活動中使用或包含 Raspberry Pi 產品不承擔任何責任。 Raspberry Pi 產品是依照 RPL 的標準條款提供。 RPL 提供的資源不會擴大或以其他方式修改 RPL 的標準條款，包括但不限於其中表達的免責聲明和保證。
文檔版本歷史
| 發布 | 日期 | 描述 |
| 1.0 | 16 年 2022 月 XNUMX 日 | • 初始發行 |
| 1.1 | 7 年 2024 月 XNUMX 日 | • 修正 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 都提供了超出 vol 的額外功能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 設備韌體中或從 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 子進程模組呼叫 vcgencmd 命令並傳入針對 pmic 的measure_temp 命令，該命令將測量 PMIC 晶片的溫度。此指令的輸出將會列印到控制台。
這是一個類似的範例ampC 中的 le：
C 程式碼使用 popen（而不是 system()，這也是一種選擇），並且可能比需要的更冗長一些，因為它可以處理來自調用的多行結果，而 vcgencmd 僅傳回一行文字。
筆記
這些代碼摘錄僅作為範例提供amples，並且您可能需要根據您的特定需求修改它們。例如ample，您可能想要解析 vcgencmd 命令的輸出以提取溫度值以供稍後使用。
常見問題解答
- Q：我可以在所有 Raspberry Pi 型號上使用這些功能嗎？
- 答：不，這些功能專門適用於 Raspberry Pi 4、Raspberry Pi 5 和 Compute Module 4 裝置。
- Q：將來使用這些功能是否安全？
- 答：無法保證此功能將在未來的 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 |