Main Content

loadBitstream

Load custom FPGA bitstream and corresponding DTB file to target SoC device

Since R2020a

Description

loadBitstream(BoardName,FPGAImage,DeviceTree) loads the custom FPGA bitstream and corresponding device tree blob (DTB) file of the specified board to the targeted SoC device by using an Ethernet or USB Ethernet connection.

Note

AXI manager supports the USB Ethernet interface for only the Xilinx® devices.

loadBitstream(BoardName,FPGAImage,DeviceTree,Name,Value) specifies options using one or more name-value arguments. For example, 'DeviceAddress','192.168.0.8' sets the internet protocol (IP) address of the target SoC device.

Input Arguments

collapse all

Targeted SoC board name, specified as one of these values.

  • 'Agilex7SoC'Intel Agilex® 7 FPGA I-Series Transceiver-SoC Development Kit

  • 'VCK190' — Xilinx Versal® AI Core Series VCK190 Evaluation Kit

  • 'ZC702' — Xilinx Zynq®-7000 ZC702

  • 'ZC706' — Xilinx Zynq-7000 ZC706

  • 'ZedBoard' — Xilinx Zynq ZedBoard™

  • 'ZCU102' — Xilinx Zynq UltraScale+™ MPSoC ZCU102 Evaluation Kit

  • 'ZCU111' — Xilinx Zynq UltraScale+ RFSoC ZCU111 Evaluation Kit

  • 'ZCU216' — Xilinx Zynq UltraScale+ RFSoC ZCU216 Evaluation Kit

Data Types: char | string

Custom FPGA bitstream file to be loaded onto the target board, specified as a character vector or string scalar.

Example: 'C:\mywork\hdlv_bitstreams\system.bit'

Data Types: char | string

Custom DTB file to load onto the target board, specified as a character vector or string scalar.

Example: 'C:\mywork\hdlv_bitstreams\devicetree.dtb'

You can also provide only the DTB file name if the file is located on the target SD card path.

Example: 'devicetree_axilite.dtb'

Data Types: char | string

Name-Value Arguments

Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: loadBitstream('ZC706','C:\mywork\hdlv_bitstreams\system.bit','C:\mywork\hdlv_bitstreams\devicetree.dtb','DeviceAddress','192.168.10.2');

IP address of the target SoC device, specified as a character vector or string scalar. The target IP address must be a set of four numbers consisting of integers in the range [0, 255] that are separated by dots.

The default IP address for the Ethernet interface is '192.168.0.2'. The default IP address for the USB Ethernet interface is '192.168.1.2'.

Use this name-value argument to specify a nondefault address when you use the copyImageToHostSDCardPath function.

Example: '192.168.0.8'

Data Types: char | string

Username to log into the target Linux operating system, specified as a character vector or string scalar. Use this name-value argument to specify a nondefault user account name.

Example: 'John'

Data Types: char | string

Password associated with the specified username, specified as a character vector or string scalar. Use this name-value argument to specify a nondefault user account password.

Example: 'P@ssw0rd123'

Data Types: char | string

Version History

Introduced in R2020a