intel Mailbox Client med Avalon Streaming Interface FPGA IP Brugervejledning

intel Mailbox Client med Avalon Streaming Interface FPGA IP Brugervejledning

Indhold skjule

1 Mailbox Client med Avalon® Streaming Interface Intel FPGA IP Overview

Mailbox Client med Avalon® Streaming Interface Intel FPGA IP Overview

Mailbox Client med Avalon® streaming interface Intel® FPGA IP (Mailbox Client med Avalon ST Client IP) giver en kommunikationskanal mellem din brugerdefinerede logik og den sikre enhedshåndtering (SDM). Du kan bruge Mailbox Client med Avalon ST IP til at sende kommandopakker og modtage svarpakker fra SDM perifere moduler. Mailbox Client med Avalon ST IP definerer funktioner, som SDM'en kører.

Din brugerdefinerede logik kan bruge denne kommunikationskanal til at modtage information og få adgang til flashhukommelse fra følgende perifere moduler:

Chip-id'et
Temperatursensoren

Voltage sensor
Quad Serial Peripheral Interface (SPI) flashhukommelse

Note: I hele denne brugervejledning forkorter udtrykket Avalon ST Avalon-streaminggrænsefladen eller IP.

Figur 1. Mailbox Client med Avalon ST IP System Design

Den følgende figur viser en applikation, hvor Mailbox Client med Avalon ST IP læser Chip ID'et.

Figur 2. Postkasseklient med Avalon ST IP læser chip-id

Enhedsfamiliesupport

Følgende lister enhedsunderstøttelsesniveaudefinitionerne for Intel FPGA IP'er:

Forudgående support — IP'en er tilgængelig til simulering og kompilering for denne enhedsfamilie. Timing-modeller inkluderer indledende tekniske estimater af forsinkelser baseret på tidlig post-layout-information. Timingmodellerne kan ændres, da siliciumtestning forbedrer korrelationen mellem det faktiske silicium og timingmodellerne. Du kan bruge denne IP til systemarkitektur og ressourceudnyttelsesundersøgelser, simulering, pin-out, systemlatensvurderinger, grundlæggende timingvurderinger (pipelinebudgettering) og I/O-overførselsstrategi (datastibredde, burstdybde, handel med I/O-standarder offs).

Foreløbig støtte — IP-adressen er verificeret med foreløbige timingmodeller for denne enhedsfamilie. IP'en opfylder alle funktionelle krav, men er muligvis stadig under tidsanalyse for enhedsfamilien. Det kan bruges i produktionsdesign med forsigtighed.
Endelig støtte — IP-adressen er verificeret med endelige timingmodeller for denne enhedsfamilie. IP'en opfylder alle funktions- og tidskrav til enhedsfamilien og kan bruges i produktionsdesign.

Tabel 1. Enhedsfamiliesupport

Enhedsfamilie	Støtte
Intel Agilex™	Forskud

Note: Du kan ikke simulere postkasseklienten med Avalon Streaming Interface Intel FPGA IP, fordi IP'en modtager svarene fra SDM'en. For at validere denne IP anbefaler Intel, at du udfører hardwareevaluering.

Relateret information
Mailbox Client med Avalon Streaming Interface Intel FPGA IP Release Notes

Parametre

Parameternavn	Værdi	Beskrivelse
Aktiver statusgrænseflade	Tænd sluk	Når du aktiverer denne grænseflade, inkluderer Mailbox Client med Avalon-streaminggrænsefladen Intel FPGA IP signalet command_status_invalid. Når command_status_invalid hævder, skal du nulstille IP'en.

Grænseflader
Følgende figur illustrerer Mailbox Client med Avalon Streaming Interface Intel FPGA IP-grænseflader:

Figur 3. Mailbox Client med Avalon Streaming Interface Intel FPGA IP Interfaces

For mere information om Avalon-streaminggrænseflader, se Avalon-grænsefladespecifikationerne.
Relateret information
Avalon grænsefladespecifikationer

Ur og nulstil grænseflader

Tabel 2. Ur og nulstil grænseflader

Signal navn	Retning	Beskrivelse
in_clk	Input	Dette er uret til Avalon streaming-grænseflader. Den maksimale frekvens i 250 MHz.
in_reset	Input	Dette er en aktiv høj nulstilling. Bekræft in_reset for at nulstille Mailbox Client med Avalon streaming interface Intel FPGA IP (Mailbox Client med Avalon ST IP). Når in_reset-signalet hævdes, skal SDM'en skylle enhver afventende aktivitet fra Mailbox Client med Avalon ST IP. SDM fortsætter med at behandle kommandoer fra andre klienter. For at sikre, at postkasseklienten med Avalon ST IP fungerer korrekt, når enheden går i brugertilstand, skal dit design inkludere Reset Release Intel FPGA IP for at holde nulstillingen, indtil FPGA-stoffet gik i brugertilstand. Intel anbefaler, at du bruger en nulstillingssynkronisering, når du tilslutter brugernulstillingen eller udgangen af Reset Release IP til
		nulstillingsporten på Mailbox Client med Avalon ST IP. For at implementere nulstillingssynkroniseringen skal du bruge Reset Bridge Intel FPGA IP, der er tilgængelig i Platform Designer. Note: For IP-instansiering og tilslutningsretningslinjer i platformdesigneren henvises til de påkrævede kommunikations- og værtskomponenter til fjernsystemopdateringsdesignet Ex.ampfiguren i Intel Agilex Configuration User Guide.

