intel Mailbox Client med Avalon Streaming Interface FPGA IP Användarhandbok
intel Mailbox Client med Avalon Streaming Interface FPGA IP

Innehåll dölja
1 Mailbox Client med Avalon® Streaming Interface Intel FPGA IP Overview
1.1 Enhetsfamiljesupport
2 Dokument/resurser
2.1 Referenser
3 Relaterade inlägg

Mailbox Client med Avalon® Streaming Interface Intel FPGA IP Overview

Mailbox Client med Avalon®-strömningsgränssnitt Intel® FPGA IP (Mailbox Client med Avalon ST Client IP) tillhandahåller en kommunikationskanal mellan din anpassade logik och den säkra enhetshanteraren (SDM). Du kan använda Mailbox Client med Avalon ST IP för att skicka kommandopaket och ta emot svarspaket från SDM-perifera moduler. Mailbox Client med Avalon ST IP definierar funktioner som SDM kör.

Din anpassade logik kan använda den här kommunikationskanalen för att ta emot information och komma åt flashminne från följande kringutrustningsmoduler:

  • Chip-ID
  • Temperatursensorn
  • Voltage Sensor
  • Quad Serial Peripheral Interface (SPI) flashminne

Notera: I den här användarhandboken förkortar termen Avalon ST Avalon streaming interface eller IP.

Figur 1. Mailbox Client med Avalon ST IP-systemdesign
Mailbox Client med Avalon ST IP-systemdesign

Följande bild visar en applikation där Mailbox Client med Avalon ST IP läser Chip ID.

Figur 2. Brevlådeklient med Avalon ST IP läser Chip ID
Brevlådeklient med Avalon ST IP läser Chip ID

Enhetsfamiljesupport

Följande listar enhetsstödnivådefinitionerna för Intel FPGA IP:er:

  • Förhandsstöd — IP-adressen är tillgänglig för simulering och kompilering för denna enhetsfamilj. Tidsmodeller inkluderar initiala tekniska uppskattningar av förseningar baserat på tidig information efter layout. Tidsmodellerna kan ändras eftersom kiseltestning förbättrar korrelationen mellan det faktiska kiseln och tidsmodellerna. Du kan använda denna IP för systemarkitektur och resursutnyttjandestudier, simulering, pin-out, systemlatensbedömningar, grundläggande timingbedömningar (pipelinebudgetering) och I/O-överföringsstrategi (datavägsbredd, burstdjup, handel med I/O-standarder offs).
  • Preliminärt stöd — IP:n verifieras med preliminära tidsmodeller för denna enhetsfamilj. IP:n uppfyller alla funktionskrav, men kan fortfarande genomgå tidsanalys för enhetsfamiljen. Det kan användas i produktionsdesign med försiktighet.
  • Slutligt stöd — IP:n verifieras med slutgiltiga tidsmodeller för denna enhetsfamilj. IP:n uppfyller alla funktions- och tidskrav för enhetsfamiljen och kan användas i produktionsdesigner.

Tabell 1. Enhetsfamiljesupport

Enhetsfamilj Stöd
Intel Agilex™ Förskott

Notera: Du kan inte simulera Mailbox Client med Avalon Streaming Interface Intel FPGA IP eftersom IP:n tar emot svaren från SDM. För att validera denna IP rekommenderar Intel att du utför hårdvaruutvärdering.

Relaterad information
Brevlådeklient med Avalon Streaming Interface Intel FPGA IP Release Notes

Parametrar

Parameternamn Värde Beskrivning
Aktivera statusgränssnitt På av När du aktiverar det här gränssnittet inkluderar Mailbox Client med Avalon streaming-gränssnitt Intel FPGA IP signalen command_status_invalid. När command_status_invalid hävdar måste du återställa IP:n.

Gränssnitt
Följande bild illustrerar Mailbox Client med Avalon Streaming Interface Intel FPGA IP-gränssnitt:

Figur 3. Brevlådeklient med Avalon Streaming Interface Intel FPGA IP-gränssnitt
Brevlådeklient med Avalon Streaming Interface Intel FPGA IP-gränssnitt

För mer information om Avalons strömningsgränssnitt, se Avalons gränssnittsspecifikationer.
Relaterad information
Avalon gränssnittsspecifikationer

Klocka och återställ gränssnitt

Tabell 2. Klocka och återställ gränssnitt

Signalnamn Riktning Beskrivning
in_clk Input Det här är klockan för Avalons strömningsgränssnitt. Den maximala frekvensen i 250 MHz.
in_reset Input Detta är en aktiv hög återställning. Bekräfta in_reset för att återställa Mailbox Client med Avalon streaming interface Intel FPGA IP (Mailbox Client with Avalon ST IP). När in_reset-signalen bekräftas måste SDM:n spola all pågående aktivitet från Mailbox Client med Avalon ST IP. SDM fortsätter att bearbeta kommandon från andra klienter.

För att säkerställa att brevlådeklienten med Avalon ST IP fungerar korrekt när enheten går in i användarläge, måste din design inkludera Reset Release Intel FPGA IP för att hålla återställningen tills FPGA-tyget går in i användarläge. Intel rekommenderar att du använder en återställningssynkroniserare när du ansluter användaråterställningen eller utgången för Reset Release IP till
återställningsporten för Mailbox Client med Avalon ST IP. För att implementera återställningssynkroniseraren, använd Reset Bridge Intel FPGA IP som är tillgänglig i Platform Designer.

