Circuito obrero-1

crates/obrero-core    Motor sans-io: parser MIDI, patrón, transporte, reloj 24 PPQN.
                      Sin threads ni I/O — la plataforma llama advance(now, lookahead)
                      y recibe eventos MIDI timestampeados. Testeable en host.
crates/obrero-wasm    Bindings wasm-bindgen del motor para el navegador.
web/                  UI TypeScript (vite): grilla de pasos, Web MIDI, scheduler
                      con lookahead de 100 ms y send timestampeado.
firmware/             Binario ESP32 (esp-idf-svc, toolchain xtensa propio).
                      Excluido del workspace raíz — se compila aparte.

# Tests del motor (host)
cargo test -p obrero-core

<<<<<<< HEAD
# Build WASM
cargo build -p obrero-wasm --target wasm32-unknown-unknown

cd web
npm install
npm run wasm   # compila crates/obrero-wasm → web/src/pkg
npm run dev    # http://localhost:5173 (Web MIDI requiere Chrome/Edge)

# Setup (una vez)
cargo install espup && espup install
source ~/export-esp.sh   # agregar al perfil de shell
cargo install espflash

cd firmware
<<<<<<< HEAD
cargo build      # primera build descarga ESP-IDF en .embuild/ — tarda
./dev.sh         # build + flash + monitor serial
=======
# Build + flash + monitor serial (todo junto)
./dev.sh

`dev.sh -m` solo elige qué directorio de target flashear — el chip compilado lo define `.cargo/config.toml`.

### USB-MIDI + debug serial (dos cables)

El firmware S3 levanta TinyUSB (componente `espressif/esp_tinyusb`, ver
`Cargo.toml` y `CONFIG_TINYUSB_MIDI_COUNT` en `sdkconfig.defaults`) sobre el
puerto **USB nativo** (GPIO19/20), que enumera como dispositivo USB-MIDI.
Los logs y el flasheo van por el conector **UART** (bridge USB-UART → UART0),
así que conviene tener ambos cables conectados: `dev.sh` flashea y monitorea
solo por `/dev/ttyUSB*` y deja el `/dev/ttyACM*` (USB nativo) libre para MIDI.

Al usar USB-OTG se pierde el USB-Serial-JTAG del puerto nativo (comparten PHY);
el debug queda en el conector UART. TinyUSB no compila para el ESP32 clásico
(no tiene USB-OTG): para ese chip hay que comentar el bloque
`extra_components` en `firmware/Cargo.toml`.

>>>>>>> e3618c6 (fmt)
Flasheo manual según target activo:

```sh
# ESP32 (rev1)
espflash flash target/xtensa-esp32-espidf/debug/obrero-1 && espflash monitor

# ESP32-S3
espflash flash target/xtensa-esp32s3-espidf/debug/obrero-1 && espflash monitor
>>>>>>> 56ef925 (entorno esp32s3)