Uživatelská příručka intel Mailbox Client s Avalon Streaming Interface FPGA IP
intel Mailbox Client s Avalon Streaming Interface FPGA IP

Obsah skrýt
1 Mailbox Client s Avalon® Streaming Interface Intel FPGA IP Overview
1.1 Podpora rodiny zařízení
2 Dokumenty / zdroje
2.1 Reference
3 Související příspěvky

Mailbox Client s Avalon® Streaming Interface Intel FPGA IP Overview

Mailbox Client s Avalon® streamovacím rozhraním Intel® FPGA IP (Mailbox Client with Avalon ST Client IP) poskytuje komunikační kanál mezi vaší vlastní logikou a správcem zabezpečeného zařízení (SDM). Mailbox Client s Avalon ST IP můžete použít k odesílání paketů příkazů a přijímání paketů odpovědí z periferních modulů SDM. Mailbox Client s Avalon ST IP definuje funkce, které SDM spouští.

Vaše vlastní logika může tento komunikační kanál používat k přijímání informací a přístupu k paměti flash z následujících periferních modulů:

  • ID čipu
  • Snímač teploty
  • Voltage Senzor
  • Flash paměť Quad sériové periferní rozhraní (SPI).

Poznámka: V této uživatelské příručce termín Avalon ST zkracuje Avalon streaming interface neboli IP adresu.

Obrázek 1. Mailbox Client s Avalon ST IP System Design
Mailbox Client s Avalon ST IP System Design

Následující obrázek ukazuje aplikaci, ve které Mailbox Client s Avalon ST IP čte ID čipu.

Postava 2. Mailbox Client s Avalon ST IP čte ID čipu
Mailbox Client s Avalon ST IP čte ID čipu

Podpora rodiny zařízení

Níže je uveden seznam definic úrovní podpory zařízení pro IP adresy Intel FPGA:

  • Předběžná podpora — IP je k dispozici pro simulaci a kompilaci pro tuto řadu zařízení. Modely načasování zahrnují počáteční technické odhady zpoždění na základě časných informací po rozvržení. Modely časování podléhají změnám, protože testování křemíku zlepšuje korelaci mezi skutečným křemíkem a modely časování. Tuto IP adresu můžete použít pro studie systémové architektury a využití zdrojů, simulace, pin out, hodnocení systémové latence, základní hodnocení načasování (rozpočet potrubí) a strategii přenosu I/O (šířka datové cesty, hloubka shluku, obchod se standardy I/O off).
  • Předběžná podpora — IP je ověřena s předběžnými modely časování pro tuto rodinu zařízení. IP splňuje všechny funkční požadavky, ale může stále procházet analýzou časování pro rodinu zařízení. Ve výrobních návrzích jej lze používat opatrně.
  • Konečná podpora — IP je ověřena s konečnými modely časování pro tuto rodinu zařízení. IP splňuje všechny funkční a časové požadavky pro rodinu zařízení a může být použit ve výrobních návrzích.

Tabulka 1. Podpora rodiny zařízení

Rodina zařízení Podpora
Intel Agilex™ Záloha

Poznámka: Nemůžete simulovat Mailbox Client s Avalon Streaming Interface Intel FPGA IP, protože IP přijímá odpovědi z SDM. Chcete-li ověřit tuto adresu IP, společnost Intel doporučuje provést vyhodnocení hardwaru.

Související informace
Mailbox Client s Avalon Streaming Interface Poznámky k vydání Intel FPGA IP

Parametry

Název parametru Hodnota Popis
Povolit stavové rozhraní Zapnuto vypnuto Když toto rozhraní povolíte, klient poštovní schránky se streamovacím rozhraním Avalon Intel FPGA IP bude obsahovat signál command_status_invalid. Když se command_status_invalid potvrdí, musíte resetovat IP.

Rozhraní
Následující obrázek ilustruje poštovního klienta s rozhraním Avalon Streaming Interface Intel FPGA IP rozhraní:

Obrázek 3. Mailbox Client s Avalon Streaming Interface Rozhraní Intel FPGA IP
Mailbox Client s Avalon Streaming Interface Rozhraní Intel FPGA IP

Další informace o rozhraních Avalon pro streamování najdete ve specifikacích rozhraní Avalon.
Související informace
Specifikace rozhraní Avalon

Rozhraní hodin a resetování

Tabulka 2. Rozhraní hodin a resetování

Název signálu Směr Popis
in_clk Vstup Toto jsou hodiny pro streamovací rozhraní Avalon. Maximální frekvence v 250 MHz.
in_reset Vstup Toto je aktivní vysoký reset. Chcete-li resetovat poštovního klienta se streamovacím rozhraním Avalon Intel FPGA IP (Mailbox Client s Avalon ST IP), zadejte příkaz in_reset. Když se aktivuje signál in_reset, SDM musí vyprázdnit všechny čekající aktivity z klienta poštovní schránky s Avalon ST IP. SDM pokračuje ve zpracování příkazů od jiných klientů.

Aby bylo zajištěno, že Mailbox Client s Avalon ST IP funguje správně, když zařízení vstoupí do uživatelského režimu, váš návrh musí obsahovat Reset Release Intel FPGA IP, který podrží reset, dokud tkanina FPGA nepřejde do uživatelského režimu. Společnost Intel doporučuje použít resetovací synchronizátor při připojení uživatelského resetu nebo výstupu Reset Release IP k
reset portu klienta poštovní schránky s Avalon ST IP. K implementaci resetovacího synchronizátoru použijte Reset Bridge Intel FPGA IP dostupný v Platform Designer.

