Клиент за пощенска кутия на intel с Avalon Streaming Interface FPGA IP Ръководство за потребителя
Intel Mailbox Client с Avalon Streaming Interface FPGA IP

Съдържание скрий се
1 Клиент за пощенска кутия с Avalon® стрийминг интерфейс Intel FPGA IP Overview
1.1 Поддръжка на семейство устройства
2 Документи / Ресурси
2.1 Референции
3 Свързани публикации

Клиент за пощенска кутия с Avalon® стрийминг интерфейс Intel FPGA IP Overview

Клиентът на пощенска кутия с Avalon® стрийминг интерфейс Intel® FPGA IP (клиент на пощенска кутия с Avalon ST Client IP) осигурява комуникационен канал между вашата персонализирана логика и мениджъра на сигурни устройства (SDM). Можете да използвате клиента на пощенската кутия с Avalon ST IP, за да изпращате командни пакети и да получавате отговорни пакети от SDM периферни модули. Клиентът на пощенската кутия с Avalon ST IP дефинира функции, които SDM изпълнява.

Вашата персонализирана логика може да използва този комуникационен канал за получаване на информация и достъп до флаш памет от следните периферни модули:

  • ID на чипа
  • Температурен сензор
  • Voltage Сензор
  • Четворна флаш памет със сериен периферен интерфейс (SPI).

Забележка: В това ръководство за потребителя терминът Avalon ST съкращава интерфейса за поточно предаване на Avalon или IP.

Фигура 1. Клиент на пощенска кутия с Avalon ST IP System Design
Клиент на пощенска кутия с Avalon ST IP System Design

Следващата фигура показва приложение, в което клиентът на пощенска кутия с Avalon ST IP чете ID на чипа.

Фигура 2. Клиент на пощенска кутия с Avalon ST IP чете ID на чип
Клиент на пощенска кутия с Avalon ST IP чете ID на чип

Поддръжка на семейство устройства

По-долу са изброени дефинициите на ниво на поддръжка на устройства за IP адреси на Intel FPGA:

  • Предварителна поддръжка — IP адресът е достъпен за симулация и компилация за това семейство устройства. Времевите модели включват първоначални инженерни оценки на закъсненията въз основа на ранна информация след оформлението. Времевите модели подлежат на промяна, тъй като тестването на силиций подобрява корелацията между действителния силиций и синхронизиращите модели. Можете да използвате този IP адрес за системна архитектура и проучвания за използване на ресурсите, симулация, pin out, оценки на латентността на системата, основни оценки на времето (бюджетиране на тръбопроводи) и I/O стратегия за трансфер (ширина на пътя на данните, дълбочина на пакета, търговия на I/O стандарти изключения).
  • Предварителна поддръжка — IP адресът е проверен с предварителни модели за синхронизация за това семейство устройства. IP отговаря на всички функционални изисквания, но все още може да бъде подложен на анализ на времето за фамилията устройства. Може да се използва в производствени проекти с повишено внимание.
  • Окончателна опора — IP адресът е проверен с окончателни времеви модели за това семейство устройства. IP отговаря на всички функционални и времеви изисквания за фамилията устройства и може да се използва в производствени проекти.

Таблица 1. Поддръжка на семейство устройства

Семейство устройства поддръжка
Intel Agilex™ Предварително

Забележка: Не можете да симулирате клиента на пощенска кутия с Avalon Streaming Interface Intel FPGA IP, защото IP получава отговорите от SDM. За да потвърдите този IP, Intel препоръчва да извършите оценка на хардуера.

Свързана информация
Клиент за пощенска кутия с Avalon Streaming Interface Бележки по изданието на Intel FPGA IP

Параметри

Име на параметъра Стойност Описание
Активиране на интерфейса за състояние Включено Изключено Когато активирате този интерфейс, клиентът на пощенската кутия с интерфейс за поточно предаване Avalon Intel FPGA IP включва сигнала command_status_invalid. Когато command_status_invalid потвърди, трябва да нулирате IP.

Интерфейси
Следващата фигура илюстрира клиента на пощенска кутия с Avalon Streaming Interface Intel FPGA IP интерфейси:

Фигура 3. Клиент на пощенска кутия с Avalon Streaming Interface Intel FPGA IP интерфейси
Клиент на пощенска кутия с Avalon Streaming Interface Intel FPGA IP интерфейси

За повече информация относно интерфейсите за поточно предаване на Avalon вижте спецификациите на интерфейса на Avalon.
Свързана информация
Спецификации на интерфейса на Avalon

Интерфейси за часовник и нулиране

Таблица 2. Интерфейси за часовник и нулиране

Име на сигнала Посока Описание
in_clk Вход Това е часовникът за стрийминг интерфейсите на Avalon. Максималната честота е 250 MHz.
in_reset Вход Това е активно високо нулиране. Утвърдете in_reset, за да нулирате клиента на пощенската кутия с интерфейс за поточно предаване на Avalon Intel FPGA IP (клиент на пощенска кутия с Avalon ST IP). Когато сигналът in_reset се потвърди, SDM трябва да изтрие всички чакащи дейности от клиента на пощенската кутия с Avalon ST IP. SDM продължава да обработва команди от други клиенти.

