Raspberry Pi -laskentamoduulin käyttöönotto
Raspberry Pi -laskentamoduulin hallinta (versiot 3 ja 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Colophon
© 2020-2022 Raspberry Pi Ltd (aiemmin Raspberry Pi (Trading) Ltd.)
Tämä dokumentaatio on lisensoitu Creative Commons Attribution-NoDerivatives 4.0 Internationalin (CC BY-ND) mukaisesti. rakennuspäivämäärä: 2022-07-19 rakennusversio: githash: 94a2802-clean
Oikeudellinen vastuuvapauslauseke
RASPBERRY PI LTD ("RPL") TOIMITTAA RASPBERRY PI LTD ("RPL") "SELLAISENAAN" TEKNISET JA LUOTETTAVUUSTIEDOT RASPBERRY PI -TUOTTEISTA (TUOTTEET MUKAAN MUKAAN MUKAAN MUKAAN TUOTTEELLE) MUUTTAMISEENA ("RESURSSIT") TOTEUTTAVAT OLETETUT TAKUUT MYYNTIKELPOISUUDESTA JA TIETTYYN TARKOITUKSEEN SOVELTUVUUDESTA. SOVELLETTAVAN LAIN SALLITTAMAAN SUURIMMAAN RPL EI MISSÄÄN TAPAUKSESSA OLE VASTUUSSA MISTÄÄN SUORISTA, EPÄSUORISTA, SATUNNAISISTA, ESIMERKKEISTÄ TAI VÄLILLISISTÄ VAHINGOISTA (MUKAAN LUKIEN, MUUTTA EI RAJOITETTUA PALVELUN KÄYTTÖÄ; , TIEDOT Tai voitot; SELLAISISTA VAHINGOISTA.
RPL varaa oikeuden tehdä parannuksia, parannuksia, korjauksia tai muita muutoksia RESURSSeihin tai niissä kuvattuihin tuotteisiin milloin tahansa ja ilman erillistä ilmoitusta. RESURSSIT on tarkoitettu ammattitaitoisille käyttäjille, joilla on sopiva suunnitteluosaaminen. Käyttäjät ovat yksin vastuussa RESURSSIEN valinnasta ja käytöstä sekä niissä kuvattujen tuotteiden käytöstä. Käyttäjä sitoutuu korvaamaan ja pitämään RPL:n vastuuttomana kaikista vastuista, kustannuksista, vahingoista tai muista menetyksistä, jotka johtuvat hänen RESURSSIEN käytöstä. RPL myöntää käyttäjille luvan käyttää RESURSSEJA vain Raspberry Pi -tuotteiden yhteydessä. Kaikki muu RESURSSIEN käyttö on kiellettyä. Mitään lisenssiä ei myönnetä muille RPL:lle tai muille kolmannen osapuolen immateriaalioikeuksille. KORKEAN RISKIN TOIMINTA. Raspberry Pi -tuotteita ei ole suunniteltu, valmistettu tai tarkoitettu käytettäviksi vaarallisissa ympäristöissä, jotka edellyttävät vikaturvallista toimintaa, kuten ydinlaitosten, lentokoneiden navigointi- tai viestintäjärjestelmien, lennonjohdon, asejärjestelmien tai turvallisuuden kannalta kriittisten sovellusten (mukaan lukien elämän ylläpitäminen) toiminnassa. järjestelmät ja muut lääkinnälliset laitteet), joissa tuotteiden vikaantuminen voi johtaa suoraan kuolemaan, henkilövahinkoon tai vakaviin fyysisiin tai ympäristövahinkoihin ("korkean riskin toiminnot"). RPL kiistää nimenomaisesti kaikki nimenomaiset tai epäsuorat takuut soveltuvuudesta suuren riskin toimintaan eikä ota vastuuta Raspberry Pi -tuotteiden käytöstä tai sisällyttämisestä suuren riskin toimintaan. Raspberry Pi -tuotteet toimitetaan RPL:n vakioehtojen alaisina. RPL:n tarjoamat RESURSSIT eivät laajenna tai muutoin muuta RPL:n vakioehtoja, mukaan lukien, mutta ei rajoittuen, niissä ilmaistut vastuuvapauslausekkeet ja takuut.
Asiakirjan versiohistoria 
Asiakirjan laajuusment
Tämä asiakirja koskee seuraavia Raspberry Pi -tuotteita:
Johdanto
CM Provisioner on a web sovellus, joka on suunniteltu tekemään useiden Raspberry Pi Compute Module (CM) -laitteiden ohjelmoinnista paljon helpompaa ja nopeampaa. Se on helppo asentaa ja helppo käyttää. Se tarjoaa käyttöliittymän ytimen kuvien tietokantaan, jotka voidaan ladata, sekä mahdollisuuden käyttää komentosarjoja asennuksen eri osien mukauttamiseen flash-prosessin aikana. Myös tarratulostus ja laiteohjelmiston päivitys ovat tuettuja. Tässä oppaassa oletetaan, että Provisioner-palvelin, ohjelmistoversio 1.5 tai uudempi, toimii Raspberry Pi:llä.
Miten se kaikki toimii
CM4
Provisioner-järjestelmä on asennettava omaan kiinteään verkkoonsa; palvelinta pyörittävä Raspberry Pi on kytketty kytkimeen sekä niin monta CM4-laitetta kuin kytkin tukee. Käyttöönottojärjestelmä havaitsee kaikki tähän verkkoon kytketyt CM4:t, ja ne päivitetään automaattisesti käyttäjän tarvitseman laiteohjelmiston kanssa. Oman langallisen verkon syy tulee selväksi, kun ajatellaan, että mikä tahansa verkkoon liitetty CM4 on provisioitu, joten verkon pitäminen erillään elävästä verkosta on välttämätöntä laitteiden tahattoman uudelleenohjelmoinnin estämiseksi.
KUVAN MUUTOKSET CM 4 IO -kortit CM 4:llä -> CM4 IO-kortit CM4:llä
Käyttämällä Raspberry Pi:tä palvelimena on mahdollista käyttää Provisionerin langallista verkkoa, mutta silti mahdollistaa pääsy ulkoisiin verkkoihin langattoman yhteyden avulla. Tämä mahdollistaa kuvien helpon lataamisen palvelimelle valmiina provisiointiprosessia varten ja mahdollistaa Raspberry Pi:n palvelevan palveluntarjoajaa. web käyttöliittymä. Voit ladata useita kuvia; Provisioner ylläpitää tietokantaa kuvista ja helpottaa sopivan kuvan valitsemista eri laitteiden asentamista varten.
Kun CM4 on liitetty verkkoon ja se on päällä, se yrittää käynnistyä, ja kun muita vaihtoehtoja on kokeiltu, yritetään käynnistää verkko. Tässä vaiheessa Provisioner Dynamic Host Configuration Protocol (DHCP) -järjestelmä vastaa käynnistyvään CM4:ään ja tarjoaa sille minimaalisen käynnistettävän kuvan, joka ladataan CM4:ään ja suoritetaan sitten pääkäyttäjänä. Tämä kuva voi ohjelmoida sulautetun Multi-Media Card (eMMC) -kortin ja suorittaa tarvittavat komentosarjat palveluntarjoajan ohjeiden mukaisesti.
Lisätietoja
CM4-moduulit toimitetaan käynnistyskokoonpanolla, joka yrittää käynnistää ensin eMMC:stä; Jos tämä epäonnistuu, koska eMMC on tyhjä, se suorittaa preboot execution Environment (PXE) -verkkokäynnistyksen. Joten CM4-moduuleilla, joita ei ole vielä varusteltu ja joissa on tyhjä eMMC, verkkokäynnistys suoritetaan oletusarvoisesti. Provisiointiverkon verkkokäynnistyksen aikana hallintapalvelin palvelee CM4-moduulille verkon kautta kevytkäyttöjärjestelmän (OS) -otosta (itse asiassa Linux-ydin ja komentosarjan suorittava initramfs), ja tämä näköistiedosto hoitaa asennuksen.
CM 3 ja CM 4s
SODIMM-liittimeen perustuvat CM-laitteet eivät voi käynnistyä verkosta, joten ohjelmointi tapahtuu USB:n kautta. Jokainen laite on yhdistettävä Provisioneriin. Jos sinun on liitettävä yli 4 laitetta (raspberry Pi:n USB-porttien määrä), voidaan käyttää USB-keskitintä. Käytä laadukkaita USB-A–Micro-USB-kaapeleita, jotka liitetään Raspberry Pi:stä tai keskittimestä jokaisen CMIO-kortin USB-slave-porttiin. Kaikki CMIO-kortit tarvitsevat myös virtalähteen, ja J4 USB orjakäynnistyksen hyppyjohdin tulee asettaa ottamaan käyttöön
TÄRKEÄÄ
ÄLÄ kytke Pi 4:n Ethernet-porttia. Langatonta yhteyttä käytetään hallintaan web käyttöliittymä.
Asennus
Seuraavat ohjeet olivat oikein julkaisuhetkellä. Viimeisimmät asennusohjeet löytyvät Provisioner GitHub -sivulta.
Provisionerin asentaminen web sovellus Raspberry Pi:ssä
VAROITUS
Varmista, että eth0 muodostaa yhteyden Ethernet-kytkimeen, johon on kytketty vain CM4 IO -kortit. Älä yhdistä eth0:aa toimistoosi/julkiseen verkkoosi, sillä se voi "antaa" myös muita Raspberry Pi -laitteita verkossasi. Käytä langatonta Raspberry Pi -yhteyttä muodostaaksesi yhteyden paikalliseen verkkoosi.
Raspberry Pi OS:n Lite-versiota suositellaan peruskäyttöjärjestelmäksi, johon Provisioner asennetaan. Käytä yksinkertaisuuden vuoksi rpi-imageria ja määritä salasana, isäntänimi ja langattomat asetukset aktivoimalla lisäasetusvalikko (Ctrl-Shift-X). Kun käyttöjärjestelmä on asennettu Raspberry Pi -laitteeseen, sinun on määritettävä Ethernet-järjestelmä:
- Määritä eth0 käyttämään staattista IP-osoitetta 172.20.0.1 /16-aliverkon sisällä (verkon peite 255.255.0.0) muokkaamalla DHCP-kokoonpanoa:
- sudo nano /etc/dhcpcd.conf
- Lisää pohjaan file:
käyttöliittymä eth0
static ip_address=172.20.0.1/16 - Käynnistä uudelleen, jotta muutokset tulevat voimaan.
- Varmista, että käyttöjärjestelmän asennus on ajan tasalla:
sudo apt päivitys
sudo apt täyden päivityksen - Provisioner toimitetaan valmiina .deb-tiedostona file Provisioner GitHub -sivulla. Lataa uusin versio tältä sivulta tai wgetillä ja asenna se seuraavalla komennolla:
sudo apt install ./cmprovision4_*_all.deb - Aseta web sovelluksen käyttäjätunnus ja salasana:
sudo /var/lib/cmprovision/artisan auth:create-user
Voit nyt käyttää web Palveluntarjoajan käyttöliittymä a web selaimella käyttämällä langatonta Raspberry Pi IP-osoitetta ja edellisessä osiossa syötettyä käyttäjätunnusta ja salasanaa. Kirjoita vain IP-osoite selaimen osoiteriville ja paina Enter.
Käyttö
Kun muodostat ensimmäisen yhteyden palveluntarjoajaan web hakemuksesi kanssasi web selaimessa näet Dashboard-näytön, joka näyttää suunnilleen tältä:
Tämä aloitussivu antaa yksinkertaisesti tietoja Palveluntarjoajan viimeisimmistä toimista (esimampedellä, yksi CM4 on varattu).
Kuvien lataaminen
Ensimmäinen asennuksen yhteydessä vaadittava toimenpide on ladata kuvasi palvelimelle, josta sitä voidaan käyttää CM4-korttien varustamiseen. Napsauta "Kuvat" -valikkokohtaa yläreunassa web sivulle ja sinun pitäisi saada alla olevan kaltainen näyttö, jossa näkyy luettelo parhaillaan ladatuista kuvista (joka on aluksi tyhjä).
Valitse Lisää kuva -painike ladataksesi kuvan; näet tämän näytön:
Kuvan on oltava käytettävissä laitteella, jossa web selain on käynnissä ja jossakin määritetyistä kuvamuodoista. Valitse kuva laitteeltasi standardin mukaan file valintaikkuna ja napsauta 'Lataa'. Tämä kopioi nyt kuvan koneeltasi Provisioner-palvelimelle, joka toimii Raspberry Pi:llä. Tämä voi kestää jonkin aikaa. Kun kuva on ladattu, näet sen Kuvat-sivulla.
Projektin lisääminen
Nyt sinun on luotava projekti. Voit määrittää minkä tahansa määrän projekteja, ja jokaisella voi olla erilainen kuva, sarja komentosarjoja tai tunniste. Aktiivinen projekti on se, jota tällä hetkellä käytetään provisiointiin.
Napsauta 'Projektit'-valikkokohtaa avataksesi Projektit-sivun. Seuraava example on jo yksi projekti, nimeltään "Testiprojekti", perustettu.
Napsauta nyt "Lisää projekti" luodaksesi uuden projektin
- Anna projektille sopiva nimi ja valitse sitten pudotusvalikosta, mitä kuvaa haluat projektin käyttävän. Voit myös asettaa useita muita parametreja tässä stage, mutta usein vain kuva riittää.
- Jos käytät Provisionerin versiota 1.5 tai uudempaa, sinulla on mahdollisuus varmistaa, että vilkkuminen on suoritettu oikein. Tämän valitseminen lukee tiedot CM-laitteesta vilkkumisen jälkeen ja vahvistaa, että ne vastaavat alkuperäistä kuvaa. Tämä lisää ylimääräistä aikaa kunkin laitteen hallintaan, lisättävä aika riippuu kuvan koosta.
- Jos valitset asennettavan laiteohjelmiston (tämä on valinnainen), voit myös mukauttaa kyseistä laiteohjelmistoa tietyillä konfiguraatiomerkinnöillä, jotka yhdistetään käynnistyslataimen binaariin. Käytettävissä olevat vaihtoehdot löytyvät Raspberry Pi:stä websivusto.
- Napsauta 'Tallenna', kun olet määrittänyt uuden projektisi kokonaan. palaat Projektit-sivulle ja uusi projekti tulee näkyviin. Huomaa, että vain yksi projekti voi olla aktiivinen kerrallaan, ja voit valita sen tästä luettelosta.
Käsikirjoitukset
Provisionerin todella hyödyllinen ominaisuus on kyky suorittaa skriptejä kuvassa ennen asennusta tai sen jälkeen. Kolme komentosarjaa asennetaan oletuksena Provisioneriin, ja ne voidaan valita uutta projektia luotaessa. Ne on lueteltu Skriptit-sivulla
ExampKomentosarjojen käyttö saattaa olla mukautettujen merkintöjen lisäämistä config.txt-tiedostoon. Vakiokomentosarja Add dtoverlay=dwc2 tiedostoon config.txt tekee tämän käyttämällä seuraavaa komentotulkkikoodia:
Napsauta "Lisää komentosarja" lisätäksesi omia mukautuksiasi:
Tarrat
Provisioijalla on mahdollisuus tulostaa tarroja toimitettavalle laitteelle. Tarrat-sivulla näkyvät kaikki ennalta määritetyt tarrat, jotka voidaan valita projektin muokkausprosessin aikana. esimampVoit halutessasi tulostaa DataMatrix- tai Quick Response (QR) -koodit jokaiselle varustetulle kortille, ja tämä ominaisuus tekee tästä erittäin helppoa.
Napsauta "Lisää tunniste" määrittääksesi omasi: 
Laiteohjelmisto
Provisioner tarjoaa mahdollisuuden määrittää, minkä version käynnistyslataimen laiteohjelmistosta haluat asentaa CM4:ään. Laiteohjelmisto-sivulla on luettelo kaikista mahdollisista vaihtoehdoista, mutta uusin on yleensä paras.
Päivitä luettelo käynnistyslataimen uusimmilla versioilla napsauttamalla 'Lataa uusi laiteohjelmisto githubista' -painiketta.
Mahdolliset ongelmat
Vanhentunut käynnistyslataimen laiteohjelmisto
Jos Provisioner-järjestelmä ei tunnista CM4:ää, kun se on kytketty, on mahdollista, että käynnistyslataimen laiteohjelmisto on vanhentunut. Huomaa, että kaikissa helmikuusta 4 lähtien valmistetuissa CM2021-laitteissa on oikea käynnistyslatain asennettuna tehtaalla, joten tämä tapahtuu vain laitteissa, jotka on valmistettu ennen kyseistä päivämäärää.
eMMC on jo ohjelmoitu
Jos CM4-moduulissa on jo käynnistys files eMMC:ssä aiemmasta hallintayrityksestä, se käynnistyy eMMC:stä eikä kokoonpanon edellyttämää verkkokäynnistystä tapahdu.
Jos haluat muuttaa CM4-moduulia, sinun tulee:
- Liitä USB-kaapeli provisiointipalvelimen ja CM4 IO -levyn mikro-USB-portin väliin (merkitty "USB-slave").
- Aseta hyppyjohdin CM4 IO -korttiin (J2, 'Fit jumper to disable eMMC boot').
Tämä saa CM4-moduulin suorittamaan USB-käynnistyksen, jolloin provisiointipalvelin siirtää files apuohjelmakäyttöjärjestelmästä USB:n kautta.
Kun apuohjelman käyttöjärjestelmä on käynnistynyt, se ottaa yhteyttä provisiointipalvelimeen Ethernetin kautta saadakseen lisäohjeita ja ladatakseen lisää files (esim. eMMC:hen kirjoitettava käyttöjärjestelmäkuva) tavalliseen tapaan. Ethernet-liitäntä on siis edelleen tarpeen USB-kaapelin lisäksi.
Spanning Tree Protocol (STP) hallituissa Ethernet-kytkimissä
PXE-käynnistys ei toimi oikein, jos STP on käytössä hallitussa Ethernet-kytkimessä. Tämä voi olla oletusasetus joissakin kytkimissä (esim. Cisco), ja jos näin on, se on poistettava käytöstä, jotta valmisteluprosessi toimii oikein.
Raspberry Pi on Raspberry Pi Foundationin tavaramerkki
Raspberry Pi Ltd
Asiakirjat / Resurssit
 |
Raspberry Pi tarjoaa Raspberry Pi -laskentamoduulin [pdfKäyttöopas Raspberry Pi -laskentamoduulin hallinta, hallinta, Raspberry Pi -laskentamoduuli, laskentamoduuli |