Poskytovanie výpočtového modulu Raspberry Pi
Poskytovanie výpočtového modulu Raspberry Pi (verzie 3 a 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Kolofón
© 2020-2022 Raspberry Pi Ltd (predtým Raspberry Pi (Trading) Ltd.)
Táto dokumentácia je licencovaná podľa Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). dátum zostavenia: 2022-07-19 verzia zostavy: githash: 94a2802-clean
Právne upozornenie
TECHNICKÉ ÚDAJE A SPOĽAHLIVOSŤ PRODUKTOV RASPBERRY PI (VRÁTANE ÚDAJOVÝCH hárkov), AKO Z ČASU UPRAVUJÚ („ZDROJE“), POSKYTUJE SPOLOČNOSŤ RASPBERRY PI LTD („RPL“) „TAK, AKO SÚ“ A AKÉKOĽVEK VÝSLOVNÉ ALEBO IMPLICITNÉ, BEZ OBMEDZENÍ BEZ ZÁRUK PREDPOKLADANÉ ZÁRUKY PREDAJNOSTI A VHODNOSTI NA KONKRÉTNY ÚČEL SA ODMIETNUJÚ. V MAXIMÁLNOM ROZSAHU POVOLENOM PRÍSLUŠNÝM ZÁKONOM V ŽIADNOM PRÍPADE NEBUDE RPL ZODPOVEDNÁ ZA AKÉKOĽVEK PRIAMY, NEPRIAME, NÁHODNÉ, ŠPECIÁLNE, EXEMPLÁRNE ALEBO NÁSLEDNÉ ŠKODY (VRÁTANE, ALE NEOBMEDZENÉHO POUŽITIA, ZAOBCHÁDZANIE GOODS; ALEBO ZISKY; ALEBO PRERUŠENIE PODNIKANIA) AKO JE TO SPÔSOBENÉ A NA AKEJKOĽVEK TEÓRII ZODPOVEDNOSTI, ČI UŽ V ZMLUVE, PRÍMEJ ZODPOVEDNOSTI ALEBO PREČINKU (VRÁTANE NEDBALOSTI ALEBO INAK), VZNIKNUTÉM AKÝMKOĽVEK SPÔSOBOM Z NAŠEHO POUŽITIA. TAKÝCHTO POŠKODENÍ.
Spoločnosť RPL si vyhradzuje právo kedykoľvek a bez ďalšieho upozornenia vykonať akékoľvek vylepšenia, vylepšenia, opravy alebo akékoľvek iné úpravy ZDROJOV alebo akýchkoľvek produktov v nich popísaných. ZDROJE sú určené pre skúsených používateľov s vhodnou úrovňou znalostí o dizajne. Používatelia sú výhradne zodpovední za svoj výber a používanie ZDROJOV a akúkoľvek aplikáciu produktov v nich popísaných. Používateľ súhlasí s tým, že odškodní a ochráni RPL za všetky záväzky, náklady, škody alebo iné straty vyplývajúce z používania ZDROJOV. RPL udeľuje používateľom povolenie používať ZDROJE výhradne v spojení s produktmi Raspberry Pi. Akékoľvek iné použitie ZDROJOV je zakázané. Žiadna licencia sa neudeľuje žiadnemu inému RPL ani inému právu duševného vlastníctva tretej strany. VYSOKÉ RIZIKOVÉ AKTIVITY. Produkty Raspberry Pi nie sú navrhnuté, vyrobené ani určené na použitie v nebezpečných prostrediach vyžadujúcich bezpečný výkon, ako je prevádzka jadrových zariadení, letecké navigačné alebo komunikačné systémy, riadenie letovej prevádzky, zbraňové systémy alebo aplikácie kritické z hľadiska bezpečnosti (vrátane podpory života systémov a iných zdravotníckych pomôcok), pri ktorých by zlyhanie produktov mohlo viesť priamo k smrti, zraneniu osôb alebo vážnemu fyzickému poškodeniu alebo poškodeniu životného prostredia (ďalej len „vysoko rizikové činnosti“). RPL výslovne odmieta akúkoľvek výslovnú alebo implicitnú záruku vhodnosti pre vysokorizikové činnosti a neprijíma žiadnu zodpovednosť za používanie alebo zahrnutie produktov Raspberry Pi do vysokorizikových činností. Produkty Raspberry Pi sú poskytované v súlade so štandardnými podmienkami RPL. Poskytnutie ZDROJOV spoločnosťou RPL nerozširuje ani inak neupravuje Štandardné podmienky spoločnosti RPL vrátane, ale nie výlučne, vylúčení zodpovednosti a záruk v nich vyjadrených.
História verzií dokumentu 
Rozsah dokumentument
Tento dokument sa vzťahuje na nasledujúce produkty Raspberry Pi:
Úvod
Poskytovateľom CM je a web aplikácia navrhnutá tak, aby programovanie veľkého počtu zariadení Raspberry Pi Compute Module (CM) bolo oveľa jednoduchšie a rýchlejšie. Ľahko sa inštaluje a jednoducho sa používa. Poskytuje rozhranie pre databázu obrazov jadra, ktoré je možné nahrať, spolu so schopnosťou používať skripty na prispôsobenie rôznych častí inštalácie počas procesu blikania. Podporovaná je aj tlač štítkov a aktualizácia firmvéru. Tento dokument predpokladá, že server Provisioner, verzia softvéru 1.5 alebo novšia, beží na Raspberry Pi.
Ako to celé funguje
CM4
Systém Provisioner musí byť nainštalovaný vo vlastnej káblovej sieti; Raspberry Pi, na ktorom beží server, je pripojený k prepínaču spolu s toľkými zariadeniami CM4, koľko môže prepínač podporovať. Akýkoľvek CM4 zapojený do tejto siete bude detekovaný systémom poskytovania a automaticky sa naň načíta firmvér požadovaný používateľom. Dôvod vlastnej káblovej siete je zrejmý, keď si uvedomíte, že bude poskytnutý akýkoľvek CM4 zapojený do siete, takže je nevyhnutné udržiavať sieť oddelenú od akejkoľvek aktívnej siete, aby sa zabránilo neúmyselnému preprogramovaniu zariadení.
ZMENY OBRÁZKU CM 4 IO dosky s CM 4 -> CM4 IO dosky s CM4
Použitím Raspberry Pi ako servera je možné používať káblovú sieť pre Provisioner, ale stále umožňuje prístup k externým sieťam pomocou bezdrôtového pripojenia. To umožňuje jednoduché sťahovanie obrázkov na server, pripravené na proces poskytovania a umožňuje Raspberry Pi obsluhovať poskytovateľa. web rozhranie. Je možné stiahnuť viacero obrázkov; Provisioner uchováva databázu obrázkov a uľahčuje výber vhodného obrázka na nastavenie rôznych zariadení.
Keď je CM4 pripojený k sieti a je zapnutý, pokúsi sa zaviesť systém a po vyskúšaní iných možností sa pokúsi o zavedenie siete. V tomto bode systém Provisioner Dynamic Host Configuration Protocol (DHCP) reaguje na zavádzanie CM4 a poskytuje mu minimálny bootovateľný obraz, ktorý sa stiahne do CM4 a potom sa spustí ako root. Tento obrázok môže naprogramovať vloženú multimediálnu kartu (eMMC) a spustiť akékoľvek požadované skripty podľa pokynov poskytovateľa.
Viac podrobností
Moduly CM4 sa dodávajú s konfiguráciou zavádzania, ktorá sa najskôr pokúsi zaviesť systém z eMMC; ak to zlyhá, pretože eMMC je prázdne, vykoná sa spustenie siete pred spustením prostredia (PXE). Takže s modulmi CM4, ktoré ešte neboli poskytnuté a majú prázdne eMMC, sa predvolene vykoná sieťové zavedenie. Počas zavádzania siete v provizórnej sieti bude poskytovaný server do modulu CM4 cez sieť doručený obraz ľahkého pomocného operačného systému (OS) (v skutočnosti jadro Linuxu a scriptexecute initramfs) a tento obraz sa stará o poskytovanie.
CM 3 a CM 4s
Zariadenia CM založené na konektore SODIMM nie je možné zaviesť zo siete, takže programovanie sa vykonáva cez USB. Každé zariadenie bude musieť byť pripojené k poskytovateľovi. Ak potrebujete pripojiť viac ako 4 zariadenia (počet USB portov na Raspberry Pi), je možné použiť USB hub. Použite kvalitné káble USB-A na Micro-USB, ktoré sa pripájajú z Raspberry Pi alebo rozbočovača k portu USB slave každej dosky CMIO. Všetky dosky CMIO budú tiež potrebovať napájací zdroj a prepojka J4 USB slave by mala byť nastavená tak, aby
DÔLEŽITÉ
NEPRIPÁJAJTE ethernetový port Pi 4. Bezdrôtové pripojenie sa používa na prístup k správe web rozhranie.
Inštalácia
Nasledujúce pokyny boli správne v čase vydania. Najnovšie pokyny na inštaláciu nájdete na stránke Provisioner GitHub.
Inštalácia poskytovateľa web aplikácia na Raspberry Pi
POZOR
Uistite sa, že eth0 sa pripája k ethernetovému prepínaču, ktorý má pripojené iba dosky CM4 IO. Nepripájajte eth0 do vašej kancelárskej/verejnej siete, pretože môže „poskytovať“ aj iné zariadenia Raspberry Pi vo vašej sieti. Na pripojenie k miestnej sieti použite bezdrôtové pripojenie Raspberry Pi.
Lite verzia operačného systému Raspberry Pi sa odporúča ako základný operačný systém, na ktorý sa má nainštalovať Provisioner. Pre jednoduchosť použite rpi-imager a aktivujte ponuku rozšírených nastavení (Ctrl-Shift-X) na nastavenie hesla, názvu hostiteľa a bezdrôtových nastavení. Po nainštalovaní operačného systému na Raspberry Pi budete musieť nastaviť systém Ethernet:
- Nakonfigurujte eth0 tak, aby mal v podsieti /172.20.0.1 statickú adresu internetového protokolu (IP) 16 (maska siete 255.255.0.0) úpravou konfigurácie DHCP:
- sudo nano /etc/dhcpcd.conf
- Pridajte na spodok file:
rozhranie eth0
statická ip_address=172.20.0.1/16 - Reštartujte, aby sa zmeny prejavili.
- Uistite sa, že inštalácia OS je aktuálna:
aktualizácia sudo apt
sudo apt full-upgrade - Provisioner je dodávaný ako hotový .deb file na stránke Provider GitHub. Stiahnite si najnovšiu verziu z tejto stránky alebo pomocou wget a nainštalujte ju pomocou nasledujúceho príkazu:
sudo apt install ./cmprovision4_*_all.deb - Nastavte web užívateľské meno a heslo aplikácie:
sudo /var/lib/cmprovision/artisan auth:create-user
Teraz máte prístup k web rozhranie Poskytovateľa s a web prehliadač pomocou bezdrôtovej IP adresy Raspberry Pi a používateľského mena a hesla zadaného v predchádzajúcej časti. Stačí zadať IP adresu do panela s adresou vášho prehliadača a stlačiť Enter.
Použitie
Pri prvom pripojení k poskytovateľovi web žiadosť s vašou web prehliadača uvidíte obrazovku Dashboard, ktorá bude vyzerať asi takto:
Táto vstupná stránka jednoducho poskytuje nejaké informácie o poslednej akcii vykonanej Poskytovateľom (naprample vyššie, bol poskytnutý jeden CM4).
Nahrávanie obrázkov
Prvou operáciou vyžadovanou pri nastavovaní je načítanie vášho obrazu na server, odkiaľ ho možno použiť na poskytovanie vašich dosiek CM4. Kliknite na položku ponuky „Obrázky“ v hornej časti web a mali by ste dostať obrazovku podobnú tej, ktorá je zobrazená nižšie, so zoznamom aktuálne nahraných obrázkov (ktoré budú na začiatku prázdne).
Ak chcete nahrať obrázok, vyberte tlačidlo Pridať obrázok; uvidíte túto obrazovku:
Obrázok musí byť prístupný na zariadení, kde je web prehliadač je spustený a v jednom zo špecifikovaných formátov obrázkov. Vyberte obrázok zo svojho zariadenia pomocou štandardu file a kliknite na „Nahrať“. Toto teraz skopíruje obrázok z vášho počítača na server Provisioner spustený na Raspberry Pi. Môže to chvíľu trvať. Po odovzdaní obrázka ho uvidíte na stránke Obrázky.
Pridanie projektu
Teraz musíte vytvoriť projekt. Môžete zadať ľubovoľný počet projektov a každý môže mať iný obrázok, sadu skriptov alebo štítok. Aktívny projekt je ten, ktorý sa momentálne používa na poskytovanie.
Kliknutím na položku ponuky „Projekty“ zobrazíte stránku Projekty. Nasledujúce example už má nastavený jeden projekt s názvom „Testovací projekt“.
Teraz kliknite na „Pridať projekt“ a vytvorte nový projekt
- Dajte projektu vhodný názov a potom z rozbaľovacieho zoznamu vyberte, ktorý obrázok má tento projekt použiť. Na tomto s. môžete nastaviť aj množstvo ďalších parametrovtage, ale často postačí len obrázok.
- Ak používate verziu 1.5 alebo novšiu poskytovateľa, potom máte možnosť overiť, či sa blikanie dokončilo správne. Výberom tejto možnosti sa po bliknutí načítajú späť údaje zo zariadenia CM a potvrdí sa, že sa zhodujú s pôvodným obrázkom. Tým sa pridá čas navyše na poskytovanie každého zariadenia, množstvo pridaného času bude závisieť od veľkosti obrázka.
- Ak vyberiete firmvér na inštaláciu (toto je voliteľné), máte tiež možnosť prispôsobiť tento firmvér pomocou niektorých špecifických konfiguračných položiek, ktoré budú zlúčené do binárneho súboru zavádzača. Dostupné možnosti nájdete na Raspberry Pi webstránky.
- Po úplnom zadefinovaní nového projektu kliknite na 'Uložiť'; vrátite sa na stránku Projekty a zobrazí sa nový projekt. Všimnite si, že vždy môže byť aktívny iba jeden projekt a môžete si ho vybrať z tohto zoznamu.
Skriptá
Skutočne užitočnou funkciou Provisioner je možnosť spúšťať skripty na obrázku, pred alebo po inštalácii. V Provisioner sú štandardne nainštalované tri skripty, ktoré je možné vybrať pri vytváraní nového projektu. Sú uvedené na stránke Scripts
BývalýampSkripty sa môžu použiť na pridanie vlastných záznamov do súboru config.txt. Na to slúži štandardný skript Add dtoverlay=dwc2 do config.txt pomocou nasledujúceho kódu shellu:
Kliknite na „Pridať skript“ a pridajte svoje vlastné prispôsobenia:
Štítky
Poskytovateľ má možnosť vytlačiť štítky pre zariadenie, ktoré sa poskytuje. Stránka Štítky zobrazuje všetky preddefinované štítky, ktoré je možné vybrať počas procesu úpravy projektu. Naprample, možno budete chcieť vytlačiť DataMatrix alebo kódy rýchlej odozvy (QR) pre každú poskytnutú dosku a táto funkcia to veľmi uľahčuje.
Kliknite na „Pridať štítok“ a zadajte svoj vlastný: 
Firmvér
Provisioner poskytuje možnosť určiť, ktorú verziu firmvéru zavádzača chcete nainštalovať na CM4. Na stránke Firmvér je zoznam všetkých možných možností, ale najnovšia je zvyčajne najlepšia.
Ak chcete aktualizovať zoznam najnovšími verziami zavádzača, kliknite na tlačidlo „Stiahnuť nový firmvér z githubu“.
Možné problémy
Zastaraný firmvér zavádzača
Ak váš CM4 nie je detekovaný systémom Provisioner, keď je zapojený, je možné, že firmvér zavádzača je zastaraný. Upozorňujeme, že všetky zariadenia CM4 vyrobené od februára 2021 majú v továrni nainštalovaný správny bootloader, takže sa to stane iba so zariadeniami, ktoré boli vyrobené pred týmto dátumom.
Už naprogramované eMMC
Ak už má modul CM4 boot filev eMMC z predchádzajúceho pokusu o poskytovanie, potom sa spustí z eMMC a nenastane zavedenie siete potrebné na poskytovanie.
Ak si želáte reprovidovať modul CM4, budete musieť:
- Pripojte kábel USB medzi server poskytovania a port micro USB dosky CM4 IO (označený ako „USB slave“).
- Umiestnite prepojku na dosku CM4 IO (J2, „Pripevnite prepojku na deaktiváciu spustenia eMMC“).
To spôsobí, že modul CM4 vykoná bootovanie z USB, v takom prípade prenesie server poskytovania files pomocného OS cez USB.
Po zavedení operačného systému pomôcky sa obráti na server poskytovania cez Ethernet, aby dostal ďalšie pokyny a stiahol ďalšie files (napr. obraz OS, ktorý sa má zapísať do eMMC) ako zvyčajne. Takže okrem kábla USB je stále potrebné pripojenie Ethernet.
Spanning Tree Protocol (STP) na riadených ethernetových prepínačoch
Zavádzanie PXE nebude fungovať správne, ak je na riadenom ethernetovom prepínači povolené STP. Toto môže byť predvolené nastavenie na niektorých prepínačoch (napr. Cisco), a ak je to tak, bude potrebné vypnúť, aby proces poskytovania fungoval správne.
Raspberry Pi je ochranná známka Raspberry Pi Foundation
Raspberry Pi Ltd
Dokumenty / zdroje
 |
Raspberry Pi Poskytovanie výpočtového modulu Raspberry Pi [pdf] Používateľská príručka Poskytovanie výpočtového modulu Raspberry Pi, poskytovanie výpočtového modulu Raspberry Pi, výpočtového modulu |