🥭MangoBox
回課程列表
MangoX2 常用 I/O 檢測系統測試

COURSE DETAIL

MangoX2 常用 I/O 檢測

逐項檢查 OLED、RGB LED、蜂鳴器與按鈕,建立常用輸入輸出的檢測流程。

預估時間160 分鐘適用能力完成基礎輸出課程
查看課程章節

CHAPTERS

課程章節

依序閱讀、操作,再用完成檢查確認自己的學習成果。
  1. 01
    CHAPTER 1

    測試規劃

    依設備清單確認 OLED、RGB、蜂鳴器與 Button,閱讀逐項檢查流程。

    確認學習目標與設備 →
  2. 02
    CHAPTER 2

    輸出檢查

    對照範例逐一觀察文字、燈光與聲音,避免只憑程式沒有報錯判定通過。

    對照本課完整程式 →
  3. 03
    CHAPTER 3

    輸入檢查

    操作 Button 並比對讀取結果,記下無反應的項目。

    對照本課完整程式 →
  4. 04
    CHAPTER 4

    結果記錄

    整理每個模組的人工檢查結果;若異常,先核對啟用與連線再重測。

    對照本課完整程式 →

完成檢查

逐項人工確認文字、綠燈與提示音,再在 Shell 觀察按鈕 0/1 讀值。

保留程式與觀察紀錄,說明你修改了哪個部分,以及結果如何改變。

學習目標

  • 建立測試順序
  • 觀察各 I/O 狀態
  • 記錄測試結果

所需設備

  • Windows 電腦
  • MangoThonny v0.4.0(Host Student API v0.4.6)
  • MangoX2 + Pico/Pico W/Pico 2 W
  • MangoX2 Runtime v0.2.6
  • USB 資料線、Host UART 所需 USB-to-TTL 連線
  • 128×64 I2C OLED 模組(已啟用)
  • 八顆 RGB LED 教學模組(已啟用,index 0–7)
  • MangoX2 板載蜂鳴器
  • Button 模組(已啟用)

PROJECT PREVIEW

課程成果預覽

四項常用 I/O 檢查紀錄逐項人工確認文字、綠燈與提示音,再在 Shell 觀察按鈕 0/1 讀值。
本課使用的 Mango X2 開發板

TRY IT

程式與實作

程式需在 MangoThonny 的 Host / CPython 執行;本頁提供閱讀與 RGB 燈效示意。
main.py
from mangobox import Mango
import time

m = Mango(mode="hardware")
try:
    m.clear()
    m.text("I/O CHECK", 0, 0)
    input("Confirm OLED text, then press Enter: ")
    m.led_all("#00FF00")
    input("Confirm green LEDs, then press Enter: ")
    m.led_off()
    m.beep()
    input("Confirm sound, then press Enter: ")
    print("Press and release the hardware button")
    for sample in range(20):
        print("Button:", m.read_button())
        time.sleep(0.25)
finally:
    m.led_off()
    m.close()

在 MangoThonny 執行

逐項人工確認文字、綠燈與提示音,再在 Shell 觀察按鈕 0/1 讀值。

下載本課 Python 範例 →

執行前請核對所需設備與頁面下方的執行環境。程式只在桌面工具執行,這個網頁不執行 Python 或連接硬體。

ENVIRONMENT & VERSIONS

本課執行環境與版本

執行方式
Host / CPython · hardware(程式在 Windows 電腦執行)
工具與韌體
MangoThonny v0.4.0 · Host Student API v0.4.6 · MangoX2 Runtime v0.2.6
適用硬體
MangoX2 + Pico/Pico W/Pico 2 W;依課程所需模組設定

本課以 MangoX2 教學套件為基準。MangoLite 需另核對模組、Enable 與 LED 數量,本課尚未宣稱直接相容。

先用 Device Manager 確認模組啟用、GPIO 與連線;MangoX2 的 OLED、RGB 和按鈕屬套件模組,不能只看裸板名稱判定已備妥。Host UART 與原生 Pico USB 的用途不同。

本課 API 核對紀錄 · 2026-09-09

已核對官方文件與 Host 原始碼;本課尚未完成實機驗證

本課只檢查 OLED、RGB、蜂鳴器、按鈕,不代表馬達、UART、ADC 等全板 I/O 都已驗證。輸出成功須實際觀察,程式沒有自動判定通過。

對照來源:Host OLED/LED/Buzzer/Button references

官方來源:MangoBox-Platform 公開 API 契約(2026-09-06)與 MangoThonny Host 原始碼 983cc296。本站範例為課程改寫,非逐字複製老師教材。

  • m.clear()清除 OLED 畫面
  • m.text(text, x=0, y=0, size=1)在 OLED 顯示文字,支援換行
  • m.led_all(color="#ffffff", duration=0, strip=None)設定全部 RGB LED 為同一顏色
  • m.led_off(strip=None)停止 LED 燈效並熄滅燈條
  • m.beep()bee() 的相容名稱
  • m.read_button()讀取按鈕目前狀態
  • m.close()停止 Runtime 或背景資源並關閉 Mango 物件