Banggood ESP32開發板

規格

• 產品名稱：ESP32-S3-LCD-1.47
• 開發工具：Arduino IDE、ESP-IDF

使用說明

ESP32-S3-LCD-1.47 目前提供 Arduino IDE 和 ESP-IDF 兩種開發工具和框架，提供靈活的開發選擇，您可以根據專案需求和個人習慣選擇合適的開發工具。

開發工具

Arduino整合開發環境
Arduino IDE 是一個開源電子原型開發平台，方便靈活，易於上手。簡單學習後即可快速上手開發。同時，Arduino 擁有龐大的全球用戶社區，提供豐富的開源程式碼、專案範例和工具。amp文件和教程，以及豐富的庫資源，封裝了複雜的函數，讓開發者能夠快速實現各種功能。

靜電除塵器
ESP-IDF，全名為 Espressif IDE，是樂鑫科技為 ESP 系列晶片推出的專業開發架構。它採用 C 語言開發，包含編譯器、偵錯器、燒寫工具等，可以透過命令列或整合開發環境（例如帶有 Espressif IDF 插件的 Visual Studio Code）進行開發。該插件提供程式碼導航、專案管理和調試等功能。

這兩種開發方法各有其優勢tag開發人員可以根據自身需求和技能等級進行選擇。 Arduino 易於學習，上手速度快，適合初學者和非專業人士。 ESP-IDF 是具有專業背景或高效能要求的開發人員的更好選擇，因為它為複雜專案的開發提供了更先進的開發工具和更強大的控制能力。
操作前，建議先瀏覽目錄，快速了解文件結構。為了操作順利，請仔細閱讀常見問題解答，事先了解可能遇到的問題。文件中所有資源均提供超鏈接，方便下載。

使用 Arduino

本章介紹 Arduino 開發環境的搭建，包括 Arduino IDE 的使用、ESP32開發板的管理、相關函式庫的安裝、程式的編譯與下載以及測試 demo 等，旨在幫助使用者快速掌握 Arduino 開發板的使用方法，並方便進行二次開發。

環境設置

下載並安裝 Arduino IDE

• 點擊訪問官方 web站點，選擇對應的系統和系統位元進行下載。
• 運行安裝程式並預設安裝所有內容。

安裝ESP32開發板

• 為了在 Arduino IDE 中使用與 ESP32 相關的主機板，必須安裝 Espressif Systems 的 esp32 主機板的軟體包
• 根據 Board 安裝需求，一般建議使用線上安裝。如果線上安裝失敗，請使用離線安裝
• Espressif Systems 的 esp32 開發板隨附離線套件。點此下載：esp32_package_3.0.2_arduino 離線套件

ESP32-S3-LCD-1.47所需開發板安裝說明

董事會名稱
樂鑫的 esp32

電路板安裝要求
“離線安裝”/“線上安裝”

版本號要求
≥3.0.2

安裝庫

• 安裝 Arduino 庫時，通常有兩種方式可供選擇：線上安裝和離線安裝。如果庫安裝需要離線安裝，則必須使用提供的庫 file
  對於大多數庫，使用者可以透過 Arduino 軟體的線上庫管理器輕鬆搜尋並安裝。但有些開源庫或自訂庫未同步到 Arduino 庫管理器，無法透過線上搜尋獲取，只能手動離線安裝。
• 庫安裝教學請參考Arduino庫管理器教學課程
• ESP32-S3-LCD-1.47 庫 file 儲存在ample 程序，點此跳轉：ESP32-S3-LCD-1.47 Demo

ESP32-S3-LCD-1.47 庫安裝說明

更多LVGL的學習與使用請參考LVGL官方文檔

運行第一個 Arduino 演示
如果您剛開始使用 ESP32 和 Arduino，並且不知道如何建立、編譯、燒錄和運行 Arduino ESP32 程序，請擴展並查看。希望對您有幫助！

示範

ESP32-S3-LCD-1.47 演示

Arduino專案參數設定

LVGL_Arduino

硬體連接

• 將開發板連接到電腦

程式碼分析

1. 設定()
   • Flash_test()：測試並列印裝置的快閃記憶體大小資訊
   • SD_Init()：初始化TF卡
   • LCD_Init()：初始化顯示
   • Set_Backlight(90)：設定背光亮度為90
   • Lvgl_Init()：初始化LVGL圖形庫
   • Lvgl_Example1()：呼叫特定的 LVGL examp函數
   • Wireless_Test2()：呼叫無線通訊的測試函數
2. 環形（）
   • Timer_Loop()：處理定時器相關任務的函數
   • RGB_Lamp_Loop(2): 定期更新RGB燈光顏色

結果演示

液晶屏顯示

更多LVGL的學習與使用請參考LVGL官方文檔

LCD_影像

TF卡準備

• 新增圖像範例amp將 Waveshare 提供的文件放入 TF 卡中

硬體連接

• 插入包含ex的TF卡amp將影像導入設備
•  將開發板連接到電腦

程式碼分析

1. 設定()
   • Flash_test()：測試並列印裝置的快閃記憶體大小資訊
   • SD_Init()：初始化TF卡
   • LCD_Init()：初始化顯示
   • Set_Backlight(90)：設定背光亮度為90
