ESP32 環境監測 01:開發環境建置與第一個程式(LED 閃爍)

這是「ESP32 環境監測」系列的第 1 篇。本篇會完成開發環境建置,並上傳第一個程式,讓 ESP32 的內建 LED 閃爍。做完之後,你就具備了後續所有實作的基礎。

本篇重點
・安裝 Arduino IDE 與 ESP32 開發板套件
・選擇正確的開發板與連接埠
・上傳 Blink 程式並用序列埠監控視窗檢查
難度:入門 預估時間:30 分鐘

整體流程

ESP32 開發環境建置流程 ① 安裝 Arduino IDE 2.x ② 偏好設定加入 ESP32 套件網址 ③ 開發板管理員安裝 esp32 ④ 選擇開發板與連接埠 ⑤ 上傳程式,LED 閃爍

一、材料準備

  • ESP32 開發板 1 片(例如 ESP32 DevKit 或 LOLIN32)
  • 支援資料傳輸的 USB 線 1 條(有些線只能充電,無法傳資料)
  • 電腦 1 台(Windows、macOS、Linux 皆可)

二、安裝 Arduino IDE

  1. 前往 Arduino 官網的軟體下載頁面,下載 Arduino IDE 2.x 版(網址:https://www.arduino.cc/en/software)。
  2. 依作業系統完成安裝。
  3. 第一次開啟時,若出現防火牆或驅動程式的詢問,選擇允許即可。

三、安裝 ESP32 開發板套件

Arduino IDE 預設不認識 ESP32,需要先加入 Espressif 官方提供的套件來源。

  1. 開啟「檔案 → 偏好設定」(macOS 為「Arduino IDE → Settings」)。
  2. 找到「額外的開發板管理員網址」,貼上下列網址:
    https://espressif.github.io/arduino-esp32/package_esp32_index.json
  3. 按「確定」儲存。
  4. 左側點選「開發板管理員」圖示(或選單「工具 → 開發板 → 開發板管理員」)。
  5. 搜尋 esp32,找到作者為 Espressif Systems 的「esp32」,按「安裝」。下載需要一些時間,請耐心等候。

四、連接開發板並選擇設定

  1. 用 USB 線把 ESP32 接上電腦。
  2. 選單「工具 → 開發板 → esp32」,選擇你的開發板。不確定型號時,選 ESP32 Dev Module 通常可以正常運作。
  3. 選單「工具 → 連接埠」,選擇新出現的連接埠(Windows 為 COM 開頭,macOS 與 Linux 為 /dev/ 開頭)。
找不到連接埠?
1. 先換一條確定能傳資料的 USB 線。
2. 開發板上的 USB 轉序列晶片常見為 CP210x 或 CH340,若電腦沒有自動辨識,需要另外安裝對應的驅動程式。
3. 換一個 USB 埠,或重新插拔後再看一次連接埠清單。

五、第一個程式:讓 LED 閃爍

多數 ESP32 開發板的內建 LED 接在 GPIO 2,下面的程式會讓它每秒亮滅一次,同時在序列埠輸出訊息。

電腦、ESP32 與內建 LED 的連接示意 電腦 Arduino IDE USB 線 ESP32 開發板 晶片 GPIO 2 內建 LED 亮 / 滅 序列埠輸出(速率 115200)
// 內建 LED 腳位(多數 ESP32 開發板為 GPIO 2)
const int LED_PIN = 2;

void setup() {
  Serial.begin(115200);       // 啟動序列埠,速率 115200
  pinMode(LED_PIN, OUTPUT);   // 設定腳位為輸出
  Serial.println("ESP32 啟動完成");
}

void loop() {
  digitalWrite(LED_PIN, HIGH);  // LED 亮
  Serial.println("LED ON");
  delay(1000);

  digitalWrite(LED_PIN, LOW);   // LED 滅
  Serial.println("LED OFF");
  delay(1000);
}

程式說明

  • setup():開機後只執行一次,用來做初始設定。
  • loop():設定完成後反覆執行。
  • pinMode():指定腳位是輸入還是輸出。
  • digitalWrite():輸出高電位(亮)或低電位(滅)。
  • delay(1000):暫停 1000 毫秒,也就是 1 秒。

六、上傳與驗證

  1. 按左上角的「上傳」按鈕(向右箭頭)。
  2. 等下方輸出視窗出現上傳完成的訊息。若停在「Connecting...」,請在這時按住開發板上的 BOOT 按鈕,直到開始寫入再放開。
  3. 內建 LED 開始每秒閃爍,就代表成功。
  4. 開啟「工具 → 序列埠監控視窗」,右下角速率選 115200,應該能看到 LED ON 與 LED OFF 交替出現。

七、常見問題

  • 上傳失敗或一直顯示 Connecting:按住 BOOT 按鈕再上傳,並確認連接埠選對。
  • LED 沒有亮:你的開發板內建 LED 可能不在 GPIO 2,請查閱該板的腳位圖,修改 LED_PIN。
  • 序列埠出現亂碼:通常是速率不一致,請確認監控視窗速率與程式中的 Serial.begin(115200) 相同。

八、延伸挑戰

  • 把閃爍間隔改成 200 毫秒,觀察變化。
  • 改成連續閃 3 次後暫停 2 秒(可以使用 for 迴圈)。

下一篇預告

環境與上傳流程都確認沒問題了。下一篇我們要接上 DHT11 感測器,讀取溫度與濕度。


系列:ESP32 環境監測
目錄:系列總整理 | 下一篇:用 DHT11 讀取溫濕度

留言

熱門文章