⬡ Church Machine — QMTECH Wukong Artix-7

QMTECH Wukong XC7A100T · JTAG · Everything in one ZIP  ·  🛒 Buy the QMTECH Wukong board
Complete build package & pre-built bitstream
One download. Extract, then build with Vivado — or flash the pre-built bitstream below.
⬇Download church-wukong-package.zip ⬇Download wukong_bridge.py
Includes Verilog netlist · XDC pin constraints · Vivado build script · native USB-UART bridge
📦 What’s inside the ZIP
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
Extract the ZIP

Unzip into a folder and open a terminal there.

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

Download the pre-built .bit from the card above. This writes the FPGA's volatile configuration, so pressing reset or removing power clears it.

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

3
Persistent: program the board's SPI boot flash

Download the .mcs file from the purple button. In Vivado Hardware Manager, choose Add Configuration Memory Device, select n25q64-3.3v-spi-x1_x2_x4, then program the configuration memory with the downloaded .mcs.

This is the persistent “lock it home” path. It writes the Wukong’s SPI flash so the FPGA reloads this image after reset or power loss. Verify succeeds before resetting the board.

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