• 中文版本

For the dactory demo

Run cd examples/factory_demo

Run ./utils.sh setup and cross your fingers and toes.

To do anything involving the serial port you will need to set the PORT environment variable for all further invocations of utils.sh. Example:

Linux:

export PORT=/dev/ttyACM0

Mac:

export PORT=/dev/cu.usbserial-31320

Once you have done that, run ./utils.sh flash. It should build, flash, and connect you to the serial monitor.

Important Note:

We recommend updating the application firmware when you first receive the product to have the new features and bugfix. Click here to access the user guide of the latest release firmware. Click here to visit the older firmware.

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
ESP32-S3-BOX-Lite

• 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 200+ speech commands in Chinese and English languages
• Continuous Identification and Wakeup Interrupt
• Flexible and reusable GUI framework
• End-to-end AIoT dvelopment framwork ESP-RainMaker
• Pmod™ compatible headers support expand peripheral modules

• Schematic and PCB Source File
• Shell 3D Print Source File
• Firmware Source Code
• Examples Source Code

Based on Apache 2.0 open source license, you can modify, develop, or distribute the contents freely.

• For getting start of BOX serial development boards, please refer to the Getting Started.
• For experiencing voice assistant, please refer to the Voice Assistance Control and Customization.
• For experiencing a more humanized interactive experience, please refer to the Continuous Speech Recognition.
• For defining the speech commands by mobile APP, please refer to the ESP-BOX APP User Guide.
• For product exploded-view and disassembly tutorial, please refer to Disassembly Tutorial.
• For more details of hardware information, please refer to the Hardware Overview.
• For latest version firmware, please refer to the Firmware Update.

ESP-BOX integrates components commonly used in AIOT development that you can leverage to build your own applications.

• Step 1. ESP-IDF (Espressif IoT Development Framework) is required to build the application. If this is your first time using the ESP-IDF, please refer to ESP-IDF development guide to understand the open-source drivers and components provided by Espressif.
• Step 2. Next, setting up development environment. Please refer to ESP-IDF(release/v4.4 or release/v5.0) Installation Step by Step.
• Step 3. Run command git clone --recursive https://github.com/espressif/esp-box.git to download the code of this project and then switch the ESP-IDF version to specified version;
• Step 4. Take a small step, you can build and flash a simple example.
• Step 5. Moving further, please read ESP-BOX technical architecture to understand the technical details.
• Step 6. Going deeper, please read ESP Speech Recognition Application Guide, ESP RainMaker Programming Guide, LVGL GUI Quick overview.
• Step 7. For extended function, please read Pmod™ compatible headers and ESP-IDF API reference, to develop drivers for more extended devices.

• If you have any technical issues, please submit issue tickets at GitHub Issues or forum esp32.com for help.
• If you are interested in ESP-BOX project, welcome to the ESP-BOX forum to share with us your ideas.

We welcome any open-source software or hardware contribution. If you have any examples you want to share with us, please click the Contributions Guide and commit to the Pull Requests to contribute your code.