Introduction
This introduction into the Digilient Arty A7 (35T and 100T) FPGA Evaluation Kit walks through implementing SiFive’s FE310 RISC-V on Xilinx Artix-7 FPGA’s. Topics include connecting a JTAG, installing Vivado, building the FE310 bitsream, programming the on-board configuration memory, and running example FE310 projects.
Hardware Requirements
Compatible Base Boards
- Artix-7 35T Arty FPGA Evaluation Kit at Digi-Key
- Artix-7 100T Arty FPGA Evaluation Kit at Digi-Key
Accessories
- Olimex ARM-USB-TINY-H Debugger at Digi-Key
- Adafruit Jumper Wire at Digi-Key
| Arty A7-35T | Arty A7-100T | |
|---|---|---|
| FPGA part | XC7A35TICSG324-1L | XC7A100TCSG324-1 |
| 1 MSPS On-chip ADC | Yes | Yes |
| Logic Cells | 33,280 | 101,440 |
| Logic Slices | 5,200 | 15,850 |
| Flip-flops | 29,200 | 65,200 |
| Block RAM (Kbits) | 1,800 | 4,860 |
| DSP Slices | 90 | 240 |
| Clock Management Tiles | 5 | 6 |
| GTP 6.6Gb/s Transceivers | 4 | 8 |
| I/O Pins | 250 | 300 |
Vendor Documentation
- Xilinx - Artix-7 FPGA: Artix 7 FPGA Family
- Xilinx - Vivado Design Suite: Vivado Overview
- Digilent - Arty A7: Artix7 FPGA Development Board for Makers and Hobbyists: Artix-7 FPGA Development Board - Digilent Arty A7 - Xilinx
Hardware Setup
Arty Board JD Header
| TDO | TDI |
|---|---|
| nTRST | TMS |
| TCK | nRST |
| 7 | 8 |
| GND | GND |
| VREF | VREF |
Olimex ARM-USB-TINY-H
| VREF | VREF |
|---|---|
| nTRST | 4 |
| TDI | 6 |
| TMS | 8 |
| TCK | 10 |
| 11 | 12 |
| TDO | GND |
| nRST | GND |
| 17 | 18 |
| 19 | 20 |
Software
Install Vivado 2017.01
This project requires Vivado Design Suite 2017.01, download the WebPACK Edition
/opt/Digilent/
sudo chmod +x Xilinx_Vivado_SDK_2017.1_0415_1_Lin64.bin
./Xilinx_Vivado_SDK_2017.1_0415_1_Lin64.bin
- Select the Vivado HL WebPACK option:
- Make sure the 7 Series (Artix-7) is selected:
- Install to the Common Build Directory for this project: (/opt/Digilent/Xilinx)
- Summary
Install Digilent system board files for Vivado
Download the Digilent repository that contains system board files for Vivado. Once downloaded these can been be copied to the Vivado board_files directory.
/opt/Digilent/
git clone https://github.com/Digilent/vivado-boards
cp -rv ./vivado-boards/new/board_files/* /opt/Digilent/Xilinx/Vivado/2017.1/data/boards/board_files/
Install prebuilt RISC-V Toolchain
Download GNU Embedded Toolchain and OpenOCD from: SiFive Boards - The best way to Develop RISC-V Software.
/opt/Digilent/
wget -c https://static.dev.sifive.com/dev-tools/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14.tar.gz
wget -c https://static.dev.sifive.com/dev-tools/riscv-openocd-0.10.0-2019.08.2-x86_64-linux-ubuntu14.tar.gz
Extract GNU Embedded Toolchain and OpenOCD
/opt/Digilent/
tar xf riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14.tar.gz
tar xf riscv-openocd-0.10.0-2019.08.2-x86_64-linux-ubuntu14.tar.gz
Double Check that GCC and OpenOCD work on your system
/opt/Digilent/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14/bin/riscv64-unknown-elf-gcc --version
riscv64-unknown-elf-gcc (SiFive GCC 8.3.0-2019.08.0) 8.3.0
Copyright (C) 2018 Free Software Foundation, Inc.
This is free software; see the source for copying conditions. There is NO
warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
/opt/Digilent/riscv-openocd-0.10.0-2019.08.2-x86_64-linux-ubuntu14/bin/openocd --version
Open On-Chip Debugger 0.10.0+dev (SiFive OpenOCD 0.10.0-2019.08.2)
Licensed under GNU GPL v2
For bug reports:
https://github.com/sifive/freedom-tools/issues
Install udev rule for Olimex JTAG
Olimex udev rule:
/etc/udev/rules.d/99-openocd.rules
SUBSYSTEM=="tty", ATTRS{idVendor}=="15ba",ATTRS{idProduct}=="002a", MODE="664", GROUP="plugdev"
SUBSYSTEM=="usb", ATTR{idVendor}=="15ba",ATTR{idProduct}=="002a", MODE="664", GROUP="plugdev"
Install Xilinx udev rules
Xilinx udev rule:
cd /opt/Digilent/Xilinx/Vivado/2017.1/data/xicom/cable_drivers/lin64/install_script/install_drivers/
sudo ./install_drivers
Double check permissions:
ls -lha /dev/ttyUSB0
crw-rw-r--+ 1 root plugdev 188, 0 Feb 8 14:12 /dev/ttyUSB0
Download the SiFive Freedom repository
This repository contains the SiFive RTL for the Freedom E300 and U500 platforms.
/opt/Digilent/
git clone https://github.com/sifive/freedom
cd freedom/
git checkout 943ab4ac2cefbbabdeda9447ec0f6231f6235f1e -b tmp
git submodule sync
git submodule update --recursive --init
Building for the Artix-7 35T or 100T
export RISCV and VIVADO for the project’s Makefile
/opt/Digilent/freedom/
export RISCV=/opt/Digilent/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14
export PATH=/opt/Digilent/Xilinx/Vivado/2017.1/bin:$PATH
Building Artix-7 35T
make BOARD=arty -f Makefile.e300artydevkit clean
make BOARD=arty -f Makefile.e300artydevkit verilog
make BOARD=arty -f Makefile.e300artydevkit mcs
Building Artix-7 100T
make BOARD=arty_a7_100 -f Makefile.e300artydevkit clean
make BOARD=arty_a7_100 -f Makefile.e300artydevkit verilog
make BOARD=arty_a7_100 -f Makefile.e300artydevkit mcs
For Reference, this build is based on:
voodoo@hades:/opt/Digilent/freedom$ git show
commit 943ab4ac2cefbbabdeda9447ec0f6231f6235f1e (HEAD -> master, origin/master, origin/HEAD)
Merge: 5241f55 92ecc01
Author: Erik Danie <43764516+erikdanie@users.noreply.github.com>
Date: Mon Dec 9 09:46:37 2019 -0800
Merge pull request #146 from Tim453/e310_with_e31-core
Changed the Configuration of the E300 Core
Vivado Installing Configuration to Device
Connect both Olimex USB JTAG and ARTY’s J10 USB interface. (J10 is also the default uart on the FE310)
- Open Vivado 2017.1
- Flow → Open Hardware Manager
- Open Target → Auto Connect
- Right Click device → Add Configuration Memory Device
| 35t | 100t | |
|---|---|---|
| Manufacturer | Micron | Spansion |
| Density (Mb) | 128 | 128 |
| Type | spi | spi |
| Width | x1_x2_x4 | x1_x2_x4 |
| Alias | n25q128-3.3v-spi-x1_x2_x4 | s25fl127s-spi-x1_x2_x4 |
Load *.mcs file: /opt/Digilent/freedom/builds/e300artydevkit/obj/E300ArtyDevKitFPGAChip.mcs
The “PROG” button the Arty A7 can be used reload the configuration file onto the Artix-7.
SiFive Freedom E SDK Examples
/opt/Digilent/
git clone https://github.com/sifive/freedom-e-sdk.git
cd freedom-e-sdk/
git checkout ee098cd5cca9efb93f88f58602f8a11e68e14621 -b tmp
git submodule sync
git submodule update --recursive --init
Set RISCV_PATH and RISCV_OPENOCD_PATH
/opt/Digilent/freedom-e-sdk/
export RISCV_PATH=/opt/Digilent/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14
export RISCV_OPENOCD_PATH=/opt/Digilent/riscv-openocd-0.10.0-2019.08.2-x86_64-linux-ubuntu14
For reference, this build is based on:
voodoo@hades:/opt/Digilent/freedom-e-sdk$ git show
commit ee098cd5cca9efb93f88f58602f8a11e68e14621 (HEAD -> v201908-branch, origin/v201908-branch, origin/main, origin/HEAD)
Merge: 0fba42f 4f4bd3d
Author: Nathaniel Graff <nathaniel.graff@sifive.com>
Date: Wed Nov 13 16:38:58 2019 -0800
Merge pull request #413 from sifive/detect-medany-reloc-truncated-1908
[v19.08] Detect "reloc truncated to fit" as medany incompatibility
Example hello
/opt/Digilent/freedom-e-sdk/
make BSP=metal PROGRAM=hello TARGET=freedom-e310-arty clean
make BSP=metal PROGRAM=hello TARGET=freedom-e310-arty software
make BSP=metal PROGRAM=hello TARGET=freedom-e310-arty upload
make BSP=metal PROGRAM=hello TARGET=freedom-e310-arty upload
voodoo@hades:/opt/Digilent/freedom-e-sdk$ make BSP=metal PROGRAM=hello TARGET=freedom-e310-arty upload
scripts/upload --elf /mnt/data/Digilent/freedom-e-sdk/software/hello/debug/hello.elf --openocd /opt/Digilent/riscv-openocd-0.10.0-2019.08.2-x86_64-linux-ubuntu14/bin/openocd --gdb /opt/Digilent/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-ubuntu14/bin/riscv64-unknown-elf-gdb --openocd-config bsp/freedom-e310-arty/openocd.cfg
Open On-Chip Debugger 0.10.0+dev (SiFive OpenOCD 0.10.0-2019.08.2)
Licensed under GNU GPL v2
For bug reports:
https://github.com/sifive/freedom-tools/issues
adapter speed: 10000 kHz
Info : auto-selecting first available session transport "jtag". To override use 'transport select <transport>'.
Info : ftdi: if you experience problems at higher adapter clocks, try the command "ftdi_tdo_sample_edge falling"
Info : clock speed 10000 kHz
Info : JTAG tap: riscv.cpu tap/device found: 0x20000913 (mfg: 0x489 (SiFive Inc), part: 0x0000, ver: 0x2)
Info : datacount=1 progbufsize=16
Info : Disabling abstract command reads from CSRs.
Info : Examined RISC-V core; found 1 harts
Info : hart 0: XLEN=32, misa=0x40001105
Info : Listening on port 3333 for gdb connections
Info : Found flash device 'micron n25q128' (ID 0x0018ba20)
cleared protection for sectors 64 through 255 on flash bank 0
Ready for Remote Connections
Info : Listening on port 6666 for tcl connections
Info : Listening on port 4444 for telnet connections
Info : accepting 'gdb' connection on tcp/3333
0x20404692 in metal_shutdown (code=0) at /mnt/data/Digilent/freedom-e-sdk/freedom-metal/src/shutdown.c:19
19 __asm__ volatile ("nop");
Info : JTAG tap: riscv.cpu tap/device found: 0x20000913 (mfg: 0x489 (SiFive Inc), part: 0x0000, ver: 0x2)
JTAG tap: riscv.cpu tap/device found: 0x20000913 (mfg: 0x489 (SiFive Inc), part: 0x0000, ver: 0x2)
cleared protection for sectors 64 through 255 on flash bank 0
cleared protection for sectors 64 through 255 on flash bank 0
Info : JTAG tap: riscv.cpu tap/device found: 0x20000913 (mfg: 0x489 (SiFive Inc), part: 0x0000, ver: 0x2)
Loading section .init, size 0x194 lma 0x20400000
Loading section .text, size 0x4600 lma 0x20400200
Loading section .rodata, size 0x3c0 lma 0x20404800
Loading section .init_array, size 0x4 lma 0x20404bc0
Loading section .data, size 0x770 lma 0x20404bc8
Info : Padding image section 0 at 0x20400194 with 108 bytes
Info : Padding image section 1 at 0x20404bc4 with 4 bytes
Info : Disabling abstract command writes to CSRs.
Info : JTAG tap: riscv.cpu tap/device found: 0x20000913 (mfg: 0x489 (SiFive Inc), part: 0x0000, ver: 0x2)
Start address 0x20400000, load size 21192
Transfer rate: 27 KB/sec, 3532 bytes/write.
shutdown command invoked
shutdown command invoked
A debugging session is active.
Inferior 1 [Remote target] will be detached.
Quit anyway? (y or n) [answered Y; input not from terminal]
Remote connection closed
voodoo@hades:/opt/Digilent/freedom-e-sdk$ tio /dev/ttyUSB2 -b 57600
[tio 10:56:24] tio v1.32
[tio 10:56:24] Press ctrl-t q to quit
[tio 10:56:24] Connected
Hello, World!
Hello, World!
Comments
Any questions or comments please go to our TechForum: TechForum