xiaozhi-esp32 適配 Freenove ESP32-S3 Display 2.8 寸電容觸屏板引腳配置、觸摸交互與固件構建全解析【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本指南以 freenove-esp32s3-display-2.8-lcd 板卡目錄為核心系統講解小智 AI 語音助手xiaozhi-esp32對該開發板的完整適配從硬件識別、引腳映射、LCD/觸摸/音頻驅動初始化到構建系統接入與固件燒錄流程。讀完本文你將掌握這塊板卡的驅動架構、觸控手勢邏輯并能獨立完成固件配置、編譯與問題排查。板卡概覽一塊帶觸摸屏的 ESP32-S3 語音終端Freenove ESP32-S3 Display 2.8型號 FNK0104是一塊集成 2.8 英寸 240×320 分辨率 IPS 電容觸摸屏的 ESP32-S3 開發板同時板載 WiFi 與藍牙能力是典型的帶屏語音交互終端形態。該板卡在 xiaozhi-esp32 倉庫中以獨立板卡類型freenove-esp32s3-display-2.8-lcd提供完整支持被列為官方適配目標之一并在 docs/esp-idf-6-migration.md 的 IDF 6.0.1 遷移驗證矩陣中標注為通過完整構建。板卡目錄結構main/boards/freenove-esp32s3-display-2.8-lcd/遵循倉庫標準的一板一目錄規范文件作用ReadMe.md板卡簡介與硬件信息來源config.h引腳分配與硬件參數宏定義config.json板卡類型聲明與構建配置freenove-esp32s3-display-2.8-lcd.cc板級初始化與驅動粘合代碼官方說明指出該板卡與 LCD wiki 的 ES3C28P/ES3N28P 很可能采用相同的硬件設計這意味著本文的驅動分析對同系板卡同樣具有參考價值。引腳映射config.h 全量解讀config.h 是板卡的硬件身份證定義了音頻、按鍵、顯示三大子系統所需的全部引腳與參數。音頻子系統ES8311 編解碼器#define AUDIO_INPUT_SAMPLE_RATE 24000 #define AUDIO_OUTPUT_SAMPLE_RATE 24000 //音頻iis部分 #define AUDIO_I2S_GPIO_MCLK GPIO_NUM_4 //MCLK #define AUDIO_I2S_GPIO_BCLK GPIO_NUM_5 //SCK #define AUDIO_I2S_GPIO_DIN GPIO_NUM_6 //DIN #define AUDIO_I2S_GPIO_WS GPIO_NUM_7 //LRC #define AUDIO_I2S_GPIO_DOUT GPIO_NUM_8 //DOUT #define AUDIO_CODEC_PA_PIN GPIO_NUM_1 //PA //音頻iic部分 #define AUDIO_CODEC_I2C_NUM I2C_NUM_0 #define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_15 #define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_16 #define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR輸入/輸出采樣率統一為 24 kHz這是小智語音鏈路的標準采樣率由 audio/codecs/es8311_audio_codec.cc 中的Es8311AudioCodec驅動支持。音頻走 I2S 總線MCLK(4)、BCLK(5)、WS(7)、DOUT(8) 輸出、DIN(6) 輸入PA 功放使能引腳為 GPIO1。編解碼器控制走 I2C0SCL15、SDA16地址使用 ES8311 默認地址ES8311_CODEC_DEFAULT_ADDR即 0x18。按鍵與指示燈#define BOOT_BUTTON_GPIO GPIO_NUM_0 #define BUILTIN_LED_GPIO GPIO_NUM_42啟動按鍵接 GPIO0ESP32 系通用 BOOT 鍵板級代碼中將其注冊為Button交互源。板載 LED 接 GPIO42由SingleLed驅動見下文GetLed()。顯示子系統ILI9341 串行 SPI#define DISPLAY_BACKLIGHT_PIN GPIO_NUM_45 #define DISPLAY_RST_PIN GPIO_NUM_NC #define DISPLAY_SCK_PIN GPIO_NUM_12 #define DISPLAY_DC_PIN GPIO_NUM_46 #define DISPLAY_CS_PIN GPIO_NUM_10 #define DISPLAY_MOSI_PIN GPIO_NUM_11 #define DISPLAY_MIS0_PIN GPIO_NUM_13 #define DISPLAY_SPI_SCLK_HZ (20 * 1000 * 1000) #define LCD_SPI_HOST SPI3_HOST #define LCD_TYPE_ILI9341_SERIAL #define DISPLAY_WIDTH 320 #define DISPLAY_HEIGHT 240 #define DISPLAY_MIRROR_X false #define DISPLAY_MIRROR_Y false #define DISPLAY_SWAP_XY true #define DISPLAY_INVERT_COLOR true #define DISPLAY_RGB_ORDER LCD_RGB_ELEMENT_ORDER_BGR #define DISPLAY_OFFSET_X 0 #define DISPLAY_OFFSET_Y 0 #define DISPLAY_BACKLIGHT_OUTPUT_INVERT false #define DISPLAY_SPI_MODE 0幾個關鍵點的工程含義分辨率與方向DISPLAY_WIDTH320、DISPLAY_HEIGHT240即物理橫屏 320×240DISPLAY_SWAP_XYtrue使邏輯坐標與面板方向匹配DISPLAY_INVERT_COLORtrue表明該面板需要顏色反相ILI9341 常見配置RGB 順序為 BGR。SPI 總線使用SPI3_HOST時鐘 20 MHzSPI Mode 0MISO 引腳GPIO13仍被定義InitializeSpi()中同樣配置了miso_io_num說明該板 SPI 為全雙工接線。背光GPIO45 輸出 PWM 背光DISPLAY_BACKLIGHT_OUTPUT_INVERTfalse表示高電平點亮DISPLAY_RST_PINGPIO_NUM_NC表示復位腳未單獨引出由面板自身管理復位。板級驅動實現從 I2C 到觸控的完整初始化鏈freenove-esp32s3-display-2.8-lcd.cc 定義了FreenoveESP32S3Display類繼承自WifiBoard構造順序即外設初始化順序InitializeI2c() → InitializeBatteryMonitor() → InitializeSpi() → InitializeLcdDisplay() → InitializeTouch() → InitializeButtons() → InitializeTools()I2C 總線與觸控芯片InitializeI2c()通過 ESP-IDF 新的i2c_master驅動創建 I2C0 總線i2c_new_master_bus并啟用內部上拉。該總線被音頻編解碼器與觸控芯片共用。TouchDriver封裝了電容觸控芯片的讀取協議bool Read(bool touched, uint16_t x, uint16_t y) { uint8_t reg 0x02; uint8_t buf[5]; i2c_master_transmit_receive(dev_, reg, 1, buf, 5, 50); uint8_t points buf[0] 0x0F; ... x ((buf[1] 0x0F) 8) | buf[2]; y ((buf[3] 0x0F) 8) | buf[4]; }從源碼結構看InitializeTouch()以 I2C 地址0x38掛載觸控芯片讀取寄存器0x02獲得觸點數量低 4 位及 12 位精度的 X/Y 坐標坐標寄存器同樣只有高 12 位有效每次輪詢超時 50ms——這符合常見電容觸控控制器如 FT 系列的協議形態。觸控數據由獨立 FreeRTOS 任務TouchTask棧 4096優先級 5固定運行在核心 0每 50ms 輪詢一次。觸控手勢單擊、雙擊與長按TouchTask是這塊板卡交互的核心它把原始觸摸事件翻譯成三個語音助手手勢手勢判定條件動作單擊按下時長 ≤ 3000ms且與上一次單擊間隔 ≥ 250msapp.ToggleChatState()切換聊天狀態雙擊兩次單擊間隔 250msapp.StartListening()開始聆聽長按按下時長 3000msEnterWifiConfigMode()進入 WiFi 配網模式其判定流程為檢測按下瞬間記錄down_start抬起時計算press now - down_start先判斷是否超過 3000ms 長按進入配網否則再判斷距上次單擊是否小于 250ms 以識別雙擊雙擊會立即清空last_tap防止三連擊誤判。這套邏輯直接映射到 application.cc 的ToggleChatState/StartListening接口實現了不依賴實體按鍵的純觸控人機交互。LCDILI9341 面板初始化InitializeLcdDisplay()完整展示了 ESP-IDFesp_lcd驅動框架的接入方式配置esp_lcd_panel_io_spi_config_tCSGPIO10、DCGPIO46、spi_mode0、pclk_hz20MHz、命令/參數位寬 8 位通過esp_lcd_new_panel_io_spi注冊到SPI3_HOST配置esp_lcd_panel_dev_config_t16 位色深、reset_gpio_numGPIO_NUM_NC、RGB 順序 BGR調用esp_lcd_new_panel_ili9341創建 ILI9341 面板依次執行esp_lcd_panel_reset→esp_lcd_panel_init→invert_color(true)→swap_xy(true)→mirror(false, false)封裝為SpiLcdDisplay并賦值給display_后續由 main/display/lcd_display.cc 統一對接 LVGL 渲染。音頻與電量兩個虛函數覆寫virtual AudioCodec* GetAudioCodec() override { static Es8311AudioCodec audio_codec(codec_i2c_bus_, AUDIO_CODEC_I2C_NUM, AUDIO_INPUT_SAMPLE_RATE, AUDIO_OUTPUT_SAMPLE_RATE, AUDIO_I2S_GPIO_MCLK, AUDIO_I2S_GPIO_BCLK, AUDIO_I2S_GPIO_WS, AUDIO_I2S_GPIO_DOUT, AUDIO_I2S_GPIO_DIN, AUDIO_CODEC_PA_PIN, AUDIO_CODEC_ES8311_ADDR, true, true); return audio_codec; }GetAudioCodec()返回以 ES8311 為編解碼器的實例開啟輸入輸出雙通道GetBacklight()返回 GPIO45 的PwmBacklightGetLed()返回 GPIO42 的SingleLed。GetBatteryLevel()通過AdcBatteryMonitor實現InitializeBatteryMonitor()中使用ADC_UNIT_1、ADC_CHANNEL_8上下分壓電阻均按 200kΩ 配置參考電壓引腳為GPIO_NUM_NC使用內部參考。這是倉庫 main/boards/common/adc_battery_monitor.cc 提供的通用 ADC 電量監測方案。實體按鍵的補充邏輯InitializeButtons()給 BOOT 鍵GPIO0注冊了點擊回調若設備仍處于kDeviceStateStarting啟動中則先進入 WiFi 配網模式否則切換聊天狀態——與觸摸手勢形成雙通道交互冗余。構建系統接入Kconfig 與 CMake 的注冊點該板卡不是孤立目錄而是被完整接入了倉庫構建體系Kconfig 注冊main/Kconfig.projbuildconfig BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD bool Freenove ESP32-S3 Display 2.8-inch LCD depends on IDF_TARGET_ESP32S3通過depends on IDF_TARGET_ESP32S3限定目標芯片為 ESP32-S3。CMake 分支main/CMakeLists.txtelseif(CONFIG_BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD) set(BOARD_DIR freenove-esp32s3-display-2.8-lcd) set(BUILTIN_TEXT_FONT font_noto_sans_basic_20_4) set(BUILTIN_ICON_FONT font_material_symbols_20_4) set(DEFAULT_EMOJI_COLLECTION noto-color-emoji_64)為 240×320 分辨率選擇了 20px 級字體與 64px Emoji 集合符合 docs/custom-board.md 中中屏240×320配*_20_4字體的選型建議。類型聲明config.json{ type: freenove-esp32s3-display-2.8-lcd, target: esp32s3, builds: [ { name: freenove-esp32s3-display-2.8-lcd } ] }type與name一致均滿足小寫字母/數字/連字符的命名約束且未在板級強制語言與喚醒詞保持用戶構建選項的靈活性。固件構建與燒錄推薦使用倉庫提供的build.py腳本用法詳見 docs/custom-board.md 的構建章節# 方式一自動腳本推薦自動讀取 config.json 的 target python scripts/build.py freenove-esp32s3-display-2.8-lcd # 指定語言與喚醒詞用戶構建選項 python scripts/build.py freenove-esp32s3-display-2.8-lcd \ --language zh-CN \ --wake-word nihaoxiaozhi # 查看可選值 python scripts/build.py --list-languages python scripts/build.py --list-wake-words也可以走傳統 ESP-IDF 流程idf.py set-target esp32s3 idf.py menuconfig # Xiaozhi Assistant - Board Type - Freenove ESP32-S3 Display 2.8-inch LCD idf.py build idf.py flash monitor構建產物默認為build/merged-binary.bin可通過--zip打包為 release 壓縮包。固件燒錄后設備將通過藍牙/WiFi 完成配網長按屏幕或啟動時按 BOOT 鍵均可進入配網模式隨后即可在屏幕上看到小智的 LVGL 界面并通過觸摸手勢進行對話交互。與其他板卡的關聯與排查要點同系硬件ReadMe 指出該板與 LCD wiki ES3C28P/ES3N28P 硬件設計很可能一致。倉庫中另有 lcdwiki-es3c35p3.5 寸版可作為對照參考兩者共用 ILI9341 SPI 驅動模式有助于理解同族面板的移植差異。排查建議結合 docs/custom-board.md 的 Troubleshooting顯示異常花屏/反色/方向錯核對DISPLAY_INVERT_COLOR、DISPLAY_SWAP_XY、DISPLAY_RGB_ORDER與 SPI Mode/時鐘無聲音檢查 I2S 五根線、PA 使能腳GPIO1與 ES8311 的 I2C 地址0x18是否與硬件一致觸摸無響應確認觸控芯片 I2C 地址 0x38 是否掛載成功并觀察串口日志中touch_task是否有數據更新。小結Freenove ESP32-S3 Display 2.8 在 xiaozhi-esp32 中是一塊小而完整的參考實現它同時涵蓋了 ILI9341 SPI 顯示、ES8311 音頻編解碼、電容觸摸手勢單擊/雙擊/長按、ADC 電量監測與實體按鍵交互五大子系統。通過閱讀 config.h 與 freenove-esp32s3-display-2.8-lcd.cc開發者不僅可以為手頭這塊板卡完成固件構建也能以此為模板快速把其他帶觸摸屏的 ESP32-S3 開發板接入小智語音生態。【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考 xiaozhi-esp32 適配 Freenove ESP32-S3 Display 2.8 寸電容觸屏板：引腳配置、觸摸交互與固件構建全解析
xiaozhi-esp32 適配 Freenove ESP32-S3 Display 2.8 寸電容觸屏板引腳配置、觸摸交互與固件構建全解析【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32本指南以 freenove-esp32s3-display-2.8-lcd 板卡目錄為核心系統講解小智 AI 語音助手xiaozhi-esp32對該開發板的完整適配從硬件識別、引腳映射、LCD/觸摸/音頻驅動初始化到構建系統接入與固件燒錄流程。讀完本文你將掌握這塊板卡的驅動架構、觸控手勢邏輯并能獨立完成固件配置、編譯與問題排查。板卡概覽一塊帶觸摸屏的 ESP32-S3 語音終端Freenove ESP32-S3 Display 2.8型號 FNK0104是一塊集成 2.8 英寸 240×320 分辨率 IPS 電容觸摸屏的 ESP32-S3 開發板同時板載 WiFi 與藍牙能力是典型的帶屏語音交互終端形態。該板卡在 xiaozhi-esp32 倉庫中以獨立板卡類型freenove-esp32s3-display-2.8-lcd提供完整支持被列為官方適配目標之一并在 docs/esp-idf-6-migration.md 的 IDF 6.0.1 遷移驗證矩陣中標注為通過完整構建。板卡目錄結構main/boards/freenove-esp32s3-display-2.8-lcd/遵循倉庫標準的一板一目錄規范文件作用ReadMe.md板卡簡介與硬件信息來源config.h引腳分配與硬件參數宏定義config.json板卡類型聲明與構建配置freenove-esp32s3-display-2.8-lcd.cc板級初始化與驅動粘合代碼官方說明指出該板卡與 LCD wiki 的 ES3C28P/ES3N28P 很可能采用相同的硬件設計這意味著本文的驅動分析對同系板卡同樣具有參考價值。引腳映射config.h 全量解讀config.h 是板卡的硬件身份證定義了音頻、按鍵、顯示三大子系統所需的全部引腳與參數。音頻子系統ES8311 編解碼器#define AUDIO_INPUT_SAMPLE_RATE 24000 #define AUDIO_OUTPUT_SAMPLE_RATE 24000 //音頻iis部分 #define AUDIO_I2S_GPIO_MCLK GPIO_NUM_4 //MCLK #define AUDIO_I2S_GPIO_BCLK GPIO_NUM_5 //SCK #define AUDIO_I2S_GPIO_DIN GPIO_NUM_6 //DIN #define AUDIO_I2S_GPIO_WS GPIO_NUM_7 //LRC #define AUDIO_I2S_GPIO_DOUT GPIO_NUM_8 //DOUT #define AUDIO_CODEC_PA_PIN GPIO_NUM_1 //PA //音頻iic部分 #define AUDIO_CODEC_I2C_NUM I2C_NUM_0 #define AUDIO_CODEC_I2C_SCL_PIN GPIO_NUM_15 #define AUDIO_CODEC_I2C_SDA_PIN GPIO_NUM_16 #define AUDIO_CODEC_ES8311_ADDR ES8311_CODEC_DEFAULT_ADDR輸入/輸出采樣率統一為 24 kHz這是小智語音鏈路的標準采樣率由 audio/codecs/es8311_audio_codec.cc 中的Es8311AudioCodec驅動支持。音頻走 I2S 總線MCLK(4)、BCLK(5)、WS(7)、DOUT(8) 輸出、DIN(6) 輸入PA 功放使能引腳為 GPIO1。編解碼器控制走 I2C0SCL15、SDA16地址使用 ES8311 默認地址ES8311_CODEC_DEFAULT_ADDR即 0x18。按鍵與指示燈#define BOOT_BUTTON_GPIO GPIO_NUM_0 #define BUILTIN_LED_GPIO GPIO_NUM_42啟動按鍵接 GPIO0ESP32 系通用 BOOT 鍵板級代碼中將其注冊為Button交互源。板載 LED 接 GPIO42由SingleLed驅動見下文GetLed()。顯示子系統ILI9341 串行 SPI#define DISPLAY_BACKLIGHT_PIN GPIO_NUM_45 #define DISPLAY_RST_PIN GPIO_NUM_NC #define DISPLAY_SCK_PIN GPIO_NUM_12 #define DISPLAY_DC_PIN GPIO_NUM_46 #define DISPLAY_CS_PIN GPIO_NUM_10 #define DISPLAY_MOSI_PIN GPIO_NUM_11 #define DISPLAY_MIS0_PIN GPIO_NUM_13 #define DISPLAY_SPI_SCLK_HZ (20 * 1000 * 1000) #define LCD_SPI_HOST SPI3_HOST #define LCD_TYPE_ILI9341_SERIAL #define DISPLAY_WIDTH 320 #define DISPLAY_HEIGHT 240 #define DISPLAY_MIRROR_X false #define DISPLAY_MIRROR_Y false #define DISPLAY_SWAP_XY true #define DISPLAY_INVERT_COLOR true #define DISPLAY_RGB_ORDER LCD_RGB_ELEMENT_ORDER_BGR #define DISPLAY_OFFSET_X 0 #define DISPLAY_OFFSET_Y 0 #define DISPLAY_BACKLIGHT_OUTPUT_INVERT false #define DISPLAY_SPI_MODE 0幾個關鍵點的工程含義分辨率與方向DISPLAY_WIDTH320、DISPLAY_HEIGHT240即物理橫屏 320×240DISPLAY_SWAP_XYtrue使邏輯坐標與面板方向匹配DISPLAY_INVERT_COLORtrue表明該面板需要顏色反相ILI9341 常見配置RGB 順序為 BGR。SPI 總線使用SPI3_HOST時鐘 20 MHzSPI Mode 0MISO 引腳GPIO13仍被定義InitializeSpi()中同樣配置了miso_io_num說明該板 SPI 為全雙工接線。背光GPIO45 輸出 PWM 背光DISPLAY_BACKLIGHT_OUTPUT_INVERTfalse表示高電平點亮DISPLAY_RST_PINGPIO_NUM_NC表示復位腳未單獨引出由面板自身管理復位。板級驅動實現從 I2C 到觸控的完整初始化鏈freenove-esp32s3-display-2.8-lcd.cc 定義了FreenoveESP32S3Display類繼承自WifiBoard構造順序即外設初始化順序InitializeI2c() → InitializeBatteryMonitor() → InitializeSpi() → InitializeLcdDisplay() → InitializeTouch() → InitializeButtons() → InitializeTools()I2C 總線與觸控芯片InitializeI2c()通過 ESP-IDF 新的i2c_master驅動創建 I2C0 總線i2c_new_master_bus并啟用內部上拉。該總線被音頻編解碼器與觸控芯片共用。TouchDriver封裝了電容觸控芯片的讀取協議bool Read(bool touched, uint16_t x, uint16_t y) { uint8_t reg 0x02; uint8_t buf[5]; i2c_master_transmit_receive(dev_, reg, 1, buf, 5, 50); uint8_t points buf[0] 0x0F; ... x ((buf[1] 0x0F) 8) | buf[2]; y ((buf[3] 0x0F) 8) | buf[4]; }從源碼結構看InitializeTouch()以 I2C 地址0x38掛載觸控芯片讀取寄存器0x02獲得觸點數量低 4 位及 12 位精度的 X/Y 坐標坐標寄存器同樣只有高 12 位有效每次輪詢超時 50ms——這符合常見電容觸控控制器如 FT 系列的協議形態。觸控數據由獨立 FreeRTOS 任務TouchTask棧 4096優先級 5固定運行在核心 0每 50ms 輪詢一次。觸控手勢單擊、雙擊與長按TouchTask是這塊板卡交互的核心它把原始觸摸事件翻譯成三個語音助手手勢手勢判定條件動作單擊按下時長 ≤ 3000ms且與上一次單擊間隔 ≥ 250msapp.ToggleChatState()切換聊天狀態雙擊兩次單擊間隔 250msapp.StartListening()開始聆聽長按按下時長 3000msEnterWifiConfigMode()進入 WiFi 配網模式其判定流程為檢測按下瞬間記錄down_start抬起時計算press now - down_start先判斷是否超過 3000ms 長按進入配網否則再判斷距上次單擊是否小于 250ms 以識別雙擊雙擊會立即清空last_tap防止三連擊誤判。這套邏輯直接映射到 application.cc 的ToggleChatState/StartListening接口實現了不依賴實體按鍵的純觸控人機交互。LCDILI9341 面板初始化InitializeLcdDisplay()完整展示了 ESP-IDFesp_lcd驅動框架的接入方式配置esp_lcd_panel_io_spi_config_tCSGPIO10、DCGPIO46、spi_mode0、pclk_hz20MHz、命令/參數位寬 8 位通過esp_lcd_new_panel_io_spi注冊到SPI3_HOST配置esp_lcd_panel_dev_config_t16 位色深、reset_gpio_numGPIO_NUM_NC、RGB 順序 BGR調用esp_lcd_new_panel_ili9341創建 ILI9341 面板依次執行esp_lcd_panel_reset→esp_lcd_panel_init→invert_color(true)→swap_xy(true)→mirror(false, false)封裝為SpiLcdDisplay并賦值給display_后續由 main/display/lcd_display.cc 統一對接 LVGL 渲染。音頻與電量兩個虛函數覆寫virtual AudioCodec* GetAudioCodec() override { static Es8311AudioCodec audio_codec(codec_i2c_bus_, AUDIO_CODEC_I2C_NUM, AUDIO_INPUT_SAMPLE_RATE, AUDIO_OUTPUT_SAMPLE_RATE, AUDIO_I2S_GPIO_MCLK, AUDIO_I2S_GPIO_BCLK, AUDIO_I2S_GPIO_WS, AUDIO_I2S_GPIO_DOUT, AUDIO_I2S_GPIO_DIN, AUDIO_CODEC_PA_PIN, AUDIO_CODEC_ES8311_ADDR, true, true); return audio_codec; }GetAudioCodec()返回以 ES8311 為編解碼器的實例開啟輸入輸出雙通道GetBacklight()返回 GPIO45 的PwmBacklightGetLed()返回 GPIO42 的SingleLed。GetBatteryLevel()通過AdcBatteryMonitor實現InitializeBatteryMonitor()中使用ADC_UNIT_1、ADC_CHANNEL_8上下分壓電阻均按 200kΩ 配置參考電壓引腳為GPIO_NUM_NC使用內部參考。這是倉庫 main/boards/common/adc_battery_monitor.cc 提供的通用 ADC 電量監測方案。實體按鍵的補充邏輯InitializeButtons()給 BOOT 鍵GPIO0注冊了點擊回調若設備仍處于kDeviceStateStarting啟動中則先進入 WiFi 配網模式否則切換聊天狀態——與觸摸手勢形成雙通道交互冗余。構建系統接入Kconfig 與 CMake 的注冊點該板卡不是孤立目錄而是被完整接入了倉庫構建體系Kconfig 注冊main/Kconfig.projbuildconfig BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD bool Freenove ESP32-S3 Display 2.8-inch LCD depends on IDF_TARGET_ESP32S3通過depends on IDF_TARGET_ESP32S3限定目標芯片為 ESP32-S3。CMake 分支main/CMakeLists.txtelseif(CONFIG_BOARD_TYPE_Freenove_ESP32S3_DISPLAY_2_8_LCD) set(BOARD_DIR freenove-esp32s3-display-2.8-lcd) set(BUILTIN_TEXT_FONT font_noto_sans_basic_20_4) set(BUILTIN_ICON_FONT font_material_symbols_20_4) set(DEFAULT_EMOJI_COLLECTION noto-color-emoji_64)為 240×320 分辨率選擇了 20px 級字體與 64px Emoji 集合符合 docs/custom-board.md 中中屏240×320配*_20_4字體的選型建議。類型聲明config.json{ type: freenove-esp32s3-display-2.8-lcd, target: esp32s3, builds: [ { name: freenove-esp32s3-display-2.8-lcd } ] }type與name一致均滿足小寫字母/數字/連字符的命名約束且未在板級強制語言與喚醒詞保持用戶構建選項的靈活性。固件構建與燒錄推薦使用倉庫提供的build.py腳本用法詳見 docs/custom-board.md 的構建章節# 方式一自動腳本推薦自動讀取 config.json 的 target python scripts/build.py freenove-esp32s3-display-2.8-lcd # 指定語言與喚醒詞用戶構建選項 python scripts/build.py freenove-esp32s3-display-2.8-lcd \ --language zh-CN \ --wake-word nihaoxiaozhi # 查看可選值 python scripts/build.py --list-languages python scripts/build.py --list-wake-words也可以走傳統 ESP-IDF 流程idf.py set-target esp32s3 idf.py menuconfig # Xiaozhi Assistant - Board Type - Freenove ESP32-S3 Display 2.8-inch LCD idf.py build idf.py flash monitor構建產物默認為build/merged-binary.bin可通過--zip打包為 release 壓縮包。固件燒錄后設備將通過藍牙/WiFi 完成配網長按屏幕或啟動時按 BOOT 鍵均可進入配網模式隨后即可在屏幕上看到小智的 LVGL 界面并通過觸摸手勢進行對話交互。與其他板卡的關聯與排查要點同系硬件ReadMe 指出該板與 LCD wiki ES3C28P/ES3N28P 硬件設計很可能一致。倉庫中另有 lcdwiki-es3c35p3.5 寸版可作為對照參考兩者共用 ILI9341 SPI 驅動模式有助于理解同族面板的移植差異。排查建議結合 docs/custom-board.md 的 Troubleshooting顯示異常花屏/反色/方向錯核對DISPLAY_INVERT_COLOR、DISPLAY_SWAP_XY、DISPLAY_RGB_ORDER與 SPI Mode/時鐘無聲音檢查 I2S 五根線、PA 使能腳GPIO1與 ES8311 的 I2C 地址0x18是否與硬件一致觸摸無響應確認觸控芯片 I2C 地址 0x38 是否掛載成功并觀察串口日志中touch_task是否有數據更新。小結Freenove ESP32-S3 Display 2.8 在 xiaozhi-esp32 中是一塊小而完整的參考實現它同時涵蓋了 ILI9341 SPI 顯示、ES8311 音頻編解碼、電容觸摸手勢單擊/雙擊/長按、ADC 電量監測與實體按鍵交互五大子系統。通過閱讀 config.h 與 freenove-esp32s3-display-2.8-lcd.cc開發者不僅可以為手頭這塊板卡完成固件構建也能以此為模板快速把其他帶觸摸屏的 ESP32-S3 開發板接入小智語音生態。【免費下載鏈接】xiaozhi-esp32An MCP-based chatbot | 一個基于MCP的聊天機器人項目地址: https://gitcode.com/GitHub_Trending/xia/xiaozhi-esp32創作聲明：本文部分內容由AI輔助生成（AIGC），僅供參考