Kommandogrænseflade
Brug Avalon Streaming-grænsefladen (Avalon ST) til at sende kommandoer til SDM.

Tabel 3. Kommandogrænseflade

Signal navn	Retning	Beskrivelse
kommando_klar	Produktion	Postkasseklienten med Avalon ST Intel FPGA IP hævder command_ready, når den er klar til at modtage kommandoer fra applikationen. Ready_latency er 0 cyklusser. Postkasseklienten med Avalon ST kan acceptere command_data[31:0] i samme cyklus som command_ready hævder.
kommando_gyldig	Input	Command_valid-signalet hævder at angive, at command_data er gyldige.
kommandodata[31:0]	Input	Command_data-bussen driver kommandoer til SDM'en. Se kommandoliste og beskrivelse for definitioner af kommandoerne.
kommando_start af pakke	Input	Command_startofpacket hævder i den første cyklus af en kommandopakke.
command_endofpacket	Input	Command_endofpacket hævder i den sidste kommandocyklus en pakke.

Figur 4. Timing for Avalon ST Command Packet

Responsgrænseflade
SDM Avalon ST Client IP sender svar til din applikation ved hjælp af svargrænsefladen.

Tabel 4. Responsgrænseflade

Signal 5	Retning	Beskrivelse
respons_klar	Input	Applikationslogik kan hævde response_ready-signalet, når den er i stand til at modtage et svar.
respons_valid	Produktion	SDM'en hævder response_valid for at angive, at response_data er gyldige.
response_data[31:0]	Produktion	SDM'en driver response_data for at give den ønskede information. Det første ord i svaret er en header, der identificerer den kommando, som SDM'en leverer. Der henvises til Kommandoliste og beskrivelse for definitioner af kommandoerne.
response_startafpakke	Produktion	Response_startofpacket hævder i den første cyklus af en svarpakke.
response_endofpacket	Produktion	Response_endofpacket hævder i den sidste cyklus af en svarpakke.

Figur 5. Timing for Avalon ST Response Packet

Kommandostatusgrænseflade

Tabel 5. Kommandostatusgrænseflade

Signal navn	Retning	Beskrivelse
kommando_status_ugyldig	Produktion	Command_status_invalid hævder at angive en fejl. Dette signal hævder typisk at angive, at længden af kommandoen, der er angivet i kommandohovedet, ikke svarer til længden af den sendte kommando. Når command_status_invalid hævder, skal din applikationslogik hævde in_reset for at genstarte Mailbox Client med Avalon streaming interface Intel FPGA IP.

Figur 6. Nulstil efter command_status_invalid hævder

Kommandoer og svar

Værtscontrolleren kommunikerer med SDM ved hjælp af kommando- og svarpakker via Mailbox Client Intel FPGA IP.

Det første ord i kommando- og svarpakkerne er en header, der giver grundlæggende oplysninger om kommandoen eller svaret.

Figur 7. Kommando- og svarhovedformat

Note: LENGTH-feltet i kommandohovedet skal svare til kommandolængden af den tilsvarende kommando.
Følgende tabel beskriver felterne i header-kommandoen.

Tabel 6. Kommando- og svarhovedbeskrivelse

Overskrift	Bit	Beskrivelse
Reserveret	[31:28]	Reserveret.
ID	[27:24]	Kommando-id'et. Svarhovedet returnerer det ID, der er angivet i kommandohovedet. Se Operation Commands for kommandobeskrivelser.
0	[23]	Reserveret.
LÆNGDE	[22:12]	Antal ord af argumenter efter overskriften. IP'en svarer med en fejl, hvis der indtastes et forkert antal ord af argumenter for en given kommando. Hvis der er uoverensstemmelse mellem kommandolængden angivet i kommandohovedet og antallet af sendte ord. IP'en hæver bit 3 i Interrupt Status Register (COMMAND_INVALID), og Mailbox Client skal nulstilles.
Reserveret	[11]	Reserveret. Skal indstilles til 0.
Kommandokode/fejlkode	[10:0]	Kommandokode angiver kommandoen. Fejlkoden angiver, om kommandoen lykkedes eller mislykkedes. I kommandohovedet repræsenterer disse bits kommandokode. I svarhovedet repræsenterer disse bits fejlkode. Hvis kommandoen lykkes, er fejlkoden 0. Hvis kommandoen mislykkes, henvises til fejlkoderne defineret i Fejlkodesvar.

Operationskommandoer

Nulstilling af Quad SPI Flash
Vigtig: For Intel Agilex-enheder skal du tilslutte den serielle flash eller quad SPI flash-nulstillingsstiften til AS_nRST-stiften. SDM'en skal fuldt ud kontrollere QSPI-nulstillingen. Tilslut ikke quad SPI-nulstillingsstiften til nogen ekstern vært.

Tabel 7. Kommandoliste og beskrivelse