За да се гарантира, че клиентът на пощенската кутия с Avalon ST IP функционира правилно, когато устройството влезе в потребителски режим, вашият дизайн трябва да включва Reset Release Intel FPGA IP, за да задържи нулирането, докато FPGA тъканта влезе в потребителски режим. Intel препоръчва използването на синхронизатор за нулиране, когато свързвате потребителското нулиране или изхода на IP Reset Release към
порта за нулиране на клиента на пощенската кутия с Avalon ST IP. За да приложите синхронизатора за нулиране, използвайте Reset Bridge Intel FPGA IP, наличен в Platform Designer.

Забележка: За указания за инстанциране на IP и свързване в дизайнера на платформа вижте Необходимите комуникационни и хост компоненти за дизайна за актуализация на отдалечена система Exampфигура в ръководството за потребителя за конфигурация на Intel Agilex.

Команден интерфейс
Използвайте интерфейса Avalon Streaming (Avalon ST), за да изпращате команди до SDM.

Таблица 3. Команден интерфейс

Име на сигнала Посока Описание
command_ready Изход Клиентът на пощенската кутия с Avalon ST Intel FPGA IP потвърждава command_ready, когато е готов да получава команди от приложението. Ready_latency е 0 цикъла. Клиентът на пощенска кутия с Avalon ST може да приеме command_data[31:0] в същия цикъл, който command_ready потвърждава.
команда_валидна Вход Сигналът command_valid твърди, че показва, че command_data е валиден.
командни_данни [31:0] Вход Шината command_data управлява команди към SDM. Обърнете се към Списък с команди и описание за дефиниции на командите.
command_startofpacket Вход Командата_startofpacket заявява в първия цикъл на команден пакет.
command_endofpacket Вход Командата_endofpacket потвърждава в последния цикъл на командата пакет.

Фигура 4. Време за Avalon ST команден пакет
fig:m ST команден пакет

Интерфейс за отговор
SDM Avalon ST Client IP изпраща отговори на вашето приложение чрез интерфейса за отговор.

Таблица 4. Интерфейс за отговор

Сигнал 5 Посока Описание
отговор_готов Вход Логиката на приложението може да заявява сигнала response_ready винаги, когато е в състояние да получи отговор.
валиден_отговор Изход SDM твърди response_valid, за да покаже, че response_data е валиден.
данни за отговор [31:0] Изход SDM управлява response_data, за да предостави исканата информация. Първата дума на отговора е заглавка, която идентифицира командата, която SDM предоставя. Препоръчай на Списък с команди и описание за дефиниции на командите.
отговор_начало на пакет Изход Response_startofpacket се потвърждава в първия цикъл на пакет с отговор.
отговор_край на пакет Изход Response_endofpacket се потвърждава в последния цикъл на пакет с отговор.

Фигура 5. Време за Avalon ST Response Packet
Avalon ST Response Packet

Интерфейс за състоянието на командите

Таблица 5. Интерфейс за състоянието на командите

Име на сигнала Посока Описание
команда_статус_невалиден Изход Командата_status_invalid твърди, че показва грешка. Този сигнал обикновено потвърждава, че дължината на командата, посочена в заглавката на командата, не съвпада с дължината на изпратената команда. Когато command_status_invalid се потвърди, логиката на вашето приложение трябва да потвърди in_reset, за да рестартирате клиента на пощенската кутия с Avalon стрийминг интерфейс Intel FPGA IP.

Фигура 6. Нулиране след command_status_invalid Asserts
фиг.: command_status_invalid Asserts

Команди и отговори

Хост контролерът комуникира със SDM, използвайки команди и пакети с отговори чрез клиента на пощенската кутия Intel FPGA IP.

Първата дума на пакетите с команда и отговор е заглавка, която предоставя основна информация за командата или отговора.

Фигура 7. Формат на заглавката на командата и отговора
фиг.: Формат на заглавката на командата и отговора

Забележка: Полето LENGTH в заглавката на командата трябва да съответства на дължината на съответната команда.
Следната таблица описва полетата на командата за заглавка.

Таблица 6. Описание на заглавката на командата и отговора

Заглавка малко Описание
Запазено [31:28] Запазено.
ID [27:24] ID на командата. Заглавката на отговора връща идентификатора, посочен в заглавката на командата. Обърнете се към Операционни команди за описание на командите.
0 [23] Запазено.
ДЪЛЖИНА [22:12] Брой думи на аргументи след заглавката. IP-то отговаря с грешка, ако за дадена команда е въведен грешен брой думи от аргументи.
Ако има несъответствие между дължината на командата, посочена в заглавката на командата, и броя на изпратените думи. IP повдига бит 3 от регистъра на състоянието на прекъсването (COMMAND_INVALID) и клиентът на пощенската кутия трябва да бъде нулиран.
Запазено [11] Запазено. Трябва да се настрои на 0.
Код на командата/код на грешка [10:0] Кодът на командата указва командата. Кодът за грешка показва дали командата е успешна или неуспешна.
В заглавката на командата тези битове представляват код на команда. В заглавката на отговора тези битове представляват код на грешка. Ако командата е успешна, кодът за грешка е 0. Ако командата е неуспешна, вижте кодовете за грешка, дефинирани в Отговори с код за грешка.

Команди за операция

Нулиране на Quad SPI Flash
Важно: За устройства Intel Agilex трябва да свържете щифта за нулиране на серийна флаш или четворна SPI флаш към щифта AS_nRST. SDM трябва напълно да контролира нулирането на QSPI. Не свързвайте четворния SPI щифт за нулиране към външен хост.

Таблица 7. Списък с команди и описание