Poznámka: Pokyny pro vytváření instancí IP a připojení v Návrháři platformy naleznete v části Požadované komunikační a hostitelské komponenty pro návrh vzdálené aktualizace systému Ex.ample obrázek v uživatelské příručce Intel Agilex Configuration.

Příkazové rozhraní
K odesílání příkazů do SDM použijte rozhraní Avalon Streaming (Avalon ST).

Tabulka 3. Příkazové rozhraní

Název signálu Směr Popis
command_ready Výstup Klient poštovní schránky s Avalon ST Intel FPGA IP uplatňuje příkaz command_ready, když je připraven přijímat příkazy z aplikace. Read_latency je 0 cyklů. Mailbox Client s Avalon ST může přijímat command_data[31:0] ve stejném cyklu, jako příkaz command_ready.
příkaz_platný Vstup Signál platnosti příkazu potvrzuje, že data příkazu jsou platná.
příkaz_data[31:0] Vstup Sběrnice command_data přenáší příkazy do SDM. Definice příkazů viz Seznam a popis příkazů.
command_startofpacket Vstup Command_startofpacket se uplatňuje v prvním cyklu příkazového paketu.
command_endofpacket Vstup Command_endofpacket uplatňuje v posledním cyklu příkazu paket.

Postava 4. Načasování pro Avalon ST Command Packet
obr:m Paket příkazů ST

Rozhraní odezvy
SDM Avalon ST Client IP odesílá odpovědi do vaší aplikace pomocí rozhraní odpovědí.

Tabulka 4. Rozhraní odezvy

Signál 5 Směr Popis
response_ready Vstup Aplikační logika může uplatnit signál response_ready, kdykoli je schopna přijmout odpověď.
odpověď_platná Výstup SDM potvrdí response_valid k označení, že response_data jsou platná.
response_data[31:0] Výstup SDM řídí response_data, aby poskytl požadované informace. První slovo odpovědi je hlavička, která identifikuje příkaz, který SDM poskytuje. Odkazují na Seznam a popis příkazů pro definice příkazů.
response_startofpacket Výstup Response_startofpacket se uplatňuje v prvním cyklu paketu odpovědi.
response_endofpacket Výstup Response_endofpacket uplatňuje v posledním cyklu paketu odpovědi.

Obrázek 5. Časování pro Avalon ST Response Packet
Paket odpovědi Avalon ST

Rozhraní stavu příkazů

Tabulka 5. Rozhraní stavu příkazů

Název signálu Směr Popis
command_status_invalid Výstup Command_status_invalid potvrzuje chybu. Tento signál obvykle potvrzuje, že délka příkazu uvedená v záhlaví příkazu neodpovídá délce odeslaného příkazu. Když se příkaz command_status_invalid potvrdí, musí vaše aplikační logika potvrdit in_reset, aby se restartoval klient poštovní schránky se streamovacím rozhraním Avalon Intel FPGA IP.

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

Příkazy a odpovědi

Hostitelský řadič komunikuje s SDM pomocí paketů příkazů a odpovědí přes Mailbox Client Intel FPGA IP.

První slovo paketů příkazů a odpovědí je hlavička, která poskytuje základní informace o příkazu nebo odpovědi.

Obrázek 7. Formát záhlaví příkazů a odpovědí
obr.: Formát záhlaví příkazů a odpovědí

Poznámka: Pole LENGTH v záhlaví příkazu musí odpovídat délce příkazu odpovídajícího příkazu.
Následující tabulka popisuje pole příkazu záhlaví.

Tabulka 6. Popis záhlaví příkazů a odpovědí

Záhlaví Bit Popis
Rezervováno [31:28] Rezervováno.
ID [27:24] ID příkazu. Hlavička odpovědi vrací ID zadané v hlavičce příkazu. Popis příkazů viz Operační příkazy.
0 [23] Rezervováno.
DÉLKA [22:12] Počet slov argumentů následujících za záhlavím. IP odpoví chybou, pokud je pro daný příkaz zadán nesprávný počet slov argumentů.
Pokud existuje nesoulad mezi délkou příkazu zadanou v záhlaví příkazu a počtem odeslaných slov. IP zvýší bit 3 registru stavu přerušení (COMMAND_INVALID) a klient poštovní schránky musí být resetován.
Rezervováno [11] Rezervováno. Musí být nastaveno na 0.
Příkazový kód/chybový kód [10:0] Kód příkazu určuje příkaz. Kód chyby označuje, zda byl příkaz úspěšný nebo neúspěšný.
V záhlaví příkazu tyto bity představují kód příkazu. V hlavičce odpovědi tyto bity představují chybový kód. Pokud je příkaz úspěšný, kód chyby je 0. Pokud příkaz selže, podívejte se na kódy chyb definované v Odpovědi na chybový kód.

Provozní příkazy

Resetování Quad SPI Flash
Důležité: U zařízení Intel Agilex musíte připojit sériový flash nebo quad SPI flash resetovací kolík ke kolíku AS_nRST. SDM musí plně ovládat reset QSPI. Nepřipojujte resetovací kolík quad SPI k žádnému externímu hostiteli.

Tabulka 7. Seznam a popis příkazů

