Skip to content
/ rj32 Public

A 16-bit RISC CPU with 32 instructions built with Digital for running on an FPGA.

License

Notifications You must be signed in to change notification settings

rj45/rj32

Repository files navigation

rj32

A 16-bit RISC CPU with 32 instructions built with Digital.

Description

This is a CPU built from scratch in a visual way using a digital circuit simulator called Digital. This is then able to be exported to verilog or VHDL and that can be converted into a digital circuit that can run on an FPGA.

I have built a couple CPUs before, but this time I decided to record it as a youtube series. I start out being a bit of a youtube n00b, but the quality hopefully gets better as the series goes on.

Introduction Video - Building a CPU From Scratch

Graphics Hardware

There is also a video display circuit designed to work with DVI over HDMI with a PMOD.

The circuit is a retro Video Display Processor (VDP), sometimes also known as a Video Display Unit (VDU), or Picture Processing Unit (PPU). It's designed to work similarily to a late 80s graphics system like in the Commodore 64 / Amiga, or the various Nintendo or Sega consoles of that era.

I am currently in the process of rebuilding this to be sprite based and more generally useful. The previous version was hard coded to just display the CPU front panel.

Status

The CPU has a complete set of arithmetic and logic instructions, and can execute most programs.

There is a Go compiler (see NanoGo project!) which can compile to rj32.

Main missing features:

  • Extended immediates (for large constants)
  • Byte load/store
  • Fix a bug in load/store
  • Standard memory bus interface (wishbone?)
  • [x]
  • Jump to register needs proper implementation

Building and Running

For the simulation, open dig/frontpanel.dig in Digital.

For the verilog version, see the HDL documentation.

FuseSOC

There is a new fusesoc folder with fusesoc core files that can be used to import the VDP and rj32 processor to be used in your own projects. It's also slated to replace the existing hdl build system. Work is in progress.

Design

A minimal instruction set computer with exactly 32 instructions.

Currently it is a RISC instruction set with a Harvard memory architecture. In other words, data memory is accessed only through load/store instructions, and data memory is separate from program memory. Program memory can only be used to execute code.

There is currently two pipeline stages: fetch and execute. In the first stage the instruction is fetched from program memory. In the second stage the instruction is decoded, has its operands loaded from the register file, executed, then the result written.

Currently the CPU is designed to run on ice40 FPGAs using the open source toolchain.

Instruction Set

Instruction Set Documentation.

Architecture

Architecture Diagram

Contributing

Contributions are welcome!

  • Please follow the existing style and implement as much as possible in the Digital simulation rather than verilog.
  • Fork and submit a PR, please update any documentation and tests and explain exactly what you changed (preferably with screenshots) in the PR description.
  • I will be showing all contributions in youtube videos showing what you changed. I will give you credit.
  • I reserve the right to reject any changes that take the processor in a different direction than I want it to go
  • Changes I would like to make are listed in the issues. If I haven't begun working on something, feel free to take it up.
  • If no issues looks interesting, feel free to submit an issue for something you'd like to do, and I can approve it.
  • Feel free to submit PRs without an issue or approval if you don't mind me deciding not to accept it.

Contributors

  • rj45
  • advice from BigEd, joanlluch, oldben, robfinch, robinsonb5, DiTBho, MichaelM on AnyCPU

License

This project is licensed under the MIT License - see the LICENSE file for details.

NOTE: The youtube videos do not fall under this license. They are under the standard youtube copyright, and I ask you not re-publish them elsewhere. You can create your own youtube videos with the content in this repo, however.

Acknowledgments