Používateľská príručka poštového klienta intel s rozhraním Avalon Streaming FPGA IP
intel Mailbox Client s Avalon Streaming Interface FPGA IP

Mailbox Client s Avalon® Streaming Interface Intel FPGA IP Overview

Mailbox Client s Avalon® streaming rozhraním Intel® FPGA IP (Mailbox Client s Avalon ST Client IP) poskytuje komunikačný kanál medzi vašou vlastnou logikou a správcom bezpečných zariadení (SDM). Mailbox Client s Avalon ST IP môžete použiť na odosielanie paketov príkazov a prijímanie paketov odpovedí z periférnych modulov SDM. Mailbox Client s Avalon ST IP definuje funkcie, ktoré SDM spúšťa.

Vaša vlastná logika môže použiť tento komunikačný kanál na prijímanie informácií a prístup k flash pamäti z nasledujúcich periférnych modulov:

  • ID čipu
  • Senzor teploty
  • Zvtage Senzor
  • Flash pamäť Quad sériové periférne rozhranie (SPI).

Poznámka: V tejto používateľskej príručke výraz Avalon ST skracuje rozhranie streamovania Avalon alebo IP.

Obrázok 1. Klient poštovej schránky s dizajnom systému Avalon ST IP
Klient poštovej schránky s dizajnom systému Avalon ST IP

Nasledujúci obrázok zobrazuje aplikáciu, v ktorej Mailbox Client s Avalon ST IP číta ID čipu.

Obrázok 2. Klient poštovej schránky s Avalon ST IP číta ID čipu
Klient poštovej schránky s Avalon ST IP číta ID čipu

Podpora rodiny zariadení

Nasleduje zoznam definícií úrovní podpory zariadení pre IP adresy Intel FPGA:

  • Predbežná podpora — IP je k dispozícii na simuláciu a kompiláciu pre túto rodinu zariadení. Modely načasovania zahŕňajú počiatočné technické odhady oneskorení založené na skorých informáciách po rozložení. Modely časovania podliehajú zmenám, pretože testovanie kremíka zlepšuje koreláciu medzi skutočným kremíkom a modelmi časovania. Túto IP adresu môžete použiť na štúdie systémovej architektúry a využitia zdrojov, simuláciu, pin out, hodnotenie latencie systému, základné hodnotenie načasovania (rozpočtovanie potrubia) a stratégiu prenosu I/O (šírka dátovej cesty, hĺbka zhluku, obchodné štandardy I/O vypnutia).
  • Predbežná podpora — IP je overená pomocou predbežných modelov časovania pre túto rodinu zariadení. IP spĺňa všetky funkčné požiadavky, ale stále môže prebiehať analýza časovania pre rodinu zariadení. S opatrnosťou ho možno použiť vo výrobných návrhoch.
  • Záverečná podpora — IP je overená s konečnými modelmi časovania pre túto rodinu zariadení. IP spĺňa všetky funkčné a časové požiadavky pre rodinu zariadení a môže byť použitý vo výrobných návrhoch.

Tabuľka 1. Podpora rodiny zariadení

Rodina zariadení Podpora
Intel Agilex™ Advance

Poznámka: Klienta poštovej schránky nemôžete simulovať s Avalon Streaming Interface Intel FPGA IP, pretože IP prijíma odpovede z SDM. Na overenie tejto adresy IP spoločnosť Intel odporúča vykonať hodnotenie hardvéru.

Súvisiace informácie
Mailbox Client s Avalon Streaming Interface Poznámky k vydaniu Intel FPGA IP

Parametre

Názov parametra Hodnota Popis
Povoliť rozhranie stavu Zapnuté Vypnuté Keď povolíte toto rozhranie, klient poštovej schránky s rozhraním Avalon na streamovanie Intel FPGA IP obsahuje signál command_status_invalid. Keď command_status_invalid tvrdí, musíte resetovať IP.

Rozhrania
Nasledujúci obrázok ilustruje Mailbox Client s Avalon Streaming Interface Intel FPGA IP rozhraniami:

Obrázok 3. Mailbox Client s Avalon Streaming Interface Intel FPGA IP Interfaces
Mailbox Client s Avalon Streaming Interface Intel FPGA IP Interfaces

Ďalšie informácie o streamovacích rozhraniach Avalon nájdete v špecifikáciách rozhrania Avalon.
Súvisiace informácie
Špecifikácie rozhrania Avalon

Rozhrania hodín a resetovania

Tabuľka 2. Rozhrania hodín a resetovania

Názov signálu Smer Popis
in_clk Vstup Toto sú hodiny pre streamovacie rozhrania Avalon. Maximálna frekvencia v 250 MHz.
in_reset Vstup Toto je aktívny vysoký reset. Potvrdením in_reset resetujte poštového klienta s rozhraním Avalon na streamovanie Intel FPGA IP (klient poštových schránok s Avalon ST IP). Keď sa potvrdí signál in_reset, SDM musí vyprázdniť všetky čakajúce aktivity z klienta poštovej schránky s Avalon ST IP. SDM pokračuje v spracovaní príkazov od iných klientov.

Aby sa zabezpečilo, že klient poštovej schránky s Avalon ST IP funguje správne, keď zariadenie vstúpi do používateľského režimu, váš návrh musí obsahovať Reset Release Intel FPGA IP, aby sa reset udržal, kým tkanina FPGA neprejde do používateľského režimu. Spoločnosť Intel odporúča použiť resetovací synchronizátor pri pripájaní používateľského resetu alebo výstupu Reset Release IP k

resetovací port klienta poštovej schránky s Avalon ST IP. Na implementáciu resetovacieho synchronizátora použite Reset Bridge Intel FPGA IP dostupný v Platform Designer.

Poznámka: Pokyny na vytváranie inštancie IP a pripojenie v nástroji Platform Designer nájdete v časti Požadované komunikačné a hostiteľské komponenty pre návrh aktualizácie vzdialeného systému Example obrázok v používateľskej príručke konfigurácie Intel Agilex.