командване Код (шестнадесетичен) Дължина на командата (1) Дължина на отговора (1) Описание
NOOP 0 0 0 Изпраща отговор за състояние OK.
GET_IDCODE 10 0 1 Отговорът съдържа един аргумент, който е JTAG IDCODE за устройството
GET_CHIPID 12 0 2 Отговорът съдържа 64-битова CHIPID стойност с най-малко значимата дума първа.
GET_USERCODE 13 0 1 Отговорът съдържа един аргумент, който е 32-битовият JTAG ПОТРЕБИТЕЛСКИ КОД, който конфигурационният битов поток записва в устройството.
GET_VOLTAGE 18 1 n(2) GET_VOLTAGКомандата E има един аргумент, който е битова маска, указваща каналите за четене. Бит 0 определя канал 0, бит 1 определя канал 1 и т.н.
Отговорът включва аргумент от една дума за всеки бит, зададен в битовата маска. Обемътtage върнато е неподписано число с фиксирана точка с 16 бита под двоичната точка. Напримерample, a voltage от 0.75 V връща 0x0000C000. (3)
Устройствата Intel Agilex имат един обемtage сензор. Следователно отговорът винаги е една дума.
GET_ TEMPERATURE 19 1 n(4) Командата GET_TEMPERATURE връща температурата или температурите на основната тъкан или местоположенията на приемо-предавателния канал, които сте посочили.

За устройства Intel Agilex използвайте аргумента sensor_req, за да посочите местоположенията. Sensor_req включва следните полета:

  • Битове [31:28]: Запазено.
  • Битове [27:16]: Местоположение на сензора. Указва местоположението на TSD.
  • Битове [15:0]: Сензорна маска. Указва сензорите за четене за посоченото местоположение на сензора. Отговорът съдържа по една дума за всяка заявена температура. Ако е пропусната, командата чете канал 0. Най-малкият бит (lsb) съответства на сензор 0. Най-значимият бит (msb) съответства на канал 15.

Върнатата температура е фиксирана стойност със знак с 8 бита под двоичната точка. Напримерample, температура от 10°C връща 0x00000A00. A с температура -1.5°C връща 0xFFFFFE80.
Ако битовата маска посочва невалидно местоположение, командата връща код на грешка, който е всяка стойност в диапазона 0x80000000 -0x800000FF.
За устройства Intel Agilex вижте потребителското ръководство за управление на мощността Intel Agilex за повече информация относно локалните вградени температурни сензори.
RSU_IMAGE_ АКТУАЛИЗАЦИЯ 5C 2 0 Задейства повторно конфигуриране от източника на данни, който може да бъде фабрично или изображение на приложение.
продължи…
  1. Този номер не включва заглавката на командата или отговора.
  2. За устройства Intel Agilex, които поддържат четене на множество устройства, индекс n съответства на броя канали, които активирате на вашето устройство.
  3. Обърнете се към Ръководство за потребителя за Intel Agilex Power Management за повече информация относно каналите и местоположенията на температурните сензори.
  4. Индекс n зависи от броя на сензорните маски.
командване Код (шестнадесетичен) Дължина на командата (1) Дължина на отговора (1) Описание
Тази команда приема незадължителен 64-битов аргумент, който указва адреса на данните за преконфигуриране във флаш паметта. Когато изпращате аргумента към IP, първо изпращате битове [31:0], последвани от битове [63:32]. Ако не предоставите този аргумент, неговата стойност се приема за 0.
  • Бит [31:0]: Началният адрес на изображение на приложение.
  • Бит [63:32]: Запазено (запишете като 0).

След като устройството обработи тази команда, то връща заглавката на отговора към FIFO на отговора, преди да продължи да преконфигурира устройството. Уверете се, че хост компютърът или хост контролерът спира да обслужва други прекъсвания и се фокусира върху четенето на данните от заглавката на отговора, за да покаже, че командата е изпълнена успешно. В противен случай хост компютърът или хост контролерът може да не успеят да получат отговор, след като процесът на преконфигуриране започне.
След като устройството продължи с преконфигуриране, връзката между външния хост и FPGA се губи. Ако използвате PCIe във вашия дизайн, трябва да преизброите PCIe връзката.
Важно: Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
RSU_GET_SPT 5A 0 4 RSU_GET_SPT извлича четворното SPI флаш местоположение за двете таблици на подразделения, които RSU използва: SPT0 и SPT1.
Отговорът от 4 думи съдържа следната информация:
Слово Име Описание
0 SPT0[63:32] SPT0 адрес в quad SPI флаш.
1 SPT0[31:0]
2 SPT1[63:32] SPT1 адрес в quad SPI флаш.
3 SPT1[31:0]
CONFIG_ СТАТУС 4 0 6 Отчита състоянието на последното преконфигуриране. Можете да използвате тази команда, за да проверите състоянието на конфигурацията по време и след конфигурацията. Отговорът съдържа следната информация:
Слово Резюме Описание
0 състояние Описва най-новата грешка, свързана с конфигурацията. Връща 0, когато няма грешки в конфигурацията.
Полето за грешка има 2 полета:
  • Горни 16 бита: Основен код на грешка.
  • Долни 16 бита: Малък код на грешка.

