Subministrament del mòdul de càlcul Raspberry Pi
Aprovisionament del mòdul de càlcul de Raspberry Pi (versions 3 i 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Colofó
© 2020-2022 Raspberry Pi Ltd (abans Raspberry Pi (Trading) Ltd.)
Aquesta documentació està subjecta a una llicència Creative Commons Attribution-SenseDerivatives 4.0 International (CC BY-ND). data de compilació: 2022-07-19 versió de compilació: githash: 94a2802-clean
Avís legal d'exempció de responsabilitat
LES DADES TÈCNIQUES I DE FIABILITAT DELS PRODUCTES RASPBERRY PI (INCLOSO LES FITXES DE DADES) MODIFICAT DE TANTA EN TEMPS ("RECURSOS") LES PROPORCIONEN PER RASPBERRY PI LTD ("RPL") "TAL CUAL" I QUALSEVOL GARANTIA EXPRESSA O IMPLÍCITA, INCLOSA, PERÒ NO LIMITADA. A, LES GARANTIES IMPLÍCITES DE COMERCIABILITAT I IDONEITAT PER A UN PROPÒSIT PARTICULAR ES RENUNCIAN. EN LA MESURA MÀXIMA PERMESA PER LA LLEI APLICABLE EN CAP CAS, RPL SERÀ RESPONSABLE DE CAP DANYS DIRECTS, INDIRECTS, INCIDENTALS, ESPECIALS, EXEMPLARS O CONSEQUENTLS (INCLOSOS, PERÒ NO LIMITAR-SE, LA ADQUISICIÓ DE BÉNS SUBSTITUTS, PÈRDUES DE DADES; , O BENEFICIS; O INTERRUPCIÓ DE NEGOCIS) SIGUI QUE ÉS CAUSADA I SOBRE QUALSEVOL TEORIA DE RESPONSABILITAT, JA SIGUI EN CONTRACTE, RESPONSABILITAT ESTRICTA O ALTRES (INCLOSA LA NEGLIGÈNCIA O ALTRE MANERA) SORRIJADA DE QUALSEVOL MANERA DE L'ÚS DE LA RESPONSABILITAT, D'AQUEST DANY.
RPL es reserva el dret de fer qualsevol millora, millora, correcció o qualsevol altra modificació als RECURSOS o als productes que s'hi descriuen en qualsevol moment i sense cap 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 es compromet a indemnitzar i mantenir indemne a RPL de 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 només juntament amb els productes Raspberry Pi. Queda prohibit qualsevol altre ús dels RECURSOS. No s'atorga cap llicència a cap altre RPL o dret de propietat intel·lectual de tercers. ACTIVITATS D'ALT RISC. Els productes Raspberry Pi no estan dissenyats, fabricats ni pensats per al seu ús en entorns perillosos que requereixin un rendiment segur contra errors, com ara en l'operació 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 (inclòs el suport vital). sistemes i altres dispositius mèdics), en els quals 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'aptitud per a Activitats d'Alt Risc i no accepta cap responsabilitat per l'ús o inclusió dels productes Raspberry Pi a les Activitats d'Alt Risc. Els productes Raspberry Pi es proporcionen subjectes a les condicions estàndard de RPL. La disposició de RPL dels RECURSOS no amplia ni modifica d'una altra manera les Condicions estàndard de RPL, incloses, entre altres, les exempcions de responsabilitat i garanties expressades en elles.
Historial de versions del document 
Àmbit del documentment
Aquest document s'aplica als següents productes Raspberry Pi:
Introducció
El proveïdor de CM és a web aplicació dissenyada per fer que la programació d'un gran nombre de dispositius Raspberry Pi Compute Module (CM) sigui molt més fàcil i ràpida. És senzill d'instal·lar i fàcil d'utilitzar. Proporciona una interfície per a una base de dades d'imatges del nucli que es poden carregar, juntament amb la possibilitat d'utilitzar scripts per personalitzar diverses parts de la instal·lació durant el procés de parpelleig. També s'admet la impressió d'etiquetes i l'actualització del firmware. Aquest document blanc suposa que el servidor Provisioner, versió de programari 1.5 o posterior, s'està executant en un Raspberry Pi.
Com funciona tot
CM4
El sistema Provisioner s'ha d'instal·lar a la seva pròpia xarxa per cable; el Raspberry Pi que executa el servidor està connectat a un commutador, juntament amb tants dispositius CM4 com el commutador pugui suportar. Qualsevol CM4 connectat a aquesta xarxa serà detectat pel sistema d'aprovisionament i es mostrarà automàticament amb el microprogramari requerit per l'usuari. La raó de tenir la seva pròpia xarxa cablejada queda clara quan es considera que qualsevol CM4 connectat a la xarxa serà subministrat, per la qual cosa mantenir la xarxa separada de qualsevol xarxa en directe és essencial per evitar la reprogramació no intencionada dels dispositius.
CANVIS D'IMATGE Plaques CM 4 IO amb CM 4 -> CM4 Plaques IO amb CM4
Si s'utilitza un Raspberry Pi com a servidor, és possible utilitzar xarxes per cable per al Provisioner, però encara es permet l'accés a xarxes externes mitjançant la connectivitat sense fil. Això permet una descàrrega fàcil d'imatges al servidor, a punt per al procés d'aprovisionament, i permet que Raspberry Pi serveixi el Provisioner. web interfície. Es poden descarregar diverses imatges; el Provisioner manté una base de dades d'imatges i facilita la selecció de la imatge adequada per configurar diferents dispositius.
Quan un CM4 està connectat a la xarxa i està encès, intentarà arrencar, i un cop s'han provat altres opcions, s'intenta l'arrencada de la xarxa. En aquest punt, el sistema DHCP (Provisioner Dynamic Host Configuration Protocol) respon al CM4 d'arrencada i li proporciona una imatge d'arrencada mínima que es baixa al CM4 i després s'executa com a root. Aquesta imatge pot programar la targeta multimèdia incrustada (eMMC) i executar els scripts necessaris, segons les instruccions del proveïdor.
Més detalls
Els mòduls CM4 s'envien amb una configuració d'arrencada que intentarà arrencar primer des de l'eMMC; si això falla perquè l'eMMC està buit, realitzarà un arrencada de xarxa de l'entorn d'execució prèvia a l'arrencada (PXE). Per tant, amb els mòduls CM4 que encara no s'han subministrat i tenen un eMMC buit, es realitzarà un arrencada de xarxa per defecte. Durant l'arrencada de xarxa en una xarxa d'aprovisionament, una imatge de sistema operatiu (SO) d'utilitat lleugera (en realitat, un nucli de Linux i un scriptexecute initramfs) serà enviada pel servidor d'aprovisionament al mòdul CM4 a la xarxa, i aquesta imatge s'encarrega de l'aprovisionament.
CM 3 i CM 4s
Els dispositius CM basats en el connector SODIMM no poden arrencar la xarxa, de manera que la programació s'aconsegueix mitjançant USB. Cada dispositiu haurà d'estar connectat al Provisioner. Si necessiteu connectar més de 4 dispositius (el nombre de ports USB del Raspberry Pi), es pot utilitzar un concentrador USB. Utilitzeu cables USB-A a Micro-USB de bona qualitat, connectant-vos des del Raspberry Pi o concentrador al port esclau USB de cada placa CMIO. Totes les plaques CMIO també necessitaran una font d'alimentació, i el pont d'activació d'arrencada esclau USB J4 s'hauria de configurar per habilitar-lo.
IMPORTANT
NO connecteu el port Ethernet del Pi 4. La connexió sense fil s'utilitza per accedir a la gestió web interfície.
Instal·lació
Les instruccions següents eren correctes en el moment de l'emissió. Les instruccions d'instal·lació més recents es poden trobar a la pàgina de Provisioner GitHub.
Instal·lació del Provisioner web aplicació en un Raspberry Pi
ADVERTIMENT
Assegureu-vos que eth0 es connecti a un commutador Ethernet que només tingui connectades les plaques d'E/S CM4. No connecteu eth0 a la vostra xarxa d'oficina/pública, o també pot "provisionar" altres dispositius Raspberry Pi a la vostra xarxa. Utilitzeu la connexió sense fil Raspberry Pi per connectar-vos a la vostra xarxa local.
Es recomana la versió Lite del sistema operatiu Raspberry Pi com a sistema operatiu base on instal·lar el Provisioner. Per simplificar, utilitzeu rpi-imager i activeu el menú de configuració avançada (Ctrl-Maj-X) per configurar la contrasenya, el nom d'amfitrió i la configuració sense fil. Un cop instal·lat el sistema operatiu al Raspberry Pi, haureu de configurar el sistema Ethernet:
- Configureu eth0 perquè tingui una adreça de protocol d'Internet (IP) estàtica de 172.20.0.1 dins d'una subxarxa /16 (màscara de xarxa 255.255.0.0) editant la configuració de DHCP:
- sudo nano /etc/dhcpcd.conf
- Afegeix a la part inferior de la file:
interfície eth0
adreça_ip estàtica=172.20.0.1/16 - Reinicieu per permetre que els canvis tinguin efecte.
- Assegureu-vos que la instal·lació del sistema operatiu estigui actualitzada:
sudo apt update
sudo apt full-upgrade - El Provisioner es subministra com a .deb ja fet file a la pàgina Provisioner GitHub. Baixeu la darrera versió d'aquesta pàgina o utilitzant wget i instal·leu-la amb l'ordre següent:
sudo apt install ./cmprovision4_*_all.deb - Estableix el web nom d'usuari i contrasenya de l'aplicació:
sudo /var/lib/cmprovision/artisan auth:create-user
Ara podeu accedir a web interfície del Proveïdor amb a web navegador utilitzant l'adreça IP sense fil de Raspberry Pi i el nom d'usuari i la contrasenya introduïts a la secció anterior. Només cal que introduïu l'adreça IP a la barra d'adreces del vostre navegador i premeu Enter.
Ús
Quan us connecteu per primera vegada al Provisioner web aplicació amb la teva web navegador, veureu la pantalla Tauler, que tindrà un aspecte com aquest:
Aquesta pàgina de destinació només ofereix informació sobre l'última acció realitzada pel proveïdor (a l'exampanterior, s'ha subministrat un únic CM4).
Carregant imatges
La primera operació necessària en configurar és carregar la vostra imatge al servidor, des d'on es pot utilitzar per subministrar les vostres plaques CM4. Feu clic a l'element del menú "Imatges" a la part superior del menú web pàgina i hauríeu d'aparèixer una pantalla semblant a la que es mostra a continuació, amb una llista d'imatges penjades actualment (que inicialment estarà buida).
Seleccioneu el botó Afegeix una imatge per carregar una imatge; veureu aquesta pantalla:
La imatge ha de ser accessible al dispositiu on es troba web el navegador s'està executant i en un dels formats d'imatge especificats. Seleccioneu la imatge de la vostra màquina utilitzant l'estàndard file diàleg i feu clic a "Carrega". Això ara copiarà la imatge de la vostra màquina al servidor Provisioner que s'executa al Raspberry Pi. Això pot trigar una mica. Un cop penjada la imatge, la veureu a la pàgina Imatges.
Afegir un projecte
Ara heu de crear un projecte. Podeu especificar qualsevol nombre de projectes i cadascun pot tenir una imatge, un conjunt d'scripts o una etiqueta diferent. El projecte actiu és el que s'utilitza actualment per aprovisionament.
Feu clic a l'element del menú "Projectes" per obrir la pàgina Projectes. El següent exampel ja té un projecte, anomenat "Projecte de prova", configurat.
Ara feu clic a "Afegeix projecte" per configurar un nou projecte
- Doneu un nom adequat al projecte i, a continuació, seleccioneu quina imatge voleu que utilitzi aquest projecte a la llista desplegable. També podeu configurar una sèrie d'altres paràmetres en aquest stage, però sovint només n'hi haurà prou amb la imatge.
- Si utilitzeu la v1.5 o posterior del Provisioner, teniu l'opció de verificar que el parpelleig s'hagi completat correctament. En seleccionar-ho, es tornaran a llegir les dades del dispositiu CM després de parpellejar i es confirmarà que coincideix amb la imatge original. Això afegirà temps addicional al subministrament de cada dispositiu, la quantitat de temps afegit dependrà de la mida de la imatge.
- Si seleccioneu el microprogramari per instal·lar (això és opcional), també teniu la possibilitat de personalitzar aquest microprogramari amb algunes entrades de configuració específiques que es fusionaran al binari del carregador d'arrencada. Les opcions disponibles es poden trobar al Raspberry Pi weblloc.
- Feu clic a "Desa" quan hàgiu definit completament el vostre nou projecte; tornareu a la pàgina Projectes i apareixerà el nou projecte. Tingueu en compte que només un projecte pot estar actiu alhora i podeu seleccionar-lo d'aquesta llista.
Guions
Una característica realment útil de Provisioner és la possibilitat d'executar scripts a la imatge, abans o després de la instal·lació. Tres scripts s'instal·len de manera predeterminada al Provisioner i es poden seleccionar quan es crea un projecte nou. S'enumeren a la pàgina Scripts
Un exampL'ús dels scripts podria ser afegir entrades personalitzades a config.txt. L'script estàndard Add dtoverlay=dwc2 a config.txt ho fa, utilitzant el següent codi de shell:
Feu clic a "Afegeix script" per afegir les vostres pròpies personalitzacions:
Etiquetes
El proveïdor té la possibilitat d'imprimir etiquetes per al dispositiu que s'està subministrant. La pàgina Etiquetes mostra totes les etiquetes predefinides que es poden seleccionar durant el procés d'edició del projecte. Per exampÉs possible que vulgueu imprimir codis DataMatrix o de resposta ràpida (QR) per a cada tauler subministrat, i aquesta característica ho facilita molt.
Feu clic a "Afegeix una etiqueta" per especificar la vostra: 
Firmware
El Provisioner ofereix la possibilitat d'especificar quina versió del microprogramari del carregador d'arrencada voleu instal·lar al CM4. A la pàgina Firmware hi ha una llista de totes les opcions possibles, però la més recent sol ser la millor.
Per actualitzar la llista amb les últimes versions del carregador d'arrencada, feu clic al botó "Descarregueu el nou firmware de github".
Possibles problemes
Microprogramari del carregador d'arrencada obsolet
Si el sistema Provisioner no detecta el vostre CM4 quan està connectat, és possible que el microprogramari del carregador d'arrencada estigui obsolet. Tingueu en compte que tots els dispositius CM4 fabricats des del febrer de 2021 tenen el carregador d'arrencada correcte instal·lat a la fàbrica, de manera que això només passarà amb els dispositius que es van fabricar abans d'aquesta data.
EMMC ja programat
Si el mòdul CM4 ja té arrencada files a l'eMMC d'un intent d'aprovisionament anterior, llavors s'iniciarà des de l'eMMC i no es produirà l'arrencada de xarxa necessària per a l'aprovisionament.
Si voleu tornar a subministrar un mòdul CM4, haureu de:
- Connecteu un cable USB entre el servidor d'aprovisionament i el port micro USB de la placa CM4 IO (etiquetat "USB slave").
- Col·loqueu un pont a la placa CM4 IO (J2, "Ajusta el pont per desactivar l'arrencada eMMC").
Això farà que el mòdul CM4 realitzi un arrencada USB, en aquest cas el servidor de subministrament transferirà el fitxer files del sistema operatiu d'utilitat a través d'USB.
Un cop arrencat el sistema operatiu d'utilitat, es posarà en contacte amb el servidor de subministrament a través d'Ethernet per rebre instruccions addicionals i descarregar-ne més files (per exemple, la imatge del sistema operatiu que s'ha d'escriure a eMMC) com és habitual. Per tant, encara és necessària una connexió Ethernet a més del cable USB.
Protocol d'arbre d'abast (STP) en commutadors Ethernet gestionats
L'arrencada PXE no funcionarà correctament si STP està habilitat en un commutador Ethernet gestionat. Aquest pot ser el predeterminat en alguns commutadors (per exemple, Cisco), i si aquest és el cas, caldrà desactivar-lo perquè el procés de subministrament funcioni correctament.
Raspberry Pi és una marca comercial de la Raspberry Pi Foundation
Raspberry Pi Ltd
Documents/Recursos
 |
Raspberry Pi Provisionament del mòdul de càlcul de Raspberry Pi [pdfGuia de l'usuari Aprovisionament del mòdul de càlcul de Raspberry Pi, aprovisionament, mòdul de càlcul de Raspberry Pi, mòdul de càlcul |