Main Content

Install Support for Xilinx Devices

You can use the SoC Blockset™ with Xilinx® devices by installing SoC Blockset Support Package for Xilinx Devices. Specifically, this support package enables you to work with the Linux® environment on the embedded ARM® processor, FPGA, and memory on Xilinx devices.

Install, Update, or Uninstall Support Package

Install Support Package

  1. On the MATLAB® Home tab, in the Environment section, select Add-Ons > Get Hardware Support Packages.

  2. In the Add-On Explorer window, click the support package and then click Install.

Update Support Package

On the MATLAB Home tab, in the Resources section, select Help > Check for Updates.

Uninstall Support Package

  1. On the MATLAB Home tab, in the Environment section, click Add-Ons > Manage Add-Ons.

  2. In the Add-On Manager window, find and click the support package, and then click Uninstall.

Hardware Setup

Before you can use the features in the SoC Blockset Support Package for Xilinx Devices, you must establish communication between the host and the hardware board. After the installer completes the support package installation, it guides you through establishing communication with the hardware board.

If the support package is already installed, you can start the hardware setup by opening the Add-On Manager.

On the MATLAB tool bar, from the Add-Ons menu, select Manage Add-Ons.

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

Follow the instructions on each page of the Hardware Setup window. When the hardware setup process completes, you can open the examples to get familiar with the product and its features.

The setup process includes these steps:

  • Download and install the third-party tools required for the SoC Blockset Support Package for Xilinx Devices.

  • Install a customized version of embedded operating system (OS) image on the hardware board.

  • Specify which hardware board you are using.

  • Configure the network interface card in the host computer (for Zynq® SoC boards only).

  • Write firmware for the hardware board to an SD card (for Zynq SoC boards only).

  • Configure your hardware board to start up from the SD card (for Zynq SoC boards only).

  • Connect your hardware board to the host computer.

  • Verify the connection between host and hardware board (for Zynq SoC boards only).

Notes

  • The host computer can be a desktop or a laptop. It must have at least one dedicated Gigabit Ethernet network interface card (NIC) for connecting to the hardware.

  • These instructions assume that you are installing the support package on only one computer and have only one NIC.

  • You can use a USB3 to Gigabit Ethernet LAN adapter instead of a NIC. The instructions are the same.

  • Do not connect or turn on the board until you are prompted.

  • Turn off antivirus, firewall, or other port-blocking software. It can interfere with communication to the Zynq hardware.

  • Because the software runs OS commands for configuring the NIC, you might require administrator privileges for the hardware setup. Start MATLAB using Run as administrator.

  • If you are running utility software to configure the network (typically done on laptops), exit or uninstall the software. This type of software can interfere with the network configuration required to perform this setup.

Download and Install Third-Party Tools

The guided setup wizard displays the list of the third-party tools required for the SoC Blockset Support Package for Xilinx Devices. In the guided setup, click Install to automatically install the required tools.

Third-party tools installation step in setup.

Select Embedded OS Image

This step installs a customized version of the embedded OS image on the hardware board. You can either install a new MathWorks® firmware image or update an existing firmware image.

Install the new MathWorks firmware image to use MathWorks embedded OS firmware image with your hardware board. This options removes any existing software from the SD or MMC card.

Embedded OS image selection step in setup. Option to install new firmware image.

Update your existing firmware image to use your own embedded image. This option opens the OS Customizer tool. Use this tool to update the embedded OS image running on the hardware board with the required software for use with MATLAB or Simulink®.

Embedded OS image selection step in setup. Option to update an existing firmware image.

Select Hardware Board

Choose your hardware board from the list. For the full list of supported boards, see Supported Xilinx Devices.

Hardware selection step in setup.

Select Network Configuration

This step is required only when you select a Zynq SoC board.

This step configures the host computer so that it can communicate with the hardware board.

Connect to LAN or home network.  This option applies the dynamic network settings provided by a dynamic host configuration protocol (DHCP) service on the network.

Network configuration step on host computer. Option to connect to LAN or home network.

