Raspberry Pi 5 Mòdul de càlcul PMIC extra 4
Colofó
2020-2023 Raspberry Pi Ltd (anteriorment Raspberry Pi (Trading) Ltd.) Aquesta documentació està subjecta a una llicència Creative Commons Reconeixement-SenseObraDerivada 4.0 Internacional (CC BY-ND 4.0).
- data de construcció: 2024-07-09
- versió de compilació: githash: 3d961bb-clean
Avís legal d'exempció de responsabilitat
LES DADES TÈCNIQUES I DE FIABILITAT DELS PRODUCTES RASPBERRY PI (INCLOSES LES FULLS DE DADES) QUE ES MODIFIQUEN PERIÒDICAMENT (“RECURSOS”) SÓN PROPORCIONADES PER RASPBERRY PI LTD (“RPL”) “TAL QUAL” I ES REBUTJA QUALSEVOL GARANTIA EXPLÍCITA O IMPLÍCITA, INCLOSES, ENTRE D'ALTRES, LES GARANTIES IMPLÍCITES DE COMERCIABILITAT I IDONEÏTAT PER A UN PROPÒSIT PARTICULAR. EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE, EN CAP CAS RPL SERÀ RESPONSABLE DE CAP DANY DIRECTE, INDIRECTE, INCIDENTAL, ESPECIAL, EXEMPLAR O CONSEQÜENT (INCLOSOS, ENTRE D'ALTRES, L'ADQUISICIÓ DE BÉNS O SERVEIS SUBSTITUTS; PÈRDUA D'ÚS, DADES O BENEFICIS; O INTERRUPCIÓ DEL NEGOCI) INDEPENDENTMENT DE LA CAUSA I SEGUINT LES CONDICIONS DE QUALSEVOL TEORIA DE RESPONSABILITAT, JA SIGUI PER CONTRACTE, RESPONSABILITAT ESTRICTA O DELICTE (INCLOSA LA NEGLIGÈNCIA O D'ALTRE) QUE DERIVI DE QUALSEVOL MANERA DE L'ÚS DELS RECURSOS, ENCARA QUE S'HAGI ADVERTIT DE LA POSSIBILITAT D'AQUESTS DANYS. RPL es reserva el dret de fer qualsevol millora, correcció o qualsevol altra modificació als RECURSOS o a qualsevol producte que s'hi descriu en qualsevol moment i sense previ avís. Els RECURSOS estan destinats a usuaris qualificats amb nivells adequats de coneixements de disseny. Els usuaris són els únics responsables de la seva selecció i ús dels RECURSOS i de qualsevol aplicació dels productes que s'hi descriuen. L'usuari accepta indemnitzar i eximir de responsabilitat RPL contra totes les responsabilitats, costos, danys o altres pèrdues derivades del seu ús dels RECURSOS. RPL concedeix als usuaris permís per utilitzar els RECURSOS únicament juntament amb els productes Raspberry Pi. Qualsevol altre ús dels RECURSOS està prohibit. No es concedeix cap llicència a cap altre dret de propietat intel·lectual de RPL o de tercers. ACTIVITATS D'ALT RISC. Els productes Raspberry Pi no estan dissenyats, fabricats ni destinats a ser utilitzats en entorns perillosos que requereixin un rendiment a prova de fallades, com ara en el funcionament d'instal·lacions nuclears, sistemes de navegació o comunicació d'aeronaus, control de trànsit aeri, sistemes d'armes o aplicacions crítiques per a la seguretat (inclosos els sistemes de suport vital i altres dispositius mèdics), en què la fallada dels productes podria provocar directament la mort, lesions personals o danys físics o ambientals greus ("Activitats d'alt risc"). RPL renuncia específicament a qualsevol garantia expressa o implícita d'idoneïtat per a Activitats d'alt risc i no accepta cap responsabilitat per l'ús o la inclusió de productes Raspberry Pi en Activitats d'alt risc. Els productes Raspberry Pi es proporcionen subjectes a les Condicions estàndard de RPL. La provisió dels RECURSOS per part de RPL no amplia ni modifica de cap altra manera les Condicions Estàndard de RPL, incloent-hi, entre d'altres, les exempcions de responsabilitat i les garanties que s'hi expressen.
Historial de versions del document
| Alliberament | Data | Descripció |
| 1.0 | 16 de desembre de 2022 | • Versió inicial |
| 1.1 | 7 de juliol de 2024 | • Correcció d'errors tipogràfics a les ordres vcgencmd, afegit Raspberry Pi
5 detalls. |
Àmbit del document
Aquest document s'aplica als següents productes 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+ | Tots | Tots | Tots | Tots | Tots | Tots | Tots |
| * | * | * | * | |||||||||||||||
Introducció
Els dispositius Raspberry Pi 4/5 i Raspberry Pi Compute Module 4 utilitzen un circuit integrat de gestió d'energia (PMIC) per subministrar els diversos volums.tages requerits pels diversos components de la PCB. També seqüencien les engegades per garantir que els dispositius s'iniciïn en l'ordre correcte. Durant la durada de la producció d'aquests models, s'han utilitzat diversos dispositius PMIC diferents. Tots els PMIC han proporcionat funcionalitats addicionals a més de les del volumtagsubministrament:
- Dos canals ADC que es poden utilitzar en CM4.
- En revisions posteriors de Raspberry Pi 4 i Raspberry Pi 400, i tots els models de Raspberry Pi 5, els ADC estan connectats al connector d'alimentació USB-C de CC1 i CC2.
- Un sensor integrat en un xip que es pot utilitzar per monitoritzar la temperatura del PMIC, disponible a Raspberry Pi 4 i 5, i CM4.
Aquest document descriu com accedir a aquestes funcions del programari.
ADVERTIMENT
No hi ha cap garantia que aquesta funcionalitat es mantingui en futures versions del PMIC, per la qual cosa s'ha d'utilitzar amb precaució.
També podeu consultar els documents següents:
- Fitxa tècnica de la Raspberry Pi CM4: https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
- Esquemes reduïts de Raspberry Pi 4: https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf
Aquest document assumeix que la Raspberry Pi executa el sistema operatiu Raspberry Pi i que està completament actualitzada amb el firmware i els nuclis més recents.
Ús de les funcions
Originalment, aquestes funcions només estaven disponibles llegint directament els registres del PMIC. Tanmateix, les adreces dels registres varien segons el PMIC utilitzat (i, per tant, segons la revisió de la placa), per la qual cosa Raspberry Pi Ltd ha proporcionat una manera agnòstica de revisió per obtenir aquesta informació. Això implica utilitzar l'eina de línia d'ordres vcgencmd, que és un programa que permet a les aplicacions d'espai d'usuari accedir a la informació emmagatzemada o a la qual s'accedeix des del firmware del dispositiu Raspberry Pi Ltd.
Les ordres vcgencmd disponibles són les següents:
| Comandament | Descripció |
| vcgencmd mesura_volts usb_pd | Mesura el voltage al pin marcat amb usb_pd (vegeu l'esquema d'E/S de CM4). Només CM4. |
| vcgencmd mesura_volts ain1 | Mesura el voltage al pin marcat amb ain1 (vegeu l'esquema d'E/S de CM 4). Només CM4. |
| vcgencmd mesura_temp pmic | Mesura la temperatura del circuit PMIC. CM4 i Raspberry Pi 4 i 5. |
Totes aquestes ordres s'executen des de la línia d'ordres de Linux.
Ús de les funcions del codi del programa
És possible utilitzar aquestes ordres vcgencmd programàticament si necessiteu la informació dins d'una aplicació. Tant en Python com en C, es pot utilitzar una crida del sistema operatiu per executar l'ordre i retornar el resultat com a cadena. Aquí teniu alguns exemples.ampCodi Python que es pot utilitzar per cridar l'ordre vcgencmd:
Aquest codi utilitza el mòdul de subprocessos de Python per cridar l'ordre vcgencmd i passar l'ordre measure_temp dirigit al PMIC, que mesurarà la temperatura del dau PMIC. La sortida de l'ordre s'imprimirà a la consola.
Aquí teniu un ex similarample en C:
El codi C utilitza popen (en lloc de system(), que també seria una opció), i probablement és una mica més prolix del que hauria de ser perquè pot gestionar resultats de diverses línies de la crida, mentre que vcgencmd només retorna una sola línia de text.
NOTA
Aquests extractes de codi es subministren només com a exemplesampfitxers, i és possible que hàgiu de modificar-los segons les vostres necessitats específiques. Per exempleampPer exemple, podeu analitzar la sortida de l'ordre vcgencmd per extreure el valor de la temperatura per a un ús posterior.
Preguntes freqüents
- P: Puc utilitzar aquestes funcions en tots els models de Raspberry Pi?
- R: No, aquestes funcions estan disponibles específicament per a dispositius Raspberry Pi 4, Raspberry Pi 5 i Compute Module 4.
- P: És segur confiar en aquestes funcions per a un ús futur?
- A: No hi ha cap garantia que aquesta funcionalitat es mantingui en futures versions de PMIC, per la qual cosa es recomana precaució a l'hora d'utilitzar aquestes característiques.
Documents/Recursos
 |
Raspberry Pi Raspberry Pi 5 Mòdul de càlcul PMIC addicional 4 [pdfManual d'instruccions Raspberry Pi 4, Raspberry Pi 5, Mòdul de càlcul 4, Raspberry Pi 5 PMIC addicional Mòdul de càlcul 4, Raspberry Pi 5, PMIC addicional Mòdul de càlcul 4, Mòdul de càlcul 4 |