ghcr.io/davidmonterocrespo24/velxio-espidf-toolchain:latest

Velxio：Arduino 与嵌入式开发板模拟器

在线访问：velxio.dev

一款完全本地化的开源多开发板模拟器。编写 Arduino C++ 或 Python 代码，编译后通过真实 CPU 仿真和 48 种以上交互式电子元件进行模拟——所有功能均在浏览器中运行。

支持 19 种开发板 · 5 种 CPU 架构：AVR8（ATmega / ATtiny）、ARM Cortex-M0+（RP2040）、RISC-V RV32IMC/EC（ESP32-C3 / CH32V003）、Xtensa LX6/LX7（ESP32 / ESP32-S3，通过 QEMU）以及 ARM Cortex-A53（Raspberry Pi 3 Linux，通过 QEMU）。

支持该项目

Velxio 是免费开源的项目。构建和维护一个完整的多开发板模拟器需要大量时间——如果它为您节省了时间或您喜欢这个项目，直接赞助我将有助于维持开发。

您的支持将帮助支付服务器成本、库维护费用，并腾出时间添加新开发板、元件和功能。感谢您的支持！

立即试用

[***] — 无需安装。打开编辑器，编写程序，直接在浏览器中模拟。

通过 Docker 自托管（单命令）：

然后打开 [***]

截图

Raspberry Pi Pico 仿真——使用两个电位器进行 ADC 读取测试，串口监视器显示实时输出，底部为编译控制台。

Arduino Uno 通过 SPI 驱动 ILI9341 240×320 TFT 显示屏——使用 Adafruit_GFX + Adafruit_ILI9341 渲染实时图形演示。

库管理器在打开时加载完整的 Arduino 库索引——无需手动输入即可浏览和安装库。

元件选择器显示 48 种可用元件，包含视觉预览、搜索和分类筛选功能。

多开发板仿真——Raspberry Pi 3 和 Arduino 在同一画布上同时运行，通过串口连接。可在单个电路中混合不同架构。

ESP32 与 HC-SR04 超声波距离传感器仿真——通过 QEMU 实现真实 Xtensa 仿真，支持触发/回波 GPIO 时序。

支持的开发板

功能特性

代码编辑

• Monaco 编辑器——完整的 C++ / Python 编辑器，支持语法高亮、自动补全、迷你地图和深色主题
• 多文件工作区——创建、重命名、删除多个 .ino / .h / .cpp / .py 文件并在其间切换 .ino

.cpp

.py

• 通过 arduino-cli 后端进行 Arduino 编译——将程序编译为 .hex / .bin 文件 arduino-cli

.hex

.bin

• 编译/运行/停止/重置工具栏按钮，带状态消息
• 编译控制台——可调整大小的输出面板，显示完整编译器输出、警告和错误

多开发板仿真

AVR8（Arduino Uno / Nano / Mega / ATtiny85 / Leonardo / Pro Mini）

• 通过 avr8js 实现真实 ATmega328p / ATmega2560 / ATmega32u4 / ATtiny85 仿真，运行于原生时钟频率
• 完整 GPIO — PORTB、PORTC、PORTD（适用于 Uno/Nano/Mega）；所有 ATtiny85 端口（PB0–PB5）
• Timer0/Timer1/Timer2 — 支持 millis()、delay()、通过 analogWrite() 实现 PWM millis()

delay()

analogWrite()

• USART — 完整发送和接收功能，支持自动波特率检测

• ADC — 支持 analogRead()，通过画布上的电位器注入电压 analogRead()

• SPI — 硬件 SPI 外设（ILI9341、SD 卡等）

• I2C（TWI）— 带虚拟设备总线的硬件 I2C

• ATtiny85 — 所有 6 个 I/O 引脚、USI（Wire）、Timer0/Timer1、10 位 ADC；使用 AttinyCore AttinyCore

• 通过 requestAnimationFrame 实现 ~60 FPS 仿真循环 requestAnimationFrame

RP2040（Raspberry Pi Pico / Pico W）

• 通过 rp2040js 实现 133 MHz 真实 RP2040 仿真——基于 ARM Cortex-M0+

