主要内容

Set Up Custom Boards Using the Hardware Setup

R2026b
Since R2026a

You can use the Hardware Setup 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:

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 Third-Party 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 (HDL Coder) 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 Set Up AMD FPGA and SoC Devices.

    hdlHardwareSetup

  2. In the Select a Hardware Board step, set the FPGA Vendor to AMD (Xilinx) and Workflow to All, Deep Learning or IP Core Generation. Set the Hardware Board to Custom Board. Click Next.

    Select hardware board

  3. In the Select an Interface step, select the ethernet interface. Click Next.

    Select an interface

  4. 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.

    Select device family

  5. 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.

    Select download mode for third-party tools

    Download Third-Party Tools

  6. In the Register Sysroot for Software Targeting step, you register the Linux root file system (sysroot) for the target AMD board. The sysroot provides the libraries, header files, and binaries required to cross‑compile, deploy, and run generated code on the target hardware. You must register a sysroot when using cross‑development workflows, such as those that use Yocto, Buildroot, or PetaLinux.

    This step is required when you installed third-party tools for software targeting in the Download and Install Third-Party Tools step.

    Select the Linux image type that matches the root file system installed on the target device:

    • MathWorks compatible Buildroot 64-bit — Select this option when the target device is running a 64‑bit Buildroot image.

    • MathWorks compatible PetaLinux 64‑bit — Select this option when the target device is running a 64‑bit PetaLinux image.

    If you do not want to register a sysroot, select the Skip this step if you do not want to register sysroot check box and click Next. You can register the sysroot later by using the Hardware Setup tool.

    Register the Root Filesystem

  7. 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.

    Configure network card on the host computer

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

  9. 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.

    Write firmware

  10. In the Connect AMD Hardware Board step, follow the instructions to connect the SD card to the hardware board and setup the hardware connection to boot hardware board from the SD card.

    Connect AMD Hardware Board

  11. You can verify your hardware connection in the Verify Configuration of Your AMD Hardware Board step. Click Verify.

    Verify configuration on AMD Hardware

  12. When the Hardware Setup completes, you can open the examples to get familiar with the product and its features. Click Open Example to launch example in MATLAB which shows how to deploy a bitstream into the hardware.

See Also

(HDL Coder)

Topics

External Websites