Pruvisione di u Modulu di calculu Raspberry Pi
Pruvisione di u Modulu Compute Raspberry Pi (Versioni 3 è 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Colofone
© 2020-2022 Raspberry Pi Ltd (ex Raspberry Pi (Trading) Ltd.)
Sta documentazione hè licenziata sottu una Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). data di creazione: 2022-07-19 versione di costruzione: githash: 94a2802-clean
Avvisu di disclaimer legale
I DATI TECNICI È DI AFFIDABILITÀ PER I PRODOTTI RASPBERRY PI (INCLUSI SCHEDE DI DATI) COME MODIFICATI DA TEMPU À TEMPU ("RESOURCES") SONU FORNITI DA RASPBERRY PI LTD ("RPL") "COME SO" È QUALSIASI GARANZIA ESPRESSA O IMPLICITA, INCLUDE, MA NON LIMITATA. À, E GARANTIE IMPLICITE DI MERCHANTABILITÀ E IDONEITÀ PER UN SUPPORTU PARTICULARI SONT DISCLIMATE. À LA MASSIMA MESSA PERMESSA DA A LEGGE APPLICABILE IN NESSUN CASU, RPL SERA RESPONSABILE PER QUALUNQUE DANNI DIRETTI, INDIRETTI, INCIDENTALI, SPECIALI, ESEMPLARI O CONSEGUENTI (INCLUSU, MA NON LIMITATI À, L'ACQUISSIONE DI BENE SOSTITUTI, PERDITA DI DORTI DI SERVIZI; , O PROFITTI ; O INTERRUPZIONE DI L'AFFARI) QUANTÀ CAUSATA E IN QUALSIASI TEORIA DI RESPONSABILITÀ, SIA IN CONTRATTU, RESPONSABILITÀ STRICTA, O TORT (INCLUSI A NEGGLIGENZA O ALTRE) SURGIENDA IN QUALSUNA MANERA DA L'USU DI A RESOURCES, ANCHE A PUBLICIDAD. DI TALI DANNI.
RPL si riserva u dirittu di fà qualsiasi miglioramenti, migliurà, currezzione o qualsiasi altre mudificazione à e RESOURCES o à qualsiasi prudutti descritti in elli in ogni mumentu è senza avvisu. I RESOURCES sò destinati à l'utilizatori qualificati cù livelli adattati di cunniscenza di u disignu. L'utilizatori sò solu rispunsevuli di a so selezzione è l'usu di i RESOURCES è di qualsiasi applicazione di i prudutti descritti in elli. L'Usuariu accunsente à indemnizà è mantene RPL innocu per tutte e responsabilità, i costi, i danni o altre perdite derivanti da u so usu di e RESOURCES. RPL cuncede à l'utilizatori u permessu di utilizà i RESOURCES solu in cunghjunzione cù i prudutti Raspberry Pi. Ogni altru usu di i RESOURCES hè pruibitu. Nisuna licenza hè cuncessa à qualsiasi altru RPL o altru dirittu di pruprietà intellettuale di terzu. ATTIVITÀ ALTE RISCHI. I prudutti Raspberry Pi ùn sò micca pensati, fabbricati o destinati à l'usu in ambienti periculosi chì necessitanu un rendimentu sicuru, cum'è in l'operazione di installazioni nucleari, sistemi di navigazione o di cumunicazione di l'aeronautica, cuntrollu di u trafficu aereu, sistemi d'arme o applicazioni critiche per a sicurezza (cumpresu u sustegnu di vita). Sistemi è altri dispositi medichi), in quale u fallimentu di i prudutti puderia purtà direttamente à morte, ferite persunale o danni fisichi o ambientali severi ("Attività à Rischiu Altu"). RPL declina specificamente qualsiasi garanzia espressa o implicita di idoneità per l'Attività di Rischiu Altu è ùn accetta micca responsabilità per l'usu o l'inclusioni di i prudutti Raspberry Pi in Attività di Rischiu Altu. I prudutti Raspberry Pi sò furniti sottumessi à i Termini Standard di RPL. A prestazione di RPL di e RISORSE ùn espande o mudifica altrimenti i Termini Standard di RPL, cumprese, senza limitazione, i disclaims è e garanzie espresse in elli.
Storia di a versione di u documentu 
Scopu di u document
Stu documentu si applica à i seguenti prudutti Raspberry Pi:
Introduzione
U CM Provisioner hè a web applicazione pensata per fà a prugrammazione di un gran numaru di dispusitivi Raspberry Pi Compute Module (CM) assai più faciule è più veloce. Hè simplice per installà è simplice per aduprà. Fornisce una interfaccia à una basa di dati di l'imaghjini di u kernel chì ponu esse caricate, inseme cù l'abilità di utilizà scripts per persunalizà diverse parti di a stallazione durante u prucessu lampante. A stampa di l'etichetta è l'aghjurnamentu di firmware sò ancu supportati. Questu whitepaper assume chì u servitore Provisioner, versione di u software 1.5 o più recente, hè in esecuzione nantu à un Raspberry Pi.
Cumu tuttu funziona
CM4
U sistema di Provisioner deve esse stallatu nantu à a so propria reta filata; u Raspberry Pi chì gestisce u servitore hè cunnessu à un cambiatore, inseme cù tanti dispositi CM4 quant'è u cambiamentu pò sustene. Ogni CM4 cunnessu à sta reta serà rilevatu da u sistema di pruvista è automaticamente lampatu cù u firmware necessariu di l'utilizatore. U mutivu di avè a so propria rete cablata diventa chjaru quandu si cunsiderà chì qualsiasi CM4 cunnessu à a reta serà furnitu, cusì mantene a rete separata da qualsiasi rete in diretta hè essenziale per impedisce a reprogrammazione involontaria di i dispositi.
MODIFICHE D'IMAGE Schede CM 4 IO con CM 4 -> Schede CM4 IO con CM4
Utilizendu un Raspberry Pi cum'è u servitore, hè pussibule di utilizà a rete cablata per u Provisioner, ma ancu permette l'accessu à e rete esterne cù a cunnessione wireless. Questu permette un scaricamentu faciule di l'imaghjini à u servitore, prontu per u prucessu di pruvista, è permette à u Raspberry Pi di serve u Provisioner. web interfaccia. Multiple images ponu esse telecaricati; u Provisioner mantene una basa di dati di l'imaghjini è facilita à selezziunà l'imaghjini adattati per stallà diversi dispositi.
Quandu un CM4 hè attaccatu à a reta è hè alimentatu, pruvarà à boot, è una volta chì l'altri opzioni sò stati pruvati, l'iniziu di a rete hè pruvatu. À questu puntu, u sistema Provisioner Dynamic Host Configuration Protocol (DHCP) risponde à l'iniziu CM4 è furnisce cù una maghjina minima di bootable chì hè scaricata in u CM4, poi eseguite cum'è root. Questa maghjina pò programà a Carta Multi-Media incrustata (eMMC) è eseguisce qualsiasi script necessariu, cum'è urdinatu da u Provisioner.
Più dettagli
I moduli CM4 spedinu cù una cunfigurazione di boot chì pruvarà di boot da eMMC prima; se falla perchè l'eMMC hè viotu, eseguirà un avviu di rete di l'ambiente di esecuzione preboot (PXE). Allora, cù i moduli CM4 chì ùn sò micca stati furniti, è anu un eMMC vacante, un boot di rete serà realizatu per automaticamente. Durante un boot di rete in una rete di pruvista, una maghjina di u sistema operatore di utilità ligera (OS) (in realtà un kernel Linux è un scriptexecute initramfs) serà servuta da u servitore di pruvisione à u modulu CM4 nantu à a reta, è sta maghjina gestisce l'approvvigionamentu.
CM 3 è CM 4s
I dispositi CM basati nantu à u connettore SODIMM ùn ponu micca avvià a rete, cusì a prugrammazione hè ottenuta nantu à USB. Ogni dispusitivu hà da esse cunnessu à u Provisioner. Sè avete bisognu di cunnette più di 4 dispusitivi (u numeru di porti USB nantu à u Raspberry Pi), un hub USB pò esse usatu. Aduprate cables USB-A à Micro-USB di bona qualità, cunnetta da u Raspberry Pi o hub à u portu slave USB di ogni scheda CMIO. Tutte e schede CMIO anu ancu bisognu di un alimentazione elettrica, è u jumper di attivazione di l'esclava USB J4 deve esse stallatu per attivà.
IMPORTANTE
Ùn cunnette micca u portu Ethernet di u Pi 4. A cunnessione wireless hè utilizata per accede à a gestione web interfaccia.
Installazione
I seguenti struzzioni eranu curretti à u mumentu di l'emissione. L'ultime struzzioni di installazione ponu esse truvate nantu à a pagina di Provisioner GitHub.
Installazione di u Provisioner web applicazione nantu à un Raspberry Pi
ATTENZIONE
Assicuratevi chì eth0 si cunnetta à un switch Ethernet chì hà solu e CM4 IO Boards cunnessi. Ùn cunnette micca eth0 à a vostra rete di ufficiu / publicu, o pò ancu "furnisce" altri dispositi Raspberry Pi in a vostra reta. Aduprate a cunnessione wireless Raspberry Pi per cunnette à a vostra reta lucale.
A versione Lite di u Raspberry Pi OS hè cunsigliatu cum'è u SO di basa nantu à quale installà u Provisioner. Per simplicità, aduprate rpi-imager, è attivate u menù di paràmetri avanzati (Ctrl-Shift-X) per stabilisce a password, u nome d'ospite è i paràmetri wireless. Una volta chì u SO hè stallatu nantu à u Raspberry Pi, avete bisognu di cunfigurà u sistema Ethernet:
- Configurate eth0 per avè un indirizzu static Internet Protocol (IP) di 172.20.0.1 in una subnet /16 (netmask 255.255.0.0) editendu a cunfigurazione DHCP:
- sudo nano /etc/dhcpcd.conf
- Aghjunghjite à u fondu file:
interfaccia eth0
static ip_address=172.20.0.1/16 - Reboot per permette à i cambiamenti di fà effettu.
- Assicuratevi chì l'installazione di u SO hè aghjurnata:
sudo apt update
sudo apt aghjurnamentu cumpletu - U Provisioner hè furnitu cum'è un .deb ready-made file nantu à a pagina Provisioner GitHub. Scaricate l'ultima versione da quella pagina o usendu wget, è installate cù u cumandimu seguente:
sudo apt install ./cmprovision4_*_all.deb - Pone u web nome d'utilizatore è password di l'applicazione:
sudo /var/lib/cmprovision/artisan auth:create-user
Pudete avà accede à u web interfaccia di u Provisioner cù a web navigatore utilizendu l'indirizzu IP wireless Raspberry Pi è u nome d'utilizatore è a password inseriti in a sezione precedente. Inserite l'indirizzu IP in a barra di indirizzu di u vostru navigatore è appughjà Enter.
Usu
Quandu avete prima cunnessu à u Provisioner web applicazione cù u vostru web navigatore vi vede a schermu Dashboard, chì parerà cusì:
Questa pagina di destinazione dà solu alcune informazioni nantu à l'ultime azzione realizata da u Provisioner (in l'example sopra, un solu CM4 hè statu furnitu).
Caricà l'imaghjini
A prima operazione necessaria durante a stallazione hè di carricà a vostra maghjina à u servitore, da induve pò esse aduprata per furnisce e vostre schede CM4. Cliccate nantu à l'elementu di menu "Immagini" in cima web pagina è duvete ottene una schermu simile à quella mostrata quì sottu, chì mostra una lista di l'imaghjini attualmente caricate (chì inizialmente seranu viotu).
Selezziunate u buttone Add Image per cullà una maghjina; vi vede stu screnu:
L'imaghjini deve esse accessibile in u dispusitivu induve u web navigatore hè in esecuzione, è in unu di i formati di l'imaghjini specificati. Selezziunate l'imaghjini da a vostra macchina cù u standard file dialogu, è cliccate "Carica". Questu avà copià l'imaghjini da a vostra macchina à u servitore Provisioner in esecuzione nantu à u Raspberry Pi. Questu pò piglià qualchì tempu. Una volta l'imaghjina hè caricata, vi vede nantu à a pagina Images.
Aghjunghjendu un prughjettu
Avà avete bisognu di creà un prughjettu. Pudete specificà ogni numeru di prughjetti, è ognunu pò avè una maghjina diversa, set di script, o etichetta. U prughjettu attivu hè quellu chì hè attualmente utilizatu per a pruvista.
Cliccate nantu à l'elementu di menu "Progetti" per apparirà a pagina di Prughjetti. I seguenti example hà digià un prughjettu, chjamatu 'prughjettu di prova', stallatu.
Avà cliccate nant'à 'Aggiungi prughjettu' à stallà un novu prughjettu
- Dà u prugettu un nome appropritatu, dopu selezziunate l'imaghjini chì vulete usà stu prughjettu da u listinu. Tù dinù ponu stabilisce un numeru di altri paràmetri à stu stage, ma spessu solu l'imaghjini basterà.
- Sè vo aduprate v1.5 o più recente di u Provisioner, allora avete l'opzione di verificà chì u lampatu hè cumpletu currettamente. Selezziunà stu vi leghje daretu à i dati da u dispusitivu CM dopu lampendu, è cunfirmà chì currisponde à l 'imagine uriginale. Questu aghjunghjerà u tempu extra à l'approvvigionamentu di ogni dispusitivu, a quantità di tempu aghjuntu dependerà di a dimensione di l'imaghjini.
- Se selezziunate u firmware per installà (questu hè facultativu), avete ancu l'abilità di persunalizà quellu firmware cù alcune entrate di cunfigurazione specifiche chì saranu unificate in u binariu di bootloader. L'opzioni dispunibili ponu esse truvati nantu à u Raspberry Pi websitu.
- Cliccate "Salvà" quandu avete definitu u vostru novu prughjettu; tornerete à a pagina di Prughjetti, è u novu prughjettu serà listatu. Nota chì solu un prughjettu pò esse attivu in ogni mumentu, è pudete selezziunate da questa lista.
Scripts
Una funzione veramente utile di Provisioner hè a capacità di eseguisce scripts nantu à l'imaghjini, prima o dopu a stallazione. Trè script sò stallati per automaticamente in u Provisioner, è ponu esse selezziunati quandu creanu un novu prughjettu. Sò listati nantu à a Scriptspage
Un esampL'usu di script pò esse per aghjunghje voci persunalizati à config.txt. U script standard Add dtoverlay=dwc2 à config.txt faci questu, utilizendu u codice di shell seguente:
Cliccate nant'à "Aggiungi script" per aghjunghje e vostre personalizzazioni:
Etichette
U Provisioner hà a facilità di stampà etichette per u dispusitivu chì hè furnitu. A pagina Etichette mostra tutte e etichette predefinite chì ponu esse scelte durante u prucessu di editazione di u prugettu. Per esample, pudete vulete stampà i codici DataMatrix o risposta rapida (QR) per ogni bordu furnitu, è sta funzione rende questu assai faciule.
Cliccate nantu à "Aggiungi etichetta" per specificà u vostru propiu: 
Firmware
U Provisioner furnisce a capacità di specificà a versione di u firmware di bootloader chì vulete installà nantu à u CM4. In a pagina Firmware ci hè una lista di tutte l'opzioni pussibuli, ma a più recente hè di solitu u megliu.
Per aghjurnà a lista cù l'ultime versioni di u bootloader, cliccate nant'à u buttone "Download new firmware from github".
Pussibili prublemi
Firmware di bootloader out-of-date
Se u vostru CM4 ùn hè micca rilevatu da u sistema di Provisioner quandu hè cunnessu, hè pussibule chì u firmware di bootloader hè fora di data. Nota chì tutti i dispositi CM4 fabbricati da u ferraghju 2021 anu u bootloader currettu installatu in fabbrica, cusì questu succede solu cù i dispositi fabbricati prima di quella data.
Digià programatu eMMC
Se u modulu CM4 hà digià boot files in l'eMMC da un tentativu di pruvisione precedente, allora s'avviarà da l'eMMC è l'avviamentu di a rete necessariu per l'approvvigionamentu ùn succede micca.
Se vulete riprovisione un modulu CM4, avete bisognu di:
- Attaccà un cable USB trà u servitore di fornitura è u portu micro USB di u CM4 IO Board (etichettatu "USB slave").
- Mettite un jumper in u CM4 IO Board (J2, 'Fit jumper to disable eMMC boot').
Questu pruvucarà u modulu CM4 per eseguisce un boot USB, in quale casu u servitore di fornitura trasfirerà u files di l'utility OS over USB.
Dopu chì l'utility OS hà iniziatu, cuntattà u servitore di fornitura per Ethernet per riceve più struzzioni, è scaricate supplementari files (per esempiu, l'imaghjini OS da scrive à eMMC) cum'è di solitu. Dunque, una cunnessione Ethernet in più di u cable USB hè sempre necessariu.
Spanning Tree Protocol (STP) nantu à i switch Ethernet gestiti
L'avvio PXE ùn funziona micca bè se STP hè attivatu nantu à un switch Ethernet gestitu. Questu pò esse u predeterminatu in certi switches (per esempiu, Cisco), è s'ellu hè u casu, duverà esse disattivatu per u prucessu di pruvisione per travaglià bè.
Raspberry Pi hè una marca di a Raspberry Pi Foundation
Raspberry Pi Ltd
Documenti / Risorse
 |
Raspberry Pi Provisioning u Modulu Compute Raspberry Pi [pdfGuida di l'utente Pruvisione di u Modulu di calculu Raspberry Pi, Pruvisionamentu, u Modulu di calculu Raspberry Pi, Modulu di calculu |