Příkaz kód (hexadecimální) Délka příkazu (1) Délka odezvy (1) Popis
NEOP 0 0 0 Odešle odpověď stavu OK.
GET_IDCODE 10 0 1 Odpověď obsahuje jeden argument, kterým je JTAG IDCODE pro zařízení
GET_CHIPID 12 0 2 Odpověď obsahuje 64bitovou hodnotu CHIPID s nejméně významným slovem na prvním místě.
GET_USERCODE 13 0 1 Odpověď obsahuje jeden argument, kterým je 32bitový JTAG USERCODE, který konfigurační bitový tok zapisuje do zařízení.
GET_VOLTAGE 18 1 n(2) GET_VOLTAGPříkaz E má jeden argument, kterým je bitová maska ​​určující kanály ke čtení. Bit 0 určuje kanál 0, bit 1 určuje kanál 1 a tak dále.
Odpověď obsahuje jednoslovný argument pro každý bit nastavený v bitové masce. Voltage vrácené je číslo s pevnou řádovou čárkou bez znaménka s 16 bity pod binárním bodem. Napřample, svtage 0.75 V vrátí 0x0000C000. (3)
Zařízení Intel Agilex mají jeden objtage senzor. V důsledku toho je odpověď vždy jedno slovo.
GET_ TEMPERATURE 19 1 n(4) Příkaz GET_TEMPERATURE vrací teplotu nebo teploty základní struktury nebo umístění kanálu transceiveru, které určíte.

U zařízení Intel Agilex použijte k určení umístění argument sensor_req. Senzor_req obsahuje následující pole:

  • Bits[31:28]: Vyhrazeno.
  • Bity[27:16]: Umístění senzoru. Určuje umístění TSD.
  • Bits[15:0]: Maska senzoru. Určuje senzory, které se mají číst pro zadané umístění senzoru. Odpověď obsahuje jedno slovo pro každou požadovanou teplotu. Pokud je vynechán, příkaz čte kanál 0. Nejnižší významný bit (lsb) odpovídá senzoru 0. Nejvyšší bit (msb) odpovídá kanálu 15.

Vrácená teplota je pevná hodnota se znaménkem s 8 bity pod binárním bodem. Napřample, teplota 10°C vrátí 0x00000A00. A teploty -1.5°C vrátí 0xFFFFFE80.
Pokud bitová maska ​​určuje neplatné umístění, příkaz vrátí kód chyby, který je libovolnou hodnotou v rozsahu 0x80000000 -0x800000FF.
Pro zařízení Intel Agilex naleznete další informace o místních vestavěných teplotních senzorech v uživatelské příručce Intel Agilex Power Management.
AKTUALIZACE RSU_IMAGE_ 5C 2 0 Spustí rekonfiguraci ze zdroje dat, kterým může být buď továrna, nebo obraz aplikace.
pokračování…
  1. Toto číslo nezahrnuje hlavičku příkazu nebo odpovědi.
  2. U zařízení Intel Agilex, která podporují čtení více zařízení, index n odpovídá počtu kanálů, které na svém zařízení povolíte.
  3. Viz Uživatelská příručka Intel Agilex Power Management pro více informací o kanálech a umístěních snímačů teploty.
  4. Index n závisí na počtu masek senzoru.
Příkaz kód (hexadecimální) Délka příkazu (1) Délka odezvy (1) Popis
Tento příkaz přebírá volitelný 64bitový argument, který určuje adresu rekonfiguračních dat ve flashi. Při odesílání argumentu na IP nejprve odešlete bity [31:0] a poté bity [63:32]. Pokud tento argument neuvedete, předpokládá se, že jeho hodnota je 0.
  • Bit [31:0]: Počáteční adresa obrázku aplikace.
  • Bit [63:32]: Rezervováno (zápis jako 0).

Jakmile zařízení zpracuje tento příkaz, vrátí hlavičku odpovědi odpovědi FIFO, než přistoupí k překonfigurování zařízení. Ujistěte se, že hostitelský počítač nebo hostitelský řadič přestane obsluhovat jiná přerušení a soustředí se na čtení dat hlavičky odpovědi, aby bylo indikováno úspěšné dokončení příkazu. V opačném případě hostitelský počítač nebo hostitelský řadič nemusí být schopen přijmout odpověď, jakmile bude proces rekonfigurace zahájen.
Jakmile zařízení pokračuje v rekonfiguraci, spojení mezi externím hostitelem a FPGA se ztratí. Pokud ve svém návrhu používáte PCIe, musíte znovu vyjmenovat odkaz PCIe.
Důležité: Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
RSU_GET_SPT 5A 0 4 RSU_GET_SPT načte umístění quad SPI flash pro dvě tabulky dílčích oddílů, které RSU používá: SPT0 a SPT1.
Čtyřslovná odpověď obsahuje následující informace:
Slovo Jméno 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ásí stav poslední rekonfigurace. Tento příkaz můžete použít ke kontrole stavu konfigurace během a po konfiguraci. Odpověď obsahuje následující informace:
Slovo Shrnutí Popis
0 Stát Popisuje nejnovější chybu související s konfigurací. Vrátí 0, pokud neexistují žádné chyby konfigurace.
Chybové pole má 2 pole:
  • Horních 16 bitů: Kód hlavní chyby.
  • Dolních 16 bitů: Malý chybový kód.

Viz příloha: CONFIG_STATUS a RSU_STATUS Popisy kódů chyb v Mailbox Client Intel FPGA IP  Uživatelská příručka pro více informací.
1 Verze Quartus K dispozici ve verzích softwaru Intel Quartus® Prime mezi 19.4 a 21.2, pole zobrazuje:
  • Bit [31:28]: Index firmwaru nebo kopie rozhodovacího firmwaru, která byla použita naposledy. Možné hodnoty jsou 0, 1, 2 a 3.
  • Bit [27:24]: Vyhrazeno
  • Bit [23:16]: Hodnota je '0'
