ESP32 Lab Arduino 版 使用說明

內容更新:2026 年 11 月 1 日

回程式編輯頁

目前是測試 Beta 版,只支援傳統 ESP32(例如 NodeMCU ESP-32S)。上傳後,板子上原有的 MicroPython 或其他程式會被取代。之後要回到 MicroPython,請到 MicroPython 版重新安裝韌體。

開始使用

  1. 用電腦版 Chrome 或 Edge 開啟本站,並用學校的 Google 帳號登入(@gm.tntcsh.tn.edu.tw)。
  2. 用可以傳資料的 USB 線接上開發板,按「連接開發板」。
  3. 選一個範例,或按「複製 Gemini 提示詞」請 Gemini 產生程式,再貼到編輯器。
  4. 按「編譯並上傳」。結果會顯示在右邊的序列埠監控窗。連不上開發板時,再按住板子上的 IO0(BOOT)鍵重試一次。

想先檢查程式有沒有錯,可以按「只編譯」,這時不用接開發板。監控窗一直顯示亂碼時,請確認鮑率和程式裡 Serial.begin() 的數字相同。

編譯要等一下,人多時要排隊。用到 Wi-Fi 或 HTTPS 的程式,編譯時間通常比基本範例長很多,跟程式行數不一定有關。全班同時按時可能要多等幾分鐘,也可能看到「使用人數較多,請稍後再試」。可以分批按,或先確定程式改好再編譯。程式沒有修改時再次上傳,不會重新編譯。

和 MicroPython 版的差異

Arduino 版(本站)MicroPython 版
語言Arduino C++MicroPython(Python 語法)
上傳方式先在雲端編譯,再燒錄到板子不用編譯,直接把程式傳到板子
開發板傳統 ESP32ESP32、S2、S3、C3
立即試指令(REPL)沒有有
需要韌體嗎不用,上傳的程式就包含全部要先安裝 MicroPython 韌體
登入學校 Google 帳號不用
程式碼會離開電腦嗎編譯時會傳到編譯服務,完成後刪除不會

兩邊的程式不能互通,切換版本時要改寫程式,可以把程式貼給 Gemini 請它改寫。相同題目的範例使用相同編號和相同腳位,所以接線不用改。只有 17 號不同:本站是序列埠指令,MicroPython 版是語音控制。

為什麼沒有 REPL

本站沒有 REPL。MicroPython 的板子上有直譯器,打一行就能馬上執行。Arduino 程式要先編譯才能燒進板子,板子上沒有直譯器可以接收新程式,所以每次修改都要重新編譯。

監控窗下方的輸入框是「傳文字給開發板」:文字會傳給正在執行的程式,由程式用 Serial.read 自行處理,如果程式沒有讀取,就不會有任何反應。想練習這種互動,可以選範例 17「用序列埠下指令控制 LED」,然後輸入 on、off 或 status。

支援的開發板

開發板狀態說明
NodeMCU ESP-32S已實測板載 LED 在 GPIO 2。
其他 ESP32-WROOM-32 開發板應可使用快閃記憶體要有 4 MB 以上,USB 晶片要是 CP210x 或 CH340。板載 LED 的腳位可能不同。
ESP32-CAM尚未測試晶片是傳統 ESP32,但板子本身沒有 USB,要接底板或 USB 轉序列埠模組。相機功能尚未測試,也沒有範例。
ESP32-S2、S3、C3、C6 等不支援第一版只編譯傳統 ESP32 的程式。這些板子請改用 MicroPython 版(S2、S3、C3)。
ESP8266、Arduino UNO 等不支援不是 ESP32。

「Arduino 版」可以用 Arduino UNO 嗎?

不行。這裡的 Arduino 指的是寫程式用的 Arduino 框架(setup()、digitalWrite() 等),不是 Arduino 這塊開發板。本站只能編譯和燒錄 ESP32 的程式。傳統的 UNO R3 晶片和燒錄方式都不同,沒有 Wi-Fi,記憶體也小很多。MicroPython 版同樣不支援 UNO。

兩個版本支援的開發板

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

Arduino 框架本身也支援 ESP32-S2、S3、C3。本站第一版先只做傳統 ESP32,不是因為這些晶片不能寫 Arduino。

瀏覽器請用電腦版 Chrome 或 Edge。手機和 Firefox、Safari 沒有 Web Serial,無法連接開發板。

電子元件與範例

下表不是限制清單。只要函式庫裝得到,表上沒有的元件也能用。請把完整型號和接線腳位告訴 Gemini。

範例或元件狀態預設腳位注意事項
1. LED 閃爍已實測GPIO 2外接 LED 要串聯限流電阻(例如 220Ω)。
2. 按鈕開關 LED已編譯按鈕 GPIO 19、LED GPIO 18使用內部上拉。GPIO 34–39 沒有內部上拉。
3. 呼吸燈(PWM)已編譯GPIO 18
4. 可變電阻調亮度已編譯可變電阻 GPIO 34、LED GPIO 18類比輸入請用 GPIO 32–39。
5. 無源蜂鳴器已編譯GPIO 25有源蜂鳴器通電就響,不能改音高。買之前先確認。
6. SG90 伺服馬達已編譯GPIO 13建議用外部 5V 供電,並和 ESP32 共地。
7. 光敏電阻自動夜燈已編譯GPIO 34、18裸元件要搭配 10kΩ 電阻分壓。
8. HC-SR501 人體紅外線已編譯GPIO 27、25、18通常用 5V 供電,訊號約 3.3V。通電後約 1 分鐘內可能誤判。
9. HC-SR04 超音波已編譯Trig GPIO 26、Echo GPIO 33Echo 輸出常是 5V,要先分壓成 3.3V 才能接 GPIO。
10. DHT11 溫濕度已編譯GPIO 4VCC 接 3V3,讀取間隔至少 1 秒。
11. DS18B20 溫度已編譯GPIO 4DATA 和 3V3 之間要接 4.7kΩ 上拉電阻,模組通常已內建。
12. WS2812 全彩 LED已編譯GPIO 16燈數多時電流很大,要用外部電源並共地。
13. SSD1306 OLED已編譯SDA 21、SCL 22位址通常是 0x3C。
14. I2C LCD 1602已編譯SDA 21、SCL 22許多模組用 5V 供電,I2C 訊號可能被上拉到 5V,接線前要先確認電壓。
15. MAX7219 點矩陣已編譯GPIO 23、18、5通常用 5V 供電,3.3V 訊號可能不穩定。
16. 手機控制 LED已實測GPIO 18手機和開發板要連同一個 Wi-Fi,用瀏覽器開啟監控窗顯示的網址。
17. 用序列埠下指令控制 LED已編譯GPIO 2在監控窗下方輸入 on、off 或 status。
18. DHT11 溫濕度警報已編譯GPIO 4手機和開發板要連同一個 Wi-Fi,用瀏覽器開啟監控窗顯示的網址。
19. Telegram 機器人已編譯GPIO 18、19設定步驟見 Telegram 機器人。
20. Google 試算表已編譯GPIO 4設定步驟見 Google 試算表。

語音控制目前只有 MicroPython 版提供。

可以用的函式庫

目前不能自行安裝函式庫。除了 ESP32 核心內建的函式庫(例如 WiFi、WebServer、HTTPClient、Wire),還可以用:

請 Gemini 寫程式的訣竅

接線注意事項

接線或改線前,請先拔掉 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)。

Telegram 機器人

  1. 在 Telegram 搜尋 @BotFather,傳 /newbot,依指示取名後會拿到 Bot Token。
  2. 範例選「Telegram 機器人控制 LED」,填入 Wi-Fi 名稱、密碼和 BOT_TOKEN,按「編譯並上傳」。
  3. 傳任一則訊息給你的機器人,監控窗會顯示 CHAT_ID。把號碼填進程式,再上傳一次。
  4. 傳 /on、/off 或 /status 控制 LED;按下按鈕時,手機會收到通知。

板子約每 2 秒查一次新訊息,反應會有幾秒延遲。只有 CHAT_ID 指定的聊天室能控制板子,開機前累積的舊指令不會執行。校園網路封鎖 Telegram 時,板子會連不上,可以改用手機熱點。

把感測器資料存到 Google 試算表

範例「DHT11 資料存到 Google 試算表」每分鐘會把時間、溫度和濕度新增成一列。Google Apps Script 是免費服務,但要先設定一次。這個範例已編譯成功,尚未接實體 Google 試算表測試。

  1. 到 Google 試算表建立新檔案,在第一列輸入標題:時間、溫度、濕度。
  2. 點選「擴充功能」→「Apps Script」,把原本的內容換成下面的程式後儲存:
    function doGet(e) {
      var temp = Number(e.parameter.temp);
      var hum = Number(e.parameter.hum);
      if (isNaN(temp) || isNaN(hum)) {
        return ContentService.createTextOutput("bad data");
      }
      var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
      sheet.appendRow([new Date(), temp, hum]);
      return ContentService.createTextOutput("ok");
    }
  3. 點選「部署」→「新增部署作業」,類型選「網頁應用程式」。執行身分選「我」,存取權選「所有人」,再依畫面完成授權。
  4. 複製部署後的網址,結尾是 /exec。先在瀏覽器網址列的網址後面加上 ?temp=25&hum=60 開啟,畫面顯示 ok、試算表多一列,就代表設定正確。測試完可以刪除這一列。
  5. 範例選「DHT11 資料存到 Google 試算表」,填入 Wi-Fi 名稱、密碼和 SCRIPT_URL,按「編譯並上傳」。

網址等於試算表的寫入權限。知道網址的人都能新增資料,不要投影或分享。不小心外洩時,請到「部署」→「管理部署作業」封存這個部署,再建立新的部署。

學校的 Google 帳號可能不允許把存取權設成「所有人」,這時請改用個人帳號。之後修改 Apps Script,要在「管理部署作業」選編輯並發布新版本,才會生效。

隱私與安全

共用電腦與開發板

關閉網頁不會清除程式碼。程式碼會留在瀏覽器,下一個用同一台電腦、同一個瀏覽器帳號的人打開網站就看得到。

  1. 想留下程式:先刪除程式裡的密碼和 Token,再按「下載 sketch.ino」。下載的檔案不會自動隱藏這些資料。
  2. 清除瀏覽器:刪除編輯器裡的全部內容。編輯器會自動儲存,所以舊內容會一起被取代。
  3. 登出:到「設定與說明」按「登出」,再關閉分頁。
  4. 清除開發板:上傳不含密碼的程式,取代板子上原本的程式。

常見問題

為什麼要登入?

Arduino 程式要先在雲端主機編譯才能上傳,用量超過免費額度就要付費,所以只開放本校師生使用。登入只用來確認你是本校帳號,網站不會讀取你的信件或雲端硬碟。MicroPython 版不用編譯,所以不用登入。

編譯要等多久?

主要看程式用到哪些函式庫,不一定跟行數有關。基本範例通常比較快,用到 Wi-Fi 或 HTTPS 的程式會久很多。編譯時畫面會顯示已經過的秒數,完成後也會顯示總共花了幾秒。

登入時顯示「已封鎖存取權」或「不是學校帳號」

本站只開放 @gm.tntcsh.tn.edu.tw 帳號。請確認登入的不是個人 Gmail。學校帳號還是不能登入時,請聯絡老師。

顯示「登入已過期」

登入大約一小時後會過期。重新登入即可,編輯器裡的程式和開發板連線都不受影響。

顯示「使用人數較多,請稍後再試」

編譯服務暫時滿了,等一下再按一次。程式不會遺失。

按「連接開發板」後,清單裡沒有序列埠

先換一條確定能傳輸資料的 USB 線,有些線只能充電。接著確認已安裝對應的驅動程式(在「設定與說明」裡),並重新插拔開發板。

連接失敗,或顯示序列埠被佔用

關閉 Arduino IDE 和其他分頁裡的本網站,一次只能有一個程式使用序列埠。

上傳時一直連不上開發板

網站會自動重試幾次,監控窗會顯示「正在重新連接開發板」,這是正常現象,請等它試完。全部失敗時,請按住板子上的 IO0(BOOT)鍵再上傳一次,看到「正在寫入程式」後再放開。還是不行時,可以按住 IO0 鍵、按一下 EN(RST)鍵再放開 EN,然後才按上傳。

編譯錯誤怎麼看?

編輯器會跳到第一個錯誤的那一行,例如 sketch.ino:5:3 代表第 5 行第 3 個字。也可以按「複製給 Gemini」請它幫忙修正。

網路上的舊程式編譯失敗

本站使用 Arduino-ESP32 核心 3.3 版。舊程式常用的 ledcSetup() 和 ledcAttachPin() 已移除,請改用 ledcAttach()。

監控窗顯示「程式當機並重新啟動了」

按「複製給 Gemini」,把當機訊息和程式碼一起貼給 Gemini 修正。

上傳後監控窗一直是亂碼

把監控窗的鮑率改成和程式裡 Serial.begin() 相同的數字。範例都用 115200。

Wi-Fi 一直連不上

確認名稱和密碼完全正確(包含大小寫),並確認是 2.4GHz 網路。

手機打不開 192.168.x.x 的網頁

確認手機和開發板連同一個 Wi-Fi,也關閉手機的行動數據試試。校園網路可能禁止裝置互連,可以改用手機熱點。

Google 試算表範例顯示「這次沒有存成功」

通常是部署時存取權沒有選「所有人」,或學校帳號不允許。請先用瀏覽器的無痕視窗開啟網址測試,應該要顯示 ok。資料沒有增加時,也請確認網址結尾是 /exec。

回程式編輯頁