You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

149 lines
4.3 KiB
Plaintext

SVF Player for JTAG Tools
~~~~~~~~~~~~~~~~~~~~~~~~~
This README describes the SVF player of the UrJTAG software package.
The player has been developed according to the "Serial Vector Format
Specification", Revision E, 8 March 1999 issued by ASSET InterTech, Inc. The
full specification can be found at
http://www.asset-intertech.com/support/svf.pdf
Copyright
---------
SVF player is copyright 2004, Arnim Laeuger.
Parser and lexer are also copyright 2002, CDS at http://www-csd.ijs.si
They have been reused from the "Experimental Boundary Scan" project at
http://ebsp.sourceforge.net/
The SVF player is free software, covered by the GNU General Public License,
and you are welcome to change it and/or distribute copies of it under certain
conditions. There is absolutely no warranty for this software.
Please read the file COPYING for more info.
Usage
-----
The SVF player operates on a single part in the scan chain. Therefore, you
have to bring up the jtag software, specify a cable and detect the scan
chain beforehand.
The player will establish a new instruction called "SIR" and a new register
called "SDR". They are used internally by the respective SVF commands and are
reassigned with new values as the player advances through the file. It is not
recommended to use them outside of the SVF player as their content is dynamic.
Example session:
jtag> cable ppdev /dev/parport0 DLC5
Initializing Xilinx DLC5 JTAG Parallel Cable III on ppdev port /dev/parport0
jtag> detect
IR length: 5
Chain length: 1
Device Id: 10010000101000100000000010010011
Manufacturer: Xilinx
Part: XC2S300E-PQ208
Stepping: 9
Filename: /usr/local/share/jtag/xilinx/xc2s300e-pq208/xc2s300e-pq208
jtag> part <desired part of the scan chain>
jtag> svf <SVF file for selected part>
jtag> instruction BYPASS
jtag> part <next part>
jtag> svf <SVF file for selected part>
jtag> instruction BYPASS
...
It is recommended to set the part's instruction register to BYPASS although
most SVF files do this at the end. By setting the instruction explicitely to
BYPASS the output of the print command will always show meaningful
information.
The SVF player will issue messages when situations arise that cannot be
handled. These messages are classified as warnings or errors depending on
whether the player can continue operation (warning) or not (error).
In case the TDO parameter of an SDR command leads to a mismatch the player
issues a warning and continues. If the player should abort in this case then
specify 'stop' at the svf command.
Limitations and Deficiencies
----------------------------
Several limitations exist for the SVF player.
It has been tested with files generated by these tools so far:
+ Xilinx ISE WebPack 6.3.02i - 9.1.02i
+ Altera Quartus II 4.1sp1 - 7.0
Configuration for these devices has been tested so far:
+ Altera EPC1C12Q240
+ Altera MAX3032, EPM3032ALC44
+ Altera MAX3064, EPM3064ALC44
+ Altera MAX7032, EPM7032SLC44
+ Altera MAX7064, EPM7064SLC44, EPM7064STC44
+ Xilinx Spartan-IIE, XC2S300E-PQ208
+ Xilinx Spartan-3, XC3S1000-FG456, XC3S5000-FG900
The implementation of some SVF commands has deficiencies.
- HIR, HDR
Commands not supported.
Their functionality should be covered by the part concept of JTAG Tools.
- PIO
Command not supported.
- PIOMAP
Command not supported.
- RUNTEST
SCK not supported.
The maximum time constraint is not guaranteed.
- SIR
No check is done against the TDO parameter.
- TRST
Parameters Z and ABSENT are not supported.
- TIR, TDR
Commands not supported.
Their functionality should be covered by the part concept of JTAG Tools.
Operation can be slowed down significantly when the FREQUENCY command has
been specified.
This is not a problem of the SVF player itself but seem to happen when the
frequency of UrJTAG is set to a value larger than 0. Configuration takes
very long although the maximum allowed frequency is 10 MHz.
Consider to comment out the FREQUENCY command at the beginning of the SVF
file.
Contact
-------
Sharing your experience with this software is highly welcome.
Please direct issues either to the urjtag-development mailinglist at
https://lists.sourceforge.net/lists/listinfo/urjtag-development
or contact me directly
arniml <at> users.sourceforge.net