esp-box
- English Version
- Gitee 镜像仓库
- 宣传视频
ESP-BOX AIoT 开发框架
重要提醒：
在收到 ESP32-S3-BOX-3 后，我们建议您更新内置的出厂固件，以确保拥有最新的 bug 修复。您可以使用乐鑫在线固件烧录工具 ESP Launchpad 进行此操作。截止目前，最新版本为 ESP-BOX-3_Demo_V1.2.4。请前往 “About Us” 页面验证设备出厂固件版本。
ESP-BOX 是乐鑫科技推出的面向 AIoT、边缘 AI 和 IIoT 应用的开发平台。ESP32-S3-BOX、ESP32-S3-BOX-Lite 和 ESP32-S3-BOX-3 是为该平台设计的系列开发板，它们基于乐鑫强大的 ESP32-S3 Wi-Fi + Bluetooth 5（LE） SoC 构建，并拥有紧凑美观的外壳结构。借助多功能配件和 ESP-BOX 项目内的可靠例程，这些开发板既适用于构建新项目原型，也适用于打造复杂的物联网系统，提供了形式上和功能上的完美平衡。
ESP-BOX 为各个领域的应用提供了开发资源，包括离线语音助手、在线 AI 聊天机器人（使用 OpenAI 和其他大型语言模型平台开发）、Matter 设备/控制器、机器人控制器、USB 主从设备、无线传感器应用以及广泛的人机交互（HMI）应用。将其加入工具箱，尽情体验各种可能性，发掘无限潜力！
| 产品名称 | 产品图 | 市场状态 |
|---|---|---|
| ESP32-S3-BOX 1 |  |
寿命终止 用户指南 |
| ESP32-S3-BOX-Lite 1 |  |
寿命终止（仅剩裸板在售） 用户指南 |
| ESP32-S3-BOX-3 |  |
在售 用户指南 |
Note 1: 对于 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite，我们建议您更新内置的出厂应用固件以确保拥有最新的 bug 修复。在 Master 分支，我们将逐步对这两款开发板提供有限的支持。有关更多信息，请阅读各例程的 README。
版本信息
| ESP-BOX | 依赖的 ESP-IDF | 分支信息 | 支持状态 |
|---|---|---|---|
| master | >= release/v5.1 commit id: 22cfbf30c3 |
Latest developing firmware esp-sr components version: v1.4.1 |
部分支持 ESP32-S3-BOX，ESP32-S3-BOX-Lite 和 ESP32-S3-BOX-3 使用 menuconfig 选择开发板 详见 Examples README |
| Tag 0.5.0 | release/v5.1 commit id: 22cfbf30c3 |
esp-sr components version: v1.3.4 | 兼容 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite 使用 menuconfig 选择开发板 |
| Tag 0.3.0 | release/v4.4 commit id: 22cfbf30c3 |
esp-sr version: dev/v2.0 commit id: c873a35 |
兼容 ESP32-S3-BOX 和 ESP32-S3-BOX-Lite |
| Tag 0.2.1 | release/v4.4 with patch | esp-sr version: close v1.0 commit id: 3ce34fe |
仅支持 ESP32-S3-BOX |
| Tag 0.1.1 | Release/v4.4 with patch | esp-sr version: v0.9.6 commit 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 等
开源内容
基于 Apache 2.0 开源协议，你可以免费且自由的修改、创作和分享。
内置固件使用指引
- 首次拿到开发板，建议先阅读产品硬件概览；
- 接着可以查看首次使用操作指引；
- 体验有意思的传感器应用；
- 体验离线语音助手功能，您可以查看离线语音识别；
- 体验更人性化的语音交互，可查看连续语音识别；
- 通过手机 APP 设置独特的语音命令词，请查看 ESP BOX APP 操作指引；
- 如需切换语音模型语言，请查看中英文语音模型切换；
- 了解产品爆炸图和拆机说明，请查看拆机教程；
- 更新最新版本固件，请查看固件更新说明。
开发指引
ESP-BOX 调用乐鑫 ESP-IDF 的包管理器 ESP Registry 中常用的组件，您可以利用这些组件构建自己的应用。
快速开始
- Step 1. 如果您首次接触 ESP-IDF 开发，建议先浏览 ESP-IDF 编程指南，了解乐鑫已经提供的开源驱动和组件；
- Step 2. 接下来您可以详细阅读 ESP-IDF（release/v5.1) 环境搭建指引，一步一步完成开发环境搭建;
- Step 3. 使用指令
git clone --recursive https://github.com/espressif/esp-box.git下载本项目的代码，然后需要将 esp-idf 版本切换到指定的版本； - Step 4. 小试牛刀，您可以尝试 构建并烧录一个新的示例程序；
- Step 5. 更进一步，您可以阅读 ESP-BOX 技术架构说明，了解更多技术细节；
- Step 6. 深入开发，您可以阅读 ESP 语音识别应用开发指南，ESP RainMaker 编程指南，LVGL UI 界面开发快速总览；
- Step 7. 扩展功能，您可以阅读 开发板 Pmod™ 兼容接口介绍 和 ESP-IDF API 参考手册，为更多扩展设备开发驱动。
云连接开发指南
ESP BOX APP 基于商业版 Nova Home 应用 APP 构建，拥有精美的用户界面和更好的用户体验，但由于 Nova Home App 有限开放，客户如需项目资源，可通过 sales@espressif.com 邮件与我们联系。 对于个人开发者，我们提供 ESP RainMaker 解决方案，其中包括公开可用的开发文档和 API 指南。以下是开发资源访问路径：
NuttX
ESP32-S3-BOX-3 支持与 NuttX 集成，提供了更多的灵活性和功能。Nuttx 是一款以其小巧、高效和实时性能而闻名的实时操作系统（RTOS），使其成为嵌入式系统的绝佳选择。
优秀开源社区项目
我们积极搜集基于 ESP-BOX 的优秀项目，以激发更多 makers 的创新思维。我们对推动社区文化繁荣的倡导者表示由衷的感谢，并欢迎更多的开发人员为充满活力的ESP32社区贡献力量。
联系我们
- 如果有任何开发和使用问题，您可添加 GitHub Issues 或到 esp32.com 论坛寻求帮助；
- 如果你对 ESP-BOX 项目感兴趣，欢迎到论坛 ESP-BOX 版块交流想法。
贡献示例
我们欢迎任何软件或硬件相关的开源贡献，如果您有任何要与我们分享的示例，请参考贡献指南后提交 Pull Requests 贡献代码。