FPGA loader: Difference between revisions

From ArmadeusWiki
Jump to navigationJump to search
JulienB (talk | contribs)
mNo edit summary
FabienM (talk | contribs)
 
(22 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Category: FPGA]]
On this page, you will find all the informations needed to use the Linux FPGA loader driver.
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).
This driver allows you to load the FPGA of your APF board from Linux userspace/shell (ie FPGA reprogrammation after Linux boot).
Line 5: Line 7:
Driver is installed in default Armadeus rootfs.
Driver is installed in default Armadeus rootfs.


In the Host directory ''target/linux/modules/fpga/dev_tools/fpga_devtools/'' you will find a script named ''fpgaloader.sh''.  
For the hackers, code is located in ''target/linux/modules/fpga/dev_tools/fpga_devtools/''.
 
== Driver usage ==


Copy this script on the target and launch it:
*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 (.rbf for APF6SP and .bin for the other boards) as parameter. For example:
<pre class="apf">
<pre class="apf">
  # sh fpgaloader.sh
  # load_fpga bramtest_top_apf.bin
</pre>
</pre>
This will load (=modprobe) the driver.


===Remark===
* For APF6_SP a periph.rbf must be [[Target_Software_Installation#APF6_SP | loaded in U-Boot]] before, the core.rbf can then be loaded under linux with load_fpga:
The default FPGA version is the Spartan3 200k.  
The version can be changed when loading the module:
<pre class="apf">
<pre class="apf">
  # modprobe fpgaloader fpga_descriptor=0    (for a 200K)
  # load_fpga firmware.core.rbf
</pre>
and:
<pre class="apf">
# modprobe fpgaloader fpga_descriptor=1    (for a 400k)
</pre>
</pre>
* [[Simple_blinking_LED |  You can find some ready to use bitfiles in ''firmware/leds/blinking_led/bin/'' (blinking LED).]]
{{Note| On '''APF6_SP''' the command load_fpga work only throught PCIe, see [[PCIe fpga load]] to know how it works}}


These informations are given by the ''/proc'' interface.
==Troubleshots==
=== APF51 ===
* Use binary format '''.bin''', bitstream format '''.bit''' doesn't work.


== Driver usage ==
All the troubleshots are handled by the ''/usr/bin/load_fpga'' utility, mentionned above.
*The FPGA loader driver is usable through the standard Linux filesystem interface. To read the available configurations, do:
<pre class="apf">
# cat /proc/driver/fpga/loader
</pre>
*The displayed sizes correspond to the different FPGA versions supported by the board:
** 130k: Spartan 200k
** 212k: Spartan 400k


*To upload a new firmware (here ''bramtest_top_apf.bin''), use:
[[Category:FPGA]]
<pre class="apf">
# dd if=bramtest_top_apf.bin of=/dev/fpga/fpgaloader
</pre>

Latest revision as of 07:41, 27 August 2015


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

  • 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 (.rbf for APF6SP and .bin for the other boards) as parameter. For example:
 # load_fpga bramtest_top_apf.bin
  • For APF6_SP a periph.rbf must be loaded in U-Boot before, the core.rbf can then be loaded under linux with load_fpga:
 # load_fpga firmware.core.rbf
Note Note: On APF6_SP the command load_fpga work only throught PCIe, see PCIe fpga load to know how it works


Troubleshots

APF51

  • Use binary format .bin, bitstream format .bit doesn't work.

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