为确保带有 Avalon ST IP 的 Mailbox Client 在设备进入用户模式时正常工作，您的设计必须包括 Reset Release Intel FPGA IP 以保持复位直到 FPGA 结构进入用户模式。 Intel 建议在将 Reset Release IP 的用户复位或输出连接到时使用复位同步器

笔记： 有关 Platform Designer 中的 IP 实例化和连接指南，请参阅 Required Communication and Host Components for the Remote System Update Design ExampIntel Agilex 配置用户指南中的图。

对于 Intel Agilex 设备，使用 sensor_req 参数指定位置。 sensor_req 包括以下字段：

• 位[31:28]：保留。
• 位 [27:16]：传感器位置。 指定 TSD 位置。
• Bits[15:0]：传感器掩码。 指定要读取指定传感器位置的传感器。 对于请求的每个温度，响应都包含一个词。 如果省略，该命令将读取通道 0。最低有效位 (lsb) 对应于传感器 0。最高有效位 (msb) 对应于通道 15。

返回的温度是一个有符号的固定值，二进制小数点以下 8 位。 对于前amp例如，10°C 的温度返回 0x00000A00。 温度 -1.5°C 的 A 返回 0xFFFFFE80。
如果位掩码指定了一个无效的位置，该命令将返回一个错误代码，该代码是 0x80000000 -0x800000FF 范围内的任何值。
对于 Intel Agilex 设备，请参阅 Intel Agilex 电源管理用户指南以获取有关本地内置温度传感器的更多信息。

• Bit [31:0]：应用映像的起始地址。
• Bit [63:32]：保留位（写为0）。

设备处理此命令后，它会在继续重新配置设备之前将响应标头返回到响应 FIFO。 确保主机 PC 或主机控制器停止为其他中断提供服务，并专注于读取响应标头数据以指示命令成功完成。 否则，一旦重新配置过程开始，主机 PC 或主机控制器可能无法接收到响应。
一旦设备进行重新配置，外部主机和 FPGA 之间的链接就会丢失。 如果您在设计中使用 PCIe，则需要重新枚举 PCIe 链路。
重要的： 重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 高 16 位：主要错误代码。
• 低 16 位：轻微错误码。

参考附录： 配置状态 和邮箱客户端英特尔中的 RSU_STATUS 错误代码说明 FPGA知识产权  用户指南了解更多信息。

• Bit [31:28]：最近使用的固件或决策固件副本的索引。 可能的值为 0、1、2 和 3。
• 位[27:24]：保留
• 位 [23:16]：值为“0”

• Bit [31:28]：最近使用的固件或决策固件副本的索引。 可能的值为 0、1、2 和 3。
• 位[27:24]：保留
• Bit [23:16]：Quartus 主要版本号
• Bit [15:8]：次要 Quartus 版本号
• Bit [7:0]: Quartus 更新号

例如amp例如，在 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

• Bit [31]：当前 nSTATUS 输出值（低电平有效）
• 位 [30]：检测到的 nCONFIG 输入值（低电平有效）
• 位[29:8]：保留
• Bit [7:6]：配置时钟源
  • 01 = 内部振荡器
  • 10 = OSC_CLK_1
• 位[5:3]：保留
• Bit [2:0]：上电时的 MSEL 值

• 位[31:6]：保留
• 位[5]：HPS_WARMRESET
• 位[4]：HPS_COLDRESET
• 位[3]：SEU_ERROR
• 位[2]：CVP_DONE
• 位[1]：INIT_DONE
• 位[0]：CONF_DONE

（继续…。）

• Bit [31:16]：主要错误代码
• 位 [15:0]：次要错误代码 无故障返回 0。 参考

附录：邮箱客户端 Intel FPGA IP 用户指南中的 CONFIG_STATUS 和 RSU_STATUS 错误代码说明了解更多信息。

• 0x00050000：清除当前复位重试计数器。 重置当前重试计数器会将计数器设置回零，就好像当前图像是第一次成功加载一样。
• 0x00060000：清除错误状态信息。
• 所有其他值均保留。

该命令在 Intel Quartus Prime Pro Edition 软件版本 19.3 之前不可用。

• Bits[31:28]：要选择的闪存设备。 有关与 nCSO[0:3] 引脚对应的值，请参阅以下信息
  • 值 4'h0000 选择对应于 nCSO[0] 的闪存。
  • 值 4'h0001 选择对应于 nCSO[1] 的闪存。
  • 值 4'h0002 选择对应于 nCSO[2] 的闪存。
  • 值 4'h0003 选择对应的 flash nCSO[3]。
