Vodič za izgradnju

Glavne detaljne upute za izgradnju nalaze se u Izgradnja Hazard3-Dooma. Ova stranica povezuje taj postupak sa zahtjevima, profilima pločica, referencom skripti i informacijama o vremenskom zatvaranju koje su korisne pri ponovnoj izgradnji ili promjeni ciljne pločice.

Uobičajene izgradnje za pločice

Za uobičajenu izgradnju koristite potpuni wrapper za ciljnu pločicu. Ti wrapperi održavaju FPGA dizajn, monitor, Doom sliku, takt i memorijski profil međusobno usklađenima:

./scripts/build-ulx3s-85f-doom.sh
./scripts/build-ulx3s-12f-doom.sh
./scripts/build-ulx4m-ld-doom.sh

Pogledajte Izgradnja Hazard3-Dooma za podržane konfiguracije pločica, selektivnu ponovnu izgradnju monitora i Doom slike, pripremu podmodula, izlazne datoteke i varijable okruženja specifične za izgradnju.

Verzije alata i reproducibilnost

Rezultati FPGA vremenskog zatvaranja ovise o više čimbenika od samog izvornog stabla. Yosys, nextpnr, Project Trellis, postavke usmjeravanja i odabrani seed mogu utjecati na rezultat. Prije izgradnje provjerite razvojno okruženje:

./scripts/requirements-check.sh

Pogledajte Preduvjeti za potrebne alate na razvojnom računalu. Zadane nextpnr postavke specifične za pločicu definirane su u scripts/build-ecp5-bitstream-common.sh i sažete izravno iz te datoteke u Profili pločica.

Za izdanje 0.2.0 .github/workflows/ulx4m-bootloader.yml namjerno fiksira OSS CAD Suite na 2026-09-14 umjesto praćenja najnovijeg nightly izdanja. Taj je paket poznato dobra CAD okolina za ULX4M bootloader CI ovog izdanja. Kasniji nightly otkrio je problem višestrukih drivera u postojećoj uporabi ECP5 TRELLIS_IO primitiva samo za ulaz. RTL čišćenje i namjerno ažuriranje fiksirane CAD verzije odgođeni su za 0.3.0, pa nemojte uklanjati ni pomicati taj pin bez ponovne provjere izgradnje bootloadera.

Seed koji je prošao vremensko zatvaranje s jednom netlistom ili verzijom alata nije jamstvo vremena za drugu. Ako se promijene rezultat sinteze, verzija CAD alata, taktovi ili konfiguracija usmjeravanja, ponovno provedite odgovarajuću provjeru vremena prije nego što rezultat upotrijebite kao izdanje. Pogledajte ECP5 timing i seed sweepovi za postupak sweepa i kvalifikacije.

Skripte za izgradnju i napredni postupci

Za potpuni katalog pomoćnih alata za izgradnju, programiranje, provjeru, čišćenje i mjerenje vremena pogledajte Referenca skripti. Ta referenca dokumentira potpune wrappere za pločice kao i niže razine alata za monitor, bitstream, Doom sliku i sweep seedova.

Za vlasništvo nad dijelovima repozitorija i granicu između Hazard3 hardvera i softvera specifičnog za Hazard3-Doom pogledajte Raspored repozitorija i vlasništvo.