Awesome
FPGA Odysseus with ULX3S - Workshop materials
This repo contains all needed material for participation at FPGA Odysseus with ULX3S Workshop at Radiona event in Zagreb 9th of March 2019.
For all environments
You probably already have a favorite text editor on your computer ready, but in case it does not have Verilog language syntax hightlight, that could help you at least at start, install Visual Studio Code or Atom or any similar editor supporting it.
For Visual Studio Code use:
ext install mshr-h.VerilogHDL
For Atom use:
apm install language-verilog
Linux Install
First install required packages.
For Ubuntu use :
sudo apt install python3-pip python3-setuptools make git gtkwave
Download prepared package, and install APIO
cd ~
wget https://github.com/ulx3s/fpga-odysseus/releases/download/v1.0/fpga-tools-linux-x64.tar.gz
tar xvfz fpga-tools-linux-x64.tar.gz
cd fpga_tools
source fpga.sh
cd apio
sudo pip3 install -e .
We also need to add support for programming over FTDI, so just run:
sudo apio drivers --ftdi-enable
To be able to test environment and to have starting point for workshop you also need to download this repository.
cd ~
git clone https://github.com/ulx3s/fpga-odysseus
Windows Install
Download file from this link first.
Uze 7zip (can be downloaded from here) to unpack file (using right click -> 7-Zip -> Extract here )
Move that folder to root of C drive (mandatory due to location being hardcoded in part of msys install)
Go to c:\msys64 and click ConEmu.exe to get console.
Your profile will be generated and you will be greeted by next prompt.
[FPGA] C:\msys64\src>
If you do not already have installed you favorite terminal console for serial access, please install PuTTY or similar. You can even install it from command line by using:
pacman -S mingw-w64-x86_64-putty
Now pull materials for workshop.
git clone https://github.com/ulx3s/fpga-odysseus -c core.symlinks=true
You will get some errors here, due to issues with specific git version on windows, but do not worry, just execute :
cd fpga-odysseus
git reset --hard
Now you have all setup, not need for additional testing on Windows side.
NOTE In case you are getting error starting git on Windows, first run msys but just leave it open at side, and try again in main window:
c:\msys64\msys2.exe
Testing (needed for Linux only)
For Linux always make sure you have tools setup and initialized first.
cd ~/fpga_tools
source fpga.sh
Testing APIO environment
To test if all is setup correctly.
cd ~/fpga_tools/test/led
apio build
response should be
[xxx xxx x hh:mm:ss yyyy] Processing ulx3s-45f
--------------------------------------------------------------------------------
yosys -p "synth_ecp5 -json hardware.json" -q top.v
Warning: Wire top.cnt has an unprocessed 'init' attribute.
nextpnr-ecp5 --45k --package CABGA381 --json hardware.json --textcfg hardware.config --lpf ulx3s_v20.lpf -q --timing-allow-fail
ecppack --db /home/xxx/fpga_tools/apio_data/packages/toolchain-ecp5/share/trellis/database hardware.config hardware.bit
========================= [SUCCESS] Took 1.92 seconds =========================
Testing Risc-V compiler
cd ~/fpga_tools/tests/riscv
make
response should be
riscv64-unknown-elf-gcc -mabi=ilp32 -march=rv32i -Wl,-Bstatic,-T,sections.lds,--strip-debug -ffreestanding -nostdlib -o firmware.elf start.s firmware.c
riscv64-unknown-elf-objcopy -O binary firmware.elf /dev/stdout > firmware.bin
python3 makehex.py firmware.bin 8192 > firmware.hex