NuBusFPGA/nubus-to-ztex-gateware/README.md

1.1 KiB

Compiling

Rom

Compiling the Declaration Rom (in DeclRom) requires the Retro68 toolchain.

The beginning of the Makefile in DeclROM/ needs to be adapted to point to the toolchain.

Microcode for acceleration

Compiling the acceleration code for the Framebuffer requires a RISC-V toolchain.

The script blit_goblin_nubus.sh in VintageBusFPGA_Common/ needs to be adapted to point to the appropriate toolchain.

Bitstream

Generating the bitstream requires Vivado, 2022 or newer should do. It also requires Litex, see for instance Linux-on-Litex-VexRiscv.

You will need LItex working, and an usable Vivado in yout $PATH.

Known issues

There's an interesting issue where you need the DeclRom to generate the bitstream (by defualt the Rom is emebedded in it), but you need CSR headers created during the generation of the bitstream to compile the Declaration Rom. A simple workaround is to create a Rom file with a kilobyte or two of fake data, generate the bitstream, then compile the declaration rom, then re-generate the bitsteam with the proper Rom.