按鈕輸入與狀態判讀

讀取按鈕狀態，理解輸入值與程式判斷之間的關係。

預估時間90 分鐘適用能力具 if 判斷概念

查看課程章節

CHAPTERS

課程章節

依序閱讀、操作，再用完成檢查確認自己的學習成果。

01
CHAPTER 1
輸入與輸出
辨認 Button 模組，確認啟用狀態與連線。
確認學習目標與設備 →
02
CHAPTER 2
讀取 button
閱讀 read_button 的回傳值，找出範例如何處理尚無資料的 None。
對照本課完整程式 →
03
CHAPTER 3
判斷狀態
分別按下、放開，對照 Shell 顯示與程式判斷。
對照本課完整程式 →
04
CHAPTER 4
顯示結果
記錄按下、放開與尚無資料三種狀態，說明為何不能把 None 當作放開。
對照本課完整程式 →

完成檢查

在 MangoThonny Shell 中持續看到 Pressed／Released；沒有有效讀值時顯示 No button value available。

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

學習目標

同步讀取 read_button()
區分 0、1 與 None
持續印出按鈕狀態

所需設備

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 連線
Button 模組（已啟用）

PROJECT PREVIEW

課程成果預覽

按鈕狀態顯示器在 MangoThonny Shell 中持續看到 Pressed／Released；沒有有效讀值時顯示 No button value available。

TRY IT

程式與實作

程式需在 MangoThonny 的 Host / CPython 執行；本頁提供閱讀與 RGB 燈效示意。

main.py

from mangobox import Mango
import time

m = Mango(mode="hardware")
try:
    for sample in range(30):
        value = m.read_button()
        if value is None:
            print("No button value available")
        elif value == 1:
            print("Pressed")
        else:
            print("Released")
        time.sleep(0.2)
finally:
    m.close()

在 MangoThonny 執行

在 MangoThonny Shell 中持續看到 Pressed／Released；沒有有效讀值時顯示 No button value available。

下載本課 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 的用途不同。

安裝與連線 →模組與連線設定 →取得正式工具 →

BUTTON API 文件 →

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

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

Host read_button() 送出讀取命令並等待回覆，逾時可能回傳已知值或 None；None 不應當成放開。同步讀值不需 start_button 或 run_forever。

對照來源：Host Button reference read_button()；student_api_parity.py

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

m.read_button()讀取按鈕目前狀態
m.close()停止 Runtime 或背景資源並關閉 Mango 物件

按鈕輸入與狀態判讀

課程章節

輸入與輸出

讀取 button

判斷狀態

顯示結果