intel Mailbox Client sa Avalon Streaming Interface FPGA IP Korisničko uputstvo

intel Mailbox Client sa Avalon Streaming Interface FPGA IP Korisničko uputstvo

Sadržaj sakriti

1 Klijent poštanskog sandučeta sa Avalon® Streaming interfejsom Intel FPGA IP Overview

Klijent poštanskog sandučeta sa Avalon® Streaming interfejsom Intel FPGA IP Overview

Klijent poštanskog sandučeta sa Avalon® streaming interfejsom Intel® FPGA IP (Klijent poštanskog sandučeta sa Avalon ST klijentom IP) obezbeđuje kanal komunikacije između vaše prilagođene logike i bezbednog upravljača uređaja (SDM). Možete koristiti Mailbox Client sa Avalon ST IP za slanje komandnih paketa i primanje paketa odgovora od SDM perifernih modula. Klijent poštanskog sandučeta sa Avalon ST IP-om definira funkcije koje SDM pokreće.

Vaša prilagođena logika može koristiti ovaj komunikacijski kanal za primanje informacija i pristup flash memoriji sa sljedećih perifernih modula:

Čip ID
Senzor temperature

The Voltage senzor
Quad serial peripheral interface (SPI) fleš memorija

Napomena: U ovom korisničkom vodiču, izraz Avalon ST skraćuje Avalon streaming interfejs ili IP.

Slika 1. Klijent poštanskog sandučeta sa dizajnom IP sistema Avalon ST

Sljedeća slika prikazuje aplikaciju u kojoj klijent poštanskog sandučeta sa Avalon ST IP-om čita Chip ID.

Slika 2. Klijent poštanskog sandučeta sa Avalon ST IP čita ID čipa

Podrška porodici uređaja

U nastavku su navedene definicije nivoa podrške za uređaje za Intel FPGA IP:

Napredna podrška — IP je dostupan za simulaciju i kompilaciju za ovu familiju uređaja. Vremenski modeli uključuju početne inženjerske procjene kašnjenja zasnovane na ranim informacijama nakon rasporeda. Modeli vremena su podložni promjenama jer testiranje na silikonu poboljšava korelaciju između stvarnog silicijuma i vremenskih modela. Možete koristiti ovu IP adresu za studije arhitekture sistema i korištenja resursa, simulacije, pin out, procjene kašnjenja sistema, osnovne procjene vremena (proračunski budžet) i strategiju I/O prijenosa (širina putanje podataka, dubina bursta, trgovina I/O standardima offs).

Preliminarna podrška — IP je verifikovan sa preliminarnim modelima vremena za ovu familiju uređaja. IP ispunjava sve funkcionalne zahtjeve, ali je možda još uvijek u fazi analize vremena za porodicu uređaja. Može se koristiti u proizvodnim dizajnima s oprezom.
Konačna podrška — IP je verifikovan sa konačnim modelima vremena za ovu familiju uređaja. IP ispunjava sve funkcionalne i vremenske zahtjeve za familiju uređaja i može se koristiti u proizvodnim projektima.

Tabela 1. Podrška porodici uređaja

Porodica uređaja	Podrška
Intel Agilex™	Napred

Napomena: Ne možete simulirati klijenta poštanskog sandučeta sa Avalon Streaming Interface Intel FPGA IP jer IP prima odgovore od SDM-a. Da biste potvrdili ovu IP adresu, Intel preporučuje da izvršite procjenu hardvera.

Povezane informacije
Klijent poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP Napomene o izdanju

Parameters

Naziv parametra	Vrijednost	Opis
Omogući statusni interfejs	Uključeno isključeno	Kada omogućite ovaj interfejs, klijent poštanskog sandučeta sa Avalon interfejsom za striming Intel FPGA IP uključuje signal command_status_invalid. Kada se command_status_invalid potvrdi, morate resetirati IP.

Interfejsi
Sljedeća slika ilustruje klijenta poštanskog sandučeta sa Avalon Streaming Interface Intel FPGA IP interfejsima:

Slika 3. Klijent poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP interfejsima

Za više informacija o Avalon interfejsima za striming, pogledajte specifikacije Avalon interfejsa.
Povezane informacije
Specifikacije Avalon interfejsa

Sat i interfejs za resetovanje

Table 2. Sat i interfejs za resetovanje

Naziv signala	Smjer	Opis
in_clk	Input	Ovo je sat za Avalon streaming interfejse. Maksimalna frekvencija je 250 MHz.
in_reset	Input	Ovo je aktivni visoki reset. Potvrdite in_reset za resetovanje klijenta poštanskog sandučeta sa Avalon interfejsom za striming Intel FPGA IP (Klijent poštanskog sandučeta sa Avalon ST IP). Kada se in_reset signal potvrdi, SDM mora isprazniti sve aktivnosti na čekanju sa klijenta poštanskog sandučeta sa Avalon ST IP. SDM nastavlja da obrađuje komande od drugih klijenata. Da bi se osiguralo da klijent poštanskog sandučeta sa Avalon ST IP ispravno funkcioniše kada uređaj uđe u korisnički režim, vaš dizajn mora uključiti Reset Release Intel FPGA IP da zadrži resetovanje dok FPGA tkanina ne uđe u korisnički režim. Intel preporučuje upotrebu sinhronizatora za resetovanje kada povezujete korisnički reset ili izlaz Reset Release IP IP-a na
		port za resetovanje klijenta poštanskog sandučeta sa Avalon ST IP. Da biste implementirali sinhronizator za resetovanje, koristite Reset Bridge Intel FPGA IP koji je dostupan u Platform Designeru. Napomena: Za smjernice za instanciranje IP-a i povezivanje u Platform Designeru, pogledajte potrebnu komunikaciju i komponente hosta za dizajn udaljenog ažuriranja sistema Exampslika u Korisničkom vodiču za Intel Agilex konfiguraciju.

