常見問題
安裝與連線
按「連接開發板」後,清單裡沒有序列埠
先換一條確定能傳輸資料的 USB 線,有些線只能充電。接著確認已安裝對應的驅動程式,並重新插拔開發板。
連接失敗,或顯示序列埠被佔用
關閉 Arduino IDE 和其他分頁裡的本網站,一次只能有一個程式使用序列埠。
顯示「沒有偵測到 MicroPython」
第一次使用,或燒錄過 Arduino 程式時都會這樣。按「安裝韌體」即可,不用另外下載韌體。
安裝韌體時一直連不上
網站會自動重新連接,最多試 10 次,每一次都會寫在監控窗。10 次都失敗時,請按住板子上的 IO0(BOOT)鍵再按「安裝韌體」,開始寫入後就可以放開。有些板子的自動重置電路不太穩,按住 IO0 是最可靠的做法。回報問題時,請一起提供監控窗裡「連線紀錄」下面的內容。
安裝韌體時出現 Serial data stream stopped
這時通常還沒開始清除,板子沒有損壞,會繼續執行原本的程式。請重新整理網頁、拔掉再插回 USB 線,重新連接後再裝一次,實測的 CH340 板就是這樣裝好的。還是失敗時,改插電腦本體的 USB 孔、換一條 USB 線,或按住 IO0 鍵、按一下 EN 鍵、放開 IO0 鍵後再安裝。
ESP32-S2、S3、C3 安裝韌體時連不上,或裝完沒有反應
USB 直接接晶片的板子,重新啟動時序列埠會暫時消失。連不上時,請按住 BOOT 鍵、按一下 RST 鍵、放開 BOOT 鍵,再重新按「連接開發板」並安裝。裝完後按一下 RST 鍵,等 2 秒再連接。板子有兩個 USB 孔時,可以改接標示 UART 或 COM 的那一個。
顯示「這塊板子是 ESP32-xx,目前只支援 ESP32、ESP32-S2、S3 和 C3」
這塊板子的晶片不在支援範圍內,內建韌體不能用。請改用這四種晶片的開發板。
晶片選錯了,上傳後板子會壞掉嗎?
選單選錯不會影響韌體,安裝時網站會自己偵測晶片。上傳的程式也不會改動韌體,但腳位可能不對。ESP32 選成 S2、S3 或 C3 時,範例可能用到 GPIO 6–11,板子可能當機或一直重新啟動。這種情況只要重新選對晶片和範例後上傳;上傳不了時,請按住 IO0 鍵重新安裝韌體。真正可能損壞板子的是接線,例如把 5V 接到 GPIO、電源短路,或腳位輸出時直接接到電源或 GND。
執行程式
監控窗出現紅色的「程式發生錯誤」
按「複製給 Gemini」,把錯誤訊息和程式碼一起貼給 Gemini 修正,再把新程式貼回來上傳。
看不懂範例或 Gemini 給的程式
按「Gemini 提示詞」→「解說整份程式」,貼給 Gemini,它會分段解說並標出行號。只看不懂其中幾行,就先選取那幾行再打開選單,見 Gemini 提示詞。
按下「停止」後,程式之後還會自動執行嗎?
會。「停止」只中斷目前的執行,main.py 還在板子上,下次通電或重新啟動時會再次執行。「停止」不是暫停,沒辦法從停下來的地方接著跑;要馬上再執行,按監控窗上方的「重新啟動」,程式會從頭開始。用「執行(不存檔)」試跑的程式,則是再按一次「執行(不存檔)」。
用「執行(不存檔)」試好了,怎麼讓它通電就自動執行?
按「上傳並執行」,程式會存成 main.py。「執行(不存檔)」的程式只在記憶體裡,重新啟動或拔掉電源就會消失。
可以用 ESP32-CAM 拍照嗎?
目前不行。MicroPython 官方韌體沒有相機模組,要改用第三方編譯的韌體才能拍照,網站沒有內建。
網路與手機
顯示 Wi-Fi 連線失敗
確認名稱和密碼完全正確(包含大小寫),並確認是 2.4GHz 網路。
手機打不開 192.168.x.x 的網頁
確認手機和開發板連同一個 Wi-Fi,也關閉手機的行動數據試試。校園網路可能禁止裝置互連,可以改用手機熱點,或語音控制頁(MQTT)。
沒有跳出麥克風權限,語音不能用
確認開啟的是 HTTPS 的語音控制頁,不是 http://192.168.x.x。如果之前拒絕過,請到瀏覽器的網站設定改成允許。
語音控制頁顯示「開發板沒有回應」或「離線」
確認開發板程式正在執行、監控窗顯示已連上 MQTT 伺服器,以及頁面和程式裡的主題名稱完全相同。校園網路可能會擋 1883 連接埠,可以改用手機熱點測試。
語音控制頁顯示「MQTT 帳號或密碼不正確」
確認帳號密碼和伺服器設定相同,以及這個帳號有權限使用 esp32-mp-class/ 開頭的 Topic。密碼不會儲存,重新整理後要再輸入一次。
Google 試算表範例顯示「Google 沒有回傳 ok」
通常是部署時存取權沒有選「所有人」,或學校帳號不允許。請先用瀏覽器的無痕視窗開啟網址測試,應該要顯示 ok。資料沒有增加時,也請確認網址結尾是 /exec。
隱私與安全
- 程式碼:網站不會把程式碼上傳到伺服器。程式碼只存在這個瀏覽器和你的開發板上。GitHub 只提供網站檔案,可能記錄 IP 這類連線資訊,但收不到你的程式碼。
- 瀏覽統計:網站用 GoatCounter 統計頁面瀏覽人次,頁尾顯示的是編輯器頁面的累計人次。每次開啟頁面時,只會送出頁面路徑、頁面標題和來源網站,GoatCounter 也會收到瀏覽器必然帶上的 IP 和瀏覽器資訊,用來估算不重複的訪客。統計不使用 Cookie,也不會送出程式碼、Wi-Fi 密碼、序列埠內容或 MQTT 主題名稱。
- Wi-Fi 密碼:密碼寫在程式裡,所以會以明文存在瀏覽器和開發板的
main.py。網站也會在這個瀏覽器記住最後用的 Wi-Fi 名稱和密碼,載入範例時自動填入。使用共用電腦或借出開發板前,請先刪除密碼,做法見下方「共用電腦與開發板」。 - 貼給 Gemini 前:「解說程式」、「複製給 Gemini」和「改寫成 MicroPython」會自動隱藏常見的 Wi-Fi、帳號密碼、Token 和 Apps Script 網址寫法,但不保證全部偵測得到。自己全選複製程式時不會隱藏,請先刪除密碼。
- 截圖和投影:編輯器會顯示密碼,投影或分享畫面前請先遮住。上課建議使用專用 Wi-Fi 或手機熱點。
- 語音控制和手機儀表板:資料會經過公用 MQTT 伺服器,沒有加密保護和權限控管,知道主題名稱的人都能看到和控制。只適合 LED 這類低風險實驗,不要控制插座或門鎖,也不要在主題名稱填入個人資料。
- 語音辨識:語音由瀏覽器和其語音服務辨識,通常需要連網。
- Telegram Bot Token:Token 等於機器人的密碼,拿到的人可以冒用機器人,不要投影或分享。不小心外洩時,請到 @BotFather 傳
/revoke換一組。範例不驗證伺服器憑證,不要用來控制重要設備。
共用電腦與開發板
關閉網頁不會清除程式碼。程式碼和裡面的 Wi-Fi 密碼會留在瀏覽器,下一個用同一台電腦、同一個瀏覽器帳號的人打開網站就看得到。
離開電腦或交還開發板前,請照下面做:
- 想留下程式:先刪除程式裡的 Wi-Fi 名稱、密碼、MQTT 帳號密碼、Bot Token 和 Apps Script 網址,再按「下載 main.py」。下載的檔案不會自動隱藏這些資料。
- 清除瀏覽器:刪除編輯器裡的全部內容。編輯器會自動儲存,所以舊內容會一起被取代,網站記住的 Wi-Fi 名稱和密碼也會一起清除。
- 清除開發板:上傳不含密碼的程式,會覆蓋板子上的
main.py;其他含有密碼的檔案可以在板上檔案刪除。要清除板子上所有檔案,請重新安裝韌體。
電腦教室的還原卡通常會在重新開機後清除瀏覽器資料,但重新開機前,下一位使用者還是看得到。開發板不受還原卡影響,資料會一直留在板子上。