Foarsjen fan de Raspberry Pi Compute Module
De Raspberry Pi Compute Module leverje (ferzjes 3 en 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Kolofon
© 2020-2022 Raspberry Pi Ltd (earder Raspberry Pi (Trading) Ltd.)
Dizze dokumintaasje is lisinsje ûnder in Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). build-datum: 2022-07-19 build-ferzje: githash: 94a2802-skjin
Juridyske disclaimer notice
TECHNISCHE EN BETROUWBAARHEIDSGEGEVENS FOAR RASPBERRY PI-PRODUKTEN (YNKLUDEREGE DATABLAD) SOOS TIJD TOT TIID WYzige ("BRONNEN") WORDE FERGESE FAN RASPBERRY PI LTD ("RPL") "AS IS" EN ELKE EXPRESS OF IMPLICEERD, NET YNLEFT TO, DE YMPLIZE GARANTIES FAN VERHANDELBAARHEID EN GESIGHEID FOAR IN BEPAAL DOEL WORDEN DISCLAIMED. TOT DE Maksimum MATE TASTE TAAST FAN TAPAASJE WET YN GEEN GEVAL SILT RPL YN FERGESE AANSPRAKELIJK WEES FOAR ELKE DIREKTE, INDIREKTE, INSIDENTELE, SPESIALE, EXEMPLARY OF GEVOLGLIKE SKADES (YNKLUDEREF, MAAR NET BEPERKTE TOT GOEDE FAN FERGESE SERVICE; , DATA , As winsten; as saaklike ûnderbrekking) lykwols feroarsake en op elke teory fan oanspraaklikens, of strangte oanspraaklikheid, of oars as oars) ûntstean op ien of oare manier út it gebrûk fan 'e boarnen, sels as mooglikheid FAN sokke skea.
RPL behâldt it rjocht foar om op elk momint en sûnder fierdere notice alle ferbetterings, ferbetteringen, korreksjes of oare wizigingen oan te meitsjen oan 'e RESOURCES of alle produkten dy't dêryn beskreaun binne. De RESOURCES binne bedoeld foar betûfte brûkers mei passende nivo's fan ûntwerpkennis. Brûkers binne allinich ferantwurdlik foar har seleksje en gebrûk fan 'e RESOURCES en elke tapassing fan' e produkten beskreaun yn har. Brûker stimt yn om RPL te fergoedzjen en harmless te hâlden tsjin alle ferplichtingen, kosten, skea of oare ferliezen dy't fuortkomme út har gebrûk fan 'e RESOURCES. RPL jout brûkers tastimming om de RESOURCES allinich te brûken yn kombinaasje mei de Raspberry Pi-produkten. Alle oare gebrûk fan de RESOURCES is ferbean. Gjin lisinsje wurdt ferliend oan in oar RPL of oare yntellektuele eigendomsrjochten fan tredden. HIGH RISK AKTIVITEITEN. Raspberry Pi-produkten binne net ûntworpen, produsearre of bedoeld foar gebrûk yn gefaarlike omjouwings dy't mislearre prestaasjes fereaskje, lykas yn 'e eksploitaasje fan kearnfoarsjennings, fleantúchnavigaasje of kommunikaasjesystemen, loftferkearskontrôle, wapensystemen of feiligenskrityske applikaasjes (ynklusyf libbensstipe). systemen en oare medyske apparaten), wêryn it mislearjen fan 'e produkten direkt kin liede ta dea, persoanlik ferwûning of slimme fysike of miljeuskea ("High Risk Activities"). RPL ûntkent spesifyk elke útdruklike of ymplisearre garânsje fan fitness foar aktiviteiten mei hege risiko en akseptearret gjin oanspraaklikens foar gebrûk of ynklúzjes fan Raspberry Pi-produkten yn aktiviteiten mei hege risiko. Raspberry Pi-produkten wurde levere ûnder foarbehâld fan de standertbetingsten fan RPL. RPL's foarsjenning fan 'e RESOURCES wreidet de Standertbetingsten fan RPL net út of feroaret net op oare wize, ynklusyf mar net beheind ta de disclaimers en garânsjes dy't dêryn útdrukt binne.
Dokumint ferzje skiednis 
Omfang fan document
Dit dokumint jildt foar de folgjende Raspberry Pi-produkten:
Ynlieding
De CM Provider is a web applikaasje ûntworpen om it programmearjen fan in grut oantal Raspberry Pi Compute Module (CM) apparaten folle makliker en flugger te meitsjen. It is ienfâldich te ynstallearjen en ienfâldich te brûken. It biedt in ynterface foar in database mei kernelôfbyldings dy't kinne wurde uploade, tegearre mei de mooglikheid om skripts te brûken om ferskate dielen fan 'e ynstallaasje oan te passen tidens it flitsende proses. Label printsjen en firmware bywurkjen wurdt ek stipe. Dit whitepaper giet derfan út dat de Provisioner-tsjinner, softwareferzje 1.5 of nijer, rint op in Raspberry Pi.
Hoe't it allegear wurket
CM4
It Provisioner-systeem moat ynstalleare wurde op syn eigen bedrade netwurk; de Raspberry Pi dy't de tsjinner draait, is ynsteld op in switch, tegearre mei safolle CM4-apparaten as de switch kin stypje. Elke CM4 ynstútsenComment yn dit netwurk sil wurde ûntdutsen troch it foarsjenning systeem en automatysk flashed mei de brûker syn fereaske firmware. De reden foar it hawwen fan in eigen bedrade netwurk wurdt dúdlik as jo betinke dat elke CM4 dy't yn it netwurk is ynstutsen wurdt foarsjoen, dus it hâlden fan it netwurk apart fan elk live netwurk is essensjeel om de ûnbedoelde werprogrammearring fan apparaten te foarkommen.
Ofbyldingsferoarings CM 4 IO boards mei CM 4 -> CM4 IO Boards mei CM4
Troch in Raspberry Pi as tsjinner te brûken, is it mooglik om bedrade netwurken te brûken foar de Provisioner, mar dochs tagong ta eksterne netwurken mei draadloze ferbining. Dit makket it maklik te downloaden fan ôfbyldings nei de server, klear foar it foarsjenningsproses, en lit de Raspberry Pi de Provisioner tsjinje web ynterface. Meardere ôfbyldings kinne wurde ynladen; de Provisioner hâldt in databank fan ôfbyldings en makket it maklik om de passende ôfbylding te selektearjen foar it ynstellen fan ferskate apparaten.
As in CM4 is hechte oan it netwurk en wurdt oandreaun, sil it besykje te booten, en ienris oare opsjes binne besocht, wurdt it netwurk opstarten besocht. Op dit punt reagearret it Provisioner Dynamic Host Configuration Protocol (DHCP) systeem op 'e bootende CM4 en leveret it mei in minimale bootbere ôfbylding dy't wurdt ynladen nei de CM4 en dan as root útfiere. Dizze ôfbylding kin de ynbêde Multi-Media Card (eMMC) programmearje en alle fereaske skripts útfiere, lykas ynstruearre troch de Provider.
Mear details
CM4 modules skip mei in boot konfiguraasje dy't sil besykje te boot út eMMC earst; as dat mislearret omdat de eMMC is leech, it sil útfiere in preboot útfiering omjouwing (PXE) netwurk boot. Dat, mei CM4-modules dy't noch net foarsjoen binne, en in lege eMMC hawwe, sil standert in netwurkboot wurde útfierd. Tidens in netwurkboot op in foarsjenningsnetwurk sil in lichtgewicht nutsbedriuwsysteem (OS)-ôfbylding (eigentlik in Linux-kernel en in scriptexecute initramfs) wurde betsjinne troch de foarsjenningstsjinner nei de CM4-module oer it netwurk, en dizze ôfbylding behannelet de foarsjenning.
CM 3 en CM 4s
De CM-apparaten basearre op 'e SODIMM-ferbining kinne net opstarte troch it netwurk, dus programmearring wurdt berikt fia USB. Elk apparaat sil ferbûn wêze moatte mei de Provider. As jo mear dan 4 apparaten moatte ferbine (it oantal USB-poarten op 'e Raspberry Pi), kin in USB-hub brûkt wurde. Brûk USB-A nei Micro-USB-kabels fan goede kwaliteit, ferbine fan 'e Raspberry Pi as hub nei de USB-slavehaven fan elk CMIO-boerd. Alle CMIO-boerden sille ek in stroomfoarsjenning nedich wêze, en de J4 USB-slave-boot-ynskeakele jumper moat ynsteld wurde om yn te skeakeljen
BELANGRYK
Net ferbine de Ethernet haven fan de Pi 4. De draadloze ferbining wurdt brûkt om tagong ta it behear web ynterface.
Ynstallaasje
De folgjende ynstruksjes wiene korrekt op it momint fan útjefte. De heul lêste ynstallaasjeynstruksjes kinne fûn wurde op 'e Provisioner GitHub side.
It ynstallearjen fan de Provider web applikaasje op in Raspberry Pi
WARSKÔGING
Soargje derfoar dat eth0 ferbynt mei in Ethernet switch dat allinnich hat de CM4 IO Boards ferbûn. Ferbine eth0 net mei jo kantoar/iepenbier netwurk, of it kin ek oare Raspberry Pi-apparaten yn jo netwurk 'foarsjen'. Brûk de Raspberry Pi draadloze ferbining om te ferbinen mei jo lokale netwurk.
De Lite-ferzje fan it Raspberry Pi OS wurdt oanrikkemandearre as it basis-OS wêrop jo de Provisioner kinne ynstallearje. Foar ienfâld brûke rpi-imager, en aktivearje it avansearre ynstellingsmenu (Ctrl-Shift-X) om it wachtwurd, hostnamme en draadloze ynstellings yn te stellen. Sadree't it OS is ynstalleare op 'e Raspberry Pi, moatte jo it Ethernet-systeem ynstelle:
- Konfigurearje eth0 om in statysk ynternetprotokol (IP) adres te hawwen fan 172.20.0.1 binnen in /16 subnet (netmaske 255.255.0.0) troch de DHCP-konfiguraasje te bewurkjen:
- sudo nano /etc/dhcpcd.conf
- Taheakje oan 'e boaiem fan' e file:
ynterface eth0
statysk ip_adres=172.20.0.1/16 - Reboot om de wizigingen effekt te meitsjen.
- Soargje derfoar dat de OS-ynstallaasje bywurke is:
sudo apt update
sudo apt folsleine upgrade - De Provisioner wurdt levere as in klearmakke .deb file op 'e Provisioner GitHub side. Download de lêste ferzje fan dy side of brûk wget, en ynstallearje it mei it folgjende kommando:
sudo apt ynstallearje ./cmprovision4_*_all.deb - Stel de web applikaasje brûkersnamme en wachtwurd:
sudo /var/lib/cmprovision/artisan auth:create-user
Jo kinne no tagong krije ta de web ynterface fan de Provider mei in web browser mei it Raspberry Pi draadloze IP-adres en de brûkersnamme en wachtwurd ynfierd yn 'e foarige seksje. Fier gewoan it IP-adres yn yn 'e adresbalke fan jo browser en druk op Enter.
Gebrûk
As jo earst ferbine mei de Provider web applikaasje mei dyn web browser sil jo it Dashboard-skerm sjen, dat der sa útsjen sil:
Dizze lâningsside jout gewoan wat ynformaasje oer de lêste aksje útfierd troch de Provider (yn it eksamphjirboppe, ien CM4 is foarsjoen).
It opladen fan ôfbyldings
De earste operaasje dy't nedich is by it ynstellen is om jo ôfbylding nei de tsjinner te laden, wêrfan it kin wurde brûkt om jo CM4-boerden te leverjen. Klikje op it menu-item 'Ofbyldings' oan 'e boppekant fan' e web side en jo moatte in skerm krije lykas it hjirûnder werjûn, mei in list mei op it stuit uploadde ôfbyldings (dy't yn earste ynstânsje leech sil wêze).
Selektearje de knop Ofbylding tafoegje om in ôfbylding te uploaden; jo sille dit skerm sjen:
De ôfbylding moat tagonklik wêze op it apparaat dêr't de web browser rint, en yn ien fan de oantsjutte byldformaten. Selektearje de ôfbylding fan jo masine mei de standert file dialoochfinster en klikje op 'Upload'. Dit sil no de ôfbylding kopiearje fan jo masine nei de Provisioner-tsjinner dy't rint op 'e Raspberry Pi. Dit kin wat tiid duorje. Sadree't de ôfbylding is opladen, sille jo it sjen op 'e ôfbyldingsside.
It tafoegjen fan in projekt
No moatte jo in projekt oanmeitsje. Jo kinne elk oantal projekten opjaan, en elk kin in oare ôfbylding, set fan skripts of label hawwe. It aktive projekt is it projekt dat op it stuit brûkt wurdt foar foarsjenning.
Klikje op it menu-item 'Projekten' om de side Projekten te heljen. De folgjende eksample hat al ien projekt, neamd 'Testprojekt', opset.
Klikje no op 'Projekt taheakje' om in nij projekt yn te stellen
- Jou it projekt in passende namme, selektearje dan hokker ôfbylding jo wolle dat dit projekt moat brûke út it útklapmenu. Jo kinne ek ynstelle in oantal oare parameters op dizze stage, mar faak allinnich de ôfbylding sil foldwaan.
- As jo v1.5 of nijer brûke fan 'e Provisioner, dan hawwe jo de opsje om te kontrolearjen dat it wjerljocht goed is foltôge. Selektearje dit sil de gegevens fan it CM-apparaat weromlêze nei it flitsen, en befêstigje dat it oerienkomt mei de orizjinele ôfbylding. Dit sil ekstra tiid tafoegje oan it leverjen fan elk apparaat, de hoemannichte tiid tafoege sil ôfhingje fan 'e grutte fan' e ôfbylding.
- As jo de firmware selektearje om te ynstallearjen (dit is opsjoneel), hawwe jo ek de mooglikheid om dizze firmware oan te passen mei guon spesifike konfiguraasje-yngongen dy't sille wurde gearfoege yn 'e bootloader-binêre. De beskikbere opsjes kinne fûn wurde op 'e Raspberry Pi website.
- Klik op 'Bewarje' as jo jo nije projekt folslein definieare hawwe; jo komme werom nei de projekten side, en it nije projekt sil wurde fermeld. Tink derom dat mar ien projekt tagelyk aktyf wêze kin, en jo kinne it selektearje út dizze list.
Skripten
In echt nuttige funksje fan Provisioner is de mooglikheid om skripts op 'e ôfbylding út te fieren, foar of nei ynstallaasje. Trije skripts wurde standert ynstalleare yn 'e Provisioner, en kinne wurde selektearre by it meitsjen fan in nij projekt. Se wurde fermeld op de Scriptspage
In eksample gebrûk fan skripts kin wêze om oanpaste yngongen ta te foegjen oan config.txt. It standertskript Add dtoverlay=dwc2 oan config.txt docht dit, mei de folgjende shellkoade:
Klikje op 'Skript taheakje' om jo eigen oanpassingen ta te foegjen:
Labels
De Provider hat de mooglikheid om labels út te printsjen foar it apparaat dat wurdt levere. De side Labels toant alle foarôf definieare labels dy't kinne wurde selektearre tidens it projektbewurkingsproses. Bygelyksample, jo meie wolle printsjen út DataMatrix of fluch antwurd (QR) koades foar elk board foarsjoen, en dizze funksje makket dit hiel maklik.
Klikje op 'Label taheakje' om jo eigen op te jaan: 
Firmware
De Provisioner biedt de mooglikheid om oan te jaan hokker ferzje fan 'e bootloader-firmware jo wolle ynstallearje op' e CM4. Op 'e Firmware-side is d'r in list mei alle mooglike opsjes, mar de meast resinte is normaal de bêste.
Om de list te aktualisearjen mei de lêste ferzjes fan 'e bootloader, klikje jo op 'Download nije firmware fan github' knop.
Mooglike problemen
Ferâldere bootloader-firmware
As jo CM4 net ûntdutsen wurdt troch it Provisioner-systeem as it ynplukt is, is it mooglik dat de bootloader-firmware ferâldere is. Tink derom dat alle CM4-apparaten produsearre sûnt febrewaris 2021 de juste bootloader hawwe ynstalleare by it fabryk, dus dit sil allinich barre mei apparaten dy't foar dy datum binne produsearre.
Al programmearre eMMC
As de CM4-module al boot hat files yn 'e eMMC fan in eardere foarsjenningspoging dan sil it opstarte fan 'e eMMC en de netwurkboot dy't nedich is foar foarsjenning sil net foarkomme.
As jo in CM4-module opnij wolle provisearje, moatte jo:
- Befestigje in USB-kabel tusken de foarsjenningstsjinner en de mikro-USB-poarte fan it CM4 IO Board (markearre 'USB-slave').
- Set in jumper op 'e CM4 IO Board (J2, 'Fit jumper om eMMC-boot út te skeakeljen').
Dit sil de CM4-module in USB-boot útfiere, yn dat gefal sil de foarsjenningstsjinner de files fan it hulpprogramma OS oer USB.
Nei it opstarten fan it nutsbedriuw sil it kontakt opnimme mei de foarsjenningstsjinner oer Ethernet om fierdere ynstruksjes te ûntfangen en ekstra yn te laden files (bgl. de OS-ôfbylding dy't skreaun wurde nei eMMC) lykas gewoanlik. Dus, in Ethernet-ferbining neist de USB-kabel is noch altyd nedich.
Spanning Tree Protocol (STP) op managed Ethernet switches
PXE booting sil net wurkje goed as STP is ynskeakele op in beheard Ethernet switch. Dit kin de standert wêze op guon skeakels (bgl. Cisco), en as dat it gefal is, sil it moatte wurde útskeakele foar it foarsjenningsproses om goed te wurkjen.
Raspberry Pi is in hannelsmerk fan 'e Raspberry Pi Foundation
Raspberry Pi Ltd
Dokuminten / Resources
 |
Raspberry Pi Provisioning de Raspberry Pi Compute Module [pdf] Brûkersgids Provisioning de Raspberry Pi Compute Module, Provisioning, de Raspberry Pi Compute Module, Compute Module |