Dodatkowy moduł obliczeniowy PMIC Raspberry Pi 5 4
Kolofon
2020–2023 Raspberry Pi Ltd (dawniej Raspberry Pi (Trading) Ltd.) Niniejsza dokumentacja jest licencjonowana na podstawie licencji Creative Commons Uznanie autorstwa-Bez utworów zależnych 4.0 Międzynarodowe (CC BY-ND 4.0).
- data kompilacji: 2024-07-09
- wersja kompilacji: githash: 3d961bb-clean
Zastrzeżenie prawne
DANE TECHNICZNE I DOTYCZĄCE NIEZAWODNOŚCI PRODUKTÓW RASPBERRY PI (W TYM ARKUSZE DANYCH) ZMIENIANE OKRESOWO („ZASOBY”) SĄ DOSTARCZANE PRZEZ RASPBERRY PI LTD („RPL”) „W STANIE, W JAKIM SIĘ ZNAJDUJĄ”, A WSZELKIE WYRAŹNE LUB DOROZUMIANE GWARANCJE, W TYM MIĘDZY INNYMI DOROZUMIANE GWARANCJE PRZYDATNOŚCI HANDLOWEJ I PRZYDATNOŚCI DO OKREŚLONEGO CELU, SĄ WYŁĄCZONE. Maksymalnie w zakresie dozwolonym przez obowiązujące prawo, w żadnym wypadku RPL nie ponosi odpowiedzialności za żadne bezpośrednie, pośrednie, przypadkowe, szczególne, przykładowe lub następcze szkody (w tym, lecz nie wyłącznie, zakup towarów lub usług zastępczych; utratę możliwości użytkowania, danych lub zysków; lub przerwę w działalności gospodarczej), niezależnie od przyczyny i podstawy odpowiedzialności, czy to na podstawie umowy, ścisłej odpowiedzialności, czy czynu niedozwolonego (w tym zaniedbania lub w inny sposób), wynikające w jakikolwiek sposób z korzystania z zasobów, nawet jeśli poinformowano o możliwości wystąpienia takich szkód. RPL zastrzega sobie prawo do wprowadzania wszelkich udoskonaleń, ulepszeń, poprawek lub innych modyfikacji ZASOBÓW lub wszelkich produktów w nich opisanych w dowolnym momencie i bez dalszego powiadomienia. ZASOBY są przeznaczone dla doświadczonych użytkowników o odpowiednim poziomie wiedzy projektowej. Użytkownicy ponoszą wyłączną odpowiedzialność za swój wybór i korzystanie z ZASOBÓW oraz wszelkie zastosowanie opisanych w nich produktów. Użytkownik zgadza się zabezpieczyć i zwolnić RPL z wszelkiej odpowiedzialności, kosztów, szkód lub innych strat wynikających z korzystania z ZASOBÓW. RPL udziela użytkownikom pozwolenia na korzystanie z ZASOBÓW wyłącznie w połączeniu z produktami Raspberry Pi. Wszelkie inne wykorzystanie ZASOBÓW jest zabronione. Nie udziela się licencji na żadne inne prawa własności intelektualnej RPL ani innych osób trzecich. DZIAŁANIA WYSOKIEGO RYZYKA. Produkty Raspberry Pi nie są projektowane, produkowane ani przeznaczone do użytku w niebezpiecznych środowiskach wymagających niezawodnej pracy, takich jak eksploatacja obiektów jądrowych, systemów nawigacji lub komunikacji lotniczej, kontroli ruchu lotniczego, systemów uzbrojenia lub zastosowań krytycznych dla bezpieczeństwa (w tym systemów podtrzymywania życia i innych urządzeń medycznych), w których awaria produktów mogłaby bezpośrednio prowadzić do śmierci, obrażeń ciała lub poważnych szkód fizycznych lub środowiskowych („Działania wysokiego ryzyka”). RPL wyraźnie zrzeka się wszelkich wyraźnych lub dorozumianych gwarancji przydatności do działań wysokiego ryzyka i nie ponosi odpowiedzialności za użytkowanie lub włączenie produktów Raspberry Pi do działań wysokiego ryzyka. Produkty Raspberry Pi są dostarczane zgodnie ze standardowymi warunkami RPL. Udostępnienie przez RPL ZASOBÓW nie rozszerza ani w żaden inny sposób nie modyfikuje standardowych warunków RPL, w tym między innymi zrzeczeń się odpowiedzialności i gwarancji w nich wyrażonych.
Historia wersji dokumentu
| Uwolnienie | Data | Opis |
| 1.0 | 16 grudnia 2022 | • Pierwsza wersja |
| 1.1 | 7 Lip 2024 | • Naprawiono literówkę w poleceniach vcgencmd, dodano Raspberry Pi
5 szczegółów. |
Zakres dokumentu
Ten dokument dotyczy następujących produktów Raspberry Pi:
| Pi-zero | Pi 1 | Pi 2 | Pi 3 | Pi 4 | Pi 5 | Pi 400 | CM1 | CM3 | CM4 | Pico | ||||||||
| Zero | W | H | A | B | A+ | B+ | A | B | B | A+ | B+ | Wszystko | Wszystko | Wszystko | Wszystko | Wszystko | Wszystko | Wszystko |
| * | * | * | * | |||||||||||||||
Wstęp
Urządzenia Raspberry Pi 4/5 i Raspberry Pi Compute Module 4 wykorzystują zintegrowany układ zarządzania energią (PMIC) do zasilania różnych objętościtages wymagane przez różne komponenty na PCB. Sekwencjonują również włączenia zasilania, aby zapewnić, że urządzenia są uruchamiane w prawidłowej kolejności. W trakcie produkcji tych modeli użyto wielu różnych urządzeń PMIC. Wszystkie PMICS zapewniały dodatkową funkcjonalność wykraczającą poza tę oferowaną przez voltagDostawa:
- Dwa kanały ADC, które można wykorzystać w CM4.
- W późniejszych wersjach Raspberry Pi 4 i Raspberry Pi 400 oraz wszystkich modelach Raspberry Pi 5, przetworniki ADC są podłączone do złącza zasilania USB-C na CC1 i CC2.
- Czujnik wbudowany w układ, który można wykorzystać do monitorowania temperatury PMIC; dostępny w Raspberry Pi 4 i 5 oraz CM4.
W niniejszym dokumencie opisano sposób uzyskiwania dostępu do tych funkcji oprogramowania.
OSTRZEŻENIE
Nie ma gwarancji, że ta funkcjonalność będzie zachowana w przyszłych wersjach PMIC, dlatego należy z niej korzystać ostrożnie.
Możesz również zapoznać się z następującymi dokumentami:
- Karta danych Raspberry Pi CM4: https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
- Schematy Raspberry Pi 4 w wersji uproszczonej: https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf
W niniejszym dokumencie przyjęto założenie, że Raspberry Pi działa pod kontrolą systemu operacyjnego Raspberry Pi OS i jest w pełni zaktualizowane do najnowszej wersji oprogramowania sprzętowego i jąder.
Korzystanie z funkcji
Początkowo te funkcje były dostępne tylko poprzez bezpośrednie odczytywanie rejestrów na samym PMIC. Jednak adresy rejestrów różnią się w zależności od używanego PMIC (a zatem od wersji płytki), więc Raspberry Pi Ltd udostępniło niezależny od wersji sposób uzyskiwania tych informacji. Obejmuje to użycie narzędzia wiersza poleceń vcgencmd, które jest programem umożliwiającym aplikacjom przestrzeni użytkownika dostęp do informacji przechowywanych w oprogramowaniu układowym urządzenia Raspberry Pi Ltd lub do których można uzyskać dostęp z niego.
Dostępne polecenia vcgencmd są następujące:
| Rozkaz | Opis |
| vcgencmd pomiar_woltów usb_pd | Mierzy objtage na pinie oznaczonym usb_pd (patrz schemat CM4 IO). Tylko CM4. |
| vcgencmd pomiar_woltów ain1 | Mierzy objtage na pinie oznaczonym ain1 (patrz schemat CM 4 IO). Tylko CM4. |
| vcgencmd pomiar_temp pmic | Mierzy temperaturę układu PMIC. CM4 oraz Raspberry Pi 4 i 5. |
Wszystkie te polecenia uruchamia się z wiersza poleceń systemu Linux.
Korzystanie z funkcji z kodu programu
Można używać tych poleceń vcgencmd programowo, jeśli potrzebujesz informacji w aplikacji. Zarówno w Pythonie, jak i C, wywołanie systemu operacyjnego może być użyte do uruchomienia polecenia i zwrócenia wyniku jako ciągu. Oto kilka przykładówampKod Pythona, którego można użyć do wywołania polecenia vcgencmd:
Ten kod używa modułu subprocess Pythona do wywołania polecenia vcgencmd i przekazania polecenia measure_temp ukierunkowanego na pmic, które zmierzy temperaturę układu PMIC. Dane wyjściowe polecenia zostaną wydrukowane na konsoli.
Oto podobny byłyample w C:
Kod w języku C wykorzystuje funkcję popen (zamiast system(), która również byłaby opcją) i jest prawdopodobnie nieco bardziej rozwlekły niż to konieczne, ponieważ może obsłużyć wyniki wywołania składające się z wielu wierszy, podczas gdy vcgencmd zwraca tylko jeden wiersz tekstu.
NOTATKA
Te wyciągi z kodu są dostarczane wyłącznie jakoamples i może być konieczna ich modyfikacja w zależności od konkretnych potrzeb. Na przykładample, możesz przeanalizować dane wyjściowe polecenia vcgencmd w celu wyodrębnienia wartości temperatury do późniejszego wykorzystania.
Często zadawane pytania
- P: Czy mogę korzystać z tych funkcji na wszystkich modelach Raspberry Pi?
- O: Nie, te funkcje są dostępne wyłącznie dla urządzeń Raspberry Pi 4, Raspberry Pi 5 i Compute Module 4.
- P: Czy można bezpiecznie korzystać z tych funkcji w przyszłości?
- O: Nie ma gwarancji, że ta funkcjonalność będzie zachowana w przyszłych wersjach PMIC, dlatego zaleca się ostrożność przy korzystaniu z tych funkcji.
Dokumenty / Zasoby
 |
Raspberry Pi Raspberry Pi 5 Dodatkowy moduł obliczeniowy PMIC 4 [plik PDF] Instrukcja obsługi Raspberry Pi 4, Raspberry Pi 5, Moduł obliczeniowy 4, Raspberry Pi 5 Dodatkowy moduł obliczeniowy PMIC 4, Raspberry Pi 5, Dodatkowy moduł obliczeniowy PMIC 4, Moduł obliczeniowy 4 |