【花雕动手做】ESP-Mosaico：硬件、Vibe Coding 与 Agent 的AI 开发平台

ESP-Mosaico V1.2 是乐鑫 ESP-Mosaico 的正式稳定版本，**最核心改进：I2C 总线拆分（内外总线独立）**，解决 V1.0 版本 I2C 总线冲突问题，适合创客同时挂载多块扩展模块（摄像头 + 多功能交互模块），也是 Claw 语音编程生态主推版本。ESP-Mosaico它的价值不在板子本身有多强，而在回答一个问题：AI 能写代码之后，硬件开发的瓶颈在哪？乐鑫给出的答案是——瓶颈在软件可以秒级迭代，硬件却要重新选型、接线、写驱动。ESP-Mosaico 用磁吸模块、自动识别、Vibe Mode 保底和 Agent 闭环，把这条沟填了一块。对想跟进 Vibe Coding 的人，它值得现在就上手；对只想找一块稳定生产工具的人，可以再等一等生态。

ESP-Mosaico 是一款基于 ESP32-S31 的可扩展智能交互开发套件，适用于磁吸扩展玩具、运动感知交互、方形触摸屏 HMI、端侧语音与多媒体等应用。设备集成 480 × 480 QSPI 方形触摸屏、ES8311 音频编解码、NS4150B 功放、BMI270 六轴 IMU、双 BMM150 磁力计、SPI NAND flash，以及左右两个 2 × 10P、2.54 mm 标准间距端子的模块接口。

ESP-Mosaico 主控采用乐鑫 ESP32-S31，支持 2.4 GHz Wi-Fi 6（IEEE 802.11b/g/n/ax）、Bluetooth® 5.4（LE + BR/EDR）以及 IEEE 802.15.4（Thread / Zigbee）。存储方面，整机配置封装内 16 MB PSRAM、板载 16 MB SPI NOR flash 与板载 1 Gbit SPI NAND flash，满足图形界面、多媒体与资源缓存需求。显示方面配备 CO5300 驱动的 480 × 480 QSPI 方形触摸屏，触摸控制器为 CST9220 系列。

音频方面，ESP-Mosaico 集成 ES8311 编解码芯片、NS4150B D 类功放。电源系统兼容 USB Type-C 5 V 供电与 3.7 V / 65 mAh 锂电池供电，板载 TP4057 充电、BQ27220 电量计与 SAM8108 开关机控制；Type-C 接口与左右模块接口均支持电源输入与输出。此外，板载 USB 2.0 High-Speed OTG 接口可用于供电、调试与通信，并预留 UART 扩展能力与左右模块接口。

组件介绍
ESP-Mosaico 由 CoreBoard（核心板）和 BaseBoard（底板）组成。下文先介绍正面视图及其主要组件，再介绍背面视图及其主要组件。

正面

ESP-Mosaico 整机正面

ESP-Mosaico CoreBoard 正面

ESP-Mosaico BaseBoard 正面

以下按照顺时针的顺序依次介绍正面 PCB 上的主要组件。

背面
ESP-Mosaico 整机背面

ESP-Mosaico CoreBoard 背面

ESP-Mosaico BaseBoard 背面

以下按照顺时针的顺序依次介绍背面 PCB 上的主要组件。

开始开发应用
通电前，请确保 ESP-Mosaico 完好无损。

必备硬件
ESP-Mosaico
USB 数据线（支持数据传输）
电脑（Windows、Linux 或 macOS）

备注
请确保使用适当的 USB 数据线。部分数据线仅可用于充电，无法用于数据传输和编程。

硬件说明
烧录方式
请使用 USB 数据线，将 ESP-Mosaico 通过板载 Type-C 接口连接至电脑。该接口为 USB 2.0 High-Speed，可同时供电并完成 USB 协议数据通信。原生 ESP32-S31 芯片仅支持在烧录模式下通过该接口烧录固件，不具备自动烧录与日志输出能力。出厂固件已集成 CDC 虚拟串口，支持自动烧录和串口日志输出。若无法烧录，可尝试在关机状态下按住 BOOT 按键后再开机，进入烧录模式。此外，左右模块接口分别提供 USB Serial/JTAG（左侧）和 TX/RX 串口（右侧），均可用于调试和下载程序。

电源说明
Type-C 接口可为设备供电，内部电池的额定充电电流为 65 mA；当插入用电端设备时，Type-C 接口会自动切换为供电模式，最大输出 5 V / 500 mA，超出 1 A 时会自动断电，并会隔一段时间自动恢复。 左右两侧模块接口提供向外供电的 3.3 V 与 5 V 引脚（3V / 5V），这两个电源仅在 GPIO60 置低时才会输出。VIN 为向设备供电的接口，同时也会为设备内电池充电。

软件设置
请前往 ESP-IDF 快速入门 章节查看如何快速设置开发环境。本开发板目标芯片为 esp32s31。

备注
开发板使用 USB 端口与电脑通信。大多数操作系统（Windows、Linux、macOS）已预装所需驱动，开发板插入后可自动识别。如无法识别设备或无法建立串口连接，请参考 与 ESP32-S31 建立串口连接 获取安装驱动的详细步骤。

板级支持包与示例
乐鑫为 ESP-Mosaico 提供了板级支持包 (BSP)，可帮助您更轻松地初始化 LCD、触摸、音频、传感器、电池、NAND flash、模块资源与 USB 控制台等外设。

出厂应用的按键、扩展接口与使用方式见 ESP-Mosaico 使用指南。
可用浏览器刷写最新固件，见 固件更新。
推荐结合 ESP-Claw 应用开发框架进行开发。

推荐首次烧录后使用 BSP 提供的 USB CDC 控制台与自动下载能力。典型命令：
 

idf.py set-target esp32s31
idf.py -p /dev/ttyACM0 flash monitor

备注
首次烧录可能需要手动进入 ROM 下载模式。
芯片复位时 USB 设备会短暂断开，IDF Monitor 通常会自动重连。
若仅附加监视器而不希望复位应用，可使用 monitor --no-reset。
相关配置项：CONFIG_BSP_USB_CONSOLE、 CONFIG_BSP_USB_CONSOLE_AUTO_INIT、 CONFIG_BSP_USB_AUTO_DOWNLOAD。