esp-dev-kits Choose target... Choose version... ESP32-S31 Boards ESP32-S31-Function-CoreBoard-1 ESP32-S31-Korvo-1 ESP-Mosaico User Guide Resources and Legal Notices Related Documentation and Resources Disclaimer and Copyright Notice esp-dev-kits ESP-Mosaico Download PDF ESP-Mosaico [中文] ESP-Mosaico is an expandable smart interaction development kit based on ESP32-S31. It targets magnetic expansion, motion sensing, square touch display, and edge multimedia scenarios. The device integrates an ESP32-S31 SoC, a 480 × 480 QSPI square touch display, audio codec and amplifier, a 6-axis IMU, dual magnetometers, SPI NAND flash, and left/right 2 × 10P, 2.54 mm pitch module headers for camera and other expansions. The board support package (BSP) and application examples are available in the esp-mosaico repository. Note This document covers CoreBoard V1.0 hardware. Please check the silkscreen version on the mainboard to confirm your board revision. User Guide Getting Started Hardware Reference Hardware Revision Details Related Documents Disclaimer and Copyright Notice Next Previous Suggestion on this document? Provide feedback Help improve this document? Edit on GitHub Need more information? Check ESP forum Sales Questions Technical Inquiries © Copyright 2016 - 2026, Espressif Systems (Shanghai) CO., LTD Built with Sphinx using a theme based on Read the Docs Sphinx Theme. esp-dev-kits Choose target... Choose version... ESP32-S31 Boards ESP32-S31-Function-CoreBoard-1 ESP32-S31-Korvo-1 ESP-Mosaico Resources and Legal Notices Related Documentation and Resources Disclaimer and Copyright Notice Terms of Use for Development Board esp-dev-kits Disclaimer and Copyright Notice Download PDF Disclaimer and Copyright Notice [中文] Information in this document, including URL references, is subject to change without notice. All third party’s information in this document is provided as is with no warranties to its authenticity and accuracy. No warranty is provided to this document for its merchantability, non-infringement, fitness for any particular purpose, nor does any warranty otherwise arising out of any proposal, specification or sample. All liability, including liability for infringement of any proprietary rights, relating to use of information in this document is disclaimed. No licenses express or implied, by estoppel or otherwise, to any intellectual property rights are granted herein. The Wi-Fi Alliance Member logo is a trademark of the Wi-Fi Alliance. The Bluetooth logo is a registered trademark of Bluetooth SIG. All trade names, trademarks and registered trademarks mentioned in this document are property of their respective owners, and are hereby acknowledged. Terms of Use for Development Board The development board is intended for R&D evaluation, engineering design verification, and early-stage product development. It is provided as a convenient platform for development and testing. The development board is not intended as a mass-production component or as a finished product for end consumers; therefore, its product management approach differs from that of mass-produced chips and modules. The development board has not obtained specific national or industry certifications and is not covered under regulatory frameworks such as CE, UL, or CCC. As a result, it may not meet the requirements of such regulations. Users should ensure that their use of the development board complies with the applicable laws and regulations of the country or region in which it is used. In addition, the development board has not been designed, validated, or managed for reliability testing, production, or commercial deployment purposes. Users assume full responsibility for the correct and safe use of the product. For applications beyond the intended use of the development board, including but not limited to pre-production testing, system integration, final product delivery, or other commercial uses, the user should, before mass production and in light of its own product requirements, fully evaluate the technical suitability, reliability requirements, regulatory compliance, and system integration risks associated with such applications. The user should also complete all necessary verification, testing, and certification activities relating to system-level design, product certification, reliability validation, regulatory compliance assessment, and commercial deployment. Espressif assumes no liability arising from applications beyond the intended use of the development board. Regardless of whether the parties have entered into a supplier framework agreement, quality agreement, or any other similar agreement, the development board is not subject to any requirements or commitments therein relating to product certification, reliability management, return material analysis (RMA), product/process change notification (PCN), end-of-life (EOL) management, long-term supply commitments, or any other requirements and commitments established under a mass-production product management model. Previous Suggestion on this document? Provide feedback Help improve this document? Edit on GitHub Need more information? Check ESP forum Sales Questions Technical Inquiries © Copyright 2016 - 2026, Espressif Systems (Shanghai) CO., LTD Built with Sphinx using a theme based on Read the Docs Sphinx Theme. esp-dev-kits Choose target... Choose version... ESP32-S31 Boards ESP32-S31-Function-CoreBoard-1 ESP32-S31-Korvo-1 ESP-Mosaico User Guide Getting Started Description of Components Start Application Development Hardware Reference Block Diagram Power Supply Options Type-C Interface DCDC 3.3 V Circuit BOOST Circuit Power On/Off Circuit MCU and Pin Assignment I2C Device Addresses LCD Interface Vibration Motor Interface Module Interface Hardware Revision Details Related Documents Disclaimer and Copyright Notice Resources and Legal Notices Related Documentation and Resources Disclaimer and Copyright Notice esp-dev-kits ESP-Mosaico ESP-Mosaico V1.0 Download PDF ESP-Mosaico V1.0 [中文] Note This document covers CoreBoard V1.0 hardware. Please check the silkscreen version on the mainboard to confirm your board revision. This guide helps you get started with ESP-Mosaico and provides detailed information about the board. ESP-Mosaico is an expandable smart interaction development kit based on ESP32-S31. It targets magnetic expansion toys, motion sensing, square touch display HMI, and edge voice/multimedia applications. The device integrates a 480 × 480 QSPI square touch display, ES8311 audio codec, NS4150B amplifier, BMI270 6-axis IMU, dual BMM150 magnetometers, SPI NAND flash, and left/right 2 × 10P, 2.54 mm pitch module headers. The main controller is Espressif ESP32-S31, supporting 2.4 GHz Wi-Fi 6 (IEEE 802.11b/g/n/ax), Bluetooth® 5.4 (LE + BR/EDR), and IEEE 802.15.4 (Thread / Zigbee). For storage, the board provides 16 MB in-package PSRAM, onboard 16 MB SPI NOR flash, and onboard 1 Gbit SPI NAND flash for graphics, multimedia, and asset caching. The display uses a CO5300-driven 480 × 480 QSPI square touch display with a CST9220-series touch controller. For audio, ESP-Mosaico integrates ES8311 and NS4150B Class-D PA. The power system supports USB Type-C 5 V and a 3.7 V / 65 mAh Li-ion battery, with TP4057 charging, BQ27220 fuel gauge, and SAM8108 power-switch control. Both the Type-C port and the left/right module interfaces support power input and output. A USB 2.0 High-Speed OTG port supports power, debug, and communication, and the board also reserves UART expansion capability and left/right module interfaces. ESP-Mosaico Appearance (Click to enlarge) The document consists of the following major sections: Getting Started: Overview of the board and hardware/software setup instructions. Hardware Reference: More detailed information about the board hardware. Hardware Revision Details: Hardware revision history and known issues (if any). Related Documents: Links to related documentation. Disclaimer and Copyright Notice: Link to the disclaimer and copyright notice. Getting Started This section briefly introduces ESP-Mosaico and describes how to flash firmware and prepare the board. Description of Components ESP-Mosaico consists of a CoreBoard and a BaseBoard. The front views and their main components are shown first, followed by the back views and their main components. Front ESP-Mosaico Front (Click to enlarge) ESP-Mosaico CoreBoard Front (Click to enlarge) ESP-Mosaico BaseBoard Front (Click to enlarge) The following describes the main components on the front PCB in clockwise order. No. Key Component Description CoreBoard Core board integrating the SoC, RF antenna, power management, display connector, audio codec, and sensors. 1 ESP32-S31NRV16 ESP32-S31 SoC, RISC-V 32-bit dual-core up to 320 MHz with 16 MB in-package PSRAM; supports 2.4 GHz Wi-Fi 6, Bluetooth 5.4 (LE + BR/EDR), and IEEE 802.15.4. 2 KH-3216-A35 Ceramic Antenna 2.4 GHz chip ceramic antenna for Wi-Fi and Bluetooth RF. 3 Orange LED Programmable mono status LED on GPIO3, active-low. 4 TLV62569 Buck (DCDC) converter that converts the input supply to the system 3.3 V rail. 5 BMM150 3-axis magnetometer (BMM150 #2), I2C address 0x11. 6 SY7088 Boost (BOOST) converter for rails higher than the battery voltage. 7 Display Connector Connects the 480 × 480, 2.16-inch QSPI touch display (CO5300 driver + CST9220 touch). 8 TP4057 Li-ion battery charger for the onboard battery. 9 BQ27220 Fuel gauge at I2C address 0x55 for voltage, current, state of charge (SOC), and related status. 10 3V3 Power LED Lights when the 3.3 V rail is present after power-on; turns off when the device is powered off. 11 HUSB320 USB Type-C interface controller that handles CC detection and controls the USB power direction. 12 Charge LED Charge status indicator: red while charging, green when fully charged. 13 SAM8108 Power on/off controller used with the POWER button. 14 HE9073A33 LDO providing a dedicated supply to the audio codec to reduce noise. 15 NS4150B Low-EMI,