配置 Raspberry Pi 計算模塊
配置 Raspberry Pi 計算模塊（版本 3 和 4）
樹莓派有限公司
2022-07-19: githash: 94a2802-clean
版畫
© 2020-2022 Raspberry Pi Ltd（原 Raspberry Pi（貿易）有限公司）
本文檔根據 Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND) 獲得許可。 構建日期：2022-07-19 構建版本：githash：94a2802-clean
法律免責聲明
不時修改的 RASPBERRY PI 產品（包括數據表）的技術和可靠性數據（“資源”）由 RASPBERRY PI LTD（“RPL”）“按原樣”提供，並提供任何明示或暗示的保證，包括但不限於至，對適銷性和特定用途適用性的默示保證不予承擔。 在適用法律允許的最大範圍內，在任何情況下，RPL 均不對任何直接、間接、附帶、特殊、懲戒性或後果性損害（包括但不限於採購替代商品或服務；使用、數據丟失）承擔責任。或利潤；或業務中斷），無論是何種原因，基於任何責任理論，無論是合同責任、嚴格責任還是侵權行為（包括疏忽或其他），均因使用資源而產生，即使已被告知這種可能性此類損害。
RPL 保留隨時對資源或其中描述的任何產品進行任何增強、改進、更正或任何其他修改的權利，恕不另行通知。 這些資源適用於具有適當設計知識水平的熟練用戶。 用戶對資源的選擇和使用以及其中描述的產品的任何應用承擔全部責任。 用戶同意賠償 RPL 並使其免受因使用資源而產生的所有責任、費用、損害或其他損失。 RPL 授予用戶僅將資源與 Raspberry Pi 產品結合使用的權限。 禁止將資源用於任何其他用途。 未向任何其他 RPL 或其他第三方知識產權授予任何許可。 高風險活動。 Raspberry Pi 產品並非設計、製造或旨在用於需要故障安全性能的危險環境，例如核設施、飛機導航或通信系統、空中交通管制、武器系統或安全關鍵應用（包括生命支持）的運行系統和其他醫療設備），其中產品故障可能直接導致死亡、人身傷害或嚴重的身體或環境損害（“高風險活動”）。 RPL 特別聲明不對高風險活動的適用性做出任何明示或暗示的保證，並且不承擔在高風險活動中使用或包含 Raspberry Pi 產品的任何責任。 Raspberry Pi 產品按照 RPL 的標準條款提供。 RPL 提供的資源不會擴展或以其他方式修改 RPL 的標準條款，包括但不限於其中表達的免責聲明和保證。
文檔版本歷史 
文檔範圍蒙特
本文檔適用於以下樹莓派產品：
介紹
CM 配置器是 web 該應用程序旨在使大量 Raspberry Pi 計算模塊 (CM) 設備的編程更加輕鬆快捷。 它安裝簡單，使用簡單。 它提供了一個可上傳的內核映像數據庫的接口，以及在刷新過程中使用腳本自定義安裝各個部分的能力。 還支持標籤打印和固件更新。 本白皮書假設 Provisioner 服務器（軟件版本 1.5 或更高版本）在 Raspberry Pi 上運行。
這一切是如何運作的
CM4
Provisioner系統需要安裝在自己的有線網絡上； 運行服務器的 Raspberry Pi 以及交換機可以支持的盡可能多的 CM4 設備已插入交換機。 任何插入該網絡的 CM4 都會被配置系統檢測到，並自動刷新用戶所需的固件。 當您考慮到將配置任何插入網絡的 CM4 時，擁有自己的有線網絡的原因就很清楚了，因此將網絡與任何實時網絡分開對於防止設備意外重新編程至關重要。
圖像更改 帶有 CM 4 的 CM 4 IO 板 -> 帶有 CM4 的 CM4 IO 板
通過使用 Raspberry Pi 作為服務器，Provisioner 可以使用有線網絡，但仍然允許使用無線連接訪問外部網絡。 這樣可以輕鬆地將圖像下載到服務器，為配置過程做好準備，並允許 Raspberry Pi 為 Provisioner 提供服務 web 界面。 可以下載多張圖片； Provisioner 保留映像數據庫，讓您可以輕鬆選擇適當的映像來設置不同的設備。
當 CM4 連接到網絡並通電時，它將嘗試啟動，一旦嘗試了其他選項，就會嘗試網絡啟動。 此時，Provisioner 動態主機配置協議 (DHCP) 系統響應啟動 CM4 並為其提供最小可啟動映像，該映像將下載到 CM4，然後以 root 身份運行。 該映像可以按照配置者的指示對嵌入式多媒體卡 (eMMC) 進行編程並運行任何所需的腳本。
更多詳情
CM4 模塊附帶啟動配置，將首先嘗試從 eMMC 啟動； 如果由於 eMMC 為空而失敗，它將執行預啟動執行環境 (PXE) 網絡啟動。 因此，對於尚未配置且具有空 eMMC 的 CM4 模塊，將默認執行網絡引導。 在配置網絡上進行網絡啟動期間，配置服務器將通過網絡向 CM4 模塊提供輕量級實用操作系統 (OS) 映像（實際上是 Linux 內核和 scriptexecute initramfs），並且該映像將處理配置。
CM 3 和 CM 4s
基於SODIMM連接器的CM設備無法網絡啟動，因此編程是通過USB實現的。 每個設備都需要連接到 Provisioner。 如果需要連接超過 4 個設備（Raspberry Pi 上的 USB 端口數量），可以使用 USB 集線器。 使用優質 USB-A 轉 Micro-USB 電纜，從 Raspberry Pi 或集線器連接到每個 CMIO 板的 USB 從屬端口。 所有 CMIO 板還需要電源，並且 J4 USB 從屬引導啟用跳線應設置為啟用
重要的
請勿連接 Pi 4 的以太網端口。無線連接用於訪問管理 web 介面.
安裝
以下說明在發佈時是正確的。 最新的安裝說明可以在 Provisioner GitHub 頁面上找到。
安裝配置器 web 樹莓派上的應用
警告
確保 eth0 連接到僅連接了 CM4 IO 板的以太網交換機。 不要將 eth0 連接到您的辦公室/公共網絡，否則它也可能會在您的網絡中“配置”其他 Raspberry Pi 設備。 使用 Raspberry Pi 無線連接連接到您的本地網絡。
建議將 Raspberry Pi OS 的 Lite 版本作為安裝 Provisioner 的基本操作系統。 為簡單起見，請使用 rpi-imager，並激活高級設置菜單 (Ctrl-Shift-X) 來設置密碼、主機名和無線設置。 在 Raspberry Pi 上安裝操作系統後，您將需要設置以太網系統：
- 通過編輯 DHCP 配置，將 eth0 配置為在 /172.20.0.1 子網（網絡掩碼 16）內具有靜態 Internet 協議 (IP) 地址 255.255.0.0：
- 須藤奈米 /etc/dhcpcd.conf
- 添加到底部 file:
接口eth0
靜態IP位址=172.20.0.1/16 - 重新啟動以使更改生效。
- 確保操作系統安裝是最新的：
須藤apt更新
sudo apt全面升級 - Provisioner 以現成的 .deb 形式提供 file 在 Provisioner GitHub 頁面上。 從該頁面或使用 wget 下載最新版本，然後使用以下命令安裝：
sudo apt install ./cmprovision4_*_all.deb - 設定 web 應用程序用戶名和密碼：
sudo /var/lib/cmprovision/artisan auth:創建用戶
您現在可以訪問 web Provisioner 的接口 web 使用 Raspberry Pi 無線 IP 地址以及上一節中輸入的用戶名和密碼的瀏覽器。 只需在瀏覽器地址欄中輸入 IP 地址，然後按 Enter 鍵即可。
用法
當您第一次連接到 Provisioner 時 web 與您的申請 web 瀏覽器中，您將看到儀表板屏幕，如下所示：
此登陸頁面僅提供有關配置者執行的最新操作的一些信息（在前amp在上面，已配置了單個 CM4）。
上傳圖片
設置時所需的第一個操作是將映像加載到服務器，從那裡它可用於配置 CM4 板。 單擊頂部的“圖像”菜單項 web 頁面，您應該會看到類似於下圖所示的屏幕，顯示當前上傳的圖像列表（最初為空）。
選擇“添加圖像”按鈕上傳圖像； 你會看到這個屏幕：
該圖像需要在所在設備上可訪問 web 瀏覽器正在運行，並且採用指定的圖像格式之一。 使用標準從您的機器中選擇圖像 file 對話框，然後單擊“上傳”。 現在，這會將映像從您的計算機複製到在 Raspberry Pi 上運行的 Provisioner 服務器。 這可能需要一些時間。 圖片上傳後，您將在“圖片”頁面上看到它。
添加項目
現在您需要創建一個項目。 您可以指定任意數量的項目，每個項目都可以有不同的圖像、腳本集或標籤。 活動項目是當前用於配置的項目。
單擊“項目”菜單項打開“項目”頁面。 以下前ample 已經設置了一個名為“測試項目”的項目。
現在單擊“添加項目”以設置新項目
- 為項目指定適當的名稱，然後從下拉列表中選擇您希望該項目使用的圖像。 您還可以在此設置許多其他參數tage，但通常只有圖像就足夠了。
- 如果您使用的是 v1.5 或更高版本的 Provisioner，則您可以選擇驗證刷新是否已正確完成。 選擇此選項將在刷新後從 CM 設備中讀回數據，並確認其與原始圖像匹配。 這將為每個設備的配置增加額外的時間，增加的時間量將取決於映像的大小。
- 如果您選擇要安裝的固件（這是可選的），您還可以使用一些特定的配置條目自定義該固件，這些條目將合併到引導加載程序二進製文件中。 可用選項可以在 Raspberry Pi 上找到 web地點。
- 完全定義新項目後，單擊“保存”； 您將返回到“項目”頁面，並且將列出新項目。 請注意，任一時間只能有一個項目處於活動狀態，並且您可以從此列表中選擇它。
腳本
Provisioner 的一個真正有用的功能是能夠在安裝之前或之後在映像上運行腳本。 Provisioner 中默認安裝了三個腳本，創建新項目時可以選擇。 它們列在腳本頁面上
前任amp使用腳本可能會將自定義條目添加到 config.txt。 標準腳本 Add dtoverlay=dwc2 to config.txt 使用以下 shell 代碼執行此操作：
單擊“添加腳本”以添加您自己的自定義設置：
標籤
配置器可以為正在配置的設備打印標籤。 標籤頁面顯示了在項目編輯過程中可以選擇的所有預定義標籤。 對於前amp文件中，您可能希望為每個配置的板打印 DataMatrix 或快速響應 (QR) 代碼，此功能使這變得非常簡單。
單擊“添加標籤”以指定您自己的標籤： 
韌體
Provisioner 能夠指定您希望在 CM4 上安裝哪個版本的引導加載程序固件。 在“固件”頁面上有一個所有可能選項的列表，但最新的通常是最好的。
要使用最新版本的引導加載程序更新列表，請單擊“從 github 下載新固件”按鈕。
可能出現的問題
過時的引導加載程序固件
如果您的 CM4 在插入時未被 Provisioner 系統檢測到，則引導加載程序固件可能已過期。 請注意，自 4 年 2021 月以來製造的所有 CMXNUMX 設備在工廠都安裝了正確的引導加載程序，因此只有該日期之前製造的設備才會發生這種情況。
已經編程的eMMC
如果CM4模塊已經有啟動 file如果先前的配置嘗試將其存儲在 eMMC 中，則它將從 eMMC 啟動，並且不會發生配置所需的網絡啟動。
如果您確實希望重新配置 CM4 模塊，您將需要：
- 在配置服務器和 CM4 IO 板的微型 USB 端口（標記為“USB 從屬”）之間連接 USB 電纜。
- 在 CM4 IO 板上放置跳線（J2，“安裝跳線以禁用 eMMC 啟動”）。
這將導致 CM4 模塊執行 USB 引導，在這種情況下，配置服務器將傳輸 file通過 USB 運行實用程序操作系統。
實用操作系統啟動後，它將通過以太網聯系配置服務器以接收進一步的指令，並下載附加的 file像往常一樣（例如要寫入 eMMC 的操作系統映像）。 因此，除了 USB 電纜之外，以太網連接仍然是必要的。
託管以太網交換機上的生成樹協議 (STP)
如果在託管以太網交換機上啟用了 STP，PXE 引導將無法正常工作。 這可能是某些交換機（例如 Cisco）的默認設置，如果是這種情況，則需要禁用它才能使配置過程正常工作。
Raspberry Pi是Raspberry Pi Foundation的商標
樹莓派有限公司
文件/資源
 |
Raspberry Pi 配置 Raspberry Pi 計算模塊 [pdf] 使用者指南 配置 Raspberry Pi 計算模塊、配置、Raspberry Pi 計算模塊、計算模塊 |