X<DUT>_LookupConfig - X<DUT>_LookupConfig - 2026.1 English

X<DUT>_LookupConfig - X<DUT>_LookupConfig - 2026.1 English - UG1399

Vitis High-Level Synthesis User Guide (UG1399)

Document_ID

UG1399

Release_Date

2026-09-11

Version

2026.1 English

Syntax

X<DUT>_Config* X<DUT>_LookupConfig(uintptr BaseAddress);
X<DUT>_Config* X<DUT>_LookupConfig(u16 DeviceId);

Description

This function is used to obtain the configuration information of the specified BaseAddress or DeviceID . Where:

BaseAddress: The BaseAddress as defined in xparameters.h .
DeviceId: Device ID as defined in xparameters.h .

Note: The DeviceId is no longer populated into the driver config struct. Instead the BaseAddress is used to identify the driver instance. The DeviceId is also not be populated in the xparameters.h file. Software applications using these drivers developed in the classic AMD Vitis™ or Vitis HLS tools needs to be updated to reflect this change using #ifdef SDT as shown in the following example:

#ifndef SDT
#define GPIO_EXAMPLE_DEVICE_ID  XPAR_GPIO_0_DEVICE_ID
#else
#define	XGPIO_AXI_BASEADDRESS	XPAR_XGPIO_0_BASEADDR
#endif

Return

A pointer to a X<DUT>_LookupConfig variable that holds the configuration information of the specified BaseAddress or device whose ID is DeviceId . Returns NULL if no match is found.