Main Content

Guided SD Card Setup

To use an Ethernet connection to a target board, you must set up the SD card for the board with the MathWorks® firmware image. After the support package installation is complete, the installer guides you through downloading the firmware image and establishing an Ethernet connection to the hardware.


Before starting the hardware setup, install HDL Coder™ Support Package for Xilinx® RFSoC Devices.

Start Hardware Setup

If the support package is already installed, you can start the hardware setup by opening the Add-On Manager. On the MATLAB® Toolstrip, click Add-Ons and select Manage Add-Ons.

Add-Ons on MATLAB Toolstrip

In the Add-On Manager, start the hardware setup process by clicking the Gear button, Gear button.

As part of the hardware setup, you can:

  • Specify which board you are using.

  • Configure the network card in the host machine.

  • Write firmware for the board to an SD card.

  • Configure your board to start from the SD card.

  • Connect your hardware to the host machine.

  • Verify the connection between the host and the hardware.

Because the software runs operating system (OS) commands for configuring the network card, you might need to have administrator privileges for the guided hardware setup. In this case, start MATLAB using Run as administrator.

Select Hardware Board

Select your hardware from the Hardware Board list.

Select a Hardware Board

Click Next.

Configure Network Card on Host Computer

  1. Select the network interface card (NIC) that you want to connect with the hardware.

    The list displays the connected network interface cards that are detected on your computer. The menu options note each NIC as (In Use) or (Available). When an NIC is connected to a device and an IP address is assigned to it, the installer marks the NIC as (In Use).

    Configure network card on the host computer

    If you do not see your NIC listed, click Refresh to trigger the NIC detection and refresh the list. Refreshing the list is useful when, for example, you plug in a USB Ethernet adapter dongle while viewing this pane.

    • If all of the listed NICs are in use, free up a NIC for use with the hardware, and then click Refresh.

    • If the NIC list is empty, VMWare software (if present) might be interfering with NIC detection. To get an accurate list of NICs on your computer, remove the VMWare.

    • Check if the missing NIC is disabled in the control panel. If the NIC is disabled, enable it.

  2. Optionally, specify an IP address for your board.

  3. If you have already configured the NIC, select Skip this step if your network card is already configured for communicating with Zynq hardware.

  4. Click Next. The software configures the NIC.

Select Drive Containing SD Card

The installer must write a firmware image to an SD card. This firmware image is included with the support package. The image includes the embedded software and the FPGA programming file for using the hardware as an input/output (I/O) peripheral. The location of the SD drive containing the card is selected.

Before downloading the firmware image to the card, unlock the SD card. Keep the card unlocked while the card is in the Zynq® board card reader.

Insert a 4 GB or larger SD memory card into the memory card reader on the host computer. The card must be formatted with the FAT32 format. Select the appropriate drive from the list.

Select a Drive

Click Next.

Write Firmware to SD Card

To copy the programming file from the host computer to the SD card, click Write. Any existing data on the memory card is erased during this process.

Write Firmware

When the write is complete, click Next.

Set Jumper Switches and Connect Hardware

Configure the jumpers on the Zynq development board so that you can use it as a peripheral device. These jumper settings ensure that the board starts from the SD card. Make sure that the board is turned off.

The jumper settings are different for each board.

Set Jumpers on ZCU111

This table and figure show the SW6 switch positions.

SW6 Switch Positions

SwitchSwitch Position

SW6 switch positions

Set Jumpers on ZCU216

This table and figure show the SW2 switch positions.

SW2 Switch Positions

SwitchSwitch Position

SW2 switch positions

Connect Hardware

  1. After you have set up the board, follow the instructions for connecting the target hardware.

    For more information, see Xilinx Zynq UltraScale+ RFSoC ZCU111 Evaluation Kit and Xilinx Zynq UltraScale+ RFSoC ZCU216 Evaluation Kit.

  2. After the LEDs indicate the readiness of the hardware, wait an additional 20 seconds for the board to boot its OS and set up communication with the host machine.

    Board displays a green steady light. If the LEDs do not light up green after one minute, press the reset switch and restart the board.

  3. Click Next. The software verifies the hardware connection.

Verify Connection to Xilinx Zynq Hardware

Click Verify, and then click Next. After you verify the connection, you see a message indicating that the hardware setup is complete.

Hardware Setup

Check Connectivity

With the USB-serial and Ethernet cable plugged in, check the connectivity by using the zynqrfsocnetwork object in MATLAB.

Create a zynqrfsocnetwork object.

z = zynqrfsocnetwork
z = 
  zynqrfsocnetwork with properties:
    IPAddress: ''

Check the connectivity.

 'Connection successful'

If the connection is unsuccessful, debug further to determine why a failure exists. To troubleshoot the connection to your target board, see "Troubleshooting" in Setup and Configuration.

If you changed the default IP address of the SD card, specify the new IP address.

z.IPAddress =

Related Topics