downloadImage

Download SD card image or bitstream file

Syntax

downloadImage(dev)
downloadImage(devAD936x,'BoardName',devAD936xDeviceName)
downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName)
downloadImage(devAD936x,'BoardName',devAD936xDeviceName,'IPAddress',IPAddress)
downloadImage(devAD936x,'BoardName',devAD936xDeviceName,'IPAddress',IPAddress,Name,Value)
downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName,'IPAddress',IPAddress)
downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName,'IPAddress',IPAddress,Name,Value)
downloadImage(___,'SDCardLocation',SDCardLocation)
downloadImage(___,'SDCardImage',SDCardImage)
downloadImage(___,'SDCardImage',SDCardImage,'SDCardLocation',SDCardLocation)
downloadImage(___,'FPGAImage',FPGAImage)

Description

downloadImage(dev) downloads the default SD card image onto the SD card inserted into the reader of the radio hardware specified by dev. The board restarts with the new image.

example

downloadImage(devAD936x,'BoardName',devAD936xDeviceName) downloads the default SD card image onto the SD card inserted into the reader of the radio hardware associated with the radio object devAD936x. Specify the name of the radio hardware by devAD936xDeviceName. The board restarts with the new image.

downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName) downloads the default SD card image onto the SD card inserted into the reader of the radio hardware associated with the radio object devFMCOMMS5. Specify the name of the radio hardware by devFMCOMMS5DeviceName. The board restarts with the new image.

downloadImage(devAD936x,'BoardName',devAD936xDeviceName,'IPAddress',IPAddress) updates the default SD card image with the specified IP address and downloads the image onto the SD card inserted into the reader of the radio hardware. The board restarts with the new image. The function also updates the IPAddress property of the devAD936x radio object accordingly.

downloadImage(devAD936x,'BoardName',devAD936xDeviceName,'IPAddress',IPAddress,Name,Value) uses additional options specified by one or more name-value pair arguments. Use these options to change the subnet mask and gateway of the updated IP address in the downloaded SD card image. The board restarts with the new image. The function also updates the IPAddress property of the devAD936x radio object accordingly.

downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName,'IPAddress',IPAddress) updates the default SD card image with the specified IP address and downloads the image onto the SD card inserted into the reader of the radio hardware. The board restarts with the new image. The function also updates the IPAddress property of the devFMCOMMS5 radio object accordingly.

downloadImage(devFMCOMMS5,'BoardName',devFMCOMMS5DeviceName,'IPAddress',IPAddress,Name,Value) uses additional options specified by one or more name-value pair arguments. Use these options to change the subnet mask and gateway of the updated IP address in the downloaded SD card image. The board restarts with the new image. The function also updates the IPAddress property of the devFMCOMMS5 radio object accordingly.

example

downloadImage(___,'SDCardLocation',SDCardLocation) downloads the SD card image onto the SD card inserted into the SD card reader on the host computer specified by SDCardLocation. Use this name-value pair in addition to the input arguments in any of the first seven syntax descriptions. After the image is downloaded, insert the SD card into the reader of the specified radio hardware and restart the board.

downloadImage(___,'SDCardImage',SDCardImage) downloads a custom SD card image onto the SD card inserted into the reader of the radio hardware. Use this name-value pair in addition to the input arguments in any of the first three syntax descriptions. The board restarts with the new image.

downloadImage(___,'SDCardImage',SDCardImage,'SDCardLocation',SDCardLocation) downloads a custom SD card image onto the SD card inserted into the specified SD card reader of the host computer. After the image is downloaded, insert the SD card into the reader of the specified radio hardware and restart the board. Use these name-value pairs in addition to the input arguments in any of the first three syntax descriptions.

downloadImage(___,'FPGAImage',FPGAImage) downloads the bitstream specified by FPGAImage onto the SD card inserted into the reader of the specified radio hardware. Use this name-value pair in addition to the input arguments in any of the first three syntax descriptions. The board restarts with the new image and the bitstream is downloaded to the radio hardware.

Note

To download the SD card image onto the SD card inserted into the reader of the radio hardware, an Ethernet connection must be present between the host and the radio hardware.

Examples

collapse all

  1. Connect the radio hardware to the host over an Ethernet cable.

  2. Insert an SD card into the card reader on the radio hardware.

  3. Create a radio object. Download the default SD card image onto the SD card by using the object and the device name.

    dev = sdrdev('AD936x');
    downloadImage(dev,'BoardName','ADI RF SOM');
    ## Loading SD card image.
    ## Rebooting board.
    ## Reboot complete.
  1. Insert an SD card into the SD card reader on the host computer.

  2. Create radio object. Download the default SD card image onto the SD card by using the object, the device name, and by specifying the drive name of the SD card reader.

    dev = sdrdev('AD936x');
    downloadImage(dev,'BoardName','ADI RF SOM','SDCardLocation','Z:')

Input Arguments

collapse all

Interface to radio hardware, specified as one of the following objects:

To create these objects, use the sdrdev function.

Interface to AD936x-based Zynq radio hardware, specified as a comm.SDRDevAD936x radio object. To create this object, use the sdrdev function.

Name of AD936x-based Zynq radio hardware, specified as a character vector. Valid character vectors include:

  • 'ADI RF SOM'

  • 'ZC706 and FMCOMMS2/3/4'

  • 'ZedBoard and FMCOMMS2/3/4'

  • 'ZCU102 and FMCOMMS2/3/4'

Interface to FMCOMMS5 Zynq radio hardware, specified as a comm.SDRDevFMCOMMS5 radio object. To create this object, use the sdrdev function.

Name of FMCOMMS5 Zynq radio hardware, specified as 'ZC706 and FMCOMMS5'.

IP address of the radio hardware, specified as a dotted-quad character vector.

Drive name of the SD card reader on the host, specified as a character vector.

Example: 'SDCardLocation','Z:'

Folder location of a custom SD card image, specified as a character vector. To generate a custom SD card image, see FPGA Targeting Workflow.

Example: 'SDCardImage','C:\mywork\hdl_prj\sdr_prj\sdcard_image'

Bitstream file specified as 'Default' or a character vector containing the extension .bit. When you specify 'Default', the default bitstream is downloaded onto the SD card. Otherwise, you can download a custom bitstream. To generate custom bitstreams, see Step 7. Generate FPGA Bitstream and Program Zynq Hardware of the hardware-software co-design workflow.

Example: 'FPGAImage','C:\mywork\hdl_bitstreams\system_wrapper.bit'

Name-Value Pair Arguments

Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

Example: 'SubnetMask','/23','Gateway','192.168.2.1' specifies updated subnet mask and gateway for the new IP address of the radio hardware.

New subnet mask, specified as the comma-separated pair consisting of 'SubnetMask' and a character vector using the CIDR format.

Example: 'SubnetMask','/23'

New gateway, specified as the comma-separated pair consisting of 'Gateway' and a dotted-quad character vector.

Example: 'Gateway','192.168.2.1'

Introduced in R2014b