Rozhranie príkazov
Na odosielanie príkazov do SDM použite rozhranie Avalon Streaming (Avalon ST).

Tabuľka 3. Rozhranie príkazov

Názov signálu Smer Popis
command_ready Výstup Klient poštovej schránky s Avalon ST Intel FPGA IP uplatňuje príkaz command_ready, keď je pripravený prijímať príkazy z aplikácie. Pripravená_latencia je 0 cyklov. Mailbox Client s Avalon ST môže akceptovať command_data[31:0] v rovnakom cykle, v akom sa uplatňuje command_ready.
príkaz_platný Vstup Signál command_valid potvrdí, že command_data sú platné.
command_data[31:0] Vstup Zbernica command_data prenáša príkazy do SDM. Definície príkazov nájdete v časti Zoznam a popis príkazov.
command_startofpacket Vstup Command_startofpacket sa uplatňuje v prvom cykle príkazového paketu.
command_endofpacket Vstup Command_endofpacket uplatňuje v poslednom cykle príkazu paket.

Obrázok 4. Načasovanie pre Avalon ST Command Packet
obr:m Balík príkazov ST

Rozhranie odozvy
IP klienta SDM Avalon ST odosiela odpovede do vašej aplikácie pomocou rozhrania odpovede.

Tabuľka 4. Rozhranie odozvy

signál 5 Smer Popis
odpoveď_pripravená Vstup Aplikačná logika môže uplatniť signál response_ready vždy, keď je schopná prijať odpoveď.
odpoveď_platná Výstup SDM potvrdí response_valid, aby naznačil, že response_data sú platné.
response_data[31:0] Výstup SDM riadi response_data, aby poskytol požadované informácie. Prvé slovo odpovede je hlavička, ktorá identifikuje príkaz, ktorý poskytuje SDM. Odkazujú na Zoznam a popis príkazov pre definície príkazov.
response_startofpacket Výstup Response_startofpacket sa uplatňuje v prvom cykle paketu odpovede.
response_endofpacket Výstup Response_endofpacket sa uplatňuje v poslednom cykle paketu odpovede.

Obrázok 5. Časovanie pre Avalon ST Response Packet
Avalon ST Response Packet

Rozhranie stavu príkazov

Tabuľka 5. Rozhranie stavu príkazov

Názov signálu Smer Popis
command_status_invalid Výstup Command_status_invalid tvrdí, že ide o chybu. Tento signál zvyčajne tvrdí, že dĺžka príkazu špecifikovaná v hlavičke príkazu sa nezhoduje s dĺžkou odoslaného príkazu. Keď sa príkazový_status_invalid potvrdí, vaša aplikačná logika musí uplatniť in_reset, aby sa reštartoval klient poštovej schránky s rozhraním Avalon na streamovanie Intel FPGA IP.

Obrázok 6. Reset After command_status_invalid Asserts
obr: command_status_invalid Asserts

Príkazy a odpovede

Hostiteľský radič komunikuje s SDM pomocou paketov príkazov a odpovedí cez Mailbox Client Intel FPGA IP.

Prvé slovo paketov príkazu a odpovede je hlavička, ktorá poskytuje základné informácie o príkaze alebo odpovedi.

Obrázok 7. Formát hlavičky príkazov a odpovedí
obr.: Formát hlavičky príkazov a odpovedí

Poznámka: Pole LENGTH v hlavičke príkazu sa musí zhodovať s dĺžkou príkazu zodpovedajúceho príkazu.
Nasledujúca tabuľka popisuje polia príkazu hlavičky.

Tabuľka 6. Popis hlavičky príkazov a odpovedí

Hlavička Bit Popis
Rezervované [31:28] Rezervované.
ID [27:24] ID príkazu. Hlavička odpovede vracia ID zadané v hlavičke príkazu. Opis príkazov nájdete v časti Operačné príkazy.
0 [23] Rezervované.
DĹŽKA [22:12] Počet slov argumentov nasledujúcich za hlavičkou. IP odpovedá chybou, ak je pre daný príkaz zadaný nesprávny počet slov argumentov.
Ak existuje nesúlad medzi dĺžkou príkazu zadanou v hlavičke príkazu a počtom odoslaných slov. IP zvyšuje bit 3 Registra stavu prerušenia (COMMAND_INVALID) a Mailbox Client sa musí resetovať.
Rezervované [11] Rezervované. Musí byť nastavené na 0.
Kód príkazu/Kód chyby [10:0] Kód príkazu určuje príkaz. Kód chyby označuje, či bol príkaz úspešný alebo neúspešný.
V hlavičke príkazu tieto bity predstavujú kód príkazu. V hlavičke odpovede tieto bity predstavujú chybový kód. Ak je príkaz úspešný, kód chyby je 0. Ak príkaz zlyhá, pozrite si kódy chýb definované v Odpovede na chybový kód.

Operačné príkazy

Resetovanie Quad SPI Flash
Dôležité:
V prípade zariadení Intel Agilex musíte pripojiť sériový flash alebo quad SPI flash resetovací kolík ku kolíku AS_nRST. SDM musí plne ovládať reset QSPI. Nepripájajte quad SPI resetovací kolík k žiadnemu externému hostiteľovi.

Tabuľka 7. Zoznam a popis príkazov