Kommando	Kode (hex)	Kommandolængde (1)	Svarlængde (1)	Beskrivelse
NEJ	0	0	0	Sender et OK-statussvar.
GET_IDCODE	10	0	1	Svaret indeholder et argument, som er JTAG IDCODE for enheden
GET_CHIPID	12	0	2	Svaret indeholder 64-bit CHIPID-værdi med det mindst signifikante ord først.
GET_USERCODE	13	0	1	Svaret indeholder et argument, som er 32-bit JTAG USERCODE, som konfigurationsbitstrømmen skriver til enheden.
GET_VOLTAGE	18	1	n(2)	GET_VOLTAGE-kommandoen har et enkelt argument, som er en bitmaske, der angiver de kanaler, der skal læses. Bit 0 angiver kanal 0, bit 1 angiver kanal 1, og så videre. Svaret inkluderer et argument på ét ord for hver bit, der er sat i bitmasken. Voltage returneret er et usigneret fastpunktnummer med 16 bit under det binære punkt. F.eksample, et bindtage på 0.75V returnerer 0x0000C000. (3) Intel Agilex-enheder har en enkelt voltage sensor. Derfor er svaret altid et ord.
GET_ TEMPERATURE	19	1	n(4)	GET_TEMPERATURE-kommandoen returnerer temperaturen eller temperaturerne for kernestof- eller transceiverkanalplaceringerne, du angiver. For Intel Agilex-enheder skal du bruge argumentet sensor_req til at angive placeringerne. Sensor_req inkluderer følgende felter: Bits[31:28]: Reserveret. Bits[27:16]: Sensorplacering. Angiver TSD-placeringen. Bits[15:0]: Sensormaske. Angiver de sensorer, der skal aflæses for den angivne sensorplacering. Svaret indeholder et ord for hver anmodet temperatur. Hvis den udelades, læser kommandoen kanal 0. Den mindst signifikante bit (lsb) svarer til sensor 0. Den mest signifikante bit (msb) svarer til kanal 15. Den returnerede temperatur er en fast værdi med fortegn med 8 bit under det binære punkt. F.eksample, en temperatur på 10°C returnerer 0x00000A00. A med temperatur -1.5°C returnerer 0xFFFFFE80. Hvis bitmasken angiver en ugyldig placering, returnerer kommandoen en fejlkode, som er en hvilken som helst værdi i området 0x80000000 -0x800000FF. For Intel Agilex-enheder henvises til Intel Agilex Power Management User Guide for mere information om lokale indbyggede temperatursensorer.
RSU_IMAGE_ OPDATERING	5C	2	0	Udløser omkonfiguration fra datakilden, der enten kan være fra fabrikken eller et applikationsbillede.
fortsatte…

Dette nummer inkluderer ikke kommando- eller svarhovedet.
For Intel Agilex-enheder, der understøtter læsning af flere enheder, svarer indeks n til antallet af kanaler, du aktiverer på din enhed.
Der henvises til Intel Agilex Power Management brugervejledning for mere information om temperatursensorkanaler og placeringer.
Indeks n afhænger af antallet af sensormasker.

Kommando	Kode (hex)	Kommandolængde (1)	Svarlængde (1)	Beskrivelse
				Denne kommando tager et valgfrit 64-bit argument, der specificerer rekonfigurationsdataadressen i flash. Når du sender argumentet til IP'en, sender du først bits [31:0] efterfulgt af bits [63:32]. Hvis du ikke angiver dette argument, antages dets værdi at være 0. Bit [31:0]: Startadressen for et applikationsbillede. Bit [63:32]: Reserveret (skriv som 0). Når enheden behandler denne kommando, returnerer den svarhovedet til svar FIFO, før den fortsætter med at omkonfigurere enheden. Sørg for, at værts-pc'en eller værtscontrolleren holder op med at servicere andre afbrydelser og fokuserer på at læse svarheaderdataene for at indikere, at kommandoen er gennemført. Ellers kan værts-pc'en eller værtscontrolleren muligvis ikke modtage svaret, når omkonfigurationsprocessen er startet. Når først enheden fortsætter med omkonfiguration, er forbindelsen mellem den eksterne vært og FPGA tabt. Hvis du bruger PCIe i dit design, skal du genopregne PCIe-linket. Vigtig: Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
RSU_GET_SPT	5A	0	4	RSU_GET_SPT henter quad SPI flash-placeringen for de to underpartitionstabeller, som RSU'en bruger: SPT0 og SPT1. Svaret på 4 ord indeholder følgende oplysninger:
				Ord	Navn	Beskrivelse
				0	SPT0[63:32]	SPT0-adresse i quad SPI-flash.
				1	SPT0[31:0]
				2	SPT1[63:32]	SPT1-adresse i quad SPI-flash.
				3	SPT1[31:0]
