FuseSoC

From ArmadeusWiki
Jump to: navigation, search


Page under construction... Construction.png Informations on this page are not guaranteed !!


Introduction

FuseSoC is a package manager written in python and used to assemble different HDL design from libraries together. FuseSoC is like Buildroot or Yocto used for Linux, it's just a «Makefile» that launch different tools to build the system.

Install fusesoc

  • Fusesoc is a python3 package that can be installed with pip :
$ python3 -m pip install fusesoc
  • To be up to date use --upgrade option:
$ python3 -m pip install --upgrade fusesoc
  • Once installed a command named fusesoc is available on system :
$ fusesoc --version
1.11.0
  • Initialize library:
$ cd workspace
$ fusesoc init

Blinky

Blinky is a project that aim do blink all FPGA board with a gateware constructed from fusesoc tool.

Here the way to blink Armadeus board with blinky.

First, git clone the blinky project:

$ cd workspace
$ fusesoc library add --sync-type git blinky https://github.com/fusesoc/blinky

APF27

$ fusesoc run --target=apf27 fusesoc:utils:blinky
  • As we don't configure fpga with impact, the build will finish with an error :
ERROR: Failed to run fusesoc:utils:blinky:1.0 : 'impact' exited with an error code
  • But the bitstream will be generated in :
./build/fusesoc_utils_blinky_1.0/apf27-ise/blinky.bit
  • To configure the FPGA, copy it under your /tftpboot/ directory then download it with U-Boot:
cp ./build/fusesoc_utils_blinky_1.0/apf27-ise/blinky.bit /tftpboot/
  • Under U-Boot
BIOS> tftpboot blinky.bit
BIOS> fpga load 0 ${loadaddr} ${filesize}
  • Admire the flashing LED

APF51

$ fusesoc run --target=apf51 fusesoc:utils:blinky
  • As we don't configure fpga with impact, the build will finish with an error :
ERROR: Failed to run fusesoc:utils:blinky:1.0 : 'impact' exited with an error code
  • But the bitstream will be generated in :
./build/fusesoc_utils_blinky_1.0/apf51-ise/blinky.bin
  • To configure the FPGA, copy it under your /tftpboot/ directory then download it with U-Boot:
cp ./build/fusesoc_utils_blinky_1.0/apf51-ise/blinky.bin /tftpboot/
  • Under U-Boot
BIOS> tftpboot blinky.bin
BIOS> fpga load 0 ${loadaddr} ${filesize}
  • Admire the flashing LED

OPOS6UL_SP

  • If you have ISE installed correctly, you can synthesize blinky with following command:
$ fusesoc run --target=op6sp fusesoc:utils:blinky
  • As we don't configure fpga with impact, the build will finish with an error :
ERROR: Failed to run fusesoc:utils:blinky:1.0 : 'impact' exited with an error code
  • But the bitstream will be generated in :
./build/fusesoc_utils_blinky_1.0/op6sp-ise/blinky.bit
  • To configure the FPGA, copy it under your /tftpboot/ directory then download it with U-Boot:
cp ./build/fusesoc_utils_blinky_1.0/op6sp-ise/blinky.bit /tftpboot/
  • Under U-Boot
BIOS> tftpboot blinky.bit
BIOS> fpga load 0 ${loadaddr} ${filesize}
  • Admire the flashing LED : Fix the configuration bug.

Ressources