Command Interface
Koristite Avalon Streaming (Avalon ST) interfejs za slanje komandi SDM-u.

Tabela 3. Komandni interfejs

Naziv signala	Smjer	Opis
command_ready	Izlaz	Klijent poštanskog sandučeta sa Avalon ST Intel FPGA IP potvrđuje command_ready kada je spreman da primi komande iz aplikacije. Ready_latency je 0 ciklusa. Klijent poštanskog sandučeta sa Avalon ST može prihvatiti command_data[31:0] u istom ciklusu koji command_ready potvrđuje.
command_valid	Input	Signal command_valid potvrđuje da je command_data validan.
naredbeni_podaci[31:0]	Input	Sabirnica command_data pokreće komande do SDM-a. Pogledajte Listu naredbi i Opis za definicije naredbi.
command_startofpacket	Input	command_startofpacket se potvrđuje u prvom ciklusu komandnog paketa.
command_endofpacket	Input	Command_endofpacket potvrđuje u posljednjem ciklusu naredbe paket.

Slika 4. Tajming za Avalon ST komandni paket

Interfejs za odgovor
SDM Avalon ST Client IP šalje odgovore vašoj aplikaciji koristeći interfejs odgovora.

Tabela 4. Interfejs za odgovor

Signal 5	Smjer	Opis
response_ready	Input	Logika aplikacije može potvrditi signal response_ready kad god je u mogućnosti primiti odgovor.
response_valid	Izlaz	SDM potvrđuje response_valid da naznači da je response_data validan.
odgovor_podaci[31:0]	Izlaz	SDM pokreće response_data da pruži tražene informacije. Prva riječ odgovora je zaglavlje koje identificira naredbu koju SDM daje. Pogledajte Lista i opis komandi za definicije naredbi.
response_startofpacket	Izlaz	Response_startofpacket se potvrđuje u prvom ciklusu paketa odgovora.
response_endofpacket	Izlaz	Odgovor_endofpacket se potvrđuje u posljednjem ciklusu paketa odgovora.

Slika 5. Tajming za Avalon ST paket odgovora

Interfejs statusa komande

Tabela 5. Interfejs statusa komande

Naziv signala	Smjer	Opis
command_status_invalid	Izlaz	command_status_invalid potvrđuje da ukazuje na grešku. Ovaj signal obično pokazuje da dužina naredbe specificirana u zaglavlju komande ne odgovara dužini poslane naredbe. Kada se command_status_invalid potvrdi, logika vaše aplikacije mora potvrditi in_reset da bi ponovo pokrenula Mailbox Client sa Avalon streaming interfejsom Intel FPGA IP.

Slika 6. Resetiraj nakon command_status_invalid Asserts

Komande i odgovori

Host kontroler komunicira sa SDM koristeći pakete komandi i odgovora preko Intel FPGA IP klijenta poštanskog sandučeta.

Prva riječ paketa naredbi i odgovora je zaglavlje koje pruža osnovne informacije o naredbi ili odgovoru.

Slika 7. Format zaglavlja naredbi i odgovora

Napomena: Polje DUŽINA u zaglavlju komande mora odgovarati dužini komande odgovarajuće komande.
Sljedeća tabela opisuje polja naredbe zaglavlja.

Tabela 6. Opis zaglavlja naredbe i odgovora

Zaglavlje	Bit	Opis
Rezervirano	[31:28]	Rezervirano.
ID	[27:24]	ID naredbe. Zaglavlje odgovora vraća ID naveden u zaglavlju naredbe. Pogledajte Operativne naredbe za opise naredbi.
0	[23]	Rezervirano.
DUŽINA	[22:12]	Broj riječi argumenata iza zaglavlja. IP odgovara greškom ako se za datu komandu unese pogrešan broj riječi argumenata. Ako postoji neslaganje između dužine naredbe navedene u zaglavlju naredbe i broja poslanih riječi. IP podiže bit 3 registra statusa prekida (COMMAND_INVALID) i klijent poštanskog sandučeta mora biti resetovan.
Rezervirano	[11]	Rezervirano. Mora biti postavljeno na 0.
Kod naredbe/šifra greške	[10:0]	Kod naredbe specificira naredbu. Šifra greške pokazuje da li je komanda uspjela ili nije uspjela. U zaglavlju komande, ovi bitovi predstavljaju kod komande. U zaglavlju odgovora, ovi bitovi predstavljaju kod greške. Ako naredba uspije, kod greške je 0. Ako naredba ne uspije, pogledajte kodove grešaka definirane u Odgovori kodova greške.

Operativne naredbe

Resetovanje Quad SPI Flash
Važno: Za Intel Agilex uređaje, morate da povežete serijski ili četvorostruki SPI pin za resetovanje na AS_nRST pin. SDM mora u potpunosti kontrolirati QSPI reset. Nemojte povezivati pin za quad SPI za resetovanje ni na jedan spoljni host.

Tabela 7. Lista i opis komandi

