🥭MangoBox
回課程列表
OLED 文字與版面設計顯示應用

COURSE DETAIL

OLED 文字與版面設計

用文字、座標與字級建立清楚的 OLED 資訊畫面，練習輪播與版面配置。

預估時間100 分鐘適用能力Python 初學者
查看課程章節

CHAPTERS

課程章節

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

    座標與字級

    確認 OLED 為 128×64，標出畫面的左上角與文字起點。

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

    單頁文字排版

    閱讀 text 的文字、座標與 size，預測每行內容出現的位置。

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

    建立文字輪播

    依完整範例觀察多頁切換，確認每次換頁前清除畫面的作用。

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

    完成資訊看板

    修改文字與版面，檢查是否超出畫面，記錄每頁顯示結果。

    對照本課完整程式 →

完成檢查

OLED 每兩秒切换一頁，依序顯示 Page 1、Page 2、Page 3。

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

學習目標

  • 理解 128×64 OLED 座標
  • 使用 text 的 size 參數
  • 建立多頁文字畫面

所需設備

  • 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 模組（已啟用）

PROJECT PREVIEW

課程成果預覽

OLED 資訊看板OLED 每兩秒切换一頁，依序顯示 Page 1、Page 2、Page 3。
本課使用的 Mango X2 開發板

TRY IT

程式與實作

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

m = Mango(mode="hardware")
try:
    for page in range(3):
        m.clear()
        m.text("MangoBox", 0, 0, size=1)
        m.text("Page " + str(page + 1), 0, 24, size=1)
        time.sleep(2)
finally:
    m.close()

在 MangoThonny 執行

OLED 每兩秒切换一頁，依序顯示 Page 1、Page 2、Page 3。

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

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

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

目前公開契約尚未正式開放 show_image／start_image_loop／stop_image_loop，本課改用已核對的 clear 與 text；不宣稱圖像 API 已可用。

對照來源：HostPython/01-MangoX2-Basic.py；Host OLED reference

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

  • m.clear()清除 OLED 畫面
  • m.text(text, x=0, y=0, size=1)在 OLED 顯示文字，支援換行
  • m.close()停止 Runtime 或背景資源並關閉 Mango 物件