ESP32 Lab MicroPython 版 使用說明 v1.13.2

內容更新:2026 年 11 月 14 日

回程式編輯頁

支援的開發板

網站內建 MicroPython v1.29.0 的 ESP32、ESP32-S2、S3 和 C3 韌體,安裝時會自動偵測晶片並選擇對應版本。ESP32-S、ESP-WROOM-32 模組裡的晶片是 ESP32,和 ESP32-S2、S3 是不同的晶片。快閃記憶體至少要 4 MB。其他晶片或容量不足時,網站會在清除資料前停止安裝。

開發板USB 晶片狀態說明
NodeMCU-32S(ESP-WROOM-32)CP2102已實測已實測安裝韌體、上傳程式、Wi-Fi 和 MQTT。可參考腳位圖。
ESP32-S 開發板CH340已實測已實測安裝韌體、上傳 LED 閃爍程式和停止程式,這塊板子的 Wi-Fi 尚未實測。腳位排列可能和上面的腳位圖不同,請對照板子上的標示。
其他 ESP32-WROOM-32 開發板依板子而定應可使用快閃記憶體要有 4 MB 以上。尚未逐款實測。
ESP32-S2 開發板內建 USB 或依板子而定待實測網站已支援,但還沒接實體板子測試。
ESP32-S3 開發板內建 USB 或依板子而定待實測網站已支援,但還沒接實體板子測試。使用八線 PSRAM 的版本(例如型號含 R8)可能用不到 PSRAM。
ESP32-C3 開發板內建 USB 或依板子而定待實測網站已支援,但還沒接實體板子測試。MicroPython 官方說明此韌體適用晶片版本 3 以上,安裝時監控窗會顯示版本。
ESP32-CAM板子本身沒有 USB,要接底板或 USB 轉序列埠模組相機不能用晶片是 ESP32,韌體應可安裝,但尚未實測。內建韌體沒有相機功能,也用不到板上的 PSRAM,只能當一般 ESP32 使用。多數範例使用的腳位沒有引出,要自行改腳位。
ESP32-C6、H2、C2、C5、P4 等依板子而定不支援網站沒有內建這些晶片的韌體,安裝時會自動停止,不會清除板子。
ESP8266、Arduino UNO 等依板子而定不支援不是 ESP32,網站無法安裝韌體。

各種 ESP32 晶片的差異

市面上叫 ESP32 的開發板,上面的晶片有好幾種。上課建議用傳統的 ESP32,教材和網路上的資料最多。其他晶片的腳位編號不同,請看「接線注意事項」的腳位表。

晶片核心記憶體(RAM)藍牙特色本站
ESP32雙核心 240 MHz520 KB傳統藍牙和 BLE最普遍,教材最多,腳位多已實測
ESP32-S3雙核心 240 MHz512 KB,可外加 PSRAMBLE 5腳位最多,可接相機,適合進階使用待實測
ESP32-C3單核心 160 MHz(RISC-V)400 KBBLE 5便宜小巧,腳位較少待實測
ESP32-S2單核心 240 MHz320 KB沒有藍牙已被 S3 取代,市面上少見,不必特地找待實測
ESP32-C2(ESP8684)單核心 120 MHz(RISC-V)272 KBBLE 5最便宜,用來取代 ESP8266,記憶體最小不支援

可以用 Arduino UNO 嗎?

不行。本站只有 ESP32 系列的 MicroPython 韌體,而傳統的 UNO R3 記憶體太小,跑不動 MicroPython。ESP32 Lab 另有 Arduino 版,但那裡的 Arduino 指的是寫程式用的 Arduino 框架(setup()、digitalWrite() 等),不是 Arduino 這塊開發板,所以同樣不支援 UNO。

兩個版本支援的開發板

開發板MicroPython 版(本站)Arduino 版
傳統 ESP32(例如 NodeMCU-32S)已實測已實測
ESP32-S2、S3、C3待實測不支援
ESP32-C6 等其他 ESP32 晶片不支援不支援
ESP8266、Arduino UNO不支援不支援

Arduino 版要用雲端主機編譯,目前只開放作者任教學校的師生使用,沒有對外公開。