Вижте Приложението: CONFIG_STATUS и RSU_STATUS Описания на кодове за грешки в клиента на пощенската кутия Intel FPGA IP  Ръководство за потребителя за повече информация.
1 Версия Квартус Предлага се във версии на софтуера Intel Quartus® Prime между 19.4 и 21.2, полето показва:
  • Бит [31:28]: Индекс на фърмуера или копието на фърмуера на решението, което е използвано последно. Възможните стойности са 0, 1, 2 и 3.
  • Бит [27:24]: Запазено
  • Бит [23:16]: Стойността е '0'
Налична във версия на софтуера Intel Quartus Prime 21.3 или по-нова, версията на Quartus показва:
  • Бит [31:28]: Индекс на фърмуера или копието на фърмуера на решението, което е използвано последно. Възможните стойности са 0, 1, 2 и 3.
  • Бит [27:24]: Запазено
  • Бит [23:16]: Основен номер на изданието на Quartus
  • Бит [15:8]: Второстепенен номер на изданието на Quartus
  • Бит [7:0]: Номер на актуализация на Quartus

Напримерample, във версия на софтуера Intel Quartus Prime 21.3.1 следните стойности представляват основните и второстепенните номера на изданието на Quartus и номера на актуализацията на Quartus:

  • Бит [23:16] = 8'd21 = 8'h15
  • Бит [15:8] = 8'd3 = 8'h3
  • Бит [7:0] = 8'd1 = 8'h1
2 Състояние на ПИН
  • Бит [31]: текуща изходна стойност nSTATUS (активен нисък)
  • Бит [30]: Открита входна стойност на nCONFIG (активно ниско)
  • Бит [29:8]: Запазено
  • Бит [7:6]: Източник на часовник за конфигурация
    • 01 = Вътрешен осцилатор
    • 10 = OSC_CLK_1
  • Бит [5:3]: Запазено
  • Бит [2:0]: MSEL стойността при включване
3 Състояние на мека функция Съдържа стойността на всяка от софтуерните функции, дори ако не сте присвоили функцията на SDM щифт.
  • Бит [31:6]: Запазено
  • Бит [5]: HPS_WARMRESET
  • Бит [4]: ​​HPS_COLDRESET
  • Бит [3]: SEU_ERROR
  • Бит [2]: CVP_DONE
  • Бит [1]: INIT_DONE
  • Бит [0]: CONF_DONE
4 Местоположение на грешката Съдържа местоположението на грешката. Връща 0, ако няма грешки.
5 Подробности за грешка Съдържа подробности за грешката. Връща 0, ако няма грешки.
RSU_STATUS 5B 0 9 Отчита текущото състояние на надграждане на отдалечена система. Можете да използвате тази команда, за да проверите състоянието на конфигурацията по време на конфигурацията и след нейното завършване. Тази команда връща следните отговори:
Слово Резюме Описание

(Продължи….)
  1. Този номер не включва заглавката на командата или отговора
0-1 Текущо изображение Flash отместване на текущо работещото изображение на приложението.
2-3 Неуспешно изображение Флаш изместване на изображението на неуспешно приложение с най-висок приоритет. Ако има няколко изображения във флаш паметта, съхранява стойността на първото неуспешно изображение. Стойност на всички 0 означава, че няма неуспешни изображения. Ако няма неуспешни изображения, останалите думи от информацията за състоянието не съхраняват валидна информация.
Забележка:Нарастващ фронт на nCONFIG за преконфигуриране от ASx4 не изчиства това поле. Информацията за неуспешно изображение се актуализира само когато клиентът на пощенската кутия получи нова команда RSU_IMAGE_UPDATE и успешно конфигурира от актуализираното изображение.
4 състояние Код на неизправност на неизправното изображение. Полето за грешка има две части:
  • Бит [31:16]: Основен код на грешка
  • Бит [15:0]: Малък код за грешка Връща 0 при липса на грешки. Препоръчай на

Приложение: Описания на кодове за грешка CONFIG_STATUS и RSU_STATUS в потребителското ръководство на клиента на пощенската кутия Intel FPGA IP за повече информация.
5 Версия Версия на RSU интерфейс и източник на грешка.
За повече информация вижте раздела за състояние на RSU и кодове за грешки в Потребителското ръководство за отдалечено актуализиране на системата с твърд процесор.
6 Местоположение на грешката Съхранява местоположението на грешката на неуспешното изображение. Връща 0 при липса на грешки.
7 Подробности за грешка Съхранява подробностите за грешката за неуспешното изображение. Връща 0, ако няма грешки.
8 Текущ брояч на повторни опити за изображение Броят на повторните опити, които са били извършени за текущото изображение. Първоначално броячът е 0. Броячът се настройва на 1 след първия повторен опит, след това на 2 след втори повторен опит.
Посочете максималния брой повторни опити във вашите настройки на Intel Quartus Prime File (.qsf). Командата е: set_global_assignment -name RSU_MAX_RETRY_COUNT 3. Валидни стойности за брояча MAX_RETRY са 1-3. Действителният брой налични повторни опити е MAX_RETRY -1
Това поле беше добавено във версия 19.3 на софтуера Intel Quartus Prime Pro Edition.
продължи…
  1. Този номер не включва заглавката на командата или отговора.
RSU_NOTIFY 5D 1 0 Изчиства цялата информация за грешка в отговора RSU_STATUS и нулира брояча за повторни опити. Аргументът от една дума има следните полета:
  • 0x00050000: Изчистване на текущия брояч за повторни опити за нулиране. Нулирането на текущия брояч на повторни опити връща брояча на нула, сякаш текущото изображение е било успешно заредено за първи път.
  • 0x00060000: Изчистване на информацията за състоянието на грешката.
  • Всички останали стойности са запазени.

