Pagbibigay ng Raspberry Pi Compute Module
Pagbibigay ng Raspberry Pi Compute Module (Bersyon 3 at 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Colophon
© 2020-2022 Raspberry Pi Ltd (dating Raspberry Pi (Trading) Ltd.)
Ang dokumentasyong ito ay lisensyado sa ilalim ng Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). build-date: 2022-07-19 build-version: githash: 94a2802-clean
Paunawa sa legal na disclaimer
TEKNIKAL AT PAGKAAASAHAN NA DATA PARA SA MGA PRODUKTO NG RASPBERRY PI (KASAMA ANG MGA DATASHEETS) NA BINABAGO PAminsan-minsan (“MGA YAMAN”) AY IBINIBIGAY NG RASPBERRY PI LTD (“RPL”) “AS IS” AT ANUMANG TAHAS O IPINAHIWATIG NA WARRANTY, HINDI KASAMA, SA, ANG IPINAHIWATIG NA WARRANTY NG KALIGTASAN AT KAANGKUPAN PARA SA ISANG PARTIKULAR NA LAYUNIN AY ITINATAWALA. HANGGANG SA MAXIMUM NA PINAHIHINTULUTAN NG NAAANGKOP NA BATAS SA KAHIT KAHIT WALANG PANANAGUTAN ANG RPL PARA SA ANUMANG DIREKTA, DI DIREKTA, NAGSASANA, ESPESYAL, HALIMBAWA, O KINAHIHINUNGANG MGA PINSALA (KASAMA, PERO HINDI LIMITADO SA, PAGBIBIGAY NG KAPALIT NA MGA SERBISYO NG PAGGAMIT; , O MGA KITA; O PAGTATAGAL SA NEGOSYO) GAANO MAN ANG SANHI AT SA ANUMANG TEORYANG PANANAGUTAN, SA KONTRATA MAN, MAHIGPIT NA PANANAGUTAN, O TORT (KASAMA ANG PAGPAPABAYA O IBA) NA NAGMULA SA ANUMANG PARAAN NG PAGGAMIT NG MGA RESOURCES, NG GANITONG PINSALA.
Inilalaan ng RPL ang karapatan na gumawa ng anumang mga pagpapahusay, pagpapahusay, pagwawasto o anumang iba pang mga pagbabago sa RESOURCES o anumang mga produktong inilarawan sa mga ito anumang oras at nang walang karagdagang abiso. Ang RESOURCES ay inilaan para sa mga bihasang user na may angkop na antas ng kaalaman sa disenyo. Ang mga gumagamit ay tanging responsable para sa kanilang pagpili at paggamit ng MGA RESOURCES at anumang aplikasyon ng mga produktong inilarawan sa kanila. Sumasang-ayon ang user na magbayad ng danyos at panatilihing hindi nakakapinsala ang RPL laban sa lahat ng pananagutan, gastos, pinsala o iba pang pagkalugi na nagmumula sa kanilang paggamit ng RESOURCES. Binibigyan ng RPL ang mga user ng pahintulot na gamitin ang RESOURCES kasabay lamang ng mga produktong Raspberry Pi. Ang lahat ng iba pang paggamit ng RESOURCES ay ipinagbabawal. Walang lisensya ang ibinibigay sa anumang ibang RPL o iba pang third party na karapatan sa intelektwal na ari-arian. MGA AKTIBIDAD NA MATAAS NA PANGANIB. Ang mga produkto ng Raspberry Pi ay hindi idinisenyo, ginawa o inilaan para gamitin sa mga mapanganib na kapaligiran na nangangailangan ng hindi ligtas na pagganap, tulad ng sa pagpapatakbo ng mga pasilidad ng nuklear, nabigasyon ng sasakyang panghimpapawid o mga sistema ng komunikasyon, kontrol sa trapiko sa himpapawid, mga sistema ng armas o mga aplikasyong kritikal sa kaligtasan (kabilang ang suporta sa buhay. system at iba pang mga medikal na aparato), kung saan ang pagkabigo ng mga produkto ay maaaring direktang humantong sa kamatayan, personal na pinsala o malubhang pisikal o pinsala sa kapaligiran ("Mga Aktibidad na Mataas na Panganib"). Partikular na itinatanggi ng RPL ang anumang ipinahayag o ipinahiwatig na warranty ng pagiging angkop para sa Mga Aktibidad na Mataas ang Panganib at hindi tumatanggap ng pananagutan para sa paggamit o pagsasama ng mga produkto ng Raspberry Pi sa Mga Aktibidad na Mataas ang Panganib. Ang mga produktong Raspberry Pi ay ibinibigay alinsunod sa Mga Karaniwang Tuntunin ng RPL. Ang probisyon ng RPL ng RESOURCES ay hindi nagpapalawak o kung hindi man ay nagbabago sa Mga Karaniwang Tuntunin ng RPL kabilang ngunit hindi limitado sa mga disclaimer at warranty na ipinahayag sa kanila.
Kasaysayan ng bersyon ng dokumento 
Saklaw ng document
Nalalapat ang dokumentong ito sa mga sumusunod na produkto ng Raspberry Pi:
Panimula
Ang CM Provisioner ay isang web application na idinisenyo upang gawing mas madali at mas mabilis ang programming ng isang malaking bilang ng mga Raspberry Pi Compute Module (CM). Ito ay simpleng i-install at madaling gamitin. Nagbibigay ito ng interface sa isang database ng mga kernel na imahe na maaaring i-upload, kasama ang kakayahang gumamit ng mga script upang i-customize ang iba't ibang bahagi ng pag-install sa panahon ng proseso ng flashing. Sinusuportahan din ang pag-print ng label at pag-update ng firmware. Ipinapalagay ng whitepaper na ito na ang server ng Provisioner, bersyon ng software 1.5 o mas bago, ay tumatakbo sa isang Raspberry Pi.
Paano gumagana ang lahat
CM4
Ang sistema ng Provisioner ay kailangang mai-install sa sarili nitong wired network; ang Raspberry Pi na nagpapatakbo sa server ay nakasaksak sa isang switch, kasama ng maraming CM4 na device na maaaring suportahan ng switch. Anumang CM4 na nakasaksak sa network na ito ay matutukoy ng sistema ng pagbibigay at awtomatikong mag-flash gamit ang kinakailangang firmware ng user. Ang dahilan ng pagkakaroon ng sarili nitong wired network ay nagiging malinaw kapag isinasaalang-alang mo na ang anumang CM4 na nakasaksak sa network ay ibibigay, kaya ang pagpapanatiling hiwalay sa network mula sa anumang live na network ay mahalaga upang maiwasan ang hindi sinasadyang reprogramming ng mga device.
NAGBABAGO ang IMAGE ng mga CM 4 IO board na may CM 4 -> Mga CM4 IO Board na may CM4
Sa pamamagitan ng paggamit ng Raspberry Pi bilang server, posibleng gumamit ng wired networking para sa Provisioner ngunit pinapayagan pa rin ang access sa mga external na network gamit ang wireless na koneksyon. Nagbibigay-daan ito sa madaling pag-download ng mga larawan sa server, handa para sa proseso ng pagbibigay, at pinapayagan ang Raspberry Pi na ihatid ang Provisioner web interface. Maaaring ma-download ang maramihang mga larawan; ang Provisioner ay nagpapanatili ng isang database ng mga larawan at ginagawang madali ang pagpili ng naaangkop na larawan para sa pag-set up ng iba't ibang mga device.
Kapag ang isang CM4 ay naka-attach sa network at pinalakas, susubukan nitong mag-boot, at kapag nasubukan na ang iba pang mga opsyon, sinusubukan ang network booting. Sa puntong ito ang Provisioner Dynamic Host Configuration Protocol (DHCP) system ay tumutugon sa booting CM4 at binibigyan ito ng kaunting bootable na imahe na na-download sa CM4 pagkatapos ay tumakbo bilang root. Maaaring i-program ng larawang ito ang naka-embed na Multi-Media Card (eMMC) at magpatakbo ng anumang kinakailangang script, gaya ng itinagubilin ng Provisioner.
Higit pang mga detalye
Ipinapadala ang mga module ng CM4 na may configuration ng boot na susubukan munang mag-boot mula sa eMMC; kung nabigo iyon dahil walang laman ang eMMC, magsasagawa ito ng preboot execution environment (PXE) network boot. Kaya, sa mga module ng CM4 na hindi pa na-provision, at may walang laman na eMMC, isang network boot ang isasagawa bilang default. Sa panahon ng network boot sa isang provisioning network, ang isang magaan na utility operating system (OS) na imahe (talagang isang Linux kernel at isang scriptexecute initramfs) ay ihahatid ng provisioning server sa CM4 module sa network, at ang larawang ito ang humahawak sa provisioning.
CM 3 at CM 4s
Ang mga CM device na nakabatay sa SODIMM connector ay hindi makakapag-boot ng network, kaya ang programming ay nakakamit sa USB. Ang bawat device ay kailangang konektado sa Provisioner. Kung kailangan mong magkonekta ng higit sa 4 na device (ang bilang ng mga USB port sa Raspberry Pi), maaaring gumamit ng USB hub. Gumamit ng magandang kalidad ng USB-A sa mga Micro-USB cable, na kumukonekta mula sa Raspberry Pi o hub sa USB slave port ng bawat CMIO board. Ang lahat ng CMIO boards ay mangangailangan din ng power supply, at ang J4 USB slave boot enable jumper ay dapat itakda upang paganahin
MAHALAGA
HUWAG ikonekta ang Ethernet port ng Pi 4. Ginagamit ang wireless na koneksyon upang ma-access ang pamamahala web interface.
Pag-install
Ang mga sumusunod na tagubilin ay tama sa oras ng isyu. Ang pinakahuling mga tagubilin sa pag-install ay matatagpuan sa pahina ng Provisioner GitHub.
Pag-install ng Provisioner web application sa isang Raspberry Pi
BABALA
Tiyaking kumokonekta ang eth0 sa isang Ethernet switch na tanging ang CM4 IO Boards ang nakakonekta. Huwag ikonekta ang eth0 sa iyong opisina/pampublikong network, o maaari itong 'magbigay' ng iba pang mga Raspberry Pi device sa iyong network. Gamitin ang wireless na koneksyon ng Raspberry Pi upang kumonekta sa iyong lokal na network.
Ang Lite na bersyon ng Raspberry Pi OS ay inirerekomenda bilang base OS kung saan i-install ang Provisioner. Para sa pagiging simple gumamit ng rpi-imager, at i-activate ang advanced na menu ng mga setting (Ctrl-Shift-X) upang i-set up ang password, hostname, at mga wireless na setting. Kapag na-install na ang OS sa Raspberry Pi, kakailanganin mong i-set up ang Ethernet system:
- I-configure ang eth0 upang magkaroon ng static na Internet Protocol (IP) address na 172.20.0.1 sa loob ng /16 subnet (netmask 255.255.0.0) sa pamamagitan ng pag-edit sa configuration ng DHCP:
- sudo nano /etc/dhcpcd.conf
- Idagdag sa ibaba ng file:
interface eth0
static na ip_address=172.20.0.1/16 - I-reboot upang payagan ang mga pagbabago na magkabisa.
- Tiyaking napapanahon ang pag-install ng OS:
sudo apt update
sudo apt ganap na-upgrade - Ang Provisioner ay ibinibigay bilang isang handa na .deb file sa pahina ng Provisioner GitHub. I-download ang pinakabagong bersyon mula sa pahinang iyon o gamit ang wget, at i-install ito gamit ang sumusunod na command:
sudo apt install ./cmprovision4_*_all.deb - Itakda ang web username at password ng application:
sudo /var/lib/cmprovision/artisan auth:create-user
Maaari mo na ngayong i-access ang web interface ng Provisioner na may a web browser gamit ang Raspberry Pi wireless IP address at ang username at password na inilagay sa nakaraang seksyon. Ipasok lamang ang IP address sa address bar ng iyong browser at pindutin ang Enter.
Paggamit
Noong una kang kumonekta sa Provisioner web aplikasyon sa iyong web browser makikita mo ang screen ng Dashboard, na magiging ganito ang hitsura:
Ang landing page na ito ay nagbibigay lamang ng ilang impormasyon sa pinakabagong aksyon na ginawa ng Tagapagbigay (sa halampsa itaas, isang solong CM4 ang na-provision).
Pag-upload ng mga larawan
Ang unang operasyon na kinakailangan kapag nagse-set up ay ang pag-load ng iyong larawan sa server, mula sa kung saan ito magagamit upang ibigay ang iyong mga CM4 board. I-click ang menu item na 'Mga Larawan' sa tuktok ng web page at dapat kang makakuha ng screen na katulad ng ipinapakita sa ibaba, na nagpapakita ng listahan ng mga kasalukuyang na-upload na larawan (na sa simula ay walang laman).
Piliin ang button na Magdagdag ng Larawan upang mag-upload ng larawan; makikita mo ang screen na ito:
Kailangang ma-access ang larawan sa device kung saan ang web tumatakbo ang browser, at sa isa sa mga tinukoy na format ng larawan. Piliin ang larawan mula sa iyong makina gamit ang pamantayan file dialog, at i-click ang 'I-upload'. Kokopyahin na nito ang imahe mula sa iyong makina patungo sa server ng Provisioner na tumatakbo sa Raspberry Pi. Maaaring tumagal ito ng ilang oras. Kapag na-upload na ang larawan, makikita mo ito sa pahina ng Mga Larawan.
Pagdaragdag ng proyekto
Ngayon ay kailangan mong lumikha ng isang proyekto. Maaari mong tukuyin ang anumang bilang ng mga proyekto, at ang bawat isa ay maaaring magkaroon ng ibang larawan, hanay ng mga script, o label. Ang aktibong proyekto ay ang kasalukuyang ginagamit para sa provisioning.
Mag-click sa menu item na 'Mga Proyekto' upang ilabas ang pahina ng Mga Proyekto. Ang sumusunod na exampMayroon nang isang proyekto, na tinatawag na 'Test project', na naka-set up.
Ngayon mag-click sa 'Magdagdag ng proyekto' upang mag-set up ng bagong proyekto
- Bigyan ang proyekto ng angkop na pangalan, pagkatapos ay piliin kung aling larawan ang nais mong gamitin ng proyektong ito mula sa drop-down na listahan. Maaari ka ring magtakda ng ilang iba pang mga parameter sa s na itotage, ngunit madalas na ang imahe lamang ay sapat na.
- Kung gumagamit ka ng v1.5 o mas bago ng Provisioner, may opsyon kang i-verify na nakumpleto nang tama ang flashing. Kapag pinili ito, babasahin muli ang data mula sa CM device pagkatapos mag-flash, at makumpirma na tumutugma ito sa orihinal na larawan. Magdaragdag ito ng dagdag na oras sa provisioning ng bawat device, ang dami ng oras na idinagdag ay depende sa laki ng larawan.
- Kung pipiliin mo ang firmware na i-install (ito ay opsyonal), mayroon ka ring kakayahang i-customize ang firmware na iyon gamit ang ilang partikular na mga entry sa configuration na isasama sa binary ng bootloader. Ang mga magagamit na opsyon ay matatagpuan sa Raspberry Pi website.
- I-click ang 'I-save' kapag ganap mong natukoy ang iyong bagong proyekto; babalik ka sa pahina ng Mga Proyekto, at ililista ang bagong proyekto. Tandaan na isang proyekto lamang ang maaaring maging aktibo sa anumang oras, at maaari mo itong piliin mula sa listahang ito.
Mga script
Ang isang talagang kapaki-pakinabang na tampok ng Provisioner ay ang kakayahang magpatakbo ng mga script sa larawan, bago o pagkatapos ng pag-install. Tatlong script ang naka-install bilang default sa Provisioner, at maaaring mapili kapag gumagawa ng bagong proyekto. Nakalista ang mga ito sa Scriptspage
Isang datingampAng paggamit ng mga script ay maaaring magdagdag ng mga custom na entry sa config.txt. Ginagawa ito ng karaniwang script na Add dtoverlay=dwc2 sa config.txt, gamit ang sumusunod na shell code:
Mag-click sa 'Magdagdag ng script' upang idagdag ang iyong sariling mga pagpapasadya:
Mga label
Ang Provisioner ay may pasilidad na mag-print ng mga label para sa device na ibinibigay. Ipinapakita ng pahina ng Mga Label ang lahat ng paunang natukoy na mga label na maaaring mapili sa panahon ng proseso ng pag-edit ng proyekto. Para kay exampKaya, maaari mong hilingin na mag-print ng DataMatrix o quick response (QR) code para sa bawat board na ibinigay, at ang feature na ito ay napakadali.
Mag-click sa 'Magdagdag ng label' upang tukuyin ang iyong sarili: 
Firmware
Nagbibigay ang Provisioner ng kakayahang tukuyin kung aling bersyon ng firmware ng bootloader ang gusto mong i-install sa CM4. Sa pahina ng Firmware mayroong isang listahan ng lahat ng posibleng mga opsyon, ngunit ang pinakabago ay karaniwang ang pinakamahusay.
Upang i-update ang listahan sa mga pinakabagong bersyon ng bootloader, mag-click sa pindutang 'Mag-download ng bagong firmware mula sa github'.
Mga posibleng problema
Luma na ang bootloader firmware
Kung hindi na-detect ng Provisioner system ang iyong CM4 kapag nakasaksak ito, posibleng luma na ang firmware ng bootloader. Tandaan na ang lahat ng CM4 device na ginawa mula noong Pebrero 2021 ay may tamang bootloader na naka-install sa factory, kaya ito ay mangyayari lamang sa mga device na ginawa bago ang petsang iyon.
Naka-program na ang eMMC
Kung ang CM4 module ay mayroon nang boot files sa eMMC mula sa isang nakaraang pagtatangka sa provisioning pagkatapos ay magbo-boot ito mula sa eMMC at ang network boot na kinakailangan para sa provisioning ay hindi magaganap.
Kung gusto mong muling magbigay ng CM4 module, kakailanganin mong:
- Mag-attach ng USB cable sa pagitan ng provisioning server at ng micro USB port ng CM4 IO Board (na may label na 'USB slave').
- Maglagay ng jumper sa CM4 IO Board (J2, 'Fit jumper to disable eMMC boot').
Magiging sanhi ito ng CM4 module na magsagawa ng USB boot, kung saan ililipat ng provisioning server ang files ng utility OS sa USB.
Pagkatapos mag-boot ang utility OS, makikipag-ugnayan ito sa provisioning server sa Ethernet para makatanggap ng karagdagang mga tagubilin, at mag-download ng karagdagang files (hal. ang OS image na isusulat sa eMMC) gaya ng dati. Kaya, isang koneksyon sa Ethernet bilang karagdagan sa USB cable ay kinakailangan pa rin.
Spanning Tree Protocol (STP) sa mga pinamamahalaang Ethernet switch
Ang PXE booting ay hindi gagana nang tama kung ang STP ay pinagana sa isang pinamamahalaang Ethernet switch. Maaaring ito ang default sa ilang switch (hal. Cisco), at kung iyon ang kaso, kakailanganin itong i-disable para gumana nang tama ang proseso ng provisioning.
Ang Raspberry Pi ay isang trademark ng Raspberry Pi Foundation
Raspberry Pi Ltd
Mga Dokumento / Mga Mapagkukunan
 |
Raspberry Pi na nagbibigay ng Raspberry Pi Compute Module [pdf] Gabay sa Gumagamit Pagbibigay ng Raspberry Pi Compute Module, Provisioning, ang Raspberry Pi Compute Module, Compute Module |