Príkaz kód (hex.) Dĺžka príkazu (1) Dĺžka odozvy (1) Popis
NOOP 0 0 0 Odošle odpoveď stavu OK.
GET_IDCODE 10 0 1 Odpoveď obsahuje jeden argument, ktorým je JTAG IDCODE pre zariadenie
GET_CHIPID 12 0 2 Odpoveď obsahuje 64-bitovú hodnotu CHIPID s najmenej významným slovom ako prvým.
GET_USERCODE 13 0 1 Odpoveď obsahuje jeden argument, ktorým je 32-bitový JTAG USERCODE, ktorý konfiguračný bitový tok zapisuje do zariadenia.
GET_VOLTAGE 18 1 n(2) GET_VOLTAGPríkaz E má jeden argument, ktorým je bitová maska ​​určujúca kanály na čítanie. Bit 0 určuje kanál 0, bit 1 určuje kanál 1 atď.
Odpoveď obsahuje jednoslovný argument pre každý bit nastavený v bitovej maske. ZvtagVrátené e je číslo s pevnou desatinnou čiarkou bez znamienka so 16 bitmi pod binárnym bodom. Naprample, zvtage 0.75 V vráti 0x0000C000. (3)
Zariadenia Intel Agilex majú jeden objtage senzor. V dôsledku toho je odpoveď vždy jedno slovo.
GET_ TEMPERATURE 19 1 n(4) Príkaz GET_TEMPERATURE vráti teplotu alebo teploty základnej štruktúry alebo umiestnenia kanála vysielača/prijímača, ktoré určíte.

Pre zariadenia Intel Agilex použite na určenie umiestnení argument sensor_req. Senzor_req obsahuje nasledujúce polia:

  • Bity[31:28]: Vyhradené.
  • Bity[27:16]: Umiestnenie senzora. Určuje umiestnenie TSD.
  • Bity[15:0]: Maska senzora. Určuje snímače, ktoré sa majú čítať pre zadané umiestnenie snímača. Odpoveď obsahuje jedno slovo pre každú požadovanú teplotu. Ak sa vynechá, príkaz načíta kanál 0. Najnižší platný bit (lsb) zodpovedá senzoru 0. Najdôležitejší bit (msb) zodpovedá kanálu 15.

Vrátená teplota je pevná hodnota so znamienkom s 8 bitmi pod binárnym bodom. Naprample, teplota 10°C vráti 0x00000A00. A teploty -1.5°C vráti 0xFFFFFE80.
Ak bitová maska ​​určuje neplatné umiestnenie, príkaz vráti chybový kód, ktorým je ľubovoľná hodnota v rozsahu 0x80000000 -0x800000FF.
Pre zariadenia Intel Agilex si pozrite používateľskú príručku Intel Agilex Power Management, kde nájdete ďalšie informácie o lokálnych zabudovaných snímačoch teploty.

AKTUALIZÁCIA RSU_IMAGE_ 5C 2 0 Spustí rekonfiguráciu zo zdroja údajov, ktorým môže byť továreň alebo obraz aplikácie.
pokračovanie…
  1. Toto číslo nezahŕňa hlavičku príkazu alebo odpovede.
  2. V prípade zariadení Intel Agilex, ktoré podporujú čítanie viacerých zariadení, sa index n zhoduje s počtom kanálov, ktoré povolíte na svojom zariadení.
  3. Pozrite si Používateľská príručka správy napájania Intel Agilex pre viac informácií o kanáloch a umiestneniach snímačov teploty.
  4. Index n závisí od počtu masiek senzorov.
Príkaz kód (hex.) Dĺžka príkazu (1) Dĺžka odozvy (1) Popis
Tento príkaz má voliteľný 64-bitový argument, ktorý špecifikuje adresu rekonfiguračných údajov vo flashi. Pri odosielaní argumentu na IP najskôr odošlete bity [31:0] a potom bity [63:32]. Ak tento argument neuvediete, predpokladá sa, že jeho hodnota je 0.
  • Bit [31:0]: Počiatočná adresa obrázka aplikácie.
  • Bit [63:32]: Vyhradené (zapíšte ako 0).

Akonáhle zariadenie spracuje tento príkaz, vráti hlavičku odpovede do odpovede FIFO predtým, ako pristúpi k rekonfigurácii zariadenia. Zaistite, aby hostiteľský počítač alebo hostiteľský radič prestali obsluhovať ostatné prerušenia a zamerali sa na čítanie údajov hlavičky odpovede, aby naznačili, že príkaz bol úspešne dokončený. V opačnom prípade hostiteľský počítač alebo hostiteľský radič nemusí byť schopný prijať odpoveď po spustení procesu rekonfigurácie.
Akonáhle zariadenie pokračuje v rekonfigurácii, spojenie medzi externým hostiteľom a FPGA sa stratí. Ak vo svojom návrhu používate PCIe, musíte znova vymenovať prepojenie PCIe.
Dôležité: Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

RSU_GET_SPT 5A 0 4 RSU_GET_SPT získava umiestnenie flash quad SPI pre dve tabuľky podrozdielov, ktoré používa RSU: SPT0 a SPT1.
4-slovná odpoveď obsahuje nasledujúce informácie:
Slovo Meno Popis
0 SPT0[63:32] Adresa SPT0 v quad SPI flash.
1 SPT0[31:0]
2 SPT1[63:32] Adresa SPT1 v quad SPI flash.
3 SPT1[31:0]
CONFIG_ STATUS 4 0 6 Hlási stav poslednej rekonfigurácie. Tento príkaz môžete použiť na kontrolu stavu konfigurácie počas a po konfigurácii. Odpoveď obsahuje nasledujúce informácie:
Slovo Zhrnutie Popis
0 štátu Popisuje najnovšiu chybu súvisiacu s konfiguráciou. Vráti 0, ak sa nevyskytnú žiadne chyby konfigurácie.
Chybové pole má 2 polia:
  • Horných 16 bitov: Kód hlavnej chyby.
  • Spodných 16 bitov: Kód malej chyby.

Pozri prílohu: CONFIG_STATUS a RSU_STATUS Popisy kódov chýb v Mailbox Client Intel FPGA IP  Viac informácií nájdete v používateľskej príručke.

