Unitate Funtzionala Simulazio Inguruneko Softwarea
Erabiltzailearen Gida

Dokumentu honi buruz

Dokumentu honek nola simulatu deskribatzen duample Azeleragailuen Unitate Funtzionala (AFU) Intel erabiliz
Azeleragailuen Unitate Funtzionala (AFU) Simulazio Ingurunea (ASE) ingurunea. Ikus Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Erabiltzailearen Gidara ASE gaitasunei eta barne arkitekturari buruzko xehetasun zabalak lortzeko.
Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) edozein Intel FPGA Programable® Azelerazio Txartelentzako (Intel FPGA PAC) hardware eta software bateragarrien simulazio ingurunea da. Software-simulazio-ingurune honek Intel FPGA PAC hauek onartzen ditu gaur egun: 10 GX FPGA

• Intel FPGA Azelerazio Txartel Programagarria D5005
• Intel Azelerazio Txartel Programagarria Intel Arria®-rekin
  ASEk Core Cache Interface (CCI-P) protokolorako transakzio-eredu bat eta FPGA erantsitako memoria lokalerako memoria-eredu bat eskaintzen du.
  ASEk Azeleragailuen Unitate Funtzionala (AFU) hurrengo protokolo eta API hauek betetzen dituela ere balioztatzen du:
• CCI-P protokoloaren zehaztapena
• Avalon
  Memoria mapatutako (Avalon-MM) Interfazearen zehaztapena
• Open Programable Acceleration Engine (OPAE)®

1. taula. Azelerazio pila FPGAdun Intel Xeon® CPUrako Glosarioa

Epea	Laburdura	Deskribapena
Intel Acceleration Stack Intel Xeon® CPUrako FPGAekin	Azelerazio pila	Intel FPGA baten eta Intel Xeon prozesadore baten arteko errendimendu optimizatutako konektibitatea eskaintzen duen software, firmware eta tresnen bilduma.
Intel FPGA Azelerazio Txartel Programagarria (Intel FPGA PAC)	Intel FPGA PAC	PCIe* FPGA azeleragailu txartela. PCIe bus baten bidez Intel Xeon prozesadore batekin parekatzen den FPGA Interface Manager (FIM) dauka.
Intel Xeon plataforma eskalagarria FPGA integratua duena	FPGA plataforma integratua	Intel Xeon plus FPGA plataforma Intel Xeon eta FPGA batekin pakete bakarrean eta Ultra Path Interconnect (UPI) bidez memoria-cache koherentea partekatzen du.

Lotutako informazioa
Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Erabiltzailearen gida

Intel Corporation. Eskubide guztiak erreserbatuak. Intel, Intel logotipoa eta beste Intel marka Intel Corporation edo bere filialen marka komertzialak dira. Intel-ek bere FPGA eta erdieroaleen produktuen errendimendua bermatzen du uneko zehaztapenekin, Intel-en berme estandarraren arabera, baina edozein unetan edozein produktu eta zerbitzutan aldaketak egiteko eskubidea gordetzen du jakinarazi gabe. Intel-ek ez du bere gain hartzen hemen deskribatutako edozein informazio, produktu edo zerbitzuren aplikazio edo erabileratik eratorritako erantzukizunik edo erantzukizunik, Intel-ek idatziz berariaz hitzartutakoa izan ezik. Intel-eko bezeroei gomendatzen zaie gailuaren zehaztapenen azken bertsioa eskuratzea argitaratutako edozein informaziotan oinarritu aurretik eta produktu edo zerbitzuen eskaerak egin aurretik.
*Beste izen eta markak beste batzuen jabetza direla erreklamatu daitezke.
ISO 9001:2015 Erregistratua

Sistemaren eskakizunak

Hona hemen Intel Accelerator Functional Unit (AFU) Simulazio Ingurunerako (ASE) sistemaren eskakizunak:

• 64 biteko Linux sistema eragilea. Argitalpen honek sistema eragile hauek balioztatu zituen:
  — Intel FPGA PAC D5005erako:
