Repository navigation
Open
Labels
enhancementNew feature or requestNew feature or request
Description
Goal
Запустить полный pipeline на реальном железе и получить измеренные tokens/sec из UART. Всё ПО готово в main (PR #9, #12, #13).
Anchor: φ² + φ⁻² = 3 · TRINITY · REAL HARDWARE
Что готово (в main)
| Артефакт | Файл | Статус |
|---|---|---|
| GF16 веса | bitstream/igla_champion_gf16.bin |
BPB=0.1427, SHA de2719b5 |
| VSA matmul | fpga/vsa/vsa_matmul.v |
64×64, 0 DSP48 |
| Synthesis top | fpga/vsa/vsa_matmul_top.v |
XDC готов |
| CLI | trios-fpga synth-vsa/flash/bench/status |
Rust, в main |
| Ring FP-01 | OpenXc7Runner |
Docker regymm/openxc7:latest |
| Ring FP-02 | XvcFlasher |
TCP/XVC, порт 2542 |
Hardware setup
XC7A100T (QMTECH board)
└── JTAG ←── ESP32 XVC bridge (WiFi, порт 2542)
└── UART TX ──→ хост 115200 baud
Steps
Step 1 — Синтез битстрима
cargo build --release -p trios-fpga
trios-fpga synth-vsa --rtl fpga/vsa/ --constraints fpga/vsa/vsa_matmul_top.xdcОжидаемый результат:
-
bitstream/design_v02.bitсоздан - LUT utilization ≤ 80%
- 0 timing violations
- SHA-256 записан в
bitstream/design_v02.bit.sha256
Step 2 — Прошивка через XVC
trios-fpga flash --xvc <ESP32_IP> --bitstream bitstream/design_v02.bit
trios-fpga verify --xvc <ESP32_IP> # IDCODE == 0x03631093Ожидаемый результат:
- Flash успешен (no errors)
- IDCODE верифицирован:
0x03631093(XC7A100T) -
STATUS=0x401079FC(DONE=1)
Step 3 — Benchmark tokens/sec
trios-fpga bench --xvc <ESP32_IP> --uart /dev/ttyUSB0 --baud 115200Ожидаемый результат:
- UART читает токены без ошибок
- tokens/sec ≥ 100 (acceptance criteria из 🚀 feat: IGLA Champion Model → FPGA Inference (v0.2-igla-fpga) #7)
- watts/token измерен (мультиметр или ваттметр)
- Результаты сохранены в
bench/results_v02.json
Step 4 — Release v0.2-igla-fpga
gh release create v0.2-igla-fpga \
bitstream/design_v02.bit \
bitstream/igla_champion_gf16.bin \
bench/results_v02.json \
--title "v0.2-igla-fpga: IGLA Champion on XC7A100T" \
--notes-file release/RELEASE-v0.2.md- GitHub Release создан с артефактами
-
design_v02.bit+ SHA-256 в релизе - Реальные tokens/sec в release notes
Step 5 — arXiv submit
- Заполнить реальные цифры в
docs/arxiv-trinity-stack-draft.md - tokens/sec, watts/token, LUT%, timing
- Отправить на arXiv cs.AR + cs.LG
Acceptance Criteria
- [ ] bitstream/design_v02.bit синтезирован (LUT ≤ 80%)
- [ ] IDCODE = 0x03631093 верифицирован на железе
- [ ] STATUS = 0x401079FC (DONE=1, no errors)
- [ ] tokens/sec ≥ 100 из UART
- [ ] watts/token задокументирован
- [ ] Release v0.2-igla-fpga опубликован
- [ ] arXiv draft отправлен
Debug hints (если упадёт)
Синтез падает
# Проверить Docker
docker pull regymm/openxc7:latest
docker run --rm regymm/openxc7:latest yosys --version
# Проверить RTL
iverilog -o /dev/null fpga/vsa/vsa_matmul_top.v fpga/vsa/vsa_matmul.vXVC не отвечает
# Проверить ESP32
nc -zv <ESP32_IP> 2542
trios-fpga status --xvc <ESP32_IP> # IDCODE pingUART нет токенов
# Проверить baud
stty -F /dev/ttyUSB0 115200
cat /dev/ttyUSB0 | hexdump -C | head
# STATUS регистр
trios-fpga status --xvc <ESP32_IP>LUT > 80%
- Уменьшить
VECTOR_DIMс 64 до 32 вvsa_matmul_top.v - Пересинтезировать
References
- Issue 🚀 feat: IGLA Champion Model → FPGA Inference (v0.2-igla-fpga) #7 (закрыт) — EPIC: все 3 фазы в main
- PR feat(igla): GF16 champion weights export (Phase 1, Closes #8) #9 — GF16 weights
- PR feat(vsa): ternary matmul kernel — XOR + popcount, 0 DSP #12 — ternary matmul VSA
- PR feat(vsa): Phase 3 — synthesis top, benchmark 135x, release v0.2, arXiv draft #13 — synthesis top + CLI + arXiv draft
fpga/COMPLETE_CONNECTION_GUIDE.md— схема подключения ESP32fpga/ESP32_CONNECTION_GUIDE.md— XVC WiFi JTAG setup
Priority: P0 · железо доступно · запускать немедленно
φ² + φ⁻² = 3 · TRINITY · NEVER STOP
Metadata
Metadata
Assignees
Labels
enhancementNew feature or requestNew feature or request
Activity
feat(hw): iverilog validation + UART TX + LED heartbeat — inference 1…
gHashTag commentedon May 6, 2026
✅ iverilog validation PASS — PR #15 merged (
0d01617d)Результаты
Чеклист #14
trios-fpga synth-vsa— собратьdesign_v02.bittrios-fpga flash --xvc <ESP32_IP>trios-fpga bench— реальные tokens/secНеобходимо для следующего шага
Как только
design_v02.bitсобран — нужен ESP32 IP для flash.gHashTag commentedon May 6, 2026
Step 1 Progress: Bitstream synthesized ✅
Synthesis Results (DIM=32, XC7A100T-FGG676-1)
Fixes Applied (PR #21, merged)
vsa_matmul.v: integer declarations moved outside initial blockvsa_matmul_top.v: integer declarations, UART multi-driver fix, debug_state wire→regStep 2: XVC Connection
ESP32 XVC server found at 192.168.1.30:2542:
However, JTAG shift commands timeout — likely JTAG cable not connected between ESP32 and FPGA board.
Needs physical cable check.
Blocker: JTAG Cable
The XVC TCP server responds to
getinfo:butshift:commands timeout. This means:Action needed: Check JTAG wiring between ESP32 and QMTECH XC7A100T board.
φ² + φ⁻² = 3 | TRINITY
gHashTag commentedon May 6, 2026
JTAG Diagnostic Result
XVC protocol works. JTAG partially works. TDO wire not connected.
What works
192.168.1.30:2542:getinfo:→xvcServer_v1.0:2048✅settck:command: period 1000ns ✅shift:command: sends TCK/TMS/TDI clocks ✅0xFF= TDO stuck HIGHRoot cause: TDO not connected
This means GPIO35 (ESP32 input-only pin) reads HIGH because the TDO wire from the FPGA JTAG header is not physically connected.
Fix needed
Connect TDO from QMTECH XC7A100T JTAG header (P2) to ESP32 GPIO35.
Pin mapping (from
firmware/xvc-esp32/xvc-esp32.ino):Once TDO is connected
./target/release/trios-fpga --xvc-host 192.168.1.30 verify # Expected: IDCODE: 0x03631093 — MATCH (XC7A100T) ./target/release/trios-fpga --xvc-host 192.168.1.30 flash \ --bitstream build/vsa_matmul/design_v02.bit --board XC7A100Tφ² + φ⁻² = 3 | TRINITY
fix(fpga): binary16 NaN payload — propagate explicitly (platform-inde…
[-]🔨 hw: синтез + прошивка + bench на железе (v0.2-igla-fpga Release)[/-][+]🔨 hw: synthesis + flashing + hardware benchmarks (v0.2-igla-fpga Release)[/+]