Intel Mailbox Client with Avalon Streaming Interface FPGA IP User Guide

Intel Mailbox Client with Avalon Streaming Interface FPGA IP User Guide

Enhavo kaŝi

1 Leterkesto-Kliento kun Avalon® Streaming Interface Intel FPGA IP Overview

Leterkesto-Kliento kun Avalon® Streaming Interface Intel FPGA IP Overview

La Poŝtkesto-Kliento kun Avalon® fluanta interfaco Intel® FPGA IP (Mailbox Client with Avalon ST Client IP) provizas komunikadkanalon inter via kutima logiko kaj la sekura aparato-administranto (SDM). Vi povas uzi la Leterkesto-Klienton kun Avalon ST IP por sendi komandpakaĵojn kaj ricevi respondpakaĵojn de SDM-periferiaj moduloj. La Leterkesto-Kliento kun Avalon ST IP difinas funkciojn kiujn la SDM funkcias.

Via kutima logiko povas uzi ĉi tiun komunikadkanalon por ricevi informojn kaj aliri fulmmemoron de la sekvaj ekstercentraj moduloj:

La Peceto ID
La Temperatura Sensilo

La Voltage Sensilo
Kvaropa seria periferia interfaco (SPI) fulmmemoro

Notu: Ĉie en ĉi tiu uzantgvidilo, la termino Avalon ST mallongigas la Avalon-fluan interfacon aŭ IP.

Figuro 1. Leterkesto-Kliento kun Avalon ST IP System Design

La sekva figuro montras aplikaĵon, en kiu la Leterkesto-Kliento kun Avalon ST IP legas la Chip-ID.

Figuro 2. Leterkesto-Kliento kun Avalon ST IP Legas Chip ID

Aparato Familia Subteno

La jenaj listigas la aparatajn subtennivelajn difinojn por Intel FPGA IP-oj:

Antaŭa subteno — La IP disponeblas por simulado kaj kompilo por ĉi tiu aparato-familio. Tempmodeloj inkludas komencajn inĝenieristiktaksojn de prokrastoj bazitaj sur fruaj post-enpaĝigaj informoj. La tempigmodeloj estas kondiĉigitaj de ŝanĝoj ĉar siliciotestado plibonigas la korelacion inter la fakta silicio kaj la tempigmodeloj. Vi povas uzi ĉi tiun IP por studado de sistema arkitekturo kaj utiligo de rimedoj, simulado, pinglo, taksado de sistema latenteco, bazaj taksadoj de tempoj (duktobuĝetado), kaj strategio de transigo de I/O (larĝo de datumvoja, profundo de eksplodo, komerco de normoj de I/O). offs).

Antaŭa subteno — La IP estas kontrolita per antaŭtempaj modeloj por ĉi tiu aparato-familio. La IP plenumas ĉiujn funkciajn postulojn, sed eble ankoraŭ estas sperta analizo de tempo por la aparato-familio. Ĝi povas esti uzata en produktaddezajnoj kun singardemo.
Fina subteno — La IP estas kontrolita kun finaj tempomodeloj por ĉi tiu aparato-familio. La IP plenumas ĉiujn funkciajn kaj tempajn postulojn por la aparato-familio kaj povas esti uzata en produktaddezajnoj.

Tabelo 1. Aparato Familia Subteno

Aparato Familio	Subteno
Intel Agilex™	Antaŭen

Notu: Vi ne povas simuli la Leterkestan Klienton kun Avalon Streaming Interface Intel FPGA IP ĉar la IP ricevas la respondojn de la SDM. Por validigi ĉi tiun IP, Intel rekomendas, ke vi faru aparatan taksadon.

Rilataj Informoj
Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP Eldonaj Notoj

Parametroj

Parametro Nomo	Valoro	Priskribo
Ebligu statusan interfacon	Enŝaltita	Kiam vi ebligas ĉi tiun interfacon, la Poŝtkesto-Kliento kun Avalon-flua interfaco Intel FPGA IP inkluzivas la signalon command_status_invalid. Kiam command_status_invalid asertas, vi devas restarigi la IP.

Interfacoj
La sekva figuro ilustras la Leterkestan Klienton kun Avalon Streaming Interface Intel FPGA IP-interfacoj:

Figuro 3. Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP-Interfacoj

Por pliaj informoj pri Avalon-fluaj interfacoj, raportu al la Specifoj de Avalon-Interfaco.
Rilataj Informoj
Specifoj de Avalon-Interfaco

Horloĝo kaj Restarigi Interfacojn

Tablo 2. Horloĝo kaj Restarigi Interfacojn

Signala Nomo	Direkto	Priskribo
in_klk	Enigo	Ĉi tiu estas la horloĝo por la fluaj interfacoj de Avalon. La maksimuma frekvenco en 250 MHz.
en_restarigi	Enigo	Ĉi tio estas aktiva alta restarigo. Aserti in_reset por restarigi la Leterkeston-Klienton kun Avalon-flua interfaco Intel FPGA IP (Mailbox Client with Avalon ST IP). Kiam la signalo in_reset asertas, la SDM devas forĵeti ajnan pritraktatan agadon de la Leterkesto-Kliento kun Avalon ST IP. La SDM daŭre prilaboras komandojn de aliaj klientoj. Por certigi, ke la Leterkesto-Kliento kun Avalon ST IP funkcias ĝuste kiam la aparato eniras uzantan reĝimon, via dezajno devas inkluzivi la Restarigi Release Intel FPGA IP por teni la rekomencigon ĝis la FPGA-ŝtofo eniris uzantan reĝimon. Intel rekomendas uzi rekomencigitan sinkronigilon kiam li konektas la uzantan rekomencigon aŭ eligon de la Restarigi Eldonan IP al
		la rekomencigita haveno de la Leterkesto-Kliento kun Avalon ST IP. Por efektivigi la rekomencigitan sinkronigilon, uzu la Restarigi Bridge Intel FPGA IP disponeblan en la Platformo-Dezajnisto. Notu: Por gvidlinioj pri IP-instatigo kaj konekto en la Platformo-Dezajnisto, raportu al la Bezonataj Komunikado kaj Gastigaj Komponentoj por la Fora Sistemo-Ĝisdatiga Dezajno Eksampla figuro en la Intel Agilex Configuration User Guide.