接線注意事項

下面的腳位表適用於 ESP32(包含 ESP32-S、ESP-WROOM-32 模組),其他晶片請看本章最後的表格。

接線或改線前,請先拔掉 USB 線。接錯電壓或短路可能會燒毀開發板。

腳位建議原因
GPIO 6–11不要使用連接內部快閃記憶體,接線可能讓板子無法運作。腳位圖上的 GPIO 9、10 標示 RX1、TX1,也不要使用。
GPIO 34、35、36、39只能輸入不能輸出,也沒有內部上拉或下拉電阻。
GPIO 25–27、GPIO 0、2、4、12–15類比輸入避開這些是 ADC2 腳位,Wi-Fi 開啟時不能讀類比值。需要類比輸入請改用 GPIO 32–39。
GPIO 0、2、5、12、15小心使用開機時的電位會影響啟動。尤其 GPIO 12 開機時若被拉高,板子可能無法啟動。
GPIO 1、3避開USB 序列埠使用,接其他元件會影響上傳和監控窗。
GPIO 4、13、16–19、21–23、25–27、32、33一般優先選用用於一般數位輸入和輸出比較不會衝突(GPIO 21、22 常用於 I2C)。

ESP32-S2、S3、C3 的腳位

這些晶片的腳位編號和 ESP32 不同,上面的腳位圖不適用,請對照你的板子標示。下表是選範例時預設使用的腳位。

用途S2、S3C3
LEDGPIO 18GPIO 4
按鈕GPIO 17GPIO 5
類比輸入(光敏電阻、可變電阻)GPIO 1GPIO 3
DHT11、DS18B20GPIO 4GPIO 5
I2C(SDA、SCL)GPIO 8、9GPIO 6、7
蜂鳴器GPIO 14GPIO 6
伺服馬達GPIO 13GPIO 6
WS2812GPIO 16GPIO 6
USB 使用,不要接元件GPIO 19、20GPIO 18、19

電子元件與感測器

下表不是限制清單。只要能用 MicroPython 控制,表上沒有的元件也可以使用。請把完整型號和接線腳位告訴 Gemini,再依下面的注意事項接線。

OLED、LCD 和 MAX7219 不用另外安裝任何東西。韌體沒有內建這三種元件的控制程式,所以內建範例把控制程式和主程式寫在同一份 main.py,選範例後直接上傳即可。這和電腦上的 CP210x、CH340 USB 驅動程式無關。

輸出元件

元件狀態控制方式注意事項
LED已實測Pin要串聯限流電阻(例如 220Ω),長腳接 GPIO,短腳接 GND。
有源蜂鳴器有範例Pin通電就響,只能開關。電流較大的元件要用模組或電晶體驅動。
無源蜂鳴器有範例PWM要送頻率才會響,可以發出不同音高。買之前先確認是有源還是無源。
SG90 伺服馬達有範例PWM(50 Hz)請用外部 5V 供電,並和 ESP32 共地,不要從開發板 3V3 取電。
繼電器模組韌體支援Pin先確認模組能接受 3.3V 訊號。課堂實驗不要接市電。
WS2812 全彩 LED、燈條、點矩陣有範例neopixel燈數多時電流很大,要用外部電源並共地。
MAX7219 LED 點矩陣有範例Pin通常用 5V 供電,ESP32 的 3.3V 訊號可能不穩定,要實測。
裸 8×8 LED 點矩陣韌體支援Pin需要很多腳位和掃描程式,不建議初學者使用,改用有驅動晶片的模組。
SSD1306 OLED有範例I2C常見接法是 SDA 接 GPIO 21、SCL 接 GPIO 22。
I2C LCD 1602有範例I2C許多模組用 5V 供電,I2C 訊號可能被上拉到 5V,接線前要先確認電壓。

感測器與輸入元件

