Functional Unit Simulation Environment Software
Gabay sa Gumagamit

Tungkol sa Dokumentong ito

Inilalarawan ng dokumentong ito kung paano gayahin bilangample Accelerator Functional Unit (AFU) gamit ang Intel
Accelerator Functional Unit (AFU) Simulation Environment (ASE) environment. Sumangguni sa Gabay sa Gumagamit ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) para sa mga kumpletong detalye sa mga kakayahan ng ASE at panloob na arkitektura.
Ang Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) ay isang hardware at software na co-simulation environment para sa anumang Intel FPGA Programmable® Acceleration Card (Intel FPGA PAC). Ang software co-simulation environment na ito ay kasalukuyang sumusuporta sa mga sumusunod na Intel FPGA PACs: 10 GX FPGA

• Intel FPGA Programmable Acceleration Card D5005
• Intel Programmable Acceleration Card na may Intel Arria®
  Ang ASE ay nagbibigay ng transactional model para sa Core Cache Interface (CCI-P) protocol at isang memory model para sa FPGA-attached local memory.
  Pinapatunayan din ng ASE ang pagsunod sa Accelerator Functional Unit (AFU) sa mga sumusunod na protocol at API:
• Ang detalye ng CCI-P protocol
• Ang Avalon
  Memory Mapped (Avalon-MM) Interface Specification
• Ang Open Programmable Acceleration Engine (OPAE)®

Talahanayan 1. Acceleration Stack para sa Intel Xeon® CPU na may FPGAs Glossary

Termino	Pagpapaikli	Paglalarawan
Intel Acceleration Stack para sa Intel Xeon® CPU na may mga FPGA	Acceleration Stack	Isang koleksyon ng software, firmware at mga tool na nagbibigay ng performance-optimized na koneksyon sa pagitan ng isang Intel FPGA at isang Intel Xeon processor.
Intel FPGA Programmable Acceleration Card (Intel FPGA PAC)	Intel FPGA PAC	PCIe* FPGA accelerator card. Naglalaman ng FPGA Interface Manager (FIM) na ipinares sa isang Intel Xeon processor sa isang PCIe bus.
Intel Xeon Scalable Platform na may Integrated FPGA	Pinagsamang FPGA Platform	Intel Xeon plus FPGA platform na may Intel Xeon at isang FPGA sa isang pakete at nagbabahagi ng magkakaugnay na cache ng memorya sa pamamagitan ng Ultra Path Interconnect (UPI).

Kaugnay na Impormasyon
Gabay sa Gumagamit ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).

Intel Corporation. Lahat ng karapatan ay nakalaan. Ang Intel, ang logo ng Intel, at iba pang mga marka ng Intel ay mga trademark ng Intel Corporation o mga subsidiary nito. Ginagarantiyahan ng Intel ang pagganap ng mga produktong FPGA at semiconductor nito sa kasalukuyang mga detalye alinsunod sa karaniwang warranty ng Intel ngunit inilalaan ang karapatang gumawa ng mga pagbabago sa anumang produkto at serbisyo anumang oras nang walang abiso. Walang pananagutan o pananagutan ang Intel na nagmumula sa aplikasyon o paggamit ng anumang impormasyon, produkto, o serbisyong inilarawan dito maliban kung hayagang sinang-ayunan ng Intel. Pinapayuhan ang mga customer ng Intel na kunin ang pinakabagong bersyon ng mga detalye ng device bago umasa sa anumang nai-publish na impormasyon at bago mag-order para sa mga produkto o serbisyo.
*Ang ibang mga pangalan at tatak ay maaaring i-claim bilang pag-aari ng iba.
ISO 9001:2015 Nakarehistro

Mga Kinakailangan sa System

Narito ang mga kinakailangan ng system para sa Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE)::

• Isang 64-bit na operating system ng Linux. Pinatunayan ng release na ito ang mga sumusunod na operating system:
  — Para sa Intel FPGA PAC D5005:
• RHEL 7.6 na may Kernel 3.10.0-957
  — Para sa Intel PAC na may Intel Arria 10 GX FPGA:
