feat(fpga): add trinity-fpga as submodule + XVC WiFi JTAG flash pipeline #588

Goal

Интегрировать trinity-fpga как git submodule в trinity/fpga/hardware, добавить flash-скрипты для XVC WiFi JTAG bridge (ESP32), и обеспечить воспроизводимый путь от CI до прошивки FPGA.

Anchor: φ² + φ⁻² = 3 · TRINITY · OWN STACK

Context

Phase 1 (trinity-fpga #8) завершена:

• igla_champion_gf16.bin (144KB, BPB=0.1427) в trinity-fpga/bitstream/
• PR Vibee v5 production #9 merged: feat(igla): GF16 champion weights export (Phase 1, Closes #8) trinity-fpga#9

Теперь нужно замкнуть цикл: trinity CI → synthesis → flash → inference.

Что уже есть в trinity/fpga/

• AUTO_FLASH.sh — автономная прошивка через DLC-10
• xvc_flash.sh — ESP32 WiFi JTAG bridge
• esp32-xvc/ — ESP32 XVC firmware
• esp32_wifi_bridge/ — WiFi JTAG bridge code
• Dockerfile.f4pga — open-source synthesis Docker
• openxc7-synth/ — 217 Verilog модулей (VSA, HSLM, ternary matmul)
• flash/ — flash utilities
• constraints/ — XDC pin assignments
• sim/ — simulation infrastructure

Что нужно сделать

Step 1 — Submodule

cd trinity
git submodule add https://github.com/gHashTag/trinity-fpga.git fpga/hardware
git commit -m "feat(fpga): add trinity-fpga submodule for hardware integration"

Step 2 — Flash pipeline symlink/script

# fpga/flash/xvc_flash.sh уже существует
# Обновить чтобы читал bitstream из submodule:
# fpga/hardware/bitstream/igla_champion_gf16.bin

Step 3 — Verify flash path

# Убедиться что AUTO_FLASH.sh работает с submodule:
ls -la fpga/hardware/bitstream/igla_champion_gf16.bin
bash fpga/AUTO_FLASH.sh  # (dry-run, без реальной FPGA)

Acceptance criteria

• trinity-fpga добавлен как submodule в fpga/hardware/
• fpga/hardware/bitstream/igla_champion_gf16.bin доступен
• fpga/flash/xvc_flash.sh корректно указывает на submodule
• CI не ломается (submodule clone работает)

Зависимости

• Blocked by: trinity-fpga PR Vibee v5 production #9 (merged ✅)
• Blocks: Phase 2 — ternary matmul RTL port (Issue #B)

φ² + φ⁻² = 3 · TRINITY · NEVER STOP