Notera: För IP-instansiering och anslutningsriktlinjer i plattformsdesignern, se Required Communication and Host Components för Remote System Update Design Ex.ampfiguren i Intel Agilex Configuration User Guide.

Kommandogränssnitt
Använd Avalon Streaming-gränssnittet (Avalon ST) för att skicka kommandon till SDM.

Tabell 3. Kommandogränssnitt

Signalnamn Riktning Beskrivning
kommando_klar Produktion Mailbox Client med Avalon ST Intel FPGA IP bekräftar command_ready när den är redo att ta emot kommandon från applikationen. Ready_latency är 0 cykler. Mailbox-klienten med Avalon ST kan acceptera command_data[31:0] i samma cykel som command_ready hävdar.
kommando_giltigt Input Signalen command_valid hävdar att kommando_data är giltig.
command_data[31:0] Input Command_data-bussen driver kommandon till SDM. Se Kommandolista och Beskrivning för definitioner av kommandona.
command_startofpacket Input Command_startofpacket hävdar i den första cykeln av ett kommandopaket.
command_endofpacket Input Command_endofpacket hävdar i den sista kommandocykeln ett paket.

Figur 4. Tidpunkt för Avalon ST Command Packet
fig:m ST-kommandopaket

Svarsgränssnitt
SDM Avalon ST Client IP skickar svar till din applikation med hjälp av svarsgränssnittet.

Tabell 4. Responsgränssnitt

Signal 5 Riktning Beskrivning
response_ready Input Applikationslogik kan hävda response_ready-signalen närhelst den kan ta emot ett svar.
response_valid Produktion SDM hävdar response_valid för att indikera att response_data är giltiga.
response_data[31:0] Produktion SDM driver response_data för att tillhandahålla den begärda informationen. Det första ordet i svaret är en rubrik som identifierar kommandot som SDM tillhandahåller. Referera till Kommandolista och beskrivning för definitioner av kommandona.
response_startofpacket Produktion Response_startofpacket hävdar i den första cykeln av ett svarspaket.
response_endofpacket Produktion Response_endofpacket hävdar i den sista cykeln av ett svarspaket.

Figur 5. Timing för Avalon ST-svarspaket
Avalon ST svarspaket

Kommandostatusgränssnitt

Tabell 5. Kommandostatusgränssnitt

Signalnamn Riktning Beskrivning
command_status_invalid Produktion Command_status_invalid hävdar för att indikera ett fel. Denna signal hävdar vanligtvis att längden på kommandot som anges i kommandohuvudet inte matchar längden på det skickade kommandot. När command_status_invalid hävdar måste din applikationslogik hävda in_reset för att starta om Mailbox Client med Avalon streaming interface Intel FPGA IP.

Figur 6. Återställ efter command_status_invalid hävdar
fig: command_status_invalid hävdar

Kommandon och svar

Värdstyrenheten kommunicerar med SDM:n med hjälp av kommando- och svarspaket via Mailbox Client Intel FPGA IP.

Det första ordet i kommando- och svarspaketen är en rubrik som ger grundläggande information om kommandot eller svaret.

Figur 7. Kommando- och svarshuvudformat
fig: Kommando- och svarshuvudformat

Notera: LENGTH-fältet i kommandohuvudet måste matcha kommandolängden för motsvarande kommando.
Följande tabell beskriver fälten för header-kommandot.

Tabell 6. Kommando- och svarshuvud Beskrivning

Rubrik Bit Beskrivning
Reserverad [31:28] Reserverad.
ID [27:24] Kommandot ID. Svarshuvudet returnerar det ID som anges i kommandohuvudet. Se Operation Commands för kommandobeskrivningar.
0 [23] Reserverad.
LÄNGD [22:12] Antal ord med argument efter rubriken. IP:n svarar med ett felmeddelande om ett felaktigt antal ord med argument anges för ett givet kommando.
Om det inte överensstämmer mellan kommandolängden som anges i kommandohuvudet och antalet skickade ord. IP:n höjer bit 3 i avbrottsstatusregistret (COMMAND_INVALID) och brevlådeklienten måste återställas.
Reserverad [11] Reserverad. Måste sättas till 0.
Kommandokod/felkod [10:0] Kommandokod anger kommandot. Felkoden anger om kommandot lyckades eller misslyckades.
I kommandohuvudet representerar dessa bitar kommandokod. I svarshuvudet representerar dessa bitar felkod. Om kommandot lyckas är felkoden 0. Om kommandot misslyckas, se felkoderna som definieras i Felkodsvar.

Operationskommandon

Återställer Quad SPI Flash
Viktig: För Intel Agilex-enheter måste du ansluta den seriella blixten eller quad SPI-blixtens återställningsstift till AS_nRST-stiftet. SDM:n måste helt kontrollera QSPI-återställningen. Anslut inte quad SPI-återställningsstiftet till någon extern värd.

Tabell 7. Kommandolista och beskrivning