• RHEL 7.6 Kernel 3.10.0-957rekin
  — Intel PAC-rako Intel Arria 10 GX FPGA-rekin:
• RHEL 7.6 Kernel 3.10.0-957rekin
• Ubuntu 18.04 Kernel 4.15arekin
• Simulagailu hauetako bat:
  — 64 biteko Synopsys* VCS-MX-2016.06-SP2-1 RTL Simulagailua
  — 64 biteko Mentor Graphics* Modelsim SE Simulator (10.5c bertsioa)
  - 64 biteko Mentor Graphics QuestaSim Simulator (10.5c bertsioa)
• C konpilatzailea: GCC 4.7.0 edo berriagoa
• CMake: 2.8.12 bertsioa edo berriagoa
• GNU C Liburutegia: 2.17 bertsioa edo berriagoa
• Python: 2.7 bertsioa
• Intel Quartus® Prime Pro Edition softwarearen 19.2 bertsioa (1)

Ingurumena Konfiguratzea

Zure simulazio-ingurunea konfiguratu eta OPAE softwarea instalatu behar duzu ASE exekutatu aurretik.

1. Ezarri ingurune-aldagai hauek zure simulazio-softwarerako:
   • VCSrako:
   $ esportatu VCS_HOME=
   $ esportatu PATH=$VCS_HOME/bin:$PATH
   VCS instalazio-direktorioaren egitura hau da:
   Ziurtatu zure sistemak baliozko VCS lizentzia duela.
   • Modelsim SE/QuestaSim-erako:
   $ esportatu MTI_HOME=
   $ esportatu PATH=$MTI_HOME/linux_x86_64/:$MTI_HOME/bin/:$PATH
   Modelsim/Questa instalazio-direktorioaren egitura hau da:
   Ziurtatu zure sistemak Modelsim SE/QuestaSim lizentzia baliozkoa duela.
   • Intel Quartus Prime Pro Edition-rako:
   $ esportatu QUARTUS_HOME=
   Intel Quartus Prime instalazio-direktorioaren egitura honakoa da:
   Gehitu ingurune-aldagaia Modelsim lizentzia egiaztatzeko:
   $ esportatu MGLS_LICENSE_FILE=
2. Esportatu:
   $ esportatu LM_LICENSE_FILE=
3.  Atera exekuzio denborako artxiboa file, eta instalatu OPAE liburutegiak, bitarrak, barne files, eta ASE liburutegiak atalean deskribatzen den moduan: OPAE software paketea instalatzea Intel Acceleration Stack Quick Start Erabiltzaile-gida egokian zure Intel FPGA PACrako.

Zure ingurunea behar bezala konfiguratu behar da AFU bat konfiguratzeko eta eraikitzeko. Bereziki, OPAE Software Development Kit (SDK) behar bezala instalatu behar duzu. OPAE SDK scriptek PATH-n egon behar dute eta barne hartu behar dute fileC konpiladorearen eskura egon behar duten liburutegiak eta liburutegiak. Horrez gain, OPAE_PLATFORM_ROOT ingurune-aldagaia ezarrita dagoela ziurtatu behar duzu. Informazio gehiago lortzeko, ikusi OPAE software paketea instalatzea.
OPAE SDK eta ASE behar bezala instalatuta daudela ziurtatzeko, shell batean, berretsi zure PATH-ek afu_sim_setup duela. afu_sim_setup /usr/bin direktorioan edo barruan egon behar du OPAE jatorritik eraiki bazenu files.

Lotutako informazioa

• Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Erabiltzailearen gida
• OPAE software paketea instalatzea
  Intel PAC-rako Intel Arria 10 GX FPGA-rekin.
• Intel FPGA PAC D5005erako OPAE software paketea instalatzea.

Hello_afu simulatzen Bezero-Zerbitzari moduan

Hello_afu example AFU txantiloi sinple bat da, CCI-P interfaze nagusia erakusten duena. RTL-k AFU baten gutxieneko baldintzak betetzen ditu, memorian mapatutako I/O irakurketei erantzuten die gailuaren ezaugarrien goiburua eta AFUren UUID itzultzeko.
1. irudia. hello_afu Directory Zuhaitza

