Клієнт поштової скриньки intel з потоковим інтерфейсом Avalon FPGA IP Посібник користувача
Клієнт поштової скриньки intel з потоковим інтерфейсом Avalon FPGA IP

Клієнт поштової скриньки з потоковим інтерфейсом Avalon® Intel FPGA IP Overview

Клієнт поштової скриньки з потоковим інтерфейсом Avalon® Intel® FPGA IP (клієнт поштової скриньки з IP-адресою клієнта Avalon ST) забезпечує канал зв’язку між вашою спеціальною логікою та диспетчером безпечних пристроїв (SDM). Ви можете використовувати клієнт поштової скриньки з Avalon ST IP для надсилання командних пакетів і отримання відповідних пакетів від периферійних модулів SDM. Клієнт поштової скриньки з Avalon ST IP визначає функції, які виконує SDM.

Ваша спеціальна логіка може використовувати цей канал зв’язку для отримання інформації та доступу до флеш-пам’яті від таких периферійних модулів:

  • Ідентифікатор чіпа
  • Датчик температури
  • Voltage Датчик
  • Флеш-пам'ять Quad Serial Peripheral Interface (SPI).

Примітка: У цьому посібнику користувача термін Avalon ST скорочується як інтерфейс потокової передачі Avalon або IP.

малюнок 1. Клієнт поштової скриньки з Avalon ST IP System Design
Клієнт поштової скриньки з Avalon ST IP System Design

На наступному малюнку показано додаток, у якому клієнт поштової скриньки з Avalon ST IP зчитує ідентифікатор мікросхеми.

малюнок 2. Клієнт поштової скриньки з Avalon ST IP зчитує ідентифікатор чіпа
Клієнт поштової скриньки з Avalon ST IP зчитує ідентифікатор мікросхеми

Підтримка сімейства пристроїв

Нижче наведено визначення рівнів підтримки пристроїв для IP-адрес Intel FPGA:

  • Попередня підтримка — IP доступний для моделювання та компіляції для цього сімейства пристроїв. Моделі синхронізації включають початкові інженерні оцінки затримок на основі ранньої інформації після компонування. Моделі синхронізації можуть змінюватися, оскільки тестування кремнію покращує кореляцію між фактичним кремнієм і моделями синхронізації. Ви можете використовувати цю IP-адресу для дослідження архітектури системи та використання ресурсів, моделювання, розпізнавання, оцінки системної затримки, базової оцінки часу (конвеєрне бюджетування) і стратегії передачі вводу-виводу (ширина шляху даних, глибина пакету, торгівля стандартами введення-виведення вимкнення).
  • Попередня підтримка — IP перевірено за попередніми моделями синхронізації для цього сімейства пристроїв. IP-адреса відповідає всім функціональним вимогам, але все ще може проходити аналіз часу для сімейства пристроїв. Його можна використовувати у виробничих конструкціях з обережністю.
  • Остаточна підтримка — IP-адресу перевірено за допомогою остаточних моделей синхронізації для цього сімейства пристроїв. IP відповідає всім функціональним і часовим вимогам для сімейства пристроїв і може використовуватися у виробничих проектах.

Таблиця 1. Підтримка сімейства пристроїв

Сімейство пристроїв Підтримка
Intel Agilex™ Аванс

Примітка: Ви не можете імітувати клієнта поштової скриньки за допомогою потокового інтерфейсу Avalon Intel FPGA IP, оскільки IP отримує відповіді від SDM. Щоб перевірити цю IP-адресу, Intel рекомендує виконати оцінку обладнання.

Пов'язана інформація
Клієнт поштової скриньки з потоковим інтерфейсом Avalon Примітки до випуску Intel FPGA IP

Параметри

Назва параметра Значення опис
Увімкнути інтерфейс статусу Увімкнено вимкнено Коли ви вмикаєте цей інтерфейс, клієнт поштової скриньки з потоковим інтерфейсом Avalon Intel FPGA IP включає сигнал command_status_invalid. Коли стверджується command_status_invalid, потрібно скинути IP-адресу.

Інтерфейси
На наступному малюнку показано клієнт поштової скриньки з потоковим інтерфейсом Avalon, IP-інтерфейси Intel FPGA:

малюнок 3. Клієнт поштової скриньки з інтерфейсом Avalon Streaming Інтерфейси Intel FPGA IP
Клієнт поштової скриньки з інтерфейсом Avalon Streaming Інтерфейси Intel FPGA IP