2. 環形（）
   • Image_Next_Loop(“/”, “.png”, 300): 顯示PNG file每隔一定時間間隔依序在TF卡根目錄下
   • RGB_Lamp_Loop(2): 定期更新RGB燈光顏色

結果演示

• LCD 顯示 PNG file每隔一定間隔依序在TF卡根目錄下

使用 ESP-IDF

本章介紹如何建構 ESP-IDF 環境，包括 Visual Studio 和 Espressif IDF 插件的安裝、程式的編譯、下載以及測試 example程序，幫助使用者掌握開發板，方便進行二次開發。

環境設置

下載並安裝 Visual Studio
開啟VScode官方的下載頁面 web站點，選擇相應的系統和系統位元進行下載

運行安裝包後，其餘的可以預設安裝，但這裡為了後續的體驗，建議勾選1、2、3項

• 前兩項啟用後，可以直接右鍵開啟VSCode file或目錄，這可以提高後續的使用者體驗。
• 第三項啟用後，選擇如何開啟時直接選擇VSCode即可。

環境設定在 Windows 10 系統上進行，Linux 和 Mac 使用者可以存取 ESP-IDF 環境設定進行參考

安裝 Espressif IDF 插件

• 一般建議使用線上安裝，如果因為網路原因導致線上安裝失敗，請使用離線安裝
• 有關如何安裝 Espressif IDF 插件的更多信息，請參閱安裝 Espressif IDF 插件

運行第一個 ESP-IDF 演示

如果您剛開始使用 ESP32 和 ESP-IDF，並且不知道如何建立、編譯、燒寫和運行 ESP-IDF ESP32 程序，請擴展並查看。希望對您有幫助！

示範

ESP32-S3-LCD-1.47 演示

ESP32-S3-LCD-1.47-測試

硬體連接

• 將開發板連接到電腦

程式碼分析

1. 設定()
   • Wireless_Init()：初始化無線通訊模組
   • Flash_Searching()：測試並列印裝置的快閃記憶體大小資訊
   • RGB_Init()：初始化RGB相關函數
   • RGB_Example()：顯示exampRGB 函數
   • SD_Init()：初始化TF卡
   • LCD_Init()：初始化顯示
   • BK_Light(50)：設定背光亮度為50
   • LVGL_Init()：初始化LVGL圖形庫
   • Lvgl_Example1()：呼叫特定的 LVGL examp函數
2. 同時(1)
   • vTaskDelay(pdMS_TO_TICKS(10))：短暫延遲，每10毫秒
   • lv_timer_handler()：LVGL的定時器處理函數，用於處理與時間相關的事件和動畫

結果演示

LCD顯示板載參數：

Flash 韌體的燒寫與擦除

目前演示提供了測試固件，可以用來測試
透過直接刷寫測試固件，板載設備功能正常

•  垃圾桶 file 小路：

..\ESP32-SS-LCD-1.47-Demo\固件

Flash 韌體的刷新與擦除 供參考

資源

示意圖

• ESP32-S3-LCD-1.47 原理圖

示範

• ESP32-S3-LCD-1.47 演示

數據表

• 1.47吋LCD資料表及其他 files

軟件工具

Arduino

• Arduino IDE 官方下載鏈接
• esp32_package_3.0.2_arduino離線包

VScode

• VScode 官方 web地點

Flash下載工具

• Flash_download_tool_3.9.5_0

其他資源連結

• ESP32-Arduino 官方文檔
•  LVGL官方文檔

常問問題

模組下載demo後重新下載為什麼有時候連接不上串口或刷機失敗？

長按BOOT鍵，同時按下RESET，然後放開RESET，再放開BOOT鍵，此時模組即可進入下載模式，可以解決大部分無法下載的問題。

為什麼模組在連接電源時會不斷重設並閃爍 view從裝置管理員查看識別狀態？

可能是因為Flash空白以及USB口不穩定導致的，可以長按BOOT鍵，同時按下RESET鍵，然後鬆開RESET，再鬆開BOOT鍵，此時模組可以進入下載模式刷寫固件（demo）來解決該情況。

程式第一次編譯極度緩慢怎麼辦？

第一次編譯比較慢是正常現象，耐心點就好。

ESP-IDF 燒寫成功後，串列埠顯示等待下載如何處理？

如果開發板上有重設按鈕，請按下重設按鈕；如果沒有重設按鈕，請重新上電

如果我找不到 App Data 資料夾該怎麼辦？

有些 AppData 資料夾預設是隱藏的，可以設定為顯示。英文系統資源管理器->View->檢查隱藏項目中文系統 File 探索者 -> View -> 顯示 -> 檢查隱藏項目

如何檢查我使用的 COM 連接埠？

Windows系統 View 透過裝置管理員 按 Windows + R 鍵開啟執行對話方塊；輸入 devmgmt.msc 並按 Enter 開啟裝置管理員；展開連接埠（COM 和 LPT）部分，其中將列出所有 COM 連接埠及其目前狀態。使用命令提示符 view 開啟命令提示字元（CMD），輸入mode指令，會顯示所有COM連接埠的狀態資訊。檢查硬體連接如果已經連接了外部設備到COM端口，該設備通常會佔用一個端口號，可以透過檢查連接的硬體來確定。

文件/資源

Banggood ESP32開發板 [pdf] 指示 1.47，ESP32開發板，ESP32，開發板

參考

• 使用者手冊