Frequently asked questions

The online firmware flashing page is https://mosaico.espressif.com/firmware-update/.

Hold the BOOT button, then turn the device on. The screen stays black in download mode. This is normal.

Currently, the camera module can only be inserted on the left side. Hot insertion is supported, but hot removal is not. If it is inserted on the right side, power off the device, remove the module, insert it on the left side, and then power the device on. For support information for other expansion modules, see https://github.com/esp-mosaico/esp-mosaico-bsp#expansion-modules Compatibility with third-party expansion boards must be verified through actual testing.

Yes. The current kit includes the official SC101IOT DVP camera expansion module. It is a separate module supplied with the kit, not a camera built into the main unit.

The mainboard has onboard NAND flash. Both the Early Access version and version v1.2 use 128 MB of NAND flash.

Two internal BMM150 geomagnetic sensors form a sensing matrix that can detect magnetic attachment in four directions.

The main unit has a built-in 65 mAh lithium battery. There are plans to open-source a matching 900 mAh rear-mounted battery module to extend battery life.

The enclosure file for the ESP-Mosaico Multi-Function Interaction Sub-board is available at:https://makerworld.com.cn/zh/models/3012963-esp-mosaico-mo-kuai-jiao-hu?appSharePlatform=copy#profileId-3539338 Users can print it themselves.

The current main unit uses 2 × 10-pin, 2.54 mm-pitch, dual-row female headers for its left and right expansion interfaces.

Yes. You can use AI agents such as DeepSeek to develop for ESP-Mosaico, referring to the esp-mosaico-vibe repository. There is currently no dedicated DeepSeek plugin or one-click setup support.

Yes. The current Early Access main unit has one onboard microphone and comes with a speaker.

ESP-Mosaico weighs approximately 31.7 g.

Tutorial: https://legacy.docs.esp-claw.com/en/tutorial/ Source repository: https://github.com/espressif/esp-claw/tree/legacy

There are three physical buttons: the power button is to the right of the USB port, the BOOT button is to the left, and the AI function button is at the top right.

You can access them through the following links: • ESP-MOsaico Getting Started Guide: https://mosaico.espressif.com/zh/guide/ ; • ESP-Mosaico software development reference: https://github.com/esp-mosaico/esp-mosaico-vibe ; • ESP-Mosaico factory firmware restoration: https://mosaico.espressif.com/zh/firmware-update/ ; • ESP-Mosaico FAQ: https://mosaico.espressif.com/zh/guide/faq/ .

ESP-Claw runs on the ESP-Mosaico device, while the large language model runs at the model service provider

• When the device has not been configured for network access, connect to the device's hotspot and visit 192.168.4.1 in a browser. • When the device has already been configured for network access, connect the phone or computer used to access the web page and ESP-Mosaico to the same LAN, then enter ESP-Mosaico's LAN IP address in the browser. Obtain the IP address as follows: 1. On esp-mosaico's setting page, go to Network and configure the WiFi connection. 2. After connecting to WiFi, you can find the IP address of esp-mosaico's WiFi connection under setting —— AI Model, or use WeChat on your phone to scan the QR code next to the IP address to open the web control page directly.

By default, QQ continues using the same session. To start a new session, send /session new. After using the same session for a long time, earlier conversation content may be forgotten. For more information: https://esp-claw.com/zh-cn/tutorial/first-interactions/

Not necessarily. The ESP-Mosaico main firmware is developed based on ESP-Claw but has its own version number, so the main firmware and component versions do not need to match. Check each corresponding version separately; a version difference alone is not enough to determine that the upgrade failed. Whether the upgrade succeeded should also be verified against the target firmware and the device’s actual operation after the upgrade.

The web console of factory firmware version v0.4.0 and later provides a Log／Real-time Log entry on the left. If an older page does not have this entry, update to firmware that includes this feature at https://mosaico.espressif.com/zh/firmware-update/ . When troubleshooting speech recognition, open the log first, trigger recognition once, and collect the error from that attempt. Logs are used to locate the problem; they do not mean that updating the firmware can resolve every speech-related fault.

A self-hosted model service can be configured, but the service must provide a compatible interface supported by the ESP-Claw backend in use, such as an OpenAI- or Anthropic-compatible interface. Enter the corresponding service address, model name, and required API Key, and ensure that the device can access the service. The model still runs on the host providing the interface; the model files are not deployed to ESP-Mosaico.

Yes. The key requirement is that the cable supports data transfer. A USB-C-to-USB-C data cable can be used, but a charge-only cable cannot be used for flashing. Once connected, use it in the same way as a USB-A-to-USB-C cable

See ESP-Mosaico Multi-Function Interaction Sub-board (https://docs.espressif.com/projects/esp-dev-kits/zh_CN/latest/esp32s31/esp-mosaico/user_guide_interact.html#esp-mosaico) documentation: when plugged into H2 on the left, the PIR corresponds to GPIO4; when plugged into H1 on the right, it corresponds to GPIO5. The PIR uses the AS312 and outputs a motion-detection level. For wiring and development, consult the table for the actual slot; do not apply the same GPIO number to both sides.

After the game is flashed as native application firmware, the device boots into that firmware. The game is not installed as an additional application that can be exited from within the original factory interface. To restore the original factory features, install the corresponding factory firmware through https://mosaico.espressif.com/zh/firmware-update/. The Lua/Skill extensions in ESP-Claw are a different development approach; the installation and exit behavior of these two approaches should not be confused.

Vibe Mode is the device's application installation and maintenance mode; Recovery is the technical name used for this retained firmware. When Vibe Mode firmware is present on the device, you can hold down the AI button while powering it on to enter Vibe Mode. BOOT download mode, also known as ROM download mode, runs the download program built into the chip.

Package the firmware as an .irisfw package. When uploading firmware in Ideas, select “Add Iris Firmware,” attach the file, and complete the submission. To use wireless updates, the target device must have Vibe mode firmware installed and running; an ordinary .bin file cannot be turned into an Iris firmware package merely by changing its file extension. Submission for review and approval are different states. After uploading, check the actual submission status.

The source code for the ESP-Mosaico factory firmware project is available at https://github.com/esp-mosaico/esp-mosaico-claw. If you need to compile it yourself, prepare ESP-IDF and the submodules according to the README and dependency requirements of the selected source code commit.

No. Simply replacing the API Key or changing the endpoint will not enable the factory firmware to support an ASR service that has not yet been adapted. Use a service provider integration already implemented in the firmware. To connect to another service provider, you need to modify the source code to implement its authentication, audio transmission, and recognition result handling, and then compile and verify the firmware. An ASR interface cannot be replaced directly as though it were a compatible large language model interface.

The matching charging module is designed for the rear contacts on v1.2; v1.0 can connect through the USB port.

The entry point is https://mosaico-ideas.espressif.com/ . The “Ideas Center” page on the ESP-Mosaico official website also provides this link, where you can find creative applications from the community.

You can view the device’s serial logs through the UART (TX/RX) in the expansion interface on the right side of the device.

Yes. ESP-Mosaico's ESP32-S31 main controller supports Classic Bluetooth (BT, BR/EDR) and Bluetooth Low Energy (BLE). Having these hardware capabilities does not mean that every firmware provides a pairing interface or supports all Bluetooth profiles; check the firmware being used to determine which features are available.

When the same firmware must support both versions, check and update to a BSP that includes the corresponding adaptations. The BSP should identify the hardware version and handle the relevant differences.