Connect directly to development computer.  This option applies the static network settings based on the network settings of the host computer.

Network configuration step on host computer. Option to connect directly to host computer.

Manually enter network settings.  This option allows you to manually enter the network settings.

Network configuration step on host computer. Option to manually enter the network settings.

Select a Drive and Load Firmware

This step is required only when you select a Zynq SoC board.

The installer writes a firmware image to the 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 I/O peripheral.

This step selects the location of the SD drive containing the card. Before downloading the firmware image to the card, unlock the SD card. Keep the card unlocked while the card is in the card reader of the hardware board.

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

Select drive containing SD card.

Write Firmware to SD Card

This step is required only when you select a Zynq SoC board.

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 the firmware to the SD card.

Set Jumper Switches

This step is required only when you select a Zynq SoC board.

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

The jumper settings are different for each board.

SW11 Jumper Positions on ZC706.  Use these jumper settings for the ZC706 board. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Down
2Down
3Up
4Up
5Down

SW11 switch and pin positions on the ZC706 board

Jumper Positions on ZedBoard.  Use these jumper settings for the ZedBoard™. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Down
2Up
3Up
4Down
5Down

Jumper positions on the ZedBoard

SW6 Switch Positions on ZCU102.  Use these jumper settings for the ZCU102 board. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Up
2Down
3Down
4Down

SW6 switch positions on the ZCU102 board

SW6 Switch Positions on ZCU111.  Use these jumper settings for the ZCU111 board. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Up
2Down
3Down
4Down

SW6 switch positions on the ZCU111 board

SW2 Switch Positions on ZCU216.  Use these jumper settings for the ZCU216 board. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Up
2Down
3Down
4Down

SW6 switch positions on the ZCU216 board

SW2 Switch Positions on ZCU208.  Use these jumper settings for the ZCU208 board. To learn more about the settings, see the board documentation.

SwitchSwitch Position
1Up
2Down
3Down
4Down

SW6 switch positions on the ZCU208 board

Connect Hardware

After you have set up the board, follow the instructions for connecting the hardware board. These steps are labeled in the pictures of each board. Wait until you see the LEDs indicating the readiness of the hardware board. Then, wait an additional 20 s for the board to boot its operating system and set up communication with the host machine. You see a green steady light. If the LEDs do not light up as indicated after one minute, press the reset switch and restart the board.

Connect ZC706, ZedBoard, or ZCU102 Board

  1. Remove the SD card from the host computer and insert it into the hardware board.

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

  3. Connect a USB cable between the USB-UART port on the hardware board and the host computer.

  4. Connect an Ethernet cable to the hardware board.

  5. (Optional) Connect a USB cable between the JTAG port on the hardware board and the host computer.

  6. Connect the power cable and turn on the power.

Connect ZC706 Board

ZC706 hardware connections

Connect ZedBoard

ZedBoard hardware connections

Connect ZCU102 Board

ZCU102 hardware connections

Connect ZCU111, ZCU216, or ZCU208 Board

  1. Remove the SD card from the host computer and insert it into the hardware board.

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

  3. Connect a USB cable to the hardware board.

  4. Connect an Ethernet cable to the hardware board.

  5. Connect the power cable and turn on the power.

Connect ZCU111 Board

ZCU111 hardware connections

Connect ZCU216 or ZCU208 Board

ZCU216 or ZCU208 hardware connections

Connect Standalone FPGA Boards

  1. Connect the power cable and turn on the power.

  2. Connect a JTAG download cable to the board.

Connect Arty Board

Arty hardware connections

Connect KC705 Board

KC705 hardware connections

Verify Setup

This step is required only when you select a Zynq SoC board.

The guided setup runs a small example to test the hardware connection. Before running the example, ensure that the board is turned on.

Verify configuration of your Zynq board

If the connection is not successful, the most common reasons are that the board is not connected properly or it is not turned on. Check the cable connections and power switch and try again.

Open Examples

When the installer completes your hardware setup, you can either exit the installer or open the examples to get started.

Hardware setup complete, open the examples.