CONFIG_ STATUS	4	0	6	Rapporterer status for den seneste omkonfiguration. Du kan bruge denne kommando til at kontrollere konfigurationsstatus under og efter konfigurationen. Svaret indeholder følgende oplysninger:
				Ord	Oversigt	Beskrivelse
				0	Tilstand	Beskriver den seneste konfigurationsrelaterede fejl. Returnerer 0, når der ikke er nogen konfigurationsfejl. Fejlfeltet har 2 felter: Øvre 16 bit: Større fejlkode. Lavere 16 bit: Mindre fejlkode. Se bilag: CONFIG_STATUS og RSU_STATUS fejlkodebeskrivelser i Mailbox Client Intel FPGA IP Brugervejledning for mere information.
				1	Quartus version	Tilgængelig i Intel Quartus® Prime-softwareversioner mellem 19.4 og 21.2, viser feltet: Bit [31:28]: Indeks over den firmware eller beslutningsfirmwarekopi, der blev brugt senest. Mulige værdier er 0, 1, 2 og 3. Bit [27:24]: Reserveret Bit [23:16]: Værdien er '0'

						Tilgængelig i Intel Quartus Prime-softwareversion 21.3 eller nyere, Quartus-versionen viser: Bit [31:28]: Indeks over den firmware eller beslutningsfirmwarekopi, der blev brugt senest. Mulige værdier er 0, 1, 2 og 3. Bit [27:24]: Reserveret Bit [23:16]: Major Quartus udgivelsesnummer Bit [15:8]: Minor Quartus-udgivelsesnummer Bit [7:0]: Quartus-opdateringsnummer F.eksample, i Intel Quartus Prime-softwareversion 21.3.1 repræsenterer følgende værdier de større og mindre Quartus-udgivelsesnumre og Quartus-opdateringsnummeret: Bit [23:16] = 8'd21 = 8'h15 Bit [15:8] = 8'd3 = 8'h3 Bit [7:0] = 8'd1 = 8'h1
				2	Pin status	Bit [31]: Aktuel nSTATUS udgangsværdi (aktiv lav) Bit [30]: Detekteret nCONFIG inputværdi (aktiv lav) Bit [29:8]: Reserveret Bit [7:6]: Konfigurationsurkilde 01 = Intern oscillator 10 = OSC_CLK_1 Bit [5:3]: Reserveret Bit [2:0]: MSEL-værdien ved opstart
				3	Blød funktionsstatus	Indeholder værdien af hver af de bløde funktioner, selvom du ikke har tildelt funktionen til en SDM-pin. Bit [31:6]: Reserveret Bit [5]: HPS_WARMRESET Bit [4]: HPS_COLDRESET Bit [3]: SEU_ERROR Bit [2]: CVP_DONE Bit [1]: INIT_DONE Bit [0]: CONF_DONE
				4	Fejlplacering	Indeholder fejlplaceringen. Returnerer 0, hvis der ikke er nogen fejl.
				5	Fejldetaljer	Indeholder fejldetaljerne. Returnerer 0, hvis der ikke er nogen fejl.
RSU_STATUS	5B	0	9	Rapporterer den aktuelle status for fjernsystemopgradering. Du kan bruge denne kommando til at kontrollere konfigurationsstatus under konfigurationen og efter den er fuldført. Denne kommando returnerer følgende svar:
				Ord	Oversigt	Beskrivelse (Fortsætte….)

Dette nummer inkluderer ikke kommando- eller svarhovedet

	0-1	Nuværende billede	Flash offset af det aktuelt kørende programbillede.
	2-3	Fejlagtigt billede	Flash offset af det højest prioriterede fejlbehæftede programbillede. Hvis flere billeder er tilgængelige i flash-hukommelsen, gemmer værdien af det første billede, der mislykkedes. En værdi på alle 0'er indikerer ingen fejlagtige billeder. Hvis der ikke er nogen fejlagtige billeder, gemmer resten af de resterende ord i statusinformationen ikke gyldig information. Note:En stigende kant på nCONFIG for at omkonfigurere fra ASx4, rydder ikke dette felt. Oplysninger om mislykket billede opdateres kun, når postkasseklienten modtager en ny RSU_IMAGE_UPDATE-kommando og konfigureres fra opdateringsbilledet.
	4	Tilstand	Fejlkode for det fejlagtige billede. Fejlfeltet har to dele: Bit [31:16]: Større fejlkode Bit [15:0]: Mindre fejlkode Returnerer 0 for ingen fejl. Der henvises til Appendiks: CONFIG_STATUS og RSU_STATUS fejlkodebeskrivelser i Mailbox Client Intel FPGA IP User Guide for mere information.
	5	Version	RSU-interfaceversion og fejlkilde. For mere information henvises til afsnittet RSU-status og fejlkoder i Hard Processor System Remote System Update User Guide.
	6	Fejlplacering	Gemmer fejlplaceringen af det fejlagtige billede. Returnerer 0 for ingen fejl.
	7	Fejldetaljer	Gemmer fejldetaljerne for det fejlagtige billede. Returnerer 0, hvis der ikke er nogen fejl.
	8	Aktuel billedtæller	Optælling af antallet af genforsøg, der er blevet forsøgt for det aktuelle billede. Tælleren er initialt 0. Tælleren indstilles til 1 efter det første forsøg igen, derefter 2 efter et andet forsøg. Angiv det maksimale antal genforsøg i dine Intel Quartus Prime-indstillinger File (.qsf). Kommandoen er: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Gyldige værdier for MAX_RETRY-tælleren er 1-3. Det faktiske antal tilgængelige genforsøg er MAX_RETRY -1 Dette felt blev tilføjet i version 19.3 af Intel Quartus Prime Pro Edition-softwaren.
*fortsatte…*

Dette nummer inkluderer ikke kommando- eller svarhovedet.