Kommando Kod (hexadecimal) Kommandolängd (1) Svarslängd (1) Beskrivning
NEJ 0 0 0 Skickar ett OK-statussvar.
GET_IDCODE 10 0 1 Svaret innehåller ett argument som är JTAG IDCODE för enheten
GET_CHIPID 12 0 2 Svaret innehåller 64-bitars CHIPID-värde med det minst signifikanta ordet först.
GET_USERCODE 13 0 1 Svaret innehåller ett argument som är 32-bitars JTAG ANVÄNDARKOD som konfigurationsbitströmmen skriver till enheten.
GET_VOLTAGE 18 1 n(2) GET_VOLTAGE-kommandot har ett enda argument som är en bitmask som anger vilka kanaler som ska läsas. Bit 0 anger kanal 0, bit 1 anger kanal 1 och så vidare.
Svaret inkluderar ett ettordsargument för varje bituppsättning i bitmasken. Voltage som returneras är ett osignerat fastpunktsnummer med 16 bitar under den binära punkten. Till exempelample, en voltage på 0.75V ger 0x0000C000. (3)
Intel Agilex-enheter har en enda voltage sensor. Följaktligen är svaret alltid ett ord.
GET_ TEMPERATURE 19 1 n(4) Kommandot GET_TEMPERATURE returnerar temperaturen eller temperaturerna för kärntyget eller sändtagarens kanalplatser som du anger.

För Intel Agilex-enheter, använd argumentet sensor_req för att ange platserna. Sensor_req innehåller följande fält:

  • Bits[31:28]: Reserverad.
  • Bits[27:16]: Sensorplacering. Anger TSD-platsen.
  • Bits[15:0]: Sensormask. Anger de sensorer som ska läsas för den angivna sensorplatsen. Svaret innehåller ett ord för varje begärd temperatur. Om det utelämnas läser kommandot kanal 0. Den minst signifikanta biten (lsb) motsvarar sensor 0. Den mest signifikanta biten (msb) motsvarar kanal 15.

Temperaturen som returneras är ett förtecknat fast värde med 8 bitar under den binära punkten. Till exempelample, en temperatur på 10°C returnerar 0x00000A00. En temperatur på -1.5°C ger 0xFFFFFE80.
Om bitmasken anger en ogiltig plats returnerar kommandot en felkod som är ett valfritt värde i intervallet 0x80000000 -0x800000FF.
För Intel Agilex-enheter, se Intel Agilex Power Management User Guide för mer information om lokala inbyggda temperatursensorer.
RSU_IMAGE_ UPPDATERING 5C 2 0 Utlöser omkonfiguration från datakällan som kan vara antingen fabriken eller en applikationsavbildning.
fortsatt…
  1. Detta nummer inkluderar inte kommandot eller svarshuvudet.
  2. För Intel Agilex-enheter som stöder läsning av flera enheter, matchar index n antalet kanaler du aktiverar på din enhet.
  3. Se till Intel Agilex Power Management användarhandbok för mer information om temperatursensorkanaler och placeringar.
  4. Index n beror på antalet sensormasker.
Kommando Kod (hexadecimal) Kommandolängd (1) Svarslängd (1) Beskrivning
Detta kommando tar ett valfritt 64-bitars argument som anger omkonfigurationsdataadressen i flash. När du skickar argumentet till IP:n skickar du först bitar [31:0] följt av bitar [63:32]. Om du inte anger detta argument antas dess värde vara 0.
  • Bit [31:0]: Startadressen för en applikationsbild.
  • Bit [63:32]: Reserverad (skriv som 0).

När enheten väl bearbetar detta kommando, returnerar den svarshuvudet till svars-FIFO innan den fortsätter att konfigurera om enheten. Se till att värddatorn eller värdstyrenheten slutar betjäna andra avbrott och fokuserar på att läsa svarshuvuddata för att indikera att kommandot slutförts framgångsrikt. Annars kan det hända att värddatorn eller värdstyrenheten inte kan ta emot svaret när omkonfigureringsprocessen har startat.
När enheten väl fortsätter med omkonfigureringen försvinner länken mellan den externa värden och FPGA. Om du använder PCIe i din design måste du räkna om PCIe-länken.
Viktig: När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
RSU_GET_SPT 5A 0 4 RSU_GET_SPT hämtar quad SPI-flashplatsen för de två underpartitionstabellerna som RSU:n använder: SPT0 och SPT1.
Svaret på fyra ord innehåller följande information:
Ord Namn Beskrivning
0 SPT0[63:32] SPT0-adress i quad SPI-blixt.
1 SPT0[31:0]
2 SPT1[63:32] SPT1-adress i quad SPI-blixt.
3 SPT1[31:0]
CONFIG_ STATUS 4 0 6 Rapporterar status för den senaste omkonfigurationen. Du kan använda detta kommando för att kontrollera konfigurationsstatusen under och efter konfigurationen. Svaret innehåller följande information:
Ord Sammanfattning Beskrivning
0 Ange Beskriver det senaste konfigurationsrelaterade felet. Returnerar 0 när det inte finns några konfigurationsfel.
Felfältet har 2 fält:
  • Övre 16 bitar: Stor felkod.
  • Lägre 16 bitar: Mindre felkod.