K dispozici v softwaru Intel Quartus Prime verze 21.3 nebo novější, verze Quartus zobrazuje:
  • Bit [31:28]: Index firmwaru nebo kopie rozhodovacího firmwaru, která byla použita naposledy. Možné hodnoty jsou 0, 1, 2 a 3.
  • Bit [27:24]: Vyhrazeno
  • Bit [23:16]: Číslo vydání Major Quartus
  • Bit [15:8]: Číslo vydání Minor Quartus
  • Bit [7:0]: Číslo aktualizace Quartus

NapřampV softwaru Intel Quartus Prime verze 21.3.1 představují následující hodnoty hlavní a vedlejší čísla vydání Quartus a číslo aktualizace 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ální výstupní hodnota nSTATUS (aktivní nízká)
  • Bit [30]: Zjištěná vstupní hodnota nCONFIG (aktivní nízká)
  • Bit [29:8]: Vyhrazeno
  • Bit [7:6]: Zdroj konfiguračních hodin
    • 01 = Vnitřní oscilátor
    • 10 = OSC_CLK_1
  • Bit [5:3]: Vyhrazeno
  • Bit [2:0]: Hodnota MSEL při zapnutí
3 Stav měkké funkce Obsahuje hodnotu každé z měkkých funkcí, i když jste funkci nepřiřadili pinu SDM.
  • Bit [31:6]: Vyhrazeno
  • 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 Umístění chyby Obsahuje umístění chyby. Vrátí 0, pokud nejsou žádné chyby.
5 Detaily chyby Obsahuje podrobnosti o chybě. Vrátí 0, pokud nejsou žádné chyby.
RSU_STATUS 5B 0 9 Hlásí aktuální stav aktualizace vzdáleného systému. Tento příkaz můžete použít ke kontrole stavu konfigurace během konfigurace a po jejím dokončení. Tento příkaz vrací následující odpovědi:
Slovo Shrnutí Popis

(Pokračovat….)
  1. Toto číslo nezahrnuje hlavičku příkazu nebo odpovědi
0-1 Aktuální obrázek Flash offset aktuálně spuštěného obrazu aplikace.
2-3 Nefunkční obrázek Flash offset obrazu selhávající aplikace s nejvyšší prioritou. Pokud je v paměti flash k dispozici více obrázků, uloží se hodnota prvního obrázku, který selhal. Hodnota všech 0 značí, že nejsou žádné chybné obrázky. Pokud neexistují žádné chybné obrazy, zbývající slova stavových informací neukládají platné informace.
Poznámka:Náběžná hrana na nCONFIG pro překonfigurování z ASx4 toto pole nevymaže. Informace o selhání bitové kopie se aktualizují pouze tehdy, když klient poštovní schránky obdrží nový příkaz RSU_IMAGE_UPDATE a úspěšně se nakonfiguruje z aktualizační bitové kopie.
4 Stát Kód chyby selhávajícího obrazu. Chybové pole má dvě části:
  • Bit [31:16]: Kód závažné chyby
  • Bit [15:0]: Kód malé chyby Vrátí 0, pokud nedojde k selhání. Odkazují na

Dodatek: Popisy chybových kódů CONFIG_STATUS a RSU_STATUS v Uživatelské příručce pro Intel FPGA IP Mailbox Client, kde najdete další informace.
5 Verze Verze rozhraní RSU a zdroj chyb.
Další informace naleznete v části Stavové a chybové kódy RSU v Uživatelské příručce pro vzdálenou aktualizaci systému pevného procesoru.
6 Umístění chyby Ukládá umístění chyby selhávajícího obrazu. Vrátí 0 bez chyb.
7 Detaily chyby Ukládá podrobnosti o chybě pro vadný obrázek. Vrátí 0, pokud nejsou žádné chyby.
8 Aktuální počítadlo opakování obrázku Počet opakování, které byly provedeny pro aktuální obrázek. Počítadlo je zpočátku 0. Po prvním opakování je počítadlo nastaveno na 1 a po druhém pokusu na 2.
Zadejte maximální počet opakování v nastavení Intel Quartus Prime File (.qsf). Příkaz je: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Platné hodnoty pro čítač MAX_RETRY jsou 1-3. Skutečný počet dostupných opakování je MAX_RETRY -1
Toto pole bylo přidáno ve verzi 19.3 softwaru Intel Quartus Prime Pro Edition.
pokračování…
  1. Toto číslo nezahrnuje hlavičku příkazu nebo odpovědi.
RSU_NOTIFY 5D 1 0 Vymaže všechny informace o chybě v odpovědi RSU_STATUS a vynuluje čítač opakování. Jednoslovný argument má následující pole:
  • 0x00050000: Vymažte aktuální počítadlo opakování resetu. Vynulováním aktuálního počítadla opakování se počítadlo nastaví zpět na nulu, jako by byl aktuální obrázek úspěšně načten poprvé.
  • 0x00060000: Vymazat informace o chybovém stavu.
  • Všechny ostatní hodnoty jsou vyhrazeny.