Тази команда не е налична преди версия 19.3 на софтуера Intel Quartus Prime Pro Edition.
QSPI_OPEN 32 0 0 Иска ексклузивен достъп до quad SPI. Издавате тази заявка преди всички други QSPI заявки. SDM приема заявката, ако четворният SPI не се използва и SDM не конфигурира устройството.
Връща OK, ако SDM предостави достъп.
SDM предоставя изключителен достъп на клиента, използващ тази пощенска кутия. Други клиенти нямат достъп до четворния SPI, докато активният клиент не се откаже от достъп чрез командата QSPI_CLOSE.
Достъпът до устройствата с четворна SPI флаш памет чрез който и да е IP клиент на пощенска кутия не е наличен по подразбиране в дизайни, които включват HPS, освен ако не деактивирате QSPI в софтуерната конфигурация на HPS.
Важно: Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_CLOSE 33 0 0 Затваря изключителния достъп до четворния SPI интерфейс.
Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_SET_CS 34 1 0 Указва едно от прикрепените четворни SPI устройства чрез линиите за избор на чип. Приема аргумент от една дума, както е описано по-долу
  • Битове [31:28]: Флаш устройство за избор. Обърнете се към информацията по-долу за стойността, която съответства на щифтовете nCSO[0:3].
    • Стойност 4'h0000 избира светкавицата, която съответства на nCSO[0].
    • Стойност 4'h0001 избира светкавицата, която съответства на nCSO[1].
    • Стойност 4'h0002 избира светкавицата, която съответства на nCSO[2].
    • Стойност 4'h0003 избира светкавицата, която съответства на nCSO[3].
  • Битове [27:0]: Запазени (запишете като 0).

Забележка: Устройствата Intel Agilex или Intel Stratix® 10 поддържат едно AS x4 устройство с флаш памет за AS конфигурация от четворно SPI устройство, свързано към nCSO[0]. След като устройството влезе в потребителски режим, можете да използвате до четири AS x4 флаш памети за използване с Mailbox Client IP или HPS като съхранение на данни. TheMailbox Client IP или HPS може да използва nCSO[3:0] за достъп до четворни SPI устройства.
Тази команда не е задължителна за конфигурационната схема AS x4, редът за избор на чип следва последната изпълнена команда QSPI_SET_CS или по подразбиране е nCSO[0] след конфигурацията AS x4. ДжTAG конфигурационната схема изисква изпълнение на тази команда за достъп до QSPI флаш, който свързва SDM_IO щифтовете.
Достъпът до устройствата с флаш памет QSPI, използващи SDM_IO пинове, е достъпен само за конфигурационната схема AS x4, JTAG конфигурация и дизайн, компилиран за конфигурация AS x4. За конфигурационната схема на интерфейса за поточно предаване на Avalon (Avalon ST) трябва да свържете QSPI флаш памети към GPIO щифтове.
продължи…
  1. Този номер не включва заглавката на командата или отговора
Важно: Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_READ 3A 2 N Чете прикрепеното четворно SPI устройство. Максималният размер на трансфера е 4 килобайта (KB) или 1024 думи.
Приема два аргумента:
  • Четворният SPI флаш адрес (една дума). Адресът трябва да е подравнен по думи. Устройството връща код за грешка 0x1 за неподравнени адреси.
  • Брой думи за четене (една дума).

При успех връща OK, последвано от прочетените данни от четворното SPI устройство. Отговорът за грешка връща код за грешка.
За частично успешно четене, QSPI_READ може погрешно да върне статус OK.
Забележка: Не можете да изпълните командата QSPI_READ, докато конфигурирането на устройството е в ход.
Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_WRITE 39 2+N 0 Записва данни в четворното SPI устройство. Максималният размер на трансфера е 4 килобайта (KB) или 1024 думи.
Приема три аргумента:
  • Отместването на флаш адреса (една дума). Адресът за запис трябва да бъде подравнен по думи.
  • Броят на думите за писане (една дума).
  • Данните, които трябва да бъдат записани (една или повече думи). Успешният запис връща кода за отговор OK.

За да подготвите паметта за запис, използвайте командата QSPI_ERASE, преди да издадете тази команда.
Забележка: Не можете да изпълните командата QSPI_WRITE, докато конфигурирането на устройството е в ход.
Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_ERASE 38 2 0 Изтрива сектор от 4/32/64 KB на четворното SPI устройство. Приема два аргумента:
  • Отместването на флаш адреса, за да започне изтриването (една дума). В зависимост от броя думи за изтриване, началният адрес трябва да бъде:
    • 4 KB подравнени, ако числовите думи за изтриване са 0x400
    • 32 KB подравнени, ако числовите думи за изтриване са 0x2000
    • 64 KB подравнени, ако числовите думи за изтриване са 0x4000 Връща грешка за не-4/32/64 KB подравнени адреси.
  • Броят на думите за изтриване е посочен в кратни на:
    • 0x400 за изтриване на 4 KB (100 думи) данни. Тази опция е минималният размер за изтриване.
    • 0x2000 за изтриване на 32 KB (500 думи) данни
    • 0x4000 за изтриване на 64 KB (1000 думи) данни Успешното изтриване връща кода за отговор OK.

Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_READ_ DEVICE_REG 35 2 N Чете регистри от четворното SPI устройство. Максималното четене е 8 байта. Приема два аргумента:
  • Операционният код за командата за четене.
  • Броят байтове за четене.
