Сборка по пунктам
Вы узнаете
Каждая стадия от спеки до битстрима — с временем, инструментом и хешем.
Целая сборка от спеки t27 до битстрима Artix-7, расписанная как чек из магазина: каждая стадия, инструмент и его версия, затраченное время и sha256 того, что она записала. Нигде нет Vivado. Когда число в чеке можно проверить, любой может пересобрать и сравнить хеш.
Попробуйте
Прочитайте чек: какая стадия шла дольше всех и какой инструмент её выполнял? В спеке RECEIPT_KINDS называет два вида чека: какой из них — только сборка и какая запись в ERRORS ловит его, когда он выдаёт себя за другой?

One real open-flow build itemised like a shop receipt: each stage from a t27 spec to an Artix-7 200T bitstream with its time, tool version, output size and sha256.
specs/fpga/adapter.t27
// SPDX-License-Identifier: Apache-2.0
; specs/fpga/adapter.t27 -- the FPGA adapter contract: how a bitstream travels from a
; build record to a device run and back as a receipt. S11 of gHashTag/trinity#988
; (gHashTag/t27#3573, dmitrii-f-t27/trinity-memory#66). Two laws from #3573 hold the
; whole contract: no hardware run may be inferred from synthesis, and physical
; acceptance is tied to a recorded device and transcript. The tool that enforces it
; is tools/trinity_fpga_adapter.py (check / --self-check); the receipts it checks
; live in conformance/trinity/fpga_adapter.json. ASCII only (L3), English only (LANG-EN).
; phi^2 + 1/phi^2 = 3 | TRINITY
module trinity_fpga_adapter;
pub const KIND : str = "spec";
pub const VERSION : str = "1";
; The receipt schema this contract version emits and accepts.
pub const RECEIPT_SCHEMA : str = "trinity.fpga-receipt.v1";
; A receipt is exactly one of: a build-only record (nothing touched a device) or a
; device record (a board ran and a transcript exists). No third kind, no defaults.
pub const RECEIPT_KINDS : [2]str = ["dry_run", "device"];
; ---- Inputs (what a caller must bring) -------------------------------------
; bitstream_path: a file path. bitstream_sha256: the hex sha256 of that file's
; bytes, checked before anything else. provenance: the build record -- commit,
; tool versions (yosys, nextpnr-xilinx, prjxray image), the routed Fmax verdict.
; board identity: the device's IDCODE under the rule below, DNA when read.
; The IDCODE rule: the full 32-bit value, high nibble included (0x13636093 for the
; Artix-7 XC7A200T of the AX7203 bench). openFPGALoader prints it without the
; revision nibble (0x3636093); a receipt records BOTH forms once, and every later
; comparison uses the full value, so a masked match can never pass for identity.
pub const IDCODE_FULL : str = "0x13636093";
pub const IDCODE_PRINTED : str = "0x3636093";
pub const BOARD : str = "alinx_ax7203";
pub const PART : str = "xc7a200tfbg484-2";
; ---- Configuration ---------------------------------------------------------
; flasher: the program that writes the device. The bench's is openFPGALoader
; (-c digilent_hs2, SRAM by default); trinity-fpga's openocd path is a legal
; second value once a receipt exercises it. cable: the JTAG adapter. target:
; "sram" (volatile, the bench default) or "flash" (persistent).
pub const FLASHERS : [2]str = ["openFPGALoader", "openocd"];
pub const CABLE : str = "digilent_hs2";
pub const TARGETS : [2]str = ["sram", "flash"];
; ---- Errors (distinct, one status each; no error is a prefix of another) ----
pub const ERRORS : [8]str = ["wrong_version", "hash_mismatch", "bitstream_absent",
"bitstream_empty", "placeholder_command", "idcode_mismatch",
"transcript_missing", "dry_run_as_device"];
; wrong_version the receipt's schema is not RECEIPT_SCHEMA of contract VERSION
; hash_mismatch the bitstream's sha256 is not the provenance's
; bitstream_absent the bitstream path names no file
; bitstream_empty the file exists and holds zero bytes
; placeholder_command the flasher line is a placeholder ("" or "TBD" or "<...>")
; idcode_mismatch the device's full IDCODE is not the receipt's recorded one
; transcript_missing a device receipt with no transcript hash / empty transcript
; dry_run_as_device a build-only record carrying a hardware result line
; ---- Receipt ---------------------------------------------------------------
; Every device receipt carries: the bitstream sha256, the full IDCODE, DNA when
; read, the transcript sha256, the result line ("HW RESULT: N/M bit-exact" for
; exact comparisons; counters for measurements), the captured UTC time and the
; tool versions. A dry_run receipt carries the build half and an explicit
; "hardware": false; it must NOT contain a hardware result line. The receipt is
; the only currency of evidence: a claim without one is a plan, not a result.
; ---- Device results of this stage (the receipts' sources) ------------------
; dmitrii-f-t27/trinity-memory: reports/fpga/matvec-capture-2026-09-27-m6d5-golden.json
; (dense5, 320/320 bit-exact), ...-golden-b2.json (baseline2, 320/320),
; ddr3-matvec-measure-2026-09-27-{d5,b2}.json (12 runs each), and the #61 pattern
; capture. conformance/trinity/fpga_adapter.json embeds them; the tool checks.
fn error_count() -> u32 {
return 8;
}
test error_codes_are_distinct {
// The eight statuses are pairwise distinct strings by construction of the
// ERRORS table; the count is what the tool's self-check plants one by one.
assert_eq(error_count(), 8);
}
// The printed form is the full form without its revision nibble; a receipt
// that recorded only the printed form could pass a masked comparison. The
// rule is arithmetic, not stringly: full == printed + 0x10000000.
fn idcode_full_of(printed: u32) -> u32 {
return printed + 268435456;
}
test idcode_rule_records_both_forms {
assert_eq(idcode_full_of(0x3636093), 0x13636093);
assert_eq(idcode_full_of(0x3636093) & 0xF0000000, 0x10000000);
}
fn receipt_kind_count() -> u32 {
return 2;
}
test receipt_kinds_exhaustive {
assert_eq(receipt_kind_count(), 2);
}
endmodule
Все уроки
Модуль 1 · Чип
Что такое FPGA, какой чип у нас и как его выводы встречаются с платой.
Модуль 2 · Числа в железе
Биты, триты и форматы чисел, и сколько стоит арифметика в логике.
Модуль 3 · Ваша программа на t27
Напишите спеку, проверьте её и увидьте, почему «компилируется» не значит «верно».
Модуль 4 · Внутри t27c
Как компилятор читает спеку и что он пишет, включая нативный t27b.
Модуль 5 · От спеки к железу
Verilog, который пишет t27c, ячейки, в которые он превращается, и что делает одна LUT.
Модуль 6 · Читаем синтез
Что yosys сообщает о вашем дизайне и какие предупреждения важны.
Модуль 7 · Размещение, трассировка, тайминг
Где ячейки оказываются на кристалле и успевает ли тактовая частота.
Модуль 8 · Битстрим
Как оттрассированный дизайн становится битами, которые загружает чип, без Vivado.
Модуль 9 · На плате
Спросите чип, кто он, загрузите биты и проверьте их.