Tento příkaz není k dispozici před verzí 19.3 softwaru Intel Quartus Prime Pro Edition.
QSPI_OPEN 32 0 0 Požaduje exkluzivní přístup ke quad SPI. Tento požadavek zadáte před jakýmkoliv jiným QSPI požadavky. SDM přijme požadavek, pokud se quad SPI nepoužívá a SDM nekonfiguruje zařízení.
Vrátí OK, pokud SDM udělí přístup.
SDM uděluje exkluzivní přístup klientovi pomocí této poštovní schránky. Ostatní klienti nemají přístup ke quad SPI, dokud se aktivní klient nevzdá přístupu pomocí příkazu QSPI_CLOSE.
Přístup k paměťovým zařízením flash se čtyřmi SPI prostřednictvím libovolné adresy IP klienta poštovní schránky není ve výchozím nastavení k dispozici u návrhů, které zahrnují HPS, pokud QSPI nezakážete v konfiguraci softwaru HPS.
Důležité: Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_CLOSE 33 0 0 Uzavře výhradní přístup k rozhraní quad SPI.
Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_SET_CS 34 1 0 Určuje jedno z připojených zařízení quad SPI prostřednictvím linek výběru čipu. Přebírá jednoslovný argument, jak je popsáno níže
  • Bits[31:28]: Flash zařízení k výběru. Hodnotu, která odpovídá pinům nCSO[0:3], najdete v informacích níže
    • Hodnota 4'h0000 vybere blesk, který odpovídá nCSO[0].
    • Hodnota 4'h0001 vybere blesk, který odpovídá nCSO[1].
    • Hodnota 4'h0002 vybere blesk, který odpovídá nCSO[2].
    • Hodnota 4'h0003 vybere blesk, který odpovídá nCSO[3].
  • Bity[27:0]: Vyhrazeno (zápis jako 0).

Poznámka: Zařízení Intel Agilex nebo Intel Stratix® 10 podporují jedno paměťové zařízení AS x4 flash pro konfiguraci AS ze zařízení quad SPI připojeného k nCSO[0]. Jakmile zařízení vstoupí do uživatelského režimu, můžete použít až čtyři flash paměti AS x4 pro použití s ​​Mailbox Client IP nebo HPS jako úložiště dat. TheMailbox Client IP nebo HPS mohou používat nCSO[3:0] pro přístup k zařízením quad SPI.
Tento příkaz je volitelný pro schéma konfigurace AS x4, řádek výběru čipu následuje po posledním provedeném příkazu QSPI_SET_CS nebo je po konfiguraci AS x0 jako výchozí nastaven na nCSO[4]. JTAG konfigurační schéma vyžaduje provedení tohoto příkazu pro přístup k QSPI flash, který spojuje piny SDM_IO.
Přístup k paměťovým zařízením QSPI flash pomocí pinů SDM_IO je k dispozici pouze pro konfigurační schéma AS x4, JTAG konfigurace a návrh zkompilovaný pro konfiguraci AS x4. Pro konfigurační schéma Avalon streaming interface (Avalon ST) musíte připojit flash paměti QSPI k pinům GPIO.
pokračování…
  1. Toto číslo nezahrnuje hlavičku příkazu nebo odpovědi
Důležité: Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_READ 3A 2 N Čte připojené zařízení quad SPI. Maximální velikost přenosu je 4 kilobajty (KB) nebo 1024 slov.
Má dva argumenty:
  • Adresa quad SPI flash (jedno slovo). Adresa musí být zarovnána slovy. Zařízení vrací kód chyby 0x1 pro nezarovnané adresy.
  • Počet slov ke čtení (jedno slovo).

Když je to úspěšné, vrátí OK následované načtenými daty ze zařízení quad SPI. Odpověď na selhání vrátí kód chyby.
Pro částečně úspěšné čtení může QSPI_READ chybně vrátit stav OK.
Poznámka: Během konfigurace zařízení nemůžete spustit příkaz QSPI_READ.
Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_WRITE 39 2+N 0 Zapisuje data do zařízení quad SPI. Maximální velikost přenosu je 4 kilobajty (KB) nebo 1024 slov.
Má tři argumenty:
  • Posun adresy flash (jedno slovo). Adresa pro zápis musí být zarovnána na slova.
  • Počet slov k napsání (jedno slovo).
  • Data, která mají být zapsána (jedno nebo více slov). Úspěšný zápis vrátí kód odpovědi OK.

Chcete-li připravit paměť pro zápisy, použijte před zadáním tohoto příkazu příkaz QSPI_ERASE.
Poznámka: Během konfigurace zařízení nemůžete spustit příkaz QSPI_WRITE.
Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_ERASE 38 2 0 Vymaže sektor 4/32/64 KB zařízení quad SPI. Má dva argumenty:
  • Posun adresy flash pro zahájení mazání (jedno slovo). V závislosti na počtu slov k vymazání musí být počáteční adresa:
    • 4 kB zarovnáno, pokud je počet slov k vymazání 0x400
    • 32 kB zarovnáno, pokud je počet slov k vymazání 0x2000
    • 64 KB zarovnáno, pokud je počet slov k vymazání 0x4000 Vrátí chybu pro adresy nezarovnané 4/32/64 KB.
  • Počet slov k vymazání je zadán v násobcích:
    • 0x400 pro vymazání 4 KB (100 slov) dat. Tato možnost představuje minimální velikost výmazu.
    • 0x2000 pro vymazání 32 kB (500 slov) dat
    • 0x4000 pro vymazání 64 KB (1000 slov) dat Úspěšné vymazání vrátí kód odpovědi OK.

Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_READ_ DEVICE_REG 35 2 N Čte registry ze zařízení quad SPI. Maximální čtení je 8 bajtů. Má dva argumenty:
  • Operační kód pro příkaz read.
  • Počet bajtů ke čtení.
pokračování…
  1. Toto číslo nezahrnuje hlavičku příkazu nebo odpovědi.
