Осигуряване на Raspberry Pi Compute Module
Осигуряване на Raspberry Pi Compute Module (Версии 3 и 4)
Raspberry Pi Ltd
2022-07-19: githash: 94a2802-clean
Колофон
© 2020-2022 Raspberry Pi Ltd (по-рано Raspberry Pi (Trading) Ltd.)
Тази документация е лицензирана съгласно Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND). дата на компилация: 2022-07-19 версия компилация: githash: 94a2802-чист
Правна бележка за отказ от отговорност
ТЕХНИЧЕСКИ ДАННИ И ДАННИ ЗА НАДЕЖДНОСТ ЗА ПРОДУКТИ RASPBERRY PI (ВКЛЮЧИТЕЛНО ЛИСТОВЕ С ДАННИ), КАКТО СЕ МОДИФИЦИРАТ ОТ ВРЕМЕ НА ВРЕМЕ („РЕСУРСИ“) СЕ ПРЕДОСТАВЯТ ОТ RASPBERRY PI LTD („RPL“) „КАКТО Е“ И ВСЯКАКВИ ИЗРИЧНИ ИЛИ КОСВЕНИ ГАРАНЦИИ, ВКЛЮЧИТЕЛНО, НО НЕ ОГРАНИЧЕНО КЪМ, ПОДРАЗБИРАЩИТЕ СЕ ГАРАНЦИИ ЗА ПРОДАВАЕМОСТ И ПРИГОДНОСТ ЗА ОПРЕДЕЛЕНА ЦЕЛ СЕ ОТХВЪРЛЯТ. ДО МАКСИМАЛНАТА СТЕПЕН, ПОЗВОЛЕНА ОТ ПРИЛОЖИМОТО ЗАКОНОДАТЕЛСТВО, RPL НЕ НОСИ ОТГОВОРНОСТ ЗА НИКАКВИ ПРЕКИ, КОСЕНИ, СЛУЧАЙНИ, СПЕЦИАЛНИ, ПРИМЕРНИ ИЛИ ПОСЛЕДВАЩИ ЩЕТИ (ВКЛЮЧИТЕЛНО, НО НЕ ОГРАНИЧАВАЩО СЕ ДО, ПОЛУЧАВАНЕ НА ЗАМЕНЯЩИ СТОКИ ИЛИ УСЛУГИ). ICES; ЗАГУБА НА УПОТРЕБА, ДАННИ , OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THE RESOURCES, EVEN IF ADVISED OF THE POSSIBILITY НА ТАКАВА ЩЕТА.
RPL си запазва правото да прави подобрения, подобрения, корекции или каквито и да е други модификации на РЕСУРСИТЕ или продуктите, описани в тях, по всяко време и без допълнително известие. РЕСУРСИТЕ са предназначени за опитни потребители с подходящи нива на познания в областта на дизайна. Потребителите са изцяло отговорни за техния избор и използване на РЕСУРСИТЕ и всяко приложение на продуктите, описани в тях. Потребителят се съгласява да обезщети и предпази RPL от всички задължения, разходи, щети или други загуби, произтичащи от тяхното използване на РЕСУРСИ. RPL предоставя на потребителите разрешение да използват РЕСУРСИ единствено във връзка с продуктите Raspberry Pi. Всяка друга употреба на РЕСУРСИ е забранена. Не се предоставя лиценз за други права на интелектуална собственост или права на трета страна. ВИСОКОРИСКОВИ ДЕЙНОСТИ. Продуктите Raspberry Pi не са проектирани, произведени или предназначени за използване в опасни среди, изискващи безопасна работа, като например при експлоатацията на ядрени съоръжения, навигационни или комуникационни системи на самолети, контрол на въздушното движение, оръжейни системи или критични за безопасността приложения (включително поддържащи живота системи и други медицински устройства), при които повредата на продуктите може да доведе директно до смърт, лично нараняване или тежки физически или екологични щети („Дейности с висок риск“). RPL изрично отхвърля всякакви изрични или подразбиращи се гаранции за годност за дейности с висок риск и не поема отговорност за използване или включване на продукти на Raspberry Pi в дейности с висок риск. Продуктите Raspberry Pi се предоставят в съответствие със Стандартните условия на RPL. Предоставянето на РЕСУРСИ от RPL не разширява или по друг начин променя Стандартните условия на RPL, включително, но не само, отказите от отговорност и гаранциите, изразени в тях.
История на версиите на документа 
Обхват на документ
Този документ се отнася за следните продукти на Raspberry Pi:
Въведение
Доставчикът на CM е a web приложение, предназначено да направи програмирането на голям брой Raspberry Pi Compute Module (CM) устройства много по-лесно и по-бързо. Той е лесен за инсталиране и лесен за използване. Той предоставя интерфейс към база данни с изображения на ядрото, които могат да бъдат качени, заедно с възможността за използване на скриптове за персонализиране на различни части от инсталацията по време на процеса на флашване. Поддържа се също печат на етикети и актуализиране на фърмуера. Тази бяла книга предполага, че сървърът на Provisioner, софтуерна версия 1.5 или по-нова, работи на Raspberry Pi.
Как работи всичко
CM4
Системата Provisioner трябва да бъде инсталирана в собствена кабелна мрежа; Raspberry Pi, работещ със сървъра, е включен към комутатор, заедно с толкова много CM4 устройства, колкото комутаторът може да поддържа. Всеки CM4, включен в тази мрежа, ще бъде открит от системата за осигуряване и автоматично ще бъде флашнат с необходимия фърмуер на потребителя. Причината да имате собствена кабелна мрежа става ясна, когато вземете предвид, че всеки CM4, включен в мрежата, ще бъде осигурен, така че поддържането на мрежата отделно от всяка мрежа на живо е от съществено значение за предотвратяване на неволно препрограмиране на устройства.
ПРОМЕНИ НА ИЗОБРАЖЕНИЕТО CM 4 IO платки с CM 4 -> CM4 IO платки с CM4
Чрез използването на Raspberry Pi като сървър е възможно да се използва кабелна мрежа за Provisioner, но все още позволява достъп до външни мрежи чрез безжична връзка. Това позволява лесно изтегляне на изображения на сървъра, готови за процеса на осигуряване, и позволява на Raspberry Pi да обслужва Provisioner web интерфейс. Могат да се изтеглят множество изображения; доставчикът поддържа база данни с изображения и улеснява избора на подходящо изображение за настройка на различни устройства.
Когато CM4 е свързан към мрежата и е включен, той ще се опита да зареди и след като бъдат изпробвани други опции, се прави опит за зареждане по мрежата. В този момент системата Provisioner Dynamic Host Configuration Protocol (DHCP) отговаря на зареждащия CM4 и му предоставя минимално стартиращо изображение, което се изтегля в CM4, след което се стартира като root. Това изображение може да програмира вградената мултимедийна карта (eMMC) и да изпълнява всички необходими скриптове, както е указано от доставчика.
Повече подробности
CM4 модулите се доставят с конфигурация за зареждане, която първо ще се опита да зареди от eMMC; ако това не успее, защото eMMC е празен, той ще изпълни мрежово зареждане на средата за изпълнение на предварително стартиране (PXE). Така че с модули CM4, които все още не са осигурени и имат празен eMMC, по подразбиране ще се извърши мрежово зареждане. По време на мрежово зареждане на мрежа за осигуряване, изображение на лека помощна операционна система (ОС) (всъщност ядро на Linux и скрипт за изпълнение на initramfs) ще бъде обслужвано от сървъра за осигуряване към модула CM4 по мрежата и това изображение обработва осигуряването.
CM 3 и CM 4s
CM устройствата, базирани на SODIMM конектора, не могат да стартират по мрежата, така че програмирането се постига през USB. Всяко устройство ще трябва да бъде свързано към доставчика. Ако трябва да свържете повече от 4 устройства (броя на USB портовете на Raspberry Pi), може да се използва USB хъб. Използвайте USB-A към Micro-USB кабели с добро качество, свързвайки от Raspberry Pi или хъб към USB подчинен порт на всяка CMIO платка. Всички CMIO платки също ще се нуждаят от захранване и джъмперът за активиране на J4 USB подчинено зареждане трябва да бъде настроен да активира
ВАЖНО
НЕ свързвайте Ethernet порта на Pi 4. Безжичната връзка се използва за достъп до управлението web интерфейс.
Монтаж
Следните инструкции бяха правилни по време на издаването. Най-новите инструкции за инсталиране могат да бъдат намерени на страницата на Provisioner GitHub.
Инсталиране на Provisioner web приложение на Raspberry Pi
ПРЕДУПРЕЖДЕНИЕ
Уверете се, че eth0 се свързва към Ethernet комутатор, който има свързани само CM4 IO платки. Не свързвайте eth0 към вашата офис/публична мрежа, или това може да „осигури“ и други Raspberry Pi устройства във вашата мрежа. Използвайте безжичната връзка Raspberry Pi, за да се свържете с вашата локална мрежа.
Lite версията на Raspberry Pi OS се препоръчва като базова операционна система, на която да инсталирате Provisioner. За по-лесно използвайте rpi-imager и активирайте менюто за разширени настройки (Ctrl-Shift-X), за да настроите паролата, името на хоста и безжичните настройки. След като операционната система е инсталирана на Raspberry Pi, ще трябва да настроите Ethernet системата:
- Конфигурирайте eth0 да има статичен адрес на интернет протокол (IP) 172.20.0.1 в подмрежа /16 (мрежова маска 255.255.0.0), като редактирате DHCP конфигурацията:
- sudo nano /etc/dhcpcd.conf
- Добавете към дъното на file:
интерфейс eth0
статичен ip_адрес=172.20.0.1/16 - Рестартирайте, за да позволите на промените да влязат в сила.
- Уверете се, че инсталацията на ОС е актуална:
sudo apt актуализация
sudo apt пълен ъпгрейд - Provisioner се доставя като готов .deb file на страницата на Provisioner GitHub. Изтеглете най-новата версия от тази страница или с помощта на wget и я инсталирайте със следната команда:
sudo apt install ./cmprovision4_*_all.deb - Задайте web потребителско име и парола за приложението:
sudo /var/lib/cmprovision/artisan auth:create-user
Вече имате достъп до web интерфейс на Доставчика с a web браузър, използвайки безжичния IP адрес на Raspberry Pi и потребителското име и паролата, въведени в предишния раздел. Просто въведете IP адреса в адресната лента на вашия браузър и натиснете Enter.
Използване
Когато за първи път се свържете с Provisioner web приложение с вашето web браузър ще видите екрана на таблото за управление, който ще изглежда по следния начин:
Тази целева страница просто дава информация за последното действие, извършено от доставчика (в прampпо-горе е осигурен единичен CM4).
Качване на изображения
Първата операция, необходима при настройката, е да заредите вашето изображение на сървъра, откъдето то може да се използва за осигуряване на вашите CM4 платки. Щракнете върху елемента от менюто „Изображения“ в горната част на web и трябва да получите екран, подобен на показания по-долу, показващ списък с текущо качени изображения (който първоначално ще бъде празен).
Изберете бутона Добавяне на изображение, за да качите изображение; ще видите този екран:
Изображението трябва да е достъпно на устройството, където web браузърът работи и в един от посочените формати на изображения. Изберете изображението от вашата машина, като използвате стандарта file и щракнете върху „Качване“. Това вече ще копира изображението от вашето устройство към сървъра на Provisioner, работещ на Raspberry Pi. Това може да отнеме известно време. След като изображението бъде качено, ще го видите на страницата с изображения.
Добавяне на проект
Сега трябва да създадете проект. Можете да посочите произволен брой проекти и всеки може да има различно изображение, набор от скриптове или етикет. Активният проект е този, който в момента се използва за осигуряване.
Кликнете върху елемента от менюто „Проекти“, за да изведете страницата с проекти. Следният примерample вече има един настроен проект, наречен „Тестов проект“.
Сега щракнете върху „Добавяне на проект“, за да настроите нов проект
- Дайте на проекта подходящо име, след което изберете кое изображение искате да използва този проект от падащия списък. Можете също да зададете редица други параметри в този stage, но често само изображението е достатъчно.
- Ако използвате v1.5 или по-нова версия на Provisioner, тогава имате възможност да проверите дали мигането е завършило правилно. Избирането на това ще прочете обратно данните от CM устройството след мигане и ще потвърди, че съответства на оригиналното изображение. Това ще добави допълнително време към осигуряването на всяко устройство, количеството добавено време ще зависи от размера на изображението.
- Ако изберете фърмуера за инсталиране (това не е задължително), вие също така имате възможността да персонализирате този фърмуер с някои специфични записи за конфигурация, които ще бъдат обединени в двоичния файл на буутлоудъра. Наличните опции могат да бъдат намерени на Raspberry Pi webсайт.
- Щракнете върху „Запазване“, когато сте дефинирали напълно новия си проект; ще се върнете на страницата Проекти и новият проект ще бъде посочен. Имайте предвид, че само един проект може да бъде активен във всеки един момент и можете да го изберете от този списък.
Скриптове
Наистина полезна функция на Provisioner е възможността за стартиране на скриптове върху изображението, преди или след инсталацията. Три скрипта са инсталирани по подразбиране в Provisioner и могат да бъдат избрани при създаване на нов проект. Те са изброени на страницата със скриптове
БившampИзползването на скриптове може да е за добавяне на потребителски записи към config.txt. Стандартният скрипт Add dtoverlay=dwc2 към config.txt прави това, използвайки следния шел код:
Кликнете върху „Добавяне на скрипт“, за да добавите свои собствени персонализации:
Етикети
Доставчикът има възможност да разпечатва етикети за устройството, което се предоставя. Страницата Етикети показва всички предварително дефинирани етикети, които могат да бъдат избрани по време на процеса на редактиране на проекта. Напримерample, може да пожелаете да отпечатате DataMatrix или кодове за бърз отговор (QR) за всяка предоставена платка и тази функция прави това много лесно.
Кликнете върху „Добавяне на етикет“, за да посочите свой собствен: 
фърмуер
Provisioner предоставя възможността да посочите коя версия на фърмуера на зареждащия механизъм искате да инсталирате на CM4. На страницата на фърмуера има списък с всички възможни опции, но най-новата обикновено е най-добрата.
За да актуализирате списъка с най-новите версии на буутлоудъра, щракнете върху бутона „Изтегляне на нов фърмуер от github“.
Възможни проблеми
Остарял фърмуер на буутлоудъра
Ако вашият CM4 не бъде разпознат от системата Provisioner, когато е включен, възможно е фърмуерът на буутлоудъра да е остарял. Обърнете внимание, че всички устройства CM4, произведени след февруари 2021 г., имат правилния буутлоудър, инсталиран фабрично, така че това ще се случи само с устройства, които са произведени преди тази дата.
Вече програмиран eMMC
Ако модулът CM4 вече има зареждане files в eMMC от предишен опит за осигуряване, тогава той ще се стартира от eMMC и мрежовото зареждане, необходимо за осигуряване, няма да се осъществи.
Ако желаете да конфигурирате отново CM4 модул, ще трябва да:
- Свържете USB кабел между сървъра за осигуряване и микро USB порта на CM4 IO Board (означен като „USB slave“).
- Поставете джъмпер на платката CM4 IO (J2, „Поставете джъмпер, за да деактивирате стартирането на eMMC“).
Това ще накара модула CM4 да извърши USB зареждане, в който случай сървърът за осигуряване ще прехвърли files на помощната операционна система през USB.
След като операционната система на помощната програма се стартира, тя ще се свърже със сървъра за осигуряване през Ethernet, за да получи допълнителни инструкции и да изтегли допълнителни files (напр. изображението на операционната система, което трябва да се запише в eMMC), както обикновено. Така че все още е необходима Ethernet връзка в допълнение към USB кабела.
Spanning Tree Protocol (STP) на управлявани Ethernet комутатори
PXE зареждането няма да работи правилно, ако STP е активиран на управляван Ethernet комутатор. Това може да е по подразбиране за някои комутатори (напр. Cisco) и ако случаят е такъв, ще трябва да бъде деактивиран, за да може процесът на осигуряване да работи правилно.
Raspberry Pi е търговска марка на Raspberry Pi Foundation
Raspberry Pi Ltd
Документи / Ресурси
 |
Raspberry Pi Осигуряване на Raspberry Pi Compute Module [pdf] Ръководство за потребителя Осигуряване на Raspberry Pi Compute Module, Осигуряване, Raspberry Pi Compute Module, Compute Module |