CrowPanel 7.0″ ESP32 HMI 顯示器快速入門：開箱檢查、Arduino IDE 環境設定、LVGL 上傳與黑屏問題排解

規格：Elecrow CrowPanel 7.0″ · 800×480 RGB TFT · 電容觸控（GT911）· ESP32-S3 · MicroSD 插槽 · USB-C

0. 開箱前先看（2 分鐘）

1. USB-C 供電開機：出廠已預燒 demo，螢幕應會亮起並顯示 UI 動畫。能開機即代表硬體正常。
2. 翻至背面確認 PCB 版本：例如 V1.2、V1.5。範例程式與背光控制會因版本而異，多數「黑屏」問題都是刷了錯誤版本的程式。
3. 確認型號：本文適用「標準版」CrowPanel 7.0（ESP32-S3），不是「Advance 7」（IPS 面板、額外麥克風/喇叭/RTC），也不是新款 ESP32-P4 Advanced 7。
4. 介面名稱陷阱：商品頁寫「RGB SPI」，實際上是 ESP32-S3 的 parallel RGB（DPI） 介面。因此 TFT_eSPI 不適用，請使用 Elecrow 的 LovyanGFX / Arduino_GFX 範例或 LVGL。

1. 建立開發環境（約 30 分鐘）

完整官方教學：Elecrow Blog — Lesson 1: Setting Up the Development Environment

安裝 Arduino IDE 與 ESP32 板級支援

1. 安裝 Arduino IDE 2.x：https://www.arduino.cc/en/software
2. 新增 ESP32 板級管理網址：
   • File → Preferences → Additional boards manager URLs 貼上：

     https://espressif.github.io/arduino-esp32/package_esp32_index.json

   • Tools → Board → Boards Manager 搜尋「esp32」並安裝 2.0.x 版（建議 2.0.15）。3.x 版有破壞性變更，會讓範例出現異常。
3. 安裝 USB 驅動（CH340/CH343）：接上板子後若沒出現 COM port，請從課程檔案的 Tool/CH340 資料夾安裝驅動，再重新插拔。

Board 設定（最容易出錯的地方）

必要函式庫

透過 Library Manager 安裝：

• lvgl 版本 8.3.3（Elecrow 範例不相容 9.x）
• LovyanGFX
• 其他範例註解中提到的函式庫

2. 首次上傳（Hello Screen）

1. 下載 課程檔案：github.com/Elecrow-RD/CrowPanel-ESP32-Display-Course-File
   • 內含各課程範例、CH340 驅動與函式庫。
2. 下載 板子專屬 repo：github.com/Elecrow-RD/CrowPanel-7.0-HMI-ESP32-Display-800×480
   • 內含 example_code7.0、出廠韌體、原理圖與硬體版本對照表。
3. 開啟 Lesson 01（Serial 測試）→ 上傳 → 開啟 Serial Monitor（鮑率依範例，通常 115200 或 9600）。能看到文字代表工具鏈正常。
4. 接著開啟 Lesson 02（LovyanGFX） → 上傳 → 螢幕應出現圖形。請選擇與 PCB 版本對應的資料夾。

若螢幕仍黑屏：90% 是以下三者之一：PCB 版本程式錯誤、PSRAM 未設為 OPI、ESP32 core 使用 3.x 而非 2.0.x。

3. 學習路徑：官方 16 課課程

YouTube 播放清單：CrowPanel ESP32 Display Tutorials — Elecrow (16 videos)

建議順序：Lesson 1 → 2 → 5 → 6。這條路徑能讓你在不手寫全部程式碼的情況下，開始設計自己的觸控 UI。

4. 不用手寫程式也能設計 UI

• SquareLine Studio：https://squareline.io — 視覺化 LVGL 編輯器，在 800×480 畫布上拖曳元件，匯出 C 程式碼後放入 Arduino 專案。課程 06–08 有詳細教學。
• LVGL 文件：https://docs.lvgl.io/8.3/ — 請務必對應函式庫版本 8.3。

5. 跳過 Arduino 的替代方案

6. 資源連結（2026 年 7 月確認有效）

7. 常見問題快速對照

延伸閱讀

• LILYGO T5 4.7″ 與 Elecrow CrowPanel 7.0″ 深度比較：低價 ESP32 螢幕能取代網頁儀表板嗎？
• 從 USD 8 到 4K 智慧螢幕：11 種 Dashboard / API 整合顯示器 CP 值選購全攻略