ESP32 Lab MicroPython 版 使用說明 v1.13.2

內容更新:2026 年 11 月 14 日

回程式編輯頁

Gemini 提示詞

網站會依你選的晶片寫好提示詞,複製後貼到 Gemini 就好。編輯器上方的「Gemini 提示詞」選單有三項:

只想問其中幾行,先在編輯器選取那幾行,再打開選單,最後一項會變成「解說選取的程式(第 5–12 行)」。整份程式也會一起附上,讓 Gemini 了解前後文。沒有選取時,解說整份程式。

另外兩種提示詞會在需要時出現:程式出錯時,錯誤提示卡上的「複製給 Gemini」會附上錯誤訊息請 Gemini 修正;貼上 Arduino 程式時,提示列上的按鈕會請 Gemini 改寫成 MicroPython。

這些提示詞都會自動隱藏常見的 Wi-Fi 密碼和 Token 寫法,但不保證全部偵測得到,見隱私與安全。

用 REPL 和開發板對話

REPL 是 Read-Eval-Print Loop 的縮寫,意思是讀取指令、執行、印出結果,然後重複。平常的 main.py 是寫好整份程式再上傳;REPL 則是說一句、回一句,很適合用來測接線、試指令和找錯誤。

這裡輸入的指令會直接在板子上執行,但不會存進 main.py。重新啟動或上傳程式後,變數和指令的效果都會消失。

開始使用

  1. 按「連接開發板」。連接時,板子上正在執行的程式會停止,監控窗會出現 >>> 提示符號。
  2. 如果程式正在執行(例如剛按完「上傳並執行」),先按「停止」。
  3. 在監控窗下方的輸入框打指令,按 Enter 送出。

動手試試看

照順序輸入下面的指令。第二段會用到 GPIO 2,也就是常見 ESP32 開發板的板載 LED;其他晶片或板子請改成自己的腳位。

1 + 1

from machine import Pin
led = Pin(2, Pin.OUT)
led.value(1)
led.value(0)

import os
os.listdir()

常用指令

指令用途
help("modules")列出韌體內建的模組
import machine,再輸入 dir(machine)列出模組裡的功能
from machine import Pin,再輸入 Pin(19, Pin.IN, Pin.PULL_UP).value()讀取按鈕腳位,按下時通常是 0
from machine import Pin, I2C,再輸入 I2C(0, scl=Pin(22), sda=Pin(21)).scan()掃描 I2C 裝置,確認 OLED、LCD 的接線和位址
import gc,再輸入 gc.mem_free()查看剩餘記憶體
print(open("main.py").read())看板子上的程式。裡面可能有 Wi-Fi 密碼,投影時要小心

快速鍵

按鍵功能
Enter送出指令。行尾是冒號時會換行並縮排
Shift + Enter換行,不送出
Ctrl + Enter不論內容,立刻送出
↑、↓叫回之前的指令
Tab補完名稱。有多個可能時,會列在輸入框上方。要先 import,才補得到模組裡的名稱,例如先輸入 import machine,再輸入 machine. 後按 Tab
Ctrl + C中斷正在執行的程式,和「停止」相同。有選取文字時則是複製

輸入多行程式

輸入 for i in range(3): 後按 Enter,輸入框會自動換行並縮排。寫完內容後,再多按兩次 Enter(出現一個空行後送出),整段就會執行。也可以直接貼上多行程式,再按「傳送」。監控窗會顯示 ===,這是開發板接收多行程式時的提示,屬於正常現象。

for i in range(3):
    print(i)

較長的程式請放到左邊的編輯器,用「上傳並執行」,才會保存下來。

REPL 會真的控制硬體。和寫在程式裡一樣,錯誤的腳位設定仍可能影響接在上面的元件,也不要輸入不了解的刪除檔案指令。之前的指令只留在這個分頁的記憶體,重新整理或切換語言後就會清除,不會存進瀏覽器。

用圖表看感測器數值