• Bits[27:0]：保留位（写为0）。

笔记： Intel Agilex 或 Intel Stratix® 10 器件支持一个 AS x4 闪存器件用于来自连接到 nCSO[0] 的 quad SPI 器件的 AS 配置。 一旦设备进入用户模式，您最多可以使用四个 AS x4 闪存与邮箱客户端 IP 或 HPS 一起用作数据存储。 TheMailbox Client IP 或 HPS 可以使用 nCSO[3:0] 访问 quad SPI 设备。
此命令对于 AS x4 配置方案是可选的，片选线跟随最后执行的 QSPI_SET_CS 命令或在 AS x0 配置后默认为 nCSO[4]。 杰TAG 配置方案需要执行此命令以访问连接 SDM_IO 引脚的 QSPI 闪存。
使用 SDM_IO 引脚访问 QSPI 闪存设备仅适用于 AS x4 配置方案，JTAG 配置，以及为 AS x4 配置编译的设计。 对于 Avalon 流接口 (Avalon ST) 配置方案，您必须将 QSPI 闪存连接到 GPIO 引脚。

• 四路 SPI 闪存地址（一个字）。 地址必须是字对齐的。 对于未对齐的地址，设备返回 0x1 错误代码。
• 要阅读的字数（一个字）。

成功时，返回 OK，后跟从 quad SPI 设备读取的数据。 失败响应返回错误代码。
对于部分成功的读取，QSPI_READ 可能会错误地返回 OK 状态。
笔记： 当设备配置正在进行时，您不能运行 QSPI_READ 命令。
重要的：重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 闪存地址偏移量（一个字）。 写地址必须是字对齐的。
• 要写的字数（一个字）。
• 要写入的数据（一个或多个字）。 成功的写入返回 OK 响应代码。

要为写入准备内存，请在发出此命令之前使用 QSPI_ERASE 命令。
笔记： 当设备配置正在进行时，您不能运行 QSPI_WRITE 命令。
重要的：重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 开始擦除的闪存地址偏移量（一个字）。 根据要擦除的字数，起始地址必须是：
  • 如果要擦除的数字字为 4x0，则 400 KB 对齐
  • 如果要擦除的数字字为 32x0，则 2000 KB 对齐
  • 如果要擦除的字数为 64x0，则 4000 KB 对齐 返回非 4/32/64 KB 对齐地址的错误。
• 要擦除的字数指定为以下的倍数：
  • 0x400 擦除 4 KB（100 个字）的数据。 此选项是最小擦除大小。
  • 0x2000 擦除 32 KB（500 字）的数据
  • 0x4000 擦除 64 KB（1000 字）数据 擦除成功返回 OK 响应代码。

重要的：重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 读取命令的操作码。
• 要读取的字节数。

• 写命令的操作码。
• 要写入的字节数。
• 要写入的数据。

要执行扇区擦除或子扇区擦除，您必须按最高有效字节 (MSB) 到最低有效字节 (LSB) 的顺序指定串行闪存地址，如下所示amp乐说明。
要使用 QSPI_WRITE_DEVICE_REG 命令擦除地址 2x0FF04 处的美光 0000 吉比特 (Gb) 闪存扇区，请按 MSB 到 LSB 顺序写入闪存地址，如下所示：
标头： 0x00003036 操作码：0x000000DC
要写入的字节数： 0x00000004 闪存地址：0x0000FF04
成功的写入返回 OK 响应代码。 此命令将不是 4 字节倍数的数据填充到下一个字边界。 该命令用零填充数据。
重要的：重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 发送 quad SPI 设备的操作码。

成功的命令返回 OK 响应代码。
重要的：重置 quad SPI 时，您必须遵循中指定的说明 重置 Quad SPI 闪存 在第9页。

• 未对齐的地址
• 地址范围问题
• 读取权限问题
• 一个无效的片选值，显示值大于 3
• RSU 案例中的无效地址
• GET_VOL 的位掩码值无效TAGE命令
• GET_TEMPERATURE 命令的无效页面选择

• 命令
• 等待 QSPI_READ 操作完成
• 等待来自其中一个温度传感器的请求温度读数。 可能表示温度传感器中存在潜在的硬件错误。

• 硬件还没有准备好。 可以指示初始化或配置问题。 硬件可能指的是quad SPI。
• RSU 映像不用于配置 FPGA。

命令

QSPI_READ_DEVICE_REG/

QSPI_SEND_DEVICE_OP/

QSPI_READ

• QSPI flash片选设置问题
• 一个QSPI flash初始化问题
• QSPI flash复位问题
• QSPI 闪存设置更新问题

