Flashing
Flash the right firmware for the project.
Studio uses the project target to choose firmware and writes the current script, filesystem image, and optional AI model from the browser.
Before flashing
Use Chrome or Edge with Web Serial support.
Use a USB cable that supports data, not a charge-only cable.
Confirm the board is ESP32-S3.
Confirm the project flash size matches the real board flash size.
Save the script and clear lint errors before starting the flash flow.
Flashing steps
Open the projectFrom the Studio console, click the project card to open the IDE.
Review device settingsUse the project settings modal if you need to change chip, flash size, or BLE option.
Click FlashThe flash modal opens with the selected firmware target and current script.
Select the serial portChoose the connected ESP32-S3 board when the browser asks for a port.
Keep the modal openWait while bootloader, partition table, app firmware, filesystem, script, and optional model are written.
Read the resultIf flashing fails, the modal output shows which artifact or board check failed.
What Studio writes
ArtifactWhy it mattersWhere it comes from
BootloaderStarts the ESP32-S3 firmware.Firmware bundle for the selected target.
Partition tableDefines app, script, filesystem, and model slots.Firmware bundle for the selected flash size.
App imageContains the native firmware runtime and modules.Selected chip, flash, and BLE build.
System filesystemStores built-in runtime support files.Firmware bundle.
ScriptYour current Studio code.Saved project source.
AI modelThe single `.espdl` model used by the script.Model catalog when `cv.load("model_name")` is present.
Target settings
ESP32-S3 8MBUse for boards with 8MB flash. Picking 16MB firmware for an 8MB board can fail at boot.
ESP32-S3 16MBUse only when the physical board really has 16MB flash.
No BLEDefault choice for smaller firmware and fewer memory constraints.
BLEUse only when the script imports and uses BLE functionality.