1 Verzia Quartus Dostupné vo verziách softvéru Intel Quartus® Prime medzi 19.4 a 21.2, pole zobrazuje:
  • Bit [31:28]: Index firmvéru alebo kópie rozhodovacieho firmvéru, ktorá bola naposledy použitá. Možné hodnoty sú 0, 1, 2 a 3.
  • Bit [27:24]: Vyhradené
  • Bit [23:16]: Hodnota je „0“
Verzia Quartus, ktorá je k dispozícii v softvéri Intel Quartus Prime verzie 21.3 alebo novšej, zobrazuje:
  • Bit [31:28]: Index firmvéru alebo kópie rozhodovacieho firmvéru, ktorá bola naposledy použitá. Možné hodnoty sú 0, 1, 2 a 3.
  • Bit [27:24]: Vyhradené
  • Bit [23:16]: Číslo vydania Major Quartus
  • Bit [15:8]: Číslo vydania Minor Quartus
  • Bit [7:0]: Číslo aktualizácie Quartus

NapríkladampV softvéri Intel Quartus Prime verzie 21.3.1 nasledujúce hodnoty predstavujú hlavné a vedľajšie čísla vydania Quartus a číslo aktualizácie Quartus:

  • Bit [23:16] = 8'd21 = 8'h15
  • Bit [15:8] = 8'd3 = 8'h3
  • Bit [7:0] = 8'd1 = 8'h1
2 Stav PIN
  • Bit [31]: Aktuálna výstupná hodnota nSTATUS (aktívna nízka)
  • Bit [30]: Zistená vstupná hodnota nCONFIG (aktívna nízka)
  • Bit [29:8]: Vyhradené
  • Bit [7:6]: Zdroj konfiguračných hodín
    • 01 = Interný oscilátor
    • 10 = OSC_CLK_1
  • Bit [5:3]: Vyhradené
  • Bit [2:0]: Hodnota MSEL pri zapnutí
3 Stav mäkkej funkcie Obsahuje hodnotu každej z mäkkých funkcií, aj keď ste funkciu nepriradili pinu SDM.
  • Bit [31:6]: Vyhradené
  • 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 Miesto chyby Obsahuje umiestnenie chyby. Vráti 0, ak nie sú žiadne chyby.
5 Detaily chyby Obsahuje podrobnosti o chybe. Vráti 0, ak nie sú žiadne chyby.
RSU_STATUS 5B 0 9 Hlási aktuálny stav aktualizácie vzdialeného systému. Tento príkaz môžete použiť na kontrolu stavu konfigurácie počas konfigurácie a po jej dokončení. Tento príkaz vráti nasledujúce odpovede:
Slovo Zhrnutie Popis

(Ďalej….)

  1. Toto číslo nezahŕňa hlavičku príkazu alebo odpovede
0-1 Aktuálny obrázok Flash offset aktuálne spusteného obrazu aplikácie.
2-3 Nefungujúci obrázok Flash offset obrazu zlyhávajúcej aplikácie s najvyššou prioritou. Ak je v pamäti flash k dispozícii viacero obrázkov, uloží sa hodnota prvého obrázka, ktorý zlyhal. Hodnota všetkých 0 označuje žiadne chybné obrázky. Ak neexistujú žiadne chybné obrázky, zvyšné slová stavových informácií neuložia platné informácie.
Poznámka:Nástupná hrana na nCONFIG na prekonfigurovanie z ASx4 toto pole nevymaže. Informácie o zlyhaní obrazu sa aktualizujú iba vtedy, keď klient poštovej schránky dostane nový príkaz RSU_IMAGE_UPDATE a úspešne sa nakonfiguruje z obrazu aktualizácie.
4 štátu Kód chyby chybného obrazu. Chybové pole má dve časti:
  • Bit [31:16]: Kód hlavnej chyby
  • Bit [15:0]: Menší chybový kód Vracia 0 pre žiadne zlyhania. Odkazujú na

Príloha: Popisy chybových kódov CONFIG_STATUS a RSU_STATUS v používateľskej príručke poštového klienta Intel FPGA IP, kde nájdete ďalšie informácie.

5 Verzia Verzia rozhrania RSU a zdroj chyby.
Ďalšie informácie nájdete v časti Stavové a chybové kódy RSU v Používateľskej príručke pre vzdialenú aktualizáciu systému pevného procesora.
6 Miesto chyby Ukladá miesto chyby chybného obrázka. Vráti 0 bez chýb.
7 Detaily chyby Ukladá podrobnosti o chybe pre chybný obrázok. Vráti 0, ak nie sú žiadne chyby.
8 Počítadlo opakovania aktuálneho obrázka Počet pokusov o opakovanie aktuálneho obrázka. Počítadlo je na začiatku 0. Počítadlo je nastavené na 1 po prvom pokuse a potom na 2 po druhom pokuse.
Zadajte maximálny počet opakovaní v nastaveniach Intel Quartus Prime File (.qsf). Príkaz je: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Platné hodnoty pre počítadlo MAX_RETRY sú 1-3. Skutočný počet dostupných opakovaní je MAX_RETRY -1
Toto pole bolo pridané vo verzii 19.3 softvéru Intel Quartus Prime Pro Edition.
pokračovanie…
  1. Toto číslo nezahŕňa hlavičku príkazu alebo odpovede.
RSU_NOTIFY 5D 1 0 Vymaže všetky chybové informácie v odpovedi RSU_STATUS a vynuluje počítadlo opakovania. Jednoslovný argument má nasledujúce polia:
  • 0x00050000: Vymazanie aktuálneho počítadla opätovného vynulovania. Vynulovaním aktuálneho počítadla opakovania sa počítadlo nastaví späť na nulu, ako keby sa aktuálny obrázok úspešne načítal prvýkrát.
  • 0x00060000: Vymazať informácie o chybovom stave.
  • Všetky ostatné hodnoty sú vyhradené.

Tento príkaz nie je dostupný pred verziou 19.3 softvéru Intel Quartus Prime Pro Edition.

