Voorsiening van die Raspberry Pi Compute Module
Voorsiening van die Raspberry Pi Compute Module (weergawes 3 en 4)
Raspberry Pi Bpk
2022-07-19: githash: 94a2802-clean
Kolofon
© 2020-2022 Raspberry Pi Ltd (voorheen Raspberry Pi (Trading) Ltd.)
Hierdie dokumentasie is gelisensieer onder 'n Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). bou-datum: 2022-07-19 bou-weergawe: githash: 94a2802-skoon
Wetlike vrywaringskennisgewing
TEGNIESE EN BETROUBAARHEIDSDATA VIR RASPBERRY PI-PRODUKTE (INSLUITEND DATABLADE) SOOS VAN TYD TOT TYD GEWYSIG ("HULPBRONNE") WORD VERSKAF DEUR RASPBERRY PI BPK ("RPL") "SOOS IS" EN ENIGE UITDRUKKELIJKE OF INGESULDE, INGESULDE, INGESLUIT, NIE geïmpliseer nie. TOT, WORD DIE GEÏSPLISEERDE WAARBORGE VAN VERHANDELBAARHEID EN GESKIKTHEID VIR 'N SPESIFIEKE DOEL AFGEWYS. SAL RPL IN GEEN GEVAL AANSPREEKLIK WEES VIR ENIGE DIREKTE, INDIREKTE, TOEVALLE, SPESIALE, VOORBEELDE OF GEVOLLIKE SKADE (INSLUITEND, MAAR NIE BEPERK TOT, VERKRYWERS VAN GOEDE, VERKRYWER) IN DIE MAKSIMUM MAAT WAT DEUR TOEPASSELIJKE WET TOEGESTAAN WORD NIE; , DATA , Of winste; of onderbreking van sakeonderbrekings) egter veroorsaak en op enige teorie van aanspreeklikheid, hetsy in kontrak, streng aanspreeklikheid, of skadelike (insluitend nalatigheid of andersins) wat voortspruit uit die gebruik van die hulpbronne, selfs al is dit van die moontlikheid in kennis gestel. VAN SULKE SKADE.
RPL behou die reg voor om enige verbeterings, verbeterings, regstellings of enige ander wysigings aan die HULPBRONNE of enige produkte wat daarin beskryf word, te eniger tyd en sonder verdere kennisgewing aan te bring. Die HULPBRONNE is bedoel vir geskoolde gebruikers met geskikte vlakke van ontwerpkennis. Gebruikers is alleen verantwoordelik vir hul keuse en gebruik van die HULPBRONNE en enige toepassing van die produkte wat daarin beskryf word. Gebruiker stem in om RPL te vrywaar en skadeloos te hou teen alle aanspreeklikhede, koste, skade of ander verliese wat voortspruit uit hul gebruik van die HULPBRONNE. RPL gee gebruikers toestemming om die HULPBRONNE uitsluitlik in samewerking met die Raspberry Pi-produkte te gebruik. Alle ander gebruik van die HULPBRONNE is verbode. Geen lisensie word aan enige ander EVL of ander derdeparty intellektuele eiendomsreg toegestaan nie. HOË RISIKO AKTIWITEITE. Raspberry Pi-produkte is nie ontwerp, vervaardig of bedoel vir gebruik in gevaarlike omgewings wat faalveilige werkverrigting vereis nie, soos in die bedryf van kernfasiliteite, vliegtuignavigasie- of kommunikasiestelsels, lugverkeerbeheer, wapenstelsels of veiligheidskritieke toepassings (insluitend lewensondersteuning) stelsels en ander mediese toestelle), waarin die mislukking van die produkte direk tot die dood, persoonlike besering of ernstige fisiese of omgewingskade kan lei (“Hoërisiko-aktiwiteite”). RPL ontken spesifiek enige uitdruklike of geïmpliseerde waarborg van geskiktheid vir hoërisiko-aktiwiteite en aanvaar geen aanspreeklikheid vir die gebruik of insluiting van Raspberry Pi-produkte in hoërisiko-aktiwiteite nie. Raspberry Pi-produkte word verskaf onderhewig aan RPL se Standaardbepalings. RPL se voorsiening van die HULPBRONNE brei nie RPL se Standaardbepalings uit of wysig andersins nie, insluitend maar nie beperk tot die vrywarings en waarborge wat daarin uitgedruk word nie.
Dokument weergawe geskiedenis 
Omvang van dokument
Hierdie dokument is van toepassing op die volgende Raspberry Pi-produkte:
Inleiding
Die CM Voorsiener is a web toepassing wat ontwerp is om programmering van 'n groot aantal Raspberry Pi Compute Module (CM) toestelle baie makliker en vinniger te maak. Dit is eenvoudig om te installeer en maklik om te gebruik. Dit bied 'n koppelvlak na 'n databasis van kernbeelde wat opgelaai kan word, tesame met die vermoë om skrifte te gebruik om verskeie dele van die installasie aan te pas tydens die flitsproses. Etiketdruk en fermware-opdatering word ook ondersteun. Hierdie witskrif neem aan dat die Provisioner-bediener, sagteware weergawe 1.5 of nuwer, op 'n Raspberry Pi loop.
Hoe dit alles werk
CM4
Die Voorsiener-stelsel moet op sy eie bedrade netwerk geïnstalleer word; die Raspberry Pi wat die bediener bestuur, is by 'n skakelaar ingeprop, saam met soveel CM4-toestelle as wat die skakelaar kan ondersteun. Enige CM4 wat by hierdie netwerk ingeprop is, sal deur die voorsieningstelsel opgespoor word en outomaties met die gebruiker se vereiste firmware geflits word. Die rede vir sy eie bedrade netwerk word duidelik as jy in ag neem dat enige CM4 wat by die netwerk ingeprop is voorsien sal word, dus is dit noodsaaklik om die netwerk apart van enige lewendige netwerk te hou om die onbedoelde herprogrammering van toestelle te voorkom.
BEELDVERANDERINGS CM 4 IO-borde met CM 4 -> CM4 IO-borde met CM4
Deur 'n Raspberry Pi as die bediener te gebruik, is dit moontlik om bedrade netwerke vir die Voorsiener te gebruik, maar steeds toegang tot eksterne netwerke met draadlose konneksie toe te laat. Dit laat maklike aflaai van beelde na die bediener toe, gereed vir die voorsieningsproses, en laat die Raspberry Pi toe om die voorsiener te bedien web koppelvlak. Veelvuldige beelde kan afgelaai word; die Voorsiener hou 'n databasis van beelde en maak dit maklik om die toepaslike beeld vir die opstel van verskillende toestelle te kies.
Wanneer 'n CM4 aan die netwerk gekoppel is en aangeskakel word, sal dit probeer om te selflaai, en sodra ander opsies probeer is, word probeer om netwerk te begin. Op hierdie stadium reageer die Provisioner Dynamic Host Configuration Protocol (DHCP)-stelsel op die selflaai-CM4 en voorsien dit van 'n minimale selflaai-beeld wat na die CM4 afgelaai word en dan as wortel uitgevoer word. Hierdie prent kan die ingebedde Multi-Media Kaart (eMMC) programmeer en enige vereiste skrifte laat loop, soos deur die Voorsiener opdrag gegee.
Meer besonderhede
CM4-modules word gestuur met 'n selflaaikonfigurasie wat eers van eMMC sal probeer selflaai; as dit misluk omdat die eMMC leeg is, sal dit 'n vooraflaai-uitvoeromgewing (PXE)-netwerklaai uitvoer. Dus, met CM4-modules wat nog nie voorsien is nie, en 'n leë eMMC het, sal 'n netwerklaai by verstek uitgevoer word. Tydens 'n netwerklaai op 'n voorsieningsnetwerk, sal 'n ligte nutsbedryfstelsel (OS)-beeld (eintlik 'n Linux-kern en 'n scriptexecute initramfs) deur die voorsieningsbediener na die CM4-module oor die netwerk bedien word, en hierdie prent hanteer die voorsiening.
CM 3 en CM 4s
Die CM-toestelle gebaseer op die SODIMM-aansluiting kan nie netwerk selflaai nie, so programmering word oor USB verkry. Elke toestel sal aan die Voorsiener gekoppel moet word. As jy meer as 4 toestelle moet koppel (die aantal USB-poorte op die Raspberry Pi), kan 'n USB-hub gebruik word. Gebruik USB-A-na-mikro-USB-kabels van goeie gehalte, verbind vanaf die Raspberry Pi of hub aan die USB-slaafpoort van elke CMIO-bord. Al die CMIO-borde sal ook 'n kragtoevoer nodig hê, en die J4 USB-slaaflaai-enable-jumper moet gestel word om te aktiveer
BELANGRIK
MOENIE die Ethernet-poort van die Pi 4 koppel nie. Die draadlose verbinding word gebruik om toegang tot die bestuur te verkry web koppelvlak.
Installasie
Die volgende instruksies was korrek ten tyde van uitreiking. Die heel nuutste installasie-instruksies kan op die Provisioner GitHub-bladsy gevind word.
Installeer die Voorsiener web toepassing op 'n Raspberry Pi
WAARSKUWING
Maak seker dat eth0 aan 'n Ethernet-skakelaar koppel wat net die CM4 IO-borde verbind het. Moenie eth0 aan jou kantoor/openbare netwerk koppel nie, of dit kan ook ander Raspberry Pi-toestelle in jou netwerk 'voorsien'. Gebruik die Raspberry Pi draadlose verbinding om aan jou plaaslike netwerk te koppel.
Die Lite-weergawe van die Raspberry Pi OS word aanbeveel as die basis-bedryfstelsel waarop die Provisioner geïnstalleer moet word. Vir eenvoud gebruik rpi-imager, en aktiveer die gevorderde instellings-kieslys (Ctrl-Shift-X) om die wagwoord, gasheernaam en draadlose instellings op te stel. Sodra die bedryfstelsel op die Raspberry Pi geïnstalleer is, sal jy die Ethernet-stelsel moet opstel:
- Stel eth0 op om 'n statiese internetprotokol (IP) adres van 172.20.0.1 binne 'n /16 subnet (netmasker 255.255.0.0) te hê deur die DHCP-konfigurasie te wysig:
- sudo nano /etc/dhcpcd.conf
- Voeg by die onderkant van die file:
koppelvlak eth0
statiese ip_adres=172.20.0.1/16 - Herlaai om die veranderinge in werking te laat tree.
- Maak seker dat die OS-installasie op datum is:
sudo apt-opdatering
sudo apt volle opgradering - Die Voorsiener word verskaf as 'n klaargemaakte .deb file op die Provisioner GitHub-bladsy. Laai die nuutste weergawe van daardie bladsy af of gebruik wget, en installeer dit met die volgende opdrag:
sudo apt installeer ./cmprovision4_*_all.deb - Stel die web toepassing gebruikersnaam en wagwoord:
sudo /var/lib/cmprovision/artisan auth:create-user
Jy kan nou toegang tot die web koppelvlak van die Voorsiener met 'n web blaaier met behulp van die Raspberry Pi draadlose IP-adres en die gebruikersnaam en wagwoord wat in die vorige afdeling ingevoer is. Voer net die IP-adres in die adresbalk van jou blaaier in en druk Enter.
Gebruik
Wanneer jy die eerste keer aan die Voorsiener koppel web aansoek met jou web blaaier sal jy die Dashboard-skerm sien, wat iets soos hierdie sal lyk:
Hierdie bestemmingsbladsy gee bloot inligting oor die jongste aksie wat deur die Voorsiener uitgevoer is (in die example hierbo, 'n enkele CM4 is voorsien).
Laai beelde op
Die eerste bewerking wat nodig is tydens die opstel, is om jou beeld na die bediener te laai, vanwaar dit gebruik kan word om jou CM4-borde te voorsien. Klik op die 'Beeld'-kieslys-item boaan die web bladsy en jy behoort 'n skerm te kry soortgelyk aan die een wat hieronder getoon word, met 'n lys van tans opgelaaide beelde (wat aanvanklik leeg sal wees).
Kies die Voeg prent by-knoppie om 'n prent op te laai; jy sal hierdie skerm sien:
Die prent moet toeganklik wees op die toestel waar die web blaaier loop, en in een van die gespesifiseerde beeldformate. Kies die beeld van jou masjien deur die standaard te gebruik file dialoog en klik op 'Laai op'. Dit sal nou die prent vanaf jou masjien na die Provisioner-bediener wat op die Raspberry Pi loop, kopieer. Dit kan 'n rukkie neem. Sodra die prent opgelaai is, sal jy dit op die Prente-bladsy sien.
Voeg 'n projek by
Nou moet jy 'n projek skep. Jy kan enige aantal projekte spesifiseer, en elkeen kan 'n ander prent, stel skrifte of etiket hê. Die aktiewe projek is die een wat tans vir voorsiening gebruik word.
Klik op die 'Projekte'-kieslys-item om die Projekte-bladsy na vore te bring. Die volgende example het reeds een projek, genaamd 'Toetsprojek', opgestel.
Klik nou op 'Voeg projek by' om 'n nuwe projek op te stel
- Gee die projek 'n gepaste naam en kies dan watter prent jy wil hê hierdie projek moet gebruik uit die aftreklys. Jy kan ook 'n aantal ander parameters by hierdie s steltage, maar dikwels sal slegs die beeld voldoende wees.
- As jy v1.5 of nuwer van die Voorsiener gebruik, dan het jy die opsie om te verifieer dat die flikkering korrek voltooi is. As u dit kies, sal die data van die CM-toestel teruglees nadat dit geflits het, en bevestig dat dit by die oorspronklike prent pas. Dit sal ekstra tyd by die voorsiening van elke toestel voeg, die hoeveelheid tyd wat bygevoeg word, sal afhang van die grootte van die prent.
- As jy die firmware kies om te installeer (dit is opsioneel), het jy ook die vermoë om daardie firmware aan te pas met 'n paar spesifieke konfigurasie-inskrywings wat in die selflaailaaier-binêre saamgevoeg sal word. Die beskikbare opsies kan op die Raspberry Pi gevind word webwebwerf.
- Klik 'Stoor' wanneer jy jou nuwe projek volledig gedefinieer het; jy sal terugkeer na die Projekte-bladsy, en die nuwe projek sal gelys word. Let daarop dat slegs een projek op enige tyd aktief kan wees, en jy kan dit uit hierdie lys kies.
Skripte
'n Baie nuttige kenmerk van Provisioner is die vermoë om skrifte op die prent uit te voer, voor of na installasie. Drie skrifte word by verstek in die Voorsiener geïnstalleer, en kan gekies word wanneer 'n nuwe projek geskep word. Hulle word op die Scripts-bladsy gelys
'N ExampDie gebruik van skrifte kan wees om persoonlike inskrywings by config.txt te voeg. Die standaard script Voeg dtoverlay=dwc2 by config.txt doen dit deur die volgende dopkode te gebruik:
Klik op 'Voeg script by' om jou eie aanpassings by te voeg:
Etikette
Die Voorsiener het die fasiliteit om etikette uit te druk vir die toestel wat voorsien word. Die Etikette-bladsy wys al die vooraf gedefinieerde etikette wat tydens die projekredigeringsproses gekies kan word. Byvoorbeeldample, wil jy dalk DataMatrix of vinnige reaksie (QR) kodes uitdruk vir elke bord wat voorsien word, en hierdie kenmerk maak dit baie maklik.
Klik op 'Voeg etiket by' om jou eie te spesifiseer: 
Firmware
Die Voorsiener bied die vermoë om te spesifiseer watter weergawe van die selflaaiprogram-firmware jy op die CM4 wil installeer. Op die Firmware-bladsy is daar 'n lys van al die moontlike opsies, maar die mees onlangse een is gewoonlik die beste.
Om die lys op te dateer met die nuutste weergawes van die selflaaiprogram, klik op die 'Laai nuwe firmware van github af'-knoppie.
Moontlike probleme
Verouderde selflaaiprogram-firmware
As jou CM4 nie deur die Provisioner-stelsel bespeur word wanneer dit ingeprop is nie, is dit moontlik dat die selflaaiprogram-firmware verouderd is. Let daarop dat alle CM4-toestelle wat sedert Februarie 2021 vervaardig is, die korrekte selflaailaaier by die fabriek geïnstalleer het, so dit sal slegs gebeur met toestelle wat voor daardie datum vervaardig is.
Reeds geprogrammeer eMMC
As die CM4-module reeds selflaai het files in die eMMC van 'n vorige voorsieningspoging, sal dit vanaf die eMMC begin en die netwerkselflaai wat vir voorsiening vereis word, sal nie plaasvind nie.
As jy wel 'n CM4-module wil herversorg, sal jy moet:
- Heg 'n USB-kabel aan tussen die voorsieningsbediener en die mikro-USB-poort van die CM4 IO-bord (gemerk 'USB-slaaf').
- Plaas 'n jumper op die CM4 IO-bord (J2, 'Pas jumper aan om eMMC-selflaai te deaktiveer').
Dit sal veroorsaak dat die CM4-module 'n USB-selflaai uitvoer, in welke geval die voorsieningsbediener die files van die nut OS oor USB.
Nadat die nutsbedryfstelsel begin het, sal dit die voorsieningsbediener oor Ethernet kontak om verdere instruksies te ontvang, en bykomende aflaai files (bv. die OS-beeld wat na eMMC geskryf moet word) soos gewoonlik. Dus, 'n Ethernet-verbinding bykomend tot die USB-kabel is steeds nodig.
Spanning Tree Protocol (STP) op bestuurde Ethernet-skakelaars
PXE-selflaai sal nie korrek werk as STP op 'n bestuurde Ethernet-skakelaar geaktiveer is nie. Dit kan die verstek op sommige skakelaars wees (bv. Cisco), en as dit die geval is, sal dit gedeaktiveer moet word vir die voorsieningsproses om korrek te werk.
Raspberry Pi is 'n handelsmerk van die Raspberry Pi Foundation
Raspberry Pi Bpk
Dokumente / Hulpbronne
 |
Raspberry Pi Voorsiening van die Raspberry Pi Compute Module [pdf] Gebruikersgids Voorsiening van die Raspberry Pi Compute Module, Voorsiening, die Raspberry Pi Compute Module, Compute Module |