Se bilaga: CONFIG_STATUS och RSU_STATUS felkodsbeskrivningar i Mailbox Client Intel FPGA IP  Användarhandbok för mer information.
1 Quartus version Tillgänglig i Intel Quartus® Prime-programvaruversioner mellan 19.4 och 21.2, fältet visar:
  • Bit [31:28]: Index över den fasta programvaran eller kopian av den fasta programvaran för beslut som användes senast. Möjliga värden är 0, 1, 2 och 3.
  • Bit [27:24]: Reserverad
  • Bit [23:16]: Värdet är '0'
Tillgänglig i Intel Quartus Prime-programversion 21.3 eller senare, Quartus-versionen visar:
  • Bit [31:28]: Index över den fasta programvaran eller kopian av den fasta programvaran för beslut som användes senast. Möjliga värden är 0, 1, 2 och 3.
  • Bit [27:24]: Reserverad
  • Bit [23:16]: Major Quartus releasenummer
  • Bit [15:8]: Minor Quartus releasenummer
  • Bit [7:0]: Quartus-uppdateringsnummer

Till exempelample, i Intel Quartus Prime-programvaruversion 21.3.1, representerar följande värden de större och mindre Quartus-utgåvorna och Quartus-uppdateringsnumret:

  • 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]: Aktuellt nSTATUS-utgångsvärde (aktivt lågt)
  • Bit [30]: Detekterat nCONFIG-ingångsvärde (aktivt lågt)
  • Bit [29:8]: Reserverad
  • Bit [7:6]: Konfigurationsklockkälla
    • 01 = Intern oscillator
    • 10 = OSC_CLK_1
  • Bit [5:3]: Reserverad
  • Bit [2:0]: MSEL-värdet vid start
3 Mjuk funktionsstatus Innehåller värdet för var och en av de mjuka funktionerna, även om du inte har tilldelat funktionen till ett SDM-stift.
  • Bit [31:6]: Reserverad
  • 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 Felplats Innehåller felplatsen. Returnerar 0 om det inte finns några fel.
5 Detaljer om felet Innehåller felinformationen. Returnerar 0 om det inte finns några fel.
RSU_STATUS 5B 0 9 Rapporterar aktuell fjärrsystemuppgraderingsstatus. Du kan använda det här kommandot för att kontrollera konfigurationsstatusen under konfigurationen och efter att den har slutförts. Detta kommando returnerar följande svar:
Ord Sammanfattning Beskrivning

(Fortsätta….)
  1. Detta nummer inkluderar inte kommandot eller svarshuvudet
0-1 Aktuell bild Flash-offset för den programbild som körs för närvarande.
2-3 Misslyckad bild Blixtförskjutning av den högst prioriterade misslyckade applikationsbilden. Om flera bilder finns tillgängliga i flashminnet lagras värdet för den första bilden som misslyckades. Ett värde på alla nollor indikerar inga misslyckade bilder. Om det inte finns några felaktiga bilder, lagrar inte resten av de återstående orden i statusinformationen giltig information.
Notera:En stigande kant på nCONFIG för att omkonfigurera från ASx4 rensar inte detta fält. Information om misslyckad bild uppdateras endast när Mailbox Client tar emot ett nytt RSU_IMAGE_UPDATE-kommando och konfigureras från uppdateringsbilden.
4 Ange Felkod för den felaktiga bilden. Felfältet har två delar:
  • Bit [31:16]: Stor felkod
  • Bit [15:0]: Mindre felkod Returnerar 0 för inga fel. Referera till

Bilaga: CONFIG_STATUS och RSU_STATUS felkodsbeskrivningar i Mailbox Client Intel FPGA IP User Guide för mer information.
5 Version RSU-gränssnittsversion och felkälla.
Mer information finns i avsnittet RSU-status och felkoder i användarhandboken för hårdprocessorsystem för fjärrsystemuppdatering.
6 Felplats Lagrar felplatsen för den felaktiga bilden. Returnerar 0 för inga fel.
7 Detaljer om felet Lagrar felinformationen för den felaktiga bilden. Returnerar 0 om det inte finns några fel.
8 Aktuell bildförsöksräknare Antal återförsök som har gjorts för den aktuella bilden. Räknaren är initialt 0. Räknaren sätts till 1 efter det första försöket, sedan 2 efter ett andra försök.
Ange det maximala antalet återförsök i dina Intel Quartus Prime-inställningar File (.qsf). Kommandot är: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Giltiga värden för MAX_RETRY-räknaren är 1-3. Det faktiska antalet tillgängliga återförsök är MAX_RETRY -1
Det här fältet lades till i version 19.3 av programvaran Intel Quartus Prime Pro Edition.
fortsatt…
  1. Detta nummer inkluderar inte kommandot eller svarshuvudet.
RSU_NOTIFY 5D 1 0 Rensar all felinformation i RSU_STATUS-svaret och återställer återförsöksräknaren. Ettordsargumentet har följande fält:
  • 0x00050000: Rensa den aktuella återställningsräknaren. Genom att nollställa den aktuella återförsöksräknaren återställs räknaren till noll, som om den aktuella bilden laddades upp för första gången.
  • 0x00060000: Rensa felstatusinformation.
  • Alla andra värden är reserverade.