• RHEL 7.6 na may Kernel 3.10.0-957
• Ubuntu 18.04 na may Kernel 4.15
• Isa sa mga sumusunod na simulator:
  — 64-bit Synopsys* VCS-MX-2016.06-SP2-1 RTL Simulator
  — 64-bit Mentor Graphics* Modelsim SE Simulator (Bersyon 10.5c)
  — 64-bit Mentor Graphics QuestaSim Simulator (Bersyon 10.5c)
• C compiler: GCC 4.7.0 o mas mataas
• CMake: bersyon 2.8.12 o mas mataas
• GNU C Library: bersyon 2.17 o mas mataas
• Python: bersyon 2.7
• Intel Quartus® Prime Pro Edition software na bersyon 19.2 (1)

Pag-set up ng Kapaligiran

Dapat mong i-set up ang iyong simulation environment at i-install ang OPAE software bago patakbuhin ang ASE.

1. Itakda ang mga sumusunod na environment variable para sa iyong simulation software:
   • Para sa VCS:
   $ export VCS_HOME=
   $ export PATH=$VCS_HOME/bin:$PATH
   Ang istraktura ng direktoryo ng pag-install ng VCS ay ang mga sumusunod:
   Tiyaking may wastong lisensya ng VCS ang iyong system.
   • Para sa Modelsim SE/QuestaSim:
   $ export MTI_HOME=
   $ export PATH=$MTI_HOME/linux_x86_64/:$MTI_HOME/bin/:$PATH
   Ang istraktura ng direktoryo ng pag-install ng Modelsim/Questa ay ang mga sumusunod:
   Tiyaking may wastong lisensya ng Modelsim SE/QuestaSim ang iyong system.
   • Para sa Intel Quartus Prime Pro Edition:
   $ export QUARTUS_HOME=
   Ang istraktura ng direktoryo ng pag-install ng Intel Quartus Prime ay ang mga sumusunod:
   Idagdag ang variable ng kapaligiran upang suriin ang lisensya ng Modelsim:
   $ export MGLS_LICENSE_FILE=
2. I-export:
   $ export LM_LICENSE_FILE=
3.  I-extract ang runtime archive file, at i-install ang mga library ng OPAE, binary, kasama files, at ASE library gaya ng inilarawan sa seksyon: Pag-install ng OPAE Software Package sa naaangkop na Intel Acceleration Stack Quick Start User Guide para sa iyong Intel FPGA PAC.

Ang iyong kapaligiran ay dapat na naka-set up nang tama upang i-configure at bumuo ng isang AFU. Sa partikular, dapat mong i-install nang maayos ang OPAE Software Development Kit (SDK). Ang mga script ng OPAE SDK ay dapat nasa PATH at kasama files at mga aklatan na dapat na magagamit sa C compiler. Bilang karagdagan, dapat mong tiyakin na ang OPAE_PLATFORM_ROOT environment variable ay nakatakda. Sumangguni sa Pag-install ng OPAE Software Package para sa karagdagang impormasyon.
Upang matiyak na ang OPAE SDK at ASE ay maayos na naka-install, sa isang shell, kumpirmahin na ang iyong PATH ay may kasamang afu_sim_setup. Ang afu_sim_setup ay dapat nasa direktoryo ng /usr/bin o sa kung binuo mo ang OPAE mula sa pinagmulan files.

Kaugnay na Impormasyon

• Gabay sa Gumagamit ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).
• Pag-install ng OPAE Software Package
  Para sa Intel PAC na may Intel Arria 10 GX FPGA.
• Pag-install ng OPAE Software Package Para sa Intel FPGA PAC D5005.

Ginagaya ang hello_afu sa Client-Server Mode

Ang hello_afu exampAng le ay isang simpleng template ng AFU na nagpapakita ng pangunahing interface ng CCI-P. Natutugunan ng RTL ang mga minimum na kinakailangan ng isang AFU, na tumutugon sa mga nabasang I/O na naka-memorya upang ibalik ang header ng feature ng device at ang UUID ng AFU.
Larawan 1. hello_afu Directory Tree