RSU_NOTIFY	5D	1	0	Rydder al fejlinformation i RSU_STATUS-svaret og nulstiller genforsøgstælleren. Et-ords-argumentet har følgende felter: 0x00050000: Ryd aktuel nulstillings-tæller. Nulstilling af den aktuelle genforsøgstæller sætter tælleren tilbage til nul, som om det aktuelle billede blev indlæst for første gang. 0x00060000: Ryd fejlstatusoplysninger. Alle andre værdier er forbeholdt. Denne kommando er ikke tilgængelig før version 19.3 af Intel Quartus Prime Pro Edition-softwaren.
QSPI_OPEN	32	0	0	Anmoder om eksklusiv adgang til quad SPI. Du udsteder denne anmodning før andre QSPI-anmodninger. SDM'en accepterer anmodningen, hvis quad SPI'en ikke er i brug, og SDM'en ikke konfigurerer enheden. Returnerer OK, hvis SDM giver adgang. SDM'en giver eksklusiv adgang til klienten ved hjælp af denne postkasse. Andre klienter kan ikke få adgang til quad SPI'en, før den aktive klient giver afkald på adgang ved hjælp af kommandoen QSPI_CLOSE. Adgang til quad SPI-flashhukommelsesenheder via enhver postkasseklient-IP er ikke tilgængelig som standard i designs, der inkluderer HPS, medmindre du deaktiverer QSPI i HPS-softwarekonfigurationen. Vigtig: Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_CLOSE	33	0	0	Lukker den eksklusive adgang til quad SPI-grænsefladen. Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_SET_CS	34	1	0	Angiver en af de vedhæftede quad SPI-enheder via chipvalgslinjerne. Tager et argument på ét ord som beskrevet nedenfor Bits[31:28]: Flash-enhed at vælge. Se oplysningerne nedenfor for den værdi, der svarer til nCSO[0:3]-benene Værdi 4'h0000 vælger den flash, der svarer til nCSO[0]. Værdi 4'h0001 vælger den flash, der svarer til nCSO[1]. Værdi 4'h0002 vælger den flash, der svarer til nCSO[2]. Værdi 4'h0003 vælger det blink, der svarer til nCSO[3]. Bits[27:0]: Reserveret (skriv som 0). Note: Intel Agilex- eller Intel Stratix® 10-enheder understøtter én AS x4-flashhukommelsesenhed til AS-konfiguration fra quad SPI-enhed tilsluttet nCSO[0]. Når enheden er gået i brugertilstand, kan du bruge op til fire AS x4 flash-hukommelser til brug med Mailbox Client IP eller HPS som datalagring. TheMailbox Client IP eller HPS kan bruge nCSO[3:0] til at få adgang til quad SPI-enheder. Denne kommando er valgfri for AS x4-konfigurationsskemaet, chipvalgslinjen følger den sidst udførte QSPI_SET_CS-kommando eller er standard til nCSO[0] efter AS x4-konfigurationen. Den JTAG konfigurationsskemaet kræver, at denne kommando udføres for at få adgang til QSPI-flashen, der forbinder SDM_IO-benene. Adgang til QSPI-flashhukommelsesenhederne ved hjælp af SDM_IO-ben er kun tilgængelig for AS x4-konfigurationsskemaet, JTAG konfiguration og et design kompileret til AS x4-konfiguration. For Avalon streaming interface (Avalon ST) konfigurationsskemaet skal du forbinde QSPI flashhukommelser til GPIO pins.
*fortsatte…*

Dette nummer inkluderer ikke kommando- eller svarhovedet

				Vigtig: Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_READ	3A	2	N	Læser den vedhæftede quad SPI-enhed. Den maksimale overførselsstørrelse er 4 kilobyte (KB) eller 1024 ord. Tager to argumenter: Quad SPI flash-adressen (et ord). Adressen skal være ordjusteret. Enheden returnerer 0x1 fejlkoden for ikke-justerede adresser. Antal ord at læse (et ord). Når det lykkes, returneres OK efterfulgt af læste data fra quad SPI-enheden. Et fejlsvar returnerer en fejlkode. For en delvis vellykket læsning kan QSPI_READ fejlagtigt returnere OK-statussen. Note: Du kan ikke køre kommandoen QSPI_READ, mens enhedskonfiguration er i gang. Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_WRITE	39	2+N	0	Skriver data til quad SPI-enheden. Den maksimale overførselsstørrelse er 4 kilobyte (KB) eller 1024 ord. Tager tre argumenter: Flashadresseforskydningen (et ord). Skriveadressen skal være ordjusteret. Antallet af ord, der skal skrives (et ord). De data, der skal skrives (et eller flere ord). En vellykket skrivning returnerer OK-svarkoden. For at forberede hukommelsen til skrivninger skal du bruge QSPI_ERASE-kommandoen, før du udsteder denne kommando. Note: Du kan ikke køre kommandoen QSPI_WRITE, mens enhedskonfiguration er i gang. Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_ERASE	38	2	0	Sletter en 4/32/64 KB-sektor af quad SPI-enheden. Tager to argumenter: Flashadressen er forskudt for at starte sletningen (et ord). Afhængigt af antallet af ord, der skal slettes, skal startadressen være: 4 KB justeret, hvis talord, der skal slettes, er 0x400 32 KB justeret, hvis talord, der skal slettes, er 0x2000 64 KB justeret, hvis talord, der skal slettes, er 0x4000 Returnerer en fejl for ikke-4/32/64 KB justerede adresser. Antallet af ord, der skal slettes, er angivet i multipla af: 0x400 for at slette 4 KB (100 ord) data. Denne mulighed er den mindste slettestørrelse. 0x2000 for at slette 32 KB (500 ord) data 0x4000 for at slette 64 KB (1000 ord) data En vellykket sletning returnerer OK-svarkoden. Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.
QSPI_READ_ DEVICE_REG	35	2	N	Læser registre fra quad SPI-enheden. Den maksimale læsning er 8 bytes. Tager to argumenter: Opkoden for læsekommandoen. Antallet af bytes, der skal læses.
*fortsatte…*

Dette nummer inkluderer ikke kommando- eller svarhovedet.

