FPGA loader: Difference between revisions

From ArmadeusWiki
m (beautify)
No edit summary
 
(26 intermediate revisions by 5 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).


== Module compilation & installation==
== Driver installation==
*The first thing you have to do is to activate the driver in the Linux configuration:
Driver is installed in default Armadeus rootfs.
$ make linux26-menuconfig
<pre class="config">
Device Drivers --->
    Armadeus specific drivers --->
        FPGA Drivers  --->
            <M>    Armadeus FPGA configuration driver
</pre>
*rebuild Linux or the complete rootfs
$ make


Once your rootfs reflashed, you will find the new driver in the ''/lib/modules/drivers/...'' subdirectories on your target. If you don't want to reflash the complete rootfs, take a look at [[Linux_drivers_generalities | this page to know how/where to manually copy the driver on your board]].
For the hackers, code is located in ''target/linux/modules/fpga/dev_tools/fpga_devtools/''.


In the Host directory ''target/linux/modules/fpga/dev_tools/fpga_devtools/'' you will find a script named ''fpgaloader.sh''.
== 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:
# sh fpgaloader.sh
This will load (=modprobe) the driver.
 
===Remark===
The default FPGA version is the Spartan3 200k.  
The version can be changed when installing the module:
<pre class="apf">
<pre class="apf">
  # modprobe fpgaloader fpga_descriptor=0    (for a 200K)
  # load_fpga bramtest_top_apf.bin
</pre>
</pre>
and:
or
<pre class="apf">
<pre class="apf">
  # modprobe fpgaloader fpga_descriptor=1    (for a 400k)
  # load_fpga firmware.core.rbf
</pre>
</pre>


These informations are given by the ''/proc'' interface.
* [[Simple_blinking_LED |  You can find some ready to use bitfiles in ''firmware/leds/blinking_led/bin/'' (blinking LED).]]
 


== Driver usage ==
*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 14:03, 3 October 2025


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

or

 # load_fpga firmware.core.rbf