Ecosystem

Simulators, FPGA boards, ASIC flow, software stack, and memory maps.

Supported Targets

Target	Purpose	Entry
NEMU	Software ISS (difftest reference)	`nemu/README.md`
NPC	Verilator simulator	`sim/`
ysyxSoC	Chisel SoC for testing	memory map
FPGA	Gowin boards and LiteX KU15P	`fpga/gowin-tang-nano-20k/README.md`, `fpga/litex/README.md`
ASIC (open)	Yosys + OpenSTA flow	yosys-opensta

Simulators

Simulator	Role	Entry
NEMU	Software ISS, reference model	`make run-nemu32`, `nemu/`
NPC	Verilator, cycle-accurate, waveform	`make sim-rv32`, `sim/`
raptSoC	Chisel SoC wrapping Raptor + devices	`make coremark-ysyxsoc` etc.

NPC is the primary development simulator. NEMU acts as the difftest reference for every commit.

FPGA Targets

Board / Flow	Status	Entry
Gowin Tang Nano 20K	Supported (synth + P&R)	`fpga/gowin-tang-nano-20k/`, `make fpga-syn`
Tang Mega 138K Pro / LiteX	Supported Gowin LiteX FPGA flow	`fpga/litex/`
MLK-CU07-KU15P / LiteX	Vivado, BIOS, MIG DDR4, SDCard, RV32 Linux boot	`fpga/litex/`

See fpga/litex/README.md for the LiteX BIOS + Linux flow.

ASIC Flow

Synthesis: Yosys with yosys-slang front-end for SystemVerilog.
STA: yosys-opensta — open-source static timing analysis (make sta).
PDK: open-source cell libraries; PPA results published under openppa.

See PROFILE.md for the latest Freq / Power / Area results and REFERENCE.md for the PPA benchmark framework.

Software Stack

Layer	Component	Notes
App	CoreMark, MicroBench, Embench-IoT, busybox, demos	`app/`, `abstract-machine/app/`
User OS	nanos-lite (simple OS), Linux v6.18 userspace	`abstract-machine/app/nanos-lite`
ABI / libc	riscv-pk (proxy kernel), AM runtime, newlib, glibc	`app/pk/`, `abstract-machine/`
Kernel	Linux v6.18.22 prebuilt by default; v6.12/v6.18 paths tested	`linux/`, see linux_kernel.md
Firmware	OpenSBI (v1.8.1)	`linux/opensbi/`
Bootrom	NPC / raptSoC reset vector	`nemu/src/memory/rom/`

NPC Memory Map

npc_soc peripherals and address ranges:

Device	Range
Finisher	`0x0010_0000 – 0x0010_0fff`
CLINT	`0x0200_0000 – 0x020b_ffff`
PLIC	`0x0c00_0000 – 0x0cff_ffff`
UART / peripherals	`0x1000_0000 – 0x1001_1fff`
MROM	`0x2000_0000 – 0x2000_ffff`
Flash	`0x3000_0000 – 0x3fff_ffff`
PMEM / PSRAM	`0x8000_0000 – 0x8fff_ffff`

Reset vector PC_INIT = 0x2000_0000 (MROM).

raptSoC Memory Map

Device	Range
Finisher	`0x0010_0000 – 0x0010_0fff`
CLINT	`0x0200_0000 – 0x020b_ffff`
PLIC	`0x0c00_0000 – 0x0cff_ffff`
SRAM	`0x0f00_0000 – 0x0f00_ffff`
UART 16550	`0x1000_0000 – 0x1000_0fff`
SPI master	`0x1000_1000 – 0x1000_1fff`
GPIO	`0x1000_2000 – 0x1000_200f`
Legacy ysyx CLINT	`0x1001_1000 – 0x1001_1fff`
MROM	`0x2000_0000 – 0x2000_ffff`
VGA	`0x2100_0000 – 0x211f_ffff`
QEMU SDHCI ECAM	`0x3000_8000 – 0x3000_8fff`
Flash	`0x3000_0000 – 0x3fff_ffff`
QEMU SDHCI	`0x4000_0000 – 0x4000_00ff`
PMEM / PSRAM	`0x8000_0000 – 0x8fff_ffff`
SDRAM	`0xa000_0000 – 0xa1ff_ffff`
raptSoC MMIO	`0xc000_0000 – 0xffff_ffff`

Reset vector PC_INIT = 0x3000_0000 (Flash). A First-Stage / Second-Stage Bootloader (FSBL/SSBL) copies the program into SRAM before running it — see trm.c.

Reference Device Trees

Spike

Source: riscv-isa-sim/riscv/platform.h

#define DEFAULT_RSTVEC     0x00001000
#define DEFAULT_ISA        "rv64imafdc_zicntr_zihpm"
#define DEFAULT_PRIV       "MSU"
#define CLINT_BASE         0x02000000
#define CLINT_SIZE         0x000c0000
#define PLIC_BASE          0x0c000000
#define PLIC_SIZE          0x01000000
#define NS16550_BASE       0x10000000
#define NS16550_SIZE       0x100
#define DRAM_BASE          0x80000000

QEMU (`virt`)

Source: hw/riscv/virt.c

[VIRT_CLINT]  = { 0x02000000, 0x00010000 },
[VIRT_PLIC]   = { 0x0c000000, VIRT_PLIC_SIZE(...) },
[VIRT_UART0]  = { 0x10000000, 0x00000100 },
[VIRT_FLASH]  = { 0x20000000, 0x04000000 },
[VIRT_DRAM]   = { 0x80000000, 0x00000000 },

NJU-ProjectN/NEMU — reference ISS.
NJU-ProjectN/abstract-machine — AM runtime.
riscv-software-src/opensbi — SBI firmware.
enjoy-digital/litex — FPGA SoC framework.
OpenXiangShan/XiangShan — inspirational reference.