元件狀態控制方式注意事項
DHT11 溫濕度有範例dhtVCC 接 3V3,讀取間隔至少 1 秒。
DHT22 溫濕度韌體支援dht程式改用 dht.DHT22,讀取間隔至少 2 秒。
光敏電阻有範例ADC請接 GPIO 32–39。裸元件要搭配電阻分壓(例如 10kΩ),模組請用 3V3 供電。
可變電阻有範例ADC同樣接 GPIO 32–39,兩端接 3V3 和 GND。
HC-SR501 人體紅外線有範例Pin通常用 5V 供電,訊號輸出約 3.3V。通電後約 1 分鐘內可能誤判。
按鈕有範例Pin可用內部上拉 Pin.PULL_UP。GPIO 34–39 沒有內部上拉。
DS18B20 溫度有範例onewire、ds18x20DATA 和 3V3 之間要接 4.7kΩ 上拉電阻,模組通常已內建。
HC-SR04 超音波有範例Pin、time_pulse_usEcho 輸出常是 5V,要先分壓成 3.3V 才能接 GPIO。

請 Gemini 寫程式的訣竅

範例接線一覽

下表是 ESP32(包含 ESP32-S、ESP-WROOM-32 模組)的預設接線。在編輯器的「晶片」選單選擇 S2、S3 或 C3 後再選範例,程式和開頭的接線說明會自動換成該晶片適用的腳位。連接開發板時,網站也會自動切換晶片選單。