QSPI_OPEN 32 0 0 Požaduje exkluzívny prístup k quad SPI. Túto požiadavku zadávate pred akýmikoľvek inými požiadavkami QSPI. SDM akceptuje požiadavku, ak sa quad SPI nepoužíva a SDM nekonfiguruje zariadenie.
Vráti OK, ak SDM udelí prístup.
SDM udeľuje exkluzívny prístup klientovi pomocou tejto poštovej schránky. Ostatní klienti nemôžu pristupovať k quad SPI, kým sa aktívny klient nevzdá prístupu pomocou príkazu QSPI_CLOSE.
Prístup k quad SPI flash pamäťovým zariadeniam cez akúkoľvek IP adresu klienta poštovej schránky nie je štandardne dostupný v dizajnoch, ktoré zahŕňajú HPS, pokiaľ QSPI nezakážete v konfigurácii softvéru HPS.
Dôležité: Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.
QSPI_CLOSE 33 0 0 Zatvorí výhradný prístup k rozhraniu quad SPI.
Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.
QSPI_SET_CS 34 1 0 Určuje jedno z pripojených zariadení quad SPI prostredníctvom čiar výberu čipu. Preberá jednoslovný argument, ako je popísané nižšie
  • Bity[31:28]: Flash zariadenie na výber. Hodnotu, ktorá zodpovedá kolíkom nCSO[0:3], nájdete v nižšie uvedených informáciách
    • Hodnota 4'h0000 vyberie blesk, ktorý zodpovedá nCSO[0].
    • Hodnota 4'h0001 vyberie blesk, ktorý zodpovedá nCSO[1].
    • Hodnota 4'h0002 vyberie blesk, ktorý zodpovedá nCSO[2].
    • Hodnota 4'h0003 vyberie blesk, ktorý zodpovedá nCSO[3].
  • Bity[27:0]: Vyhradené (zapíšte ako 0).

Poznámka: Zariadenia Intel Agilex alebo Intel Stratix® 10 podporujú jedno AS x4 flash pamäťové zariadenie pre AS konfiguráciu zo quad SPI zariadenia pripojeného k nCSO[0]. Akonáhle zariadenie vstúpi do užívateľského režimu, môžete použiť až štyri AS x4 flash pamäte na použitie s Mailbox Client IP alebo HPS ako dátové úložisko. Mailbox Client IP alebo HPS môže použiť nCSO[3:0] na prístup k quad SPI zariadeniam.
Tento príkaz je voliteľný pre schému konfigurácie AS x4, riadok výberu čipu nasleduje po poslednom vykonanom príkaze QSPI_SET_CS alebo je po konfigurácii AS x0 štandardne nastavený na nCSO[4]. JTAG konfiguračná schéma vyžaduje vykonanie tohto príkazu na prístup k QSPI flash, ktorý spája kolíky SDM_IO.
Prístup k pamäťovým zariadeniam QSPI flash pomocou kolíkov SDM_IO je dostupný len pre konfiguračnú schému AS x4, JTAG konfiguráciu a návrh zostavený pre konfiguráciu AS x4. Pre konfiguračnú schému Avalon streaming interface (Avalon ST) musíte pripojiť flash pamäte QSPI k pinom GPIO.

pokračovanie…
  1. Toto číslo nezahŕňa hlavičku príkazu alebo odpovede
Dôležité: Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.
QSPI_READ 3A 2 N Číta pripojené quad SPI zariadenie. Maximálna veľkosť prenosu je 4 kilobajty (KB) alebo 1024 slov.
Má dva argumenty:
  • quad SPI flash adresa (jedno slovo). Adresa musí byť zarovnaná podľa slov. Zariadenie vráti kód chyby 0x1 pre nezarovnané adresy.
  • Počet slov na čítanie (jedno slovo).

Keď je to úspešné, vráti OK, po ktorom nasledujú načítané dáta z quad SPI zariadenia. Odpoveď na zlyhanie vráti kód chyby.
Pre čiastočne úspešné čítanie môže QSPI_READ chybne vrátiť stav OK.
Poznámka: Počas konfigurácie zariadenia nemôžete spustiť príkaz QSPI_READ.
Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

QSPI_WRITE 39 2+N 0 Zapisuje dáta do quad SPI zariadenia. Maximálna veľkosť prenosu je 4 kilobajty (KB) alebo 1024 slov.
Berie tri argumenty:
  • Posun adresy flash (jedno slovo). Adresa zápisu musí byť zarovnaná na slová.
  • Počet slov na napísanie (jedno slovo).
  • Údaje, ktoré sa majú zapísať (jedno alebo viac slov). Úspešný zápis vráti kód odpovede OK.

Ak chcete pripraviť pamäť na zápisy, pred zadaním tohto príkazu použite príkaz QSPI_ERASE.
Poznámka: Počas konfigurácie zariadenia nemôžete spustiť príkaz QSPI_WRITE.
Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

QSPI_ERASE 38 2 0 Vymaže 4/32/64 KB sektor quad SPI zariadenia. Má dva argumenty:
  • Posun adresy flash na spustenie vymazávania (jedno slovo). V závislosti od počtu slov, ktoré sa majú vymazať, musí byť počiatočná adresa:
    • 4 KB zarovnané, ak je počet slov na vymazanie 0x400
    • 32 KB zarovnané, ak je počet slov na vymazanie 0x2000
    • 64 KB zarovnané, ak je počet slov na vymazanie 0x4000 Vráti chybu pre adresy, ktoré nie sú zarovnané 4/32/64 KB.
  • Počet slov, ktoré sa majú vymazať, sa určuje v násobkoch:
    • 0x400 na vymazanie 4 KB (100 slov) údajov. Táto možnosť predstavuje minimálnu veľkosť vymazania.
    • 0x2000 na vymazanie 32 kB (500 slov) údajov
    • 0x4000 na vymazanie 64 KB (1000 slov) údajov Úspešné vymazanie vráti kód odpovede OK.

Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

