Ubuntu 16.04 搭建 ESP8266 開發環境完整指南：編輯、編譯、燒錄

Ubuntu 16.04 搭建 ESP8266 開發環境完整指南：編輯、編譯、燒錄

系統環境與工具鏈概覽

軟體準備與安裝步驟

1. Eclipse CDT

至 eclipse.org 下載 C/C++ 開發者版本，解壓即用。

2. xtensa-lx106-elf 交叉編譯工具鏈

# 解壓至 /opt
sudo tar -vxjf xtensa-lx106-elf.tar.bz2 -C /opt/

# 設定環境變數
sudo gedit /etc/profile
# 在檔案末尾加入：
export PATH=/opt/xtensa-lx106-elf/bin:$PATH

# 套用生效
source /etc/profile

# 驗證：輸入 xtensa 按 Tab，若補全為 xtensa-lx106-elf- 即成功

3. esptool.py 燒錄工具

cd esptool
sudo cp esptool.py /usr/bin

4. pyserial 序列通訊庫

cd pyserial-master
sudo python2.7 setup.py install

專案建立與編譯

1. 下載 Espressif 官方提供的 Eclipse 專案版 SDK。
2. 匯入 Eclipse，直接點擊 Build 編譯，產生 user1.bin、user2.bin 等二進制檔。

燒錄韌體至 ESP8266

確認序列埠

ls /dev/tty*
# 通常為 ttyUSB0 或 ttyACM0

單一檔案燒錄

sudo python2.7 /usr/bin/esptool.py \
    --port /dev/ttyUSB0 \
    write_flash 0x01000 user1.bin

多檔案燒錄 (OTA 升級需兩個映像)

sudo python2.7 /usr/bin/esptool.py \
    --port /dev/ttyUSB0 \
    write_flash 0x01000 user1.bin 0x81000 user2.bin

燒錄過程會顯示進度百分比，完成後重置開發板即可運行新韌體。

常見問題排查

• 權限不足：將使用者加入 dialout 群組：sudo usermod -a -G dialout $USER，重新登入生效。
• esptool.py 找不到：確認已複製至 /usr/bin 且具備執行權限。
• 燒錄失敗：檢查接線（GPIO0 接地進入燒錄模式）、波特率、電源供應是否穩定。

環境建置完成後，即可在 Eclipse 中開發、編譯、除錯 ESP8266 應用程式，開啟物聯網開發之旅！