Command	kod (hex)	Dužina naredbe (1)	Dužina odgovora (1)	Opis
NOOP	0	0	0	Šalje odgovor na status OK.
GET_IDCODE	10	0	1	Odgovor sadrži jedan argument koji je JTAG ID KOD za uređaj
GET_CHIPID	12	0	2	Odgovor sadrži 64-bitnu vrijednost CHIPID s najmanjom značajnom riječju.
GET_USERCODE	13	0	1	Odgovor sadrži jedan argument koji je 32-bitni JTAG USERCODE koji konfiguracijski bitstream zapisuje na uređaj.
GET_VOLTAGE	18	1	n(2)	GET_VOLTAGE komanda ima jedan argument koji je bitmaska koja specificira kanale za čitanje. Bit 0 specificira kanal 0, bit 1 specificira kanal 1, i tako dalje. Odgovor uključuje argument od jedne riječi za svaki bit postavljen u bitmasku. Voltage vraćen je nepotpisani broj fiksne točke sa 16 bita ispod binarne točke. Za nprample, a voltage od 0.75V vraća 0x0000C000. (3) Intel Agilex uređaji imaju jednu voltage senzor. Shodno tome, odgovor je uvijek jedna riječ.
GET_ TEMPERATURE	19	1	n(4)	Naredba GET_TEMPERATURE vraća temperaturu ili temperature jezgrene strukture ili lokacija kanala primopredajnika koje odredite. Za Intel Agilex uređaje, koristite argument senzor_req da navedete lokacije. Senzor_req uključuje sljedeća polja: Bitovi[31:28]: Rezervisano. Bitovi[27:16]: Lokacija senzora. Određuje TSD lokaciju. Bitovi[15:0]: Maska senzora. Određuje senzore za čitanje za navedenu lokaciju senzora. Odgovor sadrži jednu riječ za svaku traženu temperaturu. Ako se izostavi, komanda čita kanal 0. Najmanji značajni bit (lsb) odgovara senzoru 0. Najznačajniji bit (msb) odgovara kanalu 15. Vraćena temperatura je označena fiksna vrijednost sa 8 bita ispod binarne točke. Za nprample, temperatura od 10°C vraća 0x00000A00. A temperature -1.5°C vraća 0xFFFFFE80. Ako bitmaska specificira nevažeću lokaciju, naredba vraća kod greške koji je bilo koja vrijednost u rasponu 0x80000000 -0x800000FF. Za Intel Agilex uređaje, pogledajte Vodič za korisnike Intel Agilex Power Management za više informacija o lokalnim ugrađenim senzorima temperature.
RSU_IMAGE_ UPDATE	5C	2	0	Pokreće rekonfiguraciju iz izvora podataka koji može biti ili tvornička ili slika aplikacije.
nastavak…

Ovaj broj ne uključuje naredbu ili zaglavlje odgovora.
Za Intel Agilex uređaje koji podržavaju čitanje više uređaja, indeks n odgovara broju kanala koje omogućite na svom uređaju.
Pogledajte na Korisnički vodič za Intel Agilex Power Management za više informacija o kanalima i lokacijama senzora temperature.
Indeks n ovisi o broju senzorskih maski.

Command	kod (hex)	Dužina naredbe (1)	Dužina odgovora (1)	Opis
				Ova komanda uzima opcioni 64-bitni argument koji specificira adresu podataka o rekonfiguraciji u flash memoriji. Kada šaljete argument na IP, prvo šaljete bitove [31:0], a zatim bitove [63:32]. Ako ne navedete ovaj argument, pretpostavlja se da je njegova vrijednost 0. Bit [31:0]: Početna adresa slike aplikacije. Bit [63:32]: Rezervisano (upišite kao 0). Jednom kada uređaj obradi ovu naredbu, vraća zaglavlje odgovora u FIFO odgovor prije nego što nastavi s rekonfiguracijom uređaja. Osigurajte da glavni računar ili glavni kontroler prestanu da servisiraju druge prekide i da se fokusiraju na čitanje podataka zaglavlja odgovora kako bi ukazali da je naredba uspješno završena. U suprotnom, host PC ili host kontroler možda neće moći primiti odgovor nakon što započne proces rekonfiguracije. Kada uređaj nastavi sa rekonfiguracijom, veza između vanjskog hosta i FPGA se gubi. Ako koristite PCIe u svom dizajnu, morate ponovo nabrojati PCIe vezu. Važno: Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
RSU_GET_SPT	5A	0	4	RSU_GET_SPT preuzima quad SPI flash lokaciju za dvije tabele podparticija koje RSU koristi: SPT0 i SPT1. Odgovor od 4 riječi sadrži sljedeće informacije:
				Riječ	Ime	Opis
				0	SPT0[63:32]	SPT0 adresa u quad SPI flash.
				1	SPT0[31:0]
				2	SPT1[63:32]	SPT1 adresa u quad SPI flash.
				3	SPT1[31:0]