Oharra:
Dokumentu honek erabiltzen duample> adib bati erreferentzia egitekoampdiseinu direktorioa, adibidez, hello_afu goiko irudian.
Softwareak OPAE erabiliz FPGA bati eransteko gutxieneko baldintzak erakusten ditu. RTL-k OPAE gidaria eta hello_afu ex-a asetzeko gutxieneko baldintzak erakusten dituample softwarea.
filelist.txt-ek zehazten du files RTL simulaziorako eta sintesirako.
AFUak behar bezala konfiguratu eta eraikitzekoamples, zure ingurunea behar bezala konfiguratu behar da, Ingurugiroa Konfiguratzen atalean azaltzen den bezala.

Lotutako informazioa

• Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Erabiltzailearen gida
• Ingurumena konfiguratzea 5. orrialdean

AFUak garatzea OPAE SDK-rekin
Azeleragailuen Unitate Funtzionalean (AFU) Garatzaileen Gidan

4.1. Simulazioa Bezero-Zerbitzari moduan

Hurrengo example flow-ek oinarrizko ASE script-ak aurkezten ditu. Adibide guztiak simulatu ditzakezuampASErekin, eth_e2e_e10 eta eth_e2e_e40 izan ezik.
Simulazioak bi software-prozesu behar ditu: prozesu bat RTL simulaziorako eta bigarren prozesu bat konektatutako softwarea exekutatzeko. RTL simulazio-ingurune bat eraikitzeko, exekutatu honako hau $OPAE_PLATFORM_ROOT/hw/s-enamples/hello_afu:
$ afu_sim_setup –iturria hw/rtl/filelist.txt build_sim
Komando honek ASE ingurune bat eraikitzen du build_sim azpidirektorioan.
Simulagailua eraikitzeko eta exekutatzeko:
$ cd build_sim
$ egin
$ egin sim
Simulatzaileak simulaziorako prest dagoela dioen mezua inprimatzen du. ASE_WORKDIR ingurune-aldagaia ezartzeko eskatzen dizun mezu bat ere inprimatzen du.
Ireki beste shell bat softwarearen simulaziorako. OPAE_PLATFORM_ROOT ingurune-aldagaia ezartzea ziurtatu behar duzu.
Softwarea shell berrian eraiki eta exekutatzeko:
$ cd $OPAE_PLATFORM_ROOT
$ esportatu ASE_WORKDIR=$OPAE_PLATFORM_ROOT/hw/samples/hello_afu/build_sim/work
$ cd $OPAE_PLATFORM_ROOT/hw/samples/hello_afu/sw
$ garbitu
$ egin USE_ASE=1
$ ./kaixo_afu

Oharra:
ASE_WORKDIRren bide-izen espezifikoa alda daiteke. Erabili simulagailuaren gonbitak emandako bide-izena.
Softwarea eta simulagailua exekutatu, transakzioak erregistratu eta irteten dira.

4.1.1. Simulazio-erregistroa Files
Simulazio-laneko direktorioak uhin forma, CCI-P transakzioak eta simulazio-erregistroa gordetzen ditu files.
Osatu hurrengo urratsak view uhin formaren datu-basea:

1. Aldatu make sim komandoa exekutatu duzun direktoriora.
2. Mota:
   $ olatu egin
   Make wave komandoak uhin forma deitzen du viewer.

4.1.2. Diseinu Adierazpenak
Honako hauek file eta direktorioek AFU simulazioa definitzen dute:

• $OPAE_PLATFORM_ROOT/hw/samples/ample>/hw/rtl/filelist.txt-ek RTL iturriak zehazten ditu.
• <AFU example> examphello_afu Directory Tree irudian agertzen den fitxategiaren direktorioa.
• filelist.txt-ek SystemVerilog, VHDL eta AFU JavaScript Object Notation (.json) zerrendatzen ditu file.
• AFU .json-ek AFUk behar dituen interfazeak deskribatzen ditu. UUID bat ere barne hartzen du FPGA batera deskargatuta AFU identifikatzeko.
• hw/rtl/hello_afu.json-ek ccip_std_afu goi-mailako interfaze gisa definitzen du afu-top-interface ccip_std_afu gisa ezarriz. ccip_std_afu oinarrizko CCI-P interfazea da, erlojuak, berrezarri eta CCI-P TX eta RX egiturak barne. Adibampbeste interfaze aukera batzuk definitzen dituzte.
• .json file AFU UUID deklaratzen du. OPAE script batek UUIDa sortzen du. RTL-k UUID-a afu_json_info.vh-tik kargatzen du.
• sw/Eginfile afu_json_info.h sortzen du. Softwareak UUID kargatzen du afu_json_info.h-tik.

4.1.3. Bezero-Zerbitzariaren simulazioaren arazoak konpontzea
afu_sim_setup komandoak huts egiten badu, baieztatu hau:

• afu_sim_setup zure BIDEAN dago. afu_sim_setup /usr/bin edo barruan egon behar du OPAE jatorritik eraiki baduzu files.
• Python 2.7 bertsioa edo berriagoa duzu instalatuta.

Simulagailua eraiki eta exekutatu ezin baduzu, baliteke zure RTL simulazio-tresna behar bezala ez instalatzea.
Softwarea eraikitzen eta exekutatzen saiatzen zarenean, "Errorea AFCak zenbatzean" mezua ikusten baduzu, USE_ASE=1 ezarri duzu make komando lerroan. Softwarea FPGA gailu fisiko bat bilatzen ari da. Berreskuratzeko, errepikatu make clean komandoko urratsak.

AFU Adibamples

2. taula.
AFU Adibamples
AFU bakoitzak adibidezample-ek IRAKURRI IRAKURRI zehatza dakar file, deskribapen operatiboa eta diseinua simulatzeko moduari buruzko oharrak emanez. Simulazio-prozesua guztiz ulertzeko, review IRAKURRI file AFU bakoitzean adibidezample.

AFU	Deskribapena
kaixo_mem_afu	hello_mem_afu-k memoria atzitzeko egoera-makina sinple bat eraikitzen duen AFU bat erakusten du. Egoera-makinak hainbat sarbide-eredu egiteko gai da FPGA pinetara zuzenean atxikitako memoria lokalera, hala nola DDR4 DIMMak. Memoria hau CCI-P bidez atzitzen den ostalariaren memoriatik bereizten da. Ostalariak hello_mem_afu kontroladorearen egoera-makina kudeatzen du memorian mapatutako I/O (MMIO) eskaerak erabiliz kontrolatzeko eta egoera erregistroak (CSRs).
kaixo_intr_afu	hello_intr_afu-k aplikazioaren eten funtzioa erakusten du ASEn.
DMA eta f1.1 (2) _	dma_afu-k DMA Oinarrizko Eraikuntza Bloke bat erakusten du FPGAra ostalariarentzat, FPGAra ostalariarentzat eta FPGAra FPGAra memoria transferitzeko. AFU hau simulatzean, DMA transferentziarako erabiltzen den buffer tamaina txikia da simulazio-denbora zentzuzkoa izan dadin. Informazio gehiago lortzeko, jo DMA Azeleragailuaren Unitate Funtzionala (AFU) Erabiltzailearen Gidara.
nlb_mode_O	nlb_mode_O memoria kopiatzeko proba frogatzen duen CCI-P sistema da. $0PAE_PLATFORM_ROOT/ sw/opae—cre/ease zenbakia>/sample/hello_fpga . c nlb_mode_0 barne hartzen du.
	$ sh atzerakada.sh -a -r rtl_sim -s < vcslmodelsimlquesta > [-i ) -b
streaming_dma	streaming_dma-k ostalariaren memoria eta FPGA streaming ataka baten artean datuak nola transferitzen diren erakusten du. Informazio gehiago lortzeko, ikus Streaming DMA Accelerator Unitate Funtzionala (AFU) Erabiltzailearen Gida.
kaixo_afu	hel lo_a fu CCI-P interfaze nagusia erakusten duen AFU sinple bat da. RTL-k AFU baten gutxieneko eskakizunak betetzen ditu, MMIO irakurketei erantzuten die gailuaren ezaugarrien goiburua eta AFUren UUID itzultzeko.