Komanda Interfaco
Uzu la interfacon Avalon Streaming (Avalon ST) por sendi komandojn al la SDM.

Tablo 3. Komanda Interfaco

Signala Nomo	Direkto	Priskribo
komando_preta	Eligo	La Leterkesto-Kliento kun Avalon ST Intel FPGA IP asertas komandon_preta kiam ĝi estas preta ricevi komandojn de la aplikaĵo. La preta_lateco estas 0 cikloj. La Leterkesto-Kliento kun Avalon ST povas akcepti komand_data[31:0] en la sama ciklo, kiun komando_preta asertas.
komando_valida	Enigo	La signalo komando_valida asertas indiki ke komando_datumoj validas.
komando_datenoj[31:0]	Enigo	La buso command_data veturas komandojn al la SDM. Vidu al Komando Listo kaj Priskribo por difinoj de la komandoj.
komando_startofpacket	Enigo	La komando_startofpacket asertas en la unua ciklo de komandpako.
komando_endofpacket	Enigo	La komando_endofpacket asertas en la lasta ciklo de komando pako.

Figuro 4. Tempigo por Avalon ST Command Packet

Responda Interfaco
La SDM Avalon ST Klienta IP sendas respondojn al via aplikaĵo uzante la respondinterfacon.

Tabelo 4. Responda Interfaco

Signalo 5	Direkto	Priskribo
respondo_preta	Enigo	Aplika logiko povas aserti la signalon response_ready kiam ajn ĝi povas ricevi respondon.
respondo_valida	Eligo	La SDM asertas respond_valid por indiki ke response_data validas.
respondo_datumoj[31:0]	Eligo	La SDM veturas respond_datumojn por provizi la petitajn informojn. La unua vorto de la respondo estas kaplinio, kiu identigas la komandon, kiun la SDM provizas. Riferu al Komando Listo kaj Priskribo por difinoj de la ordonoj.
respondo_startofpacket	Eligo	La respondo_startofpacket asertas en la unua ciklo de respondpako.
respondo_endofpacket	Eligo	La respondo_endofpacket asertas en la lasta ciklo de respondpako.

Figuro 5. Tempo por Avalon ST Response Packet

Komando-Statusa Interfaco

Tabelo 5. Komando-Statusa Interfaco

Signala Nomo	Direkto	Priskribo
komando_stato_nevalida	Eligo	La komando_status_invalid asertas por indiki eraron. Ĉi tiu signalo tipe asertas indiki ke la longo de la komando specifita en la komanda kaplinio ne kongruas kun la longo de la komando sendita. Kiam command_status_invalid asertas, via aplika logiko devas aserti in_reset por rekomenci la Poŝtkestan Klienton kun Avalon-flua interfaco Intel FPGA IP.

Figuro 6. Restarigi Post komand_status_invalid Asertoj

Komandoj kaj Respondoj

La mastro-regilo komunikas kun la SDM uzante komand- kaj respondpakaĵojn per la Mailbox Client Intel FPGA IP.

La unua vorto de la komando- kaj respondpakaĵoj estas kaplinio kiu disponigas bazajn informojn pri la komando aŭ respondo.

Figuro 7. Komando kaj Responda Kapa Formato

Notu: La kampo LENGTH en la komanda kaplinio devas kongrui kun la komanda longo de responda komando.
La sekva tabelo priskribas la kampojn de la kapa komando.

Tabelo 6. Komando kaj Responda Kapa Priskribo

Kapo	Bit	Priskribo
Rezervita	[31:28]	Rezervita.
ID	[27:24]	La komanda ID. La responda kaplinio resendas la ID specifitan en la komanda kaplinio. Vidu al Operaciaj Komandoj por komandaj priskriboj.
0	[23]	Rezervita.
LONGECO	[22:12]	Nombro da vortoj de argumentoj sekvantaj la kaplinion. La IP respondas per eraro se malĝusta nombro da vortoj de argumentoj estas enigita por donita komando. Se estas nekongruo inter la komanda longo specifita en la komanda kaplinio kaj la nombro da vortoj senditaj. La IP levas la biton 3 de la Interrompa Statusa Registro (COMMAND_INVALID) kaj la Leterkesto-Kliento devas esti rekomencigita.
Rezervita	[11]	Rezervita. Devas esti agordita al 0.
Komando Kodo/Erara Kodo	[10:0]	Komando Kodo specifas la komandon. La Erara Kodo indikas ĉu la komando sukcesis aŭ malsukcesis. En la komanda kaplinio, ĉi tiuj bitoj reprezentas komandkodon. En la respondkapo, ĉi tiuj bitoj reprezentas erarkodon. Se la komando sukcesas, la Erara Kodo estas 0. Se la komando malsukcesas, raportu al la erarkodoj difinitaj en la Eraraj Kodaj Respondoj.

Operaciaj Komandoj

Restarigi Quad SPI Flash
Grava: Por Intel Agilex-aparatoj, vi devas konekti la serian fulmon aŭ kvaran SPI-fulmrestarigpinton al la AS_nRST-stifto. La SDM devas plene kontroli la QSPI-restarigon. Ne konektu la kvaran SPI-restarigpinton al iu ekstera gastiganto.

Tabelo 7. Listo de komandoj kaj priskribo

