Poskytování výpočetního modulu Raspberry Pi
Poskytování výpočetního modulu Raspberry Pi (verze 3 a 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Tiráž
© 2020-2022 Raspberry Pi Ltd (dříve Raspberry Pi (Trading) Ltd.)
Tato dokumentace podléhá licenci Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). Datum sestavení: 2022-07-19 Verze sestavení: githash: 94a2802-clean
Právní upozornění
TECHNICKÁ A SPOLEHLIVOSTNÍ ÚDAJE PRO PRODUKTY RASPBERRY PI (VČETNĚ DATOVÝCH LISTŮ), JAK JSOU ČAS OD ČASU MODIFIKOVANÉ („ZDROJE“), POSKYTUJE RASPBERRY PI LTD („RPL“) „TAK JAK JSOU“ A JAKÉKOLI VÝSLOVNÉ NEBO OMEZENÉ, BEZ ZÁRUK ODPOVÍDAJÍCÍ ZÁRUKY PRODEJNOSTI A VHODNOSTI PRO KONKRÉTNÍ ÚČEL. V MAXIMÁLNÍM ROZSAHU POVOLENÉM PŘÍSLUŠNÝM ZÁKONEM V ŽÁDNÉM PŘÍPADĚ NEBUDE RPL ODPOVĚDNÁ ZA JAKÉKOLI PŘÍMÉ, NEPŘÍMÉ, NÁHODNÉ, ZVLÁŠTNÍ, EXEMPLÁRNÍ NEBO NÁSLEDNÉ ŠKODY (VČETNĚ, ALE NEOMEZENO NA POSKYTNUTÍ POSKYTOVÁNÍ NÁHRADNÍCH DATA; , NEBO ZISKY NEBO PŘERUŠENÍ OBCHODNÍ ČINNOSTI), JAK JSOU ZPŮSOBENÉ A NA JAKÉKOLI TEorii ODPOVĚDNOSTI, AŤ VE SMLOUVĚ, PŘÍMÉ ODPOVĚDNOSTI NEBO deliktu (VČETNĚ NEDBALOSTI ČI JINAK), VZNIKLÉM JAKÝKOLI ZPŮSOB JAK JAK NAVYŠLI TOHOTO POUŽITÍ. TAKOVÉ ŠKODY.
Společnost RPL si vyhrazuje právo kdykoli a bez dalšího upozornění provádět jakákoli vylepšení, vylepšení, opravy nebo jakékoli jiné úpravy ZDROJŮ nebo jakýchkoli produktů v nich popsaných. ZDROJE jsou určeny pro zkušené uživatele s odpovídající úrovní znalostí návrhu. Uživatelé jsou výhradně zodpovědní za svůj výběr a použití ZDROJŮ a jakékoli použití produktů v nich popsaných. Uživatel souhlasí s tím, že odškodní a ochrání RPL vůči veškerým závazkům, nákladům, škodám nebo jiným ztrátám vyplývajícím z používání ZDROJŮ. RPL uděluje uživatelům oprávnění používat ZDROJE výhradně ve spojení s produkty Raspberry Pi. Jakékoli jiné použití ZDROJŮ je zakázáno. Žádná licence není udělena žádnému jinému RPL nebo jinému právu duševního vlastnictví třetí strany. VYSOKÉ RIZIKOVÉ AKTIVITY. Produkty Raspberry Pi nejsou navrženy, vyrobeny ani zamýšleny pro použití v nebezpečných prostředích vyžadujících bezpečnost při selhání, jako je provoz jaderných zařízení, letecké navigační nebo komunikační systémy, řízení letového provozu, zbraňové systémy nebo aplikace kritické z hlediska bezpečnosti (včetně podpory života systémů a jiných zdravotnických prostředků), ve kterých by selhání produktů mohlo vést přímo k smrti, zranění osob nebo vážnému fyzickému poškození nebo poškození životního prostředí („Vysoce rizikové činnosti“). RPL výslovně odmítá jakoukoli výslovnou nebo předpokládanou záruku vhodnosti pro vysoce rizikové činnosti a nepřijímá žádnou odpovědnost za použití nebo zahrnutí produktů Raspberry Pi do vysoce rizikových činností. Produkty Raspberry Pi jsou poskytovány v souladu se standardními podmínkami RPL. Poskytování ZDROJŮ společností RPL nerozšiřuje ani jinak neupravuje Standardní podmínky společnosti RPL, včetně, nikoli však výhradně, vyloučení odpovědnosti a záruk v nich vyjádřených.
Historie verzí dokumentu 
Rozsah dokumentument
Tento dokument se vztahuje na následující produkty Raspberry Pi:
Zavedení
Poskytovatelem CM je a web aplikace navržená tak, aby programování velkého počtu zařízení Raspberry Pi Compute Module (CM) bylo mnohem jednodušší a rychlejší. Snadno se instaluje a snadno se používá. Poskytuje rozhraní k databázi obrazů jádra, které lze nahrávat, spolu s možností používat skripty k přizpůsobení různých částí instalace během procesu flashování. Podporován je také tisk štítků a aktualizace firmwaru. Tento dokument předpokládá, že server Provisioner, verze softwaru 1.5 nebo novější, běží na Raspberry Pi.
Jak to všechno funguje
CM4
Systém Provisioner musí být nainstalován ve vlastní kabelové síti; Raspberry Pi, na kterém běží server, je připojeno k přepínači spolu s tolika zařízeními CM4, kolik může přepínač podporovat. Jakýkoli CM4 zapojený do této sítě bude detekován zřizovacím systémem a automaticky doplněn o firmware požadovaný uživatelem. Důvod pro vlastní kabelovou síť bude zřejmý, když uvážíte, že bude zajištěn jakýkoli CM4 zapojený do sítě, takže udržování sítě oddělené od jakékoli živé sítě je nezbytné, aby se zabránilo neúmyslnému přeprogramování zařízení.
ZMĚNY OBRÁZKU Desky CM 4 IO s CM 4 -> CM4 IO Desky s CM4
Použitím Raspberry Pi jako serveru je možné pro Provisioner používat kabelovou síť, ale stále umožňuje přístup k externím sítím pomocí bezdrátového připojení. To umožňuje snadné stahování obrázků na server, připravené na proces zřizování a umožňuje Raspberry Pi obsluhovat poskytovatele. web rozhraní. Lze stáhnout více obrázků; Provisioner uchovává databázi obrázků a usnadňuje výběr vhodného obrázku pro nastavení různých zařízení.
Když je CM4 připojen k síti a je zapnutý, pokusí se zavést systém, a jakmile vyzkoušíte jiné možnosti, dojde k pokusu o zavedení ze sítě. V tomto okamžiku systém DHCP (Provisioner Dynamic Host Configuration Protocol) reaguje na spouštěcí CM4 a poskytuje mu minimální zaváděcí obraz, který je stažen do CM4 a poté spuštěn jako root. Tento obrázek může naprogramovat vestavěnou kartu Multi-Media Card (eMMC) a spustit jakékoli požadované skripty podle pokynů poskytovatele.
Další podrobnosti
Moduly CM4 se dodávají se zaváděcí konfigurací, která se nejprve pokusí zavést z eMMC; pokud se to nezdaří, protože eMMC je prázdné, provede spouštění sítě před spuštěním prostředí (PXE). Takže u modulů CM4, které ještě nebyly zřízeny a mají prázdné eMMC, se ve výchozím nastavení provede spouštění sítě. Během spouštění ze sítě v zřizovací síti bude zřizovací server modulu CM4 přes síť předáván odlehčený obraz operačního systému (OS) utility (ve skutečnosti linuxové jádro a scriptexecute initramfs) a tento obraz zajišťuje zřizování.
CM 3 a CM 4s
Zařízení CM založená na konektoru SODIMM nelze zavést ze sítě, takže programování probíhá přes USB. Každé zařízení bude muset být připojeno k poskytovateli. Pokud potřebujete připojit více než 4 zařízení (počet USB portů na Raspberry Pi), lze použít USB hub. Použijte kvalitní kabely USB-A na Micro-USB, které se připojují z Raspberry Pi nebo rozbočovače k portu USB slave každé desky CMIO. Všechny desky CMIO budou také potřebovat napájení a propojka J4 USB slave by měla být nastavena na povolení
DŮLEŽITÉ
NEPŘIPOJUJTE ethernetový port Pi 4. Bezdrátové připojení se používá pro přístup ke správě web rozhraní.
Instalace
Následující pokyny byly správné v době vydání. Nejnovější pokyny k instalaci naleznete na stránce Provisioner GitHub.
Instalace Provisioner web aplikace na Raspberry Pi
VAROVÁNÍ
Ujistěte se, že eth0 se připojuje k ethernetovému přepínači, který má připojené pouze CM4 IO desky. Nepřipojujte eth0 ke své kancelářské/veřejné síti, jinak může „poskytovat“ další zařízení Raspberry Pi ve vaší síti. Pro připojení k místní síti použijte bezdrátové připojení Raspberry Pi.
Lite verze operačního systému Raspberry Pi se doporučuje jako základní operační systém, na který se má nainstalovat Provisioner. Pro jednoduchost použijte rpi-imager a aktivujte nabídku pokročilých nastavení (Ctrl-Shift-X) pro nastavení hesla, názvu hostitele a nastavení bezdrátové sítě. Jakmile je operační systém nainstalován na Raspberry Pi, budete muset nastavit systém Ethernet:
- Nakonfigurujte eth0 tak, aby měl statickou adresu internetového protokolu (IP) 172.20.0.1 v podsíti /16 (maska sítě 255.255.0.0) úpravou konfigurace DHCP:
- sudo nano /etc/dhcpcd.conf
- Přidejte do spodní části file:
rozhraní eth0
statická ip_address=172.20.0.1/16 - Restartujte, aby se změny projevily.
- Ujistěte se, že instalace OS je aktuální:
aktualizace sudo apt
sudo apt full-upgrade - Provisioner je dodáván jako hotový .deb file na stránce Provisioner GitHub. Stáhněte si nejnovější verzi z této stránky nebo pomocí wget a nainstalujte ji pomocí následujícího příkazu:
sudo apt install ./cmprovision4_*_all.deb - Nastavte web uživatelské jméno a heslo aplikace:
sudo /var/lib/cmprovision/artisan auth:create-user
Nyní máte přístup k web rozhraní Poskytovatele s a web prohlížeče pomocí bezdrátové IP adresy Raspberry Pi a uživatelského jména a hesla zadaného v předchozí části. Stačí zadat IP adresu do adresního řádku vašeho prohlížeče a stisknout Enter.
Používání
Při prvním připojení k poskytovateli web aplikace s vaším web prohlížeče uvidíte obrazovku Dashboard, která bude vypadat asi takto:
Tato vstupní stránka jednoduše poskytuje nějaké informace o nejnovější akci provedené poskytovatelem (napřampvýše, byl zřízen jeden CM4).
Nahrávání obrázků
První operací vyžadovanou při nastavování je načtení vašeho obrazu na server, odkud jej lze použít k zajištění vašich desek CM4. Klikněte na položku nabídky „Obrázky“ v horní části web a měli byste získat obrazovku podobnou té, která je zobrazena níže, se seznamem aktuálně nahraných obrázků (které budou zpočátku prázdné).
Chcete-li nahrát obrázek, vyberte tlačítko Přidat obrázek; uvidíte tuto obrazovku:
Obrázek musí být přístupný na zařízení, kde je web je spuštěn prohlížeč a v jednom ze zadaných formátů obrázků. Vyberte obrázek ze svého zařízení pomocí standardu file a klikněte na 'Nahrát'. To nyní zkopíruje obraz z vašeho počítače na server Provisioner běžící na Raspberry Pi. To může nějakou dobu trvat. Jakmile je obrázek nahrán, uvidíte jej na stránce Obrázky.
Přidání projektu
Nyní musíte vytvořit projekt. Můžete zadat libovolný počet projektů a každý může mít jiný obrázek, sadu skriptů nebo štítek. Aktivní projekt je ten, který se aktuálně používá pro zajišťování.
Kliknutím na položku nabídky „Projekty“ vyvolejte stránku Projekty. Následující example již má nastaven jeden projekt nazvaný 'Testovací projekt'.
Nyní klikněte na „Přidat projekt“ a vytvořte nový projekt
- Zadejte projektu vhodný název a poté z rozevíracího seznamu vyberte, který obrázek má tento projekt použít. Na tomto s můžete nastavit i řadu dalších parametrůtage, ale často postačí pouze obrázek.
- Pokud používáte verzi 1.5 nebo novější z Provisioneru, máte možnost ověřit, že se flashování dokončilo správně. Výběrem této možnosti se po blikání přečtou zpět data ze zařízení CM a potvrdí se, že odpovídají původnímu obrázku. To přidá čas navíc k zajišťování každého zařízení, množství přidaného času bude záviset na velikosti obrazu.
- Pokud vyberete firmware k instalaci (toto je volitelné), máte také možnost přizpůsobit tento firmware některými specifickými konfiguračními položkami, které budou začleněny do binárního souboru bootloaderu. Dostupné možnosti najdete na Raspberry Pi webmísto.
- Po úplném definování nového projektu klikněte na 'Uložit'; vrátíte se na stránku Projekty a zobrazí se nový projekt. Všimněte si, že v jeden okamžik může být aktivní pouze jeden projekt a můžete jej vybrat z tohoto seznamu.
Skripty
Opravdu užitečnou funkcí Provisioner je možnost spouštět skripty na bitové kopii, před nebo po instalaci. Ve výchozím nastavení jsou v Provisioner nainstalovány tři skripty a lze je vybrat při vytváření nového projektu. Jsou uvedeny na stránce Scripts
BývalýampPoužití skriptů může spočívat v přidání vlastních položek do souboru config.txt. Standardní skript Add dtoverlay=dwc2 to config.txt to provede pomocí následujícího kódu shellu:
Kliknutím na „Přidat skript“ přidáte vlastní úpravy:
Štítky
Poskytovatel má možnost vytisknout štítky pro zajišťované zařízení. Stránka Štítky zobrazuje všechny předdefinované štítky, které lze vybrat během procesu úprav projektu. Napřample, možná budete chtít vytisknout DataMatrix nebo kódy rychlé odezvy (QR) pro každou poskytovanou desku a tato funkce to velmi usnadňuje.
Klikněte na 'Přidat štítek' a zadejte svůj vlastní: 
Firmware
Provisioner poskytuje možnost určit, kterou verzi firmwaru bootloaderu chcete nainstalovat na CM4. Na stránce Firmware je seznam všech možných možností, ale ta nejnovější je obvykle nejlepší.
Chcete-li aktualizovat seznam nejnovějšími verzemi bootloaderu, klikněte na tlačítko 'Stáhnout nový firmware z githubu'.
Možné problémy
Zastaralý firmware bootloaderu
Pokud váš CM4 není detekován systémem Provisioner, když je zapojen, je možné, že firmware bootloaderu je zastaralý. Pamatujte, že všechna zařízení CM4 vyrobená od února 2021 mají z výroby nainstalovaný správný bootloader, takže k tomu dojde pouze u zařízení, která byla vyrobena před tímto datem.
Již naprogramované eMMC
Pokud modul CM4 již má boot filePokud je v eMMC z předchozího pokusu o zřízení, spustí se z eMMC a nedojde k zavedení sítě potřebné pro zřízení.
Pokud si přejete reprovisioning modulu CM4, budete potřebovat:
- Připojte kabel USB mezi zajišťovací server a port micro USB CM4 IO Board (označený jako „USB slave“).
- Umístěte propojku na CM4 IO Board (J2, 'Připevněte propojku pro zakázání spouštění eMMC').
To způsobí, že modul CM4 provede bootování z USB, v takovém případě zřizovací server přenese soubor files obslužného OS přes USB.
Po zavedení operačního systému nástroje se obrátí na zřizovací server přes Ethernet, aby obdržel další pokyny a stáhl další files (např. obraz OS, který má být zapsán do eMMC) jako obvykle. Kromě USB kabelu je tedy stále nutné připojení Ethernet.
Spanning Tree Protocol (STP) na spravovaných ethernetových přepínačích
Spouštění PXE nebude fungovat správně, pokud je na spravovaném přepínači Ethernet povoleno STP. To může být výchozí nastavení na některých přepínačích (např. Cisco), a pokud tomu tak je, bude nutné jej zakázat, aby proces zřizování fungoval správně.
Raspberry Pi je ochranná známka Raspberry Pi Foundation
Raspberry Pi Ltd
Dokumenty / zdroje
 |
Raspberry Pi Poskytování výpočetního modulu Raspberry Pi [pdfUživatelská příručka Poskytování výpočetního modulu Raspberry Pi, poskytování, výpočetního modulu Raspberry Pi, výpočetního modulu |