- Python 69%
- C 20.4%
- TypeScript 6%
- C++ 2.2%
- CMake 1.2%
- Other 1.2%
c5688aec14
Some checks failed
CI / repository (push) Has been cancelled
CI / Host / macos-15-intel / Python 3.12 (push) Has been cancelled
CI / Host / macos-15-intel / Python 3.8 (push) Has been cancelled
CI / Host / ubuntu-24.04 / Python 3.12 (push) Has been cancelled
CI / Host / ubuntu-24.04 / Python 3.8 (push) Has been cancelled
CI / Host / windows-2022 / Python 3.12 (push) Has been cancelled
CI / Host / windows-2022 / Python 3.8 (push) Has been cancelled
CI / quality (push) Has been cancelled
CI / sanitizers (push) Has been cancelled
CI / frontend (push) Has been cancelled
CI / frontend-e2e (push) Has been cancelled
CI / firmware (baseline) (push) Has been cancelled
CI / firmware (media) (push) Has been cancelled
CI / firmware (multichip) (push) Has been cancelled
CI / firmware (ota) (push) Has been cancelled
CI / firmware (system) (push) Has been cancelled
CI / required (push) Has been cancelled
feat: update v0.3.0 |
||
|---|---|---|
| .github/workflows | ||
| docs | ||
| ESP-Iris | ||
| firmware/recovery | ||
| mosaico-tools | ||
| shared | ||
| tools | ||
| .gitignore | ||
| AGENTS.md | ||
| LICENSES.md | ||
| README.md | ||
| WORKFLOW.md | ||
ESP-Mosaico Utils
ESP-Mosaico Utils contains the ESP-Iris device link, Web Workbench and ESP-Mosaico application toolchain. Vibe Mode uses ESP-Iris for installation and device maintenance; ROM Download Mode is the chip-level flashing program. Recovery commands, protocol identifiers and ABI names remain stable.
Repository layout
| Path | Contents |
|---|---|
ESP-Iris/ |
ESP-Iris component, Developer Gateway and Web Workbench (0.2.x) |
mosaico-tools/ |
Host CLI and build runner (0.2.x), templates, public Recovery ABI, application adapter and bootloader integration |
firmware/recovery/ |
Pre-built Vibe Mode bundle for reviewed Recovery operations |
shared/ |
GSP tool acquisition and Ideas display-resource generation |
The Gateway serves the committed Web Workbench without Node.js. Frontend
contributors regenerate and commit
ESP-Iris/components/esp_iris/tools/frontend/dist with their source changes.
Use from an application workspace
Pin this repository once and resolve Iris and Tools from the same revision.
Run device commands through the consuming workspace's root mosaico.py.
The workspace owns .mosaico.json, applications, BSP pins and device evidence.
# Uses firmware/recovery.
python mosaico.py recover --source reviewed
# Requires an explicitly supplied firmware project.
python mosaico.py recover --source current --source-path /path/to/firmware/vibe-mode
# Validate an app against that project's prepared candidate.
python mosaico.py iris app-update --recovery-source current --recovery-source-path /path/to/firmware/vibe-mode
Source paths are relative to the current working directory. current without a
path fails before building or accessing a device. See
application integration and
0.2 migration.
Development
Start with AGENTS.md and use WORKFLOW.md for the check matching the changed owner. Ordinary edits use focused tests and cached builds. Full host, frontend and firmware checks remain available in CI.
Vibe Mode, ESP-Iris and ESP-Mosaico Tools have independent versions and release
tags: vX.Y.Z, esp-iris-vX.Y.Z and esp-mosaico-tools-vX.Y.Z, respectively.