Documentation

Guided Host-Radio Hardware Setup

Before You Begin

To implement the features in this support package, you must establish communication between the host and the radio hardware.

For Windows® operating systems, an automatic hardware setup process is available. For Linux® operating systems or to complete the setup process manually, see Manual Host-Radio Hardware Setup.

Once the support package is installed, you can proceed directly to the hardware setup process. Alternatively, you can open it by following these steps:

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

  • In the Add-On Manager window, find the Communications System Toolbox™ Support Package for Xilinx® Zynq®-Based Radio, and click Setup.

    Note:   Because the setup process runs OS commands for configuring the network card, you must have administrator privileges for the guided radio hardware setup. Start MATLAB using Run as administrator.

The automatic hardware setup process guides you through several steps. If you have to cancel the setup process, you can open it again from the Add-On Manager window.

Step 1. Host and Hardware Setup Checklists

Complete these checklists to confirm that the host machine has the correct configuration, that you have the correct radio hardware, and that you have all required accessories.

Host Machine Checklist

  1. Administrator privileges. Because the software runs OS commands for configuring the network card, you must have administrator privileges for the guided radio hardware setup. If you see the User Account Control window, click Yes to continue with the setup process.

  2. Gigabit Ethernet connection (also referred to as network connection). You can use either an integrated network interface card (NIC) with a Gigabit Ethernet cable or a USB 3.0 Gigabit Ethernet adapter dongle. This connection is necessary for transmitting data from the host computer to the Zynq (for example, a programming file), and for sending and receiving signals to and from the board and radio.

    Make sure that your network connection is available before beginning. In Windows, go to Device Manager > Network adapters and look for the NIC or adapter dongle in the list of installed and available devices. If it is not there, contact the dongle manufacturer or use the OS to update the drivers.

  3. SD card reader. If the host machine does not have an integrated card reader, use an external USB SD card reader.

After you complete the host machine checklist, click Next.

Radio Hardware Checklist

  1. A supported Zynq-based radio development platform. Check the list of supported development platforms here: Hardware Support. Do not connect or turn on the Zynq board until you are prompted at a later step.

  2. Ethernet cable.

  3. Antennas or a loopback cable.

After you complete the radio hardware checklist, click Next.

Step 2. Select Hardware

  1. Choose your radio hardware from the list. For each configuration, the pane displays an image for the selected radio hardware. If you are unsure which radio hardware you have, use this image as a guidance.

  2. Click Next.

Step 3. Configure Network Connection on the Host Computer

  1. Select a network connection to connect with the radio hardware.

    The dialog pane displays a list of network connections on the host. Each network connection is noted as In Use or Available. A network connection is marked as In Use when the network connection is connected to a device and an IP address is assigned to it.

    If you do not see your network connection listed, click Refresh to trigger the network connection detection and repopulate the list. Refreshing the list is useful when, for example, you plug in a USB Ethernet adapter dongle after the list was open already.

    • If all the network connections listed are in use, free up a network connection for use with the radio hardware, and then click Refresh.

    • If the network connection list is empty, it is possible that VMWare software, if present, is interfering with network connection detection. Remove the VMWare to get an accurate list of network connections on your computer.

    • It is also possible that the network connections are disabled in the control panel. If they are, enable them.

    • If you are using the USB-to-Ethernet dongle (adapter), and you don't see it listed, try the following:

      • Make sure that Windows has installed it correctly. If you have any difficulty, in Windows, go to Device Manager > Network adapters. Make sure your dongle is in the list of installed and available devices. If it is not, contact the dongle manufacturer or use the OS to update the drivers.

      • If the dongle is listed in the Device Manager list, go back to the network connection configuration step and refresh the list. If the adapter still does not show, follow the manual steps to configure the network connection: Step 3. Configure Host Computer. When you finish, you can return to the hardware setup process and continue.

      Note:   Because the setup process runs OS commands for configuring the network card, you must have administrator privileges for the guided radio hardware setup. If you see the User Account Control window, click Yes to continue.

  2. Make any desired changes to the IP address (optional).

    The radio hardware requires a point-to-point Ethernet connection. This means that the host network connection must be on the same subnet as the radio hardware. To meet this requirement, a compatible IP address is selected automatically for the host network connection. The default IP address for the radio hardware is 192.168.3.2. If you have no other connected device with this IP address, you can leave the address as is.

  3. Click Next. The software configures the network connection.

Step 4. Select a Drive

The SD card image that comes with the support package includes the embedded software and the FPGA programming file necessary for using the radio hardware as an I/O peripheral.

If you do not need to download the SD card image, select Skip this step if your SD card is already configured with appropriate image for SDR hardware.

To download the SD card image:

  1. Insert a 4 GB or larger SD memory card into the memory card reader on the host computer to download the SD card image onto it.

  2. Select the appropriate drive from the list.

      Note:   If the automatic SD card configuration is not successful, you must complete this step manually. See Step 4. Load Firmware of the manual setup instructions. When you complete that step, return to this step and select Skip this step if your SD card is already configured with appropriate image for SDR hardware.

  3. Click Next.

