User Application

“xvsecctl” command options

xvsecctl support common VSEC functionality and MCAP functionality. This section describes the details of each option provided for xvsecctl commands

Formt	Parameter	Description/Range	Devices
XVSEC Common Options
-h/H	–	Prints the usage of the tool	All
-b <bus number>	Bus number	PCI bus number	All
-F <device number>	Device number	Device number in the PCI bus	All
-l	–	List the supported VSECs	All
-v	–	Prints the verbose information about the device	All
-c <capability ID>	Capability Identifier	This ID can be identified from	All
XVSEC-MCAP Common Options(Ext Cap ID : 0xB, VSEC ID:0x0001, VSEC Rev : 0, 1, 2, 3)
-m	–	Reset the MCAP module	US,US+,Versal, Spartan US+
-d	–	Print the MCAP Registers	US,US+,Versal, Spartan US+
-a <offset> <access> [data]	offset: MCAP VSEC offset access: b – for byte access h – for short access w – for word access data: Data to perform write operation / NA to perform read operation	Read the data at given VSEC offset (or) Writes the given data at given VSEC offset	US,US+,Versal, Spartan US+
XVSEC-MCAP Ultrascale Specific Options(Ext Cap ID : 0xB, VSEC ID:0x0001, VSEC Rev : 0,1)
-r	–	Reset the configuration logic area	US,US+
-f	–	Reset both configuration logic and MCAP module	US,US+
-D	–	Print Read Data Registers	US,US+
-o	–	Print FPGA configuration registers	US,US+
-C <partial clear file>	Partial clear file: Clear bitstream to program Supported formats are .bit, .bin, .rbt	Program the partial clear bitstream	US,US+
-p <bit stream>	Bitstream: bitstream file to program Supported formats are .bit, .bin, .rbt	Program the bitstream	US,US+
-s <register number> [w] [data]	register number: Valid FPGA CFG Reg No w: command which indicates write operation data: data to write at given register	Read the data at given register number (or) Writes the data at given register number with given data	US,US+
XVSEC-MCAP Versal Specific Options(Ext Cap ID : 0xB, VSEC ID:0x0001, VSEC Rev : 2)
-p mode <32b/128b> type <fixed/incr> <address> <PDI file> [tr_mode <slow/fast>] [sbi <address>]	mode: 32 bit/128bit type: fixed - Address is fixed for each datum incr - Increment address for each datum address: Address to load the PDI PDI file: PDI file to be programmed tr_mode: Optional download mode (Slow/Fast) sbi: Address of the Slave Boot Interface (if target is SBI)	Programs the PDI	Versal
-t type <fixed/incr> <address> <len> <file>	type: fixed - Address is fixed for each datum incr - Increment address for each datum address: Address to read len: size in bytes to read file: Name of the file to store the data	Reads the contents at given address for the given length into given file	Versal
-x mode <32b/128b> <address> [w [data]]	mode: 32 bit/128bit address: AXI Address to read/write w [data]: Write operation with data w: is not valid for read	Access the AXI Registers	Versal
-q axi_cache <data> axi_prot <data>	axi_cache: value to program at axi_cache register axi_prot: value to program at axi_prot register	Set the AXI cache and protections bits	Versal
XVSEC-MCAP Spartan US+ Specific Options(Ext Cap ID : 0xB, VSEC ID:0x0001, VSEC Rev : 3)
-r	–	Reset the configuration logic area	Spartan US+
-f	–	Reset both configuration logic and MCAP module	Spartan US+
-p <bit stream> <tr_mode slow/fast>	Bitstream: bitstream file to program tr_mode: Download mode (Slow/Fast)	Program the bitstream	Spartan US+

Note:

• <> is a mandatory parameter to the requested operation
• [] is an optional parameter to the requested operation
• Except for -p and -C options, all other options are supported one at a time. i.e.,It is not suggested to request two options in a single command, in such scenario only option will get executed