Úspěšné čtení vrátí kód odpovědi OK následovaný daty načtenými ze zařízení. Návrat načtených dat je v násobcích 4 bajtů. Pokud bajty ke čtení nejsou přesným násobkem 4 bajtů, jsou doplněny násobkem 4 bajtů, dokud není hranice dalšího slova a hodnota osazeného bitu je nula.
Důležité: Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_WRITE_ DEVICE_REG 36 2+N 0 Zapisuje do registrů quad SPI. Maximální zápis je 8 bajtů. Má tři argumenty:
  • Operační kód pro příkaz write.
  • Počet bajtů k zápisu.
  • Data k zápisu.

Chcete-li provést vymazání sektoru nebo vymazání podsektoru, musíte zadat sériovou adresu flash v pořadí od nejvýznamnějších bajtů (MSB) po nejnižší bajty (LSB), jako je následující příkladample ilustruje.
Chcete-li vymazat sektor flash paměti Micron 2 gigabit (Gb) na adrese 0x04FF0000 pomocí příkazu QSPI_WRITE_DEVICE_REG, zapište adresu flash v pořadí MSB až LSB, jak je znázorněno zde:
záhlaví: 0x00003036 Operační kód: 0x000000DC
Počet bajtů k zápisu: 0x00000004 Adresa Flash: 0x0000FF04
Úspěšný zápis vrátí kód odpovědi OK. Tento příkaz vloží data, která nejsou násobkem 4 bajtů, na hranici dalšího slova. Příkaz doplní data nulou.
Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.
QSPI_SEND_ DEVICE_OP 37 1 0 Odešle operační kód příkazu do quad SPI. Trvá jeden argument:
  • Operační kód pro odeslání quad SPI zařízení.

Úspěšný příkaz vrátí kód odpovědi OK.
Důležité:Při resetování quad SPI musíte postupovat podle pokynů uvedených v Resetování Quad SPI Flash na straně 9.

Popisy hlavních a menších chybových kódů CONFIG_STATUS a RSU_STATUS naleznete v Dodatku: Popisy chybových kódů CONFIG_STATUS a RSU_STATUS v Uživatelské příručce Mailbox Client Intel FPGA IP.
Související informace

Odpovědi na chybový kód

Tabulka 8. Chybové kódy

Hodnota (hexadecimální) Odpověď na chybový kód Popis
0 OK Označuje, že příkaz byl úspěšně dokončen.
Příkaz může chybně vrátit stav OK, pokud příkaz, jako např
QSPI_READ je částečně úspěšný.
1 NEPLATNÝ PŘÍKAZ Označuje, že aktuálně načtená boot ROM nemůže dekódovat nebo rozpoznat kód příkazu.
3 NEZNÁMÝ PŘÍKAZ Označuje, že aktuálně načtený firmware nemůže dekódovat kód příkazu.
4 INVALID_COMMAND_ PARAMETERS Označuje, že příkaz je nesprávně naformátován. Napřample, nastavení pole délky v záhlaví není platné.
6 COMMAND_INVALID_ON_ SOURCE Označuje, že příkaz pochází ze zdroje, pro který není povolen.
8 CLIENT_ID_NO_MATCH Označuje, že ID klienta nemůže dokončit požadavek na uzavření výhradního přístupu ke quad SPI. ID klienta neodpovídá stávajícímu klientovi s aktuálním výhradním přístupem ke quad SPI.
9 NEPLATNÁ ADRESA Adresa je neplatná. Tato chyba označuje jednu z následujících podmínek:
  • Nezarovnaná adresa
  • Problém s rozsahem adres
  • Problém s oprávněním ke čtení
  • Neplatná hodnota výběru žetonu, zobrazující hodnotu vyšší než 3
  • Neplatná adresa v případě RSU
  • Neplatná hodnota bitové masky pro GET_VOLTAGE příkaz
  • Neplatný výběr stránky pro příkaz GET_TEMPERATURE
A AUTHENTICATION_FAIL Označuje selhání ověřování podpisu bitového proudu konfigurace.
B TIMEOUT Tato chyba označuje časový limit kvůli následujícím podmínkám:
  • Příkaz
  • Čeká se na dokončení operace QSPI_READ
  • Čekání na požadovaný údaj teploty z jednoho z teplotních čidel. Může indikovat potenciální hardwarovou chybu v teplotním senzoru.
C HW_NOT_READY Označuje jednu z následujících podmínek:
  • Hardware není připraven. Může indikovat problém s inicializací nebo konfigurací. Hardware může odkazovat na quad SPI.
  • Obraz RSU se nepoužívá ke konfiguraci FPGA.
D HW_ERROR Označuje, že příkaz byl neúspěšně dokončen kvůli neodstranitelné hardwarové chybě.
80 – 8F COMMAND_SPECIFIC_ ERROR Označuje specifickou chybu příkazu způsobenou příkazem SDM, který jste použili.
SDM

Příkaz

 Název chyby Kód chyby Popis
GET_CHIPID EFUSE_SYSTEM_ FAILURE 0x82 Označuje, že ukazatel mezipaměti eFuse je neplatný.
QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/

QSPI_READ_D EVICE_REG/

 QSPI_HW_ERROR 0x80 Označuje chybu flash paměti QSPI. Tato chyba označuje jednu z následujících podmínek:
QSPI_WRITE_ DEVICE_REG/

QSPI_SEND_D EVICE_OP/

