Set Up Custom Boards Using the Hardware Setup Add-On

Since R2026a

You can use the Hardware Setup add-on to configure custom boards, including Zynq^® UltraScale+™ MPSoC boards, Kria boards, ZYBO™ boards, and more. When you select the hardware board in Hardware Setup add-on, these boards are not listed in the Hardware Board option. To use hardware setup process for these custom boards, set the Hardware Board to Custom Board.

Using the hardware setup process for custom boards, you:

• Download and install the required third-party tools for your board.

• Establish an Ethernet connection to the hardware.

• Load the MathWorks^® firmware image onto an SD card.

Requirements

To use the Hardware Setup for custom boards, you must:

• Install the HDL Coder™ Support Package for AMD FPGA and SoC Devices.

• Build a compatible Linux image of your hardware board. For more information on how to build a Linux image, see Build Custom Linux Image for IP Core. You can also build a Linux image for the hardware boards by using MathWorks Build System or MathWorks PetaLinux System.

Supported Hardware Boards

You can use these hardware boards and AMD device families as custom boards.

The supported hardware boards include:

• ZYBO Boards

• Kria Boards

• Zynq UltraScale+ MPSoC ZCU104 Board

Additionally, hardware boards in these AMD device families are supported:

• Zynq

• Zynq UltraScale™

• Versal^®

For more information on the supported AMD^® hardware boards, see Supported EDA Tools and Hardware.

Configure Custom Hardware Board

To set up your custom hardware board by using Hardware Setup add-on, follow these steps:

1. Launch the HDL Coder Hardware Setup add-on by using hdlHardwareSetup function. You can also launch the add-on from the HDL Coder tab on the toolstrip or from the Add-ons panel in MATLAB^®. For more information, see Guided Hardware Setup for AMD Boards.

   hdlHardwareSetup

   The hardware setup process runs the operation system command to access the network card and establish a network connect. If the add-on requests user access, allow it access.

   

2. In the Select a Hardware Board step, set the FPGA Vendor to AMD (Xilinx). Set the Hardware Board to Custom Board. Click Next.

   

3. In the Select Device Family step, set Device Family to the device family of your hardware board. For the list of supported device families, see Supported Hardware Boards. Set Choose Linux Image to MathWorks-Compatible Linux Image. Click Next.

   

4. In the Choose Download Mode for Third-party Tools step, download the required third-party tools for the custom board. Select Automatic or Manual to automatically or manually download the files, respectively. For more information, see Download Required Third-Party Tools.

   

   

5. In the Configure Network Card on the Host Computer step, select the network interface card (NIC) that you want to connect with the hardware. You can also specify an IP address for your board in the Set Network Configuration section.

   

6. In the Select a Drive step, select the location of the drive that contains the SD card. Click Next.

7. In the Write Firmware step, specify the path of the Linux image of the custom board.

   To write the firmware to the SD card, click Write. After the process completes, click Next.

   

8. After the hardware setup process completes, connect the SD card to the hardware board and setup the hardware connection to boot hardware board from the SD card. You can verify your hardware connection in the Verify Configuration of Your AMD Hardware Board step.