продължи…
  1. Този номер не включва заглавката на командата или отговора.
Успешното четене връща кода за отговор OK, последван от данните, прочетени от устройството. Прочетените данни са кратни на 4 байта. Ако байтовете за четене не са точно кратни на 4 байта, те се допълват с кратно на 4 байта до следващата граница на думата и стойността на подплатения бит е нула.
Важно: Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_WRITE_ DEVICE_REG 36 2+N 0 Пише в регистрите на четворния SPI. Максималният запис е 8 байта. Приема три аргумента:
  • Операционният код за командата за запис.
  • Броят байтове за запис.
  • Данните за запис.

За да извършите изтриване на сектор или изтриване на подсектор, трябва да посочите серийния флаш адрес в реда на най-значимите байтове (MSB) до най-малко значимите байтове (LSB), както следваample илюстрира.
За да изтриете сектор от Micron 2 гигабитова (Gb) флаш памет на адрес 0x04FF0000 с помощта на командата QSPI_WRITE_DEVICE_REG, запишете флаш адреса в MSB към LSB ред, както е показано тук:
Заглавие: 0x00003036 Опционален код: 0x000000DC
Брой байтове за запис: 0x00000004 Флаш адрес: 0x0000FF04
Успешният запис връща кода за отговор OK. Тази команда добавя данни, които не са кратни на 4 байта, до границата на следващата дума. Командата допълва данните с нула.
Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.
QSPI_SEND_ DEVICE_OP 37 1 0 Изпраща команден код на операция към четворния SPI. Приема един аргумент:
  • Операционният код за изпращане на четворното SPI устройство.

Успешната команда връща кода за отговор OK.
Важно:Когато нулирате quad SPI, трябва да следвате инструкциите, посочени в Нулиране на Quad SPI Flash на страница 9.

За CONFIG_STATUS и RSU_STATUS описания на кодове за големи и второстепенни грешки вижте Приложение: Описания на кодове за грешки CONFIG_STATUS и RSU_STATUS в Ръководството за потребителя на Intel FPGA IP за пощенска кутия.
Свързана информация

Отговори с код за грешка

Таблица 8. Кодове за грешки

Стойност (шестнадесетичен) Отговор с код за грешка Описание
0 OK Показва, че командата е изпълнена успешно.
Команда може погрешно да върне статуса OK, ако команда, като напр
QSPI_READ е частично успешен.
1 INVALID_COMMAND Показва, че текущо зареденият ROM за зареждане не може да декодира или разпознае командния код.
3 НЕПОЗНАТА КОМАНДА Показва, че текущо зареденият фърмуер не може да декодира командния код.
4 INVALID_COMMAND_ ПАРАМЕТРИ Показва, че командата е неправилно форматирана. Напримерample, настройката на полето за дължина в заглавката не е валидна.
6 COMMAND_INVALID_ON_ SOURCE Показва, че командата е от източник, за който не е разрешена.
8 CLIENT_ID_NO_MATCH Показва, че ИД на клиента не може да завърши заявката за затваряне на изключителния достъп до quad SPI. Идентификационният номер на клиента не съответства на съществуващия клиент с текущия изключителен достъп до quad SPI.
9 INVALID_ADDRESS Адресът е невалиден. Тази грешка показва едно от следните условия:
  • Неподравнен адрес
  • Проблем с обхвата на адресите
  • Проблем с разрешението за четене
  • Невалидна стойност за избор на чип, показваща стойност над 3
  • Невалиден адрес в случая RSU
  • Невалидна стойност на битова маска за GET_VOLTAGE команда
  • Невалиден избор на страница за команда GET_TEMPERATURE
A AUTHENTICATION_FAIL Показва грешка при удостоверяване на подписа на битовия поток на конфигурацията.
B ИЗТЕЧИ ВРЕМЕ Тази грешка показва изчакване поради следните условия:
  • командване
  • Изчаква се завършване на операцията QSPI_READ
  • Изчаква се желаното отчитане на температурата от един от температурните сензори. Може да означава потенциална хардуерна грешка в температурния сензор.
C HW_NOT_READY Показва едно от следните условия:
  • Хардуерът не е готов. Може да показва проблем с инициализацията или конфигурацията. Хардуерът може да се отнася до quad SPI.
  • RSU изображението не се използва за конфигуриране на FPGA.
D HW_ERROR Показва, че командата е изпълнена неуспешно поради непоправима хардуерна грешка.
80 – 8F COMMAND_SPECIFIC_ ГРЕШКА Показва конкретна грешка в командата поради SDM команда, която сте използвали.
SDM

командване

 Име на грешката Код на грешка Описание
GET_CHIPID EFUSE_SYSTEM_ FAILURE 0x82 Показва, че указателят на кеша на eFuse е невалиден.
QSPI_OPEN/ QSPI_CLOSE/ QSPI_SET_CS/

QSPI_READ_D EVICE_REG/

 QSPI_HW_ERROR 0x80 Показва грешка в QSPI флаш паметта. Тази грешка показва едно от следните условия:
QSPI_WRITE_ DEVICE_REG/

QSPI_SEND_D EVICE_OP/

QSPI_READ
  • Проблем с настройката за избор на флаш чип QSPI
  • Проблем с инициализацията на флаш QSPI
  • Проблем с QSPI флаш нулиране
  • Проблем с актуализиране на настройките на флаш QSPI
