FPGA loader

On this page, you will find all the informations needed to use the Linux FPGA loader driver. This driver allows you to load the FPGA of your APF board from Linux userspace/shell (ie FPGA reprogrammation after Linux boot).

Driver installation

Driver is installed in default Armadeus rootfs.

For the hackers, code is located in target/linux/modules/fpga/dev_tools/fpga_devtools/.

Driver usage

 # modprobe fpgaloader
 fpgaloader v0.9

• The FPGA loader driver is usable through the standard Linux filesystem interface. To read the available configuration, do:

# cat /proc/driver/fpga/loader
spartan slave serial        <<-- on APF9328
spartan slave parallel      <<-- on APF27, APF51

• To upload a new firmware, use the small helper script that can do all the job for you (load driver and then firmware). Just call it with the bitfile as parameter. For example:

 # load_fpga bramtest_top_apf.bin

• You can find some ready to use bitfiles in firmware/leds/blinking_led/bin/ (blinking LED).

Note: On apf9328_devfull and on apf27_dev a LED is already soldered on fpga. For apf27_dev the fpga bank1 must be powered with 3.3V (connect pin 39 and pin 1 on J20 header)

Troubleshots

APF27

• If the dd is executed just after the modprobe an error may occur (no space left on device). This can be avoid with this small script:

 modprobe fpgaloader
 while [ ! -c /dev/fpgaloader ]; do
     usleep 1000
 done
 dd if=bramtest_top_apf.bin of=/dev/fpgaloader

APF51

• do not use a file stored in flash to load the FPGA. Please copy it to the RAM (/tmp) before.
• Use binary format .bin, bitstream format .bit doesn't work.

All the troubleshots are handled by the /usr/bin/load_fpga utility, mentionned above.