CONFIG_ STATUS	4	0	6	Izvještava o statusu posljednje rekonfiguracije. Ovu naredbu možete koristiti za provjeru statusa konfiguracije tokom i nakon konfiguracije. Odgovor sadrži sljedeće informacije:
				Riječ	Rezime	Opis
				0	Država	Opisuje najnoviju grešku u vezi s konfiguracijom. Vraća 0 kada nema grešaka u konfiguraciji. Polje greške ima 2 polja: Gornjih 16 bita: kod velike greške. Donjih 16 bita: Manji kod greške. Pogledajte Dodatak: CONFIG_STATUS i RSU_STATUS Opisi kodova greške u poštanskom sandučetu klijenta Intel FPGA IP Uputstvo za upotrebu za više informacija.
				1	Quartus verzija	Dostupno u verzijama softvera Intel Quartus® Prime između 19.4 i 21.2, polje prikazuje: Bit [31:28]: Indeks firmvera ili kopije firmvera odluke koja je posljednja korištena. Moguće vrijednosti su 0, 1, 2 i 3. Bit [27:24]: Rezervisano Bit [23:16]: Vrijednost je '0'

						Dostupan u verziji softvera Intel Quartus Prime 21.3 ili novijoj, verzija Quartus prikazuje: Bit [31:28]: Indeks firmvera ili kopije firmvera odluke koja je posljednja korištena. Moguće vrijednosti su 0, 1, 2 i 3. Bit [27:24]: Rezervisano Bit [23:16]: Broj izdanja Major Quartusa Bit [15:8]: Minor Quartus broj izdanja Bit [7:0]: Quartus ažurirani broj Za nprampda, u verziji softvera Intel Quartus Prime 21.3.1, sljedeće vrijednosti predstavljaju glavne i manje Quartusove brojeve izdanja i Quartus broj ažuriranja: 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]: Trenutna izlazna vrijednost nSTATUS (aktivno nisko) Bit [30]: Detektovana ulazna vrijednost nCONFIG (aktivno niska) Bit [29:8]: Rezervisano Bit [7:6]: Izvor takta konfiguracije 01 = Interni oscilator 10 = OSC_CLK_1 Bit [5:3]: Rezervisano Bit [2:0]: MSEL vrijednost pri uključivanju
				3	Status meke funkcije	Sadrži vrijednost svake od mekih funkcija, čak i ako funkciju niste dodijelili SDM pinu. Bit [31:6]: Rezervisano Bit [5]: HPS_WARRMRESET Bit [4]: HPS_COLDRESET Bit [3]: SEU_ERROR Bit [2]: CVP_DONE Bit [1]: INIT_DONE Bit [0]: CONF_DONE
				4	Lokacija greške	Sadrži lokaciju greške. Vraća 0 ako nema grešaka.
				5	Detalji o grešci	Sadrži detalje o grešci. Vraća 0 ako nema grešaka.
RSU_STATUS	5B	0	9	Izvještava o trenutnom statusu nadogradnje udaljenog sistema. Ovu naredbu možete koristiti za provjeru statusa konfiguracije tokom konfiguracije i nakon njenog završetka. Ova komanda vraća sljedeće odgovore:
				Riječ	Rezime	Opis (Nastavi….)

Ovaj broj ne uključuje naredbu ili zaglavlje odgovora

	0-1	Trenutna slika	Flash offset trenutno pokrenute slike aplikacije.
	2-3	Failing image	Flash offset slike neuspjele aplikacije najvišeg prioriteta. Ako je više slika dostupno u flash memoriji, pohranjuje vrijednost prve slike koja nije uspjela. Vrijednost svih 0s označava da nema neispravnih slika. Ako nema neispravnih slika, ostatak preostalih riječi informacija o statusu ne pohranjuje valjane informacije. Napomena:Rastuća ivica na nCONFIG za rekonfiguraciju sa ASx4, ne briše ovo polje. Informacije o neuspješnoj slici ažuriraju se samo kada klijent poštanskog sandučeta primi novu naredbu RSU_IMAGE_UPDATE i uspješno se konfiguriše iz slike za ažuriranje.
	4	Država	Kôd greške neispravne slike. Polje greške ima dva dijela: Bit [31:16]: Kod velike greške Bit [15:0]: Manji kod greške Vraća 0 bez grešaka. Pogledajte Dodatak: Opisi kodova greške CONFIG_STATUS i RSU_STATUS u korisničkom vodiču za Intel FPGA IP klijenta poštanskog sandučeta za više informacija.
	5	Verzija	Verzija RSU interfejsa i izvor greške. Za više informacija pogledajte RSU status i šifre grešaka u korisničkom vodiču za daljinsko ažuriranje sistema hard procesora.
	6	Lokacija greške	Pohranjuje lokaciju greške neispravne slike. Vraća 0 bez grešaka.
	7	Detalji o grešci	Pohranjuje detalje greške za neispravnu sliku. Vraća 0 ako nema grešaka.
	8	Brojač pokušaja trenutne slike	Broj pokušaja pokušaja za trenutnu sliku. Brojač je u početku 0. Brojač se postavlja na 1 nakon prvog pokušaja, zatim na 2 nakon drugog pokušaja. Odredite maksimalan broj ponovnih pokušaja u postavkama Intel Quartus Prime File (.qsf). Naredba je: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Važeće vrijednosti za brojač MAX_RETRY su 1-3. Stvarni broj dostupnih pokušaja je MAX_RETRY -1 Ovo polje je dodato u verziji 19.3 softvera Intel Quartus Prime Pro Edition.
*nastavak…*

Ovaj broj ne uključuje naredbu ili zaglavlje odgovora.