Detta kommando är inte tillgängligt före version 19.3 av programvaran Intel Quartus Prime Pro Edition.
QSPI_OPEN 32 0 0 Begär exklusiv tillgång till quad SPI. Du utfärdar denna begäran före alla andra QSPI-förfrågningar. SDM:n accepterar begäran om quad SPI:n inte används och SDM:n inte konfigurerar enheten.
Återgår OK om SDM beviljar åtkomst.
SDM ger exklusiv åtkomst till klienten som använder denna brevlåda. Andra klienter kan inte få åtkomst till quad SPI förrän den aktiva klienten avstår från åtkomst med kommandot QSPI_CLOSE.
Åtkomst till quad SPI-flashminnen via valfri postlådeklient-IP är inte tillgänglig som standard i design som inkluderar HPS, såvida du inte inaktiverar QSPI i HPS-programvarukonfigurationen.
Viktig: När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_CLOSE 33 0 0 Stänger den exklusiva åtkomsten till quad SPI-gränssnittet.
Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_SET_CS 34 1 0 Anger en av de anslutna quad SPI-enheterna via chipvalslinjerna. Tar ett ettordsargument enligt beskrivningen nedan
  • Bits[31:28]: Flash-enhet att välja. Se informationen nedan för värdet som motsvarar nCSO[0:3]-stiften
    • Värde 4'h0000 väljer blixten som motsvarar nCSO[0].
    • Värde 4'h0001 väljer blixten som motsvarar nCSO[1].
    • Värde 4'h0002 väljer blixten som motsvarar nCSO[2].
    • Värde 4'h0003 väljer den blixt som motsvarar nCSO[3].
  • Bitar[27:0]: Reserverad (skriv som 0).

Notera: Intel Agilex- eller Intel Stratix® 10-enheter stöder en AS x4-flashminne för AS-konfiguration från quad SPI-enhet ansluten till nCSO[0]. När enheten väl har gått in i användarläge kan du använda upp till fyra AS x4-flashminnen för användning med Mailbox Client IP eller HPS som datalagring. TheMailbox Client IP eller HPS kan använda nCSO[3:0] för att komma åt quad SPI-enheter.
Detta kommando är valfritt för AS x4-konfigurationsschemat, chipvalsraden följer det senast exekverade QSPI_SET_CS-kommandot eller ställer in som standard nCSO[0] efter AS x4-konfigurationen. Den JTAG konfigurationsschemat kräver att detta kommando körs för att komma åt QSPI-flashen som ansluter SDM_IO-stiften.
Åtkomst till QSPI-flashminnesenheter med SDM_IO-stift är endast tillgänglig för AS x4-konfigurationsschemat, JTAG konfiguration och en design kompilerad för AS x4-konfiguration. För konfigurationsschemat för Avalon streaming interface (Avalon ST) måste du ansluta QSPI-flashminnen till GPIO-stift.
fortsatt…
  1. Detta nummer inkluderar inte kommandot eller svarshuvudet
Viktig: När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_READ 3A 2 N Läser den bifogade quad SPI-enheten. Den maximala överföringsstorleken är 4 kilobyte (KB) eller 1024 ord.
Tar två argument:
  • Quad SPI flash-adress (ett ord). Adressen måste vara ordjusterad. Enheten returnerar felkoden 0x1 för icke-justerade adresser.
  • Antal ord att läsa (ett ord).

När det lyckas, returnerar OK följt av läsdata från quad SPI-enheten. Ett felsvar returnerar en felkod.
För en delvis lyckad läsning kan QSPI_READ felaktigt returnera OK-statusen.
Notera: Du kan inte köra kommandot QSPI_READ medan enhetskonfiguration pågår.
Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_WRITE 39 2+N 0 Skriver data till quad SPI-enheten. Den maximala överföringsstorleken är 4 kilobyte (KB) eller 1024 ord.
Tar tre argument:
  • Flash-adressförskjutning (ett ord). Skrivadressen måste vara ordjusterad.
  • Antalet ord att skriva (ett ord).
  • Data som ska skrivas (ett eller flera ord). En lyckad skrivning returnerar OK-svarskoden.

För att förbereda minnet för skrivningar, använd kommandot QSPI_ERASE innan du utfärdar detta kommando.
Notera: Du kan inte köra kommandot QSPI_WRITE medan enhetskonfiguration pågår.
Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_ERASE 38 2 0 Raderar en 4/32/64 KB-sektor av quad SPI-enheten. Tar två argument:
  • Blixtadressen förskjuts för att starta raderingen (ett ord). Beroende på antalet ord som ska raderas måste startadressen vara:
    • 4 KB justerat om nummerord som ska raderas är 0x400
    • 32 KB justerat om nummerord som ska raderas är 0x2000
    • 64 KB justerad om nummerord som ska raderas är 0x4000 Returnerar ett fel för adresser som inte är justerade med 4/32/64 KB.
  • Antalet ord som ska raderas anges i multiplar av:
    • 0x400 för att radera 4 KB (100 ord) data. Detta alternativ är den minsta raderingsstorleken.
    • 0x2000 för att radera 32 KB (500 ord) data
    • 0x4000 för att radera 64 KB (1000 ord) data En lyckad radering returnerar OK-svarskoden.

Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_READ_ DEVICE_REG 35 2 N Läser register från quad SPI-enheten. Den maximala läsningen är 8 byte. Tar två argument:
  • Op-koden för läskommandot.
  • Antalet byte att läsa.
fortsatt…
  1. Detta nummer inkluderar inte kommandot eller svarshuvudet.