Komando	Kodo (Heks)	Komando Longo (1)	Respondlongo (1)	Priskribo
NOOP	0	0	0	Sendas Bonan statusan respondon.
GET_IDKODE	10	0	1	La respondo enhavas unu argumenton kiu estas la JTAG IDKODO por la aparato
GET_CHIPID	12	0	2	La respondo enhavas 64-bitan CHIPID-valoron kun la malplej signifa vorto unue.
GET_UZKODO	13	0	1	La respondo enhavas unu argumenton kiu estas la 32-bita JTAG USERCODE, kiun la agorda bitfluo skribas al la aparato.
GET_VOLTAGE	18	1	n(2)	La GET_VOLTAGE-komando havas ununuran argumenton kiu estas bitmasko specifanta la kanalojn por legi. Bito 0 precizigas kanalon 0, bito 1 precizigas kanalon 1, ktp. La respondo inkluzivas unuvortan argumenton por ĉiu bito aro en la bitmasko. La voltage redonita estas sensigna fikspunkto kun 16 bitoj sub la binara punkto. Por ekzample, a voltage de 0.75V redonas 0x0000C000. (3) Intel Agilex-aparatoj havas ununuran voltage sensilo. Sekve, la respondo estas ĉiam unu vorto.
GET_ TEMPERATURO	19	1	n(4)	La komando GET_TEMPERATURE resendas la temperaturon aŭ temperaturojn de la kernŝtofo aŭ radioricevila kanallokoj, kiujn vi specifas. Por Intel Agilex-aparatoj, uzu la argumenton sensor_req por specifi la lokojn. La sensor_req inkluzivas la sekvajn kampojn: Bits[31:28]: Rezervita. Bitoj[27:16]: Sensila Loko. Specifas la TSD-lokon. Bitoj[15:0]: Sensila masko. Specifas la sensilojn por legi por la sensilloko specifita. La respondo enhavas unu vorton por ĉiu temperaturo petita. Se ellasita, la komando legas kanalon 0. La malplej signifa bito (lsb) egalrilatas al sensilo 0. La plej signifa bito (msb) egalrilatas al kanalo 15. La temperaturo resendita estas subskribita fiksa valoro kun 8 bitoj sub la binara punkto. Por ekzample, temperaturo de 10°C redonas 0x00000A00. A de temperaturo -1.5°C redonas 0xFFFFFE80. Se la bitmasko specifas nevalidan Lokon, la komando resendas erarkodon kiu estas ajna valoro en la intervalo 0x80000000 -0x800000FF. Por Intel Agilex-aparatoj, konsultu la Intel Agilex Power Management User Guide por pliaj informoj pri lokaj enkonstruitaj temperatursensiloj.
RSU_IMAGE_ ĜISDATIGO	5C	2	0	Ekigas reagordon de la datumfonto, kiu povas esti aŭ la fabriko aŭ aplika bildo.
daŭrigis…

Ĉi tiu nombro ne inkluzivas la komandon aŭ respondan kaplinion.
Por Intel Agilex-aparatoj kiuj subtenas legi plurajn aparatojn, indekso n kongruas kun la nombro da kanaloj, kiujn vi ebligas sur via aparato.
Raportu al la Intel Agilex Power Management User Guide por pliaj informoj pri temperatursensilo-kanaloj kaj lokoj.
Indekso n dependas de la nombro da sensilmaskoj.

Komando	Kodo (Heks)	Komando Longo (1)	Respondlongo (1)	Priskribo
				Ĉi tiu komando prenas laŭvolan 64-bitan argumenton kiu specifas la reagordan datuman adreson en la fulmo. Sendante la argumenton al la IP, vi unue sendas bitojn [31:0] sekvitajn de bitoj [63:32]. Se vi ne provizas ĉi tiun argumenton, ĝia valoro estas supozata 0. Bito [31:0]: La komenca adreso de aplika bildo. Bit [63:32]: Rezervita (skribi kiel 0). Post kiam la aparato prilaboras ĉi tiun komandon, ĝi resendas la respondkapon al respondo FIFO antaŭ ol ĝi daŭrigas reagordi la aparaton. Certigu, ke la mastro-komputilo aŭ gastiga regilo ĉesas servi aliajn interrompojn kaj koncentriĝas pri legado de la respondkapodatenoj por indiki la komandon kompletigita sukcese. Alie, la mastro-komputilo aŭ mastro-regilo eble ne povas ricevi la respondon post kiam la reagorda procezo komenciĝis. Post kiam la aparato daŭrigas kun reagordo, la ligo inter la ekstera gastiganto kaj FPGA estas perdita. Se vi uzas PCIe en via dezajno, vi devas re-nombri la PCIe-ligilon. Grava: Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
RSU_GET_SPT	5A	0	4	RSU_GET_SPT reakiras la kvaropan SPI-flash-lokon por la du subsekciaj tabloj kiujn la RSU uzas: SPT0 kaj SPT1. La 4-vorta respondo enhavas la jenajn informojn:
				Vorto	Nomo	Priskribo
				0	SPT0[63:32]	SPT0-adreso en kvara SPI-fulmo.
				1	SPT0[31:0]
				2	SPT1[63:32]	SPT1-adreso en kvara SPI-fulmo.
				3	SPT1[31:0]
