ChipScope Pro Software and Cores User Guide www.xilinx.com 179
UG029 (v14.3) October 16, 2012
CseFpga Tcl Commands
::chipscope::csefpga_configure_device
Configures an FPGA device with the contents of a byte array containing the contents of a
BIT, RBT, or MCS file.
Syntax
::chipscope::csefpga_configure_device handle deviceIndex format
fileData fileDataByteLen progressFunc<optional args>
Arguments
Table 5-46: Arguments for Subcommand ::chipscope::csefpga_configure_device
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.
format Required Format of the configuration file. Valid choices are bit,
rbt, and mcs.
fileData Required Contents of configuration file in an array of bytes. The
bit file must be read in "binary mode". Other formats
may be read in "binary mode" or "text mode". Do not
remove Windows/unix end-of-line characters from
fileData.
fileDataByteLen Required Length of fileData byte array (in bytes).
<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.
Table 5-47: Configuration Options
Option Name Values Description
reset_device reset_device=true,
reset_device=false
Controls whether or not device is reset during configuration.
Default is "reset_device=true".
shutdown_sequence shutdown_sequence=
true,
shutdown_sequence=
false
Use the JTAG SHUTDOWN command to shut down device. For
Spartan®-3 and Spartan-6 FPGA devices, this option has the
same effect as "reset_device=true". Default is
"shutdown_sequence=false".