QSPI_READ_ DEVICE_REG 35 2 N Číta registre zo zariadenia quad SPI. Maximálne čítanie je 8 bajtov. Má dva argumenty:
  • Operačný kód pre príkaz read.
  • Počet bajtov na čítanie.
pokračovanie…
  1. Toto číslo nezahŕňa hlavičku príkazu alebo odpovede.
Úspešné čítanie vráti kód odpovede OK, za ktorým nasledujú dáta načítané zo zariadenia. Návrat načítaných údajov je v násobkoch 4 bajtov. Ak bajty na čítanie nie sú presným násobkom 4 bajtov, doplní sa násobkom 4 bajtov, až kým nebude hranica ďalšieho slova a hodnota doplneného bitu nebude nula.
Dôležité: Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.
QSPI_WRITE_ DEVICE_REG 36 2+N 0 Zapisuje do registrov quad SPI. Maximálny zápis je 8 bajtov. Berie tri argumenty:
  • Operačný kód pre príkaz write.
  • Počet bajtov na zápis.
  • Údaje na zápis.

Ak chcete vykonať vymazanie sektora alebo vymazania podsektora, musíte špecifikovať sériovú adresu flash v poradí od najvýznamnejších bajtov (MSB) po najmenej významné bajty (LSB), ako napr.ample ilustruje.
Ak chcete vymazať sektor blesku Micron 2 gigabit (Gb) na adrese 0x04FF0000 pomocou príkazu QSPI_WRITE_DEVICE_REG, napíšte adresu flash v poradí MSB až LSB, ako je znázornené tu:
Hlavička: 0x00003036 Operačný kód: 0x000000DC
Počet bajtov na zápis: 0x00000004 Adresa Flash: 0x0000FF04
Úspešný zápis vráti kód odpovede OK. Tento príkaz vloží údaje, ktoré nie sú násobkom 4 bajtov, na hranicu ďalšieho slova. Príkaz doplní údaje nulou.
Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

QSPI_SEND_ DEVICE_OP 37 1 0 Odošle príkazový operačný kód do quad SPI. Trvá jeden argument:
  • Operačný kód na odoslanie quad SPI zariadenia.

Úspešný príkaz vráti kód odpovede OK.
Dôležité:Pri resetovaní quad SPI musíte postupovať podľa pokynov uvedených v Resetovanie Quad SPI Flash na strane 9.

Popisy hlavných a menších chybových kódov CONFIG_STATUS a RSU_STATUS nájdete v Prílohe: Popisy chybových kódov CONFIG_STATUS a RSU_STATUS v používateľskej príručke pre klienta poštovej schránky Intel FPGA IP.
Súvisiace informácie

Odpovede na chybový kód

Tabuľka 8. Kódy chýb

Hodnota (hex.) Odpoveď na chybový kód Popis
0 OK Označuje, že príkaz bol úspešne dokončený.
Príkaz môže chybne vrátiť stav OK, ak príkaz, ako napr
QSPI_READ je čiastočne úspešný.
1 INVALID_COMMAND Označuje, že aktuálne načítaná boot ROM nedokáže dekódovať alebo rozpoznať kód príkazu.
3 NEZNÁMY PRÍKAZ Označuje, že aktuálne načítaný firmvér nedokáže dekódovať kód príkazu.
4 INVALID_COMMAND_ PARAMETERS Označuje, že príkaz je nesprávne naformátovaný. Naprample, nastavenie poľa dĺžky v hlavičke nie je platné.
6 COMMAND_INVALID_ON_ SOURCE Označuje, že príkaz pochádza zo zdroja, pre ktorý nie je povolený.
8 CLIENT_ID_NO_MATCH Označuje, že ID klienta nemôže dokončiť požiadavku na zatvorenie výhradného prístupu k quad SPI. ID klienta sa nezhoduje s existujúcim klientom s aktuálnym exkluzívnym prístupom k quad SPI.
9 INVALID_ADDRESS Adresa je neplatná. Táto chyba označuje jednu z nasledujúcich podmienok:
  • Nezarovnaná adresa
  • Problém s rozsahom adries
  • Problém s povolením na čítanie
  • Neplatná hodnota výberu žetónu, ktorá zobrazuje hodnotu vyššiu ako 3
  • Neplatná adresa v prípade RSU
  • Neplatná hodnota bitovej masky pre GET_VOLTAGE príkaz
  • Neplatný výber stránky pre príkaz GET_TEMPERATURE
A AUTHENTICATION_FAIL Označuje zlyhanie autentifikácie podpisu bitového toku konfigurácie.
B TIMEOUT Táto chyba označuje časový limit v dôsledku nasledujúcich podmienok:
  • Príkaz
  • Čaká sa na dokončenie operácie QSPI_READ
  • Čaká sa na požadovaný údaj teploty z jedného z teplotných snímačov. Môže indikovať potenciálnu hardvérovú chybu v snímači teploty.
C HW_NOT_READY Označuje jednu z nasledujúcich podmienok:
  • Hardvér nie je pripravený. Môže indikovať problém s inicializáciou alebo konfiguráciou. Hardvér môže odkazovať na quad SPI.
  • Obraz RSU sa nepoužíva na konfiguráciu FPGA.
D HW_ERROR Označuje, že príkaz bol neúspešne dokončený z dôvodu neodstrániteľnej hardvérovej chyby.
80 – 8F COMMAND_SPECIFIC_ ERROR Označuje špecifickú chybu príkazu spôsobenú príkazom SDM, ktorý ste použili.
SDM

Príkaz

Názov chyby Kód chyby Popis
GET_CHIPID EFUSE_SYSTEM_ FAILURE 0x82 Označuje, že ukazovateľ vyrovnávacej pamäte eFuse je neplatný.
QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/

QSPI_READ_D EVICE_REG/

QSPI_HW_ERROR 0x80 Indikuje chybu flash pamäte QSPI. Táto chyba označuje jednu z nasledujúcich podmienok:
QSPI_WRITE_ DEVICE_REG/

