你是否也曾被ESP32的顯示開發折磨到“頭禿”？環境配置報錯、LVGL移植失敗、屏幕死活不亮……無數個小時在調試中白白浪費。

別擔心，這篇指南就是你的“速救手冊”。我們將跳過所有繁瑣的坑，直擊核心，讓你在最短時間內，親眼看到LVGL界面在啟明智顯ESP32-S3 2.8寸屏上流暢運行。無需痛苦的摸索，跟著我們的步驟，從零到一，全程暢通無阻。

搭建ESP-IDF環境

1. 輸入以下代碼更新軟件包：sudo apt-get update

2. 輸入以下代碼安裝esp-idf環境依賴包：

sudo apt-get install git wget flex bison gperf python3-pip python3-venv cmake

ninja-build ccache libffi-dev libssl-dev dfu-util libusb-1.0-0 net-tools）

3. 創建存放idf的?件夾，路徑可以??選擇（mkdir esp cd esp）

4. 進行換源(此操作只需國內?戶進?,國外?戶請忽略)，拉取gitee?具

5. 輸入代碼cd esp-gitee-tools執?gitee?具切換鏡像腳本

6. 更換pip源，拉取esp-idf源碼：

cd .. git clone --recursive https://github.com/espressif/esp-idf.git

7. 切換esp-idf版本分?到v5.1

8.安裝編譯?具

9.設置環境變量并將環境變量放到.bashrc中，驗證esp-idf環境

下載啟明SDK

1. 輸入以下代碼拉取源碼，該拉取流程中已集成 LVGL demo 相關資源：git clone https://gitee.com/qiming-zhixian/qmsd-esp32-bsp.git2. 進?示例目錄，輸入以下代碼選擇開發板類型：idf.py load-board，以ZX2D80CE02S這款產品為例，鍵盤輸?2，回車等待系統配置完成3.編譯工程 idf.py build4. 打包固件 idf.py generate-firmware 會?成?個firmware_0x0.bin?件，將打包的固件復制到桌面上

燒錄

1.輸入以下網址進入官網下載燒錄工具，點擊Download,選擇flash Download Tool進行下載：

https://www.espressif.com/zh-hans/support/download/other-tools

2. 打開燒錄工具，ZX2D80CE02S選擇類型為ESP32-S3 ，點擊ok

3. 選擇需要燒錄的固件,目標地址為0x0.選擇目標端口號

4. 點擊START開始燒錄

一移植LVGL官方例程到qmsd

1. 輸入qmsd的示例get-start,我們的修改將基于get-start進行

2. 新建自定義組件目錄，輸入代碼mkdir components獲取LVGL8.10.0源代碼

3.解壓后進?此目錄下將其復制到widgets目錄下

4. 編寫CMakeLists.txt使程序加?構建系統

idf_component_register(

SRC_DIRS .

INCLUDE_DIRS .

REQUIRES ui_engine）

5. 修改復制的?件,使其適配qmsd

6. 修改mian.c，在app_main（Void）中添加以下代碼開啟GUI刷新任務

7. 輸入以下配置代碼將屏幕變為橫屏

8. 選擇開發板類型(選擇開發板時出錯可以嘗試將啟明SD添加進環境變量)，開始編譯

9. 編譯失敗，此次失敗原因是芯片內部 32KB 內存不足，需修改配置

10.再次編譯，再次打包固件并復制到桌面上替換，按照之前的燒錄步驟再次燒錄

本地代碼合成

1. 編寫?個串口初始化函數

2. 修改main_app(Void)

3. 創建?個串口接收線程

4. 修改LVGL界?

跟著這份指南一步步操作，相信你已經成功點亮了屏幕，并看到了屬于自己的LVGL界面。這不僅是代碼的成功運行，更是你攻克嵌入式UI開發難題的堅實一步。

如果在實踐中遇到任何問題，或者成功做出了炫酷的效果，歡迎在評論區分享你的成果與經驗——你的真實經歷，就是幫助其他開發者最寶貴的力量。