XIAO 1.14'' IPS Display (ESP32-S3) 入门指南
| XIAO 1.14'' IPS Display (ESP32-S3) |
|---|
 |
介绍
1.14'' IPS Display 是一款为 XIAO 系列设计的扩展板，由 XIAO ESP32-S3 Plus 提供算力。它配备 135×240 IPS 彩色 LCD、板载 PDM 麦克风、6 轴 IMU、Grove I2C 接口、三个用户按键以及电池电压测量功能——所有这些都集成在一个紧凑的外形尺寸中。
这种组合使其成为可穿戴设备、紧凑型传感节点、便携式仪器以及对空间要求极高的 IoT 原型开发的理想平台。借助 ESP32-S3 的双核处理器、Wi-Fi 和 Bluetooth 能力，它可以将显示屏扩展为一个具备无线连接能力的设备。
| 规格 | 详细参数 |
|---|---|
| 产品定位 | 感知与扩展 |
| 核心控制器 | Seeed Studio XIAO ESP32-S3 Plus |
| 处理器 | ESP32-S3R8，双核，最高 240 MHz |
| 内存 | 8 MB PSRAM + 16 MB Flash |
| 无线连接 | 2.4 GHz Wi-Fi + BLE 5.0 |
| 显示类型 | 1.14" IPS TFT LCD |
| 分辨率 | 135 × 240 |
| 显示驱动 | ST7789 |
| 显示接口 | SPI |
| 触摸输入 | 无 |
| 6 轴 IMU | 有 |
| PDM 数字麦克风 | 有 |
| MicroSD 卡槽 | 无 |
| Grove I2C 接口 | 有 |
| 用户按键 | 3 |
| 电池连接器 | 2 针 JST，3.7 V 锂电池 |
| 电池监测 | 通过 D16 ADC 进行电池电压监测；可根据测得电压估算电池电量。不支持电池状态检测。 |
| 扩展接口 | 1x I2S 接口，1x JTAG 接口，3x 用户按键接口 |
| 板卡尺寸 | 26 × 48 × 10.6 mm |
| 最佳应用 | 传感器仪表盘、Grove 项目、物理控制器 |
该显示板专为 XIAO ESP32-S3 Plus 设计。如果你使用的是 XIAO nRF52840 Plus 版本，请改为参考 XIAO 1.14'' IPS Display (nRF52840) 指南。
ESP32-S3 Plus 使用 D16 进行电压测量。电压示例程序不会显示电池百分比，也没有将充电状态信号连接到任何 ESP32-S3 GPIO。
硬件概览
在开始之前，请参考下图来了解 1.14'' IPS Display 的物理布局。
引脚分布图
1.14'' IPS Display 引出了所有 XIAO ESP32-S3 Plus 引脚。下表列出了每个引脚、其在显示板上的网络名称、功能说明以及与板载外设的连接方式。
| XIAO 引脚 | 网络名称 | 功能说明 | 硬件连接说明 |
|---|---|---|---|
| D0 | PDM_CLK | PDM 数字麦克风时钟 | 内部连接到 PDM 麦克风 |
| D1 | MIC_DATA | PDM 数字麦克风数据 | 内部连接到 PDM 麦克风 |
| D2 | LCD_CS | 屏幕片选信号 | 内部连接到 LCD 驱动 IC |
| D3 | LCD_DC | 屏幕数据/命令切换 | 内部连接到 LCD 驱动 IC |
| D4 | SDA | I2C 数据总线 | 总线共享：内部连接到 IMU；外部引出到 Grove I2C 接口 |
| D5 | SCL | I2C 时钟总线 | 总线共享：内部连接到 IMU；外部引出到 Grove I2C 接口 |
| D6 | BTN_A | 物理按键 A（左） | 内部连接到前左侧微动开关，并带有外部 1 KΩ 上拉。外部引出为 U1 测试焊盘 |
| D7 | BTN_B | 物理按键 B（右） | 内部连接到前右侧微动开关，并带有外部 1 KΩ 上拉。外部引出为 U2 测试焊盘 |
| D8 | SCK | 硬件 SPI 时钟 | 内部连接到 LCD 驱动 IC |
| D9 | NC | 悬空（预留） | 无物理连接 |
| D10 | MOSI | 硬件 SPI 数据输出 | 内部连接到 LCD 驱动 IC |
| D11 | I2S_SD | 音频数据输出 | 外部引出到底部扩展焊盘 |
| D12 | I2S_SCK | 音频位时钟 | 外部引出到底部扩展焊盘 |
| D13 | I2S_WS | 音频字选择 | 外部引出到底部扩展焊盘 |
| D14 | IMU_INT | IMU 运动硬件中断 | 内部连接到 6 轴 IMU，用于异步唤醒 |
| D15 | NC | 预留（测试点） | 连接到 PCB 上的测试点 TP15，无功能外设 |
| D16 | BAT_ADC | 电池电压检测 | 内部连接到分压电路（316K / 160K）。请勿外接使用 |
| D17 | LCD_RST | 屏幕软复位 | 内部连接到 LCD 驱动 IC |
| D18 | LCD_BL | 屏幕背光控制 | 内部连接到背光驱动电路 |
| D19 | BTN_C | 物理按键 C（侧边） | 内部连接到侧边微动开关，并带有外部 1 KΩ 上拉。外部引出为 U3 测试焊盘 |
入门
本指南会向显示板上传一个最小的 "Hello, XIAO" 示例：屏幕会点亮背光、填充为黑色背景，并以两行居中的大号绿色文字打印 "Hello," 和 "XIAO"。这是在深入各个外设示例之前，最快确认屏幕和你的开发环境是否正常工作的方式。
软件准备
你需要以下工具和库：
- Arduino IDE（版本 1.8 或更高）
- Espressif 提供的 esp32 开发板包 (3.3.11) — 将以下 URL 添加到 File > Preferences > Additional Boards Manager URLs：
https://espressif.github.io/arduino-esp32/package_esp32_index.json
然后进入 Tools > Board > Boards Manager，搜索 esp32 并安装 3.3.11 版本。
- Seeed_GFX2（手动安装） — 此库在 Library Manager 中不可用，必须手动安装：
步骤 1. 点击上方按钮，将 Seeed_GFX2 v1.0.0 作为 ZIP 文件下载（固定到某个发布标签，以保证教程可复现）。或者，从 Seeed-Studio/Seeed_GFX2 克隆该仓库。
步骤 2. 在 Arduino IDE 中，依次进入 Sketch > Include Library > Add .ZIP Library...，然后选择下载的 ZIP 文件。IDE 会读取 library.properties 并自动将其安装到正确的 Seeed_GFX2 文件夹中——你无需重命名解压后的文件夹。（如果要改为手动安装，请先解压压缩包，将解压后的文件夹重命名为 Seeed_GFX2，再放入 Documents/Arduino/libraries/ 中。）
步骤 3. 重启 Arduino IDE，以便检测到新安装的库。
- Seeed_GFX2 是 Seeed Studio 基于分层
Board+Panel Config架构构建的图形库。每个示例都通过一次display.begin<Board_..., Config_...>()调用来初始化显示屏——Board 模板负责引脚映射（CS/DC/SCK/MOSI/RST/BL），而 Panel Config 预设了 135×240 分辨率、颜色顺序和方向。无需driver.h或手动引脚配置。 - 在这块板子上，示例程序使用
Board_XIAO_1inch14_LCD<13, 12>（RST=13，BL=12）和Config_Seeed_1inch14_LCD_ST7789。
下载代码
示例程序可以在 GitHub 上获取：
进入 code_GFX2/getting_started_code/xiao_esp32s3_114_hello/ 并在 Arduino IDE 中打开 xiao_esp32s3_114_hello.ino。请下载完整文件夹，而不是从 GitHub 网页视图中复制 .ino 源码。
上传示例程序
步骤 1. 通过 USB-C 接口将 XIAO ESP32-S3 Plus 连接到电脑。
步骤 2. 在 Arduino IDE 中选择开发板：Tools > Board > esp32 > XIAO_ESP32S3_PLUS。
步骤 3. 在 Tools > Port 中选择正确的 端口（Port）。
步骤 4. 点击 Upload 按钮（→）。示例程序会被编译并上传到开发板。
预期输出
上传完成后，屏幕会点亮为黑色背景，并显示两行居中的大号绿色文字——第一行是 "Hello,"，第二行是 "XIAO"。该问候语会保持在屏幕上，不会重复重绘。
如果显示屏初始化失败，示例程序会以 115200 波特率在串口监视器中打印库的错误信息。打开 Tools > Serial Monitor 并将波特率设置为 115200 以查看。
接下来做什么
这块显示板集成了多个板载外设。Function 页面为每个外设都提供了独立的演示：
| 外设 | 演示 |
|---|---|
| 屏幕 | GraphicTest — 十种图形基本图元及其计时基准测试 |
| IMU | Electronic Quicksand + Raise to Wake — 六轴运动特效和抬手唤醒 |
| 麦克风和扬声器 | Voice Bar + Flash Recorder — 实时 PDM 电平指示和录音 |
| Grove I2C | SHT31 Temperature & Humidity — 读取 Grove SHT31 传感器 |
| 按键 | User Buttons — 读取按键并使用中断进行去抖 |
| 电池 | Battery Voltage Detection — 测量分压电压 |
常见问题（FAQ）
开发板没有出现在 Tools > Board 菜单中
请确保你已经在 Arduino IDE 中添加了 ESP32 开发板包：
- 进入 File > Preferences，并将下面的 URL 粘贴到 Additional Boards Manager URLs 中：
https://espressif.github.io/arduino-esp32/package_esp32_index.json - 进入 Tools > Board > Boards Manager，搜索 esp32，并安装 3.3.11 版本。
- 安装完成后，菜单中应出现 Tools > Board > esp32 > XIAO_ESP32S3_PLUS。
如果开发板仍然没有显示，请重启 Arduino IDE 后再试一次。
[关于出厂固件 - DashBoard]
仪表盘上的 I2C 扫描卡住了——我该怎么办？
按一下 XIAO ESP32-S3 Plus 上的 Reset 按钮以重启开发板。这会清除卡住的 I2C 总线，使仪表盘恢复正常。
我们强烈建议不要热插拔 I2C 接口上的设备。在 Grove I2C 接口或 SDA/SCL 引出焊盘上连接或断开任何设备前，请务必先关闭开发板电源——热插拔可能会导致 I2C 总线挂起。
资源
- 🗃️[PCB 设计文件] XIAO 1.14'' IPS Display (ESP32-S3) KiCad Project
- 📄[原理图] XIAO 1.14'' IPS Display (ESP32-S3) Schematic
- 📦[3D 模型] XIAO 1.14'' IPS Display (STEP)
- 📄[数据手册] 1.14 Inch Display Datasheet
- 💾[出厂固件] XIAO 1.14'' IPS Display (ESP32-S3) Factory Firmware
技术支持与产品讨论
感谢你选择我们的产品！我们将为你提供多种支持，确保你在使用我们产品的过程中尽可能顺利。我们提供多种沟通渠道，以满足不同的偏好和需求。