學習路徑
38 個範例分成初階、中階、進階三級,照順序做就能一步一步學會。點範例名稱會把它載入編輯器,載入前會先問你要不要取代目前的程式。每一步都有「動手改改看」,沒有標準答案,改壞了重新載入範例就好。看不懂程式時,可以用 Gemini 提示詞的「解說程式」請 Gemini 說明。
| 等級 | 範例 | 建議時數 | 學完能做到 |
|---|---|---|---|
| 初階 | 1–5 | 約 4 節 | 上傳和執行程式、看懂監控窗和錯誤提示,控制 LED 和蜂鳴器 |
| 中階 | 6–15、21 | 約 8 節 | 讀取各種感測器、用圖表觀察數值,把結果顯示在螢幕和燈光上 |
| 進階 | 16–20、22–38 | 約 12 節(30–38 依器材和時間選做) | 讓程式同時做好幾件事,連上手機和雲端服務,用手機儀表板看數值、控制板子,做出省電或多塊板子合作的作品 |
給老師:建議時數以一節 50 分鐘計算,包含接線和動手改改看,不包含學生自己的專題。第一節課還要安裝驅動程式和韌體,可以先在課前幫板子裝好韌體。中階的感測器很多,器材不夠時可以分組,每組做不同的感測器再互相分享。
初階:讓 LED 和蜂鳴器動起來
- 學完能做到:連接開發板、上傳和執行程式,看懂監控窗的輸出和錯誤提示;用數位輸出入、PWM 和類比讀值控制 LED 和蜂鳴器。
- 建議時數:約 4 節。
- 材料:ESP32 開發板和能傳資料的 USB 線、麵包板、杜邦線、LED、220Ω 電阻、按鈕、10kΩ 可變電阻、無源蜂鳴器。
- 用到的網站功能:上傳並執行、執行(不存檔)、監控窗和錯誤提示、REPL 即時指令。
- 1. LED 閃爍:用
Pin.OUT控制腳位、while True一直重複、time.sleep暫停。順便比較「執行(不存檔)」和「上傳並執行」的差別。動手改改看:把間隔改成 0.2 秒;再試著做出「亮 0.2 秒、暗 1 秒」的節奏。 - 3. 呼吸燈(PWM):用 PWM 的
duty_u16調整亮度,用for和range一步一步改變數值。動手改改看:讓呼吸慢一倍;再改成最亮只到 50%。 - 4. 可變電阻調亮度:用
ADC讀類比電壓,得到 0 到 65535 的數字,再交給 PWM。動手改改看:反過來,旋鈕轉越多,LED 越暗。 - 5. 無源蜂鳴器播放小星星:頻率決定音高,用字典存音名、用串列存旋律。動手改改看:把
BEAT_MS改小讓歌變快;再把SONG換成「兩隻老虎」(C D E C、C D E C、E F G、E F G)。
中階:感測器和顯示器
- 學完能做到:讀取光線、人體、距離、溫濕度等感測器,用圖表觀察數值;把結果顯示在 OLED、LCD 和燈光上;接線有問題時會用 I2C 掃描檢查。
- 建議時數:約 8 節。
- 材料:SG90 伺服馬達和外部 5V 電源、光敏電阻和 10kΩ 電阻、HC-SR501、有源蜂鳴器模組、HC-SR04 和分壓用的 1kΩ、2kΩ 電阻、DHT11、DS18B20(裸元件要加 4.7kΩ 電阻)、SSD1306 OLED 或 I2C LCD 1602、WS2812 燈條、MAX7219 點矩陣。
- 用到的網站功能:圖表與 CSV、板上檔案、Gemini 提示詞的「寫新程式」、接線注意事項。
- 6. SG90 伺服馬達來回轉動:用 50 Hz 脈衝的寬度控制角度,自己寫函式
set_angle。馬達要用外部 5V 供電。動手改改看:改成只在 45 度到 135 度之間擺動。 - 7. 光敏電阻自動夜燈:讀感測器,再用門檻決定要不要開燈。動手改改看:打開圖表看亮度變化,找出適合你教室的
DARK_LEVEL。 - 8. 人體紅外線警報(HC-SR501):狀態改變時才印出,監控窗才不會洗版。動手改改看:偵測到人時,讓蜂鳴器「嗶、嗶」地響,不要一直響。
- 9. 超音波測距(HC-SR04):量回音的時間來換算距離;5V 的訊號要先分壓才能接 ESP32。動手改改看:距離小於 10 公分時印出「太近了!」,再加上 LED 或蜂鳴器提醒。
- 10. DHT11 溫濕度(監控窗):匯入感測器模組,用
try和except處理讀取失敗。動手改改看:打開圖表,對感測器呵一口氣,看濕度怎麼變化;再匯出 CSV,用試算表畫圖。 - 11. DS18B20 溫度計:單線(1-Wire)通訊,一條線可以串好幾顆感測器。動手改改看:把溫度換算成華氏,和攝氏一起印出來。
- 21. I2C 掃描(找出裝置位址):I2C 用位址區分裝置;接顯示器前,先確認板子找得到它。動手改改看:把 OLED 和 LCD 接在同一組 SDA、SCL 上,看看能不能同時掃到兩個位址。
- 13. SSD1306 OLED 顯示器:先在記憶體裡寫字、畫線,呼叫
show()後畫面才會更新。動手改改看:多顯示一行你的名字,再用oled.rect()畫一個外框。 - 14. I2C LCD 1602 顯示器:用
move_to(欄, 列)決定文字的位置。動手改改看:把秒數改成「分:秒」的格式,例如01:05。 - 12. WS2812 全彩 LED 彩虹:用(紅, 綠, 藍)三個數字表示顏色,呼叫
write()後燈條才會更新。動手改改看:讓整條燈一起輪流顯示紅、綠、藍。 - 15. MAX7219 點矩陣:用 0 和 1 組成的二進位數字畫 8×8 的圖案。動手改改看:自己設計一個圖案,例如箭頭,加進輪播。
進階:同時做好幾件事,連上網路
- 學完能做到:用中斷、計時器和 asyncio 讓程式同時處理好幾件事;讓板子和手機、雲端服務互動,用手機儀表板看數值、控制板子;做出省電或多塊板子合作的作品。
- 建議時數:約 12 節。
- 材料:範例 2 的按鈕和 LED、DHT11、10kΩ 可變電阻、2.4GHz 的 Wi-Fi、手機;選做的範例 30–38 另外要 WS2812 燈條、SSD1306 OLED、馬達驅動板和小車;Telegram 範例要 Telegram 帳號,Google 試算表範例要 Google 帳號;ESP-NOW 要兩塊以上的板子。
- 用到的網站功能:Gemini 提示詞的「解說程式」、手機與語音控制、手機儀表板、Google 試算表、隱私與安全(程式裡有 Wi-Fi 密碼時要注意)。
- 23. 計時器讓 LED 自己閃(Timer):計時器定時呼叫函式,主程式同時做別的事;用
finally收尾。動手改改看:再加一個計時器,每 3 秒在監控窗印一次訊息。 - 26. asyncio 同時做三件事:asyncio 是「非同步輸入輸出」,等待時先去做別的事。用
async def和await讓好幾個工作輪流執行。動手改改看:加第四個工作,每 5 秒用gc.mem_free()印出剩下多少記憶體。 - 16. 手機控制 LED(同一個 Wi-Fi):連上 Wi-Fi,讓板子當網頁伺服器,用 asyncio 同時處理網頁和閃爍。動手改改看:在網頁上多加一個「快閃」按鈕。
- 18. DHT11 溫濕度警報:手機網頁每 2 秒向板子要一次 JSON 資料。動手改改看:把警報門檻從 50% 改成適合你教室的數字。
- 17. 語音控制 LED(MQTT):透過網路上的 MQTT 伺服器,在不同的 Wi-Fi 之間收發訊息。動手改改看:加上一顆按鈕,按下時切換 LED,並回報狀態,讓語音控制頁跟著更新。
- 27. 儀表板入門:開關 LED、看按鈕:用
dash建立手機上的元件,.set()把值送到手機,.value讀手機上的開關。動手改改看:加一個board.text("訊息"),按下按鈕時顯示「有人按了!」。 - 28. DHT11 溫濕度儀表板:同一個數值可以同時給儀表和折線圖,儀表可以用
color=選顏色;用時間差每 3 秒讀一次感測器,board.check()照樣一直執行。對感測器哈氣,濕度變化最明顯。動手改改看:加一個board.led("太熱", color="red"),溫度超過HOT時亮紅燈。 - 29. 旋鈕和手機滑桿一起調 LED 亮度:手機的滑桿和按鈕控制板子;轉旋鈕時,板子用
.set()把手機的滑桿移到同樣的位置,兩邊誰最後動就聽誰的。動手改改看:加一個「關燈」按鈕,按下時把滑桿設成 0。 - 30. 手機選顏色點亮全彩 LED:色盤的值是(紅, 綠, 藍)三個 0~255 的數字,和範例 12 的燈條用同一種寫法。動手改改看:加一個「彩虹」開關,打開時燈條自己變換顏色。
- 31. 手機方向鍵遙控車:用兩支 PWM 腳控制一顆馬達的方向和速度;方向鍵要按住才會動,手機斷線時板子會自己停車。動手改改看:轉彎時改成一邊輪子慢、一邊快,轉得比較平順。
- 32. 選單切換 LED 模式:用
time.ticks_ms()算出閃爍和呼吸燈的亮度,不用time.sleep等待。動手改改看:在選單加一個「SOS」模式,閃出三短三長三短。 - 33. 手機傳文字到 OLED:
.changed()有新文字時才更新畫面,長文字切成一行 16 個字。動手改改看:在 OLED 最下面一行顯示收到了幾則訊息。 - 34. 按鈕門鈴通知手機:提醒只在發生時送出,不會保留;手機和板子可以互相通知。動手改改看:改用範例 8 的人體紅外線感測器,有人經過就通知手機。
- 35. 手機調整濕度門檻:
board.number()讓手機調整門檻,.changed()知道手機改了;每一圈都和最新的門檻比較,不用改程式就能做實驗。動手改改看:再加一個溫度門檻,兩個都超過才亮燈。 - 36. 溫濕度紀錄表:
board.log()把每次的數值記成一列,時間由手機加上;記錄間隔也用數字設定調整。動手改改看:記錄 10 分鐘後下載 CSV,用試算表畫出濕度的折線圖。 - 37. 手機水平儀:
board.tilt()讀手機的傾斜,tilt.x、tilt.y是 -100~100;有變化才重畫 OLED,畫面才不會一直閃。動手改改看:水平時讓範例 2 的 LED 亮起來。 - 38. 手機搖桿遙控車:
board.joystick()的前進和轉彎相加、相減,就是左右輪的速度;搖桿在中間附近不動,手指抖動也不會亂跑。動手改改看:把搖桿換成board.tilt(),傾斜手機來開車。 - 19. Telegram 機器人控制 LED:用 HTTPS 呼叫網路上的 API,按鈕用中斷做記號,網路工作留給主程式。動手改改看:加一個
/blink指令,讓 LED 閃 5 下。 - 20. DHT11 資料存到 Google 試算表:把資料放在網址參數裡,送給 Apps Script 寫進試算表。動手改改看:先把
SEND_SECONDS改成 10 秒測試,再用收集到的資料在試算表畫一張折線圖。 - 24. 深度睡眠定時醒來:睡著時幾乎不耗電,RTC 記憶體在睡眠時會保留資料,醒來就像重新開機。動手改改看:醒來時讀一次 DHT11 再去睡,做成省電的溫度記錄器。
- 25. ESP-NOW 多塊板子互傳:板子之間直接傳訊息,不用經過 Wi-Fi 基地台。動手改改看:改成傳送「按了第幾次」,收到的板子在監控窗印出來。
學完進階範例後,可以挑一個挑戰專題,把好幾個範例組合成完整的作品。