RSU_NOTIFY	5D	1	0	Briše sve informacije o grešci u RSU_STATUS odgovoru i resetuje brojač ponovnih pokušaja. Argument od jedne riječi ima sljedeća polja: 0x00050000: Obriši brojač ponovnog pokušaja resetiranja struje. Poništavanje trenutnog brojača ponovnih pokušaja vraća brojač na nulu, kao da je trenutna slika uspješno učitana po prvi put. 0x00060000: Obrišite informacije o statusu greške. Sve ostale vrijednosti su rezervirane. Ova komanda nije dostupna prije verzije 19.3 softvera Intel Quartus Prime Pro Edition.
QSPI_OPEN	32	0	0	Zahtijeva ekskluzivni pristup quad SPI. Ovaj zahtjev izdajete prije bilo kojeg drugog QSPI zahtjeva. SDM prihvaća zahtjev ako quad SPI nije u upotrebi i SDM ne konfiguriše uređaj. Vraća OK ako SDM odobri pristup. SDM odobrava ekskluzivni pristup klijentu koristeći ovo poštansko sanduče. Drugi klijenti ne mogu pristupiti quad SPI sve dok aktivni klijent ne odustane od pristupa pomoću naredbe QSPI_CLOSE. Pristup četverostrukim SPI flash memorijskim uređajima preko bilo kojeg IP-a klijenta poštanskog sandučeta nije dostupan prema zadanim postavkama u dizajnima koji uključuju HPS, osim ako ne onemogućite QSPI u konfiguraciji HPS softvera. Važno: Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_CLOSE	33	0	0	Zatvara ekskluzivni pristup quad SPI interfejsu. Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_SET_CS	34	1	0	Određuje jedan od priključenih quad SPI uređaja putem linija za odabir čipa. Uzima argument od jedne riječi kao što je opisano u nastavku Bitovi[31:28]: Flash uređaj za odabir. Pogledajte informacije ispod za vrijednost koja odgovara nCSO[0:3] pinovima Vrijednost 4'h0000 bira blic koji odgovara nCSO[0]. Vrijednost 4'h0001 bira blic koji odgovara nCSO[1]. Vrijednost 4'h0002 bira blic koji odgovara nCSO[2]. Vrijednost 4'h0003 odabire blic koji odgovara nCSO[3]. Bitovi [27:0]: Rezervisani (upišite kao 0). Napomena: Intel Agilex ili Intel Stratix® 10 uređaji podržavaju jedan AS x4 fleš memorijski uređaj za AS konfiguraciju sa quad SPI uređaja povezanog na nCSO[0]. Kada uređaj uđe u korisnički režim, možete koristiti do četiri AS x4 fleš memorije za korišćenje sa IP-om klijenta poštanskog sandučeta ili HPS-om kao skladištenjem podataka. TheMailbox Client IP ili HPS mogu koristiti nCSO[3:0] za pristup quad SPI uređajima. Ova naredba je opciona za konfiguracijsku shemu AS x4, linija za odabir čipa slijedi posljednju izvršenu QSPI_SET_CS naredbu ili je zadana na nCSO[0] nakon AS x4 konfiguracije. The JTAG konfiguraciona šema zahteva izvršavanje ove naredbe za pristup QSPI flešu koji povezuje SDM_IO pinove. Pristup QSPI flash memorijskim uređajima koji koriste SDM_IO pinove je dostupan samo za AS x4 konfiguracijsku šemu, JTAG konfiguraciju, i dizajn kompajliran za AS x4 konfiguraciju. Za šemu konfiguracije Avalon streaming interfejsa (Avalon ST), morate povezati QSPI fleš memorije na GPIO pinove.
*nastavak…*

Ovaj broj ne uključuje naredbu ili zaglavlje odgovora

				Važno: Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_READ	3A	2	N	Čita priključeni quad SPI uređaj. Maksimalna veličina prijenosa je 4 kilobajta (KB) ili 1024 riječi. Uzima dva argumenta: Četvorostruka SPI flash adresa (jedna riječ). Adresa mora biti poravnata po riječima. Uređaj vraća kod greške 0x1 za neusklađene adrese. Broj riječi za čitanje (jedna riječ). Kada je uspješan, vraća OK nakon čega slijede pročitani podaci sa quad SPI uređaja. Odgovor na grešku vraća kod greške. Za djelomično uspješno čitanje, QSPI_READ može greškom vratiti status OK. Napomena: Ne možete pokrenuti naredbu QSPI_READ dok je konfiguracija uređaja u toku. Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_WRITE	39	2+N	0	Zapisuje podatke na quad SPI uređaj. Maksimalna veličina prijenosa je 4 kilobajta (KB) ili 1024 riječi. Uzima tri argumenta: Pomak flash adrese (jedna riječ). Adresa za pisanje mora biti poravnata po riječima. Broj riječi koje treba napisati (jedna riječ). Podaci koje treba napisati (jedna ili više riječi). Uspješno upisivanje vraća kod odgovora OK. Za pripremu memorije za upisivanje, koristite naredbu QSPI_ERASE prije izdavanja ove naredbe. Napomena: Ne možete pokrenuti naredbu QSPI_WRITE dok je konfiguracija uređaja u toku. Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_ERASE	38	2	0	Briše sektor od 4/32/64 KB na quad SPI uređaju. Uzima dva argumenta: Pomak flash adrese za početak brisanja (jedna riječ). U zavisnosti od broja riječi koje treba izbrisati, početna adresa mora biti: 4 KB poravnato ako je broj riječi za brisanje 0x400 32 KB poravnato ako je broj riječi za brisanje 0x2000 64 KB poravnato ako je broj riječi za brisanje 0x4000 Vraća grešku za ne-4/32/64 KB poravnate adrese. Broj riječi za brisanje naveden je u višekratnicima: 0x400 za brisanje 4 KB (100 riječi) podataka. Ova opcija je minimalna veličina brisanja. 0x2000 za brisanje 32 KB (500 riječi) podataka 0x4000 za brisanje 64 KB (1000 riječi) podataka Uspješno brisanje vraća kod odgovora OK. Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.
QSPI_READ_ DEVICE_REG	35	2	N	Čita registre sa quad SPI uređaja. Maksimalno čitanje je 8 bajtova. Uzima dva argumenta: Opkod za naredbu za čitanje. Broj bajtova za čitanje.
*nastavak…*

Ovaj broj ne uključuje naredbu ili zaglavlje odgovora.