KONFIG_ STATO	4	0	6	Raportas la staton de la lasta reagordo. Vi povas uzi ĉi tiun komandon por kontroli la agordan staton dum kaj post agordo. La respondo enhavas la jenajn informojn:
				Vorto	Resumo	Priskribo
				0	Ŝtato	Priskribas la plej lastatempan agordan rilatan eraron. Liveras 0 kiam ne estas agordaj eraroj. La erara kampo havas 2 kampojn: Supraj 16 bitoj: Grava erarkodo. Malsupraj 16 bitoj: Malgranda erarkodo. Vidu al Apendico: KONFIG_STATUS kaj RSU_STATUS Eraraj Kodaj Priskriboj en la Poŝtkesto-Kliento Intel FPGA IP Uzantgvidilo por pliaj informoj.
				1	Quartus Versio	Disponebla en versioj de programaro Intel Quartus® Prime inter 19.4 kaj 21.2, la kampo montras: Bito [31:28]: Indekso de la firmvaro aŭ decida firmware kopio kiu estis uzata la plej lastatempe. Eblaj valoroj estas 0, 1, 2 kaj 3. Bit [27:24]: Rezervita Bito [23:16]: Valoro estas '0'

						Disponebla en Intel Quartus Prime programaro versio 21.3 aŭ poste, la Quartus-versio montras: Bito [31:28]: Indekso de la firmvaro aŭ decida firmware kopio kiu estis uzata la plej lastatempe. Eblaj valoroj estas 0, 1, 2 kaj 3. Bit [27:24]: Rezervita Bit [23:16]: Major Quartus release number Bit [15:8]: Minor Quartus release number Bito [7:0]: Numero de ĝisdatigo de Quartus Por ekzample, en la programaro versio 21.3.1 de Intel Quartus Prime, la sekvaj valoroj reprezentas la plej gravajn kaj negravajn eldonnombrojn de Quartus, kaj la ĝisdatigan nombron de Quartus: Bito [23:16] = 8'd21 = 8'h15 Bito [15:8] = 8'd3 = 8'h3 Bito [7:0] = 8'd1 = 8'h1
				2	Pin statuso	Bito [31]: Nuna nSTATUS-eligvaloro (aktiva malalta) Bito [30]: Detektita nCONFIG-eniga valoro (aktiva malalta) Bit [29:8]: Rezervita Bit [7:6]: Agorda horloĝfonto 01 = Interna oscilatoro 10 = OSC_CLK_1 Bit [5:3]: Rezervita Bito [2:0]: La MSEL-valoro ĉe ekŝalto
				3	Mola funkcio statuso	Enhavas la valoron de ĉiu el la molaj funkcioj, eĉ se vi ne asignis la funkcion al SDM-pinglo. Bit [31:6]: Rezervita Bito [5]: HPS_WARMRESET Bito [4]: HPS_COLDRESET Bito [3]: SEU_ERROR Bito [2]: CVP_DONE Bito [1]: INIT_DONE Bito [0]: CONF_DONE
				4	Erara loko	Enhavas la erarlokon. Liveras 0 se ne estas eraroj.
				5	Detaloj pri eraro	Enhavas la erarajn detalojn. Liveras 0 se ne estas eraroj.
RSU_STATUS	5B	0	9	Raportas la nunan foran sisteman ĝisdatigstatuson. Vi povas uzi ĉi tiun komandon por kontroli la agordan staton dum agordo kaj post kiam ĝi finiĝis. Ĉi tiu komando resendas la sekvajn respondojn:
				Vorto	Resumo	Priskribo (Daŭrigu....)

Ĉi tiu nombro ne inkluzivas la komandon aŭ respondan kaplinion

	0-1	Nuna bildo	Ekbrila ofseto de la aktuala aplika bildo.
	2-3	Malsukcesa bildo	Ekbrila ofseto de la plej alta prioritata malsukcesa aplika bildo. Se pluraj bildoj estas haveblaj en fulmmemoro, konservas la valoron de la unua bildo kiu malsukcesis. Valoro de ĉiuj 0oj indikas neniujn malsukcesajn bildojn. Se mankas malsukcesaj bildoj, la resto de la ceteraj vortoj de la statusaj informoj ne konservas validajn informojn. Notu:Leviĝanta rando sur nCONFIG por reagordi de ASx4, ne malplenigas ĉi tiun kampon. Informoj pri malsukcesa bildo nur ĝisdatiĝas kiam la Leterkesto-Kliento ricevas novan komandon RSU_IMAGE_UPDATE kaj sukcese agordas de la ĝisdatiga bildo.
	4	Ŝtato	Malsukcesa kodo de la malsukcesa bildo. La erara kampo havas du partojn: Bit [31:16]: Grava erarkodo Bito [15:0]: Malgranda erarkodo Redonas 0 por neniuj misfunkciadoj. Vidu al Apendico: CONFIG_STATUS kaj RSU_STATUS-Eraraj Kodaj Priskriboj en la Poŝtkesto-Kliento Intel FPGA IP-Uzanto-Gvidilo por pliaj informoj.
	5	Versio	RSU-interfaca versio kaj erarfonto. Por pliaj informoj, raportu al la sekcio de RSU-Statuso kaj Eraraj Kodoj en la Uzanto-Gvidilo pri Malmola Procesoro-Sistemo.
	6	Erara loko	Stokas la erarlokon de la malsukcesa bildo. Liveras 0 por neniuj eraroj.
	7	Detaloj pri eraro	Stokas la erardetalojn por la malsukcesa bildo. Liveras 0 se ne estas eraroj.
	8	Nuna bilda reprovo-nombrilo	Nombro de la nombro da provoj, kiuj estis provitaj por la nuna bildo. La nombrilo estas 0 komence. La nombrilo estas agordita al 1 post la unua reprovo, tiam 2 post dua reprovo. Indiku la maksimuman nombron da reprovoj en viaj Intel Quartus Prime Settings File (.qsf). La komando estas: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Validaj valoroj por la nombrilo MAX_RETRY estas 1-3. La reala nombro da disponeblaj reprovoj estas MAX_RETRY -1 Ĉi tiu kampo estis aldonita en la versio 19.3 de la programaro Intel Quartus Prime Pro Edition.
*daŭrigis…*

Ĉi tiu nombro ne inkluzivas la komandon aŭ respondan kaplinion.