QSPI_SEND_D EVICE_OP/

QSPI_READ

  • Problém s nastavením výberu flash čipu QSPI
  • Problém s inicializáciou flash QSPI
  • Problém s resetovaním blesku QSPI
  • Problém s aktualizáciou nastavení flash QSPI
QSPI_ALREADY_ OPEN 0x81 Označuje, že exkluzívny prístup klienta k QSPI flash cez príkaz QSPI_OPEN je už otvorený.
100 NOT_CONFIGURED Označuje, že zariadenie nie je nakonfigurované.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Označuje, že zariadenie je zaneprázdnené v dôsledku nasledujúcich prípadov použitia:
  • RSU: Firmvér nie je schopný prejsť na inú verziu kvôli internej chybe.
  • HPS: HPS je zaneprázdnený, keď prebieha proces rekonfigurácie HPS alebo studený reštart HPS.
2FF ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE Označuje, že nie je k dispozícii žiadna platná odpoveď.
3FF ALT_SDM_MBOX_RESP_ ERROR Všeobecná chyba.

Obnova chybového kódu
Nižšie uvedená tabuľka popisuje možné kroky na obnovenie z chybového kódu. Obnova po chybe závisí od konkrétneho prípadu použitia.
Tabuľka 9. Obnova chybového kódu pre známe chybové kódy

Hodnota Odpoveď na chybový kód Obnova chybového kódu
4 INVALID_COMMAND_ PARAMETERS Znova odošlite hlavičku príkazu alebo hlavičku s argumentmi s opravenými parametrami.
Napríkladample, uistite sa, že nastavenie poľa dĺžky v hlavičke je odoslané so správnou hodnotou.
6 COMMAND_INVALID_ ON_SOURCE Znova odošlite príkaz z platného zdroja, ako je JTAG, HPS alebo jadrová tkanina.
8 CLIENT_ID_NO_MATCH Počkajte, kým klient, ktorý otvoril prístup k quad SPI, dokončí svoj prístup a potom zatvorí exkluzívny prístup k quad SPI.
9 INVALID_ADDRESS Možné kroky na obnovenie chyby:
Pre GET_VOLTAGE príkaz: Odoslať príkaz s platnou bitovou maskou.
Pre príkaz GET_TEMPERATURE: Odoslať príkaz s platnou polohou senzora a maskou senzora.
Pre operáciu QSPI:
  • Odoslať príkaz s platným výberom čipu.
  • Odoslať príkaz s platnou flash adresou QSPI.

Pre RSU: Odošlite príkaz s platnou počiatočnou adresou pôvodného obrazu alebo aplikácie.

B TIMEOUT Možné kroky obnovy:

Pre príkaz GET_TEMPERATURE: Zopakujte odoslanie príkazu znova. Ak problém pretrváva, prekonfigurujte zariadenie alebo ho vypnite a zapnite.

Pre prevádzku QSPI: Skontrolujte integritu signálu rozhraní QSPI a skúste zadať príkaz znova.

Pre operáciu reštartu HPS: Zopakujte odoslanie príkazu znova.

C HW_NOT_READY Možné kroky obnovy:

Pre prevádzku QSPI: Prekonfigurujte zariadenie cez zdroj. Uistite sa, že IP použitá na vytvorenie vášho návrhu umožňuje prístup k QSPI flash.

Pre RSU: Nakonfigurujte zariadenie pomocou obrazu RSU.

80 QSPI_HW_ERROR Skontrolujte integritu signálu rozhrania QSPI a uistite sa, že zariadenie QSPI nie je poškodené.
81 QSPI_ALREADY_OPEN Klient už QSPI otvoril. Pokračujte v ďalšej operácii.
82 EFUSE_SYSTEM_FAILURE Pokúste sa o rekonfiguráciu alebo vypnite napájanie. Ak chyba pretrváva aj po rekonfigurácii alebo zapnutí, zariadenie môže byť poškodené a neopraviteľné.
100 NOT_CONFIGURED Odošlite bitový tok, ktorý konfiguruje HPS.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Možné kroky na obnovenie chyby:

Pre operáciu QSPI: Počkajte na prebiehajúcu konfiguráciu alebo na dokončenie operácie iného klienta.

Pre RSU: Prekonfigurujte zariadenie, aby sa zotavilo z internej chyby.

Pre operáciu reštartovania HPS: Počkajte na dokončenie rekonfigurácie pomocou HPS alebo HPS Cold Reset.

Mailbox Client s Avalon Streaming Interface Intel FPGA IP Užívateľská príručka Archívy dokumentov

Najnovšie a predchádzajúce verzie tejto používateľskej príručky nájdete na Mailbox Client s Avalon Streaming Interface Užívateľská príručka Intel FPGA IP. Ak IP alebo verzia softvéru nie je uvedená, platí používateľská príručka pre predchádzajúcu verziu IP alebo softvéru.

Verzie IP sú rovnaké ako verzie softvéru Intel Quartus Prime Design Suite až po v19.1. Od verzie softvéru Intel Quartus Prime Design Suite 19.2 alebo novšej majú jadrá IP novú schému verzovania IP.

História revízií dokumentu pre poštového klienta s Avalon Streaming Interface Užívateľská príručka Intel FPGA IP

Verzia dokumentu Verzia Intel Quartus Prime Verzia IP Zmeny
2022.09.26 22.3 1.0.1 Urobil nasledujúce zmeny:
  • Aktualizovaný GET_VOLTAGE príkazový riadok v

Zoznam príkazov a tabuľka popisu.

  • Pridaná poznámka k podpore rodiny tabuľkových zariadení.
  • Prepracované QSPI_SET_CS popis príkazu v tabuľke Zoznam príkazov a popis.
2022.04.04 22.1 1.0.1 Aktualizovaná tabuľka Zoznam príkazov a popis.
  • Aktualizovaný popis stavu pinu pre príkaz CONFIG_STATUS.
  • Odstránil sa príkaz REBOOT_HPS.
