Klargjøring av Raspberry Pi Compute Module
Klargjøring av Raspberry Pi Compute Module (versjon 3 og 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Kolofon
© 2020-2022 Raspberry Pi Ltd (tidligere Raspberry Pi (Trading) Ltd.)
Denne dokumentasjonen er lisensiert under en Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). byggedato: 2022-07-19 byggeversjon: githash: 94a2802-clean
Juridisk ansvarsfraskrivelse
TEKNISKE DATA OG PÅLITELIGHETSDATA FOR RASPBERRY PI-PRODUKTER (INKLUDERT DATABLAD) SOM ENDRET FRA TIDEN TIL TIDEN (“RESURSER”) LEVERES AV RASPBERRY PI LTD (“RPL”) “SOM DE ER” OG EVENTUELLE UTTRYKKELIGE ELLER UNDERFORSTÅTTE, UNDERFORSTÅET TIL FRASVISES DE UNDERFORSTÅTE GARANTIER OM SALGBARHET OG EGNETHET FOR ET BESTEMT FORMÅL. I DEN MAKSIMALE UTREDNING SOM TILLATES AV GJELDENDE LOV, SKAL RPL IKKE UNDER OMSTENDIGHETER VÆRE ANSVARLIG FOR EVENTUELLE DIREKTE, INDIREKTE, TILFELDIGE, SPESIELLE, EKSEMPELISKE ELLER FØLGESKADER (INKLUDERT, MEN IKKE BEGRENSET TIL GOD, LEVERANDØR AV OSS LEVERANDØR; , DATA , Eller fortjeneste; eller forretningsavbrudd) imidlertid forårsaket og om enhver teori om ansvar, enten det er i kontrakt, strengt ansvar eller erstatning (inkludert uaktsomhet eller på annen måte) som oppstår på noen måte ut av bruken av ressursene, selv om det er anbefalt muligheten AV SLIK SKADE.
RPL forbeholder seg retten til å foreta eventuelle forbedringer, forbedringer, rettelser eller andre modifikasjoner av RESSURSENE eller produkter beskrevet i dem når som helst og uten ytterligere varsel. RESSURSENE er ment for dyktige brukere med passende nivåer av designkunnskap. Brukere er alene ansvarlige for deres valg og bruk av RESSURSENE og enhver bruk av produktene beskrevet i dem. Brukeren godtar å holde RPL skadesløs mot alle forpliktelser, kostnader, skader eller andre tap som oppstår som følge av deres bruk av RESSURSENE. RPL gir brukere tillatelse til å bruke RESSURSENE utelukkende i forbindelse med Raspberry Pi-produktene. All annen bruk av RESSURSENE er forbudt. Ingen lisens gis til noen annen RPL eller annen tredjeparts immaterielle rettigheter. AKTIVITETER MED HØY RISIKO. Raspberry Pi-produkter er ikke designet, produsert eller beregnet for bruk i farlige miljøer som krever feilsikker ytelse, for eksempel ved drift av kjernefysiske anlegg, flynavigasjons- eller kommunikasjonssystemer, lufttrafikkkontroll, våpensystemer eller sikkerhetskritiske applikasjoner (inkludert livsoppretting). systemer og annet medisinsk utstyr), der svikt i produktene kan føre direkte til død, personskade eller alvorlig fysisk skade eller miljøskade («Høyrisikoaktiviteter»). RPL fraskriver seg spesifikt enhver uttrykt eller underforstått garanti om egnethet for høyrisikoaktiviteter og påtar seg intet ansvar for bruk eller inkludering av Raspberry Pi-produkter i høyrisikoaktiviteter. Raspberry Pi-produkter leveres underlagt RPLs standardvilkår. RPLs levering av RESSURSENE utvider eller endrer ikke RPLs standardvilkår inkludert, men ikke begrenset til, ansvarsfraskrivelsene og garantiene som er uttrykt i dem.
Dokumentversjonshistorikk 
Omfang av document
Dette dokumentet gjelder for følgende Raspberry Pi-produkter:
Introduksjon
CM Provisioner er en web applikasjon utviklet for å gjøre programmering av et stort antall Raspberry Pi Compute Module (CM)-enheter mye enklere og raskere. Den er enkel å installere og enkel å bruke. Det gir et grensesnitt til en database med kjernebilder som kan lastes opp, sammen med muligheten til å bruke skript for å tilpasse ulike deler av installasjonen under blinkingsprosessen. Etikettutskrift og fastvareoppdatering støttes også. Denne hvitboken forutsetter at Provisioner-serveren, programvareversjon 1.5 eller nyere, kjører på en Raspberry Pi.
Hvordan det hele fungerer
CM4
Provisioner-systemet må installeres på sitt eget kablede nettverk; Raspberry Pi som kjører serveren er koblet til en svitsj, sammen med så mange CM4-enheter som svitsjen kan støtte. Enhver CM4 koblet til dette nettverket vil bli oppdaget av klargjøringssystemet og automatisk blinket med brukerens nødvendige fastvare. Årsaken til å ha sitt eget kablede nettverk blir tydelig når du tenker på at enhver CM4 som er koblet til nettverket vil bli klargjort, så det er viktig å holde nettverket atskilt fra ethvert live-nettverk for å forhindre utilsiktet omprogrammering av enheter.
BILDEENDRINGER CM 4 IO-kort med CM 4 -> CM4 IO-kort med CM4
Ved å bruke en Raspberry Pi som server, er det mulig å bruke kablet nettverk for Provisioner, men fortsatt tillate tilgang til eksterne nettverk ved hjelp av trådløs tilkobling. Dette gjør det enkelt å laste ned bilder til serveren, klar for klargjøringsprosessen, og lar Raspberry Pi betjene Provisioneren web grensesnitt. Flere bilder kan lastes ned; Provisioner holder en database med bilder og gjør det enkelt å velge riktig bilde for å sette opp forskjellige enheter.
Når en CM4 er koblet til nettverket og er slått på, vil den prøve å starte opp, og når andre alternativer er prøvd, forsøkes nettverksoppstart. På dette tidspunktet reagerer DHCP-systemet (Provisioner Dynamic Host Configuration Protocol) på den oppstartende CM4 og gir den et minimalt oppstartbart bilde som lastes ned til CM4 og kjøres som root. Dette bildet kan programmere det innebygde Multi-Media Card (eMMC) og kjøre alle nødvendige skript, som instruert av Provisjonsleverandøren.
Flere detaljer
CM4-moduler leveres med en oppstartskonfigurasjon som vil prøve å starte opp fra eMMC først; hvis det mislykkes fordi eMMC er tom, vil den utføre en PXE-nettverksoppstart (preboot execution environment). Så med CM4-moduler som ennå ikke er klargjort, og som har en tom eMMC, vil en nettverksoppstart utføres som standard. Under en nettverksoppstart på et klargjøringsnettverk, vil et lettvekts-operativsystem-bilde (faktisk en Linux-kjerne og en scriptexecute initramfs) bli servert av klargjøringsserveren til CM4-modulen over nettverket, og dette bildet håndterer klargjøringen.
CM 3 og CM 4s
CM-enhetene basert på SODIMM-kontakten kan ikke nettverksstarte, så programmering utføres over USB. Hver enhet må være koblet til Provisjonsleverandøren. Hvis du trenger å koble til mer enn 4 enheter (antall USB-porter på Raspberry Pi), kan en USB-hub brukes. Bruk USB-A til Micro-USB-kabler av god kvalitet, koble fra Raspberry Pi eller huben til USB-slaveporten på hvert CMIO-kort. Alle CMIO-kortene vil også trenge en strømforsyning, og J4 USB-slavestartkoblingen bør settes til å aktivere
VIKTIG
IKKE koble til Ethernet-porten på Pi 4. Den trådløse tilkoblingen brukes for å få tilgang til administrasjonen web grensesnitt.
Installasjon
Følgende instruksjoner var korrekte på utstedelsestidspunktet. De aller nyeste installasjonsinstruksjonene finner du på Provisioner GitHub-siden.
Installering av provisjonsprogrammet web applikasjon på en Raspberry Pi
ADVARSEL
Sørg for at eth0 kobles til en Ethernet-svitsj som bare har CM4 IO-kort tilkoblet. Ikke koble eth0 til kontoret/offentlige nettverket ditt, ellers kan det også "produsere" andre Raspberry Pi-enheter i nettverket ditt. Bruk den trådløse Raspberry Pi-tilkoblingen for å koble til ditt lokale nettverk.
Lite-versjonen av Raspberry Pi OS anbefales som basis OS for å installere Provisioner. For enkelhets skyld bruk rpi-imager, og aktiver menyen for avanserte innstillinger (Ctrl-Shift-X) for å sette opp passord, vertsnavn og trådløse innstillinger. Når operativsystemet er installert på Raspberry Pi, må du sette opp Ethernet-systemet:
- Konfigurer eth0 til å ha en statisk Internet Protocol (IP)-adresse på 172.20.0.1 i et /16-undernett (nettmaske 255.255.0.0) ved å redigere DHCP-konfigurasjonen:
- sudo nano /etc/dhcpcd.conf
- Legg til bunnen av file:
grensesnitt eth0
statisk ip_address=172.20.0.1/16 - Start på nytt for å la endringene tre i kraft.
- Sørg for at OS-installasjonen er oppdatert:
sudo apt oppdatering
sudo apt full oppgradering - Provisioner leveres som en ferdig .deb file på Provisioner GitHub-siden. Last ned den nyeste versjonen fra den siden eller bruk wget, og installer den ved å bruke følgende kommando:
sudo apt install ./cmprovision4_*_all.deb - Still inn web applikasjonens brukernavn og passord:
sudo /var/lib/cmprovision/artisan auth:create-user
Du kan nå få tilgang til web grensesnittet til Provisjonsleverandøren med en web nettleseren ved å bruke Raspberry Pi trådløs IP-adresse og brukernavnet og passordet som ble angitt i forrige seksjon. Bare skriv inn IP-adressen i adressefeltet til nettleseren din og trykk Enter.
Bruk
Når du først kobler til Provisjonsleverandøren web søknad med din web nettleseren vil du se Dashboard-skjermen, som vil se omtrent slik ut:
Denne landingssiden gir ganske enkelt litt informasjon om den siste handlingen utført av leverandøren (i eksample ovenfor, har en enkelt CM4 blitt klargjort).
Laster opp bilder
Den første operasjonen som kreves ved oppsett er å laste inn bildet til serveren, hvorfra det kan brukes til å klargjøre CM4-kortene dine. Klikk på "Bilder"-menyelementet øverst på web side, og du bør få en skjerm som ligner på den som vises nedenfor, som viser en liste over opplastede bilder (som i utgangspunktet vil være tom).
Velg Legg til bilde-knappen for å laste opp et bilde; du vil se denne skjermen:
Bildet må være tilgjengelig på enheten der web nettleseren kjører, og i et av de angitte bildeformatene. Velg bildet fra maskinen din ved å bruke standarden file dialogboksen og klikk "Last opp". Dette vil nå kopiere bildet fra maskinen din til Provisioner-serveren som kjører på Raspberry Pi. Dette kan ta litt tid. Når bildet er lastet opp, vil du se det på Bilder-siden.
Legger til et prosjekt
Nå må du lage et prosjekt. Du kan spesifisere et hvilket som helst antall prosjekter, og hvert kan ha et annet bilde, sett med skript eller etikett. Det aktive prosjektet er det som for øyeblikket brukes til klargjøring.
Klikk på menyelementet 'Prosjekter' for å få frem siden Prosjekter. Følgende eksample har allerede satt opp ett prosjekt, kalt "Testprosjekt".
Klikk nå på 'Legg til prosjekt' for å sette opp et nytt prosjekt
- Gi prosjektet et passende navn, og velg deretter hvilket bilde du vil at dette prosjektet skal bruke fra rullegardinlisten. Du kan også stille inn en rekke andre parametere på denne stage, men ofte er det bare bildet som er tilstrekkelig.
- Hvis du bruker v1.5 eller nyere av Provisioner, har du muligheten til å verifisere at blinkingen har fullført riktig. Hvis du velger dette, vil dataene fra CM-enheten leses tilbake etter blinking, og bekrefte at det samsvarer med originalbildet. Dette vil legge til ekstra tid til klargjøringen av hver enhet, hvor mye tid som legges til vil avhenge av størrelsen på bildet.
- Hvis du velger fastvaren som skal installeres (dette er valgfritt), har du også muligheten til å tilpasse den fastvaren med noen spesifikke konfigurasjonsoppføringer som vil bli slått sammen med oppstartslasterens binære. De tilgjengelige alternativene finner du på Raspberry Pi webnettstedet.
- Klikk "Lagre" når du har definert det nye prosjektet ditt; du kommer tilbake til Prosjekter-siden, og det nye prosjektet vil bli listet opp. Merk at kun ett prosjekt kan være aktivt om gangen, og du kan velge det fra denne listen.
Skript
En veldig nyttig funksjon i Provisioner er muligheten til å kjøre skript på bildet, før eller etter installasjon. Tre skript er installert som standard i Provisioner, og kan velges når du oppretter et nytt prosjekt. De er oppført på Scripts-siden
En eksampBruken av skript kan være å legge til egendefinerte oppføringer i config.txt. Standardskriptet Add dtoverlay=dwc2 til config.txt gjør dette ved å bruke følgende skallkode:
Klikk på "Legg til skript" for å legge til dine egne tilpasninger:
Etiketter
Provisjonsleverandøren har mulighet til å skrive ut etiketter for enheten som klargjøres. Etiketter-siden viser alle forhåndsdefinerte etiketter som kan velges under prosjektredigeringsprosessen. For eksample, kan det være lurt å skrive ut DataMatrix eller Quick Response (QR)-koder for hvert bord som er klargjort, og denne funksjonen gjør dette veldig enkelt.
Klikk på "Legg til etikett" for å angi din egen: 
Fastvare
Provisioneren gir muligheten til å spesifisere hvilken versjon av oppstartslasterens fastvare du ønsker å installere på CM4. På Firmware-siden er det en liste over alle mulige alternativer, men den nyeste er vanligvis den beste.
For å oppdatere listen med de nyeste versjonene av oppstartslasteren, klikk på 'Last ned ny fastvare fra github'-knappen.
Mulige problemer
Utdatert oppstartslasterfastvare
Hvis CM4-en din ikke oppdages av Provisioner-systemet når den er koblet til, er det mulig at oppstartslasterens fastvare er utdatert. Merk at alle CM4-enheter produsert siden februar 2021 har riktig oppstartslaster installert på fabrikken, så dette vil kun skje med enheter som ble produsert før den datoen.
Allerede programmert eMMC
Hvis CM4-modulen allerede har oppstart files i eMMC fra et tidligere provisjonsforsøk, vil den starte opp fra eMMC og nettverksoppstarten som kreves for klargjøring vil ikke skje.
Hvis du ønsker å reprodusere en CM4-modul, må du:
- Koble til en USB-kabel mellom klargjøringsserveren og mikro-USB-porten på CM4 IO-kortet (merket 'USB-slave').
- Sett en jumper på CM4 IO Board (J2, 'Fit jumper to disable eMMC boot').
Dette vil føre til at CM4-modulen utfører en USB-oppstart, i så fall vil klargjøringsserveren overføre files av verktøyet OS over USB.
Etter at verktøyet OS har startet opp, vil det kontakte klargjøringsserveren over Ethernet for å motta ytterligere instruksjoner og laste ned flere files (f.eks. OS-bildet som skal skrives til eMMC) som vanlig. Så en Ethernet-tilkobling i tillegg til USB-kabelen er fortsatt nødvendig.
Spanning Tree Protocol (STP) på administrerte Ethernet-svitsjer
PXE-oppstart vil ikke fungere riktig hvis STP er aktivert på en administrert Ethernet-svitsj. Dette kan være standard på enkelte svitsjer (f.eks. Cisco), og hvis det er tilfelle, må den deaktiveres for at klargjøringsprosessen skal fungere riktig.
Raspberry Pi er et varemerke for Raspberry Pi Foundation
Raspberry Pi Ltd
Dokumenter / Ressurser
 |
Raspberry Pi Provisioning Raspberry Pi Compute Module [pdfBrukerhåndbok Klargjøring av Raspberry Pi Compute Module, Provisioning, Raspberry Pi Compute Module, Compute Module |