velxio/test/autosearch/00_README.md

Autosearch — Custom Chips para Velxio

Este folder es un cuaderno de bitácora vivo del trabajo para añadir custom chips al simulador Velxio.

Reglas:

• Cada hallazgo concreto va a un .md con número de orden.
• Cosas que NO funcionaron también se documentan (con la causa y qué se probó).
• Links a recursos externos se citan textualmente con la fecha en que se consultaron.
• No se borra contenido obsoleto: se marca como ~~tachado~~ o se mueve a una sección ## Descartado.

Índice de archivos

#	Archivo	De qué trata
00	00_README.md	Este archivo
01	01_wokwi_research.md	Cómo funciona el sistema de chips de Wokwi (referencia)
02	02_velxio_chip_api_design.md	Diseño del API propio (sin código de Wokwi)
03	03_wasi_compile_pipeline.md	Cadena de compilación C → WASM con clang + wasi-sdk
04	04_findings.md	Log corrido de qué funciona / qué no, día a día
05	05_open_questions.md	Decisiones pendientes
06	06_wokwi_api_gap_analysis.md	Comparación con wokwi-api.h: qué falta agregar
07	07_multi_board_support.md	Matriz por board (AVR/RP2040/ESP32/etc): qué protocolos funcionan

Restricción del proyecto

Cero código de Wokwi. Ni wokwi-cli, ni wokwi-api.h, ni nombres de su API. El stack es 100% open source pero independiente:

• Toolchain: clang (LLVM, Apache 2.0) + wasi-sdk (WebAssembly, Apache 2.0).
• API del chip: velxio-chip.h, escrita desde cero, naming propio (vx_*).
• Loader y runtime: JS puro en test_custom_chips/src/.

Si en algún momento se considera importar algo de Wokwi, se discute primero acá.