Connect

PassportSim

BlackHole1byBlackHole1
•
25
•
Developer Tools
Productivity & Workflow
Security & Testing

Emulate and debug FoloToy AI Passport ESP32-C3 firmware across web, desktop, and AI agent environments.

PassportSim is an advanced ESP32-C3 hardware emulator tailored for the FoloToy AI Passport, enabling developers to run and debug unmodified ESP-IDF firmware images directly in the browser via WebAssembly or locally on macOS and Windows. Offering screen emulation, peripheral controls, state snapshots, and console debugging, it completely removes the need for physical hardware during testing. Equipped with both a native CLI and a Model Context Protocol (MCP) server, PassportSim empowers AI agents and CI pipelines to autonomously boot builds, simulate button presses, analyze the LVGL UI tree, capture screenshots, and streamline embedded systems development.

Key Features

01Runs unmodified ESP-IDF firmware, merged binaries, and build bundles directly in the browser or via desktop CLI
02Advanced debugging tools including execution pausing, single-stepping, state snapshots, and memory inspection
03Cross-platform support across modern web browsers (WebAssembly), Apple silicon macOS, and Windows x64
04Provides built-in MCP server integration allowing AI agents to interact with UI trees, capture screenshots, and control device state
0524 GitHub stars
06Full hardware emulation covering display rendering, button inputs, audio, serial console, and mock peripherals

Use Cases

01Developing and debugging FoloToy AI Passport firmware applications quickly inside a browser environment
02Automating continuous integration and visual regression testing for ESP-IDF and LVGL projects without physical devices
03Enabling AI coding agents to autonomously test and verify embedded firmware interfaces and UI states