⬡ Church Machine — QMTECH Wukong Artix-7

QMTECH Wukong XC7A100T · JTAG · Exact approved revisions  ·  🛒 Buy the QMTECH Wukong board
Approved bitstream delivery
Select an exact approved revision in Build Approval history, then Download selected revision.
Open approved bitstream history ⬇Download wukong_bridge.py
Approved .bit delivery is supported. Approved .mcs, BSCAN helper, and project-package exports are unavailable. The bridge is a separate host utility.

Downloading does not program hardware or verify installation. If no approved revision is listed, complete an approved build first; a mutable current file is not a substitute.

📦 Build inputs (retained with the approved Namespace; not a downloadable package)
church_wukong_xc7a100t.v — Verilog netlist ✓
church_wukong_xc7a100t.il — Amaranth RTLIL source
wukong_xc7a100t.xdc — Vivado pin constraints
wukong_xc7a100t.tcl — Vivado batch build script
wukong_bridge.py — native USB-UART trace & command bridge
BUILD.md — full instructions
⚡ Load once or make the Wukong boot persistently

For the complete Windows/Vivado GUI sequence and troubleshooting, see Vivado Artix-7 Flash Guide.

1
Select the approved revision

Open Build Approval history, select the intended .bit revision, and download it. Keep its exact revision identity with the file.

2
Temporary: load the FPGA for this session
openFPGALoader church_wukong_xc7a100t.bit

Use the actual filename of the approved .bit you downloaded. Loading it writes the FPGA's volatile configuration; downloading alone does not.

Or via Vivado: Hardware Manager → Open target → Auto Connect → Program Device → select the .bit.

3
Persistent: program the board's SPI boot flash

Approved .mcs export is not available in this workflow. Do not substitute a mutable release file or claim a .bit download as persistent installation.

External flash tooling requires its own explicit artifact selection and verification. This IDE does not currently verify persistent FPGA installation.

4
Reset and confirm automatic boot

Press RESET or power-cycle the board. A correctly programmed .mcs restores the Church Machine without selecting the .bit again.

5
Connect to the IDE

Open the Church Machine IDE → click 🔌 Connect Wukong → pick your board from the list. The IDE uploads the boot image automatically and the Church Machine starts running.


🔧 Rebuild the bitstream from source (AMD Vivado required)
1
Run the Vivado build script
vivado -mode batch -source wukong_xc7a100t.tcl

Creates the project, runs synthesis + implementation (~30 min), and writes church_wukong_xc7a100t.bit.

2
Flash
openFPGALoader church_wukong_xc7a100t.bit

← Home  ·  Release 1 Documents  ·  IDE