QSPI_ВЕЧЕ_ ОТВОРЕНО 0x81 Показва, че изключителният достъп на клиента до QSPI флаш чрез командата QSPI_OPEN вече е отворен.
100 NOT_CONFIGURED Показва, че устройството не е конфигурирано.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Показва, че устройството е заето поради следните случаи на употреба:
  • RSU: Фърмуерът не може да премине към друга версия поради вътрешна грешка.
  • HPS: HPS е зает, когато е в процес на преконфигуриране на HPS или студено нулиране на HPS.
2FF ALT_SDM_MBOX_RESP_NO _ VALID_RESP_AVAILABLE Показва, че няма наличен валиден отговор.
3FF ALT_SDM_MBOX_RESP_ ГРЕШКА Обща грешка.

Възстановяване на код за грешка
Таблицата по-долу описва възможните стъпки за възстановяване от код на грешка. Възстановяването на грешки зависи от конкретния случай на употреба.
Таблица 9. Възстановяване на код за грешка за известни кодове за грешка

Стойност Отговор с код за грешка Възстановяване на код за грешка
4 INVALID_COMMAND_ ПАРАМЕТРИ Изпратете отново заглавката на командата или заглавката с аргументи с коригирани параметри.
Напримерample, уверете се, че настройката на полето за дължина в заглавката е изпратена с правилната стойност.
6 COMMAND_INVALID_ ON_SOURCE Изпратете отново командата от валиден източник като JTAG, HPS или основна тъкан.
8 CLIENT_ID_NO_MATCH Изчакайте клиентът, който е отворил достъпа до quad SPI, да завърши своя достъп и след това затваря изключителния достъп до quad SPI.
9 INVALID_ADDRESS Възможни стъпки за отстраняване на грешка:
За GET_VOLTAGE команда: Изпратете команда с валидна битова маска.
За команда GET_TEMPERATURE: Изпратете команда с валидно местоположение на сензора и маска на сензора.
За работа с QSPI:
  • Изпратете команда с валиден избор на чип.
  • Изпратете команда с валиден QSPI флаш адрес.

За RSU: Изпратете команда с валиден начален адрес на фабричното изображение или приложение.
B ИЗТЕЧИ ВРЕМЕ Възможни стъпки за възстановяване:

За команда GET_TEMPERATURE: Опитайте отново да изпратите командата отново. Ако проблемът продължава, конфигурирайте отново или включете захранването на устройството.

За работа с QSPI: Проверете целостта на сигнала на интерфейсите QSPI и опитайте командата отново.

За операция за рестартиране на HPS: Опитайте отново да изпратите командата отново.
C HW_NOT_READY Възможни стъпки за възстановяване:

За работа с QSPI: Преконфигурирайте устройството чрез източник. Уверете се, че IP, използван за изграждане на вашия дизайн, позволява достъп до QSPI флаш.

За RSU: Конфигурирайте устройството с RSU изображение.
80 QSPI_HW_ERROR Проверете целостта на сигнала на QSPI интерфейса и се уверете, че QSPI устройството не е повредено.
81 QSPI_ALREADY_OPEN Клиентът вече е отворил QSPI. Продължете със следващата операция.
82 EFUSE_SYSTEM_FAILURE Опитайте преконфигуриране или цикъл на захранване. Ако грешката продължава след преконфигуриране или цикъл на захранване, устройството може да е повредено и невъзстановимо.
100 NOT_CONFIGURED Изпратете битов поток, който конфигурира HPS.
1FF ALT_SDM_MBOX_RESP_ DEVICE_ BUSY Възможни стъпки за отстраняване на грешка:

За работа с QSPI: Изчакайте текущата конфигурация или друг клиент да завърши операцията.

За RSU: Преконфигурирайте устройството за възстановяване от вътрешна грешка.

За операция по рестартиране на HPS: Изчакайте преконфигурирането чрез HPS или HPS Cold Reset да завърши.

Клиент за пощенска кутия с Avalon Streaming Interface Intel FPGA IP Ръководство за потребителя Архив на документи

За най-новата и предишната версия на това ръководство за потребителя вижте Клиент за пощенска кутия с Avalon Streaming Interface Intel FPGA IP Ръководство за потребителя. Ако IP или версия на софтуера не е посочена, се прилага ръководството за потребителя за предишната версия на IP или софтуер.

IP версиите са същите като версиите на софтуера Intel Quartus Prime Design Suite до v19.1. От версия на софтуера Intel Quartus Prime Design Suite 19.2 или по-нова, IP ядрата имат нова схема за IP версии.

Хронология на ревизиите на документа за клиента на пощенската кутия с Avalon Streaming Interface Intel FPGA IP Ръководство за потребителя

Версия на документа Intel Quartus Prime версия IP версия Промени
2022.09.26 22.3 1.0.1 Направи следните промени:
  • Актуализира GET_VOLTAGE команден ред в

Списък с команди и таблица с описания.

  • Добавена е бележка към поддръжката на семейството на таблични устройства.
  • Ревизиран QSPI_SET_CS описание на командата в таблицата Списък с команди и описание.
2022.04.04 22.1 1.0.1 Актуализира списъка с команди и таблицата с описания.
  • Актуализирано описание на състоянието на ПИН за командата CONFIG_STATUS.
  • Премахна командата REBOOT_HPS.
