<p align="center"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/f3f13246-a32d-48aa-84a8-adcc87064c70.jpg" width="auto" height="auto" alt="ESPRESSIF"> </p>

• 英文版本
• 宣传视频

ESP-BOX AIoT 开发框架

<p align="left"> <a href="https://github.com/espressif/esp-box/blob/master/LICENSE" alt="构建示例"> <img alt="GitHub" src="https://img.shields.io/github/license/espressif/esp-box"></a> <a href="https://github.com/espressif/esp-box/actions/workflows/build-examples-gh-pages-on-push.yml" alt="构建示例"> <img src="https://yellow-cdn.veclightyear.com/ab5030c0/ebf65b1a-2537-4f3c-8bc5-144d030fff8a.svg" /></a> <a href="https://github.com/espressif/esp-box/graphs/contributors" alt="贡献者"> <img src="https://img.shields.io/github/contributors/espressif/esp-box" /></a> <a href="https://github.com/espressif/esp-box/releases" alt="GitHub 所有版本"> <img src="https://img.shields.io/github/downloads/espressif/esp-box/total" /></a> </p> <a href="https://espressif.github.io/esp-launchpad/?flashConfigURL=https://espressif.github.io/esp-box/launchpad.toml"> <img alt="使用 ESP Launchpad 尝试" src="https://yellow-cdn.veclightyear.com/ab5030c0/49becbfc-6af3-4a00-879f-4054f07d4f9e.png" width="250" height="70"> </a>

重要提示：

收到 ESP32-S3-BOX-3 后，我们建议通过乐鑫在线固件烧录工具 ESP Launchpad 更新内置出厂固件，以确保您获得最新的错误修复。目前，最新版本是 ESP-BOX-3_Demo_V1.2.4。要验证软件版本，请前往"关于我们"页面。

ESP-BOX 是乐鑫系统发布的先进 AIoT、边缘 AI 和 IIoT 应用开发平台。ESP32-S3-BOX、ESP32-S3-BOX-Lite 和 ESP32-S3-BOX-3 是为该平台设计的一系列开发板，它们基于乐鑫强大的 ESP32-S3 Wi-Fi + 蓝牙 5 (LE) SoC，具有紧凑美观的外壳。利用多功能配件和仓库中可靠的示例，这些开发板既适用于原型设计新项目，也适用于构建复杂的物联网系统，提供了形式和功能的完美平衡。

ESP-BOX 提供了一个平台，用于开发各个领域的应用，包括离线语音助手、在线 AI 聊天机器人（使用 OpenAI 和其他大型语言模型平台开发）、Matter 设备/控制器、机器人控制器、USB 设备/主机、无线传感器应用以及广泛的人机交互 (HMI) 应用。体验可能性——将其添加到您的工具包中，探索无限潜力！

产品名称	产品图片	市场状态
ESP32-S3-BOX<sup> 1 </sup>	<img src="https://yellow-cdn.veclightyear.com/ab5030c0/5bab0c34-4922-4f45-804a-cf5c73fca768.png" width="200px" />	停产 <br> 用户指南
ESP32-S3-BOX-Lite<sup> 1</sup>	<img src="https://yellow-cdn.veclightyear.com/ab5030c0/4ada4592-614c-4802-8476-6200f7af9f51.png" width="200px" />	停产 <br> 用户指南
ESP32-S3-BOX-3<sup> 2</sup>	<img src="https://yellow-cdn.veclightyear.com/ab5030c0/da857ccf-30d0-4b2a-9f7d-08415fc03d52.png" width="200px" />	在售 <br> 用户指南

注 1：收到 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite 后，我们建议更新内置出厂固件以确保您获得最新的错误修复。在 master 分支中，我们将逐步为这两款开发板提供有限支持。欲了解更多信息，请参阅示例的 readme。

注 2：ESP32-S3-BOX-3 提供两种不同版本：ESP32-S3-BOX-3 和 ESP32-S3-BOX-3B。ESP32-S3-BOX-3 是标准版，配有四个蓝色配件，ESP32-S3-BOX-3B 提供较少配件，以满足不需要太多不必要硬件的入门者。有关区别的更多详情，请查看此处。

版本

ESP-BOX	依赖的 ESP-IDF	分支说明	支持状态
master	>= release/v5.1<br/>提交 ID: 22cfbf30c3	最新开发固件 <br/>esp-sr 组件版本：v1.4.1	部分支持 ESP32-S3-BOX、ESP32-S3-BOX-Lite 和 ESP32-S3-BOX-3 <br>使用 menuconfig 选择开发板<br> 详情请参阅示例的 README。
标签 0.5.0	release/v5.1<br>提交 ID: 22cfbf30c3	esp-sr 组件版本：v1.3.4	兼容 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite <br/>使用 menuconfig 选择开发板
标签 0.3.0	release/v4.4<br>提交 ID: 2bdea81b2a	esp-sr 版本：dev/v2.0<br>提交 ID: c873a35	兼容 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite
标签 0.2.1	release/v4.4 带补丁	esp-sr 版本：接近 v1.0<br/>提交 ID: 3ce34fe	仅支持 ESP32-S3-BOX
标签 0.1.1	release/v4.4 带补丁	esp-sr 版本：v0.9.6<br/>提交 ID: 3ce34fe	仅支持 ESP32-S3-BOX