Uspješno čitanje vraća kod odgovora OK nakon kojeg slijede podaci pročitani s uređaja. Povrat pročitanih podataka je višestruk od 4 bajta. Ako bajtovi za čitanje nisu tačan umnožak od 4 bajta, dopunjava se sa višestrukim od 4 bajta do sljedeće granice riječi i dopunjena vrijednost bita nije nula.
Važno: Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.

QSPI_WRITE_ DEVICE_REG

2+N

Upisuje u registre quad SPI. Maksimalni upis je 8 bajtova. Uzima tri argumenta:

Opkod za naredbu pisanja.
Broj bajtova za pisanje.
Podaci za pisanje.

Da biste izvršili brisanje sektora ili podsektora, morate specificirati serijsku flash adresu od najvećeg bajta (MSB) do najmanje značajnog bajta (LSB) kao što slijedi npr.ample ilustrira.
Da biste izbrisali sektor flash memorije Micron 2 gigabita (Gb) na adresi 0x04FF0000 pomoću naredbe QSPI_WRITE_DEVICE_REG, upišite flash adresu u MSB prema LSB redoslijedu kao što je prikazano ovdje:
Zaglavlje: 0x00003036 Opcode: 0x000000DC
Broj bajtova za pisanje: 0x00000004 Flash adresa: 0x0000FF04
Uspješno upisivanje vraća kod odgovora OK. Ova naredba dodaje podatke koji nisu višestruki od 4 bajta do sljedeće granice riječi. Komanda dodaje podatke nulom.
Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.

QSPI_SEND_ DEVICE_OP

Šalje operacijski kod komande na quad SPI. Uzima jedan argument:

Opkod za slanje quad SPI uređaja.

Uspješna komanda vraća kod odgovora OK.
Važno:Kada resetujete quad SPI, morate slijediti upute navedene u Resetovanje Quad SPI Flash na strani 9.

Za CONFIG_STATUS i RSU_STATUS opise velikih i manjih kodova greške, pogledajte Dodatak: Opisi kodova grešaka CONFIG_STATUS i RSU_STATUS u Korisničkom vodiču za Intel FPGA IP za klijenta poštanskog sandučeta.
Povezane informacije

Mailbox Client Intel FPGA IP korisnički vodič: CONFIG_STATUS i RSU_STATUS Opis kodova greške
Za više informacija o CONFIG_STATUS i RSU_STATUS kodovima greške.
Korisnički vodič za Intel Agilex Power Management
Za više informacija o brojevima kanala senzora temperature i diodama za senzor temperature (TSD).
Tehnički referentni priručnik za Intel Agilex sistem tvrdih procesora

Uputstvo za korisnike za daljinsko ažuriranje sistema Intel Agilex hard procesora

Odgovori kodova greške

Tabela 8. Kodovi grešaka

vrijednost (hex)		Odgovor koda greške	Opis
0		OK	Označava da je naredba uspješno završena. Komanda može greškom vratiti status OK ako komanda, kao što je QSPI_READ je djelimično uspješan.
1		INVALID_COMMAND	Označava da trenutno učitani ROM za pokretanje ne može dekodirati ili prepoznati komandni kod.
3		UNKNOWN_COMMAND	Označava da trenutno učitani firmver ne može dekodirati komandni kod.
4		INVALID_COMMAND_ PARAMETERS	Označava da je naredba pogrešno formatirana. Za nprample, postavka polja dužine u zaglavlju nije važeća.
6		COMMAND_INVALID_ON_ SOURCE	Označava da je naredba iz izvora za koji nije omogućena.
8		CLIENT_ID_NO_MATCH	Označava da ID klijenta ne može dovršiti zahtjev za zatvaranje ekskluzivnog pristupa quad SPI. ID klijenta ne odgovara postojećem klijentu sa trenutnim ekskluzivnim pristupom quad SPI.
9		INVALID_ADDRESS	Adresa je nevažeća. Ova greška ukazuje na jedan od sljedećih uslova: Neporavnana adresa Problem opsega adrese Problem s dozvolom za čitanje Nevažeća vrijednost odabira čipa, prikazuje vrijednost veću od 3 Nevažeća adresa u slučaju RSU Nevažeća vrijednost bitmaske za GET_VOLTAGE komanda Nevažeći odabir stranice za naredbu GET_TEMPERATURE
A		AUTHENTICATION_FAIL	Označava neuspjeh provjere autentičnosti potpisa bitstreama konfiguracije.
B		TIMEOUT	Ova greška ukazuje na vremensko ograničenje zbog sledećih uslova: Command Čeka se završetak operacije QSPI_READ Čeka se traženo očitanje temperature od jednog od temperaturnih senzora. Može ukazivati na potencijalnu hardversku grešku u senzoru temperature.
C		HW_NOT_READY	Označava jedan od sljedećih uslova: Hardver nije spreman. Može ukazivati na problem inicijalizacije ili konfiguracije. Hardver se može odnositi na quad SPI. RSU slika se ne koristi za konfiguraciju FPGA.
D		HW_ERROR	Označava da je komanda neuspješno završena zbog nepopravljive hardverske greške.
80 – 8F		COMMAND_SPECIFIC_ ERROR	Označava grešku specifičnu za naredbu zbog SDM naredbe koju ste koristili.
			SDM Command		Naziv greške			Kôd greške	Opis
			GET_CHIPID		EFUSE_SYSTEM_ FAILURE			0x82	Označava da je pokazivač keš memorije eFuse nevažeći.
			QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/ QSPI_READ_D EVICE_REG/		QSPI_HW_ERROR			0x80	Ukazuje na grešku QSPI fleš memorije. Ova greška ukazuje na jedan od sljedećih uslova:
				QSPI_WRITE_ DEVICE_REG/ QSPI_SEND_D EVICE_OP/ QSPI_READ						Problem pri odabiru QSPI flash čipa Problem s QSPI flash inicijalizacijom Problem sa QSPI resetovanjem blica Problem ažuriranja QSPI flash postavki
						QSPI_VEĆ_ OTVOREN	0x81			Označava da je klijentov ekskluzivni pristup QSPI flash preko QSPI_OPEN komande već otvoren.
