Skip to content

Commit

Permalink
Deploying to gh-pages from @ f1cd361 🚀
Browse files Browse the repository at this point in the history
  • Loading branch information
jakubcabal committed Nov 6, 2024
1 parent ec75301 commit 207e95b
Show file tree
Hide file tree
Showing 210 changed files with 1,231 additions and 208 deletions.
1 change: 1 addition & 0 deletions devel/_sources/index.rst.txt
Original file line number Diff line number Diff line change
Expand Up @@ -107,6 +107,7 @@ support a subset of these cards. A complete list of supported FPGA cards can be
ndk_cards/amd/vcu118/readme
extra/nfb-200g2ql/readme
ndk_cards/prodesign/pd-falcon/readme
ndk_cards/terasic/a2700/readme

--------

Expand Down
66 changes: 66 additions & 0 deletions devel/_sources/ndk_cards/terasic/a2700/readme.rst.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
.. _card_terasic-a2700:

Terasic A2700
----------------

- Card information:
- Vendor: Terasic
- Name: Mercury A2700 Accelerator Card
- Ethernet ports: 2x QSFP-DD
- 400G
- up to 200G (200/100/40/25/10) - Unsupported
- PCIe conectors: Edge connector
- `FPGA Card Website <https://www.terasic.com.tw/cgi-bin/page/archive.pl?Language=English&CategoryNo=142&No=1300&PartNo=1#contents>`_
- FPGA specification:
- FPGA part number: ``AGIB027R29A1E2VB``
- Ethernet Hard IP: F-Tile (up to 400G Ethernet)
- PCIe Hard IP: R-Tile (up to PCIe Gen5 x16)
- Four DDR4 SO-DIMM Socket
- One shared with HPS

NDK firmware support
^^^^^^^^^^^^^^^^^^^^

- Ethernet cores that are supported in the NDK firmware:
- :ref:`F-Tile in the Network Module <ndk_intel_net_mod>`
- PCIe cores that are supported in the NDK firmware:
- :ref:`R-Tile in the PCIe Module <ndk_intel_pcie_mod>`
- Makefile targets for building the NDK firmware (valid for NDK-APP-Minimal, may vary for other apps):
- Use ``make 400g1`` command for firmware with 1x400GE (default).
- Support for booting the NDK firmware using the nfb-boot tool:
- TODO

.. note::

To build the NDK firmware for this card, you must have the Intel Quartus Prime Pro installed, including a valid license.
Design requires enabled bifurcation (x8x8) on target machine

Boot instructions (initial)
^^^^^^^^^^^^^^^^^^^^^^^^^^^
Supported boot is handled by the Secure Device Manager (SDM), which has its own 1Gb flash to store Factory and User defined image.
To enable this method, it is necessary to set the switches on the board as follows:
- Ensure that the MSEL[2:0] switch on the board is set to 'Active Serial Normal' mode - MSEL[2:0] = 3'b011
- Set SW4 to 2'b01 and SW5 to 2'b10.
- The SW4(1) set to 0 to load user image or to 1 to load factory image after power up.
- For more detailed description refer to `Mercury A2700 User Manual <https://www.terasic.com.tw/cgi-bin/page/archive_download.pl?Language=English&No=1300&FID=96d539627a1f37a9b6386bd0571f7e3f>`_

Before you can use the nfb-boot tool, you must write the initial NDK firmware to flash memory using a regular JTAG programmer.
It is possible to use Micro-USB port marked as 'USB/UART' on the Terasic card for this purpose.

- Build your application calling ``make`` in the build folder with 'Makefile'.
- After the NDK firmware build is complete, you will have a bitstream file called ``my_bitstream.sof``.
- Use the ``NDK-APP_root_directory/ndk_fpga/cards/terasic/a2700/scripts/generate_jic.sh my_bitstream.sof my_bitstream.sof`` command to convert the two bitstream files to .jic format for flash memory.
- This creates a flash image and sets address spaces in the flash to hold the factory and user images.
- On the host PC where the card is connected, write the .jic bitstream to the flash memory with the command ``<NDK-APP_root_directory/ndk_fpga/cards/terasic/a2700/scripts/write_jic.sh my_bitstream.jic``.
- You must power off and on the PC to power cycle it completely. Only then is the new NDK firmware loaded into the FPGA. (Do not simply reboot, otherwise the factory design will still be loaded on the FPGA.)

Check that the procedure was successful by running ``nfb-boot -l``. This command should list the recovery and application slots in the boot flash.
Reboot/New Configuration of the FPGA is performed by calling ``nfb-boot -F0`` or ``nfb-boot -F1``.
Loading new design to the boot flash is performed by calling ``nfb-boot -f0 your_design.nfw``. (This may take up to 30 minutes)

.. note::

- Make sure SW2 (next to the power connector) is set to 'ON' position
- In the 'ON' position, the switch is switched to the connector (It is not by default)
- This procedure requires the Intel Quartus to be installed and the PC must also be connected to the card using an USB cable (JTAG).
- Loading the .jic bitstream into the flash can take up to 30 minutes.
3 changes: 2 additions & 1 deletion devel/app-minimal.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -733,7 +734,7 @@ <h2>The application MI offsets<a class="headerlink" href="#the-application-mi-of
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/async.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -602,7 +603,7 @@ <h2>References<a class="headerlink" href="#references" title="Link to this headi
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/base.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -600,7 +601,7 @@ <h1>Basic Tools<a class="headerlink" href="#basic-tools" title="Link to this hea
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/dsp/dsp_comparator/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -703,7 +704,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/fifo/asfifox/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -778,7 +779,7 @@ <h2>Block diagram<a class="headerlink" href="#block-diagram" title="Link to this
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/fifo/fifox/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -804,7 +805,7 @@ <h2>Verification block diagram<a class="headerlink" href="#verification-block-di
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/fifo/fifox_multi/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -775,7 +776,7 @@ <h2>Read interface behavior<a class="headerlink" href="#read-interface-behavior"
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/fifo/reg_fifo/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -662,7 +663,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/logic/barrel_shifter/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -772,7 +773,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/logic/cnt_multi_memx/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -711,7 +712,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/logic/h3hash/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -700,7 +701,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/logic/n_loop_op/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -716,7 +717,7 @@ <h3>Quick reset<a class="headerlink" href="#quick-reset" title="Link to this hea
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/logic/sr_sync_latch/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -663,7 +664,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/mem/lvt_mem/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -700,7 +701,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/mem/mem_clear/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -653,7 +654,7 @@ <h2>Instance template<a class="headerlink" href="#instance-template" title="Link
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
3 changes: 2 additions & 1 deletion devel/comp/base/mem/mp_bram/readme.html
Original file line number Diff line number Diff line change
Expand Up @@ -480,6 +480,7 @@
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
</ul>

</div>
Expand Down Expand Up @@ -763,7 +764,7 @@
</div>
<div class="right-details">
<div style="font-size: var(--font-size--small)">
Git branch: devel<br>Git hash: c761b80f
Git branch: devel<br>Git hash: f1cd361c
</div>

</div>
Expand Down
Loading

0 comments on commit 207e95b

Please sign in to comment.