# MangoBox Device Manager v0.5.0
MangoBox Device Manager `v0.5.0` is the first Stable release of the current v0.5 desktop device-management line.
## Scope
Device Manager is the routine MangoBox configuration and diagnostics tool for:
- MangoX2 / MangoLite device detection and Runtime identity;
- Pico, Pico W and Pico 2 W target alignment;
- Runtime UART and MicroUSB / Pico connection modes;
- module enable/disable and GPIO / Pin configuration;
- config read/update/replace/restore workflows;
- supported calibration and live monitoring;
- Student API preview / Runtime JSON preview;
- live Traditional Chinese / English UI switching.
Firmware flashing, Clean Flash, Factory Reset-assisted deployment, Recovery / Deep Rescue and full firmware lifecycle diagnostics remain the responsibility of MangoBox Hardware Lab.
## Supported Stable target line
- MangoX2 + Pico — `mangox2-pico` — Runtime `v0.2.6`
- MangoX2 + Pico W — `mangox2-picow` — Runtime `v0.2.6`
- MangoX2 + Pico 2 W — `mangox2-pico2w` — Runtime `v0.2.6`
- MangoLite + Pico W — `mangolite-picow` — Runtime `v0.6.0`
- MangoLite + Pico 2 W — `mangolite-pico2w` — Runtime `v0.6.0`
## Stable validation
The Stable release is a release-promotion of the validated `v0.5.0-rc8` functional baseline. No new Device Manager functional path was introduced solely for the Stable version bump.
Final Stable release gates completed on Windows:
- local source / contract suite: `88 passed`;
- live i18n / font visibility / Runtime UART restore suite: `5 passed`;
- Stable Qt title smoke: PASS;
- Portable package build: PASS;
- Traditional-Chinese Windows Installer build: PASS;
- Installer launch, Start Menu shortcut, desktop shortcut, icon, About/version, zh → en → zh switching and uninstall: PASS;
- Portable launch: PASS;
- five-target identity + `system/info` + `config/get` sanity: PASS;
- representative MangoX2 + Pico W Runtime UART / MicroUSB / RGB smoke: PASS;
- representative MangoLite + Pico W Runtime UART / RGB / onboard IR / config smoke: PASS.
GitHub Actions attempts during the Stable promotion could not allocate a runner and executed no steps; this was recorded as CI NOT RUN / BLOCKED rather than a source-test failure. The equivalent local source gates above passed.
## Windows packages
- `MangoBox_Device_Manager_v0.5.0_Setup.exe` — recommended
- `MangoBox_Device_Manager_v0.5.0_Portable.zip`
SHA-256:
- Portable: `5619ceabcf2f5393df54898c5b2443a4927c70bae541bfd331d8bacd14cb0182`
- Installer: `d011d45b2542c591632eadbc98c7f4d6aaddfbad8c38718b45ba431be84d4d80`
Both artifacts are generated from the same PyInstaller onedir tree. The Installer is per-user, Traditional Chinese only, and uses the canonical MangoBox Device Manager application icon.
## Notes
The existing rc7 / rc8 hardware-validation evidence remains the provenance for unchanged module behavior. The Stable release adds final exact-artifact and five-target promotion checks; it does not retroactively relabel unexecuted hardware tests as newly passed.
# MangoBox Hardware Lab v0.3.0
## 中文
Hardware Lab v0.3.0 正式版，提供 Windows 64-bit Installer 與 Portable。支援 MangoX2 + Pico／Pico W／Pico 2 W，以及 MangoLite + Pico W／Pico 2 W。提供雙語介面、韌體維護與單次 UF2 教師套件部署。Teacher Profile v1 為預設；v2 仍為需明確啟用的實驗功能。
安裝 Installer，或完整解壓 Portable 後執行 MangoBox Hardware Lab.exe；不需另外安裝 Python。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable Hardware Lab v0.3.0 for Windows 64-bit, with Installer and Portable distributions. Supports all five MangoX2/MangoLite targets, bilingual UI and one-UF2 Teacher Profile deployment. Profile v1 is the default; Profile v2 remains opt-in experimental. Install Setup or extract the entire Portable ZIP and launch MangoBox Hardware Lab.exe. Python is not required.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoBox_Hardware_Lab_v0.3.0_Setup.exe`
SHA-256: `5e28804f2f1d45a358ecf5858d0417896e317be62d6c4f215fa5cf82758af5a8`
- `MangoBox_Hardware_Lab_v0.3.0_Portable.zip`
SHA-256: `0c3b5798619469c9e3deb2c41b5403046a63f66f13e4d2fd5df055f8420fc306`
# MangoX2 Runtime v0.2.6 — Pico
## 中文
MangoX2 Runtime v0.2.6 正式版，僅適用 MangoX2 + Raspberry Pi Pico。搭配 Hardware Lab v0.3.0 使用，保留既有 Student API、執行模式與維護路徑。
在 Hardware Lab 選擇正確主板與控制板，再選本 Release 的 UF2，依指示燒錄。更新前請備份需要保留的學生程式與設定。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable MangoX2 Runtime v0.2.6 for MangoX2 + Raspberry Pi Pico only. Use Hardware Lab v0.3.0, select the matching carrier/controller and UF2, then follow the flashing instructions. Back up student files and settings before updating.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoBox_Runtime_v0.2.6_MangoX2_Pico.uf2`
SHA-256: `52357c7e830364717c86cc164e9e0dfc449c1093b95a04a7e7acb52e129b6e6f`
# MangoX2 Runtime v0.2.6 — Pico W
## 中文
MangoX2 Runtime v0.2.6 正式版，僅適用 MangoX2 + Raspberry Pi Pico W。搭配 Hardware Lab v0.3.0 使用，保留既有 Student API、執行模式與維護路徑。
在 Hardware Lab 選擇正確主板與控制板，再選本 Release 的 UF2，依指示燒錄。更新前請備份需要保留的學生程式與設定。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable MangoX2 Runtime v0.2.6 for MangoX2 + Raspberry Pi Pico W only. Use Hardware Lab v0.3.0, select the matching carrier/controller and UF2, then follow the flashing instructions. Back up student files and settings before updating.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoBox_Runtime_v0.2.6_MangoX2_PicoW.uf2`
SHA-256: `043c048183644da44b34b39189117d7f7518af4c1f4bc38d9830dce639fff9b2`
# MangoX2 Runtime v0.2.6 — Pico 2 W
## 中文
MangoX2 Runtime v0.2.6 正式版，僅適用 MangoX2 + Raspberry Pi Pico 2 W。搭配 Hardware Lab v0.3.0 使用，保留既有 Student API、執行模式與維護路徑。
在 Hardware Lab 選擇正確主板與控制板，再選本 Release 的 UF2，依指示燒錄。更新前請備份需要保留的學生程式與設定。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable MangoX2 Runtime v0.2.6 for MangoX2 + Raspberry Pi Pico 2 W only. Use Hardware Lab v0.3.0, select the matching carrier/controller and UF2, then follow the flashing instructions. Back up student files and settings before updating.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoBox_Runtime_v0.2.6_MangoX2_Pico2W.uf2`
SHA-256: `4bbc48747726fe93ba042e3a7eb2d799aabc9859ec989cb03cf9c1563c758447`
# MangoLite Runtime v0.6.0 — Pico W
## 中文
MangoLite Runtime v0.6.0 正式版，僅適用 MangoLite + Raspberry Pi Pico W。搭配 Hardware Lab v0.3.0 使用，保留既有 Student API、執行模式與維護路徑。
在 Hardware Lab 選擇正確主板與控制板，再選本 Release 的 UF2，依指示燒錄。更新前請備份需要保留的學生程式與設定。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable MangoLite Runtime v0.6.0 for MangoLite + Raspberry Pi Pico W only. Use Hardware Lab v0.3.0, select the matching carrier/controller and UF2, then follow the flashing instructions. Back up student files and settings before updating.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoLite_Runtime_v0.6.0_PicoW.uf2`
SHA-256: `90ef66d8aac461a050c97a0e73f2f8f28d9a06763dc4c10530554e1fb31dd89c`
# MangoLite Runtime v0.6.0 — Pico 2 W
## 中文
MangoLite Runtime v0.6.0 正式版，僅適用 MangoLite + Raspberry Pi Pico 2 W。搭配 Hardware Lab v0.3.0 使用，保留既有 Student API、執行模式與維護路徑。
在 Hardware Lab 選擇正確主板與控制板，再選本 Release 的 UF2，依指示燒錄。更新前請備份需要保留的學生程式與設定。
本機 Windows 建置；使用者回報正式版 smoke PASS，先前代表機驗收通過。五個 UF2 已核對正式版內嵌版本與 MCU family，未宣稱五台新機各自重做完整實機驗證。
## English
Stable MangoLite Runtime v0.6.0 for MangoLite + Raspberry Pi Pico 2 W only. Use Hardware Lab v0.3.0, select the matching carrier/controller and UF2, then follow the flashing instructions. Back up student files and settings before updating.
Built locally on Windows. The user reported final smoke PASS following representative hardware acceptance. All five UF2 embedded release versions and MCU families were checked. This does not claim a new full physical test on every target.
## Downloads / SHA-256
- `MangoLite_Runtime_v0.6.0_Pico2W.uf2`
SHA-256: `8154ab86b3d5cba1d24021c42013781f0817d09c6a65313ce0eae9e7d753e421`
# MangoBox Device Manager v0.5.0-rc8
## 中文
MangoBox Device Manager v0.5.0-rc8 是目前建議使用的 Windows Release Candidate。此版本在既有 MangoX2 / MangoLite 裝置管理能力上，加入 Pico W target 對齊、即時中英文切換、ADC 腳位絲印標示，以及更乾淨的 Runtime UART 恢復流程，並正式提供 Installer 與 Portable 兩種 Windows 發布形式。
### 支援平台與裝置
- Windows 64-bit
- MangoX2 + Raspberry Pi Pico
- MangoX2 + Raspberry Pi Pico 2 W
- MangoX2 + Raspberry Pi Pico W
- MangoLite + Raspberry Pi Pico 2 W
- MangoLite + Raspberry Pi Pico W
### 下載檔案
**一般使用者建議：Installer**
- `MangoBox_Device_Manager_v0.5.0-rc8_Setup.exe`
- 全繁體中文安裝／解除安裝介面
- 安裝後建立開始選單捷徑，可選桌面捷徑
**免安裝：Portable**
- `MangoBox_Device_Manager_v0.5.0-rc8_Portable.zip`
- 解壓後直接執行 `MangoBox_Device_Manager_v0.5.0-rc8.exe`
兩個下載檔皆附獨立 SHA-256 檢查檔。
### 主要更新
- 支援辨識 `mangox2-picow` 與 `mangolite-picow`，沿用既有 MangoX2 / MangoLite family capability semantics，不另外複製一套功能。
- 中文／English 可在目前頁面即時切換，不需重建視窗或重新連線。
- GPIO 顯示對齊板上絲印：`GP26 (AD0)`、`GP27 (AD1)`、`GP28 (AD2)`。
- OLED「目前學生自訂字庫」管理區塊僅在 `MicroUSB / Pico` 模式顯示；Runtime UART 仍保留既有字模分析／寫入能力。
- MangoX2 從 `MicroUSB / Pico` 回到 `Runtime UART` 時，改為單次 boot grace / auto-connect round，避免重複送出多次 `system/info` 與 `config/get`。
- Installer 與 Portable 由同一份 PyInstaller onedir binary tree 產生，避免兩種發布形式內容不一致。
- Installer、安裝後程式、開始選單、桌面捷徑與 Windows Installed Apps 使用 MangoBox Device Manager 官方 App ICON。
### 驗證
- Device Manager source / contract / Qt startup CI：PASS
- Live i18n / transition CI：PASS
- MangoLite + Pico W target / config identity：實機 PASS
- MangoX2 + Pico W target / config identity：實機 PASS
- Windows Installer：建置、繁中安裝、啟動、捷徑、解除安裝 PASS
- Windows Portable：解壓、直接啟動 PASS
既有硬體功能路徑沿用 v0.5.0-rc7 已完成的驗證；rc8 未把未重測項目重新標示成新的硬體 PASS。
### 安裝方式
**Installer**
1. 下載 `MangoBox_Device_Manager_v0.5.0-rc8_Setup.exe`。
2. 執行安裝程式並依繁體中文精靈完成安裝。
3. 從開始選單或桌面捷徑啟動 MangoBox Device Manager。
**Portable**
1. 下載 `MangoBox_Device_Manager_v0.5.0-rc8_Portable.zip`。
2. 完整解壓縮到一般資料夾。
3. 執行 `MangoBox_Device_Manager_v0.5.0-rc8.exe`。
若 Windows SmartScreen 第一次執行時出現提示，請先確認檔案來自 MangoBox 官方 GitHub Release，再依 Windows 提示選擇是否執行。
### 版本狀態
**Release Candidate (RC)**。建議目前開發、測試與教學環境使用，尚未標示為 Stable。
---
## English
MangoBox Device Manager v0.5.0-rc8 is the current recommended Windows Release Candidate. It adds Pico W target parity, live Traditional Chinese / English switching, ADC silkscreen aliases, a cleaner Runtime UART restoration flow, and official Installer + Portable Windows packages while preserving the existing MangoX2 / MangoLite management model.
### Supported platforms and targets
- Windows 64-bit
- MangoX2 + Raspberry Pi Pico
- MangoX2 + Raspberry Pi Pico 2 W
- MangoX2 + Raspberry Pi Pico W
- MangoLite + Raspberry Pi Pico 2 W
- MangoLite + Raspberry Pi Pico W
### Downloads
**Recommended for most users: Installer**
- `MangoBox_Device_Manager_v0.5.0-rc8_Setup.exe`
- Traditional-Chinese-only setup and uninstall UI
- Start Menu shortcut and optional desktop shortcut
**No-install option: Portable**
- `MangoBox_Device_Manager_v0.5.0-rc8_Portable.zip`
- Extract and run `MangoBox_Device_Manager_v0.5.0-rc8.exe`
Separate SHA-256 checksum files are provided for both packages.
### Highlights
- Recognizes `mangox2-picow` and `mangolite-picow` through the existing MangoX2 / MangoLite family capability semantics.
- Live Traditional Chinese / English switching without rebuilding the current page or reconnecting the device.
- ADC GPIO labels match the board silkscreen: `GP26 (AD0)`, `GP27 (AD1)`, `GP28 (AD2)`.
- The persistent custom-font-cache management block is shown only in `MicroUSB / Pico`; Runtime UART retains the existing glyph analysis/upload path.
- MangoX2 `MicroUSB / Pico -> Runtime UART` restoration now uses one boot-grace / auto-connect round and avoids repeated `system/info` / `config/get` bursts.
- Installer and Portable packages are produced from the same PyInstaller onedir binary tree.
- Setup, installed app, Start Menu, desktop shortcut and Windows Installed Apps use the canonical MangoBox Device Manager App ICON.
### Validation
- Device Manager source / contract / Qt startup CI: PASS
- Live i18n / transition CI: PASS
- MangoLite + Pico W target / config identity: physical-device PASS
- MangoX2 + Pico W target / config identity: physical-device PASS
- Windows Installer build / localized install / launch / shortcuts / uninstall: PASS
- Windows Portable extraction / direct launch: PASS
Existing hardware-functional paths retain the previously recorded v0.5.0-rc7 validation baseline; rc8 does not relabel unchanged, un-retested paths as a new hardware PASS.
### Installation
**Installer**
1. Download `MangoBox_Device_Manager_v0.5.0-rc8_Setup.exe`.
2. Run the setup wizard and complete the installation.
3. Launch MangoBox Device Manager from the Start Menu or desktop shortcut.
**Portable**
1. Download `MangoBox_Device_Manager_v0.5.0-rc8_Portable.zip`.
2. Extract the ZIP to a normal folder.
3. Run `MangoBox_Device_Manager_v0.5.0-rc8.exe`.
If Windows SmartScreen appears on first launch, first verify that the file came from the official MangoBox GitHub Release before choosing whether to run it.
### Release status
**Release Candidate (RC)**. Recommended for current development, testing, and classroom use; it has not yet been designated Stable.