100	NOT_CONFIGURED			Označava da uređaj nije konfigurisan.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ ZAUZET			Označava da je uređaj zauzet zbog sljedećih slučajeva upotrebe: RSU: Firmver ne može preći na drugu verziju zbog interne greške. HPS: HPS je zauzet kada je u procesu rekonfiguracije HPS-a ili HPS hladnog resetiranja.
2FF	ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE			Označava da nema dostupnog važećeg odgovora.
3FF	ALT_SDM_MBOX_RESP_ GREŠKA			Opća greška.

Oporavak koda greške
Tabela u nastavku opisuje moguće korake za oporavak od koda greške. Oporavak od greške zavisi od specifičnog slučaja upotrebe.
Tabela 9. Oporavak koda greške za poznate kodove grešaka

Vrijednost	Odgovor koda greške	Oporavak koda greške
4	INVALID_COMMAND_ PARAMETERS	Ponovo pošaljite zaglavlje naredbe ili zaglavlje s argumentima s ispravljenim parametrima. Za nprampUvjerite se da je postavka polja dužine u zaglavlju poslana s ispravnom vrijednošću.
6	COMMAND_INVALID_ ON_SOURCE	Ponovo pošaljite naredbu iz važećeg izvora kao što je JTAG, HPS ili jezgro tkanine.
8	CLIENT_ID_NO_MATCH	Pričekajte da klijent koji je otvorio pristup quad SPI-u završi svoj pristup, a zatim zatvori ekskluzivni pristup quad SPI-u.
9	INVALID_ADDRESS	Mogući koraci za oporavak od greške: Za GET_VOLTAGE komanda: Pošaljite naredbu s valjanom bitmaskom. Za naredbu GET_TEMPERATURE: Pošaljite naredbu s važećom lokacijom senzora i maskom senzora. Za QSPI rad: Pošaljite naredbu s važećim odabirom čipa. Pošaljite naredbu s važećom QSPI flash adresom. Za RSU: Pošaljite naredbu s važećom početnom adresom tvorničke slike ili aplikacije.
B	TIMEOUT	Mogući koraci oporavka: Za naredbu GET_TEMPERATURE: Pokušajte ponovo poslati naredbu. Ako problem i dalje postoji, ponovo konfigurirajte ili isključite uređaj. Za QSPI rad: Provjerite integritet signala QSPI sučelja i pokušajte ponovo naredbu. Za operaciju ponovnog pokretanja HPS-a: Pokušajte ponovo da pošaljete naredbu.
C	HW_NOT_READY	Mogući koraci oporavka: Za QSPI rad: Ponovno konfigurirajte uređaj putem izvora. Uvjerite se da IP korišten za izradu vašeg dizajna omogućava pristup QSPI flash-u. Za RSU: Konfigurirajte uređaj sa RSU slikom.
80	QSPI_HW_ERROR	Provjerite integritet signala QSPI interfejsa i osigurajte da QSPI uređaj nije oštećen.
81	QSPI_ALREADY_OPEN	Klijent je već otvorio QSPI. Nastavite sa sljedećom operacijom.
82	EFUSE_SYSTEM_FAILURE	Pokušaj rekonfiguracije ili ciklusa napajanja. Ako se greška nastavi nakon rekonfiguracije ili ciklusa napajanja, uređaj može biti oštećen i nepopravljiv.
100	NOT_CONFIGURED	Pošaljite bitstream koji konfigurira HPS.
1FF	ALT_SDM_MBOX_RESP_ DEVICE_ ZAUZET	Mogući koraci za oporavak od greške: Za QSPI operaciju: Pričekajte da konfiguracija u toku ili drugi klijent završi operaciju. Za RSU: Ponovno konfigurirajte uređaj za oporavak od interne greške. Za operaciju ponovnog pokretanja HPS-a: Sačekajte da se rekonfiguracija putem HPS-a ili HPS-ovog hladnog resetiranja završi.

Klijent poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP Uputstvo za korisnike Arhiva dokumenata

Za najnoviju i prethodnu verziju ovog korisničkog vodiča, pogledajte Klijent poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP Uputstvo za upotrebu. Ako IP ili verzija softvera nisu navedeni, primjenjuje se korisnički vodič za prethodnu IP ili verziju softvera.

IP verzije su iste kao verzije softvera Intel Quartus Prime Design Suite do v19.1. Od verzije softvera Intel Quartus Prime Design Suite 19.2 ili novije, IP jezgre imaju novu šemu IP verzija.

Istorija revizija dokumenta za klijenta poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP korisnički vodič

