34 lines
1.6 KiB
Markdown
34 lines
1.6 KiB
Markdown
|
# 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á.
|