小智AI -- ESP32-S3 DIY面包板WIFI-LCD彩屏

DIY 所需硬件

开发板：ESP32-S3-DevKitC-1（选择 WROOM N16R8 模组） Goouuu ESP32-S3-N16R8开发板
数字麦克风：INMP441 INMP441全向麦克风模块
功放：MAX98357A MAX98357 I2S 音频放大器模块
腔体喇叭：8Ω 2~3W 或 4Ω 2~3W 2030腔体-4Ω3W/8Ω2WBOX蓝牙音响扬声器
导线：跳线一盒，杜邦线若干 140根优质跳线面包板线
400 孔面包板 2 块优质面包板/迷你小面包板/ 实验板
SPI-LCD彩屏黄保凯中景园1.3寸 IPS液晶屏 ST7789 新款8脚
6*6mm 立式轻触开关（可选）轻触开关中两脚 6*6*4 微动/按键开关

1. SPI-LCD彩屏（带驱动板，焊接8Pin排针）

本教程以 1.3寸 IPS LCD彩屏为例，产品参数如下：

1.3寸IPS彩屏，支持 RGB 65K色显示，显示色彩丰富
240X240分辨率，显示清晰
IPS全视角面板，超宽可视范围
采用4线制SPI串行总线，需8个IO引脚即可工作

2. 面包板WIFI-LCD彩屏接线方案

2.1. 开发板与元件模块接线对照表

注意：接线请按照表格的引脚进行接线，对应开发板接线照片仅供参考。

把下方表格中的 ESP32S3开发板的加粗的数字/字母引脚，和麦克风、数字功放、LCD显示屏等加粗的英文字母引脚，用导线连接起来，短接的意思就是也连导线在一起。

ESP32S3开发板	麦克风 INMP441（I2S接口）
GPIO4	WS 数据选择
GPIO5	SCK 数据时钟
GPIO6	SD 数据输出
3V3	VDD 电源正 3.3V
GND	GND 接地短接L/R 左/右声道
	数字功放 MAX98357A
GPIO7	DIN 数字信号
GPIO15	BCLK 位时钟
GPIO16	LRC 左/右时钟
3V3 /3.3V	Vin（或VCC）电源输入短接SD 关机频道
GND	GND 接地短接GAIN 增益和频道
	音频+ 接喇叭正极（一般红线，不清楚问卖家、或用万用表测或其他方法）
	音频- 接喇叭负极
	显示屏（SPI-LCD 8Pin接口）
GND	GND 接地
3V3	VCC 电源正
GPIO21	SCL 时钟线
GPIO47	SDA 数据信号
GPIO45	RES 复位
GPIO40	DC 数据选择
GPIO41	CS 片选
GPIO42	BLK 背光

2.2. ESP32-S3-DevKitC-1 开发板版本2（GOOUUU 果云版 42 IO引脚）LCD屏接线图

ESP32-S3果云 42 引脚开发板面包板DIY，请参考下图接线：

3. Windows搭建 ESP IDF 5.4开发环境以及编译小智

3.1. Windows 平台工具链的标准设置

ESP32 ESP-IDF Windows 平台工具链的标准设置-CSDN博客

3.2. 编译小智

3.2.1. 下载源码

进入虾哥代码主页：https://github.com/78/xiaozhi-esp32, 点击Code - Download ZIP

电脑装了git的话，建议还是用命令

git clone git@github.com:78/xiaozhi-esp32.git #虾哥Github
git clone https://gitee.com/zexuntec/xiaozhi-esp32.git #Gitee 每周同步一次虾哥Github