2021.10.04 21.3 1.0.1 Vykonala nasledujúcu zmenu:
  • Prepracované Zoznam a popis príkazov tabuľky. Aktualizovaný popis pre:
    • CONFIG_STATUS
    • RSU_STATUS
2021.06.21 21.2 1.0.1 Urobil nasledujúce zmeny:
  • Prepracované Zoznam a popis príkazov tabuľky. Aktualizovaný popis pre:
    • RSU_STATUS
    • QSPI_OPEN
    • QSPI_SET_CS
    • QSPI_ERASE
2021.03.29 21.1 1.0.1 Urobil nasledujúce zmeny:
  • Upravený popis RSU_IMAGE_UPDATE v Zoznam a popis príkazov tabuľky.
  • Reštrukturalizované Operačné príkazy. Odstránili sa popisy hlavných a menších kódov chýb pre príkazy CONFIG_STATUS a RSU_STATUS. Hlavné a menšie chybové kódy sú teraz zdokumentované ako príloha v Užívateľská príručka poštového klienta Intel FPGA IP.
2020.12.14 20.4 1.0.1 Urobil nasledujúce zmeny:
  • Pridaná dôležitá poznámka o resetovaní blesku QSPI v Operačné príkazy tému.
  • Aktualizované Zoznam a popis príkazov porcie pre:
    • Upravený popis príkazu GET_TEMPERATURE.
    • Upravený popis príkazu RSU_IMAGE_UPDATE.
  • Pridaný text o resetovaní blesku QSPI.
  • Pridaný text popisujúci správanie medzi externým hostiteľom a FPGA.
  • Odstránený text: Ak zariadenie už spracováva konfiguračný príkaz, vráti nenulovú odpoveď.
    • Aktualizované popisy QSPI_WRITE a QSPI_READ, aby špecifikovali, že maximálna veľkosť prenosu je 4 kilobajty alebo 1024 slov.
    • Opravená dĺžka odpovede z 1 na 0 pre QSPI_OPEN, QSPI_CLOSE a QSPI_SET_CS príkaz.
    • Upravené popisy QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG a QSPI_WRITE_DEVICE_REG.
    • Pridaný nový príkaz: REBOOT_HPS.
  • Pridaná nová téma: Obnova chybového kódu.
2020.10.05 20.3 1.0.1
  • Názov tejto používateľskej príručky bol zmenený z Mailbox Avalon Streaming Interface Client Užívateľská príručka Intel FPGA IP do Mailbox Client s Avalon Streaming Interface Užívateľská príručka Intel FPGA IP z dôvodu zmeny názvu IP v katalógu IP Intel Quartus Prime.
  • Globálne aktualizované všetky inštancie názvu IP.
  • Upravený popis príkazu GET TEMPERATURE pre zariadenia Intel Agilex v Zoznam a popis príkazov tabuľky.
  • Pridané odporúčanie o resetovaní synchronizátora v Rozhrania hodín a resetovania tabuľky.
  • Aktualizované Chybové kódy tabuľky. Pridané nové odpovede na chybový kód:
    • HW_ERROR
    • COMMAND_SPECIFIC_ERROR
  • Odstránené Umiestnenie snímačov teploty tému. Informácie o teplotnom snímači sú dostupné v Používateľská príručka správy napájania Intel Agilex.
2020.06.30 20.2 1.0.0
  • Názov tejto používateľskej príručky bol zmenený z Poštová schránka Avalon ST Client Užívateľská príručka Intel FPGA IP do Mailbox Avalon Streaming Interface Client Užívateľská príručka Intel FPGA IP.
  • Premenovaný názov témy Hlavička príkazov a odoziev do Príkazy a odpovede.
  • Upravené popisy ID, DĹŽKY a príkazového kódu/chybového kódu v Popis hlavičky príkazov a odpovedí tabuľky.
  • Premenovaný názov témy Podporované príkazy do Operačné príkazy.
  • Upravený nasledujúci popis príkazov v Zoznam a popis príkazov porcie pre:
    • GET_TEMPERATURE
    • RSU_STATUS
    • QSPI_SET_CS
  • Premenovaný názov témy Chybové kódy do Odpovede na chybový kód.
  • Príkaz UNKNOWN_BR bol odstránený z Kód chyby tabuľky.
2020.04.13 20.1 1.0.0 Urobil nasledujúce zmeny:
  • Pridané informácie o teplotných senzoroch pre príkaz GET_TEMPERATURE vrátane obrázkov znázorňujúcich polohy TSD.
  • Pridaný príkaz RSU_NOTIFY v Zoznam a popis príkazových kódov tabuľky.
  • Aktualizované Chybové kódy porcie pre:
    • Premenované na INVALID_COMMAND_PARAMETERS na INVALID_LENGTH.
    • Hexadecimálna hodnota COMMAND_INVALID_ON_SOURCE bola zmenená z 5 na 6.
    • Hexadecimálna hodnota CLIENT_ID_NO_MATCH bola zmenená zo 6 na 8.
    • Šestnástková hodnota INVALID_ADDRESS bola zmenená zo 7 na 9.
    • Pridaný príkaz AUTHENTICATION_FAIL.
    • Hexadecimálna hodnota TIMEOUT bola zmenená z 8 na B.
    • Hexadecimálna hodnota HW_NOT_READY sa zmenila z 9 na C.
2019.09.30 19.3 1.0.0 Prvotné uvoľnenie.

 Pre spätnú väzbu navštívte:  FPGAtechdocfeedback@intel.com

 

Dokumenty / zdroje

intel Mailbox Client s Avalon Streaming Interface FPGA IP [pdf] Používateľská príručka
Mailbox klient s Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Referencie

Zanechajte komentár

Vaša emailová adresa nebude zverejnená. Povinné polia sú označené *