RSU_NOTIFY	5D	1	0	Forigas ĉiujn erarajn informojn en la respondo de RSU_STATUS kaj restarigas la reprovajn nombrilon. La unuvorta argumento havas la sekvajn kampojn: 0x00050000: Malplenigi la nunan rekomencigitan reprovojn. Restarigi la nunan reprovan nombrilon metas la nombrilon reen al nulo, kvazaŭ la nuna bildo estus sukcese ŝargita por la unua fojo. 0x00060000: Klara informo pri erara stato. Ĉiuj aliaj valoroj estas rezervitaj. Ĉi tiu komando ne disponeblas antaŭ la versio 19.3 de la programaro Intel Quartus Prime Pro Edition.
QSPI_OPEN	32	0	0	Petas ekskluzivan aliron al la kvara SPI. Vi eldonas ĉi tiun peton antaŭ iuj aliaj QSPI-petoj. La SDM akceptas la peton se la kvaropo SPI ne estas uzata kaj la SDM ne agordas la aparaton. Revenas OK se la SDM donas aliron. La SDM donas ekskluzivan aliron al la kliento uzante ĉi tiun leterkeston. Aliaj klientoj ne povas aliri la kvaran SPI ĝis la aktiva kliento rezignas aliron per la QSPI_CLOSE-komando. Aliro al la kvaropaj SPI-memoro-aparatoj per iu ajn leterkesto-kliento IP ne estas disponebla defaŭlte en dezajnoj kiuj inkluzivas la HPS, krom se vi malŝaltas la QSPI en HPS-programara agordo. Grava: Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_CLOSE	33	0	0	Fermas la ekskluzivan aliron al la kvara SPI-interfaco. Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_SET_CS	34	1	0	Specifas unu el la ligitaj kvaropaj SPI-aparatoj per la pecetaj elektaj linioj. Prenas unuvortan argumenton kiel priskribite sube Bits[31:28]: Elektenda fulmo. Rigardu al informoj malsupre por la valoro kiu respondas al la nCSO[0:3] pingloj Valoro 4'h0000 elektas la ekbrilon kiu respondas al nCSO[0]. Valoro 4'h0001 elektas la ekbrilon kiu respondas al nCSO[1]. Valoro 4'h0002 elektas la ekbrilon kiu respondas al nCSO[2]. Valoro 4'h0003 elektas la ekbrilon kiu respondas nCSO[3]. Bitoj[27:0]: Rezervita (skribi kiel 0). Notu: Intel Agilex aŭ Intel Stratix® 10-aparatoj subtenas unu AS x4 fulmmemora aparato por AS-agordo de kvara SPI-aparato konektita al nCSO[0]. Post kiam la aparato eniris uzantan reĝimon, vi povas uzi ĝis kvar AS x4 fulmmemorojn por uzi kun Mailbox Client IP aŭ HPS kiel datumstokado. TheMailbox Client IP aŭ HPS povas uzi nCSO[3:0] por aliri kvaropajn SPI-aparatojn. Ĉi tiu komando estas laŭvola por la AS x4-agorda skemo, la pecet-elekta linio sekvas la laste efektivigitan QSPI_SET_CS-komandon aŭ defaŭlte al nCSO[0] post la AS x4-agordo. La JTAG agorda skemo postulas ekzekuti ĉi tiun komandon por aliri la QSPI-fulmon, kiu konektas la SDM_IO-pinglojn. Aliro al la QSPI-memoro-aparatoj uzantaj SDM_IO-stiftojn nur disponeblas por la agorda skemo AS x4, JTAG agordo, kaj dezajno kompilita por AS x4-agordo. Por la agorda skemo de Avalon-flua interfaco (Avalon ST), vi devas konekti QSPI-flash-memorojn al GPIO-pingloj.
*daŭrigis…*

Ĉi tiu nombro ne inkluzivas la komandon aŭ respondan kaplinion

				Grava: Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_READ	3A	2	N	Legas la alkroĉitan kvaran SPI-aparaton. La maksimuma transiga grandeco estas 4 kilobajtoj (KB) aŭ 1024 vortoj. Prenas du argumentojn: La kvara SPI-fulmadreso (unu vorto). La adreso devas esti vorto vicigita. La aparato resendas la erarkodon 0x1 por nevicigitaj adresoj. Nombro da vortoj por legi (unu vorto). Kiam sukcesa, revenas OK sekvita de la legitaj datumoj de la kvara SPI-aparato. Malsukcesa respondo resendas erarkodon. Por parte sukcesa legado, QSPI_READ povas erare redoni la OK-statuson. Notu: Vi ne povas ruli la komandon QSPI_READ dum aparato-agordo estas en progreso. Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_WRITE	39	2+N	0	Skribas datumojn al la kvara SPI-aparato. La maksimuma transiga grandeco estas 4 kilobajtoj (KB) aŭ 1024 vortoj. Prenas tri argumentojn: La fulmadreso ofseto (unu vorto). La skriba adreso devas esti vorto vicigita. La nombro da vortoj por skribi (unu vorto). La skribendaj datumoj (unu aŭ pluraj vortoj). Sukcesa skribo resendas la OK respondkodon. Por prepari memoron por skribado, uzu la komandon QSPI_ERASE antaŭ ol eldoni ĉi tiun komandon. Notu: Vi ne povas ruli la komandon QSPI_WRITE dum aparato-agordo estas en progreso. Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_ERASE	38	2	0	Forigas 4/32/64 KB-sektoron de la kvara SPI-aparato. Prenas du argumentojn: La fulmadreso kompensas por komenci la forigon (unu vorto). Depende de la nombro da vortoj por viŝi, la komenca adreso devas esti: 4 KB vicigitaj se nombrovortoj por viŝi estas 0x400 32 KB vicigitaj se nombrovortoj por viŝi estas 0x2000 64 KB vicigitaj se nombrovortoj por viŝi estas 0x4000 Liveras eraron por ne-4/32/64 KB vicigitaj adresoj. La nombro da vortoj por viŝi estas specifita en multobloj de: 0x400 por forigi 4 KB (100 vortoj) da datumoj. Ĉi tiu opcio estas la minimuma forigita grandeco. 0x2000 por forigi 32 KB (500 vortoj) da datumoj 0x4000 por forviŝi 64 KB (1000 vortoj) da datumoj Sukcesa forigo resendas la OK respondkodon. Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.