En vellykket læsning returnerer OK-svarkoden efterfulgt af data læst fra enheden. Den læste data returneres i multiplum af 4 bytes. Hvis de bytes, der skal læses, ikke er et nøjagtigt multiplum af 4 bytes, udfyldes det med multiplum af 4 bytes, indtil den næste ordgrænse, og den polstrede bitværdi er nul.
Vigtig: Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.

QSPI_WRITE_ DEVICE_REG

2+N

Skriver til registre af quad SPI. Den maksimale skrivning er 8 bytes. Tager tre argumenter:

Opkoden for skrivekommandoen.
Antallet af bytes, der skal skrives.
Data til at skrive.

For at udføre en sektorsletning eller undersektorsletning skal du angive den serielle flash-adresse i rækkefølgen mest signifikant byte (MSB) til mindst signifikant byte (LSB) som følgende f.eks.ample illustrerer.
For at slette en sektor af et Micron 2 gigabit (Gb) flash på adressen 0x04FF0000 ved hjælp af QSPI_WRITE_DEVICE_REG kommandoen, skriv flash adressen i MSB til LSB rækkefølge som vist her:
Overskrift: 0x00003036 Opkode: 0x000000DC
Antal bytes at skrive: 0x00000004 Flash-adresse: 0x0000FF04
En vellykket skrivning returnerer OK-svarkoden. Denne kommando overfører data, der ikke er et multiplum af 4 bytes, til den næste ordgrænse. Kommandoen udfylder dataene med nul.
Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.

QSPI_SEND_ DEVICE_OP

Sender en kommandoopkode til quad SPI'en. Tager et argument:

Op-koden til at sende quad SPI-enheden.

En vellykket kommando returnerer OK-svarkoden.
Vigtig:Når du nulstiller quad SPI, skal du følge instruktionerne specificeret i Nulstilling af Quad SPI Flash på side 9.

For beskrivelser af CONFIG_STATUS og RSU_STATUS større og mindre fejlkoder, se appendiks: CONFIG_STATUS og RSU_STATUS fejlkodebeskrivelser i Mailbox Client Intel FPGA IP User Guide.
Relateret information