範例功能預設接線需要 Wi-Fi
1. LED 閃爍LED 每秒切換一次板載 LED(GPIO 2)不需要
2. 按鈕開關 LED每按一次切換亮暗按鈕 GPIO 19、LED GPIO 18不需要
3. 呼吸燈(PWM)LED 慢慢變亮再變暗LED GPIO 18不需要
4. 可變電阻調亮度轉旋鈕調整 LED 亮度旋鈕 GPIO 34、LED GPIO 18不需要
5. 無源蜂鳴器播放小星星用不同頻率播放旋律蜂鳴器 GPIO 25不需要
6. SG90 伺服馬達來回轉動在 0 到 180 度之間掃動訊號 GPIO 13,外部 5V 供電不需要
7. 光敏電阻自動夜燈環境變暗時 LED 自動點亮光敏電阻 GPIO 34、LED GPIO 18不需要
8. 人體紅外線警報(HC-SR501)偵測到人時蜂鳴器響、LED 亮OUT GPIO 27、蜂鳴器 GPIO 25、LED GPIO 18不需要
9. 超音波測距(HC-SR04)在監控窗顯示距離Trig GPIO 26,Echo 分壓後接 GPIO 33不需要
10. DHT11 溫濕度(監控窗)每 2 秒顯示溫度和濕度DATA GPIO 4不需要
11. DS18B20 溫度計每 2 秒顯示溫度DATA GPIO 4不需要
12. WS2812 全彩 LED 彩虹彩虹顏色沿燈條流動DIN GPIO 16不需要
13. SSD1306 OLED 顯示器顯示文字和開機秒數SDA GPIO 21、SCL GPIO 22不需要
14. I2C LCD 1602 顯示器顯示文字和開機秒數SDA GPIO 21、SCL GPIO 22不需要
15. MAX7219 點矩陣輪流顯示笑臉和愛心DIN GPIO 23、CLK GPIO 18、CS GPIO 5不需要
16. 手機控制 LED(同一個 Wi-Fi)手機網頁按鈕或文字指令控制 LED外接 LED 接 GPIO 18手機和板子要同一個 Wi-Fi
17. 語音控制 LED(MQTT)用語音控制頁說「開燈」、「關燈」、「閃爍」外接 LED 接 GPIO 18板子和手機都要能上網
18. DHT11 溫濕度警報手機網頁每 2 秒更新,濕度超過 50% 發出警報DHT11 DATA 接 GPIO 4手機和板子要同一個 Wi-Fi
19. Telegram 機器人控制 LED傳 /on、/off、/status 控制 LED,按按鈕時通知手機LED GPIO 18、按鈕 GPIO 19板子要能上網
20. DHT11 資料存到 Google 試算表每分鐘把溫度和濕度新增成一列,步驟見 Google 試算表DATA GPIO 4板子要能上網
21. I2C 掃描(找出裝置位址)列出接在 I2C 上的裝置位址和可能的型號,OLED、LCD 沒反應時先用它檢查SDA GPIO 21、SCL GPIO 22不需要
22. 按鈕中斷(IRQ)按鈕一按下就記錄,主程式每 2 秒才看一次也不會漏掉同範例 2:按鈕 GPIO 19、LED GPIO 18不需要
23. 計時器讓 LED 自己閃(Timer)計時器讓 LED 每 0.5 秒閃一次,主程式同時計數LED GPIO 18不需要
24. 深度睡眠定時醒來醒來閃一下 LED、記下第幾次醒來,再睡 10 秒板載 LED(GPIO 2)不需要
25. ESP-NOW 多塊板子互傳按任一塊板子的按鈕,所有板子的 LED 一起切換每塊板子都同範例 2不需要,板子之間直接傳
26. asyncio 同時做三件事LED 閃爍、監看按鈕、每 2 秒報告執行時間同時進行同範例 2:按鈕 GPIO 19、LED GPIO 18不需要
27. 儀表板入門:開關 LED、看按鈕手機儀表板的開關控制 LED,指示燈顯示按鈕有沒有按下,數字顯示按了幾下同範例 2:按鈕 GPIO 19、LED GPIO 18板子和手機都要能上網
28. DHT11 溫濕度儀表板手機上看溫度和濕度儀表、標有時間的濕度變化圖,溫度超過 30°C 時狀態文字會提醒DATA GPIO 4板子和手機都要能上網
29. 旋鈕和手機滑桿一起調 LED 亮度轉旋鈕或拉手機滑桿都能調 LED 亮度,轉旋鈕時手機的滑桿也會跟著動;儀表顯示旋鈕位置,「全亮」按鈕讓滑桿跳到 100%旋鈕 GPIO 34、LED GPIO 18板子和手機都要能上網
30. 手機選顏色點亮全彩 LED手機色盤選顏色,WS2812 燈條跟著變色,滑桿調亮度DIN GPIO 16板子和手機都要能上網
31. 手機方向鍵遙控車按住手機的方向鍵,車子前進、後退或轉彎,放開就停;手機斷線時自動停車L298N 或 L9110S:IN1–IN4 接 GPIO 18、19、21、22板子和手機都要能上網
32. 選單切換 LED 模式手機選單切換關、亮、閃爍、呼吸燈,儀表顯示目前亮度LED GPIO 18板子和手機都要能上網
33. 手機傳文字到 OLED在手機輸入英文,OLED 顯示出來;「清除畫面」按鈕清空SDA GPIO 21、SCL GPIO 22板子和手機都要能上網
34. 按鈕門鈴通知手機按下板子的按鈕,手機跳出提醒並發出聲音;手機按「回應」,LED 閃 3 秒同範例 2:按鈕 GPIO 19、LED GPIO 18板子和手機都要能上網
35. 手機調整濕度門檻手機上設定濕度門檻,濕度超過門檻時 LED 亮起DHT11 DATA GPIO 4、LED GPIO 18板子和手機都要能上網
36. 溫濕度紀錄表每隔一段時間把溫度和濕度記成一列,在手機下載 CSVDATA GPIO 4板子和手機都要能上網
37. 手機水平儀傾斜手機,OLED 上的小球往低的那一邊滾,放平時顯示 LEVEL!SDA GPIO 21、SCL GPIO 22板子和手機都要能上網
38. 手機搖桿遙控車推手機搖桿開車,推得越遠越快,放開就停;手機斷線時自動停車同範例 31:IN1–IN4 接 GPIO 18、19、21、22板子和手機都要能上網

進階技巧範例(21–26):22、23、25、26 都沿用範例 2 的接線,接好一次就能全部試。中斷和計時器的範例按「停止」時會關掉中斷和計時器,不然程式停了 LED 還會繼續動。ESP-NOW 要兩塊以上的板子,每塊都上傳同一份程式。深度睡眠請用「上傳並執行」,板子醒來後有 5 秒可以按「停止」;USB 直接接晶片的板子(S2、S3、C3)睡著時會斷線,醒來後要重新連接。

回程式編輯頁