ESP-Mosaico

Source: https://docs.espressif.com/projects/esp-dev-kits/en/latest/esp32s31/esp-mosaico/user_guide.html#esp-mosaico-v1-0

[中文]

Older version: ESP-Mosaico V1.0

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.

Back

ESP-Mosaico Back (Click to enlarge)

ESP-Mosaico CoreBoard Back (Click to enlarge)

ESP-Mosaico BaseBoard Back (Click to enlarge)

The following describes the main components on the back PCB in clockwise order.

Start Application Development

Before powering up, make sure ESP-Mosaico is in good condition.

Required Hardware

• ESP-Mosaico
• USB cable (data-capable)
• Computer (Windows, Linux, or macOS)

Hardware Notes

1. Flashing Connect ESP-Mosaico to the computer with a USB cable through the onboard Type-C port. This port is USB 2.0 High-Speed and supports both power delivery and USB data communication. The native ESP32-S31 chip only supports firmware download through this port in download mode, and does not provide auto-download or log output by itself. The factory firmware integrates a CDC virtual serial port and supports auto-download and serial log output. If flashing fails, try holding the BOOT button while the device is powered off, then power it on to enter download mode. In addition, the left and right module interfaces provide USB Serial/JTAG (left) and a TX/RX UART (right), both of which can be used for debugging and firmware download.
2. Power The Type-C port can power the device. The onboard battery is charged at a rated current of 65 mA. When a USB sink device is attached, the Type-C port automatically switches to source mode, with a maximum output of 5 V / 500 mA. If the load exceeds 1 A, the port shuts off automatically and recovers after a period of time. The left and right module interfaces also provide outward 3.3 V and 5 V rails (3V / 5V). These rails are output only when GPIO60 is driven low. VIN is an input supply pin that can also charge the onboard battery.

Software Setup

Follow the ESP-IDF Get Started guide to set up the development environment. The target chip for this board is esp32s31.

BSP and Examples

Espressif provides a board support package (BSP) for ESP-Mosaico to simplify initialization of the LCD, touch, audio, sensors, battery, NAND flash, module resources, and USB console.

• For the shipped application, buttons, expansion I/O, and getting started, see the ESP-Mosaico User Guide.
• Flash the latest firmware in the browser at Firmware Update.
• Recommended application framework: ESP-Claw.
• After the first successful flash, use the BSP USB CDC console and auto-download support. Typical commands:

idf.py set-target esp32s31
idf.py -p /dev/ttyACM0 flash monitor

Contents and Packaging

Ordering Information

The development board is available in the variant listed in the table below.

For more information about available variants, visit the ESP Product Selector and select the Development Board tab. If you cannot find the variant you need in the table or Product Selector, or if you have special customization requirements, contact Espressif Sales.

Retail Orders

If you order a few samples, each board comes in an individual package in either antistatic bag or any packaging depending on your retailer.

For retail orders, please go to https://www.espressif.com/en/company/contact/buy-a-sample.

Wholesale Orders

If you order in bulk, the boards come in large cardboard boxes.

For wholesale orders, please go to https://www.espressif.com/en/contact-us/sales-questions.

Hardware Reference

Block Diagram

The main components and connections of ESP-Mosaico are shown below.

ESP-Mosaico Block Diagram (Click to enlarge)

Power Supply Options

You can power the board in the following ways:

1. Through the Type-C (USB-C) port Connect a USB Type-C cable to the Type-C port.
2. Through the back expansion pads Supply external power through the back expansion pads on the BaseBoard.
3. Through the battery The board supports a 3.7 V / 65 mAh Li-ion battery.

Regardless of the power source, use the POWER button to turn the device on or off. External power sources above can also charge the onboard battery.

Type-C Interface

Type-C Interface Schematic (Click to enlarge)

The Type-C port connects to ESP32-S31 USB 2.0 High-Speed OTG for power, debug, and application communication. Onboard USB Serial/JTAG signals are used for download and debugging. The BSP USB CDC console and auto-download feature are the recommended download and log path.

DCDC 3.3 V Circuit

DCDC 3.3 V Schematic (Click to enlarge)

TLV62569 steps VDD down to MCU_3V3, which is then switched to VCC_3V3 by the VCC_PW load switch.

