Skip to content
This repository has been archived by the owner on Jul 10, 2024. It is now read-only.
/ multizone-fpga Public archive
forked from sifive/freedom

This repository contains the hardware design source files of the Hex Five X300 RISC-V SoC. The X300 is Hex Five's official reference HW platform for its MultiZone Trusted Execution Environment and MultiZone Trusted Firmware. The X300 is an enhanced secure version of the SiFive's Freedom E300 built around the Rocket chip developed at U.C. Berkeley.

License

Notifications You must be signed in to change notification settings

hex-five/multizone-fpga

 
 

Repository files navigation

X300

This repository contains the hardware design source files of the Hex Five X300 RISC-V SoC. The X300 SoC is Hex Five's official reference platform for its MultiZone Security Trusted Execution Environment and MultiZone Security Trusted Firmware. The X300 is an enhanced secure version of the SiFive's Freedom E300 Platform built around the RISC-V Rocket chip originally developed at U.C. Berkeley.

Feature comparison between E300 (not secure) and X300 (secure):

E300 X300
RV32IMAC RV32IMACU - 'U' mode support for TEE
no PMP 8 Physical Memory Protection registers
32.5 MHz clock 65 MHz clock
2 HW breakpoints 8 HW breakpoints
no Ethernet core Xilinx EthernetLite Ethernet 10/100 core
1-way icache 4-way icache
no ITIM 16KB ITIM at 0x08000000
16 KB DTIM 64KB DTIM at 0x80000000
no perf counters 2 perf counters: hpmcounter3 and hpmcounter4
no BTN mappings 3 CLINT sources: BTN0, BTN1, and BTN2

Like the Freedom E300 Arty FPGA Dev Kit, the X300 is designed to work with the Digilent Arty A7 FPGA Evaluation Kit in the 35T or 100T version.

Bootrom & Trusted Firmware

The default bootrom consists of a program that immediately jumps to address 0x20400000, which is 0x400000 bytes into the SPI flash memory on the Arty board. The default bitstream files include no other firmware. A fully functional state-of-the-art trusted firmware stack for this device is available at https://github.com/hex-five/multizone-iot-sdk including pre-built bitstreams for ARTY 35T and ARTY 100T.

Quick Start

Prebuilt bitstream files are provided as release assets ready to download and program (no firmware).

If you don't intend to modify the design of the hardware, you can skip the next sections and jump directly to the Program section.

Requirements

Xilinx Vivado Design Suite

You need the Xilinx Vivado Design Suite to synthesize and/or upload the bistream for the Arty FPGA. You should have received a Xilinx single node license and instructions how to install Vivado with your Arty FPGA Dev Kit. If you are not interested in hardware development and just need to flash the X300 bitstream to run RISC-V firmware, you may prefer the Vivado Lab edition, which is smaller, quicker to download and install, and doesn't require license.

RISC-V Toolchain

To compile the bootloader for the X300, the RISC-V software toolchain must be installed locally and the RISCV environment variable must point to the location of the install. We recommend Hex Five's reference build freely available for download at https://hex-five.com/wp-content/uploads/riscv-openocd-20210618.tar.xz or you can use the one included in the rocket-chip submodule.

wget https://hex-five.com/wp-content/uploads/riscv-gnu-toolchain-20210618.tar.xz
tar -xvf riscv-gnu-toolchain-20210618.tar.xz

Build

Run the following commands to clone repository and submodules:

$ git clone https://github.com/hex-five/multizone-fpga.git
$ cd multizone-fpga
$ git submodule update --init --recursive --jobs 8

Note: you can safely ignore git messages about missing submodules. The only submodule required to build the fpga bitstream is rocket-chip (v1.2-032519-SNAPSHOT~138).

In order to make the mcs target, you need the Vivado executable on your PATH and the RISCV environment variable pointing to your local toolchain. Change these values according to your setup:

export PATH=$PATH:~/Xilinx/Vivado/2021.1/bin
export RISCV=~/riscv-gnu-toolchain-20210618

To build the bitstream, run one of these two scripts according to your target:

$ make -f Makefile.x300arty35devkit mcs

or

$ make -f Makefile.x300arty100devkit mcs

Note: the first run of the build may end prematurely if scala dependencies are not up-to-date. Just reenter the make command above until all scala requirements are met.

These will place the bitstream file X300ArtyDevKitFPGAChip.mcs under builds/x300artyXXXdevkit/obj.

Program

To program the SPI flash with Vivado:

  • Launch Vivado
  • Open Hardware Manager, click the auto-connect icon, and open the target board
  • Right click on the FPGA device and select ”Add Configuration Memory Device”
  • Select Part "s25fl128sxxxxxx0-spi-x1_x2_x4" ("mt25ql128-spi-x1_x2_x4" if you have an old Arty 35T)
  • Click OK to ”Do you want to program the configuration memory device now?”
  • Add X300ArtyA7-35T.mcs or X300ArtyA7-100T.mcs depending on your board
  • Select OK
  • Once the programming completes in Vivado, press the “PROG” Button on the Arty board to load the image into the FPGA

Appendix - GPIO interrupts table

GPIO ARTY CONNECTION CLINT IRQ PLIC IRQ
0 IO8 22
1
2
3
4 IO12 26
5 IO13 27
6
7
8 PMODA [1] 30
9 PMODA [2] 31
10 PMODA [3] 32
11 PMODA [4] 33
12
13
14
15 BTN0 16 37
16
17
18 IO02 40
19
20 IO04 42
21
22
23 IO07 45
24
25
26
27
28
29
30 BTN1 17 52
31 BTN2 18 53

About

This repository contains the hardware design source files of the Hex Five X300 RISC-V SoC. The X300 is Hex Five's official reference HW platform for its MultiZone Trusted Execution Environment and MultiZone Trusted Firmware. The X300 is an enhanced secure version of the SiFive's Freedom E300 built around the Rocket chip developed at U.C. Berkeley.

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • Scala 83.2%
  • Tcl 15.1%
  • Makefile 1.3%
  • Other 0.4%