Provvista tal-Raspberry Pi Compute Module

Provvista tal-Modulu tal-Kompjuter tar-Raspberry Pi (Verżjonijiet 3 u 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean

Kolofonu
© 2020-2022 Raspberry Pi Ltd (qabel Raspberry Pi (Trading) Ltd.)
Din id-dokumentazzjoni hija liċenzjata taħt Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). build-date: 2022-07-19 build-version: githash: 94a2802-clean

Avviż ta' ċaħda legali

DEJTA TEKNIKA U AFFIDABILTÀ GĦAL PRODOTTI RASPBERRY PI (INKLUŻI SKEJJIET TA' DATA) KIF MODIFIKATI MINN Żmien għal żmien (“RIŻORSI”) HUMA PROVVUTI MINN RASPBERRY PI LTD (“RPL”) “KIF INHI” U KULL GARANZIJA ESPRESSA JEW IMPLIKATI, INKLUŻI, IMMA MHUX LIMITATA. GĦAL, IL-GARANZIJI IMPLICITI TA' KUMMERĊJABILITÀ U ADATTAZZJONI GĦAL GĦAN PARTIKOLARI MHUMIEX JIRRADNU. SAL-MESSA MASSIMA PERMESSA MILL-LIĠI APPLIKABBLI FL-EBDA KAŻ RPL M’GĦANDU JKUN RESPONSABBLI GĦAL KWALUNKWE DANNI DIRETTI, INDIRETTI, INĊIDENTALI, SPEĊJALI, EŻEMPLARI JEW KONSEKWENZJALI (INKLUŻI, IMMA MHUX LIMITAT GĦAL, AKKWIST TA’ OĠĠETTI SOSTITUTTI TA’ UŻU TA’ SERVIZZ, TELF TA’ ID-DATA; , JEW PROFITTI; JEW INTERRUZZJONI TAN-NEGOZJU) IKKAŻAW U FUQ KWALUNKWE TEORIA TA’ RESPONSABBILTÀ, KEMM F’KUNTRATT, RESPONSABBILTÀ STRETTA, JEW DELEG (INKLUŻA NEGLIĠENZA JEW MOD IEĦOR) LI JKOLLU B’KULL MOD MINN L-UŻU TAR-RIŻORSSIBILITÀ TA’ TALI ĦSARA.
RPL tirriżerva d-dritt li tagħmel xi titjib, titjib, korrezzjoni jew kwalunkwe modifika oħra lir-RIŻORSI jew kwalunkwe prodott deskritt fihom fi kwalunkwe ħin u mingħajr avviż ieħor. Ir-RIŻORSI huma maħsuba għal utenti tas-sengħa b'livelli xierqa ta' għarfien tad-disinn. L-utenti huma unikament responsabbli għall-għażla u l-użu tagħhom tar-RIŻORSI u kwalunkwe applikazzjoni tal-prodotti deskritti fihom. L-utent jaqbel li jindennizza u jżomm lil RPL bla ħsara kontra r-responsabbiltajiet kollha, spejjeż, danni jew telf ieħor li jirriżulta mill-użu tagħhom tar-RIŻORSI. RPL jagħti permess lill-utenti biex jużaw ir-RIŻORSI biss flimkien mal-prodotti Raspberry Pi. Kull użu ieħor tar-RIŻORSI huwa pprojbit. L-ebda liċenzja ma tingħata lil kwalunkwe RPL ieħor jew dritt ieħor ta’ proprjetà intellettwali ta’ parti terza. ATTIVITAJIET TA' RISKJU GĦOLI. Il-prodotti Raspberry Pi mhumiex iddisinjati, manifatturati jew maħsuba għall-użu f'ambjenti perikolużi li jeħtieġu prestazzjoni mingħajr periklu, bħal fl-operat ta' faċilitajiet nukleari, sistemi ta' navigazzjoni jew komunikazzjoni ta' inġenji tal-ajru, kontroll tat-traffiku tal-ajru, sistemi tal-armi jew applikazzjonijiet kritiċi għas-sikurezza (inkluż appoġġ għall-ħajja sistemi u apparat mediku ieħor), li fihom il-falliment tal-prodotti jista’ jwassal direttament għall-mewt, korriment personali jew ħsara fiżika jew ambjentali severa (“Attivitajiet ta’ Riskju Għoli”). RPL speċifikament jiċħad kwalunkwe garanzija espressa jew impliċita ta 'saħħa għal Attivitajiet ta' Riskju Għoli u ma jaċċetta l-ebda responsabbiltà għall-użu jew inklużjoni ta 'prodotti Raspberry Pi f'Attivitajiet ta' Riskju Għoli. Il-prodotti Raspberry Pi huma pprovduti soġġetti għat-Termini Standard ta 'RPL. Il-provvediment ta' RPL tar-RIŻORSI ma jespandix jew jimmodifikax b'xi mod ieħor it-Termini Standard ta' RPL inklużi iżda mhux limitati għaċ-ċaħdiet u l-garanziji espressi fihom.

Storja tal-verżjoni tad-dokument Skop tad-dokument
Dan id-dokument japplika għall-prodotti Raspberry Pi li ġejjin:

Introduzzjoni

Il-Provveditur tas-CM huwa a web applikazzjoni ddisinjata biex tagħmel l-ipprogrammar ta 'numru kbir ta' apparati tal-Raspberry Pi Compute Module (CM) ħafna aktar faċli u aktar malajr. Huwa sempliċi biex tinstalla u sempliċi biex tużah. Jipprovdi interface għal database ta 'immaġini tal-qalba li jistgħu jittellgħu, flimkien mal-kapaċità li tuża skripts biex tippersonalizza diversi partijiet tal-installazzjoni matul il-proċess li jteptep. L-istampar tat-tikketti u l-aġġornament tal-firmware huma appoġġjati wkoll. Din il-whitepaper tassumi li s-server Provisioner, verżjoni tas-softwer 1.5 jew aktar ġdida, qed taħdem fuq Raspberry Pi.

Kif jaħdem kollox

CM4
Is-sistema Provisioner jeħtieġ li tiġi installata fuq in-netwerk bil-fili tagħha stess; il-Raspberry Pi li jmexxi s-server huwa pplaggjat ma 'swiċċ, flimkien ma' kemm apparat CM4 kemm jista 'jappoġġja s-swiċċ. Kwalunkwe CM4 imqabbad f'dan in-netwerk jiġi skopert mis-sistema ta' forniment u awtomatikament flashed bil-firmware meħtieġ tal-utent. Ir-raġuni biex ikollu n-netwerk bil-fili tagħha stess issir ċara meta tqis li kwalunkwe CM4 imdaħħla fin-netwerk se jiġi pprovdut, għalhekk iż-żamma tan-netwerk separat minn kwalunkwe netwerk ħaj hija essenzjali biex tevita r-riprogrammar mhux intenzjonat tal-apparati.

TIBDIL FIL-IMMAĠNI Bordijiet CM 4 IO b'CM 4 -> Bordijiet CM4 IO b'CM4

Billi tuża Raspberry Pi bħala s-server, huwa possibbli li tuża netwerking bil-fili għall-Provveditur iżda xorta tippermetti aċċess għal netwerks esterni bl-użu ta 'konnettività mingħajr fili. Dan jippermetti tniżżil faċli ta 'immaġini lis-server, lesti għall-proċess ta' forniment, u jippermetti li l-Raspberry Pi jaqdi lill-Provveditur. web interface. Immaġini multipli jistgħu jitniżżlu; il-Provveditur iżomm database ta 'immaġini u jagħmilha faċli li tagħżel l-immaġni xierqa għat-twaqqif ta' apparati differenti.
Meta CM4 ikun imwaħħal man-netwerk u jitħaddem se jipprova jibbutja, u ladarba jkunu ġew ippruvati għażliet oħra, jiġi ppruvat l-ibbutjar tan-netwerk. F'dan il-punt is-sistema tal-Provisioner Dynamic Host Configuration Protocol (DHCP) twieġeb għas-CM4 tal-ibbutjar u tipprovdiha b'immaġni bootable minima li titniżżel fis-CM4 imbagħad titħaddem bħala root. Din l-immaġini tista' tipprogramma l-Multi-Media Card (eMMC) inkorporata u tmexxi kwalunkwe skripts meħtieġa, kif inhu ordnat mill-Fornitur.

Aktar dettalji
Il-moduli CM4 jintbagħtu b'konfigurazzjoni tal-boot li se tipprova tibbutja mill-eMMC l-ewwel; jekk dan ifalli minħabba li l-eMMC huwa vojt, se jwettaq boot tan-netwerk tal-ambjent ta 'eżekuzzjoni preboot (PXE). Għalhekk, b'moduli CM4 li għadhom ma ġewx ipprovduti, u għandhom eMMC vojta, se titwettaq boot tan-netwerk b'mod awtomatiku. Waqt boot ta 'netwerk fuq netwerk ta' proviżjonament, immaġni ta 'sistema operattiva ta' utilità ħafifa (OS) (fil-fatt kernel Linux u scriptexecute initramfs) se tiġi moqdija mis-server ta 'proviżjoni lill-modulu CM4 fuq in-netwerk, u din l-immaġni tieħu ħsieb il-forniment.

CM 3 u CM 4s

L-apparati CM bbażati fuq il-konnettur SODIMM ma jistgħux jibnu netwerk, għalhekk l-ipprogrammar jinkiseb permezz tal-USB. Kull apparat jeħtieġ li jkun imqabbad mal-Provveditur. Jekk għandek bżonn tikkonnettja aktar minn 4 apparati (in-numru ta 'portijiet USB fuq il-Raspberry Pi), jista' jintuża hub USB. Uża kejbils USB-A għal Mikro-USB ta 'kwalità tajba, li tikkonnettja mill-Raspberry Pi jew hub mal-port slave USB ta' kull bord CMIO. Il-bordijiet CMIO kollha se jeħtieġu wkoll provvista ta 'enerġija, u l-J4 USB slave boot enable jumper għandu jkun issettjat biex jippermetti

IMPORTANTI
Tqabbadx il-port Ethernet tal-Pi 4. Il-konnessjoni bla fili tintuża biex taċċessa l-ġestjoni web interface.

Installazzjoni

L-istruzzjonijiet li ġejjin kienu korretti fil-ħin tal-ħruġ. L-aħħar struzzjonijiet ta' installazzjoni jistgħu jinstabu fuq il-paġna ta' Provisioner GitHub.

Installazzjoni tal-Provveditur web applikazzjoni fuq Raspberry Pi
TWISSIJA
Kun żgur li eth0 jgħaqqad ma 'swiċċ Ethernet li għandu biss il-Bordijiet CM4 IO konnessi. Tqabbadx eth0 man-netwerk tal-uffiċċju/pubbliku tiegħek, jew jista 'jipprovdi' apparati oħra tar-Raspberry Pi fin-netwerk tiegħek ukoll. Uża l-konnessjoni bla fili Raspberry Pi biex tikkonnettja man-netwerk lokali tiegħek.

Il-verżjoni Lite tal-Raspberry Pi OS hija rakkomandata bħala l-OS bażi li fuqha tinstalla l-Provveditur. Għal sempliċità uża rpi-imager, u attiva l-menu tas-settings avvanzati (Ctrl-Shift-X) biex twaqqaf il-password, l-hostname u s-settings mingħajr fili. Ladarba l-OS jiġi installat fuq il-Raspberry Pi, ikollok bżonn twaqqaf is-sistema Ethernet:

1. Ikkonfigura eth0 biex ikollu indirizz statiku tal-Protokoll tal-Internet (IP) ta' 172.20.0.1 ġewwa subnet /16 (netmask 255.255.0.0) billi teditja l-konfigurazzjoni DHCP:
   • sudo nano /etc/dhcpcd.conf
   • Żid mal-qiegħ tal- file:
     interface eth0
     static ip_address=172.20.0.1/16
   • Ibda mill-ġdid biex jippermetti li l-bidliet jidħlu fis-seħħ.
2. Kun żgur li l-installazzjoni tal-OS hija aġġornata:
   sudo apt update
   sudo apt aġġornament sħiħ
3. Il-Provveditur huwa fornut bħala .deb lest file fuq il-paġna tal-Provisioner GitHub. Niżżel l-aħħar verżjoni minn dik il-paġna jew uża wget, u installaha billi tuża l-kmand li ġej:
   sudo apt install ./cmprovision4_*_all.deb
4. Issettja l- web username u password tal-applikazzjoni:
   sudo /var/lib/cmprovision/artisan auth:create-user

Issa tista' taċċessa l- web interface tal-Fornitur ma' a web browser bl-użu tal-indirizz IP bla fili tar-Raspberry Pi u l-isem tal-utent u l-password imdaħħla fit-taqsima preċedenti. Daħħal l-indirizz IP fil-bar tal-indirizz tal-browser tiegħek u agħfas Enter.

Użu

Meta tikkonnettja l-ewwel mal-Provveditur web applikazzjoni ma tiegħek web browser se tara l-iskrin tad-Dashboard, li se tidher xi ħaġa bħal din:

Din il-paġna ta’ destinazzjoni sempliċement tagħti xi informazzjoni dwar l-aħħar azzjoni mwettqa mill-Provveditur (fl-eżample hawn fuq, ġie pprovdut CM4 wieħed).

Tlugħ ta' stampi

L-ewwel operazzjoni meħtieġa meta twaqqaf hija li tgħabbi l-immaġni tiegħek fis-server, minn fejn tista 'tintuża biex tipprovdi l-bordijiet CM4 tiegħek. Ikklikkja l-oġġett tal-menu 'Stampi' fin-naħa ta' fuq tal- web paġna u għandek tikseb skrin simili għal dak muri hawn taħt, li turi lista ta’ immaġini li ttellgħu bħalissa (li fil-bidu se jkunu vojta).

Agħżel il-buttuna Żid Immaġni biex ittella' immaġni; se tara dan l-iskrin:

L-immaġni jeħtieġ li tkun aċċessibbli fuq l-apparat fejn il- web browser qed jaħdem, u f'wieħed mill-formati tal-immaġni speċifikati. Agħżel l-immaġni mill-magna tiegħek billi tuża l-istandard file dialog, u kklikkja 'Upload'. Dan issa se jikkopja l-immaġni mill-magna tiegħek għas-server Provisioner li jaħdem fuq il-Raspberry Pi. Dan jista 'jieħu ftit taż-żmien. Ladarba l-immaġni tittella’, taraha fuq il-paġna Stampi.

Żieda ta 'proġett

Issa għandek bżonn toħloq proġett. Tista' tispeċifika kwalunkwe numru ta' proġetti, u kull wieħed jista' jkollu immaġni, sett ta' skripts jew tikketta differenti. Il-proġett attiv huwa dak li bħalissa jintuża għall-forniment.
Ikklikkja fuq l-oġġett tal-menu 'Proġetti' biex toħroġ il-paġna tal-Proġetti. L-eżample diġà għandha proġett wieħed, imsejjaħ 'Test project', stabbilit.

Issa ikklikkja fuq 'Żid proġett' biex twaqqaf proġett ġdid

• Agħti lill-proġett isem xieraq, imbagħad agħżel liema immaġni tixtieq li dan il-proġett juża mil-lista li tinżel. Tista 'wkoll tissettja numru ta' parametri oħra f'dan stage, iżda ħafna drabi l-immaġni biss tkun biżżejjed.
• Jekk qed tuża v1.5 jew aktar ġdida tal-Provveditur, imbagħad għandek l-għażla li tivverifika li t-teptep ikun tlesta b'mod korrett. L-għażla ta 'dan se taqra lura d-dejta mill-apparat CM wara li jteptep, u tikkonferma li taqbel mal-immaġni oriġinali. Dan iżid ħin żejjed għall-forniment ta 'kull apparat, l-ammont ta' ħin miżjud jiddependi fuq id-daqs tal-immaġni.
• Jekk tagħżel il-firmware biex tinstalla (dan mhux obbligatorju), għandek ukoll il-kapaċità li tippersonalizza dak il-firmware b'xi entrati speċifiċi ta 'konfigurazzjoni li se jingħaqdu mal-binarju bootloader. L-għażliet disponibbli jistgħu jinstabu fuq il-Raspberry Pi websit.
• Ikklikkja 'Save' meta tkun iddefinit bis-sħiħ il-proġett il-ġdid tiegħek; int ser terġa' lura għall-paġna tal-Proġetti, u l-proġett il-ġdid jiġi elenkat. Innota li proġett wieħed biss jista 'jkun attiv fi kwalunkwe ħin, u tista' tagħżel minn din il-lista.

Skripts
Karatteristika tassew utli ta' Provisioner hija l-abbiltà li tmexxi skripts fuq l-immaġni, qabel jew wara l-installazzjoni. Tliet skripts huma installati awtomatikament fil-Provveditur, u jistgħu jintgħażlu meta jinħoloq proġett ġdid. Huma elenkati fuq l-Scriptspage

EżampL-użu ta' skripts jista' jkun li żżid entrati personalizzati f'config.txt. L-iskritt standard Żid dtoverlay=dwc2 ma' config.txt jagħmel dan, billi juża l-kodiċi tal-qoxra li ġej:

Ikklikkja fuq 'Żid skript' biex iżżid il-personalizzazzjonijiet tiegħek:

Tikketti
Il-Fornitur għandu l-faċilità li jistampa t-tikketti għall-apparat li qed jiġi pprovdut. Il-paġna Tikketti turi t-tikketti kollha predefiniti li jistgħu jintgħażlu matul il-proċess tal-editjar tal-proġett. Per example, inti tista 'tixtieq li jistampa DataMatrix jew kodiċi ta' rispons rapidu (QR) għal kull bord ipprovdut, u din il-karatteristika tagħmel dan faċli ħafna.

Ikklikkja fuq 'Żid tikketta' biex tispeċifika tiegħek:

Firmware

Il-Provveditur jipprovdi l-abbiltà li jispeċifika liema verżjoni tal-firmware tal-bootloader tixtieq tinstalla fuq is-CM4. Fuq il-paġna tal-Firmware hemm lista tal-għażliet kollha possibbli, iżda l-aktar waħda reċenti ġeneralment tkun l-aħjar.Biex taġġorna l-lista bl-aħħar verżjonijiet tal-bootloader, ikklikkja fuq il-buttuna 'Niżżel firmware ġdid minn github'.

Problemi possibbli

Firmware tal-bootloader skadut
Jekk is-CM4 tiegħek ma jiġix skopert mis-sistema Provisioner meta jiġi pplaggjat, huwa possibbli li l-firmware tal-bootloader ikun skadut. Innota li l-apparati CM4 kollha manifatturati minn Frar 2021 għandhom il-bootloader korrett installat fil-fabbrika, għalhekk dan iseħħ biss b'apparat li kien manifatturat qabel dik id-data.

Diġà pprogrammat eMMC
Jekk il-modulu CM4 diġà għandu boot files fl-eMMC minn tentattiv ta 'proviżjon preċedenti allura se boot mill-eMMC u l-boot tan-netwerk meħtieġ għall-forniment ma jseħħx.
Jekk tixtieq terġa' tipprovdi modulu CM4, ser ikollok bżonn:

• Waħħal kejbil USB bejn is-server tal-forniment u l-port mikro USB tal-Bord CM4 IO (immarkat 'USB slave').
• Poġġi jumper fuq il-Bord CM4 IO (J2, 'Fit jumper to disable eMMC boot').

Dan jikkawża li l-modulu CM4 iwettaq boot USB, f'liema każ is-server tal-forniment se jittrasferixxi l- files tal-utilità OS fuq USB.
Wara li l-OS ta 'utilità jkun ibbutjat, se jikkuntattja lis-server tal-forniment fuq Ethernet biex jirċievi aktar struzzjonijiet, u tniżżel addizzjonali files (eż. l-immaġni tal-OS li għandha tinkiteb lill-eMMC) bħas-soltu. Għalhekk, konnessjoni Ethernet minbarra l-kejbil USB għadha meħtieġa.

Spanning Tree Protocol (STP) fuq swiċċijiet Ethernet ġestiti
L-ibbutjar tal-PXE mhux se jaħdem b'mod korrett jekk STP ikun attivat fuq swiċċ Ethernet ġestit. Dan jista 'jkun il-default fuq xi swiċċijiet (eż. Cisco), u jekk dan ikun il-każ ikun jeħtieġ li jiġi diżattivat biex il-proċess ta' forniment jaħdem b'mod korrett.
Raspberry Pi hija trademark tal-Raspberry Pi Foundation
Raspberry Pi Ltd

Dokumenti / Riżorsi

Raspberry Pi Provisioning tal-Raspberry Pi Compute Module [pdfGwida għall-Utent Provisioning tal-Raspberry Pi Compute Module, Provisioning, il-Raspberry Pi Compute Module, Compute Module

Referenzi

• Manwal għall-Utent