Power-control GPIOs defined by the BSP:

BOOST Circuit

BOOST Schematic (Click to enlarge)

The onboard SY7088 boost converter is enabled by VCC_3V3 and outputs VOUT_BOOST for rails higher than the battery voltage.

Power On/Off Circuit

Power On/Off Schematic (Click to enlarge)

SAM8108 works with the POWER button for whole-device power control. The POWER_SWITCH signal can also be monitored or driven by software to request shutdown.

MCU and Pin Assignment

The following table lists the main pin assignments used by the ESP-Mosaico BSP, grouped by function.

ESP-Mosaico Main Pin Assignment

I2C Device Addresses

V1.2 splits onboard devices and expansion modules onto two I2C buses:

• I2C0 (internal): I2C0_SDA = GPIO56, I2C0_SCL = GPIO3, connecting touch, audio codec, IMU, magnetometers, and the fuel gauge.
• I2C1 (external): I2C1_SDA = GPIO0, I2C1_SCL = GPIO1, connecting module EEPROM and other external devices.

Internal I2C0 (7-bit addresses)

External I2C1 (7-bit addresses)

Module EEPROMs are on the attached modules, not on the mainboard, and appear only when a module with EEPROM is plugged into the corresponding slot.

LCD Interface

LCD Interface Schematic (Click to enlarge)

• LCD driver: CO5300, QSPI interface, 480 × 480 resolution.
• Touch controller: CST9220 series, I2C interface (TP_SCL / TP_SDA / TP_RST / TP_INT).

Vibration Motor Interface

Vibration Motor Schematic (Click to enlarge)

The vibration motor is driven by MOTOR (GPIO8) through a low-side MOSFET, active-high.

Module Interface

The BaseBoard provides two 2 × 10P, 2.54 mm pitch expansion headers (H2 left and H1 right) that expose GPIOs, UART, USB Serial/JTAG, power, and ground for secondary development. Except for power and ground, all expansion signal pins support GPIO and can be flexibly remapped through the GPIO matrix. Labels such as ADC / TOUCH / COMP / DAC in the tables below mark the pin’s analog capabilities and do not prevent using it as a general-purpose GPIO.

ESP-Mosaico provides left and right module slots. The BSP discovers them through EEPROM address selection:

Left Module Slot (H2) Pins

Left Module Interface Schematic (Click to enlarge)

Pins are listed clockwise around the connector, starting from Pin1 (odd-numbered row first, then even-numbered row back).

Right Module Slot (H1) Pins

Right Module Interface Schematic (Click to enlarge)

Pins are listed clockwise around the connector, starting from Pin1 (odd-numbered row first, then even-numbered row back).

Hardware Revision Details

• V1.2 (this document): Major changes compared with V1.0 are as follows.
  • Display interface: LCD_RST and LCD_SCL are swapped (V1.2: LCD_RST = GPIO44, LCD_SCL = GPIO42).
  • The charge LED colors are changed: V1.0 uses red while charging and green when fully charged; V1.2 uses orange while charging and white when fully charged.
  • The programmable orange LED (formerly GPIO3) is removed.
  • The 3.3 V power LED is removed.
  • Independent codec power-domain control (formerly GPIO56) is removed.
  • Onboard devices and expansion modules use two I2C buses: internal I2C0 (SDA = GPIO56, SCL = GPIO3); external I2C1 remains SDA = GPIO0, SCL = GPIO1.
  • The external 3.3 V rail is generated by a dedicated DCDC, so expansion modules do not affect the internal MCU supply.
• V1.0: See ESP-Mosaico V1.0.

Related Documents

• ESP-Mosaico CoreBoard V1.2 Schematic (PDF)
• ESP-Mosaico BaseBoard V1.2 Schematic (PDF)
• 2.16-inch 480 × 480 QSPI AMOLED Display Datasheet (PDF)
• ESP32-S31 Series Datasheet (HTML)
• Camera Module User Guide
• Multi-function Interaction Module User Guide
• ESP-Mosaico User Guide (HTML)
• ESP-Mosaico Firmware Update (HTML)
• ESP-Claw (HTML)

Disclaimer and Copyright Notice

Please refer to the Disclaimer and Copyright Notice.