特性

• 一款开箱即用的入门级边缘 AI + HMI 应用开发板。
• 基于 FreeRTOS 的四合一语音交互面板：离线语音识别、网络通信、屏幕显示、外设控制。
• 支持双麦远场语音交互。
• 高唤醒率的离线语音唤醒和命令识别。
• 允许连续识别、唤醒中断和超过 200 个可自定义命令词。
• 灵活多样的家庭自动化解决方案：Matter、Home Assistant、ESP-RainMaker
• 可视化拖放式 GUI 开发：LVGL SquareLine Studio、Embedded Wizard 等。
• 丰富的开发框架：ESP-IDF、Arduino、PlatformIO、Circuit Python 等。

开源内容

• 原理图和 PCB 源文件
• 外壳 3D 打印源文件
• 内置固件源代码
• 其他示例

基于 Apache 2.0 开源许可证，您可以自由修改、开发或分发内容。

内置固件用户指南

• 建议从阅读产品硬件概述开始。
• 接下来您可以探索入门指南。
• 要探索有趣的传感器演示，请参阅传感器应用。
• 要体验语音助手，请参阅语音辅助控制。
• 要体验更人性化的交互体验，请参阅连续语音识别。
• 要通过移动应用定义语音命令，请参阅ESP BOX APP 用户指南。
• 要切换语音模型语言，请参阅切换语音模型语言。
• 关于产品分解图和拆卸教程，请参阅拆卸教程。
• 要了解更多硬件信息详情，请参阅硬件概述。
• 关于最新版本固件，请参阅固件更新。

开发者指南

ESP-BOX 集成了来自 ESP Registry 的 ESP-IDF 组件，这些组件常用于 AIoT 开发，您可以利用它们构建自己的应用程序。

快速入门

• 步骤 1. 构建应用程序需要 ESP-IDF（乐鑫物联网开发框架）。如果这是您第一次使用 ESP-IDF，请参阅 ESP-IDF 开发指南，了解乐鑫提供的开源驱动程序和组件。
• 步骤 2. 接下来，设置开发环境。请参阅 ESP-IDF（release/v5.1）逐步安装指南。
• 步骤 3. 运行命令 git clone --recursive https://github.com/espressif/esp-box.git 下载本项目的代码，然后将 ESP-IDF 版本切换到指定版本；
• 步骤 4. 迈出小小的一步，您可以构建并烧录一个简单示例。
• 步骤 5. 进一步探索，请阅读 ESP-BOX 技术架构以了解技术细节。
• 步骤 6. 深入了解，请阅读 ESP 语音识别应用指南、ESP RainMaker 编程指南、LVGL GUI 快速概述。
• 步骤 7. 扩展功能，请阅读 Pmod™ 兼容接头 和 ESP-IDF API 参考，以开发更多扩展设备的驱动程序。

云端快速入门

ESP BOX APP 基于商业移动 APP 架构 Nova Home 构建，提供了精美的 UI 和更好的用户体验，但开放性有限。要获取访问权限，客户需要通过电子邮件 sales@espressif.com 与我们进行商业联系。 对于开发者，我们提供 ESP RainMaker 解决方案，其中包括公开可用的开发文档和 API 指南。以下是访问它们的途径：

• ESP RainMaker 入门指南
• ESP RainMaker 编程指南
• RainMaker App API 定义

NuttX

ESP32-S3-BOX-3 还支持与 NuttX 集成，提供更多的灵活性和功能。NuttX 是一个实时操作系统（RTOS），以其小巧的体积、高效性和实时性能而闻名，是嵌入式系统的绝佳选择。

开发者优秀项目

我们积极收集基于 ESP-BOX 的优秀项目，以激发更多开发者的创新。我们感谢那些推动蓬勃社区文化的爱好者，并欢迎更多开发者为充满活力的 ESP32 社区做出贡献。

联系我们

• 如果您有任何技术问题，请在 GitHub Issues 或论坛 esp32.com 上提交问题以获取帮助。
• 如果您对 ESP-BOX 项目感兴趣，欢迎到 ESP-BOX 论坛 与我们分享您的想法。

贡献示例

我们欢迎任何开源软件或硬件的贡献。如果您有想与我们分享的示例，请点击贡献指南并提交Pull Requests以贡献您的代码。