Main Content

Guided Hardware Setup

You can use the Hardware Setup add-on to configure your target Intel® hardware board for the hardware-software co-design workflow. To set up the board, you load the MathWorks® firmware image onto an SD card, then use the Hardware Setup Add-On to configure the board, establish an Ethernet connection to the hardware, and set the hardware connections.

Prerequisites

Before starting the hardware setup, install the HDL Coder™ Support Package for Intel FPGA and SoC Devices. See Download and Install HDL Coder Support Package for Intel FPGA and SoC Devices.

Open the Hardware Setup Add-On

Start the hardware setup by opening the Add-On Manager. Select Add-Ons > Manage Add-Ons.

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

Because the software runs operating system (OS) commands for configuring the network card, you might require administrator privileges for the guided hardware setup. If that is the case, start MATLAB® using Run as administrator.

Hardware Setup Workflow

To configure your SD card and hardware board, follow the instructions in each step of the Hardware Setup add-on.

Host Machine Checklist

Because the software runs operating system commands to configure the network card, you may require administrator privileges to complete the hardware setup. To continue the setup process, provide your user permission when the User Account Control window opens. You can also start MATLAB using Run as administrator. In Linux® machines, provide the user administrator password when required.

This step also checks available Gigabit Ethernet connection, SD card reader, and writable SD card. Click Next to proceed.

Host Machine Checklist Screen

Select Hardware Board

Choose your hardware from the list. The page displays your selected hardware. For more information on the supported hardware, see Supported EDA Tools and Hardware. Click Next.

Select Hardware Screen

Download Required Third-Party Tools

You can automatically or manually download and install third-party tools for your board.

Choose Download Mode for Third-Party Tools Window that has Automatic or Manual options

When you select Automatic, the wizard downloads and installs the necessary third-party tools from the internet to your host computer, which must have internet connectivity. After installation completes, the third-party tools are available in the folder support_package_installation_folder/3P.instrset/. To get to the root folder of support packages, use the matlabshared.supportpkg.getSupportPackageRoot function.

Automatic Download screen that list the required third-party tools

For host computers without internet access, you can select Manual to manually download the third-party tools. The wizard provides step-by-step instructions for downloading the required third-party tools. Use another computer with internet access to download these tools and then transfer them on your host computer. After transferring the required third-party tools to the host computer, specify the folder path that contains third-party tools and click Next.

Manual Download screen

Install Intel SoC Embedded Design Suite

To deploy and run the Linux ARM® applications on the Intel SoC hardware, download the Intel SoC FPGA Embedded Development Suite (EDS). Click Download link to download the Intel SoC FPGA Embedded Development Suite software. Select software version 17.0, which is the current supported version for this support package.

Install Intel SoC FPGA EDS Tools screen

If you do not want to install EDS tool, you can skip this step and proceed Next.

After the software download completes, click Next. In the Validate Intel SoC FPGA EDS Tools step, provide the installation folder path of the Intel SoC FPGA Embedded Development Suite tool and click Next.

Validate Intel SoC FPGA Tools Screen

Configure Network Card on Host Computer

  1. Select the network interface card (NIC) that you want to connect with the hardware. If you have already configured the NIC, select Skip this step if your network card is already configured for communicating with Intel SoC hardware. If you do not see your NIC, click Refresh.

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

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

    • If the NIC list is empty, it is possible that the VMWare software, if present, is interfering with NIC detection. To get an accurate list of NICs on your computer, remove the VMWare. Alternatively, check if the missing NIC is disabled in the control panel. If it is disabled, enable it.

  2. Optionally, specify an IP address for your board. Click Next. The software configures the NIC.

Network card configuration step on host computer.

Select Drive Containing SD Card

In the next step, the Hardware Setup add-on 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 that contains 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 target board.

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

Select a Drive

If your host computer does not have access to an SD card reader, you can still copy the firmware image to your SD card using a guest computer that has the HDL Coder Support Package for Intel FPGA and SoC Devices, along with the required third-party tools installed.

To copy the SD card image from the guest computer, locate the ../3P.instrset/alterasoclinuxbinaries.instrset folder on the guest computer. If you have downloaded the required third-party tool using automatic download mode, the folder is available in thesupport_package_installation_folder/3P.instrset/. In the alterasoclinuxbinaries.instrset, look for the SD card image (a zip folder) for the respective board, extract the contents of the zip folder, and then copy these contents to your SD card. To get to the root folder of support packages, use the matlabshared.supportpkg.getSupportPackageRoot function.

If your SD card already has an appropriate MathWorks Linux image to configure the hardware, you can skip this step by selecting Skip this step if your SD card is already configured with appropriate MathWorks Linux Image for Intel hardware check box. When you select this check box, the Hardware Setup add-on skips the Write Firmware step and proceeds to the Set Jumper and Switch Setting for Boards step.

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. When the write is complete, click Next.

Write the firmware to the SD card.

Set Jumper Switches for Hardware Board

Configure the jumpers switches on the selected hardware board so that you can use it as a peripheral device. The jumper settings are different for each board. This step guides you to use appropriate setting for development boards so that the board starts up from the SD card. When you set the jumper switch settings, make sure that the board is off.

For example, use these switch settings for the Arria® 10 Development Board.

Jumper Settings for Arria 10 Board

Connect the Hardware Board

Follow the instructions to connect the target hardware. Wait until the LEDs indicate the readiness of the hardware. Then, wait an additional 20 seconds for the board to boot its operating system and set up communication with the host machine. The LEDs display a green, steady light when the board is ready. If the LEDs do not light up after one minute, press the reset switch and restart the board. Click Next. The software verifies the hardware connection.

Connection for Hardware Boards

Verify Connection of Hardware Board

To verify the connection between the hardware board and your computer, click the Verify button and then click Next. After you verify the connection, you see a message that the hardware setup is complete.

You can skip this step if the connections to your board and development computer is already verified.

Verify Configuration of Hardware Board

Launch Example

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

Launch Example

Related Topics