Для отримання додаткової інформації про потокові інтерфейси Avalon зверніться до специфікацій інтерфейсу Avalon.
Пов'язана інформація
Специфікації інтерфейсу Avalon

Інтерфейси годинника та скидання

Таблиця 2. Інтерфейси годинника та скидання

Назва сигналу Напрямок опис
in_clk Введення Це годинник для потокових інтерфейсів Avalon. Максимальна частота в 250 МГц.
in_reset Введення Це активний високий скидання. Assert 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-адреси та підключення в конструкторі платформи, зверніться до розділу «Обов’язкові комунікаційні та хост-компоненти для дизайну оновлення віддаленої системи».ampу посібнику користувача конфігурації 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_valid засвідчує, що command_data дійсні.
командні_дані[31:0] Введення Шина command_data направляє команди до SDM. Зверніться до списку та опису команд для визначення команд.
command_startofpacket Введення Command_startofpacket стверджує в першому циклі командного пакета.
command_endofpacket Введення Команда command_endofpacket затверджує в останньому циклі команди пакет.

малюнок 4. Час для командного пакета Avalon ST
fig:m Командний пакет ST

Інтерфейс відповіді
SDM Avalon ST Client IP надсилає відповіді вашій заявці за допомогою інтерфейсу відповідей.

Таблиця 4. Інтерфейс відповіді

Сигнал 5 Напрямок опис
response_ready Введення Логіка програми може видавати сигнал response_ready щоразу, коли вона може отримати відповідь.
відповідь_дійсна Вихід SDM стверджує response_valid, щоб вказати, що response_data дійсні.
дані_відповіді[31:0] Вихід SDM управляє response_data, щоб надати запитувану інформацію. Перше слово відповіді – це заголовок, який ідентифікує команду, яку надає SDM. Відноситься до Список і опис команд для визначення команд.
response_startofpacket Вихід Response_startofpacket стверджується в першому циклі пакета відповіді.
відповідь_кінець пакета Вихід Response_endofpacket стверджується в останньому циклі пакета відповіді.

Рисунок 5. Час для пакета відповіді Avalon ST
Пакет відповіді Avalon ST

Інтерфейс стану команд

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

Назва сигналу Напрямок опис
command_status_invalid Вихід Command_status_invalid стверджує, що вказує на помилку. Цей сигнал зазвичай повідомляє, що довжина команди, зазначеної в заголовку команди, не відповідає довжині надісланої команди. Коли стверджується command_status_invalid, ваша логіка програми повинна стверджувати in_reset, щоб перезапустити клієнт поштової скриньки з потоковим інтерфейсом Avalon Intel FPGA IP.

малюнок 6. Скидання після command_status_invalid Asserts
рис.: command_status_invalid Asserts

Команди та відповіді

Хост-контролер зв’язується з SDM за допомогою пакетів команд і відповідей через IP клієнта поштової скриньки Intel FPGA.

Перше слово пакетів команди та відповіді – це заголовок, який містить основну інформацію про команду чи відповідь.

малюнок 7. Формат заголовка команди та відповіді
рис. Формат заголовка команди та відповіді

Примітка: Поле LENGTH у заголовку команди має відповідати довжині відповідної команди.
У наведеній нижче таблиці описано поля команди заголовка.

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

Заголовок біт опис
Зарезервовано [31:28] Зарезервовано.
ID [27:24] Ідентифікатор команди. Заголовок відповіді повертає ідентифікатор, указаний у заголовку команди. Опис команд див. у розділі Операційні команди.
0 [23] Зарезервовано.
ДОВЖИНА [22:12] Кількість слів аргументів після заголовка. IP відповідає помилкою, якщо для даної команди введено неправильну кількість слів аргументів.
Якщо існує невідповідність між довжиною команди, зазначеною в заголовку команди, і кількістю надісланих слів. IP піднімає біт 3 регістру стану переривання (COMMAND_INVALID), і клієнт поштової скриньки має бути скинутий.
Зарезервовано [11] Зарезервований. Потрібно встановити 0.
Код команди/код помилки [10:0] Код команди визначає команду. Код помилки вказує на те, успішно чи не виконано команду.
У заголовку команди ці біти представляють код команди. У заголовку відповіді ці біти представляють код помилки. Якщо команда виконується успішно, код помилки дорівнює 0. Якщо команда не виконується, зверніться до кодів помилок, визначених у Відповіді на код помилки.

