This project aims to port the QBert cabinet emulator to the Xilinx KR260 FPGA. The QBert emulator allows you to play QBert cabinet games on FPGA hardware.
To recreate the project in Vivado, follow these steps:
- Open Vivado and navigate to the "project" folder.
- Launch Vivado and run the command "source project.tcl".
Once the project is compiled in Vivado, you can load the bitstream onto the KR260 FPGA by following these commands in XSCT (Xilinx Software Command-line Tool) in sequence:
- Connect
- targets -set -nocase -filter {name =~ "*PSU*"}
- mwr 0xff5e0200 0x0100
- rst -system
Then, via Vivado, click on "Program device".
The project directory has the following structure:
project: contains the TCL project file for recreating the project.sources: contains the project sources.tools: contains scripts for converting a QBert games file to COE format for loading the ROM into the EPROM(s) IPs.
To load an QBert cartridge statically, generate the COE file and load it via Vivado interface. Follow these steps:
- Generate the COE file using the provided tools/scripts.
- Extract the number of lines of the .hex file and set it on the "EPROM"(s) IP ROM size.
- Load the COE file in Vivado.
For VGA output, you can use a PMOD VGA adapter. We recommend using this PMOD VGA adapter by Digilent. Connect the PMOD VGA adapter to the PMOD 3-4 ports.
The audio output is mapped on PMOD 2 on pin 1 (left channel) and pin 2 (right channel).
To map the joystick pins, replace the constant IP [0:7] with the desired PMOD pins. The joystick mapping is the following:
- 0: Jump
- 1: ---
- 2: START
- 3: START
- 4: DX
- 5: SX
- 6: UP
- 7: DOWN
When the signal is high, a button will trigger an event. If you implement your joystick in pull-up configuration, remember to invert the signal (with a Utility Vector Logic IP for example)
This project is licensed under the MIT License.
Please refer to the LICENSE file for more details.
- Original FPGA conversion by Pierco