Módulo de computação PMIC extra Raspberry Pi 5 4
Colofão
2020-2023 Raspberry Pi Ltd (anteriormente Raspberry Pi (Trading) Ltd.) Esta documentação está licenciada sob uma licença Creative Commons Atribuição-SemDerivações 4.0 Internacional (CC BY-ND 4.0).
- data de construção: 2024/07/09
- versão de compilação: githash: 3d961bb-clean
Aviso de isenção de responsabilidade legal
DADOS TÉCNICOS E DE CONFIABILIDADE DOS PRODUTOS RASPBERRY PI (INCLUINDO FOLHAS DE DADOS), CONFORME MODIFICADOS PERIODICAMENTE ("RECURSOS"), SÃO FORNECIDOS PELA RASPBERRY PI LTD ("RPL") "NO ESTADO EM QUE SE ENCONTRAM" E QUAISQUER GARANTIAS EXPRESSAS OU IMPLÍCITAS, INCLUINDO, MAS NÃO SE LIMITANDO A, GARANTIAS IMPLÍCITAS DE COMERCIALIZAÇÃO E ADEQUAÇÃO A UM PROPÓSITO ESPECÍFICO, SÃO ISENTAS. ATÉ O LIMITE MÁXIMO PERMITIDO PELA LEI APLICÁVEL, EM NENHUMA HIPÓTESE A RPL SERÁ RESPONSÁVEL POR QUAISQUER DANOS DIRETOS, INDIRETOS, INCIDENTAIS, ESPECIAIS, EXEMPLARES OU CONSEQUENCIAIS (INCLUINDO, MAS NÃO SE LIMITANDO A, AQUISIÇÃO DE BENS OU SERVIÇOS SUBSTITUTOS; PERDA DE USO, DADOS OU LUCROS; OU INTERRUPÇÃO DE NEGÓCIOS) INDEPENDENTEMENTE DA CAUSA E SOB QUALQUER TEORIA DE RESPONSABILIDADE, SEJA EM CONTRATO, RESPONSABILIDADE OBJETIVA OU ATO ILÍCITO (INCLUINDO NEGLIGÊNCIA OU OUTRO) DECORRENTES DE QUALQUER FORMA DO USO DOS RECURSOS, MESMO QUE AVISADO DA POSSIBILIDADE DE TAIS DANOS. A RPL reserva-se o direito de fazer quaisquer melhorias, aprimoramentos, correções ou quaisquer outras modificações nos RECURSOS ou em quaisquer produtos neles descritos a qualquer momento e sem aviso prévio. Os RECURSOS destinam-se a usuários qualificados com níveis adequados de conhecimento em design. Os usuários são os únicos responsáveis por sua seleção e uso dos RECURSOS e por qualquer aplicação dos produtos neles descritos. O usuário concorda em indenizar e isentar a RPL de todas as responsabilidades, custos, danos ou outras perdas decorrentes do uso dos RECURSOS. A RPL concede aos usuários permissão para usar os RECURSOS exclusivamente em conjunto com os produtos Raspberry Pi. Qualquer outro uso dos RECURSOS é proibido. Nenhuma licença é concedida a qualquer outro direito de propriedade intelectual da RPL ou de terceiros. ATIVIDADES DE ALTO RISCO. Os produtos Raspberry Pi não são projetados, fabricados ou destinados ao uso em ambientes perigosos que exijam desempenho à prova de falhas, como na operação de instalações nucleares, sistemas de navegação ou comunicação de aeronaves, controle de tráfego aéreo, sistemas de armas ou aplicações críticas de segurança (incluindo sistemas de suporte à vida e outros dispositivos médicos), nos quais a falha dos produtos pode levar diretamente à morte, ferimentos pessoais ou danos físicos ou ambientais graves (“Atividades de Alto Risco”). A RPL se isenta especificamente de qualquer garantia expressa ou implícita de adequação a Atividades de Alto Risco e não se responsabiliza pelo uso ou inclusão de produtos Raspberry Pi em Atividades de Alto Risco. Os produtos Raspberry Pi são fornecidos sujeitos aos Termos Padrão da RPL. O fornecimento dos RECURSOS pela RPL não expande ou modifica de outra forma os Termos Padrão da RPL, incluindo, entre outros, as isenções de responsabilidade e garantias expressas neles.
Histórico de versões do documento
| Liberar | Data | Descrição |
| 1.0 | 16 de dezembro de 2022 | • Lançamento inicial |
| 1.1 | 7 de julho de 2024 | • Corrigir erro de digitação nos comandos vcgencmd, adicionado Raspberry Pi
5 detalhes. |
Escopo do documento
Este documento se aplica aos seguintes produtos 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+ | Todos | Todos | Todos | Todos | Todos | Todos | Todos |
| * | * | * | * | |||||||||||||||
Introdução
Os dispositivos Raspberry Pi 4/5 e Raspberry Pi Compute Module 4 usam um circuito integrado de gerenciamento de energia (PMIC) para fornecer vários volumestages exigidos pelos vários componentes da placa de circuito impresso. Eles também sequenciam as inicializações para garantir que os dispositivos sejam iniciados na ordem correta. Ao longo da produção desses modelos, diversos dispositivos PMIC diferentes foram utilizados. Todos os PMICs forneceram funcionalidade extra além daquela do volume.tage oferta:
- Dois canais ADC que podem ser usados no CM4.
- Em revisões posteriores do Raspberry Pi 4 e Raspberry Pi 400, e em todos os modelos do Raspberry Pi 5, os ADCs são conectados ao conector de alimentação USB-C no CC1 e CC2.
- Um sensor no chip que pode ser usado para monitorar a temperatura do PMIC, disponível no Raspberry Pi 4 e 5 e no CM4.
Este documento descreve como acessar esses recursos no software.
AVISO
Não há garantia de que essa funcionalidade será mantida em versões futuras do PMIC, portanto, ela deve ser usada com cautela.
Você também pode consultar os seguintes documentos:
- Ficha técnica do Raspberry Pi CM4: https://datasheets.raspberrypi.com/cm4/cm4-datasheet.pdf
- Esquemas reduzidos do Raspberry Pi 4: https://datasheets.raspberrypi.com/rpi4/raspberry-pi-4-reduced-schematics.pdf
Este white paper pressupõe que o Raspberry Pi esteja executando o Raspberry Pi OS e esteja totalmente atualizado com o firmware e os kernels mais recentes.
Usando os recursos
Originalmente, esses recursos estavam disponíveis apenas pela leitura direta de registradores no próprio PMIC. No entanto, os endereços dos registradores variam dependendo do PMIC utilizado (e, portanto, da revisão da placa), portanto, a Raspberry Pi Ltd. forneceu uma maneira independente de revisão para obter essas informações. Isso envolve o uso da ferramenta de linha de comando vcgencmd, que é um programa que permite que aplicativos do espaço do usuário acessem informações armazenadas ou acessadas a partir do firmware do dispositivo Raspberry Pi Ltd.
Os comandos vcgencmd disponíveis são os seguintes:
| Comando | Descrição |
| vcgencmd medir_volts usb_pd | Mede o voltage no pino marcado usb_pd (veja o esquema CM4 IO). Somente CM4. |
| vcgencmd medida_volts ain1 | Mede o voltage no pino marcado ain1 (Veja o esquema CM 4 IO). Somente CM4. |
| vcgencmd medida_temp pmic | Mede a temperatura do chip PMIC. CM4 e Raspberry Pi 4 e 5. |
Todos esses comandos são executados na linha de comando do Linux.
Usando os recursos do código do programa
É possível usar esses comandos vcgencmd programaticamente se você precisar das informações dentro de um aplicativo. Tanto em Python quanto em C, uma chamada do sistema operacional pode ser usada para executar o comando e retornar o resultado como uma string. Aqui estão alguns exemplos:ampo código Python que pode ser usado para chamar o comando vcgencmd:
Este código usa o módulo subprocess do Python para chamar o comando vcgencmd e passar o comando measure_temp direcionado ao PMIC, que medirá a temperatura do chip PMIC. A saída do comando será impressa no console.
Aqui está um exemplo semelhanteample em C:
O código C usa popen (em vez de system(), que também seria uma opção) e provavelmente é um pouco mais detalhado do que o necessário porque pode manipular resultados de várias linhas da chamada, enquanto vcgencmd retorna apenas uma única linha de texto.
OBSERVAÇÃO
Esses extratos de código são fornecidos apenas como examparquivos, e você pode precisar modificá-los dependendo de suas necessidades específicas. Por exemploample, você pode querer analisar a saída do comando vcgencmd para extrair o valor da temperatura para uso posterior.
Perguntas frequentes
- P: Posso usar esses recursos em todos os modelos de Raspberry Pi?
- R: Não, esses recursos estão disponíveis especificamente para dispositivos Raspberry Pi 4, Raspberry Pi 5 e Compute Module 4.
- P: É seguro confiar nesses recursos para uso futuro?
- R: Não há garantia de que essa funcionalidade será mantida em versões futuras do PMIC, portanto, é recomendável ter cautela ao usar esses recursos.
Documentos / Recursos
 |
Raspberry Pi Raspberry Pi 5 Extra PMIC Compute Módulo 4 [pdf] Manual de Instruções Raspberry Pi 4, Raspberry Pi 5, Módulo de Computação 4, Raspberry Pi 5 Módulo de Computação PMIC Extra 4, Raspberry Pi 5, Módulo de Computação PMIC Extra 4, Módulo de Computação 4 |