🥭MangoBox
回課程列表
RGB LED 色彩與循環燈效基礎實作

COURSE DETAIL

RGB LED 色彩與循環燈效

控制八顆 RGB LED 的顏色、亮度與順序，做出自己的燈光節奏。

預估時間120 分鐘適用能力具基礎變數與迴圈概念
查看課程章節

CHAPTERS

課程章節

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

    RGB 色碼與 LED 編號

    辨認 RGB 色碼與 index 0–7，確認使用八顆 LED 的教學模組。

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

    點亮單顆與全部 LED

    閱讀 led 與 led_off，觀察範例如何讓上一顆熄滅、下一顆亮起。

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

    使用 for 迴圈製作燈效

    追蹤 colors 與 index 兩層迴圈，預測下一顆 LED 的顏色，再執行比對。

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

    調整速度並完成作品

    一次只改一個色碼或 sleep 間隔，觀察節奏；確認結束時 LED 熄滅。

    對照本課完整程式 →

完成檢查

八顆 LED 依序亮起並循環八種顏色；結束時全部關閉。

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

學習目標

  • 認識 LED index 與色碼
  • 使用迴圈依序控制八顆 LED
  • 調整亮度、延遲與清除狀態

所需設備

  • 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 連線
  • 八顆 RGB LED 教學模組（已啟用，index 0–7）

PROJECT PREVIEW

課程成果預覽

八色循環燈與自訂燈效八顆 LED 依序亮起並循環八種顏色；結束時全部關閉。
本課使用的 Mango X2 開發板

TRY IT

程式與實作

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

m = Mango(mode="hardware")
colors = ["#FF0000", "#FF7A00", "#FFFF00", "#00FF00",
          "#0000FF", "#2210BB", "#440080", "#FFFFFF"]
try:
    m.brightness(20)
    for color in colors:
        for index in range(8):  # MangoX2 八顆 RGB 教學模組
            m.led_off()
            m.led(index, color)
            time.sleep(0.15)  # Python sleep 單位是秒
finally:
    m.led_off()
    m.close()

在 MangoThonny 執行

八顆 LED 依序亮起並循環八種顏色；結束時全部關閉。

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

安裝與連線 →模組與連線設定 →取得正式工具 →
LED API 文件 →
本課 API 核對紀錄 · 2026-09-09

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

此範例使用 index 0–7，僅適用已設定八顆 LED 的 MangoX2 教學模組；MangoLite 板載六顆不可直接套用。brightness 的 power 為 0–100。

對照來源：HostPython/02-MangoX2-LED_Basic.py、03-MangoX2-LED_Loop.py

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

  • m.brightness(power=30, duration=0, strip=None)設定 RGB LED 整體亮度
  • m.led_off(strip=None)停止 LED 燈效並熄滅燈條
  • m.led(index, color="#ffffff", duration=0, strip=None)設定單顆 RGB LED 的顏色
  • m.close()停止 Runtime 或背景資源並關閉 Mango 物件