學習目標
- 記錄按下與放開事件
- 寫入含時間戳記的 CSV
- 使用紀錄觀察操作順序
資料紀錄CHAPTERS
課程章節
依序閱讀、操作，再用完成檢查確認自己的學習成果。- 01
- 02
- 03
- 04
完成檢查
每次按下與放開都在 Shell 顯示時間與事件，並附加一列到 button-events.csv。
保留程式與觀察紀錄，說明你修改了哪個部分，以及結果如何改變。
所需設備
- 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
課程成果預覽
硬體事件紀錄每次按下與放開都在 Shell 顯示時間與事件，並附加一列到 button-events.csv。TRY IT
程式與實作
程式需在 MangoThonny 的 Host / CPython 執行；本頁提供閱讀與 RGB 燈效示意。main.py
from mangobox import Mango
import csv
from datetime import datetime
from threading import Lock
m = Mango(mode="hardware")
log_lock = Lock()
def record(state):
with log_lock:
row = [datetime.now().isoformat(timespec="milliseconds"), state]
with open("button-events.csv", "a", newline="", encoding="utf-8") as file:
csv.writer(file).writerow(row)
print(*row)
m.when_pressed("button", lambda: record("pressed"))
m.when_released("button", lambda: record("released"))
m.start_button(100)
m.run_forever()
在 MangoThonny 執行
每次按下與放開都在 Shell 顯示時間與事件，並附加一列到 button-events.csv。
下載本課 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 原始碼；本課尚未完成實機驗證
CSV 儲存在目前工作目錄，屬電腦端 Python 檔案操作；不是 Pico 檔案系統，也不是已上傳到網站的學習歷程。
對照來源：Host Button reference；HostPython/04-MangoX2-Button_Basic.py
官方來源：MangoBox-Platform 公開 API 契約（2026-09-06）與 MangoThonny Host 原始碼 983cc296。本站範例為課程改寫，非逐字複製老師教材。
m.when_pressed(sensor='button', callback=None)註冊按下事件的便利寫法m.when_released(sensor='button', callback=None)註冊放開事件的便利寫法m.start_button(period=100)啟動按鈕週期監看m.run_forever()Host：保持電腦程式存活以接收事件；不是 Pico Scheduler 迴圈。