• RSU：由于内部错误，固件无法转换到不同版本。
• HPS：当处于 HPS 重新配置过程或 HPS 冷复位时，HPS 忙。

• 发送带有有效芯片选择的命令。
• 发送带有有效 QSPI 闪存地址的命令。

对于 RSU：发送带有出厂映像或应用程序有效起始地址的命令。

对于 GET_TEMPERATURE 命令：重试再次发送命令。 如果问题仍然存在，请重新配置或重启设备。

对于 QSPI 操作：检查 QSPI 接口的信号完整性并再次尝试命令。

对于 HPS 重启操作：重试再次发送命令。

对于 QSPI 操作：通过源重新配置设备。 确保用于构建设计的 IP 允许访问 QSPI 闪存。

对于 RSU：使用 RSU 映像配置设备。

对于 QSPI 操作：等待正在进行的配置或其他客户端完成操作。

对于 RSU：重新配置设备以从内部错误中恢复。

对于 HPS 重启操作：等待通过 HPS 或 HPS 冷重置完成重新配置。

• 更新了 GET_VOLTAGE命令行中

命令列表和描述表。

• 添加了对表设备系列支持的注释。
• 修改 QSPI_SET_CS 命令列表和描述表中的命令描述。

• 更新了 CONFIG_STATUS 命令的引脚状态描述。
• 删除了 REBOOT_HPS 命令。

• 修改 命令列表和说明 桌子。 更新说明：
  • 配置状态
  • RSU_状态

• 修改 命令列表和说明 桌子。 更新说明：
  • RSU_状态
  • QSPI_OPEN
  • QSPI_SET_CS
  • QSPI_擦除

• 修改了 RSU_IMAGE_UPDATE 中的描述 命令列表和说明 桌子。
• 重组 操作指令. 删除了 CONFIG_STATUS 和 RSU_STATUS 命令的主要和次要错误代码说明。 主要和次要错误代码现在作为附录记录在 邮箱客户端英特尔 FPGA IP 用户指南。

• 在中添加了关于重置 QSPI 闪存的重要说明 操作指令 话题。
• 更新了 命令列表和说明 表：
  • 修改了 GET_TEMPERATURE 命令说明。
  • 修订了 RSU_IMAGE_UPDATE 命令说明。
• 添加了有关重置 QSPI 闪存的文本。
• 添加了描述外部主机和 FPGA 之间行为的文本。
• 删除的文本： 如果设备已经在处理配置命令，则返回非零响应。
  • 更新了 QSPI_WRITE 和 QSPI_READ 说明以指定最大传输大小为 4 KB 或 1024 字。
  • 将 QSPI_OPEN、QSPI_CLOSE 和 QSPI_SET_CS 的响应长度从 1 更正为 0 命令。
  • 修改了 QSPI_OPEN、QSPI_WRITE、QSPI_READ_DEVICE_REG 和 QSPI_WRITE_DEVICE_REG 描述。
  • 添加了一个新命令：REBOOT_HPS。
• 添加了新主题：错误代码恢复。

• 将本用户指南的标题从 邮箱 Avalon Streaming Interface Client Intel FPGA IP 用户指南 到 带有 Avalon 流接口的邮箱客户端英特尔 FPGA IP 用户指南 由于 Intel Quartus Prime IP Catalog 中的 IP 名称更改。
• 全局更新所有 IP 名称实例。
• 修改了 Intel Agilex 设备的 GET TEMPERATURE 命令描述 命令列表和说明 桌子。
• 在中添加了有关重置同步器的建议 时钟和复位接口 桌子。
• 更新了 错误代码 桌子。 添加了新的错误代码响应：
  • 硬件错误
  • 命令特定错误
• 删除了 温度传感器位置 话题。 温度传感器信息可在 Intel Agilex 电源管理用户指南.

• 将本用户指南的标题从 邮箱 Avalon ST Client Intel FPGA IP 用户指南 到 邮箱 Avalon Streaming Interface Client Intel FPGA IP 用户指南.
• 重命名主题标题 命令和响应头 到 命令和响应.
• 修订后的 ID、长度和命令代码/错误代码说明 命令和响应头描述 桌子。
• 重命名主题标题 支持的命令 到 操作指令.

• 修改了以下命令说明 命令列表和说明 表：
  • 获取温度
  • RSU_状态
  • QSPI_SET_CS
• 重命名主题标题 错误代码 到 错误代码响应.
• 从中删除了 UNKNOWN_BR 命令 错误代码 桌子。

• 为 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。