Команди операції

Скидання Quad SPI Flash
Важливо:
Для пристроїв Intel Agilex необхідно під’єднати контакт скидання флеш-пам’яті з послідовним портом або чотирма SPI до контакту AS_nRST. SDM повинен повністю контролювати скидання QSPI. Не підключайте контакт скидання quad 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 USERCODE, який бітовий потік конфігурації записує на пристрій.
GET_VOLTAGE 18 1 n(2) GET_VOLTAGКоманда E має єдиний аргумент, який є бітовою маскою, яка визначає канали для читання. Біт 0 визначає канал 0, біт 1 визначає канал 1 і так далі.
Відповідь містить однослівний аргумент для кожного біта, встановленого в бітовій масці. Тtage повертається число без знаку з фіксованою комою з 16 бітами нижче двійкової точки. наприкладample, томtage 0.75 В повертає 0x0000C000. (3)
Пристрої Intel Agilex мають один томtage датчик. Отже, відповідь завжди складається з одного слова.
ОТРИМАЙТЕ_ ТЕМПЕРАТУРУ 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. Температура -1.5°C повертає 0xFFFFFE80.
Якщо бітова маска вказує недійсне розташування, команда повертає код помилки, який є будь-яким значенням у діапазоні 0x80000000 -0x800000FF.
Для пристроїв Intel Agilex зверніться до посібника користувача Intel Agilex Power Management, щоб дізнатися більше про локальні вбудовані датчики температури.

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_ STATUS 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'
Версія Quartus, доступна в програмному забезпеченні Intel Quartus Prime версії 21.3 або пізнішої, відображає:
  • Біт [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 Статус PIN-коду
  • Біт [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 Помилка зображення Flash-зміщення зображення програми, яка не працює з найвищим пріоритетом. Якщо у флеш-пам’яті є кілька зображень, зберігається значення першого зображення, яке не вдалося виконати. Усі значення 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 Запитує ексклюзивний доступ до квадроциклу SPI. Ви надсилаєте цей запит перед будь-якими іншими запитами QSPI. SDM приймає запит, якщо квадроцикл SPI не використовується і SDM не налаштовує пристрій.
Повертає OK, якщо SDM надає доступ.
SDM надає ексклюзивний доступ клієнту, який використовує цю поштову скриньку. Інші клієнти не можуть отримати доступ до квадроциклу SPI, доки активний клієнт не відмовиться від доступу за допомогою команди QSPI_CLOSE.
Доступ до пристроїв флеш-пам’яті Quad SPI через будь-яку IP-адресу клієнта поштової скриньки недоступний за замовчуванням у моделях, які включають HPS, якщо ви не вимкнете QSPI у конфігурації програмного забезпечення HPS.
Важливо: Під час скидання quad SPI ви повинні дотримуватись інструкцій, наведених у Скидання Quad SPI Flash на сторінці 9.
QSPI_CLOSE 33 0 0 Закриває ексклюзивний доступ до інтерфейсу Quad 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 Зчитує підключений пристрій quad SPI. Максимальний розмір передачі становить 4 кілобайти (КБ) або 1024 слова.
Приймає два аргументи:
  • Флеш-адреса Quad SPI (одне слово). Адреса має бути вирівняна за словами. Пристрій повертає код помилки 0x1 для невирівняних адрес.
  • Кількість слів для читання (одне слово).

У разі успіху повертає OK, а потім читає дані з пристрою чотирьох SPI. Відповідь на помилку повертає код помилки.
Для частково успішного читання QSPI_READ може помилково повернути статус OK.
Примітка: Ви не можете запустити команду QSPI_READ під час конфігурації пристрою.
Важливо:Під час скидання quad SPI ви повинні дотримуватись інструкцій, наведених у Скидання Quad SPI Flash на сторінці 9.

QSPI_WRITE 39 2+N 0 Записує дані на пристрій quad SPI. Максимальний розмір передачі становить 4 кілобайти (КБ) або 1024 слова.
Приймає три аргументи:
  • Зміщення флеш-адреси (одне слово). Адреса запису має бути вирівняна за словами.
  • Кількість слів для написання (одне слово).
  • Дані для запису (одне або кілька слів). Успішний запис повертає код відповіді OK.

Щоб підготувати пам'ять для запису, скористайтеся командою QSPI_ERASE перед виконанням цієї команди.
Примітка: Ви не можете запустити команду QSPI_WRITE під час конфігурації пристрою.
Важливо:Під час скидання quad SPI ви повинні дотримуватись інструкцій, наведених у Скидання Quad SPI Flash на сторінці 9.

QSPI_ERASE 38 2 0 Стирає сектор 4/32/64 КБ пристрою з чотирма SPI. Приймає два аргументи:
  • Зміщення флеш-адреси для початку стирання (одне слово). Залежно від кількості слів, які потрібно видалити, початкова адреса має бути:
    • 4 КБ вирівняно, якщо числові слова, які потрібно видалити, дорівнюють 0x400
    • 32 КБ вирівняно, якщо числові слова, які потрібно видалити, дорівнюють 0x2000
    • 64 КБ вирівняно, якщо кількість слів для стирання становить 0x4000. Повертає помилку для не вирівняних адрес 4/32/64 КБ.
  • Кількість слів для видалення вказується у кратних числах:
    • 0x400 для видалення 4 КБ (100 слів) даних. Цей параметр є мінімальним розміром стирання.
    • 0x2000 для видалення 32 КБ (500 слів) даних
    • 0x4000 для видалення 64 КБ (1000 слів) даних Успішне видалення повертає код відповіді OK.

Важливо:Під час скидання quad SPI ви повинні дотримуватись інструкцій, наведених у Скидання Quad SPI Flash на сторінці 9.

QSPI_READ_ DEVICE_REG 35 2 N Читає регістри з пристрою quad 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 Gigabit (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. Приймає один аргумент:
  • Код операції для надсилання пристрою quad 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 Вказує на те, що наразі завантажене ПЗУ для завантаження не може декодувати або розпізнати код команди.
3 НЕВІДОМА КОМАНДА Вказує на те, що поточне завантажене мікропрограмне забезпечення не може декодувати код команди.
4 INVALID_COMMAND_ PARAMETERS Вказує на те, що команда неправильно відформатована. наприклад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 Вказує на одну з таких умов:
  • Обладнання не готове. Може вказувати на проблему ініціалізації або конфігурації. Апаратне забезпечення може стосуватися чотирьох 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_ALREADY_ OPEN 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_ PARAMETERS Повторно надішліть заголовок команди або заголовок з аргументами з виправленими параметрами.
наприклад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 Intel FPGA IP Посібник користувача Архіви документів

Останню та попередню версії цього посібника користувача див Клієнт поштової скриньки з потоковим інтерфейсом Avalon Посібник користувача Intel FPGA IP. Якщо IP-адреса або версія програмного забезпечення відсутні в списку, застосовується посібник користувача для попередньої IP-адреси або версії програмного забезпечення.

Версії IP такі ж, як версії програмного забезпечення Intel Quartus Prime Design Suite до версії 19.1. Починаючи з програмного забезпечення Intel Quartus Prime Design Suite версії 19.2 або новішої, IP-ядра мають нову схему версії IP.

Історія версій документів для клієнта поштової скриньки з потоковим інтерфейсом Avalon Посібник користувача 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 Оновлено список команд і таблицю опису.
  • Оновлено опис статусу PIN-коду для команди 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 Посібник користувача Intel FPGA IP через зміну назви IP-адреси в каталозі IP-адрес Intel Quartus Prime.
  • Глобально оновлено всі випадки IP-імен.
  • Переглянуто опис команди GET TEMPERATURE для пристроїв Intel Agilex у Список і опис команд стіл.
  • Додана рекомендація щодо скидання синхронізатора в Інтерфейси годинника та скидання стіл.
  • Оновлено Коди помилок стіл. Додано нові відповіді з кодами помилок:
    • HW_ERROR
    • COMMAND_SPECIFIC_ERROR
  • Видалено Розташування датчиків температури тема. Інформація про датчик температури доступна в Посібник користувача Intel Agilex Power Management.
2020.06.30 20.2 1.0.0
  • Змінено назву цього посібника користувача з Mailbox Avalon ST Client Intel FPGA IP User Guide до Поштова скринька 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 з потоковим інтерфейсом Avalon FPGA IP [pdfПосібник користувача
Клієнт поштової скриньки з Avalon Streaming Interface FPGA IP, Mailbox Client, Avalon Streaming Interface FPGA IP

Список літератури

Залиште коментар

Ваша електронна адреса не буде опублікована. Обов'язкові поля позначені *