Spartan UltraScale+ Programmable Device Image (PDI) Settings - Spartan UltraScale+ Programmable Device Image (PDI) Settings - 2026.1 English - UG908

Vivado Design Suite User Guide: Programming and Debugging (UG908)

Document ID
UG908
Release Date
2026-06-23
Version
2026.1 English

The device configuration settings for the AMD Spartan™ UltraScale+™ devices available for use with the set_property <Setting> <Value> [current_design] Vivado tool Tcl command are shown in the following table.

Table 1. Spartan UltraScale+ Programmable Device Image Settings
Setting Default Value Possible Values Description
BITSTREAM.AUTHENTICATION.AUTHENTICATE NONE NONE, HSS-SHAKE256, LMS-SHAKE256, ECDSA-P384 Enable bitstream authentication.
BITSTREAM.AUTHENTICATION.LMSPRIMARYPUBLICKEYFILE NONE File path string LMS primary public key file input
BITSTREAM.AUTHENTICATION.LMSSECONDARYPUBLICKEYFILE NONE File path string LMS secondary public key file input
BITSTREAM.AUTHENTICATION.PRIMARYSECRETKEYFILE NONE File path string Primary secret key file input
BITSTREAM.AUTHENTICATION.SECONDARYSECRETKEYFILE NONE File path string Secondary secret key file input
BITSTREAM.CONFIG.CCLKPIN PULLUP PULLUP, PULLNONE CCLK Pin
BITSTREAM.CONFIG.CONFIGRATE 21 127, 102, 85, 72, 63, 56, 51, 42, 31, 25, 21 Select the frequency in MHz for the internally generated configuration clock source (CCLK).
BITSTREAM.CONFIG.D00_MOSI_DOUT PULLUP PULLUP, PULLDOWN, PULLNONE D00_MOSI_DOUT Pin
BITSTREAM.CONFIG.D01_DIN PULLUP PULLUP, PULLDOWN, PULLNONE D01_DIN Pin
BITSTREAM.CONFIG.D02_CS_B PULLUP PULLUP, PULLDOWN, PULLNONE D02_CSB Pin
BITSTREAM.CONFIG.D03_READY PULLUP PULLUP, PULLDOWN, PULLNONE D03_READY Pin
BITSTREAM.CONFIG.DCIUPDATEMODE ASREQUIRED ASREQUIRED, QUIET, SAFE Digitally controlled impedance (DCI) circuit match frequency
BITSTREAM.CONFIG.DONEPIN PULLUP PULLUP, PULLNONE DONE pin
BITSTREAM.CONFIG.EMCCLK DISABLE DISABLE, FREQ [51-166 MHz] Set External Master Configuration Clock (EMCCLK) frequency [51-166 MHz]
BITSTREAM.CONFIG.INITPIN PULLUP PULLUP, PULLNONE INIT_B Pin
BITSTREAM.CONFIG.INITSIGNALSERROR ENABLE ENABLE, DISABLE Drop INIT_B pin when there is a configuration error
BITSTREAM.CONFIG.M0PIN PULLUP PULLUP, PULLDOWN, PULLNONE M0 pin
BITSTREAM.CONFIG.M1PIN PULLUP PULLUP, PULLDOWN, PULLNONE M1 pin
BITSTREAM.CONFIG.M2PIN PULLUP PULLUP, PULLDOWN, PULLNONE M2 pin
BITSTREAM.CONFIG.MULTIBOOT_DEBUG DISABLE ENABLE, DISABLE Only used for debugging boot issues. Setting to ENABLE disables fallback to collect additional debug information.
BITSTREAM.CONFIG.OSPI_DDR DISABLE DISABLE, ENABLE Enables the DDR feature in Master OSPI configuration mode.
BITSTREAM.CONFIG.OSPI_ECC_FAIL DISABLE DISABLE, ENABLE Enable OSPI ECC Fail
BITSTREAM.CONFIG.OVERTEMPSHUTDOWN DISABLE DISABLE, ENABLE Enable over-temperature shutdown
BITSTREAM.CONFIG.PERSIST NO NO, YES Prohibit usage of the configuration pins as user I/O and persist after configuration
BITSTREAM.CONFIG.PROGPIN PULLUP PULLUP, PULLNONE PROGRAM_B Pin
BITSTREAM.CONFIG.PUDC_B PULLUP PULLUP, PULLDOWN, PULLNONE PUDC_B Pin
BITSTREAM.CONFIG.QSPI_STACKED DISABLE DISABLE, ENABLE Enable post-configuration access to the QSPI when in Dual Stacked QSPI (SPIx4) mode.
BITSTREAM.CONFIG.RDWR_B_FCS_B PULLUP PULLUP, PULLDOWN, PULLNONE RDWR_B_FCS_B Pin
BITSTREAM.CONFIG.SECONDARY_BOOT NONE NONE, AXI32, MCAP, JTAG Select the source for secondary boot.
BITSTREAM.CONFIG.TCKPIN PULLUP PULLUP, PULLDOWN, PULLNONE TCK Pin
BITSTREAM.CONFIG.TDIPIN PULLUP PULLUP, PULLDOWN, PULLNONE TDI Pin
BITSTREAM.CONFIG.TDOPIN PULLUP PULLUP, PULLDOWN, PULLNONE TDO Pin
BITSTREAM.CONFIG.TMSPIN PULLUP PULLUP, PULLDOWN, PULLNONE TMS Pin
BITSTREAM.CONFIG.UNUSEDPIN PULLDOWN PULLUP, PULLDOWN, PULLNONE Unused IOB Pins
BITSTREAM.CONFIG.USERID NONE NONE, <8-digit hex string> USERCODE (USER ID)
BITSTREAM.CONFIG.USR_ACCESS NONE NONE, <8-digit hex string>, TIMESTAMP User Access
BITSTREAM.EAM.CCU_APB_ERROR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a APB Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_BAD_PR_FORMAT NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a Bad Packet Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_CRC_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a CCU_CRC_ERR. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_IDCODE_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a IDCODE Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_SEU_CRC_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a CCU_SEU_CRC_ERR. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_SEU_ECC_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a CCU_SEU_ECC_ERR. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.CCU_TAMPER_FABRIC NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a Tamper Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.DFX_UNEXPECTED_ACTIV_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a DFX Unexpected Activ Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.EFUSE_CACHE_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a eFUSE Cache Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.EFUSE_PGM_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a eFUSE Programming Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.EFUSE_RD_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a eFUSE Read Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.JTAG_TOGGLE_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a JTAG Toggle Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.OSPI_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a OSPI Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.PMC_BOOT_NCR_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a PMC Boot Non-Correctible Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.PMC_FW_CR_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a PMC Firmware Correctible Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.PMC_FW_NCR_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a PMC Firmware Non-Correctible Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.ROM_VALID_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a ROM Valid Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_AXI_APB_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a AXI APB Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_JTAG_OVF_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a JTAG Overflow Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_MCAP_OVF_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a MCAP Overflow Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_SMAP_ABORT NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a SelectMAP Abort Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_SMAP_CONFIG_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a SelectMAP Configuration Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_SMAP_OVF_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a SelectMAP Overflow Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SBI_SS_OVF_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a Slave Serial Overflow Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SECLKDWN_IO_TRISTATE DISABLE DISABLE, ENABLE Enable I/O Tri-State if system enters secure lockdown.
BITSTREAM.EAM.SSS_CFG_ERR NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a Slave Serial Config Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EAM.SYSMON_OT NONE NONE, ERROR_OUT, SLD, SRST Set the Error Aggregator Module (EAM) response for a Sysmon Over Temperature Error. ERROR_OUT selects the EAM response to drive the INIT_B pin low if this error is detected. SLD selects the EAM response to send the system into secure lock-down state. SRST selects the EAM response to issue a system reset.
BITSTREAM.EFUSE_PROGRAM.EFUSE_CLK_FREQ FREQ [25-200 MHz]   Programming eFUSE clock source
BITSTREAM.EFUSE_PROGRAM.EFUSE_CLK_SOURCE DISABLE, EMCCLK, FUSE_CLK DISABLE Programming eFUSE clock source
BITSTREAM.ENCRYPTION.BLOCKS String DISABLE, ENABLE Block Sizes Input for AES Key Rolling
BITSTREAM.ENCRYPTION.BOOTHEADER_KEYFILE File Path String DISABLE, ENABLE Family Key File Input
BITSTREAM.ENCRYPTION.CDOKEYFILE <string>.nky DISABLE, ENABLE RCDO Partition AES NKY File Input
BITSTREAM.ENCRYPTION.DPACM_ENABLE <none/empty>, NO, YES <none> Selection of DPA Countermeasure Enablement in PDI
BITSTREAM.ENCRYPTION.ENCRYPT NONE, AES NONE Enable Bitstream Encryption
BITSTREAM.ENCRYPTION.FAMILY_KEY_FILEPATH File Path String NONE Family Key File Input
BITSTREAM.ENCRYPTION.IV File Path String NONE Key Encryption Key (KEK) IV File Input
BITSTREAM.ENCRYPTION.KEYSRC NONE, EFUSE_RED_KEY, EFUSE_BLK_KEY, EFUSE_GRY_KEY, BH_GRY_KEY, BH_BLK_KEY NONE Encryption Key Source Selection
BITSTREAM.ENCRYPTION.PLMKEYFILE <string>.nky NONE PLM Partition AES NKY File Input
BITSTREAM.ENCRYPTION.PUF_HDFILE File Path String NONE PUF Helper Data Input File
BITSTREAM.ENCRYPTION.PUF_HDLOCATION <none/empty>, BOOTHEADER, HD_PDI <none/empty> PUF Helper Data Location
BITSTREAM.ENCRYPTION.RED_KEY_CLEAR DISABLE DISABLE, ENABLE Enable Red Key Clear after configuration
BITSTREAM.GENERAL.COMPRESS FALSE, TRUE FALSE Enable Bitstream Compression
BITSTREAM.GENERAL.CRC ENABLE, DISABLE ENABLE Enable Cyclic Redundancy Checking (CRC)
BITSTREAM.GENERAL.JTAG_SYSMON ENABLE, DISABLE, STATUSONLY ENABLE Enable JTAG Connection to SYSMON
BITSTREAM.GENERAL.PERFRAMECRC NO, YES NO Enable Single Frame Cyclic Redundancy Checking (CRC)
BITSTREAM.GENERAL.SYSMON_JTAG_DRP ENABLE ENABLE, DISABLE Enable SYSMON DRP Instruction in JTAG TAP
BITSTREAM.GENERAL.SYSMONPOWERDOWN ENABLE, DISABLE DISABLE Enable SYSMON Power Down
BITSTREAM.GENERAL.TIMESTAMP     Timestamp
BITSTREAM.POWER.CCU_CLK_FREQ 127 170, 127, 102, 85, 72, 63, 56, 51, 46, 42, 39, 36, 34 Set the CCU Clock Frequency after configuration completes
BITSTREAM.POWER.PMC_CLK_FREQ 255 255, 170, 127, 102, 85, 72, 63, 56, 51, 46, 42, 39, 36, 34 Set the PMC Clock Frequency after configuration completes
BITSTREAM.READBACK.ACTIVERECONFIG YES, NO NO Prevent the assertions of GHIGH and GSR during configuration
BITSTREAM.READBACK.ENABLE ENABLE ENABLE, DISABLE Enable READBACK
BITSTREAM.READBACK.ICAP_SELECT AUTO, TOP, BOTTOM AUTO Select between the top and bottom ICAP
BITSTREAM.REVOCATIONID.PARTITION <none/empty> or string representing hex numbers 0x00 through 0x59 none/empty Partition Revocation ID
BITSTREAM.REVOCATIONID.SPK <none/empty> or string representing hex numbers 0x00 through 0x59 none/empty SPK Revocation ID
BITSTREAM.SEU.ESSENTIALBITS NO, YES NO  
BITSTREAM.STARTUP.DONE_CYCLE 1, 2, 3, 4, 5, 6 4 Select the Startup phase that activates the DONE signal
BITSTREAM.STARTUP.GTS_CYCLE 1, 2, 3, 4, 5, 6, DONE, KEEP 5 Select the Startup phase that releases the internal tristate control to the I/O buffers
BITSTREAM.STARTUP.GWE_CYCLE 1, 2, 3, 4, 5, 6, DONE, KEEP 6 Select the Startup phase that asserts the internal write enable to components connected to the GWE signal
BITSTREAM.STARTUP.LCK_CYCLE 0, 1, 2, 3, 4, 5, 6, NOWAIT NOWAIT Select the Startup phase to wait until MMCMs/PLLs lock
BITSTREAM.STARTUP.MATCH_CYCLE 0, 1, 2, 3, 4, 5, 6, AUTO, NOWAIT AUTO Selects a delay in the Startup cycle until digitally controlled impedance (DCI) match signals are asserted