QSPI_READ_ DEVICE_REG	35	2	N	Legas registrojn de la kvara SPI-aparato. La maksimuma legado estas 8 bajtoj. Prenas du argumentojn: La opkodo por la legita komando. La nombro da bajtoj por legi.
*daŭrigis…*

Ĉi tiu nombro ne inkluzivas la komandon aŭ respondan kaplinion.

Sukcesa legado resendas la OK respondkodon sekvitan de la datumoj legitaj de la aparato. La legita datuma reveno estas en oblo de 4 bajtoj. Se la bajtoj por legi ne estas preciza oblo de 4 bajtoj, ĝi estas plenigita kun oblo de 4 bajtoj ĝis la sekva vortlimo kaj la remburita bitovaloro estas nul.
Grava: Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.

QSPI_WRITE_ DEVICE_REG

2+N

Skribas al registroj de la kvara SPI. La maksimuma skribo estas 8 bajtoj. Prenas tri argumentojn:

La opkodo por la skriba komando.
La nombro da bajtoj por skribi.
La datumoj por skribi.

Por elfari sektoran forigon aŭ subsektoran forigon, vi devas specifi la serian fulm-adreson en plej signifa bajto (MSB) ĝis malplej signifa bajta (LSB) ordo kiel jena ekz.ample ilustras.
Por forigi sektoron de Micron 2 gigabit (Gb) fulmo ĉe adreso 0x04FF0000 uzante la komandon QSPI_WRITE_DEVICE_REG, skribu la fulm-adreson en MSB al LSB-ordo kiel montrite ĉi tie:
Kapo: 0x00003036 Opkodo: 0x000000DC
Nombro da bajtoj por skribi: 0x00000004 Flash-adreso: 0x0000FF04
Sukcesa skribo resendas la OK respondkodon. Ĉi tiu komando aldonas datumojn, kiuj ne estas oblo de 4 bajtoj al la sekva vortlimo. La komando plenigas la datumojn per nulo.
Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.

QSPI_SEND_ DEVICE_OP

Sendas komandan opkodon al la kvara SPI. Prenas unu argumenton:

La opkodo por sendi la kvaran SPI-aparaton.

Sukcesa komando resendas la OK respondkodon.
Grava:Kiam vi restarigas kvaran SPI, vi devas sekvi instrukciojn specifitajn en Restarigi Quad SPI Flash sur paĝo 9.

Por CONFIG_STATUS kaj RSU_STATUS-gravaj kaj negravaj erarkodaj priskriboj, referu al Apendico: CONFIG_STATUS kaj RSU_STATUS-Eraraj priskriboj en la Poŝtkesto-Kliento Intel FPGA IP-Gvidilo.
Rilataj Informoj

Leterkesto Kliento Intel FPGA IP Uzanto Gvidilo: CONFIG_STATUS kaj RSU_STATUS Erarkodo Priskriboj
Por pliaj informoj pri la erarkodoj CONFIG_STATUS kaj RSU_STATUS.
Intel Agilex Power Management User Guide
Por pliaj informoj pri la temperatursensilo-kanalnombroj kaj temperatursensaj diodoj (TSD).
Intel Agilex Hard Processor System Technical Reference Manual

Intel Agilex Hard Processor System Remote System Update User Guide

Eraraj Kodaj Respondoj

Tabelo 8. Eraraj Kodoj

Valoro (Heks)		Erara Koda Respondo	Priskribo
0		OK	Indikas, ke la komando sukcese plenumis. Komando povas erare resendi la OK-statuson se komando, kiel ekz QSPI_READ estas parte sukcesa.
1		INVALID_COMMAND	Indikas, ke la aktuale ŝarĝita lanĉa ROM ne povas malkodi aŭ rekoni la komandkodon.
3		UNKNOWN_COMMAND	Indikas, ke la nuntempe ŝarĝita firmvaro ne povas malkodi la komandkodon.
4		INVALID_COMMAND_ PARAMETERS	Indikas ke la komando estas malĝuste formatita. Por ekzample, la longo-kampa agordo en kaplinio ne validas.
6		COMMAND_INVALID_ON_ SOURCE	Indikas ke la komando estas de fonto por kiu ĝi ne estas ebligita.
8		CLIENT_ID_NO_MATCH	Indikas, ke la Klienta ID ne povas plenumi la peton por fermi la ekskluzivan aliron al kvara SPI. La Kliento-ID ne kongruas kun la ekzistanta kliento kun la nuna ekskluziva aliro al kvara SPI.
9		INVALID_ADDRESS	La adreso estas malvalida. Ĉi tiu eraro indikas unu el la sekvaj kondiĉoj: Nevicigita adreso Problemo pri adresintervalo Problemo pri legpermeso Nevalida peceta elekta valoro, montranta valoron de pli ol 3 Nevalida adreso en RSU-kazo Nevalida bitmaskvaloro por GET_VOLTAGE komando Nevalida paĝo-elekto por komando GET_TEMPERATURE
A		AUTHENTICATION_FAIL	Indikas la fiaskon de konfirmo de subskribo de agorda bitfluo.
B		TEMPO	Ĉi tiu eraro indikas tempodaŭron pro la sekvaj kondiĉoj: Komando Atendante la finiĝon de la operacio QSPI_READ Atendante la petitan temperaturlegadon de unu el la temperatursensiloj. Povas indiki eblan aparatan eraron en la temperatursensilo.
C		HW_NE_PRETA	Indikas unu el la sekvaj kondiĉoj: La aparataro ne estas preta. Povas indiki aŭ inicialigon aŭ agordan problemon. La aparataro povas rilati al kvara SPI. RSU-bildo ne estas uzata por agordi la FPGA.
D		HW_ERROR	Indikas, ke la komando finiĝis malsukcese pro nereakirebla aparatara eraro.
80 – 8F		COMMAND_SPECIFIC_ ERARO	Indikas komandan specifan eraron pro SDM-komando, kiun vi uzis.
			SDM Komando		Erara Nomo			Erarkodo	Priskribo
			GET_CHIPID		EFUSE_SYSTEM_ FAILURE			0x82	Indikas ke la kaŝmemormontrilo eFuse estas nevalida.
			QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/ QSPI_READ_D EVICE_REG/		QSPI_HW_ERROR			0x80	Indikas eraron pri fulmmemoro de QSPI. Ĉi tiu eraro indikas unu el la sekvaj kondiĉoj:
				QSPI_WRITE_ DEVICE_REG/ QSPI_SEND_D EVICE_OP/ QSPI_READ						Problemo pri elekta agordo de QSPI-flashpeto Problemo pri inicialigo de QSPI-fulmo Problemo pri restarigo de QSPI-fulmo Problemo pri ĝisdatigo de QSPI-agordoj
						QSPI_ALREADY_ OPEN	0x81			Indikas, ke la ekskluziva aliro de la kliento al QSPI-fulmo per QSPI_OPEN-komando jam estas malfermita.