进入终端，打开IDF 5.4或者双击桌面的ESP IDF5.4 Powershell

Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindowsSetting PYTHONNOUSERSITE, was not set
Using Python in D:\workspace\Espressif\python_env\idf5.4_py3.11_env\Scripts
Python 3.11.2
Using Git in D:\workspace\Espressif\tools\idf-git\2.44.0\cmd
git version 2.44.0.windows.1
Activating ESP-IDF 5.4
* Checking python version ... 3.11.2
* Checking python dependencies ... OK
* Deactivating the current ESP-IDF environment (if any) ... OK
* Establishing a new ESP-IDF environment ... OK
* Identifying shell ... powershell.exe
* Detecting outdated tools in system ... Found tools that are not used by active ESP-IDF version.
For removing old versions of idf-driver, idf-python-wheels use command 'python.exe D:\workspace\Espressif\frameworks\esp-idf-v5.4\tools\idf_tools.py uninstall'
To free up even more space, remove installation packages of those tools.
Use option python.exe D:\workspace\Espressif\frameworks\esp-idf-v5.4\tools\idf_tools.py uninstall --remove-archives.Done! You can now compile ESP-IDF projects.
Go to the project directory and run:idf.py buildPS D:\workspace\Espressif\frameworks\esp-idf-v5.4>cd D:\workspace\xiaozhi-esp32\

3.2.2. 设置芯片类型

默认的编译芯片是ESP32的，所以自己的板子是S3的话一定要输入以下命令把芯片设置为S3, idf.py set-target esp32s3

 idf.py set-target esp32s3

如果你使用的芯片是ESP32C3的话，需要输入 idf.py set-target esp32c3先把芯片类型设置为C3，再去menuconfig里选择对应的板子类型。

PS D:\workspace\xiaozhi-esp32> idf.py set-target esp32s3
Adding "set-target"'s dependency "fullclean" to list of commands with default set of options.
Executing action: fullclean
Build directory 'D:\workspace\xiaozhi-esp32\build' not found. Nothing to clean.
Executing action: set-target
Set Target to: esp32s3, new sdkconfig will be created.
Running cmake in directory D:\workspace\xiaozhi-esp32\build
Executing "cmake -G Ninja -DPYTHON_DEPS_CHECKED=1 -DPYTHON=D:\workspace\Espressif\python_env\idf5.4_py3.11_env\Scripts\python.exe -DESP_PLATFORM=1 -DIDF_TARGET=esp32s3 -DCCACHE_ENABLE=1 D:\workspace\xiaozhi-esp32"...
-- Found Git: D:/workspace/Espressif/tools/idf-git/2.44.0/cmd/git.exe (found version "2.44.0.windows.1")
-- ccache will be used for faster recompilation
-- The C compiler identification is GNU 14.2.0
-- The CXX compiler identification is GNU 14.2.0
-- The ASM compiler identification is GNU
-- Found assembler: D:/workspace/Espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc.exe
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: D:/workspace/Espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-gcc.exe - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: D:/workspace/Espressif/tools/xtensa-esp-elf/esp-14.2.0_20241119/xtensa-esp-elf/bin/xtensa-esp32s3-elf-g++.exe - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Building ESP-IDF components for target esp32s3
NOTICE: Dependencies lock doesn't exist, solving dependencies.
....................................NOTICE: Updating lock file at D:\workspace\xiaozhi-esp32\dependencies.lock
NOTICE: Processing 24 dependencies:
NOTICE: [1/24] 78/esp-ml307 (1.7.2)
NOTICE: [2/24] 78/esp-opus (1.0.4)
NOTICE: [3/24] 78/esp-opus-encoder (2.1.0)
NOTICE: [4/24] 78/esp-wifi-connect (2.3.1)
NOTICE: [5/24] 78/esp_lcd_nv3023 (1.0.0)
NOTICE: [6/24] 78/xiaozhi-fonts (1.3.2)
NOTICE: [7/24] espressif/button (3.5.0)
NOTICE: [8/24] espressif/cmake_utilities (0.5.3)
NOTICE: [9/24] espressif/esp-dsp (1.4.12)
NOTICE: [10/24] espressif/esp-sr (2.0.2)
NOTICE: [11/24] espressif/esp_codec_dev (1.3.4)
NOTICE: [12/24] espressif/esp_io_expander (1.0.1)
NOTICE: [13/24] espressif/esp_io_expander_tca9554 (2.0.0)
NOTICE: [14/24] espressif/esp_io_expander_tca95xx_16bit (2.0.0)
NOTICE: [15/24] espressif/esp_lcd_gc9a01 (2.0.2)
NOTICE: [16/24] espressif/esp_lcd_ili9341 (1.2.0)
NOTICE: [17/24] espressif/esp_lcd_panel_io_additions (1.0.1)
NOTICE: [18/24] espressif/esp_lcd_spd2010 (1.0.2)
NOTICE: [19/24] espressif/esp_lcd_st77916 (1.0.1)
NOTICE: [20/24] espressif/esp_lvgl_port (2.4.4)
NOTICE: [21/24] espressif/led_strip (2.5.5)
NOTICE: [22/24] lvgl/lvgl (9.2.2)
NOTICE: [23/24] waveshare/esp_lcd_sh8601 (1.0.2)
NOTICE: [24/24] idf (5.4.0)
-- Project sdkconfig file D:/workspace/xiaozhi-esp32/sdkconfig
C:\Users\ADMINI~1\AppData\Local\Temp\kconfgen_tmp42_640bb:16: warning: ignoring malformed line 'ESP_TASK_WDT_TIMEOUT_S=10'
Loading defaults file D:/workspace/xiaozhi-esp32/sdkconfig.defaults...
Loading defaults file D:/workspace/xiaozhi-esp32/sdkconfig.defaults.esp32s3...
-- Compiler supported targets: xtensa-esp-elf
-- Found Python3: D:/workspace/Espressif/python_env/idf5.4_py3.11_env/Scripts/python.exe (found version "3.11.2") found components: Interpreter
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Success
-- Found Threads: TRUE
-- Performing Test C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS
-- Performing Test C_COMPILER_SUPPORTS_WFORMAT_SIGNEDNESS - Success
-- App "xiaozhi" version: 1.5.1
-- Adding linker script D:/workspace/xiaozhi-esp32/build/esp-idf/esp_system/ld/memory.ld
-- Adding linker script D:/workspace/xiaozhi-esp32/build/esp-idf/esp_system/ld/sections.ld.in
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.api.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.bt_funcs.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.libgcc.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.wdt.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.version.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/esp_rom/esp32s3/ld/esp32s3.rom.newlib.ld
-- Adding linker script D:/workspace/Espressif/frameworks/esp-idf-v5.4/components/soc/esp32s3/ld/esp32s3.peripherals.ld
-- ESP_LCD_NV3023: 1.0.0
-- BUTTON: 3.5.0
-- ESP_LCD_GC9A01: 2.0.2
-- ESP_LCD_ILI9341: 1.2.0
-- ESP_LCD_PANEL_IO_ADDITIONS: 1.0.1
-- ESP_LCD_SPD2010: 1.0.2
-- ESP_LCD_ST77916: 1.0.1
-- LVGL version: 9.2.2
-- ESP_LCD_SH8601: 1.0.2
-- Component idf::main will be linked with -Wl,--whole-archive
......
......
-- Configuring done (52.8s)
-- Generating done (3.0s)
-- Build files have been written to: D:/workspace/xiaozhi-esp32/build
PS D:\workspace\xiaozhi-esp32>