Tandaan:
Ang dokumentong ito ay gumagamit ngample> upang sumangguni sa isang exampang direktoryo ng disenyo, tulad ng hello_afu sa figure sa itaas.
Ang software ay nagpapakita ng mga minimum na kinakailangan upang ilakip sa isang FPGA gamit ang OPAE. Ipinapakita ng RTL ang mga minimum na kinakailangan upang matugunan ang driver ng OPAE at ang hello_afu exampang software.
filelist.txt ay tumutukoy sa files para sa RTL simulation at synthesis.
Upang matagumpay na mai-configure at mabuo ang AFU samples, ang iyong kapaligiran ay dapat na naka-set up nang tama, tulad ng inilarawan sa Pag-set Up ng Kapaligiran.

Kaugnay na Impormasyon

• Gabay sa Gumagamit ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).
• Pag-set Up ng Kapaligiran sa pahina 5

Pagbuo ng mga AFU gamit ang OPAE SDK
Sa Gabay ng Developer ng Accelerator Functional Unit (AFU).

4.1. Simulation sa Client-Server Mode

Ang sumusunod na exampAng daloy ay nagpapakilala sa mga pangunahing script ng ASE. Maaari mong gayahin ang lahat ng examples kasama ang ASE, maliban sa eth_e2e_e10 at eth_e2e_e40.
Ang simulation ay nangangailangan ng dalawang proseso ng software: isang proseso para sa RTL simulation at isang pangalawang proseso upang patakbuhin ang konektadong software. Upang bumuo ng isang RTL simulation environment, patakbuhin ang sumusunod sa $OPAE_PLATFORM_ROOT/hw/samples/hello_afu:
$ afu_sim_setup –source hw/rtl/filelist.txt build_sim
Ang utos na ito ay gumagawa ng isang ASE na kapaligiran sa build_sim subdirectory.
Upang buuin at patakbuhin ang simulator:
$ cd build_sim
$ gumawa
$ gumawa ng sim
Ang simulator ay nagpi-print ng isang mensahe na ito ay handa na para sa simulation. Nagpi-print din ito ng mensaheng nag-uudyok sa iyo na itakda ang ASE_WORKDIR environment variable.
Magbukas ng isa pang shell para sa software simulation. Dapat mong tiyakin na itakda ang OPAE_PLATFORM_ROOT environment variable.
Upang buuin at patakbuhin ang software sa bagong shell:
$ cd $OPAE_PLATFORM_ROOT
$ export ASE_WORKDIR=$OPAE_PLATFORM_ROOT/hw/samples/hello_afu/build_sim/work
$ cd $OPAE_PLATFORM_ROOT/hw/samples/hello_afu/sw
$ maglinis
$ gumawa ng USE_ASE=1
$ ./hello_afu

Tandaan:
Maaaring mag-iba ang partikular na pathname para sa ASE_WORKDIR. Gamitin ang pathname na ibinigay ng simulator prompt.
Ang software at simulator ay tumatakbo, mag-log ng mga transaksyon, at lumabas.

4.1.1. Log ng Simulation Files
Iniimbak ng direktoryo ng simulation work ang waveform, mga transaksyon sa CCI-P, at simulation log files.
Kumpletuhin ang mga sumusunod na hakbang sa view ang database ng waveform:

1. Baguhin ang direktoryo kung saan mo pinaandar ang make sim command.
2. Uri:
   $ gumawa ng wave
   Ang make wave command ay nagpapatawag ng waveform vieweh.

4.1.2. Mga Deklarasyon sa Disenyo
Ang mga sumusunod file at tinukoy ng mga direktoryo ang simulation ng AFU:

• $OPAE_PLATFORM_ROOT/hw/samples/ample>/hw/rtl/fileAng list.txt ay tumutukoy sa mga pinagmumulan ng RTL.
• <AFU exampsi le> ang example directory gaya ng ipinapakita sa hello_afu Directory Tree figure.
• filelist.txt lists SystemVerilog, VHDL, at ang AFU JavaScript Object Notation (.json) file.
• Inilalarawan ng AFU .json ang mga interface na kailangan ng AFU. Kasama rin dito ang isang UUID upang matukoy ang AFU kapag na-download na sa isang FPGA.
• Tinutukoy ng hw/rtl/hello_afu.json ang ccip_std_afu bilang ang nangungunang antas ng interface sa pamamagitan ng pagtatakda ng afu-top-interface sa ccip_std_afu. Ang ccip_std_afu ay ang batayang interface ng CCI-P kasama ang mga orasan, pag-reset, at mga istruktura ng CCI-P TX at RX. Mas advanced na examples tukuyin ang iba pang mga pagpipilian sa interface.
• Ang .json file ipinapahayag ang AFU UUID. Binubuo ng OPAE script ang UUID. Nilo-load ng RTL ang UUID mula sa afu_json_info.vh.
• sw/Gumawafile bumubuo ng afu_json_info.h. Nilo-load ng software ang UUID mula sa afu_json_info.h.

4.1.3. Pag-troubleshoot ng Client-Server Simulation
Kung nabigo ang afu_sim_setup command, kumpirmahin na:

• Ang afu_sim_setup ay nasa iyong PATH. Ang afu_sim_setup ay dapat nasa /usr/bin o in kung binuo mo ang OPAE mula sa pinagmulan files.
• Mayroon kang bersyon ng Python 2.7 o mas mataas na naka-install.

Kung hindi mo magawang buuin at maisagawa ang simulator, malamang na hindi mo na-install nang maayos ang iyong RTL simulation tool.
Kapag sinubukan mong buuin at patakbuhin ang software, kung makakita ka ng mensaheng “Error enumerating AFCs,” inalis mo ang pagtatakda ng USE_ASE=1 sa make command line. Ang software ay naghahanap ng isang pisikal na FPGA device. Upang mabawi, ulitin ang mga hakbang mula sa make clean command.

AFU Halamples

Talahanayan 2.
AFU Halamples
Ang bawat AFU exampKasama sa le ang isang detalyadong README file, na nagbibigay ng paglalarawan sa pagpapatakbo at mga tala sa kung paano gayahin ang disenyo. Para sa ganap na pag-unawa sa proseso ng simulation, mulingview ang README file sa bawat AFU example.

AFU	Paglalarawan
hello_mem_afu	hello_mem_afu ay nagpapakita ng isang AFU na bumubuo ng isang simpleng state machine upang ma-access ang memorya. Ang makina ng estado ay may kakayahan ng ilang mga pattern ng pag-access sa lokal na memorya na direktang nakakabit sa mga FPGA pin, tulad ng mga DDR4 DIMM. Ang memorya na ito ay naiiba sa host memory na na-access sa CCI-P. Pinamamahalaan ng host ang hello_mem_afu controller state machine gamit ang memory-mapped I/O (MMIO) na mga kahilingan para makontrol at mga status register (CSRs).
hello_intr_afu	hello_intr_afu ay nagpapakita ng application interrupt feature sa ASE.
DMA at f1.1 (2) _	Ang dma_afu ay nagpapakita ng DMA Basic Building Block para sa host sa FPGA, FPGA sa host, at FPGA sa FPGA memory transfer. Kapag ginagaya ang AFU na ito, ang laki ng buffer na ginamit para sa paglipat ng DMA ay maliit upang mapanatiling makatwiran ang oras ng simulation. Para sa karagdagang impormasyon, sumangguni sa Gabay sa Gumagamit ng DMA Accelerator Functional Unit (AFU).
nlb_mode_O	Ang nlb_mode_O ay isang CCI-P system na nagpapakita ng memory copy test. $0PAE_PLATFORM_ROOT/ sw/opae—cre/ease number>/sample/hello_fpga . c kasama ang nlb_mode_0.
	$ sh regress.sh -a -r rtl_sim -s < vcslmodelsimlquesta > [-i ) -b