100	NOT_CONFIGURED			Indikas, ke la aparato ne estas agordita.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ BUSY			Indikas, ke la aparato estas okupata pro jenaj uzkazoj: RSU: Firmvaro ne povas transiri al malsama versio pro interna eraro. HPS: HPS estas okupata kiam en HPS-reagorda procezo aŭ HPS malvarma rekomencigita.
2FF	ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE			Indikas, ke ne ekzistas valida respondo disponebla.
3FF	ALT_SDM_MBOX_RESP_ ERARO			Ĝenerala Eraro.

Reakiro de Erara Kodo
La suba tabelo priskribas eblajn paŝojn por reakiri de erara kodo. La reakiro de eraro dependas de specifa uzokazo.
Tablo 9. Reakiro de Erarkodo por konataj Eraraj Kodoj

Valoro	Erara Koda Respondo	Reakiro de Erara Kodo
4	INVALID_COMMAND_ PARAMETERS	Resendu la komandan kaplinion aŭ kaplinion kun argumentoj kun korektitaj parametroj. Por ekzample, certigu, ke la longo-kampa agordo en kaplinio estas sendita kun la ĝusta valoro.
6	COMMAND_INVALID_ ON_SOURCE	Resendu la komandon de valida fonto kiel JTAG, HPS, aŭ kerna ŝtofo.
8	CLIENT_ID_NO_MATCH	Atendu, ke la kliento, kiu malfermis la aliron al quad SPI, kompletigu ĝian aliron kaj poste fermas la ekskluzivan aliron al quad SPI.
9	INVALID_ADDRESS	Eblaj eraraj reakiro paŝoj: Por GET_VOLTAGE komando: Sendu komandon kun valida bitmasko. Por komando GET_TEMPERATURE: Sendu komandon kun valida sensilloko kaj sensilmasko. Por QSPI-operacio: Sendu komandon kun valida pecelektado. Sendu komandon kun valida QSPI-flash-adreso. Por RSU: Sendu komandon kun valida komenca adreso de la fabrika bildo aŭ aplikaĵo.
B	TEMPO	Eblaj restarigaj paŝoj: Por komando GET_TEMPERATURE: Reprovu sendi la komandon denove. Se problemo daŭras, reagordu aŭ ŝaltu la aparaton. Por QSPI-operacio: Kontrolu signalintegrecon de QSPI-interfacoj kaj provu komandon denove. Por HPS rekomenca operacio: Reprovu sendi la komandon denove.
C	HW_NE_PRETA	Eblaj restarigaj paŝoj: Por QSPI-operacio: Reagordu la aparaton per fonto. Certigu, ke IP uzata por konstrui vian dezajnon ebligas aliron al la QSPI-fulmo. Por RSU: Agordu la aparaton kun RSU-bildo.
80	QSPI_HW_ERROR	Kontrolu la QSPI-interfacan signalintegrecon kaj certigu, ke la QSPI-aparato ne estas difektita.
81	QSPI_ALREADY_OPEN	Kliento jam malfermis QSPI. Daŭrigu kun la sekva operacio.
82	EFUSE_SYSTEM_FAILURE	Provu reagordon aŭ potencociklon. Se eraro daŭras post reagordo aŭ elektra ciklo, la aparato povas esti difektita kaj nereakirebla.
100	NOT_CONFIGURED	Sendu bitfluon kiu agordas la HPS.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ BUSY	Eblaj eraraj reakiro paŝoj: Por QSPI-operacio: Atendu daŭrantan agordon aŭ alia kliento por plenumi operacion. Por RSU: Reagordu aparaton por resaniĝi de interna eraro. Por HPS-rekomenca operacio: Atendu la reagordon per HPS aŭ HPS Cold Reset finiĝi.

Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP User Guide Dokumentaj Arkivoj

Por la plej novaj kaj antaŭaj versioj de ĉi tiu uzantgvidilo, referu al Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP Uzantgvidilo. Se IP aŭ programara versio ne estas listigita, validas la uzantgvidilo por la antaŭa IP aŭ programara versio.

IP-versioj estas la samaj kiel la versioj de la programaro Intel Quartus Prime Design Suite ĝis v19.1. De Intel Quartus Prime Design Suite programaro versio 19.2 aŭ pli posta, IP-kernoj havas novan IP-versiadskemon.

Dokumenta Revizia Historio por la Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP User Guide

