Hardware Lab 安裝與使用說明
Hardware Lab 可辨識 Pico、更新韌體、切換開機模式及收集診斷紀錄。
Hardware Lab v0.3.12 正式版
發布日期 2026-11-21 · Windows 64 位元
桌面硬體實驗室新增整板清空、空白板直接更新,以及乾淨燒錄後的讀回驗證。內附九款支援 OLED 字距與行距的韌體。
內建九款韌體
提供 MangoX2 0.2.14、MangoLite 0.6.9、BarePico 0.1.4 韌體,分別適用 Pico、Pico W、Pico 2 W。支援最多 16 格 OLED 圖片與動畫,可搭配 Device Manager 傳送、儲存、讀回及播放素材;沒有網路時也可使用內建韌體更新。
改善多個素材接續播放、停止播放與重複操作的穩定性,並保留原有圖片與動畫功能。
MangoX2/MangoLite 的開機歡迎畫面改為「芒果盒/智慧互動設計平台」,第一行置中;BarePico 維持沒有開機歡迎畫面。請搭配最新正式版 Device Manager,先選擇正確主板與 Pico 型號,更新前備份板上檔案。歷史版本繼續保留。
使用舊版 MangoThonny 播放較長動畫時,若出現等待逾時,請切換到板端 MicroPython 模式播放。
檔名與 SHA-256 校驗碼
MangoBox_Hardware_Lab_v0.3.12_Setup.exe2c7482579ea36a4b0be4197876324788773c3b5070bfa9bc840af107b01f5b94
MangoBox_Hardware_Lab_v0.3.12_Portable.zipf9ba05e85ef476ec18db0fb483c0a7193f66c47131beaedf9b26ac7d06f76a45
1. 安裝與更新
- 安裝版適合日常使用。執行上方的安裝檔,依精靈指示完成安裝。舊版會在原有位置升級。
- 若精靈偵測到現有設定,請選擇保留或清除。解除安裝時也可保留設定,以便下次安裝使用。
- 免安裝版請完整解壓縮至新資料夾,從資料夾啟動主程式。請保留解壓後的相對目錄。
- 開啟「說明」選單,選擇「檢查更新」。正式通道可直接取得正式版。下載完成後確認安裝,程式會關閉並開啟安裝精靈。
2. 選擇主板與控制板
先選擇刷完後要使用的主板,再依實體控制板選擇 Pico、Pico W 或 Pico 2 W。
- MangoX2 可搭配 Pico、Pico W 或 Pico 2 W。
- MangoLite 可搭配 Pico、Pico W 或 Pico 2 W。
- BarePico 可搭配 Pico、Pico W 或 Pico 2 W。
MangoX2 的 Host UART 使用 TX GP12、RX GP13。MangoLite 使用 TX GP4、RX GP5。Gateway 僅適用於支援它的無線韌體。BarePico 的開機模式為 MicroPython。
3. 上方連線區怎麼填
選好 Target 後,按「重新整理」讓程式掃描可用連接埠。Hardware Lab 會顯示:
- MicroUSB COM:Pico 原生 USB/管理通道。
- USB-TTL / UART COM:Host UART 管理路徑。
- Gateway URL:無線 Target 可使用,預設格式為
ws://mangobox-gateway.local:8765。 - Device ID:需要指定 Gateway 裝置時填入,例如 MB001;切換不同 Target 時不應沿用舊板子的 Device ID。
4. 更新韌體
- 使用 MicroUSB 連接 Pico,按「重新掃描」並選擇該裝置。
- 選擇要使用的主板、實體控制板與相符的 UF2,再按「更新韌體」。同一塊控制板可以更換主板韌體。
- 分區相同時可保留檔案。若分區不同或無法確認,請先備份檔案,閱讀清除範圍後再決定是否繼續。
- 選擇韌體支援的開機模式。刷完後核對完成畫面中的韌體、硬體組合與啟動方式。
進階部署/教師套件
- 選擇正確的主板、控制板與正式版 UF2。
- 匯入 Teacher Profile 或 Device Manager Runtime config,確認執行模式與選用的 Gateway 設定。
- 預設使用 Teacher Profile v1,保留學生檔案與裝置身分。
- 依提示進入 UF2 模式,等待韌體寫入與設定套用完成。
- 等待完成訊息與裝置重新啟動,再進行操作。
選用的 Teacher Profile v2
v2 仍須明確啟用實驗模式。preserve_all 保留設定與檔案;teacher_kit 以韌體預設值套用教師設定並保留檔案;fresh_classroom 清除可寫檔案系統後套用教師設定。
fresh_classroom 會清除學生程式與檔案,請先備份;裝置身分保留。5. Clean Flash 什麼時候用?
Clean Flash 是較深層的重新部署流程,適合裝置設定、執行模式或檔案系統已經混亂,單純更新 Firmware 無法恢復正常狀態時使用。它會結合 Factory Reset-assisted deployment、重新進入 UF2、重新燒錄與目標執行模式設定。
- 確認 Target 正確。
- 選擇正確 UF2。
- 在「初始模式」選擇 Clean Flash 完成後希望進入的模式;一般維護可優先選 MicroPython。
- 按「Clean Flash」。
- 依畫面指示完成 Factory Reset、重新連線、Bootloader / UF2 與後續驗證。
- 不要在流程中任意拔線或關閉程式,除非畫面明確要求。
6. Button + RESET 維護手勢
「維護手勢」頁可協助驗證 Normal、Recovery、Deep Rescue 與 Cancel。先依畫面選擇手勢與目前 stored mode,再使用計時器配合實機操作。
| 手勢 | 按住 Recovery Button 的時間 | 用途 |
|---|---|---|
| Normal | < 2 秒 | 一般開機,不進入維護模式。 |
| Recovery | 2–<10 秒 | 進入 Recovery 路徑。 |
| Deep Rescue | 10–<20 秒 | 進入更深層維護/救援路徑。 |
| Cancel | ≥20 秒 | 取消維護手勢並回到 Normal。 |
實際按法
- 先按住 Recovery Button。
- 短按 RESET,RESET 放開後 Recovery Button 繼續按住。
- 依目標時間與板上聲光提示判斷。
- 到達要測試的區間後放開 Recovery Button。
7. 偵測與切換執行模式
在「執行模式」頁可先 Probe Current Mode,再選擇目標模式並切換。Preferred Path 建議先使用 Auto,讓 Hardware Lab 依目前 Target 與可用傳輸選擇管理路徑。
| 模式 | 用途 | 常見情境 |
|---|---|---|
| MicroPython | 直接在 Pico 上執行高層/低層 MicroPython。 | Thonny、Creator Device-side 程式。 |
| Host UART | 由上位機 Python 透過 Host UART 控制 Runtime。 | MangoThonny / PC Python。 |
| Gateway | 透過 Wi‑Fi Gateway 集中管理。 | MangoLite/MangoX2 搭配 Pico W 或 Pico 2 W 的教室部署。 |
8. 診斷紀錄與報告
視窗下方會累積結構化診斷事件。遇到問題時,不要只截一張「失敗」畫面,建議保留完整紀錄:
- 複製紀錄:提供給協助排查問題的人員。
- 儲存報告:輸出 JSON,包含 app version、Target、選擇的 COM Port、Gateway、Firmware 與診斷事件。
- 清除紀錄:開始下一輪獨立測試前再清除。
9. 常見問題與工具分工
選了 UF2,但 Hardware Lab 不接受
先確認 Target 是否選錯,尤其 MangoX2 / Pico 與 MangoX2 / Pico 2 W 是不同 MCU、不同 UF2。
找不到 MicroUSB
- 確認 USB 線可傳資料。
- 按「重新整理」。
- 若裝置正在被 Thonny 使用,先釋放 COM Port。
- 若需要 ROM UF2,依畫面提示進入 Bootloader。
找不到 Host UART
- 確認 USB-to-TTL 驅動與 COM Port。
- MangoLite Host UART 為 GP4 / GP5;MangoX2 為 GP12 / GP13,115200。
- TX / RX 要交叉接,並共地。
只是想改 Servo / PIR / Light 的 Pin,要用這裡嗎?
不用。這類日常模組與 Pin 設定請使用 Device Manager。Hardware Lab 不把一般 GPIO/ADC/RGB/OLED/Servo/Sensor production test 宣稱為目前公開功能。
| 你要做的事 | 請使用 |
|---|---|
| 改 GPIO/Pin、Enable module、校準、即時讀值 | Device Manager |
| Firmware Update、Clean Flash、Factory Reset | Hardware Lab |
| Recovery/Deep Rescue、模式卡住、無法回 Runtime | Hardware Lab |
| 正常寫程式、積木、執行學生作品 | MangoBox Creator / Thonny |