ChipScope Pro Software and Cores User Guide www.xilinx.com 181
UG029 (v14.3) October 16, 2012
CseFpga Tcl Commands
::chipscope::csefpga_configure_device_with_file
Configures an FPGA device with the contents of a .bit, .rbt or .mcs file.
Syntax
::chipscope::csefpga_configure_device_with_file handle deviceIndex
filename <optional args> progressFunc
Arguments
Returns
A bitfield containing the resulting status of the configuration. The bitfield can be logically
AND'ed with one or more of the following values to check the corresponding status
information:
$CSE_INTERNAL_DONE_HIGH_STATUS
$CSE_EXTERNAL_DONE_HIGH_STATUS
$CSE_CRC_ERROR_STATUS
$CSE_BITSTREAM_READ_ENABLED
$CSE_BITSTREAM_WRITE_ENABLED
An exception is thrown if the command fails.
Example
Configure the third device in the JTAG chain with the file mydesign.bit.
%set fileName "mydesign.bit"
%set configStatus [::chipscope::csefpga_configure_device $handle 2
$fileName $CSE_DEFAULT_OPTIONS "progressCallBack"]
Back to list of all CseFpga Tcl Commands
Table 5-48: Arguments for Subcommand ::chipscope::csefpga_configure_device_with_file
Argument Type Description
handle Required Handle to the session that is returned by
::chipscope::csejtag_session create
deviceIndex Required Device index (0 to n-1) in the n-length JTAG chain.
filename Required Filename of the .bit, .rbt, or .mcs configuration file.
<optional args> Optional Enables additional device configuration options. A list of
configuration options is provided in
Table 5-47.
progressFunc Required Function to show progress while shifting in
configuration data into the device. The format of the
progress callback function is:
proc progressFunc (handle totalCount
CurrentCount progressStatus) {...}
The progress callback function must return either
$CSE_STOP or $CSE_CONTINUE. If no progress
callback function is necessary, a 0 should be passed into
this argument position.