streaming_dma	Ang streaming_dma ay nagpapakita kung paano maglipat ng data sa pagitan ng host memory at isang FPGA streaming port. Para sa higit pang impormasyon, sumangguni sa Gabay sa Gumagamit ng Streaming DMA Accelerator Functional Unit (AFU).
hello_afu	hel lo_a fu ay isang simpleng AFU na nagpapakita ng pangunahing interface ng CCI-P. Natutugunan ng RTL ang mga minimum na kinakailangan ng isang AFU, na tumutugon sa MMIO reads upang ibalik ang header ng feature ng device at ang UUID ng AFU.

Kaugnay na Impormasyon

• Gabay sa Gumagamit ng DMA Accelerator Functional Unit (AFU).
  Para sa impormasyon kung paano i-compile at i-execute ang dma_afu sa iyong Intel PAC gamit ang Intel Arria 10 GX FPGA.
• Streaming DMA Accelerator Functional Unit (AFU) User Guide
  Para sa impormasyon kung paano i-compile at isagawa ang streaming_dma_afu sa iyong Intel PAC gamit ang Intel Arria 10 GX FPGA.
• Gabay sa Gumagamit ng Unit ng Paggana ng DMA Accelerator: Intel FPGA Programmable Acceleration Card D5005
  Para sa impormasyon kung paano i-compile at isagawa ang dma_afu sa iyong Intel FPGA PAC D5005.
• Streaming DMA Accelerator Functional Unit Gabay sa Gumagamit: Intel FPGA Programmable Acceleration Card D5005
  Para sa impormasyon kung paano i-compile at isagawa ang dma_afu sa iyong Intel FPGA PAC D5005.

Pag-troubleshoot

Kung lumitaw ang sumusunod na error sa panahon ng simulation, itama ito sa pamamagitan ng pagsunod sa mga hakbang sa ibaba.
Mensahe ng Error
# [SIM] Ang isang ASE instance ay malamang na tumatakbo pa rin sa kasalukuyang direktoryo!
# [SIM] Tingnan ang PID 28816
# [SIM] Lalabas ang simulation... maaari kang gumamit ng SIGKILL para patayin ang proseso ng simulation.
# [SIM] Suriin din kung .ase_ready.pid file ay tinanggal bago magpatuloy. Solusyon

1. I-type ang kill ase_simv upang patayin ang mga proseso ng simulation ng zombie at alisin ang anumang pansamantalang files naiwan ng mga nabigong proseso ng simulation o lock up.
2. Tanggalin ang .ase_ready.pid file, na matatagpuan sa direktoryo ng $ASE_WORKDIR.

ASE Quick Start User Guide Archives

Bersyon ng Intel Acceleration Stack	Gabay sa Gumagamit
2.0	Gabay sa Mabilis na Pagsisimula ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).
1.	Gabay sa Mabilis na Pagsisimula ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).
1.	Gabay sa Mabilis na Pagsisimula ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).
1.0	Gabay sa Mabilis na Pagsisimula ng Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE).

Kasaysayan ng Pagbabago ng Dokumento para sa Gabay sa Gumagamit ng Mabilis na Pagsisimula ng ASE

Bersyon ng Dokumento	Bersyon ng Intel Acceleration Stack	Mga pagbabago
2020.03.06	1.2.1 at 2.0.1	Na-update ang sumusunod: • Mga Kinakailangan sa System
2019.08.05	2.0	• Na-update ang bersyon ng Intel Quartus Prime Pro Edition sa System Requirements. • Idinagdag ang hello_afu sa AFU Halamples. • Inalis ang impormasyon tungkol sa pagtulad sa regression mode. • Nagdagdag ng bagong seksyon: ASE Quick Start User Guide Archives.
2018.12.04	1.	Nagdagdag ng suporta sa Ubuntu.
2018.08.06	1.	Na-update ang mga kinakailangan ng system, istraktura ng direktoryo, at naaayon filemga pangalan.
2018.04.10	1.0	Paunang paglabas.

683200 | 2020.03.06
Magpadala ng Feedback

Mga Dokumento / Mga Mapagkukunan

intel Accelerator Functional Unit Simulation Environment Software [pdf] Gabay sa Gumagamit Accelerator Functional Unit, Simulation Environment Software, Accelerator Functional Unit Simulation Environment, Software, Accelerator Functional Unit Simulation Environment Software

Mga sanggunian

• User Manual