ChipScope Pro Software and Cores User Guide
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
.
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"
.
