Provizante la Raspberry Pi Komputan Modulon
Provizo de la Komputila Modulo Raspberry Pi (Versioj 3 kaj 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Kolofono
© 2020-2022 Raspberry Pi Ltd (antaŭe Raspberry Pi (Komerco) Ltd.)
Ĉi tiu dokumentaro estas disponebla laŭ Krea Komunaĵo Atribuite-NeDerivatoj 4.0 Internacia (CC BY-ND). konstrua dato: 2022-07-19 konstrua versio: githash: 94a2802-pura
Avizo pri jura malgarantio
TEKNIKAJ KAJ FIDEBLECO-DATUMO PRI RASPBERRY PI-PRODUTOJ (INKLUDE DATUMONOJ) KIAL MODIFIKITAJ DE TEMPO AL TEMPO ("RIMEDOJ") ESTAS PROVIZITA DE RASPBERRY PI LTD ("RPL") "KIAL ESTAS" KAJ IUJ ESPRITA AŬ IMPLITA GARANTIOJ, INKLUDE, SED NE LIMIGITA. AL, LA IMPLITAJ GARANTIOJ DE KOMERKABLECO KAJ TAŬGECO POR APARTA CELO ESTAS RENKLAITAJ. ĜIS LA MAKMUME PERMESITA DE APLIKA LEĜO EN NENIAJ OKAĜO RPL RESPONDAS PRI IUJ REKTA, NEREKTA, EKZENDA, SPECIALA, EKZEMPLA AŬ KONSEKVAJ damaĝoj (INKLUDE, SED NE LIMIGITE AL, AKIRADO DE ANSTAŬOJ VAROJ, PERDO DE DATUMOJ; , AŬ PROFITOJ; AŬ KOMERCO INTERRUPTO) TAMEN KaŭZITA KAJ ĈU IUJ TEORIO DE RESPONVO, ĈU KONTRALE, STRIKA RESPONVO, AŬ kulpigo (INkluzive de neglektemo aŭ alie) ekestiĝanta iel ajn el la UZADO DE LA RESPONDEBLECO, Eĉ DE LA RIMEDOCO. DE TIA damaĝo.
RPL rezervas la rajton fari ajnajn plibonigojn, plibonigojn, korektojn aŭ ajnajn aliajn modifojn al la RIMEDOJ aŭ ajnaj produktoj priskribitaj en ili en ajna momento kaj sen plia avizo. La RESURSOJ estas destinitaj por spertaj uzantoj kun taŭgaj niveloj de kono pri dezajno. Uzantoj respondecas nur pri sia elekto kaj uzo de la RIMEDOJ kaj ajna apliko de la produktoj priskribitaj en ili. Uzanto konsentas kompensi kaj senkulpigi RPL kontraŭ ĉiuj kompensdevoj, kostoj, damaĝoj aŭ aliaj perdoj estiĝantaj pro ilia uzo de la RIMEDOJ. RPL donas al uzantoj permeson uzi la RESURSOJN nur kune kun la produktoj Raspberry Pi. Ĉia alia uzo de la RESURSOJ estas malpermesita. Neniu permesilo estas koncedita al iu alia RPL aŭ alia triapartia intelekta proprieta rajto. ALTA RISKAJ ACTIVADOJ. Raspberry Pi-produktoj ne estas desegnitaj, fabrikitaj aŭ destinitaj por uzo en danĝeraj medioj postulantaj malsukcesan sekuran agadon, kiel ekzemple en funkciado de nukleaj instalaĵoj, aviadilnavigacio aŭ komunikadsistemoj, aertrafika kontrolo, armilsistemoj aŭ sekurec-kritikaj aplikoj (inkluzive de vivsubteno). sistemoj kaj aliaj medicinaj aparatoj), en kiuj la malsukceso de la produktoj povus kaŭzi rekte morton, personan vundon aŭ severan fizikan aŭ median damaĝon ("Altaj Riskaj Agadoj"). RPL specife rifuzas ajnan eksplicitan aŭ implican garantion de taŭgeco por Altriskaj Aktivecoj kaj akceptas neniun respondecon por uzo aŭ inkludoj de Raspberry Pi-produktoj en Altriskaj Aktivecoj. Raspberry Pi-produktoj estas provizitaj sub la Normaj Kondiĉoj de RPL. La dispozicio de RPL pri la RIMEDOJ ne vastigas aŭ alie modifas la Normajn Kondiĉojn de RPL inkluzive sed ne limigitaj al la malgarantioj kaj garantioj esprimitaj en ili.
Dokumentversiohistorio 
Amplekso de documento
Ĉi tiu dokumento validas por la sekvaj produktoj de Raspberry Pi:
Enkonduko
La CM Provizanto estas a web aplikaĵo desegnita por faciligi kaj pli rapidan programi grandan nombron da aparatoj de Raspberry Pi Compute Module (CM). Ĝi estas simpla por instali kaj simpla por uzi. Ĝi provizas interfacon al datumbazo de kernaj bildoj, kiuj povas esti alŝutitaj, kune kun la kapablo uzi skriptojn por personecigi diversajn partojn de la instalado dum la ekbrila procezo. Etiked-preso kaj firmvara ĝisdatigo ankaŭ estas subtenataj. Ĉi tiu blankpapero supozas, ke la Provisioner-servilo, programaro versio 1.5 aŭ pli nova, funkcias per Raspberry Pi.
Kiel ĉio funkcias
CM4
La Provisioner-sistemo devas esti instalita sur sia propra kablita reto; la Raspberry Pi kuranta la servilon estas konektita al ŝaltilo, kune kun tiom da CM4-aparatoj kiom la ŝaltilo povas subteni. Ajna CM4 konektita al ĉi tiu reto estos detektita de la provizosistemo kaj aŭtomate ekbrilos kun la postulata firmvaro de la uzanto. La kialo por havi sian propran kablian reton evidentiĝas kiam vi konsideras, ke iu ajn CM4 ŝtopita al la reto estos provizita, do teni la reton aparta de iu viva reto estas esenca por malhelpi la neintencitan reprogramadon de aparatoj.
BILDOŜANĜOJ CM 4 IO-tabuloj kun CM 4 -> CM4 IO-tabuloj kun CM4
Uzante Raspberry Pi kiel la servilon, eblas uzi kabligitan reton por la Provizanto sed ankoraŭ permesi aliron al eksteraj retoj uzante sendratan konekteblecon. Ĉi tio ebligas facilan elŝuton de bildoj al la servilo, preta por la provizoprocezo, kaj permesas al la Raspberry Pi servi la Provizanton. web interfaco. Multoblaj bildoj povas esti elŝutitaj; la Provizanto konservas datumbazon de bildoj kaj faciligas elekti la taŭgan bildon por agordi malsamajn aparatojn.
Kiam CM4 estas ligita al la reto kaj estas ŝaltita, ĝi provos ekbruligi, kaj post kiam aliaj opcioj estas provitaj, reto-ŝargo estas provata. Je ĉi tiu punkto la Provisioner Dynamic Host Configuration Protocol (DHCP) sistemo respondas al la ekfunkciigo CM4 kaj provizas ĝin per minimuma startebla bildo, kiu estas elŝutita al la CM4 kaj poste rulita kiel radiko. Ĉi tiu bildo povas programi la enigitan Multmedian Karton (eMMC) kaj ruli ajnajn postulatajn skriptojn, kiel instrukciitaj de la Provizanto.
Pli da detaloj
CM4-moduloj sendas kun lanĉa agordo, kiu provos lanĉi de eMMC unue; se tio malsukcesas ĉar la eMMC estas malplena, ĝi elfaros retan lanĉon de preboot ekzekutmedio (PXE). Do, kun CM4-moduloj, kiuj ankoraŭ ne estis provizitaj, kaj havas malplenan eMMC, reta ekkuro estos farita defaŭlte. Dum reto-ŝargo sur provizanta reto, malpeza utila operaciumo (OS) bildo (fakte Linukso-kerno kaj scriptexecute initramfs) estos servata de la provizservilo al la CM4-modulo tra la reto, kaj ĉi tiu bildo pritraktas la provizon.
CM 3 kaj CM 4s
La CM-aparatoj bazitaj sur la SODIMM-konektilo ne povas retigi, do programado estas atingita per USB. Ĉiu aparato devos esti konektita al la Provizanto. Se vi bezonas konekti pli ol 4 aparatojn (la nombro da USB-havenoj sur la Raspberry Pi), USB-nabo povas esti uzata. Uzu bonkvalitajn USB-A al Mikro-USB kablojn, konektante de la Raspberry Pi aŭ nabo al la USB-sklava haveno de ĉiu CMIO-tabulo. Ĉiuj CMIO-tabuloj ankaŭ bezonos elektroprovizon, kaj la J4-USB-sklava ekfunkciiga jumper devas esti agordita por ebligi.
GRAVA
NE konektu la Ethernet-havenon de la Pi 4. La sendrata konekto estas uzata por aliri la administradon web interfaco.
Instalado
La sekvaj instrukcioj estis ĝustaj en la momento de la eldono. La plej novaj instalinstrukcioj troveblas sur la paĝo de Provisioner GitHub.
Instalado de la Provizanto web aplikaĵo sur Raspberry Pi
AVERTO
Certigu, ke eth0 konektas al Ethernet-ŝaltilo, kiu havas nur la CM4 IO-Estrarojn konektitaj. Ne konektu eth0 al via oficejo/publika reto, aŭ ĝi ankaŭ povas 'provizi' aliajn Raspberry Pi-aparatojn en via reto. Uzu la sendratan konekton Raspberry Pi por konekti al via loka reto.
La Lite versio de la Raspberry Pi OS estas rekomendita kiel la baza OS sur kiu instali la Provizilon. Por simpleco uzu rpi-bildilon, kaj aktivigu la altnivelajn agordojn (Ctrl-Shift-X) por agordi la pasvorton, gastigan nomon kaj sendratajn agordojn. Post kiam la OS estas instalita sur la Raspberry Pi, vi devos agordi la Ethernet-sistemon:
- Agordu eth0 por havi senmovan adreson de Interreta Protokolo (IP) de 172.20.0.1 ene de /16-subreto (retmasko 255.255.0.0) redaktante la DHCP-agordon:
- sudo nano /etc/dhcpcd.conf
- Aldonu al la fundo de la file:
interfaco eth0
statika ip_adreso=172.20.0.1/16 - Rekomencu por ebligi la ŝanĝojn.
- Certigu, ke la OS-instalado estas ĝisdatigita:
sudo apt ĝisdatigo
sudo apt kompleta ĝisdatigo - La Provizanto estas liverita kiel preta .deb file sur la paĝo de Provisioner GitHub. Elŝutu la plej novan version de tiu paĝo aŭ uzante wget, kaj instalu ĝin per la sekva komando:
sudo apt install ./cmprovision4_*_all.deb - Agordu la web uzantnomo kaj pasvorto de la aplikaĵo:
sudo /var/lib/cmprovision/artisan auth:create-user
Vi nun povas aliri la web interfaco de la Provizanto kun a web retumilo uzante la sendratan IP-adreson de Raspberry Pi kaj la uzantnomon kaj pasvorton enigitajn en la antaŭa sekcio. Nur enigu la IP-adreson en la adresbreton de via retumilo kaj premu Enigu.
Uzado
Kiam vi unue konektiĝas al la Provizanto web aplikaĵo kun via web retumilo, vi vidos la ekranon Panelo, kiu aspektos kiel ĉi tio:
Ĉi tiu alterpaĝo simple donas kelkajn informojn pri la plej nova ago farita de la Provizanto (en la ekzample supre, ununura CM4 estis provizita).
Alŝuto de bildoj
La unua operacio necesa dum la agordo estas ŝargi vian bildon al la servilo, de kie ĝi povas esti uzata por provizi viajn CM4-tabulojn. Alklaku la menueron 'Bildoj' ĉe la supro de la web paĝo kaj vi devus ricevi ekranon similan al tiu montrita sube, montrante liston de nuntempe alŝutitaj bildoj (kiuj komence estos malplenaj).
Elektu la butonon Aldoni bildon por alŝuti bildon; vi vidos ĉi tiun ekranon:
La bildo devas esti alirebla sur la aparato kie la web retumilo funkcias, kaj en unu el la bildformatoj specifitaj. Elektu la bildon de via maŝino uzante la normon file dialogo, kaj alklaku 'Alŝuti'. Ĉi tio nun kopios la bildon de via maŝino al la Provisioner-servilo funkcianta sur la Raspberry Pi. Ĉi tio povas preni iom da tempo. Post kiam la bildo estas alŝutita, vi vidos ĝin sur la paĝo Bildoj.
Aldonante projekton
Nun vi devas krei projekton. Vi povas specifi ajnan nombron da projektoj, kaj ĉiu povas havi malsaman bildon, aron de skriptoj aŭ etikedon. La aktiva projekto estas tiu, kiu estas nuntempe uzata por provizado.
Alklaku la menueron 'Projektoj' por aperigi la paĝon de Projektoj. La sekva ekzampLe jam havas unu projekton, nomatan 'Provprojekto', starigita.
Nun alklaku 'Aldoni projekton' por agordi novan projekton
- Donu al la projekto taŭgan nomon, tiam elektu kiun bildon vi deziras, ke ĉi tiu projekto uzu el la fallisto. Vi ankaŭ povas agordi kelkajn aliajn parametrojn ĉe ĉi tiu stage, sed ofte nur la bildo sufiĉos.
- Se vi uzas v1.5 aŭ pli novan de la Provizanto, tiam vi havas la eblon kontroli, ke la ekbrilado ĝuste finiĝis. Elektante ĉi tion relegos la datumojn de la CM-aparato post ekbrilado, kaj konfirmos, ke ĝi kongruas kun la originala bildo. Ĉi tio aldonos kroman tempon al la provizo de ĉiu aparato, la kvanto da tempo aldonita dependos de la grandeco de la bildo.
- Se vi elektas la firmvaro por instali (ĉi tio estas laŭvola), vi ankaŭ havas la kapablon personecigi tiun firmvaron kun iuj specifaj agordaj enskriboj, kiuj estos kunfanditaj en la binaron de ekŝargilo. La disponeblaj opcioj troveblas sur la Raspberry Pi webretejo.
- Alklaku 'Konservi' kiam vi plene difinis vian novan projekton; vi revenos al la paĝo Projektoj, kaj la nova projekto estos listigita. Notu, ke nur unu projekto povas esti aktiva iam ajn, kaj vi povas elekti ĝin el ĉi tiu listo.
Skriptoj
Vere utila trajto de Provisioner estas la kapablo ruli skriptojn sur la bildo, antaŭ aŭ post instalado. Tri skriptoj estas instalitaj defaŭlte en la Provizanto, kaj povas esti elektitaj dum kreado de nova projekto. Ili estas listigitaj sur la Scriptspage
EksampLa uzo de skriptoj povus esti aldoni kutimajn enskribojn al config.txt. La norma skripto Add dtoverlay=dwc2 al config.txt faras tion, uzante la sekvan ŝelkodon:
Alklaku 'Aldoni skripton' por aldoni viajn proprajn personigojn:
Etikedoj
La Provizanto havas la facilecon presi etikedojn por la aparato provizita. La paĝo Etikedoj montras ĉiujn antaŭdifinitajn etikedojn, kiuj povas esti elektitaj dum la projekta redakta procezo. Por ekzample, vi eble volas presi DataMatrix aŭ rapidajn respondajn (QR) kodojn por ĉiu provizota tabulo, kaj ĉi tiu funkcio faras tion tre facila.
Alklaku 'Aldoni etikedon' por specifi vian propran: 
Firmvaro
La Provizanto disponigas la kapablon specifi kiun version de la ekŝargila firmvaro vi volas instali sur la CM4. En la paĝo Firmware estas listo de ĉiuj eblaj opcioj, sed la plej lastatempa estas kutime la plej bona.
Por ĝisdatigi la liston kun la plej novaj versioj de la ekŝargilo, alklaku la butonon 'Elŝuti novan firmvaron el github'.
Eblaj problemoj
Malaktuala firmvaro de ekŝargilo
Se via CM4 ne estas detektita de la Provisioner-sistemo kiam ĝi estas enŝovita, eblas ke la ekŝargila firmvaro estas malaktuala. Notu, ke ĉiuj CM4-aparatoj fabrikitaj ekde februaro 2021 havas la ĝustan ekŝargilon instalitan en la fabriko, do tio okazos nur kun aparatoj kiuj estis fabrikitaj antaŭ tiu dato.
Jam programita eMMC
Se la CM4-modulo jam havas lanĉon files en la eMMC de antaŭa provizprovo tiam ĝi ekŝargos de la eMMC kaj la reto-boto necesa por provizado ne okazos.
Se vi volas reprovizi CM4-modulon, vi devos:
- Aligu USB-kablon inter la provizanta servilo kaj la mikro-USB-haveno de la CM4 IO Board (etikedita 'USB-sklavo').
- Metu jumper sur la CM4 IO Board (J2, 'Fit jumper to maleable eMMC boot').
Ĉi tio kaŭzos, ke la CM4-modulo elfaros USB-lanĉon, en kiu kazo la provizanta servilo transdonos la files de la utileco OS super USB.
Post kiam la utila VIN ekfunkciis, ĝi kontaktos la provizantan servilon per Ethernet por ricevi pliajn instrukciojn kaj elŝuti pliajn files (ekz. la OS-bildo skribenda al eMMC) kiel kutime. Do, Ethernet-konekto krom la USB-kablo ankoraŭ estas necesa.
Spanning Tree Protocol (STP) sur administritaj Ethernet-ŝaltiloj
PXE-lanĉo ne funkcios ĝuste se STP estas ebligita sur administrita Ethernet-ŝaltilo. Ĉi tio povas esti la defaŭlta ĉe iuj ŝaltiloj (ekz. Cisco), kaj se tio estas la kazo, ĝi devos esti malŝaltita por ke la provizado funkciu ĝuste.
Raspberry Pi estas varmarko de la Fondaĵo Raspberry Pi
Raspberry Pi Ltd
Dokumentoj/Rimedoj
 |
Raspberry Pi Provizanta la Raspberry Pi Komputan Modulon [pdf] Uzantogvidilo Provizado de la Komputila Modulo Raspberry Pi, Provizado, la Komputila Modulo de Raspberry Pi, Komputila Modulo |