En lyckad läsning returnerar OK-svarskoden följt av data som läses från enheten. Returen av lästa data är i multipel av 4 byte. Om de byte som ska läsas inte är en exakt multipel av 4 byte, utfylls den med multipel av 4 byte tills nästa ordgräns och det utfyllda bitvärdet är noll.
Viktig: När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_WRITE_ DEVICE_REG 36 2+N 0 Skriver till register av quad SPI. Den maximala skrivningen är 8 byte. Tar tre argument:
  • Op-koden för skrivkommandot.
  • Antalet byte att skriva.
  • Data att skriva.

För att utföra en sektorradering eller subsektorradering måste du ange den seriella flashadressen i ordningen mest signifikant byte (MSB) till minst signifikant byte (LSB) enligt följande ex.ample illustrerar.
För att radera en sektor av en Micron 2 gigabit (Gb) flash på adress 0x04FF0000 med QSPI_WRITE_DEVICE_REG-kommandot, skriv flashadressen i MSB till LSB-ordning som visas här:
Rubrik: 0x00003036 Opcode: 0x000000DC
Antal byte att skriva: 0x00000004 Flash-adress: 0x0000FF04
En lyckad skrivning returnerar OK-svarskoden. Detta kommando lägger till data som inte är en multipel av 4 byte till nästa ordgräns. Kommandot fyller data med noll.
Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.
QSPI_SEND_ DEVICE_OP 37 1 0 Skickar en kommandoopkod till quad SPI. Tar ett argument:
  • Op-koden för att skicka quad SPI-enheten.

Ett lyckat kommando returnerar OK-svarskoden.
Viktig:När du återställer quad SPI måste du följa instruktionerna som anges i Återställer Quad SPI Flash på sidan 9.

För CONFIG_STATUS och RSU_STATUS beskrivningar av större och mindre felkoder, se Bilaga: CONFIG_STATUS och RSU_STATUS felkodsbeskrivningar i Mailbox Client Intel FPGA IP User Guide.
Relaterad information

Felkodsvar

Tabell 8. Felkoder

Värde (hexadecimalt) Felkodssvar Beskrivning
0 OK Indikerar att kommandot slutfördes framgångsrikt.
Ett kommando kan felaktigt returnera OK-statusen om ett kommando, t.ex
QSPI_READ är delvis framgångsrik.
1 INVALID_COMMAND Indikerar att det för närvarande laddade start-ROM:et inte kan avkoda eller känna igen kommandokoden.
3 UNKNOWN_COMMAND Indikerar att den för närvarande laddade firmware inte kan avkoda kommandokoden.
4 INVALID_COMMAND_ PARAMETRAR Indikerar att kommandot är felaktigt formaterat. Till exempelample, längdfältsinställningen i rubriken är inte giltig.
6 COMMAND_INVALID_ON_ SOURCE Indikerar att kommandot kommer från en källa som det inte är aktiverat för.
8 CLIENT_ID_NO_MATCH Indikerar att klient-ID inte kan slutföra begäran om att stänga den exklusiva åtkomsten till quad SPI. Klient-ID:t matchar inte den befintliga klienten med den nuvarande exklusiva åtkomsten till quad SPI.
9 INVALID_ADRESS Adressen är ogiltig. Det här felet indikerar ett av följande tillstånd:
  • En ojusterad adress
  • Ett problem med adressintervall
  • Ett problem med läsbehörighet
  • Ett ogiltigt markeringsvärde som visar ett värde på mer än 3
  • En ogiltig adress i RSU-fallet
  • Ett ogiltigt bitmaskvärde för GET_VOLTAGE kommando
  • Ett ogiltigt sidval för kommandot GET_TEMPERATURE
A AUTHENTICATION_FAIL Indikerar autentiseringsfel för konfigurationsbitströmsignaturen.
B TIMEOUT Det här felet indikerar timeout på grund av följande förhållanden:
  • Kommando
  • Väntar på att QSPI_READ-åtgärden ska slutföras
  • Väntar på den begärda temperaturavläsningen från en av temperatursensorerna. Kan indikera ett potentiellt hårdvarufel i temperatursensorn.
C HW_NOT_READY Indikerar ett av följande villkor:
  • Hårdvaran är inte klar. Kan indikera antingen ett initierings- eller konfigurationsproblem. Hårdvaran kan referera till quad SPI.
  • RSU-bilden används inte för att konfigurera FPGA.
D HW_ERROR Indikerar att kommandot slutfördes utan framgång på grund av ett oåterställbart maskinvarufel.
80 – 8F COMMAND_SPECIFIC_ ERROR Indikerar ett kommandospecifikt fel på grund av ett SDM-kommando du använde.
SDM

Kommando

 Felnamn Felkod Beskrivning
GET_CHIPID EFUSE_SYSTEM_ FAILURE 0x82 Indikerar att eFuse-cachepekaren är ogiltig.
QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/

QSPI_READ_D EVICE_REG/

 QSPI_HW_ERROR 0x80 Indikerar QSPI-flashminnesfel. Det här felet indikerar ett av följande tillstånd:
QSPI_WRITE_ DEVICE_REG/

QSPI_SEND_D EVICE_OP/

QSPI_READ
  • Ett inställningsproblem med QSPI flash-chip
  • Ett QSPI flash-initieringsproblem
  • Ett QSPI-blixtåterställningsproblem
  • Ett QSPI flash-inställningsuppdateringsproblem
