stnolting / neorv32-setups

📁 NEORV32 projects and exemplary setups for various FPGAs, boards and (open-source) toolchains.

Exemplary NEORV32 Setups and Projects

• Community Projects (hardware / software)
• Setups using Commercial Toolchains (FPGA setups)
• Setups using Open-Source Toolchains (FPGA setups)
• Adding Your Project or Setup
• Setup-Specific NEORV32 Software Framework Modifications

This repository provides community projects as well as exemplary setups for different FPGAs, platforms, boards and toolchains for the NEORV32 RISC-V Processor. Project maintainers may make pull requests against this repository to add or link their setups and projects.

Tip

Ready-to-use bitstreams for the provided open source toolchain-based setups are available via the assets of theImplementation Workflow.

Community Projects

This list shows projects that focus on custom hard- or software modifications, specific applications, etc.

Link	Description	Author(s)
🌍 github.com/motius	tutorial: custom CRC32 processor module for the nexys-a7 boards	motius (ikstvn, turbinenreiter)
🌍 neorv32-examples	NEORV32 setups/projects for different Intel/Terasic boards	emb4fun
🌍 neorv32-xmodem-bootloader	A XModem Bootloader for the DE0-Nano board	emb4fun
🌍 neorv32-xip-bootloader	A XIP (eXecute In Place) Bootloader for the NEORV32	betocool-prog

Setups using Commercial Toolchains

The setups using commercial toolchains provide pre-configured project files that can be opened with the according FPGA tools.

Setup	Toolchain	Board	FPGA	Author(s)
📁 de0-nano-test-setup	Intel Quartus Prime	Terasic DE0-Nano	Intel Cyclone IV EP4CE22F17C6N	stnolting
📁 de0-nano-test-setup-qsys	Intel Quartus Prime	Terasic DE0-Nano	Intel Cyclone IV EP4CE22F17C6N	torerams
📁 de0-nano-test-setup-avalonmm	Intel Quartus Prime	Terasic DE0-Nano	Intel Cyclone IV EP4CE22F17C6N	torerams
📁 terasic-cyclone-V-gx-starter-kit-test-setup	Intel Quartus Prime	Terasic Cyclone-V GX Starter Kit	Intel Cyclone V 5CGXFC5C6F27C7N	zs6mue
📁 UPduino_v3	Lattice Radiant	tinyVision.ai Inc. UPduino v3.0	Lattice iCE40 UltraPlus iCE40UP5K-SG48I	stnolting
📁 iCEBreaker	Lattice Radiant	iCEBreaker @ GitHub	Lattice iCE40 UltraPlus iCE40UP5K-SG48I	stnolting

| 📁 arty-a7-35-test-setup | Xilinx Vivado | Digilent Arty A7-35 | Xilinx Artix-7 XC7A35TICSG324-1L | stnolting | | 📁 nexys-a7-test-setup | Xilinx Vivado | Digilent Nexys A7 | Xilinx Artix-7 XC7A50TCSG324-1 | AWenzel83 | | 📁 nexys-a7-test-setup | Xilinx Vivado | Digilent Nexys 4 DDR | Xilinx Artix-7 XC7A100TCSG324-1 | AWenzel83 | | 📁 on-chip-debugger-intel | Intel Quartus Prime | Gecko4Education | Intel Cyclone IV E EP4CE15F23C8 | NikLeberg | | 📁 tang-nano-9k | Gowin EDA | Sipeed Tang Nano 9K | Gowin LittleBee GW1NR-9 GW1NR-LV9QN88PC6/I5 | IvanVeloz

Setups using Open-Source Toolchains

All setups using open-source toolchains are located in the osflow folder. See the README there for more information how to run a specific setup and how to add new targets.

Setup	Toolchain	Board	FPGA	Author(s)
📁 UPDuino-v3.0	GHDL, Yosys, nextPNR	UPduino v3.0	Lattice iCE40 UltraPlus iCE40UP5K-SG48I	tmeissner
📁 FOMU	GHDL, Yosys, nextPNR	FOMU	Lattice iCE40 UltraPlus iCE40UP5K-SG48I	umarcor
📁 iCESugar	GHDL, Yosys, nextPNR	iCESugar	Lattice iCE40 UltraPlus iCE40UP5K-SG48I	umarcor
📁 AlhambraII	GHDL, Yosys, nextPNR	AlhambraII	Lattice iCE40HX4K	zipotron
📁 Orange Crab	GHDL, Yosys, nextPNR	Orange Crab	Lattice ECP5-25F	umarcor, jeremyherbert
📁 ULX3S	GHDL, Yosys, nextPNR	ULX3S	Lattice ECP5 LFE5U-85F-6BG381C	zipotron
📁 ChipWhisperer iCE40CW312	GHDL, Yosys, nextPNR	CW312T_ICE40UP	Lattice iCE40 UltraPlus iCE40UP5K-UWG30	colinoflynn
🌍 ULX3S-SDRAM	GHDL, Yosys, nextPNR	ULX3S	Lattice ECP5 LFE5U-85F-6BG381C	zipotron

---

Adding Your Project or Setup

Please respect the following guidelines if you'd like to add or link your setup/project to the list:

• check out the project's code of conduct
• for FPGA- / board- / toolchain-specific setups:
  • a "setup" is a wrapped (and maybe script-aided) implementation of the NEORV32 processor for a certain FPGA/board/toolchain
  • add a link if the board you are using provides online documentation or can be purchased somewhere
  • use the 📁 emoji (:file_folder:) if the setup is located in this repository; use the 🌍 emoji (:earth_africa:) if it is a link to your local project
  • please add a README.md file to give some brief information about the setup and a .gitignore file to keep things clean
  • for local setups you can add your setup to the implementation GitHub actions workflow to automatically generate up-to-date bitstreams for your setup
• for projects:
  • provide a link to your project (use the 🌍 (:earth_africa:) emoji)
  • provide a short description
  • further information should be provided by a project-local README

Setup-Specific NEORV32 Software Framework Modifications

In order to use the features provided by the setups, minor optional changes can be made to the default NEORV32 setup.

• To change the default data memory size take a look at the User Guide section General Software Framework Setup
• To modify the SPI flash base address for storing/booting software application see User Guide section Customizing the Internal Bootloader