Verzija dokumenta	Intel Quartus Prime verzija		IP verzija	Promjene
2022.09.26	22.3		1.0.1	Napravio sljedeće izmjene: Ažuriran GET_VOLTAGE komandni red u Lista naredbi i tabela opisa. Dodata napomena za podršku porodice stolnih uređaja. Revidirano QSPI_SET_CS opis komande u listi komandi i tabeli opisa.
2022.04.04	22.1		1.0.1	Ažurirana lista komandi i tabela opisa. Ažuriran opis statusa pina za naredbu CONFIG_STATUS. Uklonjena naredba REBOOT_HPS.
2021.10.04	21.3		1.0.1	Napravio sljedeću promjenu: Revidirano Lista i opis komandi sto. Ažuriran opis za: CONFIG_STATUS RSU_STATUS
2021.06.21	21.2		1.0.1	Napravio sljedeće izmjene: Revidirano Lista i opis komandi sto. Ažuriran opis za: RSU_STATUS QSPI_OPEN QSPI_SET_CS QSPI_ERASE
2021.03.29	21.1		1.0.1	Napravio sljedeće izmjene: Revidirani RSU_IMAGE_UPDATE opis u Lista i opis komandi sto. Restrukturiran Operativne naredbe. Uklonjeni su opisi kodova velikih i manjih grešaka za naredbe CONFIG_STATUS i RSU_STATUS. Glavni i manji kodovi grešaka su sada dokumentovani kao dodatak u Mailbox Client Intel FPGA IP korisnički priručnik.
2020.12.14	20.4		1.0.1	Napravio sljedeće izmjene:
					Dodata važna napomena o resetovanju QSPI flash-a u Operativne naredbe tema. Ažurirano Lista i opis komandi stol: Revidirani opis naredbe GET_TEMPERATURE. Revidirani opis komande RSU_IMAGE_UPDATE. Dodan tekst o resetovanju QSPI flash-a. Dodan tekst koji opisuje ponašanje između vanjskog hosta i FPGA. Uklonjen tekst: Vraća odgovor koji nije nula ako uređaj već obrađuje konfiguracijsku naredbu. Ažurirani opisi QSPI_WRITE i QSPI_READ da specificiraju da je maksimalna veličina prijenosa 4 kilobajta ili 1024 riječi. Ispravljena dužina odgovora od 1 do 0 za QSPI_OPEN, QSPI_CLOSE i QSPI_SET_CS komanda. Revidirani opisi QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG i QSPI_WRITE_DEVICE_REG. Dodata nova naredba: REBOOT_HPS. Dodata nova tema: Oporavak koda greške.
2020.10.05	20.3	1.0.1			Promijenjen naslov ovog korisničkog vodiča iz Poštansko sanduče Avalon Streaming Interface Client Intel FPGA IP korisnički priručnik to Klijent poštanskog sandučeta sa Avalon Streaming interfejsom Intel FPGA IP Uputstvo za upotrebu zbog promjene IP imena u Intel Quartus Prime IP katalogu. Globalno ažurirane sve instance IP imena. Revidirani opis naredbe GET TEMPERATURE za Intel Agilex uređaje u Lista i opis komandi sto. Dodata preporuka o resetovanju sinhronizatora u Sat i interfejs za resetovanje sto. Ažurirano Kodovi grešaka sto. Dodani novi odgovori koda greške: HW_ERROR COMMAND_SPECIFIC_ERROR Uklonjeno Lokacije temperaturnih senzora tema. Informacije o senzoru temperature dostupne su u Korisnički vodič za Intel Agilex Power Management.
2020.06.30	20.2	1.0.0			Promijenjen naslov ovog korisničkog vodiča iz Poštansko sanduče Avalon ST Client Intel FPGA IP Korisničko uputstvo to Poštansko sanduče Avalon Streaming Interface Client Intel FPGA IP korisnički priručnik. Preimenovan naslov teme Zaglavlje komandi i odgovora to Komande i odgovori. Revidirani ID, DUŽINA i opisi koda naredbe/koda greške u Opis zaglavlja naredbe i odgovora sto. Preimenovan naslov teme Podržane komande to Operativne naredbe.
				Revidiran je sljedeći opis komandi u Lista i opis komandi stol: GET_TEMPERATURE RSU_STATUS QSPI_SET_CS Preimenovan naslov teme Kodovi grešaka to Odgovori kodova greške. Uklonjena naredba UNKNOWN_BR iz Kod greške sto.
2020.04.13	20.1		1.0.0	Napravio sljedeće izmjene: Dodane su informacije o senzorima temperature za naredbu GET_TEMPERATURE, uključujući slike koje ilustriraju TSD lokacije. Dodata naredba RSU_NOTIFY u Lista i opis komandnih kodova sto. Ažurirano Kodovi grešaka stol: Preimenovano u INVALID_COMMAND_PARAMETERS u INVALID_LENGTH. Promijenjena heksadecimalna vrijednost COMMAND_INVALID_ON_SOURCE sa 5 na 6. Promijenjena heksadecimalna vrijednost CLIENT_ID_NO_MATCH sa 6 na 8. Promijenjena heksadecimalna vrijednost INVALID_ADDRESS sa 7 na 9. Dodata naredba AUTHENTICATION_FAIL. Promijenjena heksadecimalna vrijednost TIMEOUT sa 8 na B. Promijenjena hex vrijednost HW_NOT_READY sa 9 na C.
2019.09.30	19.3		1.0.0	Prvo izdanje.

Za povratne informacije posjetite: FPGAtechdocfeedback@intel.com

Dokumenti / Resursi

intel Mailbox Client sa Avalon Streaming Interface FPGA IP [pdf] Korisnički priručnik
Klijent poštanskog sandučeta sa Avalon Streaming Interface FPGA IP, Klijent poštanskog sandučeta, Avalon Streaming Interface FPGA IP

Reference

Uputstvo za upotrebu

Klijent poštanskog sandučeta sa Avalon® Streaming interfejsom Intel FPGA IP Overview