Lotutako informazioa

• DMA Azeleragailuaren Unitate Funtzionala (AFU) Erabiltzailearen Gida
  Intel Arria 10 GX FPGA-rekin dma_afu nola konpilatu eta exekutatu jakiteko.
• Streaming DMA Accelerator Unitate Funtzionala (AFU) Erabiltzailearen Gida
  Zure Intel PAC-n streaming_dma_afu nola konpilatu eta exekutatu jakiteko, Intel Arria 10 GX FPGA-rekin.
• DMA azeleragailuaren unitate funtzionalaren erabiltzailearen gida: Intel FPGA azelerazio-txartel programagarria D5005
  Zure Intel FPGA PAC D5005-n dma_afu nola konpilatu eta exekutatu jakiteko.
• Streaming DMA azeleragailuaren unitate funtzionalaren erabiltzailearen gida: Intel FPGA azelerazio-txartel programagarria D5005
  Zure Intel FPGA PAC D5005-n dma_afu nola konpilatu eta exekutatu jakiteko.

Arazoak konpontzea

Simulazioan ondoko errorea agertzen bada, zuzendu beheko urratsak jarraituz.
Errore-mezua
# [SIM] ASE instantzia bat seguruenik uneko direktorioan exekutatzen ari da!
# [SIM] Egiaztatu PID 28816
# [SIM] Simulazioa irtengo da... SIGKILL bat erabil dezakezu simulazio-prozesua amaitzeko.
# [SIM] Egiaztatu .ase_ready.pid ere file aurrera egin baino lehen kentzen da. Irtenbidea

1. Idatzi kill ase_simv zonbi simulazio-prozesuak hiltzeko eta behin-behineko guztiak kentzeko filehuts egin duten simulazio-prozesuek edo blokeoek atzean utzi dute.
2. Ezabatu .ase_ready.pid file, $ASE_WORKDIR direktorioan aurkitzen da.

ASE Quick Start Erabiltzailearen Gida Artxiboak

Intel Acceleration Stack bertsioa	Erabiltzailearen Gida
2.0	Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Quick Start Erabiltzailearen gida
1.	Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Quick Start Erabiltzailearen gida
1.	Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Quick Start Erabiltzailearen gida
1.0	Intel Accelerator Functional Unit (AFU) Simulation Environment (ASE) Quick Start Erabiltzailearen gida

ASE Quick Start Erabiltzailearen Gidarako Dokumentuen Berrikuspen Historia

Dokumentuaren bertsioa	Intel Acceleration Stack bertsioa	Aldaketak
2020.03.06	1.2.1 eta 2.0.1	Honako hau eguneratu da: • Sistemaren eskakizunak
2019.08.05	2.0	• Intel Quartus Prime Pro Edition bertsioa eguneratu du Sistemaren eskakizunetan. • Hello_afu gehitu da AFU Adibamples. • Erregresio moduan simulatzeari buruzko informazioa kendu da. • Atal berri bat gehitu da: ASE Quick Start Erabiltzailearen Gida Artxiboak.
2018.12.04	1.	Ubuntu euskarria gehitu da.
2018.08.06	1.	Sistemaren eskakizunak, direktorioen egitura eta dagozkionak eguneratu ditu fileizenak.
2018.04.10	1.0	Hasierako kaleratzea.

683200 | 2020.03.06
Bidali Iritzia

Dokumentuak / Baliabideak

intel Azeleragailua Unitate Funtzionala Simulazio Inguruneko Softwarea [pdfErabiltzailearen gida Azeleragailuaren Unitate Funtzionala, Simulazio-inguruneko softwarea, Azeleragailuaren Unitate Funtzionala Simulazio-ingurunea, Softwarea, Azeleragailuaren Unitate Funtzionala Simulatzeko Inguruneko Softwarea

Erreferentziak

• Erabiltzailearen eskuliburua