Skip to content

Commit 207e95b

Browse files
committed
Deploying to gh-pages from @ f1cd361 🚀
1 parent ec75301 commit 207e95b

File tree

210 files changed

+1231
-208
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

210 files changed

+1231
-208
lines changed

devel/_sources/index.rst.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -107,6 +107,7 @@ support a subset of these cards. A complete list of supported FPGA cards can be
107107
ndk_cards/amd/vcu118/readme
108108
extra/nfb-200g2ql/readme
109109
ndk_cards/prodesign/pd-falcon/readme
110+
ndk_cards/terasic/a2700/readme
110111

111112
--------
112113

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
.. _card_terasic-a2700:
2+
3+
Terasic A2700
4+
----------------
5+
6+
- Card information:
7+
- Vendor: Terasic
8+
- Name: Mercury A2700 Accelerator Card
9+
- Ethernet ports: 2x QSFP-DD
10+
- 400G
11+
- up to 200G (200/100/40/25/10) - Unsupported
12+
- PCIe conectors: Edge connector
13+
- `FPGA Card Website <https://www.terasic.com.tw/cgi-bin/page/archive.pl?Language=English&CategoryNo=142&No=1300&PartNo=1#contents>`_
14+
- FPGA specification:
15+
- FPGA part number: ``AGIB027R29A1E2VB``
16+
- Ethernet Hard IP: F-Tile (up to 400G Ethernet)
17+
- PCIe Hard IP: R-Tile (up to PCIe Gen5 x16)
18+
- Four DDR4 SO-DIMM Socket
19+
- One shared with HPS
20+
21+
NDK firmware support
22+
^^^^^^^^^^^^^^^^^^^^
23+
24+
- Ethernet cores that are supported in the NDK firmware:
25+
- :ref:`F-Tile in the Network Module <ndk_intel_net_mod>`
26+
- PCIe cores that are supported in the NDK firmware:
27+
- :ref:`R-Tile in the PCIe Module <ndk_intel_pcie_mod>`
28+
- Makefile targets for building the NDK firmware (valid for NDK-APP-Minimal, may vary for other apps):
29+
- Use ``make 400g1`` command for firmware with 1x400GE (default).
30+
- Support for booting the NDK firmware using the nfb-boot tool:
31+
- TODO
32+
33+
.. note::
34+
35+
To build the NDK firmware for this card, you must have the Intel Quartus Prime Pro installed, including a valid license.
36+
Design requires enabled bifurcation (x8x8) on target machine
37+
38+
Boot instructions (initial)
39+
^^^^^^^^^^^^^^^^^^^^^^^^^^^
40+
Supported boot is handled by the Secure Device Manager (SDM), which has its own 1Gb flash to store Factory and User defined image.
41+
To enable this method, it is necessary to set the switches on the board as follows:
42+
- Ensure that the MSEL[2:0] switch on the board is set to 'Active Serial Normal' mode - MSEL[2:0] = 3'b011
43+
- Set SW4 to 2'b01 and SW5 to 2'b10.
44+
- The SW4(1) set to 0 to load user image or to 1 to load factory image after power up.
45+
- 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>`_
46+
47+
Before you can use the nfb-boot tool, you must write the initial NDK firmware to flash memory using a regular JTAG programmer.
48+
It is possible to use Micro-USB port marked as 'USB/UART' on the Terasic card for this purpose.
49+
50+
- Build your application calling ``make`` in the build folder with 'Makefile'.
51+
- After the NDK firmware build is complete, you will have a bitstream file called ``my_bitstream.sof``.
52+
- 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.
53+
- This creates a flash image and sets address spaces in the flash to hold the factory and user images.
54+
- 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``.
55+
- 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.)
56+
57+
Check that the procedure was successful by running ``nfb-boot -l``. This command should list the recovery and application slots in the boot flash.
58+
Reboot/New Configuration of the FPGA is performed by calling ``nfb-boot -F0`` or ``nfb-boot -F1``.
59+
Loading new design to the boot flash is performed by calling ``nfb-boot -f0 your_design.nfw``. (This may take up to 30 minutes)
60+
61+
.. note::
62+
63+
- Make sure SW2 (next to the power connector) is set to 'ON' position
64+
- In the 'ON' position, the switch is switched to the connector (It is not by default)
65+
- This procedure requires the Intel Quartus to be installed and the PC must also be connected to the card using an USB cable (JTAG).
66+
- Loading the .jic bitstream into the flash can take up to 30 minutes.

devel/app-minimal.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -733,7 +734,7 @@ <h2>The application MI offsets<a class="headerlink" href="#the-application-mi-of
733734
</div>
734735
<div class="right-details">
735736
<div style="font-size: var(--font-size--small)">
736-
Git branch: devel<br>Git hash: c761b80f
737+
Git branch: devel<br>Git hash: f1cd361c
737738
</div>
738739

739740
</div>

devel/async.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -602,7 +603,7 @@ <h2>References<a class="headerlink" href="#references" title="Link to this headi
602603
</div>
603604
<div class="right-details">
604605
<div style="font-size: var(--font-size--small)">
605-
Git branch: devel<br>Git hash: c761b80f
606+
Git branch: devel<br>Git hash: f1cd361c
606607
</div>
607608

608609
</div>

devel/base.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

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

606607
</div>

devel/comp/base/dsp/dsp_comparator/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -703,7 +704,7 @@
703704
</div>
704705
<div class="right-details">
705706
<div style="font-size: var(--font-size--small)">
706-
Git branch: devel<br>Git hash: c761b80f
707+
Git branch: devel<br>Git hash: f1cd361c
707708
</div>
708709

709710
</div>

devel/comp/base/fifo/asfifox/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -778,7 +779,7 @@ <h2>Block diagram<a class="headerlink" href="#block-diagram" title="Link to this
778779
</div>
779780
<div class="right-details">
780781
<div style="font-size: var(--font-size--small)">
781-
Git branch: devel<br>Git hash: c761b80f
782+
Git branch: devel<br>Git hash: f1cd361c
782783
</div>
783784

784785
</div>

devel/comp/base/fifo/fifox/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -804,7 +805,7 @@ <h2>Verification block diagram<a class="headerlink" href="#verification-block-di
804805
</div>
805806
<div class="right-details">
806807
<div style="font-size: var(--font-size--small)">
807-
Git branch: devel<br>Git hash: c761b80f
808+
Git branch: devel<br>Git hash: f1cd361c
808809
</div>
809810

810811
</div>

devel/comp/base/fifo/fifox_multi/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -775,7 +776,7 @@ <h2>Read interface behavior<a class="headerlink" href="#read-interface-behavior"
775776
</div>
776777
<div class="right-details">
777778
<div style="font-size: var(--font-size--small)">
778-
Git branch: devel<br>Git hash: c761b80f
779+
Git branch: devel<br>Git hash: f1cd361c
779780
</div>
780781

781782
</div>

devel/comp/base/fifo/reg_fifo/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -662,7 +663,7 @@
662663
</div>
663664
<div class="right-details">
664665
<div style="font-size: var(--font-size--small)">
665-
Git branch: devel<br>Git hash: c761b80f
666+
Git branch: devel<br>Git hash: f1cd361c
666667
</div>
667668

668669
</div>

devel/comp/base/logic/barrel_shifter/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -772,7 +773,7 @@
772773
</div>
773774
<div class="right-details">
774775
<div style="font-size: var(--font-size--small)">
775-
Git branch: devel<br>Git hash: c761b80f
776+
Git branch: devel<br>Git hash: f1cd361c
776777
</div>
777778

778779
</div>

devel/comp/base/logic/cnt_multi_memx/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -711,7 +712,7 @@
711712
</div>
712713
<div class="right-details">
713714
<div style="font-size: var(--font-size--small)">
714-
Git branch: devel<br>Git hash: c761b80f
715+
Git branch: devel<br>Git hash: f1cd361c
715716
</div>
716717

717718
</div>

devel/comp/base/logic/h3hash/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -700,7 +701,7 @@
700701
</div>
701702
<div class="right-details">
702703
<div style="font-size: var(--font-size--small)">
703-
Git branch: devel<br>Git hash: c761b80f
704+
Git branch: devel<br>Git hash: f1cd361c
704705
</div>
705706

706707
</div>

devel/comp/base/logic/n_loop_op/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

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

722723
</div>

devel/comp/base/logic/sr_sync_latch/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -663,7 +664,7 @@
663664
</div>
664665
<div class="right-details">
665666
<div style="font-size: var(--font-size--small)">
666-
Git branch: devel<br>Git hash: c761b80f
667+
Git branch: devel<br>Git hash: f1cd361c
667668
</div>
668669

669670
</div>

devel/comp/base/mem/lvt_mem/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -700,7 +701,7 @@
700701
</div>
701702
<div class="right-details">
702703
<div style="font-size: var(--font-size--small)">
703-
Git branch: devel<br>Git hash: c761b80f
704+
Git branch: devel<br>Git hash: f1cd361c
704705
</div>
705706

706707
</div>

devel/comp/base/mem/mem_clear/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -653,7 +654,7 @@ <h2>Instance template<a class="headerlink" href="#instance-template" title="Link
653654
</div>
654655
<div class="right-details">
655656
<div style="font-size: var(--font-size--small)">
656-
Git branch: devel<br>Git hash: c761b80f
657+
Git branch: devel<br>Git hash: f1cd361c
657658
</div>
658659

659660
</div>

devel/comp/base/mem/mp_bram/readme.html

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -480,6 +480,7 @@
480480
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/alveo-u55c/readme.html">AMD Alveo U55C</a></li>
481481
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/amd/vcu118/readme.html">AMD VCU118@VU9P</a></li>
482482
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/prodesign/pd-falcon/readme.html">PRO DESIGN Falcon</a></li>
483+
<li class="toctree-l1"><a class="reference internal" href="../../../../ndk_cards/terasic/a2700/readme.html">Terasic A2700</a></li>
483484
</ul>
484485

485486
</div>
@@ -763,7 +764,7 @@
763764
</div>
764765
<div class="right-details">
765766
<div style="font-size: var(--font-size--small)">
766-
Git branch: devel<br>Git hash: c761b80f
767+
Git branch: devel<br>Git hash: f1cd361c
767768
</div>
768769

769770
</div>

0 commit comments

Comments
 (0)