QSPI_ALREADY_ ÖPPEN 0x81 Indikerar att klientens exklusiva åtkomst till QSPI flash via QSPI_OPEN-kommandot redan är öppen.
100 NOT_CONFIGURED Indikerar att enheten inte är konfigurerad.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ UPPTAGET Indikerar att enheten är upptagen på grund av följande användningsfall:
  • RSU: Firmware kan inte övergå till en annan version på grund av ett internt fel.
  • HPS: HPS är upptagen i HPS-omkonfigurationsprocessen eller HPS-kallåterställning.
2FF ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE Indikerar att det inte finns något giltigt svar tillgängligt.
3FF ALT_SDM_MBOX_RESP_ ERROR Allmänt fel.

Återställning av felkod
Tabellen nedan beskriver möjliga steg för att återställa från en felkod. Felåterställning beror på specifika användningsfall.
Tabell 9. Återställning av felkoder för kända felkoder

Värde Felkodssvar Återställning av felkod
4 INVALID_COMMAND_ PARAMETRAR Skicka om kommandohuvudet eller rubriken med argument med korrigerade parametrar.
Till exempelample, se till att längdfältsinställningen i rubriken skickas med rätt värde.
6 COMMAND_INVALID_ ON_SOURCE Skicka kommandot igen från giltig källa som JTAG, HPS eller kärntyg.
8 CLIENT_ID_NO_MATCH Vänta på att klienten som öppnade åtkomsten till quad SPI slutför sin åtkomst och stänger sedan den exklusiva åtkomsten till quad SPI.
9 INVALID_ADRESS Möjliga felåterställningssteg:
För GET_VOLTAGE-kommando: Skicka kommando med en giltig bitmask.
För kommandot GET_TEMPERATURE: Skicka kommando med giltig sensorplats och sensormask.
För QSPI-drift:
  • Skicka kommando med en giltig markering.
  • Skicka kommando med en giltig QSPI flash-adress.

För RSU: Skicka kommando med en giltig startadress för fabriksbilden eller applikationen.
B TIMEOUT Möjliga återställningssteg:

För kommandot GET_TEMPERATURE: Försök att skicka kommandot igen. Om problemet kvarstår, konfigurera om eller slå på strömmen till enheten.

För QSPI-drift: Kontrollera signalintegriteten för QSPI-gränssnitt och försök kommandot igen.

För HPS-omstart: Försök igen att skicka kommandot igen.
C HW_NOT_READY Möjliga återställningssteg:

För QSPI-drift: Konfigurera om enheten via källan. Se till att IP som används för att bygga din design tillåter åtkomst till QSPI-blixten.

För RSU: Konfigurera enheten med RSU-bild.
80 QSPI_HW_ERROR Kontrollera QSPI-gränssnittets signalintegritet och se till att QSPI-enheten inte är skadad.
81 QSPI_ALREADY_OPEN Klienten har redan öppnat QSPI. Fortsätt med nästa operation.
82 EFUSE_SYSTEM_FAILURE Försök att konfigurera om eller slå på strömmen. Om felet kvarstår efter omkonfigurering eller strömförsörjning kan enheten vara skadad och omöjlig att återställa.
100 NOT_CONFIGURED Skicka en bitström som konfigurerar HPS.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ UPPTAGET Möjliga felåterställningssteg:

För QSPI-drift: Vänta tills pågående konfiguration eller annan klient slutförs.

För RSU: Konfigurera om enheten för att återställa från internt fel.

För HPS-omstart: Vänta tills omkonfigurationen via HPS eller HPS Cold Reset är klar.

Brevlådeklient med Avalon Streaming Interface Intel FPGA IP Användarhandbok Dokumentarkiv

För de senaste och tidigare versionerna av denna användarhandbok, se Mailbox Client med Avalon Streaming Interface Intel FPGA IP Användarhandbok. Om en IP- eller mjukvaruversion inte finns med i listan gäller användarhandboken för den tidigare IP- eller mjukvaruversionen.

IP-versioner är desamma som Intel Quartus Prime Design Suite-programvaruversioner upp till v19.1. Från Intel Quartus Prime Design Suite version 19.2 eller senare har IP-kärnor ett nytt IP-versionsschema.

Dokumentversionshistorik för brevlådeklienten med Avalon Streaming Interface Intel FPGA IP Användarhandbok

Dokumentversion Intel Quartus Prime-version IP-version Ändringar
2022.09.26 22.3 1.0.1 Gjorde följande ändringar:
  • Uppdaterade GET_VOLTAGE kommandoraden i

Kommandolista och beskrivningstabell.

  • Lade till anteckning till Table Device Family Support.
  • Reviderad QSPI_SET_CS kommandobeskrivning i tabellen Kommandolista och Beskrivning.
2022.04.04 22.1 1.0.1 Uppdaterade kommandolistan och beskrivningstabellen.
  • Uppdaterad pinstatusbeskrivning för kommandot CONFIG_STATUS.
  • Tog bort kommandot REBOOT_HPS.
2021.10.04 21.3 1.0.1 Gjorde följande ändring:
  • Reviderad Kommandolista och beskrivning tabell. Uppdaterad beskrivning för:
    • CONFIG_STATUS
    • RSU_STATUS
