支援的開發板
網站內建 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 MHz | 520 KB | 傳統藍牙和 BLE | 最普遍,教材最多,腳位多 | 已實測 |
| ESP32-S3 | 雙核心 240 MHz | 512 KB,可外加 PSRAM | BLE 5 | 腳位最多,可接相機,適合進階使用 | 待實測 |
| ESP32-C3 | 單核心 160 MHz(RISC-V) | 400 KB | BLE 5 | 便宜小巧,腳位較少 | 待實測 |
| ESP32-S2 | 單核心 240 MHz | 320 KB | 沒有藍牙 | 已被 S3 取代,市面上少見,不必特地找 | 待實測 |
| ESP32-C2(ESP8684) | 單核心 120 MHz(RISC-V) | 272 KB | BLE 5 | 最便宜,用來取代 ESP8266,記憶體最小 | 不支援 |
- S3 開發板的型號:例如 N16R8,表示 16 MB 快閃記憶體和 8 MB 八線 PSRAM。八線 PSRAM 會占用 GPIO 35–37,這三支腳不要接元件。板子有兩個 Type-C 孔時,先接標示 COM 或 UART 的那個。
- 名稱有 CAM 的開發板:本站的韌體沒有相機功能,只能當一般開發板使用。
- C3、S2、S3 開發板:有些沒有 USB 轉序列晶片,直接用晶片內建的 USB,不用裝驅動。
可以用 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 只能接受 3.3V:不要把 5V 訊號直接接到 GPIO。
- 不要直接驅動大電流元件:馬達、長燈條等要用外部電源或驅動模組。使用外部電源時,GND 要和 ESP32 接在一起。
- 確認腳位編號:程式裡的編號是 GPIO 編號,請對照板子標示或腳位圖。
| 腳位 | 建議 | 原因 |
|---|---|---|
| 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、S3 | C3 |
|---|---|---|
| LED | GPIO 18 | GPIO 4 |
| 按鈕 | GPIO 17 | GPIO 5 |
| 類比輸入(光敏電阻、可變電阻) | GPIO 1 | GPIO 3 |
| DHT11、DS18B20 | GPIO 4 | GPIO 5 |
| I2C(SDA、SCL) | GPIO 8、9 | GPIO 6、7 |
| 蜂鳴器 | GPIO 14 | GPIO 6 |
| 伺服馬達 | GPIO 13 | GPIO 6 |
| WS2812 | GPIO 16 | GPIO 6 |
| USB 使用,不要接元件 | GPIO 19、20 | GPIO 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 溫濕度 | 有範例 | dht | VCC 接 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、ds18x20 | DATA 和 3V3 之間要接 4.7kΩ 上拉電阻,模組通常已內建。 |
| HC-SR04 超音波 | 有範例 | Pin、time_pulse_us | Echo 輸出常是 5V,要先分壓成 3.3V 才能接 GPIO。 |
請 Gemini 寫程式的訣竅
- 寫清楚型號和腳位:例如「MAX7219 8×8 點矩陣,DIN 接 GPIO 23,CLK 接 GPIO 18,CS 接 GPIO 5」。
- 缺少模組時:如果執行時出現
ImportError,代表程式用了韌體沒有的模組。可以請 Gemini「把這個元件的控制程式和主程式寫在同一份 main.py」,或用板上檔案把那個模組的檔案上傳到板子。 - 指定語言:說明要 MicroPython v1.29.0,不要 Arduino C++。網站的「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. 溫濕度紀錄表 | 每隔一段時間把溫度和濕度記成一列,在手機下載 CSV | DATA 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)睡著時會斷線,醒來後要重新連接。