Dokumenta Versio	Intel Quartus Prime Version		IP-Versio	Ŝanĝoj
2022.09.26	22.3		1.0.1	Faris la sekvajn ŝanĝojn: Ĝisdatigis la GET_VOLTAGE komandvico en la Komando Listo kaj Priskribo-tabelo. Aldonita noto al Tabla Aparato Familia Subteno. Reviziita QSPI_SET_CS komanda priskribo en la komanda Listo kaj Priskribo-tabelo.
2022.04.04	22.1		1.0.1	Ĝisdatigis la komandan Liston kaj Priskribon-tabelon. Ĝisdatigita pingla statopriskribo por la komando CONFIG_STATUS. Forigis la komandon REBOOT_HPS.
2021.10.04	21.3		1.0.1	Faris la sekvan ŝanĝon: Reviziita Komando Listo kaj Priskribo tablo. Ĝisdatigita priskribo por: KONFIG_STATUS RSU_STATUS
2021.06.21	21.2		1.0.1	Faris la sekvajn ŝanĝojn: Reviziita Komando Listo kaj Priskribo tablo. Ĝisdatigita priskribo por: RSU_STATUS QSPI_OPEN QSPI_SET_CS QSPI_ERASE
2021.03.29	21.1		1.0.1	Faris la sekvajn ŝanĝojn: Reviziita RSU_IMAGE_UPDATE priskribo en la Komando Listo kaj Priskribo tablo. Restrukturita Operaciaj Komandoj. Forigitaj gravaj kaj negravaj erarkodaj priskriboj por la komandoj CONFIG_STATUS kaj RSU_STATUS. La plej gravaj kaj negravaj erarkodoj nun estas dokumentitaj kiel apendico en la Poŝtkesto-Kliento Intel FPGA IP Uzantgvidilo.
2020.12.14	20.4		1.0.1	Faris la sekvajn ŝanĝojn:
					Aldonita grava noto pri restarigo de QSPI-fulmo en la Operaciaj Komandoj temo. Ĝisdatigis la Komando Listo kaj Priskribo tablo: Reviziita komanda priskribo de GET_TEMPERATURE. Reviziita komanda priskribo de RSU_IMAGE_UPDATE. Aldonita teksto pri restarigo de QSPI-fulmo. Aldonita teksto priskribanta konduton inter la ekstera gastiganto kaj FPGA. Forigita teksto: Liveras ne-nulan respondon se la aparato jam prilaboras agordan komandon. Ĝisdatigitaj QSPI_WRITE kaj QSPI_READ priskriboj por specifi ke la maksimuma transiga grandeco estas 4 kilobajtoj aŭ 1024 vortoj. Korektita respondlongo de 1 ĝis 0 por la QSPI_OPEN, QSPI_CLOSE kaj QSPI_SET_CS komando. Reviziitaj priskriboj de QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG kaj QSPI_WRITE_DEVICE_REG. Aldonis novan komandon: REBOOT_HPS. Aldonita nova temo: Erara Kodo Reakiro.
2020.10.05	20.3	1.0.1			Ŝanĝis la titolon de ĉi tiu uzantgvidilo de Leterkesto Avalon Streaming Interface Client Intel FPGA IP User Guide al Leterkesto-Kliento kun Avalon Streaming Interface Intel FPGA IP Uzantgvidilo pro la IP-nomŝanĝo en la Intel Quartus Prime IP Katalogo. Tutmonde ĝisdatigis ĉiujn IP-nomajn petskribojn. Reviziita komanda priskribo GET TEMPERATURE por Intel Agilex-aparatoj en la Komando Listo kaj Priskribo tablo. Aldonita rekomendo pri la rekomencigita sinkronigilo en la Horloĝo kaj Restarigi Interfacojn tablo. Ĝisdatigis la Eraraj Kodoj tablo. Aldonitaj novaj erarkodaj respondoj: HW_ERROR COMMAND_SPECIFIC_ERROR Forigis la Temperatura Sensilo Lokoj temo. La informoj pri temperatursensilo haveblas en la Intel Agilex Power Management User Guide.
2020.06.30	20.2	1.0.0			Ŝanĝis la titolon de ĉi tiu uzantgvidilo de Leterkesto Avalon ST Kliento Intel FPGA IP Uzantgvidilo al Leterkesto Avalon Streaming Interface Client Intel FPGA IP User Guide. Renomita temo titolo Komandado kaj Responda Kapo al Komandoj kaj Respondoj. Reviziitaj priskriboj de ID, LONGO kaj Komandkodo/Era Kodo en la Komando kaj Responda Kapa Priskribo tablo. Renomita temo titolo Subtenataj Komandoj al Operaciaj Komandoj.
				Reviziis la jenajn komandojn priskribon en la Komando Listo kaj Priskribo tablo: GET_TEMPERATURE RSU_STATUS QSPI_SET_CS Renomita temo titolo Eraraj Kodoj al Eraraj Kodaj Respondoj. Forigita UNKNOWN_BR komando de la Erara Kodo tablo.
2020.04.13	20.1		1.0.0	Faris la sekvajn ŝanĝojn: Aldonitaj informoj pri la temperatursensiloj por la komando GET_TEMPERATURE, inkluzive de figuroj ilustrantaj TSD-lokojn. Aldonita RSU_NOTIFY komando en la Listo kaj Priskribo de Kodo de komando tablo. Ĝisdatigis la Eraraj Kodoj tablo: Renomite INVALID_COMMAND_PARAMETERS al INVALID_LENGTH. Ŝanĝita COMMAND_INVALID_ON_SOURCE deksesa valoro de 5 al 6. Ŝanĝita CLIENT_ID_NO_MATCH heksvaloro de 6 al 8. Ŝanĝita INVALID_ADDRESS deksesa valoro de 7 al 9. Aldonita komando AUTHENTICATION_FAIL. Ŝanĝita TIMEOUT heksvaloro de 8 al B. Ŝanĝita HW_NOT_READY heksvaloro de 9 al C.
2019.09.30	19.3		1.0.0	Komenca eldono.

Por sugestoj, bonvolu viziti: FPGAtechdocfeedback@intel.com

Dokumentoj/Rimedoj

Intel Mailbox Client kun Avalon Streaming Interface FPGA IP [pdf] Uzantogvidilo
Leterkesto Kliento kun Avalon Streaming Interface FPGA IP, Leterkesto Kliento, Avalon Streaming Interface FPGA IP

Referencoj

Uzanto Manlibro

Leterkesto-Kliento kun Avalon® Streaming Interface Intel FPGA IP Overview