• 全部 30 个 GPIO 引脚——支持输入/输出、事件监听、引脚状态注入

• UART0 + UART1 — 串口监视器中的串行输出；通过 UI 进行串行输入

• ADC — 12 位，支持 GPIO 26–29（A0–A3）+ 内部温度传感器（通道 4）

• I2C0 + I2C1 — 带虚拟设备总线的主模式（DS1307、TMP102、EEPROM）

• SPI0 + SPI1 — 默认回环模式；支持自定义处理程序

• PWM — 可在任意 GPIO 引脚上使用

• WFI 优化——delay() 会跳至仿真时间的后续时刻，而非忙等待 delay()

• 示波器——~8 ns 分辨率的 GPIO 跳变时间戳

• 使用 earlephilhower arduino-pico 内核编译

详见 docs/RP2040_EMULATION.md 获取完整技术细节。

ESP32 / ESP32-S3（Xtensa QEMU）

• 通过 lcgamboa/qemu 实现真实 Xtensa LX6/LX7 双核仿真
• 完整 GPIO — 所有 40 个 GPIO 引脚，支持方向跟踪、状态回调、GPIO32–39 修复
• UART0/1/2 — 多 UART 串行，支持波特率检测
• ADC — 12 位，支持所有 ADC 功能引脚（通过电位器注入 0–3300 mV 电压）
• I2C — 带虚拟设备响应的同步总线
• SPI — 全双工，支持可配置 MISO 字节注入
• RMT / NeoPixel — 硬件 RMT 解码器，WS2812 24 位 GRB 帧解码
• LEDC/PWM — 16 通道占空比读取、LEDC→GPIO 映射、LED 亮度
• WiFi — SLIRP NAT 仿真（WiFi.begin("PICSimLabWifi", "")）

WiFi.begin("PICSimLabWifi", "")

• 需使用 arduino-esp32 2.0.17（IDF 4.4.x）——仅该版本兼容 lcgamboa WiFi

详见 docs/ESP32_EMULATION.md 获取设置和完整技术细节。

ESP32-C3 / XIAO-C3 / SuperMini / CH32V003（RISC-V，浏览器内运行）

• 基于 TypeScript 的 RV32IMC 仿真——无后端、无 QEMU、无 WebSocket
• GPIO 0–21（通过 W1TS/W1TC MMIO 寄存器，适用于 ESP32-C3）；PB0–PB5（适用于 CH32V003）
• UART0 串行输出至串口监视器
• CH32V003 — 48 MHz RV32EC 内核，16 KB 闪存，DIP-8 / SOP 封装——超紧凑型
• 即时启动——零延迟，支持离线运行
• 可 CI 测试——相同的 TypeScript 代码可在 Vitest 中运行

详见 docs/RISCV_EMULATION.md 获取完整技术细节。

Raspberry Pi 3B（QEMU raspi3b）

• 通过 qemu-system-aarch64 -M raspi3b 实现完整 BCM2837 仿真

qemu-system-aarch64 -M raspi3b

• 启动真实 Raspberry Pi OS（Trixie）——直接运行 Python 脚本
• RPi.GPIO 垫片——GPIO 库的即插即用替代品；通过文本协议向前端发送引脚事件
• GPIO 0–27 — 支持输出和输入、事件检测、PWM（二进制状态）
• 双串口——ttyAMA0 用于用户串口监视器，ttyAMA1 用于 GPIO 协议
• 虚拟文件系统——在 UI 中编辑 Python 脚本，启动时上传至 Pi
• 多开发板串行桥接——同一画布上的 Pi ↔ Arduino 串行通信
• qcow2 覆盖层——基础 SD 镜像永不修改；会话更改相互隔离

详见 docs/RASPBERRYPI3_EMULATION.md 获取完整技术细节。

串口监视器

• 实时串口输出——按程序/脚本发送的字符实时显示
• 自动波特率检测——读取硬件寄存器，无需手动配置
• 通过 UI 向 RX 引脚发送数据
• 带切换功能的自动滚动

元件系统（48+ 元件）