loadBitstream

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

Since R2020a

Syntax

loadBitstream(BoardName,FPGAImage,DeviceTree)

loadBitstream(BoardName,FPGAImage,DeviceTree,Name,Value)

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 AMD^® 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

BoardName — Targeted SoC board name

'Agilex7SoC' | 'VCK190' | 'ZC702' | 'ZC706' | 'ZedBoard' | 'ZCU102' | 'ZCU111' | 'ZCU216'

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

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

• 'VCK190' — AMD Versal^® AI Core Series VCK190 Evaluation Kit

• 'ZC702' — AMD Zynq^®-7000 ZC702

• 'ZC706' — AMD Zynq-7000 ZC706

• 'ZedBoard' — AMD Zynq ZedBoard™

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

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

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

Data Types: char | string

FPGAImage — Custom FPGA bitstream file

character vector | string scalar

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

DeviceTree — Custom DTB file

character vector | string scalar

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');

DeviceAddress — IP address of target SoC device

character vector | string scalar

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 — Username to log into target Linux^® operating system

'root' (default) | character vector | string scalar

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 — Password associated with specified username

'root' (default) | character vector | string scalar

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