Merge branch 'docs/add_box_lite' into 'master'
docs: add documents for supporting box and box-lite See merge request ae_group/esp-box!25
Wu Jian Gang
@@ -2,26 +2,29 @@
|
||||
|
||||
# ESP-BOX AIoT Development Framework
|
||||
|
||||
**Important Note: We recommend [updating the ESP32-S3-BOX firmware](./docs/firmware_update.md) when you first receive the product to have the latest features and bugfix.**
|
||||
**Important Note: We recommend [updating the application firmware](./docs/firmware_update.md) when you first receive the product to have the latest features and bugfix.**
|
||||
|
||||
The ESP-BOX is a new generation AIoT development platform released by Espressif Systems. The ESP32-S3-BOX is an AIoT development board that is based on Espressif’s ESP32-S3 Wi-Fi + Bluetooth 5 (LE) SoC. The ESP32-S3-BOX provides a platform for developing the control of home appliances using Voice Assistance + touch screen controller, sensor, infrared controller, and intelligent Wi-Fi gateway. The ESP32-S3-BOX comes with pre-built firmware that supports offline voice interaction, with the SDKs and examples provided by Espressif, you will be able to develop a wide variety of AIoT applications based on the ESP32-S3-BOX such as online and offline voice assistants, voice-enabled devices, HMI touch-screen devices, control panels, multi-protocol gateways easily.
|
||||
The ESP-BOX is a new generation AIoT development platform released by Espressif Systems. The ESP32-S3-BOX and ESP32-S3-BOX-Lite are AIoT development boards that are based on Espressif’s ESP32-S3 Wi-Fi + Bluetooth 5 (LE) SoC. They provide a platform for developing the control of home appliances using Voice Assistance + touch and screen controller, sensor, infrared controller, and intelligent Wi-Fi gateway. Development boards come with pre-built firmware that supports offline voice interaction, with the SDKs and examples provided by Espressif, you will be able to develop a wide variety of AIoT applications based on the BOX series products such as online and offline voice assistants, voice-enabled devices, human-computer interaction devices, control panels, multi-protocol gateways easily.
|
||||
|
||||
|
||||
| Product Name | Product Figure |
|
||||
| :-----: | :---------------------: |
|
||||
| ESP32-S3-BOX<br> | [<img src="docs/_static/esp32_s3_box.png" width="200px" href="docs/esp32-s3-box/hardware_overview_for_box_cn.md"/>](docs/esp32_s3_box/hardware_overview_for_box_cn.md) |
|
||||
| ESP32-S3-BOX-Lite<br> | [<img src="docs/_static/esp32_s3_box_lite.png" width="200px" />](docs/esp32_s3_box_lite/hardware_overview_for_lite_cn.md) |
|
||||
|
||||
**ESP-BOX features:**
|
||||
|
||||
* Supports far-field voice interaction with 2 mics
|
||||
* Offline voice wake-up with high wake-up rate
|
||||
* Offline speech commands recognition in Chinese and English languages with high recognition rate
|
||||
* Reconfigurable voice commands in Chinese and English languages
|
||||
* Reconfigurable 200+ speech commands in Chinese and English languages
|
||||
* Flexible and reusable GUI framework
|
||||
* End-to-end IoT development framework ESP-RainMaker
|
||||
* End-to-end AIoT dvelopment framwork ESP-RainMaker
|
||||
* Pmod™ compatible headers support expand peripheral modules
|
||||
|
||||
**ESP-BOX Open-Source Content Include:**
|
||||
|
||||
* [Schematic and PCB Source File](./hardware)
|
||||
* [Shell 3D Print Source File](./hardware/esp32_s3_box_shell_step)
|
||||
* [Shell 3D Print Source File](./hardware)
|
||||
* [Firmware Source Code](./examples/factory_demo)
|
||||
* [Examples Source Code](./examples)
|
||||
|
||||
@@ -29,12 +32,12 @@ The ESP-BOX is a new generation AIoT development platform released by Espressif
|
||||
|
||||
## User Guide
|
||||
|
||||
* For getting start of ESP32-S3-BOX, please refer to the [Getting Started](./docs/getting_started.md)
|
||||
* For voice control and customization, please refer to the [Voice Assistance Control and Customization](./docs/getting_started.md#voice-assistance-control-and-customization)
|
||||
* For control the device by graphical user interface, please refer to the [ESP32-S3-BOX GUI Guide](./docs/getting_started.md#esp32-s3-box-graphical-user-interface)
|
||||
* For product exploded-view and disassembly tutorial, please refer to [ESP32-S3-BOX Disassembly Tutorial](docs/disassembly_tutorial.md)
|
||||
* For more detils of ESP32-S3-BOX hardware, please refer to the [ESP32-S3-BOX hardware overview](./docs/hardware_overview.md).
|
||||
* For latest version firmware, please refer to the [ESP32-S3-BOX firmware update](./docs/firmware_update.md)
|
||||
* For getting start of BOX serial development boards, please refer to the [Getting Started](./docs/getting_started.md)
|
||||
* For experiencing voice assistant, please refer to the [Voice Assistance Control and Customization](./docs/getting_started.md#offline-voice-assistant-with-your-device)
|
||||
* For defining the speech commands by mobile APP, please refer to the [ESP-BOX APP User Guide](./docs/getting_started.md#voice-command-customization)
|
||||
* For product exploded-view and disassembly tutorial, please refer to [Disassembly Tutorial](docs/disassembly_tutorial.md)
|
||||
* For more detils of hardware information, please refer to the [Hardware Overview](./docs/hardware_overview).
|
||||
* For latest version firmware, please refer to the [Firmware Update](./docs/firmware_update.md)
|
||||
|
||||
## Developer Guide
|
||||
|
||||
@@ -43,8 +46,8 @@ The ESP-BOX is a new generation AIoT development platform released by Espressif
|
||||
* **Step 3**. Additionally, apply the patch files on current ESP-IDF, please refer [Patch for ESP-IDF](./idf_patch) for details.
|
||||
* **Step 4**. Take a small step, you can [build and flash a simple example](./examples/image_display).
|
||||
* **Step 5**. Moving further, please read [ESP-BOX technical architecture](./docs/technical_architecture.md) to understand the technical details.
|
||||
* **Step 6**. Going deeper, please read [ESP Speech Recognition Application Guide](https://github.com/espressif/esp-sr), [ESP RainMaker Programming Guide](https://docs.espressif.com/projects/esp-rainmaker/en/latest/), [LVGL GUI Quick overview](https://docs.lvgl.io/latest/en/html/get-started/quick-overview.html).
|
||||
* **Step 7**. For extended function, please read [ESP32-S3-BOX Pmod™ compatible headers](./docs/hardware_overview.md) and [ESP-IDF API reference](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/index.html), to develop drivers for more extended devices.
|
||||
* **Step 6**. Going deeper, please read [ESP Speech Recognition Application Guide](https://github.com/espressif/esp-sr), [ESP RainMaker Programming Guide](https://docs.espressif.com/projects/esp-rainmaker/en/latest/), [LVGL GUI Quick overview](https://docs.lvgl.io/8.1/get-started/index.html).
|
||||
* **Step 7**. For extended function, please read [Pmod™ compatible headers](./docs/hardware_overview) and [ESP-IDF API reference](https://docs.espressif.com/projects/esp-idf/en/v4.4/esp32s3/api-reference/index.html), to develop drivers for more extended devices.
|
||||
|
||||
## Contact Us
|
||||
|
||||
|
||||
@@ -1,55 +1,59 @@
|
||||
* [English Version](./README.md)
|
||||
* [Gitee 镜像仓库](https://gitee.com/EspressifSystems/esp-box)
|
||||
|
||||
# ESP-BOX AIoT 开发框架
|
||||
|
||||
**重要提醒：**
|
||||
**我们建议您在第一次收到产品时[更新 ESP32-S3-BOX 的固件](./docs/firmware_update_cn.md)以获得最新功能和 bug 的修复。**
|
||||
|
||||
ESP-BOX 是乐鑫信息科技发布的新一代 AIoT 应用开发平台。ESP32-S3-BOX 是对应的 AIoT 应用开发板，搭载支持 AI 加速的 ESP32-S3 Wi-Fi + Bluetooth 5 (LE) SoC。ESP32-S3-BOX 为用户提供了一个基于语音助手 + 触摸屏控制、传感器、红外控制器和智能 Wi-Fi 网关等功能，开发和控制智能家居设备的平台。ESP32-S3-BOX 出厂支持离线语音交互功能，通过乐鑫丰富的 SDK 和解决方案，能够轻松构建在线和离线语音助手、智能语音设备、HMI 触摸屏设备、控制面板、多协议网关等多样的应用。
|
||||
|
||||
|
||||
|
||||
**ESP-BOX 支持以下特性:**
|
||||
|
||||
* 双麦克风支持远场语音交互
|
||||
* 高唤醒率的离线语音唤醒
|
||||
* 高识别率的离线中英文命令词识别
|
||||
* 可动态配置的中英文命令词
|
||||
* 灵活可复用的 GUI 框架
|
||||
* 端到端一站式接入云平台
|
||||
* Pmod™ 兼容接口支持多种外设扩展
|
||||
|
||||
**ESP-BOX 开源内容包括:**
|
||||
|
||||
* [原理图与 PCB 源文件](./hardware)
|
||||
* [外壳 3D 打印源文件](./hardware/esp32_s3_box_shell_step)
|
||||
* [出厂固件源代码](./examples/factory_demo)
|
||||
* [示例程序源代码](./examples)
|
||||
|
||||
> 基于 [Apache 2.0](https://github.com/espressif/esp-box/blob/master/LICENSE) 开源协议，你可以免费且自由的修改、创作和分享。
|
||||
|
||||
## 使用指引
|
||||
|
||||
* 首次拿到 ESP32-S3-BOX，您可以查看[首次使用操作指引](./docs/getting_started_cn.md#给-esp32-s3-box-供电)
|
||||
* 想要设置独特的语音命令词，您可以查看[修改自定义命令词](./docs/getting_started_cn.md#语音控制命令词自定义)
|
||||
* 想要通过界面控制设备，请查看[图形界面操作指引](./docs/getting_started_cn.md#esp32-s3-box-图形界面)
|
||||
* 想要了解产品爆炸图和拆机说明, 请查看 [ESP32-S3-BOX 拆机教程](docs/disassembly_tutorial.md)
|
||||
* 想要了解 ESP32-S3-BOX 硬件和接口细节，请查看 [ESP32-S3-BOX 硬件总览](./docs/hardware_overview_cn.md)
|
||||
* 想要使用最新版本固件，请查看[固件更新说明](./docs/firmware_update_cn.md)
|
||||
|
||||
## 开发指引
|
||||
|
||||
* **Step 1**. 如果您首次接触 ESP-IDF 开发，建议先浏览 [ESP-IDF 编程指南](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32s3/index.html)，了解乐鑫已经提供的开源驱动和组件；
|
||||
* **Step 2**. 接下来您可以详细阅读 [ESP-IDF（release/v4.4） 环境搭建指引](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32s3/get-started/index.html#installation-step-by-step), 一步一步完成开发环境搭建；
|
||||
* **Step 3**. 此外, 请在当前 ESP-IDF 上打上补丁, 详情请参考 [Patch for ESP-IDF](./idf_patch).
|
||||
* **Step 4**. 小试牛刀，您可以尝试 [构建并烧录一个新的示例程序](./examples/image_display)；
|
||||
* **Step 5**. 更进一步，您可以阅读 [ESP-BOX 技术架构说明](./docs/technical_architecture_cn.md)，了解更多技术细节；
|
||||
* **Step 6**. 深入开发，您可以阅读 [ESP 语音识别应用开发指南](https://github.com/espressif/esp-sr), [ESP RainMaker 编程指南](https://docs.espressif.com/projects/esp-rainmaker/en/latest/), [LVGL UI 界面开发快速总览](https://docs.lvgl.io/latest/en/html/get-started/quick-overview.html)；
|
||||
* **Step 7**. 扩展功能，您可以阅读 [ESP32-S3-BOX Pmod™ 兼容接口介绍](./docs/hardware_overview_cn.md) 和 [ESP-IDF API 参考手册](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/index.html)，为更多扩展设备开发驱动；
|
||||
|
||||
## 联系我们
|
||||
|
||||
* 如果有任何开发和使用问题，您可添加 [GitHub Issues](https://github.com/espressif/esp-box/issues) 或到 [esp32.com](https://esp32.com/) 论坛寻求帮助；
|
||||
* 如果你对 ESP-BOX 项目感兴趣，欢迎到论坛 [ESP-BOX 版块](https://esp32.com/viewforum.php?f=43)交流想法；
|
||||
* 我们欢迎任何软件或硬件相关的开源贡献，您可直接提交 [Pull Requests](https://github.com/espressif/esp-box/pulls) 贡献代码。
|
||||
* [English Version](./README.md)
|
||||
* [Gitee 镜像仓库](https://gitee.com/EspressifSystems/esp-box)
|
||||
|
||||
# ESP-BOX AIoT 开发框架
|
||||
|
||||
**重要提醒：**
|
||||
**我们建议您在第一次收到产品时[更新应用固件](./docs/firmware_update_cn.md)以获得最新功能和 bug 的修复。**
|
||||
|
||||
ESP-BOX 是乐鑫信息科技发布的新一代 AIoT 应用开发平台。ESP32-S3-BOX 和 ESP32-S3-BOX-Lite 是目前对应的 AIoT 应用开发板，搭载支持 AI 加速的 ESP32-S3 Wi-Fi + Bluetooth 5 (LE) SoC。他们为用户提供了一个基于语音助手 + 触摸屏控制、传感器、红外控制器和智能 Wi-Fi 网关等功能，开发和控制智能家居设备的平台。开发板出厂支持离线语音交互功能，用户通过乐鑫丰富的 SDK 和解决方案，能够轻松构建在线和离线语音助手、智能语音设备、HMI 人机交互设备、控制面板、多协议网关等多样的应用。
|
||||
|
||||
| 开发板名称 | 产品图 |
|
||||
| :-----: | :---------------------: |
|
||||
| ESP32-S3-BOX<br> | [<img src="docs/_static/esp32_s3_box.png" width="200px" href="docs/esp32-s3-box/hardware_overview_for_box_cn.md"/>](docs/esp32_s3_box/hardware_overview_for_box_cn.md) |
|
||||
| ESP32-S3-BOX-Lite<br> | [<img src="docs/_static/esp32_s3_box_lite.png" width="200px" />](docs/esp32_s3_box_lite/hardware_overview_for_lite_cn.md) |
|
||||
|
||||
|
||||
**ESP-BOX 支持以下特性:**
|
||||
|
||||
* 双麦克风支持远场语音交互
|
||||
* 高唤醒率的离线语音唤醒
|
||||
* 高识别率的离线中英文命令词识别
|
||||
* 可动态配置 200+ 中英文命令词
|
||||
* 灵活可复用的 GUI 框架
|
||||
* 端到端一站式接入云平台
|
||||
* Pmod™ 兼容接口支持多种外设扩展
|
||||
|
||||
**ESP-BOX 开源内容包括:**
|
||||
|
||||
* [原理图与 PCB 源文件](./hardware)
|
||||
* [外壳 3D 打印源文件](./hardware)
|
||||
* [出厂固件源代码](./examples/factory_demo)
|
||||
* [示例程序源代码](./examples)
|
||||
|
||||
> 基于 [Apache 2.0](https://github.com/espressif/esp-box/blob/master/LICENSE) 开源协议，你可以免费且自由的修改、创作和分享。
|
||||
|
||||
## 使用指引
|
||||
|
||||
* 首次拿到 BOX 系列开发板，您可以查看 [首次使用操作指引](./docs/getting_started_cn.md#给设备供电)
|
||||
* 想要体验离线语音助手功能，您可以查看 [离线语音识别](./docs/getting_started_cn.md#体验离线语音识别)
|
||||
* 想要通过手机 APP 设置独特的语音命令词，请查看 [ESP-BOX APP 操作指引](./docs/getting_started_cn.md#语音命令词自定义)
|
||||
* 想要了解产品爆炸图和拆机说明，请查看 [拆机教程](docs/disassembly_tutorial.md)
|
||||
* 想要了解开发板硬件和接口细节，请查看 [硬件总览](./docs/hardware_overview)
|
||||
* 想要使用最新版本固件，请查看 [固件更新说明](./docs/firmware_update_cn.md)
|
||||
|
||||
## 开发指引
|
||||
|
||||
* **Step 1**. 如果您首次接触 ESP-IDF 开发，建议先浏览 [ESP-IDF 编程指南](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32s3/index.html)，了解乐鑫已经提供的开源驱动和组件；
|
||||
* **Step 2**. 接下来您可以详细阅读 [ESP-IDF（release/v4.4） 环境搭建指引](https://docs.espressif.com/projects/esp-idf/en/release-v4.4/esp32s3/get-started/index.html#installation-step-by-step)，一步一步完成开发环境搭建；
|
||||
* **Step 3**. 此外，请在当前 ESP-IDF 上打上补丁，详情请参考 [Patch for ESP-IDF](./idf_patch).
|
||||
* **Step 4**. 小试牛刀，您可以尝试 [构建并烧录一个新的示例程序](./examples/image_display)；
|
||||
* **Step 5**. 更进一步，您可以阅读 [ESP-BOX 技术架构说明](./docs/technical_architecture_cn.md)，了解更多技术细节；
|
||||
* **Step 6**. 深入开发，您可以阅读 [ESP 语音识别应用开发指南](https://github.com/espressif/esp-sr)，[ESP RainMaker 编程指南](https://docs.espressif.com/projects/esp-rainmaker/en/latest/)，[LVGL UI 界面开发快速总览](https://docs.lvgl.io/8.1/get-started/index.html)；
|
||||
* **Step 7**. 扩展功能，您可以阅读 [开发板 Pmod™ 兼容接口介绍](./docs/hardware_overview) 和 [ESP-IDF API 参考手册](https://docs.espressif.com/projects/esp-idf/en/v4.4/esp32s3/api-reference/index.html)，为更多扩展设备开发驱动；
|
||||
|
||||
## 联系我们
|
||||
|
||||
* 如果有任何开发和使用问题，您可添加 [GitHub Issues](https://github.com/espressif/esp-box/issues) 或到 [esp32.com](https://esp32.com/) 论坛寻求帮助；
|
||||
* 如果你对 ESP-BOX 项目感兴趣，欢迎到论坛 [ESP-BOX 版块](https://www.esp32.com/viewforum.php?f=43) 交流想法；
|
||||
* 我们欢迎任何软件或硬件相关的开源贡献，您可直接提交 [Pull Requests](https://github.com/espressif/esp-box/pulls) 贡献代码。
|
||||
|
||||
|
After Width: | Height: | Size: 3.8 KiB |
|
After Width: | Height: | Size: 207 KiB |
|
After Width: | Height: | Size: 5.2 KiB |
|
After Width: | Height: | Size: 277 KiB |
|
After Width: | Height: | Size: 299 KiB |
|
After Width: | Height: | Size: 181 KiB |
|
After Width: | Height: | Size: 300 KiB |
|
After Width: | Height: | Size: 396 KiB |
|
After Width: | Height: | Size: 399 KiB |
|
After Width: | Height: | Size: 265 KiB |
|
After Width: | Height: | Size: 285 KiB |
|
After Width: | Height: | Size: 4.5 KiB |
|
After Width: | Height: | Size: 4.9 KiB |
|
After Width: | Height: | Size: 4.8 KiB |
|
After Width: | Height: | Size: 4.5 KiB |
|
After Width: | Height: | Size: 4.5 KiB |
|
After Width: | Height: | Size: 4.5 KiB |
|
After Width: | Height: | Size: 238 KiB |
|
After Width: | Height: | Size: 8.5 KiB |
|
After Width: | Height: | Size: 4.7 KiB |
|
After Width: | Height: | Size: 5.1 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 292 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 9.4 KiB |
|
After Width: | Height: | Size: 7.7 KiB |
|
After Width: | Height: | Size: 226 KiB |
|
After Width: | Height: | Size: 8.3 KiB |
|
After Width: | Height: | Size: 13 KiB |
|
After Width: | Height: | Size: 181 KiB |
|
After Width: | Height: | Size: 8.4 KiB |
|
After Width: | Height: | Size: 9.9 KiB |
|
After Width: | Height: | Size: 174 KiB |
|
After Width: | Height: | Size: 10 KiB |
|
After Width: | Height: | Size: 137 KiB |
|
After Width: | Height: | Size: 11 KiB |
|
After Width: | Height: | Size: 139 KiB |
|
After Width: | Height: | Size: 6.3 KiB |
|
After Width: | Height: | Size: 3.8 KiB |
|
After Width: | Height: | Size: 48 KiB |
|
After Width: | Height: | Size: 146 KiB |
|
After Width: | Height: | Size: 23 KiB |
|
After Width: | Height: | Size: 114 KiB |
|
Before Width: | Height: | Size: 19 KiB After Width: | Height: | Size: 19 KiB |
|
Before Width: | Height: | Size: 113 KiB After Width: | Height: | Size: 113 KiB |
@@ -0,0 +1,150 @@
|
||||
<style type="text/css">
|
||||
.tg {border-collapse:collapse;border-spacing:0;}
|
||||
.tg td{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
|
||||
overflow:hidden;padding:6px 4px;word-break:normal;}
|
||||
.tg th{border-color:black;border-style:solid;border-width:1px;font-family:Arial, sans-serif;font-size:14px;
|
||||
font-weight:normal;overflow:hidden;padding:6px 4px;word-break:normal;}
|
||||
.tg .tg-ycr8{background-color:#ffffff;text-align:left;vertical-align:top}
|
||||
.tg .tg-3wa1{background-color:#ECF4FF;font-weight:bold;text-align:center;vertical-align:middle}
|
||||
.tg .tg-zr06{background-color:#FFF;text-align:left;vertical-align:middle}
|
||||
.tg .tg-o2c7{background-color:#ECF4FF;font-weight:bold;text-align:center;vertical-align:top}
|
||||
.tg .tg-0lax{text-align:left;vertical-align:top}
|
||||
</style>
|
||||
<table class="tg" style="undefined;table-layout: fixed; width: 781px">
|
||||
<colgroup>
|
||||
<col style="width: 146px">
|
||||
<col style="width: 227px">
|
||||
<col style="width: 156px">
|
||||
<col style="width: 252px">
|
||||
</colgroup>
|
||||
<thead>
|
||||
<tr>
|
||||
<th class="tg-3wa1" colspan="4">SoC</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td class="tg-zr06">SoC Type:</td>
|
||||
<td class="tg-zr06">ESP32-S3</td>
|
||||
<td class="tg-zr06">SoC Details:</td>
|
||||
<td class="tg-zr06">Dual-Core, 2.4 GHz Wi-Fi and Bluetooth® 5 LE</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-o2c7" colspan="4"><span style="font-weight:bold">CPU / Memory</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">CPU Type:</td>
|
||||
<td class="tg-zr06">Dual-Core Xtensa® 32bit LX7</td>
|
||||
<td class="tg-zr06">CPU Speed:</td>
|
||||
<td class="tg-zr06">240 MHz</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Flash Type:</td>
|
||||
<td class="tg-zr06">Quad SPI</td>
|
||||
<td class="tg-zr06">Flash Size:</td>
|
||||
<td class="tg-zr06">16 MB</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Flash Speed:</td>
|
||||
<td class="tg-zr06">120 MHz</td>
|
||||
<td class="tg-zr06">SRAM Size</td>
|
||||
<td class="tg-zr06">512 KB</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">PSRAM Type:</td>
|
||||
<td class="tg-zr06">Octal SPI</td>
|
||||
<td class="tg-zr06">PSRAM Size:</td>
|
||||
<td class="tg-zr06">8 MB</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-ycr8">PSRAM Speed:</td>
|
||||
<td class="tg-ycr8">120 MHz</td>
|
||||
<td class="tg-ycr8"></td>
|
||||
<td class="tg-ycr8"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-3wa1" colspan="4">AI Ability</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">AI Algorithm</td>
|
||||
<td class="tg-zr06">Neural Network, Acoustic Algorithm, Wakeup Interrupt, Continuous Recognition, etc.</td>
|
||||
<td class="tg-zr06">Computing Acceleration</td>
|
||||
<td class="tg-zr06">Vector, Complex number, FFT, etc.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-3wa1" colspan="4">Wireless</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Wi-Fi:</td>
|
||||
<td class="tg-zr06">IEEE 802.11b/g/n</td>
|
||||
<td class="tg-zr06">Bluetooth® LE:</td>
|
||||
<td class="tg-zr06">Bluetooth® 5 and Bluetooth® mesh</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-o2c7" colspan="4"><span style="font-weight:bold">Display</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Display Type:</td>
|
||||
<td class="tg-zr06">2.4‑inch LCD</td>
|
||||
<td class="tg-zr06">Display Resolution:</td>
|
||||
<td class="tg-zr06">240 x 320</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Display Interface:</td>
|
||||
<td class="tg-zr06">SPI</td>
|
||||
<td class="tg-zr06">Interface Speed:</td>
|
||||
<td class="tg-zr06">40 MHz</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-o2c7" colspan="4"><span style="font-weight:bold">Microphone</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Microphone Type:</td>
|
||||
<td class="tg-zr06">Dual Mic</td>
|
||||
<td class="tg-zr06">ADC Model:</td>
|
||||
<td class="tg-zr06">ES7243</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Mute:</td>
|
||||
<td class="tg-zr06">Supported</td>
|
||||
<td class="tg-0lax"></td>
|
||||
<td class="tg-0lax"></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-o2c7" colspan="4"><span style="font-weight:bold">Speaker</span></td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Codec Model:</td>
|
||||
<td class="tg-zr06">ES8156</td>
|
||||
<td class="tg-zr06">PA Model:</td>
|
||||
<td class="tg-zr06">NS4150</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-3wa1" colspan="4">OS / SDK</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Original OS:</td>
|
||||
<td class="tg-zr06">FreeRTOS</td>
|
||||
<td class="tg-zr06">SDK:</td>
|
||||
<td class="tg-zr06">ESP-IDF</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-3wa1" colspan="4">Outline</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">Dimensions:</td>
|
||||
<td class="tg-zr06">62.6 x 52.2 x 9.5 mm</td>
|
||||
<td class="tg-zr06">Weight:</td>
|
||||
<td class="tg-zr06">TBD</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-3wa1" colspan="4">Power</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td class="tg-zr06">USB-C Power:</td>
|
||||
<td class="tg-zr06">5 V - 2.0 A Input</td>
|
||||
<td class="tg-zr06">Battery:</td>
|
||||
<td class="tg-zr06">N/A</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
After Width: | Height: | Size: 111 KiB |
|
After Width: | Height: | Size: 463 KiB |
|
After Width: | Height: | Size: 210 KiB |
|
Before Width: | Height: | Size: 214 KiB After Width: | Height: | Size: 214 KiB |
|
After Width: | Height: | Size: 54 KiB |
|
After Width: | Height: | Size: 91 KiB |
|
Before Width: | Height: | Size: 548 KiB After Width: | Height: | Size: 548 KiB |
|
Before Width: | Height: | Size: 225 KiB After Width: | Height: | Size: 225 KiB |
|
After Width: | Height: | Size: 4.4 MiB |
|
Before Width: | Height: | Size: 52 KiB After Width: | Height: | Size: 52 KiB |
|
Before Width: | Height: | Size: 26 KiB After Width: | Height: | Size: 26 KiB |
|
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
|
Before Width: | Height: | Size: 102 KiB After Width: | Height: | Size: 102 KiB |
|
Before Width: | Height: | Size: 5.1 KiB After Width: | Height: | Size: 5.1 KiB |
|
Before Width: | Height: | Size: 4.2 KiB After Width: | Height: | Size: 4.2 KiB |
|
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 17 KiB |
|
Before Width: | Height: | Size: 12 KiB After Width: | Height: | Size: 12 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
|
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 33 KiB |
|
Before Width: | Height: | Size: 85 KiB After Width: | Height: | Size: 85 KiB |
|
Before Width: | Height: | Size: 14 KiB After Width: | Height: | Size: 14 KiB |
|
Before Width: | Height: | Size: 36 KiB After Width: | Height: | Size: 36 KiB |
|
Before Width: | Height: | Size: 35 KiB After Width: | Height: | Size: 35 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 18 KiB After Width: | Height: | Size: 18 KiB |
|
Before Width: | Height: | Size: 23 KiB After Width: | Height: | Size: 23 KiB |
|
Before Width: | Height: | Size: 20 KiB After Width: | Height: | Size: 20 KiB |
|
Before Width: | Height: | Size: 8.9 KiB After Width: | Height: | Size: 8.9 KiB |
|
Before Width: | Height: | Size: 24 KiB After Width: | Height: | Size: 24 KiB |
|
Before Width: | Height: | Size: 9.2 KiB After Width: | Height: | Size: 9.2 KiB |
|
Before Width: | Height: | Size: 722 KiB After Width: | Height: | Size: 722 KiB |
|
Before Width: | Height: | Size: 560 KiB After Width: | Height: | Size: 560 KiB |
|
Before Width: | Height: | Size: 22 KiB After Width: | Height: | Size: 22 KiB |
|
Before Width: | Height: | Size: 61 KiB After Width: | Height: | Size: 61 KiB |
|
Before Width: | Height: | Size: 76 KiB After Width: | Height: | Size: 76 KiB |
|
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 40 KiB |
|
Before Width: | Height: | Size: 43 KiB After Width: | Height: | Size: 43 KiB |
|
Before Width: | Height: | Size: 111 KiB After Width: | Height: | Size: 111 KiB |
|
Before Width: | Height: | Size: 114 KiB After Width: | Height: | Size: 114 KiB |
|
Before Width: | Height: | Size: 44 KiB After Width: | Height: | Size: 44 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
|
Before Width: | Height: | Size: 43 KiB After Width: | Height: | Size: 43 KiB |
@@ -1,9 +1,9 @@
|
||||
# ESP32-S3-BOX Disassembly Tutorial
|
||||
|
||||
The case of the ESP32-S3-BOX has two different batches. Please match the corresponding disassembly tutorial according to the appearance of your product.
|
||||
The case of the BOX series products have three different versions. Please match the corresponding disassembly tutorial according to the appearance of your product.
|
||||
|
||||
| Version | Tutorial |
|
||||
| :-----: | :---------------------: |
|
||||
| <img src="_static/disassembly_pictures/figure_10.png" width="350px"/> | [Disassembly Tutorial V1](disassembly_tutorial_v1.md) |
|
||||
| <img src="_static/disassembly_pictures_v2/figure_10.png" width="350px"/> | [Disassembly Tutorial V2](disassembly_tutorial_v2.md) |
|
||||
| | |
|
||||
| Version | Tutorial |Note|
|
||||
| :-----: | :---------------------: |:---------------------: |
|
||||
| ESP32-S3-BOX V1 <img src="_static/disassembly_pictures/figure_10.png" width="350px"/> | [Disassembly Tutorial for ESP32-S3-BOX V1](hardware_overview/esp32_s3_box/disassembly_tutorial_v1.md) | Not available |
|
||||
| ESP32-S3-BOX V2 <img src="_static/disassembly_pictures_v2/figure_10.png" width="350px"/> | [Disassembly Tutorial for ESP32-S3-BOX V2](hardware_overview/esp32_s3_box/disassembly_tutorial_v2.md) |On sale now|
|
||||
| ESP32-S3-BOX-Lite <img src="_static/lite_back.png" width="350px"/> | Please refer to ESP32-S3-BOX V2 as they are similar in structure.|On sale now|
|
||||
@@ -1,204 +1,207 @@
|
||||
* [中文版本](./getting_started_cn.md)
|
||||
|
||||
The guide is suitable for the development boards that flashed the latest firmware, now it supports ESP32-S3-BOX Kit and ESP32-S3-BOX-Lite Kit, hereafter this text will be collectively referred to as BOX series products.
|
||||
|
||||
# Getting Started
|
||||
|
||||
The ESP32-S3-BOX provides a platform for developing the control of home appliances using Voice Assistance + touch screen controller, sensor, infrared controller, and intelligent Wi-Fi gateway. The ESP32-S3-BOX comes with pre-built firmware that allows you to experience voice wake-up and offline speech commands recognition in Chinese and English languages, with the SDKs and examples provided by Espressif, you will be able to develop a wide variety of AIoT applications based on the ESP32-S3-BOX such as online and offline voice assistants, voice-enabled devices, HMI touch-screen devices, control panels, multi-protocol gateways easily.
|
||||
The BOX series development boards based on ESP32-S3 SoC provides a platform for developing the control of home appliances using Voice Assistance + display with buttons controller, sensor, infrared controller, and intelligent Wi-Fi gateway. The BOX series development boards comes with pre-built firmware that allows you to experience voice wake-up and offline speech commands recognition in Chinese and English languages.
|
||||
The ESP-BOX SDK includes a reconfigurable AI voice interaction that allows you to customize commands to control your smart home appliances. The content of this material is to give you a brief concept of how the latest firmware works, a basic idea for you to know where to begin. Once you go through the guide below, you may start developing the application yourself. So, let’s begin the journey!
|
||||
|
||||
The ESP32-S3-BOX SDK also includes a reconfigurable AI voice interaction that allows you to customize commands to control your smart home appliances. The content of this material is to give you a brief concept of how the ESP32-S3-BOX works, a basic idea for you to know where to begin. Once you go through the guide below, you may start developing the application yourself. So, let’s begin the journey!
|
||||
|
||||
**The BOX Kit contains:**
|
||||
|
||||
| ESP32-S3-BOX | ESP32-S3-BOX-Lite |
|
||||
| :-----: | :---------------------: |
|
||||
| A main unit that can work on its own | A main unit that can work on its own|
|
||||
| An RGB LED module and Dupont wires for testing | An RGB LED module and Dupont wires for testing|
|
||||
| Dock, an accessory that serves as a stand for the device. | N/A|
|
||||
|
||||
|
||||
|
||||
**Required Hardware:**
|
||||
|
||||
What do you need: An USB-C Cable (not included in the kit).
|
||||
|
||||
## Connect the RGB LED Module to your Device
|
||||
|
||||
Refer to the pin definition below, insert the RGB LED Module to the BOX. The RGB LED Module has four male pins: R, G, B, GND, which should connect to the G39, G40, G41, GND female port of the PMOD 1.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/esp_s3_box_outline.png">
|
||||
<img src="./_static/_get_started_static/hardware_pmod.png">
|
||||
</div>
|
||||
|
||||
**What is in the ESP32-S3-BOX Kit:**
|
||||
## Power on your Device
|
||||
1. Power on your device via an USB-C cable.
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/usb_power.png" width="800px">
|
||||
</div>
|
||||
|
||||
1. ESP32-S3-BOX main unit
|
||||
2. Dock (Stand for ESP32-S3-BOX)
|
||||
3. RGB LED Module & Dupont wires for testing
|
||||
2. Once power on, the interactive Espressif logo will display on the screen.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/boot_animation.png" width="800px">
|
||||
</div>
|
||||
|
||||
## Let's Play Around!
|
||||
|
||||
**What do you need:**
|
||||
1. Initially, the two Guide Pages introduces the functions of buttons of your BOX series development boards. Press Next to enter next page after reading them.
|
||||
|
||||
1. Type-C Cable (not included in the BOX Kit)
|
||||
|
||||
|
||||
## Connect the RGB LED Module to the BOX
|
||||
|
||||
1. Refer to the pin definition below, insert the RGB LED Module to the BOX.
|
||||
2. The RGB LED Module has four male pins: R, G, B, GND connect to the G39, G40, G41, GND female port of the PMOD 1.
|
||||
3. Only one unit of RGB Module is provided in the kit.
|
||||
| ESP32-S3-BOX | ESP32-S3-BOX-Lite|
|
||||
| :-----: | :---------------------: |
|
||||
| <img src="./_static/_get_started_static/0.png" width="300px"/> | <img src="./_static/_get_started_static/1.png" width="300px"/> |
|
||||
| <img src="./_static/_get_started_static/2.png" width="280px"/> | <img src="./_static/_get_started_static/2.png" width="280px"/> |
|
||||
|
||||
2. Next, the Steps for Voice Assistant window gives you a hint of how to use the AI voice control. Press “OK Let’s Go” to enter the Menu screen.
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/3_EN.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/3.1_EN.png">
|
||||
</div>
|
||||
|
||||
3. The Menu screen has five functions, they are Device Control, Media Player, Network, Help and About Us. You can navigate to different sections by switching the pages. For example, enter the Device Control user interface, tap the Light icon to turn on or turn off the LED light. Moreover, go back to the Menu page and go forward to the Media Player section, you can operate buttons to control the music playback or adjust the volume.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/hardware_pmod.png">
|
||||
<img src="./_static/_get_started_static/4.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/4.1.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/5.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/5.1.png">
|
||||
</div>
|
||||
|
||||
## Power on the ESP32-S3-BOX
|
||||
## Offline Voice Assistant with your Device
|
||||
|
||||
1. Use a Type-C cable (not included in the ESP32-S3-BOX kit) to power on the ESP32-S3-BOX.
|
||||
1. In any interface, you can say the Chinese wake word “Hi Le Xin”, or English wake word “Hi E. S. P.” (Pronounce in alphabet) to activate your BOX series development boards. If the board wakes up, its screen will display the wake word you just speak. If the wake word is not displayed, try the wake word more times. The animation interface below gives you a hint that your device is listening.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/plug_power.png">
|
||||
<img src="./_static/_get_started_static/17.png">
|
||||
</div>
|
||||
|
||||
2. Once power on, the interactive Espressif logo will display on the screen.
|
||||
2. Utter a command phrase within 6 seconds after the beep, for example “turn on the light”. The command phrase will display on the screen and the RGB light of the LED Module will turn on. Around 1 second the voice user interface exits.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/boot_animation.png">
|
||||
<img src="./_static/_get_started_static/21.png">
|
||||
</div>
|
||||
|
||||
## Let’s play around with the ESP32-S3-BOX!
|
||||
|
||||
1. Initially, the “Steps for usage” pop-up window gives you a hint of how to use the AI Voice Assistance.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_use_intr.png">
|
||||
</div>
|
||||
|
||||
2. Follow the “Steps for usage” or press the “OK Let’s Go” to skip this and return to the Home Screen.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_home.png">
|
||||
</div>
|
||||
|
||||
3. Now, say the wake word **“Hi E. S. P.” (pronounce in alphabet)** to activate your ESP32-S3-BOX. If the board wakes up, its screen below will display the wake word you just spoke. If the wake word is not displayed, try the wake word more times. The animation below gives you a hint that your device is listening.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_hi.png">
|
||||
</div>
|
||||
|
||||
4. Please voice out one command phrase within 6 seconds each time and say your command such as “**Turn on the light**”, the command phrase will display on the screen, and the RGB light of the LED Module will be turned on. Around 1s, the voice user interface jumps back to the Home Screen.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_turn_on_the_light.png">
|
||||
</div>
|
||||
|
||||
5. The default command words are: "**Turn on the light**", "**Turn off the light**", "**Turn Red**", "**Turn Green**", "**Turn Blue**", "**Turn White**".
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_timeout.png">
|
||||
</div>
|
||||
|
||||
|
||||
3. You can use voice commands to enjoy music. Please wake up the device first, then say the command phrase "Sing a song". The music player opens and start playing built-in music. You can also use voice commands to switch to the next song or pause playing (There are two build-in songs).
|
||||
|
||||
>**Tips:**
|
||||
>* Check the connection of the RGB Module if the LED is not turned on. The pin of the RGB Module may be inserted into the wrong port of the BOX.
|
||||
>* If received no command within the specified time, the voice user interface will show “Timeout” and jump back to the Home Screen.
|
||||
|
||||
>* If the LED light fails to turn on, check whether the pins of the RGB Module are inserted into the right port of the BOX.
|
||||
>* If the BOX receives no command within the specified time, the voice user interface will show “Timeout” and jumps back to last page in about 1 second.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/19.png">
|
||||
</div>
|
||||
|
||||
6. Press the Mute button on the top of the ESP32-S3-BOX to disable the voice wake-up and speech recognition function. Press again to restore the function.
|
||||
4. The default command words are:
|
||||
|
||||
"**Turn on the light**", "**Switch off the light**", "**Turn Red**", "**Turn Green**", "**Turn Blue**", "**Sing a song**", "**Next Song**", "**Pause Playing**".
|
||||
|
||||
## Voice Command Customization
|
||||
|
||||
The BOX series development boards are equipped with the Espressif’s proprietary AI Speech Recognition system which allows you to customize command phrases through our ESP-BOX APP. We will take the LED module as an example to show how to customize the voice commands.
|
||||
(For the details of how the algorithm works, please refer to the technical architecture on the Developer Guide for an inside peek.)
|
||||
|
||||
**1. Connect to the ESP-BOX mobile APP**
|
||||
|
||||
1.1. First, please navigate to the Network section, press confirm button, and enter device provisioning interface. You will see a QR Code as below. Before network provisioning, ESP-BOX APP need to be installed. Tap on the “To install APP” icon that appears at the upper right corner and navigate to APP download interface.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/hardware_mute_button.jpg">
|
||||
<img src="_static/_get_started_static/6.png" >
|
||||
</div>
|
||||
|
||||
7. You can press the “Red Circle” on the device and return to the Home Screen.
|
||||
|
||||
1.2. Scan the QR Code below to visit the APP download page, follow the instructions to install the ESP-BOX APP. You can also search the “ESP-BOX” either in Apple Store or Google Play to install the APP.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/hardware_home.png">
|
||||
<img src="_static/_get_started_static/8.png">
|
||||
</div>
|
||||
|
||||
## Voice Assistance Control and Customization
|
||||
|
||||
The ESP32-S3-BOX is equipped with the Espressif proprietary AI Voice Recognition system, you can customize the command phrases used to give the instructions. (For the details of how the algorithm works, please refer to our Developer Guide on GitHub for an inside peek.)
|
||||
|
||||
**Let’s begin to learn about the Voice Command Customization:**
|
||||
|
||||
**1. First, connect to the ESP32-S3-BOX Wi-Fi simply using your phone**
|
||||
|
||||
1.1. Click on the “Wi-Fi” logo from the Home Screen that appears at the upper left corner.
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/Picture1.png">
|
||||
</div>
|
||||
1.3. If you first download the APP, please click "User", "Register" to register a new account.
|
||||
|
||||
1.4. Sign in with your ESP-BOX account and turn on the Bluetooth of your phone. Then tap + on the bottom of the interface, find the code scanning icon and scan the network provisioning QR code on your device.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_wifi_lable.png">
|
||||
<img src="_static/_get_started_static/1.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/2.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/3.jpeg"width="300" />
|
||||
</div>
|
||||
1.5 Please follow the instructions to add your device. After adding the device, you will see the following interfaces:
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/4.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/5.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/7.png">
|
||||
</div>
|
||||
|
||||
>**Tips:**
|
||||
|
||||
1.2. You will see a QR Code (as below) once you press the Wi-Fi logo.
|
||||
>* Make sure the device is connected to 2.4GHz Wi-Fi channel not 5GHz, if the Wi-Fi password is incorrect, it will lead to Wi-Fi Authentication failed as the figure below shows.
|
||||
>* Please stay on the device provisioning page during network provision.
|
||||
>* Long press the Boot button for 5 seconds to clean the network information and restore to factory settings.
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/7.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
**2. Customize Voice Command**
|
||||
|
||||
2.1. Tap the ESP-BOX device and enter to the below interface. You can simply turn on or turn off the light by toggling the button on the user interface, as the figure below shows. (We left the Fan and Switch parts for you to configure and develop by yourself.)
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_scan_qrcode.png">
|
||||
<img src="_static/_get_started_static/8.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
1.3. Simply turn on the QR code scanner APP on your phone or your phone’s Camera to do network provisioning. For iPhone users, you have to turn on your Camera.
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/9.jpeg"width="300" />
|
||||
</div>
|
||||
2.2 Press on Light and navigate to the Configure page to check the current default pin information and command phrases. The pin number for RED, GREEN and BLUE can be modified as needed.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/phone_scan_qrcode.png">
|
||||
<img src="_static/_get_started_static/10 EN.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
If code scanning fails, please turn on the WLAN manually, find the "ESP-Box" wireless network, and enter the password "password".
|
||||
|
||||
**2. Visit Web Control Interface “192.168.4.1”**
|
||||
|
||||
Scan another QR code again, and it will redirect you to the web control interface. Alternatively, you can turn on the mobile phone browser, enter the IP address “192.168.4.1”.
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/11.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2.3 The Control page allows you to adjust the color and brightness of the light, as well as the saturation of the color.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/12.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2.4 The Configure page allows you to define the preferred command phrase to control the on/off status and color of the light. For example, you can customize “Good morning” for action ON (as marked with “1” in the figure below). Click Save to return to the previous interface (as marked with “2” in the figure below). Then click Save again (as marked with “3” in the figure below).
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_scan_qrcode2.png">
|
||||
<img src="_static/_get_started_static/13 EN.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/13.1 EN.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2.5 Now, you can try out your new command! First, say “Hi E. S. P.” to wake up your device. Then say “Good morning” to turn on your light within 6 seconds. The new command phrase will display on the screen and the LED module will turn on.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/phone_scan_qrcode2.png">
|
||||
<img src="_static/_get_started_static/15.png">
|
||||
</div>
|
||||
|
||||
>**How to Add Appropriate Command Phrases: Now AI model supports users to define command phrases. In order to obtain the best recognition experience, you need to pay attention to the following matters when defining command phrase:**
|
||||
|
||||
> Tips For Android phones: We recommend you to turn off the mobile network and use the IP address via Chrome, Safari, or Firefox browsers to visit the webpage if scanning the QR code fails to load the webpage
|
||||
>* Length of command word: The number of words in the command phrase must be greater than or equal to 2 and less than or equal to 8. When defining a series of command phrases, it is best to keep the length of different command phrases similar.
|
||||
>* Avoid prefixes: Multiple command phrase should not be prefixed with each other. Short words will be not recognized, such as “Turn on” and “Turn on the light", “Turn on" will be not recognized.
|
||||
|
||||
**3. Voice Command Customization**
|
||||
|
||||
1. You can simply turn on & turn off the light from this user interface；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light.JPG">
|
||||
</div>
|
||||
|
||||
2. Press on the “light” icon and navigate to the Voice Command Device Control page to check the current default pin information and command word；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_cmd.JPG">
|
||||
</div>
|
||||
|
||||
3. The "Control” allows you to make the necessary changes to the light, including color, brightness and saturation。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_ctrl.JPG">
|
||||
</div>
|
||||
|
||||
4. The Voice page allows you to define the preferred command phrase to control the on/off status and color of the light. For example, you can customize “Good morning” for action ON (as marked with “1” in the figure below). Click Save to return to the previous interface (as marked with “2” in the figure below). Then click Save again (as marked with “3” in the figure below).
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_cmd_cg.JPG">
|
||||
</div>
|
||||
|
||||
5. Now, you can try out your new command! First, say **“Hi E. S. P.”** to wake-up your device. Then say **“Good morning”** to turn on your light within 6 seconds. The new command phrase will display on the screen and the LED module will be turned on as below.。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_good_morning.png">
|
||||
</div>
|
||||
|
||||
>**How to add appropriate command phrases:**
|
||||
Now AI model supports users to customize command phrases. In order to obtain the best recognition experience, you need to pay attention to the following matters when defining command phrase:
|
||||
>* Length of command word
|
||||
The number of words in the command phrase must be greater than or equal to 2 and less than or equal to 8.
|
||||
When defining a series of command phrases, it is best to keep the length of different command phrases similar.
|
||||
>* Avoid prefixes
|
||||
Multiple command phrase should not be prefixed with each other. Short words will be not recognized, such as “Turn on” and “Turn on the light", “Turn on" will be not recognized.
|
||||
|
||||
## ESP32-S3-BOX Graphical User Interface
|
||||
|
||||
1. Tap on the “function” logo from the Home Screen that appears at the upper right corner and navigate to the User Interface.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_panel_lable.png">
|
||||
</div>
|
||||
|
||||
2. Tap on the “Light” icon will allow you to turn on and turn off the light.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_panel_control.png">
|
||||
</div>
|
||||
|
||||
3. Long press the “Light” icon to navigate to the Light Tuning Interface, which allows changing the color display. Long press the Light Tuning Circle again to adjust the light saturation and brightness, respectively.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_panel_color.png">
|
||||
</div>
|
||||
|
||||
4. The built-in function above is pre-programmed to give you a brief idea of how this ESP32-S3-BOX can be used in your project.
|
||||
|
||||
5. The other three icons (Media, Fan, Security) are added for illustration purposes, and you may start writing your exciting application program! Begin your IoT Journey!
|
||||
|
||||
## ESP-BOX BBS
|
||||
|
||||
Visit the BBS [esp32.com](https://esp32.com/viewforum.php?f=44) to question us or contact us at sales@espressif.com, and we will reply to you as soon as possible.
|
||||
The built-in function above gives you a brief idea of how to use the latest firmware on your BOX series products. The other three icons (Switch, Fan, Air) are added for illustration purposes, and you may start writing your exciting application program! Begin your IoT journey!
|
||||
|
||||
@@ -1,199 +1,196 @@
|
||||
* [English Version](./getting_started.md)
|
||||
|
||||
本用户指南适用于烧录了最新固件的 ESP32-S3-BOX、ESP32-S3-BOX-Lite 产品，下文将他们统称为 BOX 系列开发板。
|
||||
|
||||
# 开始使用
|
||||
|
||||
ESP32-S3-BOX 提供了一个使用语音助手+触摸屏控制、传感器、红外控制器和智能 Wi-Fi 网关的概念来开发智能控制产品的平台。ESP32-S3-BOX 出厂支持语音唤醒和离线中英文命令词识别，通过乐鑫丰富的 SDK 和解决方案，能够轻松构建在线和离线语音助手、智能语音设备、HMI 触摸屏设备、控制面板、多协议网关等多样的应用。
|
||||
基于 ESP32-S3 的 BOX 系列开发板为用户提供了一个基于语音助手 + 屏幕控制、传感器、红外控制器和智能 Wi-Fi 网关等功能，开发和控制智能家居设备的平台。BOX 系列开发板出厂支持语音唤醒和离线中英文命令词识别。 其 SDK 包含可重构的 AI 语音交互功能，支持用户通过自定义命令词控制智能设备。本文的内容仅为您简要介绍最新固件能实现的参考功能，让您了解如何开始使用开发板。一旦您完成阅读下面的指南，您可以尝试自己开发应用。让我们开始旅程吧！
|
||||
|
||||
ESP32-S3-BOX 的 SDK 拥有可配置的 AI 语音交互功能，它允许您更改命令词以控制智能产品。本文的内容仅为您简要介绍 ESP32-S3-BOX 能实现的参考功能，让您了解如何开始使用开发板。一旦您完成阅读下面的指南，您可以尝试自己开发应用。让我们开始旅程吧！
|
||||
|
||||
**BOX 套件包含：**
|
||||
|
||||
| ESP32-S3-BOX | ESP32-S3-BOX-Lite |
|
||||
| :-----: | :---------------------: |
|
||||
| 主机，可独立使用 | 主机，可独立使用 |
|
||||
| 供测试的 RGB LED 模块和杜邦线 | 供测试的 RGB LED 模块和杜邦线 |
|
||||
| Dock 配件, 辅助主机站在桌上 | N/A|
|
||||
|
||||
|
||||
**所需硬件:**
|
||||
|
||||
您需要准备一根 USB-C 数据线 （不包含在套件内）。
|
||||
|
||||
## 插入 RGB LED 模块
|
||||
参考下面的引脚定义，将 RGB LED 模块插入 BOX 设备。RGB LED 模块有四根公头针脚：R、G、B、GND，将它们插入 PMOD 1 对应的 G39、G40、G41、GND 母头端口。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/hardware_pmod.png">
|
||||
</div>
|
||||
|
||||
## 给设备供电
|
||||
1. 使用一根 USB-C 数据线（不包含在套件中）给 BOX 设备供电。
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/usb_power.png" width="800px">
|
||||
</div>
|
||||
|
||||
2. 设备启动后，屏幕上将显示 Espressif logo 的开机动画。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/boot_animation.png" width="800px">
|
||||
</div>
|
||||
|
||||
## 开始体验
|
||||
|
||||
1. 首先您会看几页“按键引导页”，介绍 BOX 系列开发板的按键功能，完成阅读后点击 “Next” 并进入下一页。
|
||||
|
||||
| ESP32-S3-BOX 按键引导页| ESP32-S3-BOX-Lite 按键引导页|
|
||||
| :-----: | :---------------------: |
|
||||
| <img src="./_static/_get_started_static/0.png" width="300px"/> | <img src="./_static/_get_started_static/1.png" width="300px"/> |
|
||||
| <img src="./_static/_get_started_static/2.png" width="280px"/> | <img src="./_static/_get_started_static/2.png" width="280px"/> |
|
||||
|
||||
2. 接下来是“语音助手使用说明”引导页 ，请仔细阅读，它会提示您如何使用 AI 语音功能。完成阅读后点击 “OK Let's Go” 进入菜单页。
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/3_CN.png" >
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/3.1_CN.png">
|
||||
</div>
|
||||
3. 菜单页有五大功能，分别是“设备控制”、“音乐播放器”、“网络”、“帮助”以及“关于”，左右切换可进入不同的功能。比如，进入“设备控制”用户界面，选中 “Light” 图标，点按确认可打开或关闭 LED 灯。然后回到菜单页，找到“音乐播放器”界面并进入，进行歌曲的播放或调节音量。
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/4.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/4.1.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/5.png">
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/5.1.png">
|
||||
</div>
|
||||
|
||||
## 体验离线语音识别
|
||||
1. 在任意界面，您可以使用唤醒词去唤醒设备，中文唤醒词是“Hi 乐鑫”，英文唤醒词是 “Hi E. S. P.”（用字母发音）。设备唤醒成功后，唤醒词将显示在如下屏幕上并伴有提示音，如果唤醒词未出现，请再次尝试。如下展示的动画界面提示您的设备正在倾听。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/16.png">
|
||||
</div>
|
||||
|
||||
|
||||
2. 请在提示音响起后的 6 秒左右时间内对设备说命令词，比如“打开电灯”，同时命令词将显示在屏幕上并且 LED 模块打开。约 1 秒后语音控制界面退出。
|
||||
<div align="center">
|
||||
<img src="./_static/_get_started_static/20.png">
|
||||
</div>
|
||||
|
||||
3. 您也可以使用语音命令欣赏音乐，请先唤醒设备然后对设备说命令词“播放音乐”，设备会打开音乐播放器并开始播放内置音乐，您也可以用语音命令词切换下一首歌或者暂停播放。（最新固件默认自带两首歌）
|
||||
|
||||
>**注意：**
|
||||
>* 如果 LED 灯没有被打开，请检查 RGB 模块的 pin 脚是否插错。
|
||||
>* 若在规定时间内未识别到命令词，则显示超时，约 1 秒后界面关闭。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/19.png">
|
||||
</div>
|
||||
|
||||
4. 默认命令词为："**打开电灯**", "**关闭电灯**", "**调成红色**", "**调成绿色**", "**调成蓝色**", "**播放音乐**", "**切歌**", "**暂停播放**"；
|
||||
|
||||
## 语音命令词自定义
|
||||
BOX 系列开发板配备乐鑫专有的 AI 语音识别系统，您可以通过 “ESP-BOX” APP 自定义用于指令的任意命令词，我们将以 LED 灯作为示例介绍如何自定义语音命令词。（有关算法工作原理的详细信息，请参阅开发指引里的技术架构说明。）
|
||||
|
||||
**1. 连接 ESP-BOX 手机 APP**
|
||||
|
||||
1.1. 首先找到“网络”部分，点击确认后进入如下设备配网界面，在此之前，您需要安装 ESP-BOX APP。点击右上角 “To install APP” 部分下载并安装 ESP-BOX APP。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/esp_s3_box_outline.png">
|
||||
<img src="_static/_get_started_static/6.png">
|
||||
</div>
|
||||
|
||||
**ESP32-S3-BOX 套件包含:**
|
||||
|
||||
1. 主机，可独立使用；
|
||||
2. Dock 配件, 辅助主机站在桌面；
|
||||
3. 供测试的 LED 模块和杜邦线。
|
||||
|
||||
**你可能还需要：**
|
||||
|
||||
1. Type-C 数据线 (不包含在 ESP32-S3-BOX Kit 内)
|
||||
|
||||
## 将 LED 模块插入 ESP32-S3-BOX
|
||||
|
||||
1. 参考下面的引脚定义，将 RGB LED 模块插入 ESP32-S3-BOX；
|
||||
2. RGB LED 模块有四根公头针脚：分别将 R、G、B、GND 插入 PMOD 1 的 G39、G40、G41、GND 母头端口；
|
||||
3. 套件中仅提供一个 RGB 模块。
|
||||
1.2. 扫描如下二维码下载并安装 ESP-BOX APP，您也可以直接在 Apple Store 和 Google Play 搜索“ESP-BOX”下载 APP。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/hardware_pmod.png">
|
||||
<img src="_static/_get_started_static/8.png">
|
||||
</div>
|
||||
|
||||
## 给 ESP32-S3-BOX 供电
|
||||
|
||||
1. 使用一根 Type-C 数据线（不包含在 ESP32-S3-BOX 套件中）给 ESP32-S3-BOX 供电；
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/Picture1.png">
|
||||
</div>
|
||||
1.3. 如您第一次下载使用，请点击 “User”，“Register”，注册一个新账户。
|
||||
|
||||
1.4. 登录您的 ESP-BOX 账号并打开手机蓝牙。然后找到界面下方的“+” ，点击扫码图标扫描设备上的配网二维码。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/plug_power.png">
|
||||
<img src="_static/_get_started_static/1.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/2.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/3.jpeg"width="300" />
|
||||
</div>
|
||||
1.5 请按 APP 内指引添加您的设备，设备添加完成后，您将看到如下界面:
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/4.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/5.jpeg"width="300" />
|
||||
</div>
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/7.png">
|
||||
</div>
|
||||
|
||||
>**注意：**
|
||||
|
||||
2. 设备启动后，屏幕上将显示 Espressif logo 的开机动画；
|
||||
>* 确保设备连接的网络是 2.4GHz Wi-Fi 而不是 5GHz，并且输入正确的 Wi-Fi 密码，如果 Wi-Fi 密码错误，会显示 “Wi-Fi Authentication failed”。
|
||||
>* 在配网过程中不要退出设备配网界面。
|
||||
>* 长按 Boot 按键 5 秒可清除配网信息恢复出厂设置。
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/7.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
**2. 自定义语音命令词：**
|
||||
|
||||
2.1. 点击你的 ESP-BOX 设备，进入如下页面，您可以简单地在这个用户界面开灯或者关灯。（我们预留了“开关”和“风扇”功能给您自行去配置和开发。）
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/boot_animation.png">
|
||||
<img src="_static/_get_started_static/8.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
## 开始体验 ESP32-S3-BOX
|
||||
|
||||
1. 首先您会看到 “使用说明” 弹窗，请仔细阅读，它会提示您如何使用 AI 语音功能；
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/9.jpeg"width="300" />
|
||||
</div>
|
||||
2.2. 点按 “Light”，进入 “Configure” 页面查看当前默认的 pin 脚信息和命令词。您也可以根据需要修改 LED 模块的 “RED”、“GREEN” 和 “BLUE” pin 脚。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_use_intr_cn.png">
|
||||
<img src="_static/_get_started_static/10 CN.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2. 点击 “确认” 完成“使用说明” 的阅读并回到主页；
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/11.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2.3. “Control” 页面允许您对灯光进行颜色、亮度和饱和度的更改。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/_get_started_static/12.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
2.4. “Configure” 页面允许您针对设备的“开”、“关”、“颜色”定义您喜欢的命令词来控制设备。比如，您可以自定义“开”的命令词为“早上好”（如下图标注“1”步骤），点击保存，界面返回上一级（如下图标注“2”步骤），然后再点击保存（如下图标注“3”步骤）。
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_home.png">
|
||||
<img src="_static/_get_started_static/13 CN.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
3. 现在，请使用唤醒词 “Hi 乐鑫” 去唤醒设备。设备唤醒成功后，唤醒词将显示在如下屏幕上并伴有提示音，如果唤醒词未出现，请再次尝试。如下展示的动画提示您的设备正在聆听；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_hi_cn.png">
|
||||
<img src="_static/_get_started_static/13.1 CN.jpeg"width="300" />
|
||||
</div>
|
||||
|
||||
4. 请在提示音响起后的 6 秒左右时间内对设备说命令词，比如 “**打开电灯**”，同时命令词将显示在屏幕上并且 LED 模块打开。约 1s 后语音控制界面退出；
|
||||
|
||||
|
||||
2.5. 现在，您可以体验您的新命令词了！请先使用 “Hi 乐鑫” 去唤醒设备，然后在六秒内说出打开电灯的新命令词“早上好”，新命令词会显示在屏幕上并且 LED 模块打开。
|
||||
<div align="center">
|
||||
<img src="_static/page_turn_on_the_light_cn.png">
|
||||
<img src="_static/_get_started_static/14.png"width="300" />
|
||||
</div>
|
||||
|
||||
>**如何添加合适的命令词：AI 模型支持自定义命令词，为了获得最优的识别体验，命令词定义时需要注意以下事项：**
|
||||
|
||||
5. 默认命令词为："**打开电灯**", "**关闭电灯**", "**调成红色**", "**调成绿色**", "**调成蓝色**", "**调成白色**"；
|
||||
>* 命令词的长度：命令词中单词数需要大于等于 2 个，小于等于 8 个。在定义一系列命令词时，最好可以保持不同命令词的长度相似。
|
||||
>* 避免前缀：多个命令词，相互之间不要是对方的前缀，短的词会被屏蔽，比如 “打开”和“打开灯”，“打开”会被屏蔽。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_timeout_cn.png">
|
||||
</div>
|
||||
|
||||
>注意:
|
||||
> 如果 LED 灯没有被打开，请检察 RGB 模块的 pin 脚是否插错；
|
||||
> 若在规定时间内未识别到命令词，则显示超时，约 1s 后界面关闭。
|
||||
以上指南目的是让您简要了解如何在 BOX 系列开发板上使用最新的固件，其他三个功能图标 (Switch/Fan/Air) 仅用于展示，暂未开发。您可以开始尝试编写令人兴奋的应用程序，开启您的物联网之旅！
|
||||
|
||||
6. 按下 ESP32-S3-BOX 顶部的静音按钮，按下后设备语音唤醒和识别功能被禁用，再次按下恢复语音功能。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/hardware_mute_button.jpg">
|
||||
</div>
|
||||
|
||||
7. 您也可以轻触触摸屏下方的 “小红圈” 回到主页；
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/hardware_home.png">
|
||||
</div>
|
||||
|
||||
## 语音控制命令词自定义
|
||||
|
||||
ESP32-S3-BOX 最令人印象深刻的功能是乐鑫专有的 AI 语音识别系统。您可以自定义用于指令的任意命令词。有关 AI 算法工作原理的详细信息，请参阅我们 GitHub 上的开发指南。让我们开始了解语音命令词自定义：
|
||||
|
||||
**1. 首先，请将你的手机连接 ESP32-S3-BOX 的 Wi-Fi**
|
||||
|
||||
1.1. 点击主页左上角的 Wi-Fi 图标；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_wifi_lable.png">
|
||||
</div>
|
||||
|
||||
1.2. 您将看到如下二维码界面；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_scan_qrcode.png">
|
||||
</div>
|
||||
|
||||
1.3. 打开你手机上的二维码扫描软件或者相机扫码配网，对于 iPhone 用户，您可以打开相机（如扫码失败，请手动打无线网络，找到 “ ESP-Box” 无线网络，然后输入密码 “password”）；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/phone_scan_qrcode.png">
|
||||
</div>
|
||||
|
||||
**2. 访问 Web “192.168.4.1” 进入控制界面**
|
||||
|
||||
再次扫码进入 Web 控制界面，或者打开手机浏览器，输入IP地址 “192.168.4.1”。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_scan_qrcode2.png">
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/phone_scan_qrcode2.png">
|
||||
</div>
|
||||
|
||||
> 小提示：对于部分安卓手机，如果网页加载失败，建议您关闭手机的移动网络。建议您使用 Chrome, Safari, Firefox 浏览器访问网页。
|
||||
|
||||
**3. 自定义语音命令词**
|
||||
|
||||
1. 您可以简单地在这个用户界面进行开灯或者关灯；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light.JPG">
|
||||
</div>
|
||||
|
||||
2. 点按 “light” 图标并进入到语音命令控制页面查看当前默认的 Pin 脚信息和命令词；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_cmd_cn.JPG">
|
||||
</div>
|
||||
|
||||
3. “设备控制” 允许您对灯光进行颜色、亮度和饱和度的更改。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_ctrl_cn.JPG">
|
||||
</div>
|
||||
|
||||
4. “语音指令”页面允许您针对设备的 “开”、“关”、“颜色”定义您喜欢的命令词来控制设备。比如，您可以自定义“开”的命令词为“早上好”（如下图标注“1”步骤），点击保存，界面返回上一级（如下图标注“2”步骤），然后再点击保存（如下图标注“3”步骤）。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/web_config_light_cmd_cg_cn.JPG">
|
||||
</div>
|
||||
|
||||
5. 现在，您可以体验您的新命令词了！请先使用 **“Hi 乐鑫”** 去唤醒设备，然后在**6秒**内说出打开电灯的新命令词 **“早上好”**，新命令词会显示在屏幕上并且 LED 模块打开。
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_good_morning_cn.png">
|
||||
</div>
|
||||
|
||||
>**如何添加合适的命令词:**
|
||||
AI 模型支持自定义命令词，为了获得最优的识别体验，命令词定义时需要注意以下事项：
|
||||
>* 命令词的长度
|
||||
命令词中单词数需要大于等于 2 个，小于等于 8 个。
|
||||
在定义一系列命令词时，最好可以保持不同命令词的长度相似。
|
||||
>* 避免前缀
|
||||
多个命令词，相互之间不要是对方的前缀，短的词会被屏蔽，比如 “打开” 和 “打开灯”， “打开”会被屏蔽。
|
||||
|
||||
## ESP32-S3-BOX 图形界面
|
||||
|
||||
1. 点击主页右上角的功能图标进入用户界面；
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/page_panel_lable.png">
|
||||
</div>
|
||||
|
||||
2. 点按 “Light” 图标将允许您打开和关闭灯；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_panel_control.png">
|
||||
</div>
|
||||
|
||||
3. 长按 “Light” 图标将进入灯光调整界面，可以更改颜色显示。再次长按调光圆环，分别可调节灯光饱和度和亮度；
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/page_panel_color.png">
|
||||
</div>
|
||||
|
||||
4. 以上出厂功能是预编程的，目的是让您简要了解如何在您的项目中使用此 ESP32-S3-BOX；
|
||||
|
||||
5. 其他三个功能图标（Media、Fan、Security）仅用于展示，暂未开发。您可以尝试编写令人兴奋的应用程序，请开启您的物联网之旅；
|
||||
|
||||
## ESP-BOX 论坛
|
||||
|
||||
访问乐鑫 BBS 论坛 [esp32.com](https://esp32.com/viewforum.php?f=43) 给我们提问，或者通过 sales@espressif.com 邮箱联系我们，我们将尽快答复您。
|
||||
|
||||
@@ -1,25 +0,0 @@
|
||||
* [中文版本](./hardware_overview_cn.md)
|
||||
|
||||
## Hardware Overview
|
||||
|
||||
|
||||
|
||||
### Hardware Source Files
|
||||
|
||||
* [ESP32-S3-BOX Mainboard Schematic](../hardware/esp32_s3_box_v2.5/schematic)
|
||||
* [ESP32-S3-BOX Mainboard PCB](../hardware/esp32_s3_box_v2.5/pcb)
|
||||
* [ESP32-S3-BOX Mainboard Gerber](../hardware/esp32_s3_box_v2.5/gerber)
|
||||
* [ESP32-S3-BOX Subboard Schematic](../hardware/esp32_s3_box_sub_v2.2/schematic)
|
||||
* [ESP32-S3-BOX Subboard PCB](../hardware/esp32_s3_box_sub_v2.2/pcb)
|
||||
* [ESP32-S3-BOX Subboard Gerber](../hardware/esp32_s3_box_sub_v2.2/gerber)
|
||||
* [ESP32-S3-BOX Shell CAD STEP](../hardware/esp32_s3_box_shell_step)
|
||||
|
||||
### Specifications:
|
||||
|
||||
|
||||
|
||||
### Ports:
|
||||
|
||||
|
||||
|
||||
* [Digilent Pmod™ Interface Specification](https://digilent.com/reference/_media/reference/pmod/pmod-interface-specification-1_3_1.pdf)
|
||||
@@ -5,7 +5,7 @@
|
||||
The figure below depicts an exploded view of the ESP32-S3-BOX, which shows the relationship or order of assembly of various parts and how they fit together. The projection of the ESP32-S3-BOX main unit has seven layers, beginning from the top layer and arranging in descending order as shown in the picture below.
|
||||
|
||||
<div align="center">
|
||||
<img src="./_static/disassembly_pictures/exploded_view.png" width="650px"/>
|
||||
<img src="../../_static/disassembly_pictures/exploded_view.png" width="650px"/>
|
||||
</div>
|
||||
|
||||
> **Warning**: Disassembling the ESP32-S3–BOX may damage the hardware structure. Espressif will not be responsible for any damages resulting from the disassembling.
|
||||
@@ -24,7 +24,7 @@ The figure below depicts an exploded view of the ESP32-S3-BOX, which shows the r
|
||||
The following tutorial will guide you to disassemble the development board step-by-step. Once you have dissembled the development board, there will be 7 main components as shown below. Please keep them well.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_9.jpg" width="750px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_9.jpg" width="750px"/>
|
||||
</div>
|
||||
|
||||
### Step-by-step Guide
|
||||
@@ -33,29 +33,29 @@ The following tutorial will guide you to disassemble the development board step-
|
||||
- Next, use the "Flat-Head Screwdriver" or "Triangle Plastic Pry Opening Tool" to pry off the touch screen. Please be careful, as you may damage the FPC cable and the glass cover of the touch screen when removing the touch screen from the development board.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_1.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_1.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- While tearing off the touch screen, you will observe the touch panel is connected to the mainboard by two FPC cables, 8 pin and 20 pin, respectively. Unlock the two FPC connectors and take down the whole touch screen.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_2_1.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_2_1.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_2_2.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_2_2.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- Use the “Phillips-Head Screwdriver” to remove the three self-tapping screws.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_4.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_4.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- Use the "Flat-Head Screwdriver" or "Triangle Plastic Pry Opening Tool" to remove the middle frame from the edge.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_4_2.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_4_2.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
> **Note**: The middle frame is 3D printed, it might be tight while removing the middle frame from the case. Try to open the snap-fit from the edge.
|
||||
@@ -63,21 +63,21 @@ The following tutorial will guide you to disassemble the development board step-
|
||||
- You will see a microphone sub-board attached to the back of the middle frame. The mic sub-board is connected to the mainboard through a 6 pin FPC cable. Unscrew the two screws of the mic sub-board and unlock one side of the 6 pin FPC cable to remove the sub-board completely.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_5.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_5.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- Now, only the mainboard is embedded in the case. Unscrew the last three screws on the mainboard and take out the board. You will see the 6 pin FPC cable on the other side, unlock the connector and take off the FPC cable.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_6.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_6.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_7.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_7.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- The speaker is glued to the side of the bottom case, and its connector is soldered to the mainboard PCBA. You can remove it from PCBA using the soldering iron.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures/figure_8.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures/figure_8.jpg" width="500px"/>
|
||||
</div>
|
||||
@@ -1,11 +1,11 @@
|
||||
# ESP32-S3-BOX Disassembly Tutorial V2
|
||||
# ESP32-S3-BOX Disassembly Tutorial V2 (Also suitable for ESP32-S3-BOX-Lite)
|
||||
|
||||
## Exploded View
|
||||
|
||||
The figure below depicts an exploded view of the new batch of the ESP32-S3-BOX, which shows the relationship or order of assembly of various parts and how they fit together. The projection of the ESP32-S3-BOX main unit has eight layers, beginning from the top layer and arranging in descending order as shown in the picture below.
|
||||
The figure below depicts an exploded view of the new batch of the ESP32-S3-BOX, which shows the relationship or order of assembly of various parts and how they fit together. The projection of the ESP32-S3-BOX main unit has eight layers, beginning from the top layer and arranging in descending order as shown in the picture below. The guide is also suitable for the ESP32-S3-BOX-Lite product as they are similar in structure.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/exploded_view.png" width="650px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/exploded_view.png" width="650px"/>
|
||||
</div>
|
||||
|
||||
> **Warning**: Disassembling the ESP32-S3–BOX may damage the hardware structure. Espressif will not be responsible for any damages resulting from the disassembling.
|
||||
@@ -21,7 +21,7 @@ The figure below depicts an exploded view of the new batch of the ESP32-S3-BOX,
|
||||
The following tutorial will guide you to disassemble the development board step-by-step. Once you have dissembled the development board, there will be six main components as shown below. This tutorial doesn't cover how to disassemble the components of the sixth layer and eight layer. Please keep them well.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_8.jpg" width="750px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_8.jpg" width="750px"/>
|
||||
</div>
|
||||
|
||||
### Step-by-step Guide
|
||||
@@ -29,45 +29,45 @@ The following tutorial will guide you to disassemble the development board step-
|
||||
- Use the “Phillips-Head Screwdriver” to remove the two self-tapping screws from the bottom case.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_1.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_1.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- Gently push the bottom case to the right to separate the bottom case and the top case.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_2.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_2.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- You will observe the touch panel is connected to the main board by two FPC cables, 8 pin and 20 pin, respectively. Unlock the two FPC connectors to separate the main board and touch screen. The touch screen is glued to the top case, we don't recommend you to tear off the whole touch screen as you may damage the FPC cable and the glass cover of the touch screen.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_3.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_3.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- You will see a microphone sub-board attached to the bottom case. The mic sub-board is connected to the main board through a 6 pin FPC cable. Unscrew the two screws of the microphone sub-board and unlock one side of the 6 pin FPC cable to remove the sub-board completely. Behind the microphone sub-board are the dust cover of two microphones, we do not recommend that you take down them since they are glued to the top case.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_4.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_4.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_3.1.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_3.1.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- The speaker is glued on the side of the top case, you can slightly remove it. Its connector is soldered to the main board PCBA. You can remove it from PCBA using the soldering iron.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_5.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_5.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
- Now, only the main board is embedded in the buttom case. Unscrew the last three screws on the main board and take out the board. You will see the 6 pin FPC cable on the other side, unlock the connector and take off the FPC cable.
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_6.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_6.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="_static/disassembly_pictures_v2/figure_7.jpg" width="500px"/>
|
||||
<img src="../../_static/disassembly_pictures_v2/figure_7.jpg" width="500px"/>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -0,0 +1,25 @@
|
||||
* [中文版本](./hardware_overview_for_box_cn.md)
|
||||
|
||||
## Hardware Overview
|
||||
|
||||
|
||||
|
||||
### Hardware Source Files
|
||||
|
||||
* [ESP32-S3-BOX Mainboard Schematic](../../../hardware/esp32_s3_box_v2.5/schematic)
|
||||
* [ESP32-S3-BOX Mainboard PCB](../../../hardware/esp32_s3_box_v2.5/pcb)
|
||||
* [ESP32-S3-BOX Mainboard Gerber](../../../hardware/esp32_s3_box_v2.5/gerber)
|
||||
* [ESP32-S3-BOX Subboard Schematic](../../../hardware/esp32_s3_box_sub_v2.2/schematic)
|
||||
* [ESP32-S3-BOX Subboard PCB](../../../hardware/esp32_s3_box_sub_v2.2/pcb)
|
||||
* [ESP32-S3-BOX Subboard Gerber](../../../hardware/esp32_s3_box_sub_v2.2/gerber)
|
||||
* [ESP32-S3-BOX Shell CAD STEP](../../../hardware/esp32_s3_box_shell_step)
|
||||
|
||||
### Specifications:
|
||||
|
||||
|
||||
|
||||
### Ports:
|
||||
|
||||
|
||||
|
||||
* [Digilent Pmod™ Interface Specification](https://digilent.com/reference/_media/reference/pmod/pmod-interface-specification-1_3_1.pdf)
|
||||