2021.06.21 21.2 1.0.1 Gjorde följande ändringar:
  • Reviderad Kommandolista och beskrivning tabell. Uppdaterad beskrivning för:
    • RSU_STATUS
    • QSPI_OPEN
    • QSPI_SET_CS
    • QSPI_ERASE
2021.03.29 21.1 1.0.1 Gjorde följande ändringar:
  • Reviderad RSU_IMAGE_UPDATE-beskrivning i Kommandolista och beskrivning tabell.
  • Omstrukturerad Operationskommandon. Beskrivningar av större och mindre felkoder för kommandona CONFIG_STATUS och RSU_STATUS har tagits bort. De större och mindre felkoderna är nu dokumenterade som en bilaga i Mailbox Client Intel FPGA IP Användarhandbok.
2020.12.14 20.4 1.0.1 Gjorde följande ändringar:
  • Lade till viktig anteckning om att återställa QSPI-blixten i Operationskommandon ämne.
  • Uppdaterade Kommandolista och beskrivning tabell:
    • Reviderad GET_TEMPERATURE kommandobeskrivning.
    • Reviderad RSU_IMAGE_UPDATE-kommandobeskrivning.
  • Lade till text om återställning av QSPI-blixt.
  • Tillagd text som beskriver beteendet mellan den externa värden och FPGA.
  • Borttagen text: Returnerar ett svar som inte är noll om enheten redan bearbetar ett konfigurationskommando.
    • Uppdaterade QSPI_WRITE och QSPI_READ beskrivningar för att specificera att den maximala överföringsstorleken är 4 kilobyte eller 1024 ord.
    • Korrigerad svarslängd från 1 till 0 för QSPI_OPEN, QSPI_CLOSE och QSPI_SET_CS kommando.
    • Reviderade beskrivningar av QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG och QSPI_WRITE_DEVICE_REG.
    • Lade till ett nytt kommando: REBOOT_HPS.
  • Nytt ämne har lagts till: Återställning av felkod.
2020.10.05 20.3 1.0.1
  • Ändrade titeln på denna användarhandbok från Mailbox Avalon Streaming Interface Client Intel FPGA IP Användarhandbok till Mailbox Client med Avalon Streaming Interface Intel FPGA IP Användarhandbok på grund av IP-namnändringen i Intel Quartus Prime IP Catalog.
  • Globalt uppdaterade alla IP-namninstanser.
  • Reviderad GET TEMPERATURE-kommandobeskrivning för Intel Agilex-enheter i Kommandolista och beskrivning tabell.
  • Lade till rekommendation om återställningssynkroniseraren i Klocka och återställ gränssnitt tabell.
  • Uppdaterade Felkoder tabell. Lade till nya felkodsvar:
    • HW_ERROR
    • COMMAND_SPECIFIC_ERROR
  • Tog bort Temperaturgivarplatser ämne. Temperatursensorinformationen finns tillgänglig i Intel Agilex Power Management användarhandbok.
2020.06.30 20.2 1.0.0
  • Ändrade titeln på denna användarhandbok från Mailbox Avalon ST Client Intel FPGA IP Användarhandbok till Mailbox Avalon Streaming Interface Client Intel FPGA IP Användarhandbok.
  • Ämnestitel omdöpt Kommando- och svarshuvud till Kommandon och svar.
  • Reviderade beskrivningar av ID, LENGTH och kommandokod/felkod i Kommando- och svarshuvud Beskrivning tabell.
  • Ämnestitel omdöpt Kommandon som stöds till Operationskommandon.
  • Reviderade följande kommandobeskrivning i Kommandolista och beskrivning tabell:
    • GET_TEMPERATURE
    • RSU_STATUS
    • QSPI_SET_CS
  • Ämnestitel omdöpt Felkoder till Felkodsvar.
  • Tog bort kommandot UNKNOWN_BR från Felkod tabell.
2020.04.13 20.1 1.0.0 Gjorde följande ändringar:
  • Lade till information om temperatursensorerna för kommandot GET_TEMPERATURE, inklusive figurer som illustrerar TSD-platser.
  • Lade till kommandot RSU_NOTIFY i Kommandokodlista och beskrivning tabell.
  • Uppdaterade Felkoder tabell:
    • Bytte namn på INVALID_COMMAND_PARAMETERS till INVALID_LENGTH.
    • Ändrade hexadecimalt värde för COMMAND_INVALID_ON_SOURCE från 5 till 6.
    • Ändrade CLIENT_ID_NO_MATCH hexadecimalt värde från 6 till 8.
    • Ändrade INVALID_ADDRESS hexadecimalt värde från 7 till 9.
    • Lade till kommandot AUTHENTICATION_FAIL.
    • Ändrade TIMEOUT hex-värde från 8 till B.
    • Ändrade HW_NOT_READY hex-värde från 9 till C.
2019.09.30 19.3 1.0.0 Initial release.

 För feedback, besök:  FPGAtechdocfeedback@intel.com

 

Dokument/resurser

intel Mailbox Client med Avalon Streaming Interface FPGA IP [pdf] Användarhandbok
Mailbox Client med Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Referenser

Relaterade inlägg

Lämna en kommentar

Din e-postadress kommer inte att publiceras. Obligatoriska fält är markerade *