QSPI_READ
  • Problém s nastavením výběru flash čipu QSPI
  • Problém s inicializací flash QSPI
  • Problém s resetováním blesku QSPI
  • Problém s aktualizací nastavení flash QSPI
QSPI_ALREADY_ OPEN 0x81 Označuje, že výhradní přístup klienta k QSPI flash prostřednictvím příkazu QSPI_OPEN je již otevřen.
100 NENÍ NAKONFIGUROVÁNO Označuje, že zařízení není nakonfigurováno.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Označuje, že zařízení je zaneprázdněné kvůli následujícím případům použití:
  • RSU: Firmware není schopen přejít na jinou verzi kvůli vnitřní chybě.
  • HPS: HPS je zaneprázdněn během procesu rekonfigurace HPS nebo studeného restartu HPS.
2FF ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE Označuje, že není k dispozici žádná platná odpověď.
3FF ALT_SDM_MBOX_RESP_ ERROR Obecná chyba.

Obnova chybového kódu
Níže uvedená tabulka popisuje možné kroky pro zotavení z chybového kódu. Obnova chyb závisí na konkrétním případu použití.
Tabulka 9. Obnova chybového kódu pro známé chybové kódy

Hodnota Odpověď na chybový kód Obnova chybového kódu
4 INVALID_COMMAND_ PARAMETERS Znovu odešlete záhlaví nebo záhlaví příkazu s argumenty s opravenými parametry.
Napřample, ujistěte se, že nastavení pole délky v záhlaví je odesláno se správnou hodnotou.
6 COMMAND_INVALID_ ON_SOURCE Znovu odešlete příkaz z platného zdroje, jako je JTAG, HPS nebo jádrová tkanina.
8 CLIENT_ID_NO_MATCH Počkejte, až klient, který otevřel přístup ke quad SPI, dokončí svůj přístup a poté zavře výhradní přístup ke quad SPI.
9 NEPLATNÁ ADRESA Možné kroky k nápravě chyby:
Pro GET_VOLTAGE příkaz: Odešle příkaz s platnou bitovou maskou.
Pro příkaz GET_TEMPERATURE: Odešlete příkaz s platným umístěním senzoru a maskou senzoru.
Pro provoz QSPI:
  • Odešlete příkaz s platným výběrem čipu.
  • Odešlete příkaz s platnou flash adresou QSPI.

Pro RSU: Odešlete příkaz s platnou počáteční adresou továrního obrazu nebo aplikace.
B TIMEOUT Možné kroky obnovy:

Pro příkaz GET_TEMPERATURE: Opakujte odeslání příkazu znovu. Pokud problém přetrvává, změňte konfiguraci nebo vypněte zařízení.

Pro provoz QSPI: Zkontrolujte integritu signálu rozhraní QSPI a zkuste zadat příkaz znovu.

Operace restartu HPS: Zkuste znovu odeslat příkaz.
C HW_NOT_READY Možné kroky obnovy:

Pro provoz QSPI: Překonfigurujte zařízení přes zdroj. Ujistěte se, že IP použitá k vytvoření vašeho návrhu umožňuje přístup k QSPI flash.

Pro RSU: Nakonfigurujte zařízení pomocí obrazu RSU.
80 QSPI_HW_ERROR Zkontrolujte integritu signálu rozhraní QSPI a ujistěte se, že zařízení QSPI není poškozeno.
81 QSPI_ALREADY_OPEN Klient již QSPI otevřel. Pokračujte další operací.
82 EFUSE_SYSTEM_FAILURE Pokus o rekonfiguraci nebo vypnutí napájení. Pokud chyba přetrvává i po rekonfiguraci nebo vypnutí napájení, zařízení může být poškozené a neopravitelné.
100 NENÍ NAKONFIGUROVÁNO Odešlete bitový tok, který konfiguruje HPS.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Možné kroky k nápravě chyby:

Pro operaci QSPI: Počkejte na probíhající konfiguraci nebo na dokončení operace jiného klienta.

Pro RSU: Překonfigurujte zařízení, aby se zotavilo z vnitřní chyby.

Operace restartu HPS: Počkejte na dokončení rekonfigurace pomocí HPS nebo HPS Cold Reset.

Poštovní klient s Avalon Streaming rozhraním Intel FPGA IP Uživatelská příručka Archiv dokumentů

Nejnovější a předchozí verze této uživatelské příručky viz Mailbox Client s Avalon Streaming Interface Uživatelská příručka Intel FPGA IP. Pokud IP nebo verze softwaru není uvedena, platí uživatelská příručka pro předchozí IP nebo verzi softwaru.

Verze IP jsou stejné jako verze softwaru Intel Quartus Prime Design Suite až do v19.1. Od verze softwaru Intel Quartus Prime Design Suite 19.2 nebo novější mají jádra IP nové schéma verzování IP.

Historie revizí dokumentu pro klienta Mailbox s Avalon Streaming Interface Uživatelská příručka Intel FPGA IP

Verze dokumentu Verze Intel Quartus Prime IP verze Změny
2022.09.26 22.3 1.0.1 Provedl následující změny:
  • Aktualizováno GET_VOLTAGE příkazový řádek v

Seznam příkazů a tabulka popisu.

  • Přidána poznámka k podpoře rodiny tabulkových zařízení.
  • Revidováno QSPI_SET_CS popis příkazu v tabulce Seznam příkazů a Popis.
2022.04.04 22.1 1.0.1 Aktualizována tabulka Seznam příkazů a Popis.
  • Aktualizovaný popis stavu pinů pro příkaz CONFIG_STATUS.
  • Odstraněn příkaz REBOOT_HPS.