Mailbox Client Intel FPGA IP Brugervejledning: CONFIG_STATUS og RSU_STATUS fejlkodebeskrivelser
For mere information om CONFIG_STATUS- og RSU_STATUS-fejlkoderne.
Intel Agilex Power Management brugervejledning
For mere information om temperatursensorens kanalnumre og temperaturfølende dioder (TSD'er).
Intel Agilex Hard Processor System Technical Reference Manual

Intel Agilex Hard Processor System Remote System Update Brugervejledning

Fejlkodesvar

Tabel 8. Fejlkoder

Værdi (hex)		Fejlkodesvar	Beskrivelse
0		OK	Indikerer, at kommandoen blev gennemført. En kommando kan fejlagtigt returnere OK-status, hvis en kommando, som f.eks QSPI_READ er delvist vellykket.
1		INVALID_COMMAND	Indikerer, at den aktuelt indlæste boot-ROM ikke kan afkode eller genkende kommandokoden.
3		UNKNOWN_COMMAND	Indikerer, at den aktuelt indlæste firmware ikke kan afkode kommandokoden.
4		INVALID_COMMAND_ PARAMETRE	Angiver, at kommandoen er forkert formateret. F.eksample, længdefeltindstillingen i header er ikke gyldig.
6		COMMAND_INVALID_ON_ KILDE	Angiver, at kommandoen er fra en kilde, som den ikke er aktiveret for.
8		CLIENT_ID_NO_MATCH	Angiver, at klient-id'et ikke kan fuldføre anmodningen om at lukke den eksklusive adgang til quad SPI. Klient-id'et matcher ikke den eksisterende klient med den nuværende eksklusive adgang til quad SPI.
9		INVALID_ADRESSE	Adressen er ugyldig. Denne fejl angiver en af følgende forhold: En ikke-justeret adresse Et adresseområdeproblem Et problem med læsetilladelse En ugyldig chipvalgsværdi, der viser værdi på mere end 3 En ugyldig adresse i RSU-tilfælde En ugyldig bitmaskeværdi for GET_VOLTAGE kommando Et ugyldigt sidevalg for kommandoen GET_TEMPERATURE
A		AUTHENTICATION_FAIL	Indikerer konfigurations-bitstreamsignaturgodkendelsesfejl.
B		TIMEOUT	Denne fejl angiver timeout på grund af følgende forhold: Kommando Venter på, at QSPI_READ-handlingen er fuldført Venter på den ønskede temperaturaflæsning fra en af temperaturfølerne. Kan indikere en potentiel hardwarefejl i temperatursensoren.
C		HW_NOT_READY	Angiver en af følgende betingelser: Hardwaren er ikke klar. Kan indikere enten et initialiserings- eller konfigurationsproblem. Hardwaren kan referere til quad SPI. RSU-billede bruges ikke til at konfigurere FPGA.
D		HW_FEJL	Angiver, at kommandoen blev fuldført uden succes på grund af en hardwarefejl, der ikke kan genoprettes.
80 – 8F		COMMAND_SPECIFIC_ FEJL	Angiver en kommandospecifik fejl på grund af en SDM-kommando, du brugte.
			SDM Kommando		Fejlnavn			Fejlkode	Beskrivelse
			GET_CHIPID		EFUSE_SYSTEM_ FAILURE			0x82	Indikerer, at eFuse-cachemarkøren er ugyldig.
			QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/ QSPI_READ_D EVICE_REG/		QSPI_HW_ERROR			0x80	Angiver QSPI-flashhukommelsesfejl. Denne fejl angiver en af følgende forhold:
				QSPI_WRITE_ DEVICE_REG/ QSPI_SEND_D EVICE_OP/ QSPI_READ						Et QSPI flash chip valg indstillingsproblem Et QSPI flash initialiseringsproblem Et QSPI flash-nulstillingsproblem Et problem med opdatering af QSPI flash-indstillinger
						QSPI_ALREADY_ ÅBEN	0x81			Indikerer, at klientens eksklusive adgang til QSPI flash via QSPI_OPEN kommando allerede er åben.
100	NOT_CONFIGURED			Angiver, at enheden ikke er konfigureret.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ OPTAGET			Indikerer, at enheden er optaget på grund af følgende anvendelsestilfælde: RSU: Firmware kan ikke skifte til en anden version på grund af en intern fejl. HPS: HPS er optaget, når den er i HPS-omkonfigurationsprocessen eller HPS kold nulstilling.
2FF	ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE			Indikerer, at der ikke er noget gyldigt svar tilgængeligt.
3FF	ALT_SDM_MBOX_RESP_ FEJL			Generel fejl.

Fejlkodegendannelse
Tabellen nedenfor beskriver mulige trin til retablering fra en fejlkode. Fejlgendannelse afhænger af specifik brug.
Tabel 9. Fejlkodegendannelse for kendte fejlkoder

Værdi	Fejlkodesvar	Fejlkodegendannelse
4	INVALID_COMMAND_ PARAMETRE	Send kommandohovedet eller -hovedet igen med argumenter med korrigerede parametre. F.eksample, sørg for, at længdefeltindstillingen i header sendes med den korrekte værdi.
6	COMMAND_INVALID_ ON_SOURCE	Send kommandoen igen fra en gyldig kilde, såsom JTAG, HPS eller kernestof.
8	CLIENT_ID_NO_MATCH	Vent på, at klienten, der åbnede adgangen til quad SPI, fuldfører sin adgang og lukker derefter den eksklusive adgang til quad SPI.
9	INVALID_ADRESSE	Mulige fejlgendannelsestrin: For GET_VOLTAGE-kommando: Send kommando med en gyldig bitmaske. For GET_TEMPERATURE kommando: Send kommando med gyldig sensorplacering og sensormaske. For QSPI-drift: Send kommando med et gyldigt chipvalg. Send kommando med en gyldig QSPI flash-adresse. For RSU: Send kommando med en gyldig startadresse for fabriksbilledet eller applikationen.
B	TIMEOUT	Mulige gendannelsestrin: For kommandoen GET_TEMPERATURE: Prøv igen at sende kommandoen igen. Hvis problemet fortsætter, skal du omkonfigurere eller slukke for enheden. For QSPI-drift: Kontroller signalintegriteten af QSPI-grænseflader, og forsøg kommando igen. For HPS-genstart: Prøv igen at sende kommandoen igen.
C	HW_NOT_READY	Mulige gendannelsestrin: For QSPI-drift: Genkonfigurer enheden via kilden. Sørg for, at IP, der bruges til at bygge dit design, giver adgang til QSPI-flash. For RSU: Konfigurer enheden med RSU-billede.
80	QSPI_HW_ERROR	Kontroller QSPI-interfacesignalets integritet, og sørg for, at QSPI-enheden ikke er beskadiget.
81	QSPI_ALREADY_OPEN	Kunden har allerede åbnet QSPI. Fortsæt med næste operation.
82	EFUSE_SYSTEM_FAILURE	Forsøg omkonfiguration eller tænd/sluk. Hvis fejlen fortsætter efter omkonfiguration eller tænd/sluk, kan enheden være beskadiget og uoprettelig.
100	NOT_CONFIGURED	Send en bitstream, der konfigurerer HPS.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ OPTAGET	Mulige fejlgendannelsestrin: For QSPI-drift: Vent på igangværende konfiguration eller anden klient for at fuldføre driften. For RSU: Genkonfigurer enheden til at genoprette efter intern fejl. For HPS-genstart: Vent på, at omkonfigurationen via HPS eller HPS Cold Reset er fuldført.

Mailbox Client med Avalon Streaming Interface Intel FPGA IP Brugervejledning Dokumentarkiver

Se de seneste og tidligere versioner af denne brugervejledning Mailbox Client med Avalon Streaming Interface Intel FPGA IP Brugervejledning. Hvis en IP- eller softwareversion ikke er angivet, gælder brugervejledningen for den tidligere IP- eller softwareversion.

IP-versioner er de samme som Intel Quartus Prime Design Suite-softwareversioner op til v19.1. Fra Intel Quartus Prime Design Suite-softwareversion 19.2 eller nyere har IP-kerner et nyt IP-versionssystem.

Dokumentrevisionshistorik for postkasseklienten med Avalon Streaming Interface Intel FPGA IP Brugervejledning

Dokumentversion	Intel Quartus Prime-version		IP version	Ændringer
2022.09.26	22.3		1.0.1	Foretog følgende ændringer: Opdaterede GET_VOLTAGE kommandorække i Kommandoliste og beskrivelsestabel. Tilføjet note til Table Device Family Support. Revideret QSPI_SET_CS kommandobeskrivelse i tabellen Kommandoliste og Beskrivelse.
2022.04.04	22.1		1.0.1	Opdaterede kommandoliste og beskrivelsestabellen. Opdateret pin-statusbeskrivelse for CONFIG_STATUS-kommandoen. Fjernede REBOOT_HPS-kommandoen.
2021.10.04	21.3		1.0.1	Foretog følgende ændring: Revideret Kommandoliste og beskrivelse tabel. Opdateret beskrivelse for: CONFIG_STATUS RSU_STATUS
2021.06.21	21.2		1.0.1	Foretog følgende ændringer: Revideret Kommandoliste og beskrivelse tabel. Opdateret beskrivelse for: RSU_STATUS QSPI_OPEN QSPI_SET_CS QSPI_ERASE
2021.03.29	21.1		1.0.1	Foretog følgende ændringer: Revideret RSU_IMAGE_UPDATE-beskrivelse i Kommandoliste og beskrivelse tabel. Omstruktureret Operationskommandoer. Fjernede større og mindre fejlkodebeskrivelser for kommandoerne CONFIG_STATUS og RSU_STATUS. De større og mindre fejlkoder er nu dokumenteret som et bilag i Mailbox Client Intel FPGA IP Brugervejledning.
2020.12.14	20.4		1.0.1	Foretog følgende ændringer:
					Tilføjet vigtig bemærkning om nulstilling af QSPI-flash i Operationskommandoer emne. Opdateret Kommandoliste og beskrivelse bord: Revideret GET_TEMPERATURE kommandobeskrivelse. Revideret RSU_IMAGE_UPDATE kommandobeskrivelse. Tilføjet tekst om nulstilling af QSPI-flash. Tilføjet tekst, der beskriver adfærd mellem den eksterne vært og FPGA. Fjernet tekst: Returnerer et svar, der ikke er nul, hvis enheden allerede behandler en konfigurationskommando. Opdaterede QSPI_WRITE og QSPI_READ beskrivelser for at specificere, at den maksimale overførselsstørrelse er 4 kilobyte eller 1024 ord. Korrigeret svarlængde fra 1 til 0 for QSPI_OPEN, QSPI_CLOSE og QSPI_SET_CS kommando. Reviderede beskrivelser af QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG og QSPI_WRITE_DEVICE_REG. Tilføjet en ny kommando: REBOOT_HPS. Tilføjet nyt emne: Error Code Recovery.
2020.10.05	20.3	1.0.1			Ændrede titlen på denne brugervejledning fra Mailbox Avalon Streaming Interface Client Intel FPGA IP Brugervejledning til Mailbox Client med Avalon Streaming Interface Intel FPGA IP Brugervejledning på grund af IP-navneændringen i Intel Quartus Prime IP Catalog. Globalt opdateret alle IP-navne. Revideret GET TEMPERATURE kommandobeskrivelse for Intel Agilex-enheder i Kommandoliste og beskrivelse tabel. Tilføjet anbefaling om nulstillingssynkroniseringen i Ur og nulstil grænseflader tabel. Opdateret Fejlkoder tabel. Tilføjet nye fejlkodesvar: HW_FEJL COMMAND_SPECIFIC_ERROR Fjernede Temperatursensorplaceringer emne. Temperatursensoroplysningerne er tilgængelige i Intel Agilex Power Management brugervejledning.
2020.06.30	20.2	1.0.0			Ændrede titlen på denne brugervejledning fra Mailbox Avalon ST Client Intel FPGA IP Brugervejledning til Mailbox Avalon Streaming Interface Client Intel FPGA IP Brugervejledning. Omdøbt emnetitel Kommando- og svarhoved til Kommandoer og svar. Reviderede beskrivelser af ID, LENGTH og kommandokode/fejlkode i Kommando- og svarhovedbeskrivelse tabel. Omdøbt emnetitel Understøttede kommandoer til Operationskommandoer.
				Revideret følgende kommandobeskrivelse i Kommandoliste og beskrivelse bord: GET_TEMPERATURE RSU_STATUS QSPI_SET_CS Omdøbt emnetitel Fejlkoder til Fejlkodesvar. Fjernede UNKNOWN_BR kommando fra Fejlkode tabel.
2020.04.13	20.1		1.0.0	Foretog følgende ændringer: Tilføjet information om temperatursensorerne for GET_TEMPERATURE-kommandoen, inklusive figurer, der illustrerer TSD-placeringer. Tilføjet RSU_NOTIFY kommando i Kommandokodeliste og beskrivelse tabel. Opdateret Fejlkoder bord: Omdøbt INVALID_COMMAND_PARAMETERS til INVALID_LENGTH. Ændret COMMAND_INVALID_ON_SOURCE hex-værdi fra 5 til 6. Ændret CLIENT_ID_NO_MATCH hex-værdi fra 6 til 8. Ændret INVALID_ADDRESS hex-værdi fra 7 til 9. Tilføjet AUTHENTICATION_FAIL kommando. Ændret TIMEOUT hex-værdi fra 8 til B. Ændret HW_NOT_READY hex-værdi fra 9 til C.
2019.09.30	19.3		1.0.0	Første udgivelse.

For feedback, besøg venligst: FPGAtechdocfeedback@intel.com

Dokumenter/ressourcer

intel Mailbox Client med Avalon Streaming Interface FPGA IP [pdfBrugervejledning
Mailbox Client med Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Referencer

Brugermanual

Mailbox Client med Avalon® Streaming Interface Intel FPGA IP Overview