Skip to content

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

@gHashTag

Description

@gHashTag

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) завершена:

Теперь нужно замкнуть цикл: 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

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions