SurfOS GitHub
Menu

Our custom RISC-V processor.

SurfCPU already boots SurfOS from microSD on the Arty A7-100T FPGA. We wrote its 32-bit core in Verilog.

Pixel-art illustration of a processor surrounded by circuit traces and gold contacts.

Inside the core

The core, SurfBoot firmware, and SurfOS kernel share a memory map and boot interface.

Read the core design
Instruction set
RV32IM + Zicsr + Zifencei
Core design
Single core, five-stage pipeline
Implementation
Verilog on a Digilent Arty A7-100T
Boot path
SurfBoot ROM, microSD, DDR3L memory
Console
Serial UART and VGA output
Arty A7-100T boot capture
Brandon Burr's SurfOS
Version 1.0 on a RISC-V (SurfCPU on the Arty A7), 2004-2026
SURF ≋#>
Full serial capture

Board test results

In November 2026 tests, SurfOS displayed its shell on VGA and drew a rotating cube. Files on the microSD card survived two power cuts.