Aprovisionamento do módulo de cálculo Raspberry Pi
Aprovisionamento do módulo de cálculo Raspberry Pi (versións 3 e 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Colofón
© 2020-2022 Raspberry Pi Ltd (anteriormente Raspberry Pi (Trading) Ltd.)
Esta documentación está baixo a licenza Creative Commons Atribución-Sen Derivadas 4.0 Internacional (CC BY-ND). data de compilación: 2022-07-19 versión de compilación: githash: 94a2802-clean
Aviso legal de exención de responsabilidade
OS DATOS TÉCNICOS E DE FIABILIDADE DOS PRODUTOS DE RASPBERRY PI (INCLUÍDAS AS FOLLAS DE DATOS) MODIFICADOS DE CADA VEZ ("RECURSOS") PROPORCIONAN RASPBERRY PI LTD ("RPL") "TAL CUAL" E CALQUERA GARANTÍA EXPRESA OU IMPLÍCITA, INCLUÍDO, PERO NON LIMITADO. AO, NEGARÁNSE AS GARANTÍAS IMPLÍCITAS DE COMERCIABILIDADE E IDONEIDADE PARA UN FIN PARTICULAR. NA MEDIDA MÁXIMA PERMITIDA POLA LEI APLICABLE EN NINGÚN CASO, RPL SERÁ RESPONSABLE DE NINGÚN DANOS DIRECTOS, INDIRECTOS, ACCIDENTALES, ESPECIAIS, EXEMPLARS OU CONSECUENTES (INCLUÍDO, PERO NON LIMITADO A, A ADQUISICIÓN DE BENS SUBSTITUTIVOS, PERDA DE DATOS; , OU BENEFICIOS; OU INTERRUPCIÓN DE NEGOCIOS) SEEN O CAUSADOS E SOBRE CALQUERA TEORÍA DE RESPONSABILIDADE, FOI POR CONTRATO, RESPONSABILIDADE ESTRICTA OU EXTRAORDINARIA (INCLÚA A NEGLIXENCIA OU DE OUTRO MODO) DERIVADA DE CALQUERA FORMA DO USO DOS RECURSOS, INCLUSO A CONSULTABILIDADE DE DE TAL DANO.
RPL resérvase o dereito de facer calquera mellora, mellora, corrección ou calquera outra modificación nos RECURSOS ou en calquera produto descrito neles en calquera momento e sen previo aviso. Os RECURSOS están destinados a usuarios cualificados con niveis axeitados de coñecemento do deseño. Os usuarios son os únicos responsables da súa selección e uso dos RECURSOS e de calquera aplicación dos produtos descritos neles. O usuario comprométese a indemnizar e eximir a RPL de todas as responsabilidades, custos, danos ou outras perdas derivadas do uso dos RECURSOS. RPL concede aos usuarios permiso para usar os RECURSOS unicamente xunto cos produtos Raspberry Pi. Queda prohibido calquera outro uso dos RECURSOS. Non se concede ningunha licenza a ningún outro RPL ou dereito de propiedade intelectual de terceiros. ACTIVIDADES DE ALTO RISCO. Os produtos Raspberry Pi non están deseñados, fabricados nin destinados a ser utilizados en ambientes perigosos que requiren un rendemento seguro, como no funcionamento de instalacións nucleares, sistemas de navegación ou comunicación de aeronaves, control de tráfico aéreo, sistemas de armas ou aplicacións críticas para a seguridade (incluído o soporte vital). sistemas e outros dispositivos médicos), nos que a falla dos produtos pode provocar directamente a morte, danos persoais ou graves danos físicos ou ambientais (“Actividades de alto risco”). RPL renuncia específicamente a calquera garantía expresa ou implícita de aptitude para actividades de alto risco e non acepta ningunha responsabilidade polo uso ou inclusión de produtos Raspberry Pi en actividades de alto risco. Os produtos Raspberry Pi ofrécense suxeitos ás Condicións estándar de RPL. A disposición de RPL dos RECURSOS non amplía nin modifica de ningún xeito as Condicións estándar de RPL, incluíndo, entre outras, as renuncias e garantías expresadas nelas.
Historial de versións do documento 
Alcance do documentomento
Este documento aplícase aos seguintes produtos Raspberry Pi:
Introdución
O Provedor de CM é un web aplicación deseñada para facer que a programación dun gran número de dispositivos Raspberry Pi Compute Module (CM) sexa moito máis sinxela e rápida. É sinxelo de instalar e de usar. Ofrece unha interface para unha base de datos de imaxes do núcleo que se poden cargar, xunto coa posibilidade de usar scripts para personalizar varias partes da instalación durante o proceso de flasheo. Tamén se admite a impresión de etiquetas e a actualización de firmware. Este documento asume que o servidor Provisioner, versión de software 1.5 ou posterior, está a executarse nun Raspberry Pi.
Como funciona todo
CM4
O sistema Provisioner debe instalarse na súa propia rede cableada; o Raspberry Pi que executa o servidor está conectado a un interruptor, xunto con tantos dispositivos CM4 como pode soportar o interruptor. Calquera CM4 conectado a esta rede será detectado polo sistema de aprovisionamento e flashearase automaticamente co firmware necesario do usuario. O motivo de ter a súa propia rede con cable queda claro cando se considera que calquera CM4 conectado á rede será aprovisionado, polo que manter a rede separada de calquera rede activa é fundamental para evitar a reprogramación involuntaria dos dispositivos.
CAMBIOS DE IMAXE Placas CM 4 IO con CM 4 -> Placas CM4 IO con CM4
Ao usar unha Raspberry Pi como servidor, é posible usar redes con cable para o Provisioner pero aínda así permitir o acceso a redes externas mediante a conectividade sen fíos. Isto permite a descarga sinxela de imaxes ao servidor, listas para o proceso de aprovisionamento e permite que Raspberry Pi sirva ao Provisioner. web interface. Pódense descargar varias imaxes; o Provisioner mantén unha base de datos de imaxes e facilita a selección da imaxe adecuada para configurar diferentes dispositivos.
Cando un CM4 está conectado á rede e está acendido, tentará arrincar e, unha vez que se probaron outras opcións, inténtase o inicio da rede. Neste punto, o sistema Provisioner Dynamic Host Configuration Protocol (DHCP) responde ao CM4 de arranque e proporciónalle unha imaxe de arranque mínima que se descarga no CM4 e despois execútase como root. Esta imaxe pode programar a Tarxeta Multimedia incorporada (eMMC) e executar os scripts necesarios, segundo as instrucións do Provedor.
Máis detalles
Os módulos CM4 envíanse cunha configuración de arranque que tentará iniciar primeiro desde eMMC; se iso falla porque o eMMC está baleiro, realizará un arranque de rede do entorno de execución de prearranque (PXE). Así, cos módulos CM4 que aínda non foron aprovisionados e que teñan un eMMC baleiro, realizarase un arranque de rede por defecto. Durante un arranque de rede nunha rede de aprovisionamento, unha imaxe de sistema operativo (SO) de utilidade lixeira (en realidade, un núcleo Linux e un scriptexecute initramfs) será servida polo servidor de aprovisionamento ao módulo CM4 a través da rede, e esta imaxe xestiona o aprovisionamento.
CM 3 e CM 4s
Os dispositivos CM baseados no conector SODIMM non poden arrancar en rede, polo que a programación realízase a través de USB. Cada dispositivo deberá estar conectado ao Provisioner. Se precisas conectar máis de 4 dispositivos (o número de portos USB do Raspberry Pi), pódese usar un concentrador USB. Use cables USB-A a Micro-USB de boa calidade, conectándose desde o Raspberry Pi ou o concentrador ao porto escravo USB de cada placa CMIO. Todas as placas CMIO tamén necesitarán unha fonte de alimentación e o jumper de activación do arranque escravo USB J4 debería estar configurado para activalo.
IMPORTANTE
NON conecte o porto Ethernet do Pi 4. A conexión sen fíos utilízase para acceder á xestión web interface.
Instalación
As seguintes instrucións eran correctas no momento da emisión. As instrucións de instalación máis recentes pódense atopar na páxina de Provisioner GitHub.
Instalación do Provisioner web aplicación nunha Raspberry Pi
AVISO
Asegúrese de que eth0 se conecte a un conmutador Ethernet que só teña conectadas as placas de E/S CM4. Non conecte eth0 á súa rede de oficina ou pública, ou tamén pode "aprovisionar" outros dispositivos Raspberry Pi na súa rede. Use a conexión sen fíos Raspberry Pi para conectarse á súa rede local.
Recoméndase a versión Lite do sistema operativo Raspberry Pi como o sistema operativo base no que instalar o Provisioner. Para simplificar, use rpi-imager e active o menú de configuración avanzada (Ctrl-Shift-X) para configurar o contrasinal, o nome de host e a configuración sen fíos. Unha vez instalado o sistema operativo no Raspberry Pi, terás que configurar o sistema Ethernet:
- Configure eth0 para ter un enderezo de protocolo de Internet (IP) estático de 172.20.0.1 dentro dunha subrede /16 (máscara de rede 255.255.0.0) editando a configuración DHCP:
- sudo nano /etc/dhcpcd.conf
- Engadir ao fondo do file:
interface eth0
static ip_address=172.20.0.1/16 - Reinicie para permitir que os cambios teñan efecto.
- Asegúrese de que a instalación do SO estea actualizada:
actualización de sudo apt
sudo apt actualización completa - O Provisioner ofrécese como un .deb listo file na páxina de Provisioner GitHub. Descarga a última versión desa páxina ou usando wget e instálaa usando o seguinte comando:
sudo apt install ./cmprovision4_*_all.deb - Establece o web nome de usuario e contrasinal da aplicación:
sudo /var/lib/cmprovision/artisan auth:create-user
Agora podes acceder ao web interface do Provedor con a web navegador usando o enderezo IP sen fíos de Raspberry Pi e o nome de usuario e o contrasinal introducidos na sección anterior. Só tes que introducir o enderezo IP na barra de enderezos do teu navegador e premer Intro.
Uso
Cando se conecta por primeira vez ao Provisioner web aplicación co seu web navegador verá a pantalla Dashboard, que terá un aspecto así:
Esta páxina de destino simplemente ofrece información sobre a última acción realizada polo Provedor (no example anterior, aprovisionouse un único CM4).
Cargando imaxes
A primeira operación necesaria ao configurar é cargar a túa imaxe no servidor, desde onde se pode utilizar para aprovisionar as túas placas CM4. Fai clic no elemento do menú "Imaxes" na parte superior do menú web páxina e deberías obter unha pantalla similar á que se mostra a continuación, mostrando unha lista de imaxes cargadas actualmente (que inicialmente estará baleira).
Seleccione o botón Engadir imaxe para cargar unha imaxe; verás esta pantalla:
A imaxe debe estar accesible no dispositivo onde se atopa web o navegador está en execución e nun dos formatos de imaxe especificados. Seleccione a imaxe da súa máquina usando o estándar file diálogo e fai clic en "Cargar". Agora copiará a imaxe da túa máquina ao servidor Provisioner que se executa no Raspberry Pi. Isto pode levar algún tempo. Unha vez cargada a imaxe, veraa na páxina Imaxes.
Engadindo un proxecto
Agora cómpre crear un proxecto. Podes especificar calquera número de proxectos e cada un pode ter unha imaxe, un conxunto de guións ou unha etiqueta diferente. O proxecto activo é o que se utiliza actualmente para aprovisionamento.
Fai clic no elemento do menú "Proxectos" para abrir a páxina de Proxectos. Os seguintes exampxa ten un proxecto, chamado "Proxecto de proba", configurado.
Agora fai clic en "Engadir proxecto" para configurar un novo proxecto
- Dálle un nome ao proxecto e, a continuación, selecciona a imaxe que desexas que use este proxecto na lista despregable. Tamén pode configurar outros parámetros neste stage, pero moitas veces só a imaxe será suficiente.
- Se estás a usar a versión 1.5 ou posterior do Provisioner, tes a opción de verificar que o flasheo completouse correctamente. Se selecciona isto, volverá ler os datos do dispositivo CM despois de parpadear e confirmará que coincide coa imaxe orixinal. Isto engadirá tempo extra ao aprovisionamento de cada dispositivo, a cantidade de tempo engadido dependerá do tamaño da imaxe.
- Se seleccionas o firmware para instalar (isto é opcional), tamén tes a posibilidade de personalizar ese firmware con algunhas entradas de configuración específicas que se combinarán co binario do cargador de arranque. As opcións dispoñibles pódense atopar no Raspberry Pi websitio.
- Fai clic en "Gardar" cando teñas definido completamente o teu novo proxecto; volverás á páxina de Proxectos e listarase o novo proxecto. Teña en conta que só pode estar activo un proxecto á vez, e pode seleccionalo desta lista.
Guións
Unha característica realmente útil de Provisioner é a posibilidade de executar scripts na imaxe, antes ou despois da instalación. Tres scripts están instalados por defecto no Provisioner e pódense seleccionar ao crear un novo proxecto. Están listados na páxina Scripts
Un exampO uso dos scripts pode ser engadir entradas personalizadas a config.txt. O script estándar Add dtoverlay=dwc2 to config.txt fai isto, usando o seguinte código de shell:
Fai clic en "Engadir guión" para engadir as túas propias personalizacións:
Etiquetas
O provedor ten a posibilidade de imprimir etiquetas para o dispositivo que se está a subministrar. A páxina Etiquetas mostra todas as etiquetas predefinidas que se poden seleccionar durante o proceso de edición do proxecto. Por example, pode querer imprimir códigos DataMatrix ou de resposta rápida (QR) para cada placa provista, e esta función fai isto moi sinxelo.
Fai clic en "Engadir etiqueta" para especificar a túa: 
Firmware
O Provisioner ofrece a posibilidade de especificar que versión do firmware do cargador de arranque quere instalar no CM4. Na páxina Firmware hai unha lista de todas as opcións posibles, pero a máis recente adoita ser a mellor.
Para actualizar a lista coas últimas versións do cargador de arranque, fai clic no botón "Descargar novo firmware de github".
Posibles problemas
Firmware do cargador de arranque desactualizado
Se o teu CM4 non é detectado polo sistema Provisioner cando está conectado, é posible que o firmware do cargador de arranque estea desactualizado. Teña en conta que todos os dispositivos CM4 fabricados desde febreiro de 2021 teñen instalado de fábrica o cargador de arranque correcto, polo que isto só ocorrerá cos dispositivos que se fabricaron antes desa data.
EMMC xa programado
Se o módulo CM4 xa ten arranque files no eMMC dun intento de aprovisionamento anterior, entón arrancará desde o eMMC e non se producirá o arranque de rede necesario para o aprovisionamento.
Se desexa reprovisionar un módulo CM4, terá que:
- Conecte un cable USB entre o servidor de aprovisionamento e o porto micro USB da placa CM4 IO (etiquetado como "esclavo USB").
- Pon un puente na placa CM4 IO (J2, 'Axustar o puente para desactivar o arranque eMMC').
Isto fará que o módulo CM4 realice un arranque USB, nese caso o servidor de aprovisionamento transferirá o ficheiro files do SO da utilidade a través de USB.
Despois de que se inicie o sistema operativo da utilidade, poñerase en contacto co servidor de aprovisionamento a través de Ethernet para recibir máis instrucións e descargar adicionais files (por exemplo, a imaxe do SO que se escribirá en eMMC) como é habitual. Polo tanto, aínda é necesaria unha conexión Ethernet ademais do cable USB.
Protocolo de árbore de expansión (STP) en conmutadores Ethernet xestionados
O arranque PXE non funcionará correctamente se STP está activado nun conmutador Ethernet xestionado. Este pode ser o predeterminado nalgúns switches (por exemplo, Cisco), e se ese é o caso, terá que estar desactivado para que o proceso de aprovisionamento funcione correctamente.
Raspberry Pi é unha marca comercial da Fundación Raspberry Pi
Raspberry Pi Ltd
Documentos/Recursos
 |
Raspberry Pi Aprovisionamento do módulo de cálculo de Raspberry Pi [pdfGuía do usuario Aprovisionamento do módulo de cálculo Raspberry Pi, aprovisionamento, módulo de cálculo de Raspberry Pi, módulo de cálculo |