Importing a Hardware Configuration - 2024.2 English - UG1144

The steps to import hardware configuration are as follows:

1. Change into the directory of your PetaLinux project.

   cd <plnx-proj-root>

2. Import the hardware description with petalinux-config command using the following steps:
   • Using path of the directory containing the .xsa file:

     petalinux-config --get-hw-description /<PATH-TO-SDT Directory>

   Or
   • Using the file path as follows for XSCT flows:

     When multiple XSA files in a specified folder, petalinux-config gives you an error. To avoid these kind of errors, you can provide complete XSA file path as follows:

     petalinux-config --get-hw-description <PATH-TO-XSA-FILE>

     Note: Changing the XSA file in the <PATH-TO-XSA directory> later gives an INFO: Seems like your hardware design:<PATH-TO-XSA Directory>/system.xsa has changed warning for all subsequent executions of the petalinux-config/petalinux-build commands. This means that your XSA has changed. To use the latest XSA, run petalinux-config --get-hw-description again.
3. This launches the top system configuration menu. When the petalinux-config --get-hw-description command runs for the PetaLinux project, the tool detects the changes in the imported hardware design and launches the menu.

Ensure DTG Settings > (template) MACHINE_NAME is selected and use the option as follows:

• Keep the BSP setting as AUTO when using an AMD evaluation board with the default BSP/hardware project. The DTG machine configuration is automatically determined based on your specific design.
• For the custom board, keep the default value.
• For customized hardware design implemented on an AMD evaluation board, use the values in the following table.

Ensure Subsystem AUTO Hardware Settings is selected, and go to the menu which is similar to the following:

The Subsystem AUTO Hardware Settings → menu allows customizing system-wide hardware settings. You can to select the processor, memory bank, serial console, or flash.

This step can take a few minutes to complete because the tool parses the hardware description file for hardware information required to update the device tree, PetaLinux U-Boot configuration files (only for MicroBlaze), and the kernel config files (only for MicroBlaze) based on the “Auto Config Settings --->” and “Subsystem AUTO Hardware Settings --->” settings.