3.2.3. 更换编译板子类型

默认编译出的固件是面包板的，如果需要更换板子，需要输入idf.py menuconfig

idf.py menuconfig

进入Xiaozhi Assistant选项

选Board Type选项, 选“面包板新版接线(WiFi + LCD)”

选LCD Type选项, 选“ST7789, 分辨率240*240，8PIN”

选择需要编译的板子固件后按键盘的‘S’键保存然后Esc退出menuconfig

3.2.4. 开始编译

再次输入idf.py build进行编译

idf.py build
Executing action: all (aliases: build)
Running ninja in directory D:\workspace\xiaozhi-esp32\build
Executing "ninja all"...
[0/1] Re-running CMake...
-- ccache will be used for faster recompilation
-- Building ESP-IDF components for target esp32s3
NOTICE: Processing 24 dependencies:
NOTICE: [1/24] 78/esp-ml307 (1.7.2)
NOTICE: [2/24] 78/esp-opus (1.0.4)
NOTICE: [3/24] 78/esp-opus-encoder (2.1.0)
NOTICE: [4/24] 78/esp-wifi-connect (2.3.1)
NOTICE: [5/24] 78/esp_lcd_nv3023 (1.0.0)
NOTICE: [6/24] 78/xiaozhi-fonts (1.3.2)
NOTICE: [7/24] espressif/button (3.5.0)
NOTICE: [8/24] espressif/cmake_utilities (0.5.3)
NOTICE: [9/24] espressif/esp-dsp (1.4.12)
NOTICE: [10/24] espressif/esp-sr (2.0.2)
NOTICE: [11/24] espressif/esp_codec_dev (1.3.4)
NOTICE: [12/24] espressif/esp_io_expander (1.0.1)
NOTICE: [13/24] espressif/esp_io_expander_tca9554 (2.0.0)
NOTICE: [14/24] espressif/esp_io_expander_tca95xx_16bit (2.0.0)
NOTICE: [15/24] espressif/esp_lcd_gc9a01 (2.0.2)
NOTICE: [16/24] espressif/esp_lcd_ili9341 (1.2.0)
NOTICE: [17/24] espressif/esp_lcd_panel_io_additions (1.0.1)
NOTICE: [18/24] espressif/esp_lcd_spd2010 (1.0.2)
NOTICE: [19/24] espressif/esp_lcd_st77916 (1.0.1)
NOTICE: [20/24] espressif/esp_lvgl_port (2.4.4)
NOTICE: [21/24] espressif/led_strip (2.5.5)
NOTICE: [22/24] lvgl/lvgl (9.2.2)
NOTICE: [23/24] waveshare/esp_lcd_sh8601 (1.0.2)
NOTICE: [24/24] idf (5.4.0)
-- Project sdkconfig file D:/workspace/xiaozhi-esp32/sdkconfig
C:\Users\ADMINI~1\AppData\Local\Temp\kconfgen_tmpbmqhc7y0:16: warning: ignoring malformed line 'ESP_TASK_WDT_TIMEOUT_S=10'
Loading defaults file D:/workspace/xiaozhi-esp32/sdkconfig.defaults...
Loading defaults file D:/workspace/xiaozhi-esp32/sdkconfig.defaults.esp32s3...
-- Compiler supported targets: xtensa-esp-elf
-- App "xiaozhi" version: 1.5.1
......
......
-- ESP_LCD_NV3023: 1.0.0
-- BUTTON: 3.5.0
-- ESP_LCD_GC9A01: 2.0.2
-- ESP_LCD_ILI9341: 1.2.0
-- ESP_LCD_PANEL_IO_ADDITIONS: 1.0.1
-- ESP_LCD_SPD2010: 1.0.2
-- ESP_LCD_ST77916: 1.0.1
-- LVGL version: 9.2.2
-- ESP_LCD_SH8601: 1.0.2
......
......
-- Configuring done (15.6s)
-- Generating done (1.7s)
-- Build files have been written to: D:/workspace/xiaozhi-esp32/build
[5/1890] Move and Pack models...
Recommended model partition size: 285K
[11/1890] Generating ../../partition_table/partition-table.bin
Partition table binary generated. Contents:
*******************************************************************************
# ESP-IDF Partition Table
# Name, Type, SubType, Offset, Size, Flags
nvs,data,nvs,0x9000,16K,
otadata,data,ota,0xd000,8K,
phy_init,data,phy,0xf000,4K,
model,data,spiffs,0x10000,960K,
ota_0,app,ota_0,0x100000,6M,
ota_1,app,ota_1,0x700000,6M,
*******************************************************************************
......
......
[1888/1890] Generating binary image from built executable
esptool.py v4.8.1
Creating esp32s3 image...
Merged 2 ELF sections
Successfully created esp32s3 image.
Generated D:/workspace/xiaozhi-esp32/build/xiaozhi.bin
[1889/1890] C:\Windows\system32\cmd.exe /C "cd /D D:\works...on-table.bin D:/workspace/xiaozhi-esp32/build/xiaozhi.bin"
xiaozhi.bin binary size 0x360920 bytes. Smallest app partition is 0x600000 bytes. 0x29f6e0 bytes (44%) free.Project build complete. To flash, run:idf.py flash
oridf.py -p PORT flash
PS D:\workspace\xiaozhi-esp32>