2021.10.04 21.3 1.0.1 Provedl následující změnu:
  • Revidováno Seznam a popis příkazů stůl. Aktualizovaný popis pro:
    • CONFIG_STATUS
    • RSU_STATUS
2021.06.21 21.2 1.0.1 Provedl následující změny:
  • Revidováno Seznam a popis příkazů stůl. Aktualizovaný popis pro:
    • RSU_STATUS
    • QSPI_OPEN
    • QSPI_SET_CS
    • QSPI_ERASE
2021.03.29 21.1 1.0.1 Provedl následující změny:
  • Upravený popis RSU_IMAGE_UPDATE v Seznam a popis příkazů tabulka.
  • Restrukturalizováno Provozní příkazy. Byly odstraněny popisy hlavních a menších chybových kódů pro příkazy CONFIG_STATUS a RSU_STATUS. Hlavní a vedlejší chybové kódy jsou nyní zdokumentovány jako příloha v Uživatelská příručka poštovního klienta Intel FPGA IP.
2020.12.14 20.4 1.0.1 Provedl následující změny:
  • Přidána důležitá poznámka o resetování QSPI flash v Provozní příkazy téma.
  • Aktualizováno Seznam a popis příkazů stůl:
    • Upravený popis příkazu GET_TEMPERATURE.
    • Upravený popis příkazu RSU_IMAGE_UPDATE.
  • Přidán text o resetování QSPI flash.
  • Přidán text popisující chování mezi externím hostitelem a FPGA.
  • Odebraný text: Vrátí nenulovou odpověď, pokud zařízení již zpracovává konfigurační příkaz.
    • Byly aktualizovány popisy QSPI_WRITE a QSPI_READ tak, aby uváděly, že maximální velikost přenosu je 4 kilobajty nebo 1024 slov.
    • Opravená délka odezvy z 1 na 0 pro QSPI_OPEN, QSPI_CLOSE a QSPI_SET_CS příkaz.
    • Upravené popisy QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG a QSPI_WRITE_DEVICE_REG.
    • Přidán nový příkaz: REBOOT_HPS.
  • Přidáno nové téma: Obnova chybového kódu.
2020.10.05 20.3 1.0.1
  • Změněn název této uživatelské příručky z Mailbox Avalon Streaming Interface Client Uživatelská příručka Intel FPGA IP na Mailbox Client s Avalon Streaming Interface Uživatelská příručka Intel FPGA IP kvůli změně názvu IP v katalogu IP Intel Quartus Prime.
  • Globálně aktualizovány všechny instance názvu IP.
  • Upravený popis příkazu GET TEMPERATURE pro zařízení Intel Agilex v Seznam a popis příkazů tabulka.
  • Přidáno doporučení ohledně resetování synchronizátoru v Rozhraní hodin a resetování tabulka.
  • Aktualizováno Chybové kódy stůl. Přidány nové odpovědi na chybový kód:
    • HW_ERROR
    • COMMAND_SPECIFIC_ERROR
  • Odebráno Umístění snímačů teploty téma. Informace o teplotním čidle jsou k dispozici v Uživatelská příručka Intel Agilex Power Management.
2020.06.30 20.2 1.0.0
  • Změněn název této uživatelské příručky z Mailbox Avalon ST Client Uživatelská příručka Intel FPGA IP na Mailbox Avalon Streaming Interface Client Uživatelská příručka Intel FPGA IP.
  • Přejmenován název tématu Hlavička příkazů a odpovědí na Příkazy a odpovědi.
  • Upravené popisy ID, DÉLKY a příkazového kódu/chybového kódu v Popis záhlaví příkazů a odpovědí tabulka.
  • Přejmenován název tématu Podporované příkazy na Provozní příkazy.
  • Byl revidován následující popis příkazů v Seznam a popis příkazů stůl:
    • GET_TEMPERATURE
    • RSU_STATUS
    • QSPI_SET_CS
  • Přejmenován název tématu Chybové kódy na Odpovědi na chybový kód.
  • Odebrán příkaz UNKNOWN_BR z Kód chyby tabulka.
2020.04.13 20.1 1.0.0 Provedl následující změny:
  • Přidány informace o teplotních senzorech pro příkaz GET_TEMPERATURE, včetně obrázků znázorňujících umístění TSD.
  • Přidán příkaz RSU_NOTIFY v Seznam a popis příkazových kódů tabulka.
  • Aktualizováno Chybové kódy stůl:
    • Přejmenováno INVALID_COMMAND_PARAMETERS na INVALID_LENGTH.
    • Hexadecimální hodnota COMMAND_INVALID_ON_SOURCE změněna z 5 na 6.
    • Hexadecimální hodnota CLIENT_ID_NO_MATCH změněna z 6 na 8.
    • Hexadecimální hodnota INVALID_ADDRESS změněna ze 7 na 9.
    • Přidán příkaz AUTHENTICATION_FAIL.
    • Hexadecimální hodnota TIMEOUT změněna z 8 na B.
    • Hexadecimální hodnota HW_NOT_READY byla změněna z 9 na C.
2019.09.30 19.3 1.0.0 Počáteční vydání.

 Pro zpětnou vazbu prosím navštivte:  FPGAtechdocfeedback@intel.com

 

Dokumenty / zdroje

intel Mailbox Client s Avalon Streaming Interface FPGA IP [pdfUživatelská příručka
Poštovní klient s Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Reference

Související příspěvky

Zanechte komentář

Vaše emailová adresa nebude zveřejněna. Povinná pole jsou označena *