Intel Agilex® 7 Hard Processor System Remote System Update User Guide

ID 683184
Date 6/09/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

3.2.2. Sub-Partition Table Layout

The following table shows the structure of the sub-partition table. The Intel® Quartus® Prime Programming File Generator software supports up to 126 partitions. Each sub-partition descriptor is 32 bytes.

Note: The firmware never updates the SPT.
Table 4.  Sub-partition Table Layout
Offset Size (in bytes) Description
0x000 4 Magic number 0x57713427
0x004 4 Version number:
  • 0 - before Intel® Quartus® Prime Pro Edition software version 20.4
  • 1 - starting with Intel® Quartus® Prime Pro Edition software version 20.4
0x008 4 Number of entries
0x00C 4 Checksum:
  • 0 - before Intel® Quartus® Prime Pro Edition software version 20.4
  • CRC32 checksum - starting with Intel® Quartus® Prime Pro Edition software version 20.4
0x010 16 Reserved
0x020 32 Sub-partition Descriptor 1
0x040 32 Sub-partition Descriptor 2
0xFE0 32 Sub-partition Descriptor 126

Starting with Intel® Quartus® Prime Pro Edition software version 20.4, the SPT header contains a CRC32 checksum that is computed over the whole SPT. The value of the CRC32 checksum field itself is assumed as zero when the checksum is computed. Refer to Absolute Application Image Layout for the algorithm used to compute the CRC32 checksum.

The checksum is provided as a convenience so that SPT corruptions can better be detected by HPS software. By default the feature is turned off.

Each 32-byte sub-partition descriptor contains the following information:

Table 5.  Sub-partition Descriptor Layout
Offset Size Description
0x00 16 Sub-partition name, including a null string terminator
0x10 8 Sub-partition start offset
0x18 4 Sub-partition length
0x1C 4 Sub-partition flags
Two flags are currently defined:
  • System flag, if set to 1: Reserved for RSU system. For partition offset value, refer to RSU Image Sub-Partitions Layout table in RSU Image Sub-Partitions Layout.
  • Read-only flag, if set to 1: The system protects partition against direct writes.
Note: You can use the read-only flag as an additional information during your API development. Read-only flag=1 indicates the content can only be changed by API from Intel® .
The Intel® Quartus® Prime Programming File Generator sets these flags as follows at image creation time, then they are not changed afterward:
Table 6.  Flags Specifying Contents and Access
Partition System Read Only
BOOT_INFO 1 1
FACTORY_IMAGE 1 1
SPT0 1 0
SPT1 1 0
CPB0 1 0
CPB1 1 0
P1 0 0
P2 0 0
Note: In order to successfully update SPTs and CPBs, the HPS software (U-Boot or Linux) must be configured to support a minimum QSPI erase granularity smaller or equal to CPB and SPT sizes. All supported flash devices offer erase granularities of 4 KB, 32 KB, and 64 KB. HPS software is typically configured with either 4 KB or 64 KB erase granularity. When the HPS software is configured with 64 KB erase granularity, the CPB and SPT sizes must be configured in Programming File Generator to be 64 KB instead of the default 32 KB.