監控窗右上角可以切換「文字」和「圖表」。切到「圖表」時,程式印出的數字會畫成折線圖,很適合觀察溫度變化、旋鈕轉動或距離遠近。不管停在哪一頁,資料都會持續記錄,切回來不會漏掉。

怎麼印才畫得出來

程式這樣印圖上出現
print("溫度:", t)一條「溫度」線
print("溫度:", t, "°C 濕度:", h, "%")「溫度」和「濕度」兩條線,數字後面的單位會略過
print(t, h)只印數字時,依順序叫做「數值1」、「數值2」

動手試試看

不接任何元件也能試。上傳下面的程式,再切到「圖表」,會看到兩條波浪線。

import math, time

i = 0
while True:
    print("sin:", math.sin(i / 50), "cos:", math.cos(i / 50))
    i += 1
    time.sleep(0.05)

圖表上的按鈕

按鈕功能
顯示最近選看最近 10 秒、30 秒、1 分鐘、5 分鐘或 10 分鐘。剛開始記錄時,會從 0 秒開始撐滿整個寬度
暫停/繼續停住畫面方便觀察,資料仍在背景記錄
圖例顯示每條線的最新數值。點一下可以隱藏或顯示那條線
清除在圖表頁按,只清掉圖表資料,按之前會先詢問
匯出 CSV把記錄的資料下載成 CSV 檔

匯出 CSV

按「匯出 CSV」會下載 esp32-data-日期-時間.csv。第一欄是時間(秒,從第一筆資料開始算),後面每條線一欄;某一行沒有印到的值會留空。用 Excel 或 Google 試算表打開,中文都不會變成亂碼,可以拿來畫圖、算平均或寫實驗報告。

網站最多保留最近 10 萬筆資料,超過時會丟掉最舊的資料,圖表上方會提示。資料只存在這個分頁,重新整理網頁就會清除,長時間記錄請記得匯出。要長期保存,可以參考把感測器資料存到 Google 試算表。

管理板子上的檔案

連接開發板後,按編輯器上方的「板上檔案」,就能看到板子裡有哪些檔案,也可以下載、上傳和刪除,不用另外安裝 Thonny 或 mpremote。

打開「板上檔案」時,板子上正在執行的程式會停止。關掉視窗後程式還是停著,按監控窗的「重新啟動」就會再執行 main.py。

可以做什麼

操作功能
點資料夾名稱進入資料夾,例如 lib。上方的路徑可以點回上一層
開到編輯器把 100 KB 以內的文字檔(例如 .py、.txt、.csv、.json)放進編輯器,會先詢問
下載把檔案存到電腦
刪除刪除前會先詢問。資料夾要先清空才能刪
從電腦上傳檔案…上傳到目前所在的資料夾,可以一次選好幾個,也可以直接把檔案拖進視窗。同名檔案會先問要不要覆蓋
把編輯器內容存成…輸入檔名,把編輯器裡的程式存成那個檔案,例如 mylib.py

視窗右上角會顯示板子還剩多少空間。上傳和下載都會用 SHA-256 檢查檔案有沒有傳錯;上傳失敗時,板子上原來的檔案不會被改到。

自己寫一個函式庫

  1. 在編輯器寫好函式:
    def hello(name):
        print("哈囉,", name)
  2. 按「板上檔案」,再按「把編輯器內容存成…」,輸入 mylib.py。
  3. 關掉視窗,在編輯器寫主程式,按「上傳並執行」:
    import mylib
    mylib.hello("ESP32")

網路上找到的元件函式庫,例如 OLED 的 ssd1306.py,也可以用「從電腦上傳檔案…」放到板子的根目錄或 lib 資料夾,再用 import 匯入。

把 lib/ssd1306.py 這類檔案開到編輯器修改後,要用「把編輯器內容存成…」存回去。直接按「上傳並執行」會把它存成 main.py,取代原本的主程式。

回程式編輯頁