Step 5. Write Firmware

    Note:   If you chose to skip downloading the image, this screen is not displayed.

  1. Unlock the SD card before downloading the firmware image to the card. Keep the card unlocked while the card is in the Zynq board card reader.

  2. Click Write to copy the programming file from the host computer to the SD card. The data on the memory card is erased during this process.

    Note:   If you must complete this step manually, see Step 4. Load Firmware of the manual setup instructions. When you complete that step, return to the previous step and select Skip this step if your SD card is already configured with appropriate image for SDR hardware.

Step 6. Set Jumpers on Zynq Radio Hardware

  1. Configure the jumpers on the Zynq development board to use it as an SDR device. These jumper settings make it so that the board restarts from the SD card. Make sure that the board is turned off.

    How you set the jumpers depends on the board you are using. See the following sections for the jumper settings on your specific radio hardware.

  2. After you set the jumper switches, click Next.

Set Jumper Positions ZC706 Board

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

Set Jumper Positions on ZedBoard

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

Set Jumper Positions on PicoZed

Switch S1 off to tell the PicoZed™ SDR SOM to boot from the SD card slot on the carrier board.

Step 7. Connect Hardware

Connect ZC706 Hardware

  1. Follow the instructions displayed on the screen to connect the RF card to the Zynq development board, to connect the board to the host computer, and to connect the antennas to the radio hardware. Specific connections for your board are shown.

  2. Turn the board power on.

  3. Wait until you see the LEDs indicating the readiness of the radio hardware. The LEDs are located near the power switches.

    • DONE (green, steady)

    • GPIO-C (green, blinking)

    If the LEDs do not light up as indicated after waiting one minute, press PS-POR push button to reset and restart the board

  4. Click Next. The software verifies the radio hardware connection.

Connect ZedBoard Hardware

  1. Follow the instructions displayed on the screen to connect the RF card to the Zynq development board, to connect the board to the host computer, and to connect the antennas to the radio hardware. Specific connections for your board are shown.

  2. Turn the board power on.

  3. Wait until you see the LEDs indicating the readiness of the radio hardware. The LEDs are located near the DIP switches.

    • LD12-DONE (blue, steady)

    • LD0 (red, blinking)

    If the LEDs do not light up as indicated after waiting one minute, press PS-RST push button to reset and restart the board.

  4. Click Next. The software verifies the radio hardware connection.

Connect PicoZed SDR Hardware

  1. Follow the instructions displayed on the screen to connect the hardware to the host computer and to connect the antennas to the radio hardware.

    For PicoZed SDR hardware, the mapping of port numbers to antennas is as follows.

    PortAntenna
    J8Tx1
    J10Tx2
    J4Rx1
    J6Rx2

  2. Turn the board power on.

  3. Wait until you see the following LEDs (near the DIP switches) indicating the readiness of the radio hardware.

    • CFG-DONE (blue, steady)

    • DS3-GPIO0 (red, blinking)

    If the LED does not light up as indicated after waiting one minute, press CARRIER RESET push button to reset and restart the board

  4. Click Next. The setup process verifies the radio hardware connection.

Step 8. Verify Connection

The next pane displays the results of verification testing and the actions you can perform to fix any failures. The board must be started properly before you can verify the setup. If you have not waited until the board is ready (see the previous step), then you see failures.

  • If the verification is not successful, you see a failure message. This example message is for ZC706/ZedBoard™, and the PicoZed SDR board shows a similar message.

    Follow the instructions in the message to diagnose and resolve any connection problems.

    If you still get an error you cannot resolve, see Common Problems and Fixes.

  • If the verification is successful, you see a success message. This example message is for ZC706/ZedBoard, and the PicoZed SDR board shows a similar message.

    Additional setup steps for targeting:

    • To generate code for the FPGA portion of the Zynq radio hardware, you must install HDL Coder™ Support Package for Xilinx Zynq-7000 Platform (requires HDL Coder).

    • To generate code for the ARM® portion of the Zynq radio hardware, you must install additional software and carry out additional setup. See Step 9. Setup for ARM Targeting.

    Otherwise, get started with your first example. Click Run Example to run an SDR example in MATLAB. It can take several minutes to initialize System objects, hardware, and to retrieve data off the hardware. The example can appear to be frozen at times, however, the example is still running. This example shows you plots of the received signal in the time and frequency domains, and a constellation diagram plotting the signal in the complex plane.

    Click Open Example to open only the description about this SDR example. This description contains snapshots of the plots demonstrated in the example.

    For more guidance, see What to Do After Installation.

Step 9. Setup for ARM Targeting

You only need to perform this step if you plan to generate embedded ARM code targeted for the Zynq radio hardware. You must install third-party software and additional support packages. Follow the instructions in Installation for Hardware-Software Co-Design.

Related Topics

Was this topic helpful?