2021.10.04 21.3 1.0.1 Направи следната промяна:
  • Ревизиран Списък с команди и описание маса. Актуализирано описание за:
    • CONFIG_STATUS
    • RSU_STATUS
2021.06.21 21.2 1.0.1 Направи следните промени:
  • Ревизиран Списък с команди и описание маса. Актуализирано описание за:
    • RSU_STATUS
    • QSPI_OPEN
    • QSPI_SET_CS
    • QSPI_ERASE
2021.03.29 21.1 1.0.1 Направи следните промени:
  • Ревизирано описание RSU_IMAGE_UPDATE в Списък с команди и описание маса.
  • Преструктуриран Команди за операция. Премахнати са описания на кодове на големи и незначителни грешки за командите CONFIG_STATUS и RSU_STATUS. Кодовете на големи и второстепенни грешки вече са документирани като приложение в Клиент на пощенска кутия Intel FPGA IP Ръководство за потребителя.
2020.12.14 20.4 1.0.1 Направи следните промени:
  • Добавена е важна забележка относно нулирането на QSPI флаш в Команди за операция тема.
  • Актуализиран на Списък с команди и описание таблица:
    • Ревизирано описание на командата GET_TEMPERATURE.
    • Ревизирано описание на командата RSU_IMAGE_UPDATE.
  • Добавен текст за нулиране на QSPI флаш.
  • Добавен е текст, описващ поведението между външния хост и FPGA.
  • Премахнат текст: Връща ненулев отговор, ако устройството вече обработва команда за конфигуриране.
    • Актуализирани описания на QSPI_WRITE и QSPI_READ, за да се уточни, че максималният размер на трансфер е 4 килобайта или 1024 думи.
    • Коригирана дължина на отговора от 1 до 0 за QSPI_OPEN, QSPI_CLOSE и QSPI_SET_CS команда.
    • Ревизирани описания на QSPI_OPEN, QSPI_WRITE, QSPI_READ_DEVICE_REG и QSPI_WRITE_DEVICE_REG.
    • Добавена е нова команда: REBOOT_HPS.
  • Добавена е нова тема: Възстановяване на код за грешка.
2020.10.05 20.3 1.0.1
  • Променено е заглавието на това ръководство за потребителя от Пощенска кутия Avalon Streaming Interface Client Intel FPGA IP Ръководство за потребителя към Клиент за пощенска кутия с Avalon Streaming Interface Intel FPGA IP Ръководство за потребителя поради промяната на IP името в Intel Quartus Prime IP каталога.
  • Глобално актуализира всички копия на IP имена.
  • Ревизирано описание на командата GET TEMPERATURE за устройства Intel Agilex в Списък с команди и описание маса.
  • Добавена е препоръка относно синхронизатора за нулиране в Интерфейси за часовник и нулиране маса.
  • Актуализиран на Кодове за грешки маса. Добавени са нови отговори с код за грешка:
    • HW_ERROR
    • COMMAND_SPECIFIC_ERROR
  • Премахнаха Местоположение на температурния сензор тема. Информацията за температурния сензор е достъпна в Ръководство за потребителя за Intel Agilex Power Management.
2020.06.30 20.2 1.0.0
  • Променено е заглавието на това ръководство за потребителя от Пощенска кутия Avalon ST Client Intel FPGA IP Ръководство за потребителя към Пощенска кутия Avalon Streaming Interface Client Intel FPGA IP Ръководство за потребителя.
  • Преименувано заглавие на темата Заглавие на командата и отговора към Команди и отговори.
  • Ревизирани описания на ID, LENGTH и код на команда/код на грешка в Описание на заглавката на командата и отговора маса.
  • Преименувано заглавие на темата Поддържани команди към Команди за операция.
  • Ревизира се описанието на следните команди в Списък с команди и описание таблица:
    • GET_TEMPERATURE
    • RSU_STATUS
    • QSPI_SET_CS
  • Преименувано заглавие на темата Кодове за грешки към Отговори с код за грешка.
  • Премахната команда UNKNOWN_BR от Код на грешка маса.
2020.04.13 20.1 1.0.0 Направи следните промени:
  • Добавена е информация за температурните сензори за командата GET_TEMPERATURE, включително фигури, илюстриращи местоположенията на TSD.
  • Добавена е команда RSU_NOTIFY в Списък с кодове на команди и описание маса.
  • Актуализиран на Кодове за грешки таблица:
    • Преименува INVALID_COMMAND_PARAMETERS на INVALID_LENGTH.
    • Променена е шестнадесетичната стойност на COMMAND_INVALID_ON_SOURCE от 5 на 6.
    • Шестнадесетичната стойност на CLIENT_ID_NO_MATCH е променена от 6 на 8.
    • Променена шестнадесетична стойност на INVALID_ADDRESS от 7 на 9.
    • Добавена е команда AUTHENTICATION_FAIL.
    • Шестнадесетичната стойност на TIMEOUT е променена от 8 на B.
    • Променена е шестнадесетичната стойност на HW_NOT_READY от 9 на C.
2019.09.30 19.3 1.0.0 Първоначално издание.

 За обратна връзка, моля посетете:  FPGAtechdocfeedback@intel.com

 

Документи / Ресурси

Intel Mailbox Client с Avalon Streaming Interface FPGA IP [pdf] Ръководство за потребителя
Клиент за пощенска кутия с Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Референции

Свързани публикации

Оставете коментар

Вашият имейл адрес няма да бъде публикуван. Задължителните полета са маркирани *