Skip to content

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

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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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