目前是測試 Beta 版,只支援傳統 ESP32(例如 NodeMCU ESP-32S)。上傳後,板子上原有的 MicroPython 或其他程式會被取代。之後要回到 MicroPython,請到 MicroPython 版重新安裝韌體。
開始使用
- 用電腦版 Chrome 或 Edge 開啟本站,並用學校的 Google 帳號登入(
@gm.tntcsh.tn.edu.tw)。 - 用可以傳資料的 USB 線接上開發板,按「連接開發板」。
- 選一個範例,或按「複製 Gemini 提示詞」請 Gemini 產生程式,再貼到編輯器。
- 按「編譯並上傳」。結果會顯示在右邊的序列埠監控窗。連不上開發板時,再按住板子上的 IO0(BOOT)鍵重試一次。
想先檢查程式有沒有錯,可以按「只編譯」,這時不用接開發板。監控窗一直顯示亂碼時,請確認鮑率和程式裡 Serial.begin() 的數字相同。
編譯要等一下,人多時要排隊。用到 Wi-Fi 或 HTTPS 的程式,編譯時間通常比基本範例長很多,跟程式行數不一定有關。全班同時按時可能要多等幾分鐘,也可能看到「使用人數較多,請稍後再試」。可以分批按,或先確定程式改好再編譯。程式沒有修改時再次上傳,不會重新編譯。
和 MicroPython 版的差異
| Arduino 版(本站) | MicroPython 版 | |
|---|---|---|
| 語言 | Arduino C++ | MicroPython(Python 語法) |
| 上傳方式 | 先在雲端編譯,再燒錄到板子 | 不用編譯,直接把程式傳到板子 |
| 開發板 | 傳統 ESP32 | ESP32、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 33 | Echo 輸出常是 5V,要先分壓成 3.3V 才能接 GPIO。 |
| 10. DHT11 溫濕度 | 已編譯 | GPIO 4 | VCC 接 3V3,讀取間隔至少 1 秒。 |
| 11. DS18B20 溫度 | 已編譯 | GPIO 4 | DATA 和 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),還可以用:
- DHT sensor library、Adafruit Unified Sensor
- Adafruit NeoPixel、ESP32Servo
- Adafruit SSD1306、Adafruit GFX Library、LiquidCrystal I2C、MD_MAX72XX
- PubSubClient、ArduinoJson
- OneWire、DallasTemperature
請 Gemini 寫程式的訣竅
- 寫清楚型號和腳位:例如「MAX7219 8×8 點矩陣,DIN 接 GPIO 23,CLK 接 GPIO 18,CS 接 GPIO 5」。
- 只用一個檔案:本站只編譯一份
.ino,不能放多個檔案。 - 出現
No such file or directory:代表程式用了沒有安裝的函式庫,請 Gemini 改用上面這些函式庫。「複製 Gemini 提示詞」已經包含這些要求。
接線注意事項
接線或改線前,請先拔掉 USB 線。接錯電壓或短路可能會燒毀開發板。
- GPIO 只能接受 3.3V:不要把 5V 訊號直接接到 GPIO。
- 不要直接驅動大電流元件:馬達、長燈條等要用外部電源或驅動模組。使用外部電源時,GND 要和 ESP32 接在一起。
- 確認腳位編號:程式裡的編號是 GPIO 編號,請對照板子標示或腳位圖。
- Wi-Fi 只支援 2.4GHz:ESP32 連不上 5GHz 網路。
| 腳位 | 建議 | 原因 |
|---|---|---|
| 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 機器人
- 在 Telegram 搜尋 @BotFather,傳
/newbot,依指示取名後會拿到 Bot Token。 - 範例選「Telegram 機器人控制 LED」,填入 Wi-Fi 名稱、密碼和
BOT_TOKEN,按「編譯並上傳」。 - 傳任一則訊息給你的機器人,監控窗會顯示 CHAT_ID。把號碼填進程式,再上傳一次。
- 傳
/on、/off或/status控制 LED;按下按鈕時,手機會收到通知。
板子約每 2 秒查一次新訊息,反應會有幾秒延遲。只有 CHAT_ID 指定的聊天室能控制板子,開機前累積的舊指令不會執行。校園網路封鎖 Telegram 時,板子會連不上,可以改用手機熱點。
把感測器資料存到 Google 試算表
範例「DHT11 資料存到 Google 試算表」每分鐘會把時間、溫度和濕度新增成一列。Google Apps Script 是免費服務,但要先設定一次。這個範例已編譯成功,尚未接實體 Google 試算表測試。
- 到 Google 試算表建立新檔案,在第一列輸入標題:時間、溫度、濕度。
- 點選「擴充功能」→「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"); } - 點選「部署」→「新增部署作業」,類型選「網頁應用程式」。執行身分選「我」,存取權選「所有人」,再依畫面完成授權。
- 複製部署後的網址,結尾是
/exec。先在瀏覽器網址列的網址後面加上?temp=25&hum=60開啟,畫面顯示ok、試算表多一列,就代表設定正確。測試完可以刪除這一列。 - 範例選「DHT11 資料存到 Google 試算表」,填入 Wi-Fi 名稱、密碼和
SCRIPT_URL,按「編譯並上傳」。
網址等於試算表的寫入權限。知道網址的人都能新增資料,不要投影或分享。不小心外洩時,請到「部署」→「管理部署作業」封存這個部署,再建立新的部署。
學校的 Google 帳號可能不允許把存取權設成「所有人」,這時請改用個人帳號。之後修改 Apps Script,要在「管理部署作業」選編輯並發布新版本,才會生效。
隱私與安全
- 程式碼:按編譯時,程式碼會傳到編譯服務。編譯完成後立刻刪除,不會保存,也不會寫進紀錄。
- Wi-Fi 密碼和 Token:寫在程式裡的密碼會以明文存在瀏覽器,也會編譯進開發板。使用共用電腦或借出開發板前,請先清除。
- 貼給 Gemini 前:「複製給 Gemini」會自動隱藏常見的 Wi-Fi、帳號密碼、Token 和 Apps Script 網址寫法,但不保證全部偵測得到。自己全選複製程式時不會隱藏。
- 截圖和投影:編輯器會顯示密碼,投影或分享畫面前請先遮住。
- Telegram Bot Token:Token 等於機器人的密碼,不要投影或分享。不小心外洩時,請到 @BotFather 傳
/revoke換一組。範例不驗證伺服器憑證,不要用來控制重要設備。
共用電腦與開發板
關閉網頁不會清除程式碼。程式碼會留在瀏覽器,下一個用同一台電腦、同一個瀏覽器帳號的人打開網站就看得到。
- 想留下程式:先刪除程式裡的密碼和 Token,再按「下載 sketch.ino」。下載的檔案不會自動隱藏這些資料。
- 清除瀏覽器:刪除編輯器裡的全部內容。編輯器會自動儲存,所以舊內容會一起被取代。
- 登出:到「設定與說明」按「登出」,再關閉分頁。
- 清除開發板:上傳不含密碼的程式,取代板子上原本的程式。
常見問題
為什麼要登入?
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。