Added HTML documentation, rendered from UrJTAG.txt using DocBook DSSSL stylesheets
git-svn-id: https://urjtag.svn.sourceforge.net/svnroot/urjtag/trunk@1065 b68d4a1b-bc3d-0410-92ed-d4ac073336b7master
parent
de439c8c32
commit
e622c5bb14
File diff suppressed because it is too large
Load Diff
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,381 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Compilation and installation</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="General"
|
||||
HREF="_general.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="System requirements"
|
||||
HREF="_system_requirements.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Usage"
|
||||
HREF="_usage.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_system_requirements.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 2. General</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_usage.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_compilation_and_installation"
|
||||
>2.4. Compilation and installation</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_required_software_for_compiling_urjtag"
|
||||
>2.4.1. Required software for compiling UrJTAG</A
|
||||
></H2
|
||||
><P
|
||||
>To run autogen.sh, you need autoconf and automake, bison, and a recent flex.</P
|
||||
><P
|
||||
>The distributed source tarball contains source pregenerated with a current flex
|
||||
version; flex therefore is only needed if you want to compile code checked
|
||||
out from our Subversion repository. Flex 2.5.4a as it comes with Cygwin will
|
||||
work but some parts of UrJTAG (namely the SVF player) become more verbose if
|
||||
Flex 2.5.31 or newer is used. Building the BSDL subsystem files requires Flex
|
||||
2.5.33 or newer. The configure script will compare the available Flex version
|
||||
against these preconditions and enables or disables the related features. ,</P
|
||||
><P
|
||||
>Furthermore, libtool should be available, and "devel" versions of the following
|
||||
packages:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> gettext
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> readline (not needed, but really eases interactive use)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> ioperm (needed only for Cygwin)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_required_libraries_for_usb_support"
|
||||
>2.4.2. Required libraries for USB support</A
|
||||
></H2
|
||||
><P
|
||||
>For USB adapter support (including support for parallel port adapters attached
|
||||
to USB-to-parallel converters), one or more additional libraries are required.</P
|
||||
><P
|
||||
>Many USB JTAG adapters and USB-to-parallel converters are based on chips
|
||||
made by FTDI. To support these, either intra.net's "libftdi" or FTDI's
|
||||
"FTD2XX" library can be used.</P
|
||||
><P
|
||||
>On many modern Linux distributions, libftdi is available as a precompiled
|
||||
package and can be installed using the distribution's package management system
|
||||
(e.g. "apt-get libftdi-dev" for Debian and Ubuntu). If it isn't available or
|
||||
you don't run Linux, you can get it from</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> http://www.intra2net.com/de/produkte/opensource/ftdi/
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>Alternatively, you can use the FTD2XX library from the chip manufacturer FTDI.
|
||||
It is available for Linux and Windows. To use the library for Windows in a
|
||||
Cygwin environment, first get it from:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> http://www.ftdichip.com/Drivers/D2XX.htm
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>Unzip the CDM*.zip to some directory and tell UrJTAG about this directory
|
||||
during the configure step before actual compilation:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>./configure --with-libftd2xx=/cygdrive/c/windows/temp/CDM_Drivers</PRE
|
||||
><P
|
||||
>All other USB JTAG adapters can be supported only if libusb is installed.
|
||||
There is a libusb-win32 variant that can be used in a Cygwin environment:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> http://libusb.sourceforge.net (libusb)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> http://libusb-win32.sourceforge.net (libusb for Windows)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>For specific notes regarding the use of these libraries in a Cygwin
|
||||
environmen, see below.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_installing_from_source_tar_gz"
|
||||
>2.4.3. Installing from source tar.gz</A
|
||||
></H2
|
||||
><P
|
||||
>The installation follows the standard configure, make, make install scheme:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>tar xzvf urjtag.tar.gz
|
||||
cd ../jtag
|
||||
./configure
|
||||
make
|
||||
make install</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_installing_from_subversion_repository"
|
||||
>2.4.4. Installing from Subversion repository</A
|
||||
></H2
|
||||
><P
|
||||
>If you want to try the very newest version of UrJTAG…</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>svn co http://urjtag.svn.sourceforge.net/svnroot/urjtag/trunk urjtag</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>cd urjtag/jtag
|
||||
./autogen.sh
|
||||
# ./configure done by autogen.sh; run it here with special options if needed
|
||||
make
|
||||
make install</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_linking_to_ftd2xx_dll_in_cygwin_environment"
|
||||
>2.4.5. Linking to FTD2XX.DLL in Cygwin environment</A
|
||||
></H2
|
||||
><P
|
||||
>Before running configure, get the D2XX drivers from FTDI.</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> http://www.ftdichip.com/Drivers/D2XX.htm (FTDI FTD2XX library)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>Unzip the archive into a directory of your choice (probably a choice
|
||||
without spaces in the name is better) and afterwards run configure with the
|
||||
"—with-ftd2xx" pointing to that directory, e.g.</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>./configure --with-ftd2xx="/cygdrive/c/temp/ftdi-cdm-drivers"</PRE
|
||||
><P
|
||||
>Configure should now report</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>FTDI cable support
|
||||
...
|
||||
via libftd2xx : yes</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_using_libusb_win32_in_cygwin_environment"
|
||||
>2.4.6. Using LibUSB-Win32 in Cygwin environment</A
|
||||
></H2
|
||||
><P
|
||||
>Before running configure, install the LibUSB-Win32 "filter" driver from SF.</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> http://libusb-win32.sourceforge.net
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>Then point configure to the directory where LibUSB-Win32 was installed (it
|
||||
might give problems if the path contains spaces, as "Program Files" does!):</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>./configure --with-libusb="/cygdrive/c/Programme/LibUSB-Win32/"</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_building_the_bsdl_subsystem"
|
||||
>2.4.7. Building the BSDL subsystem</A
|
||||
></H2
|
||||
><P
|
||||
>As mentioned above, building the BSDL lexer requires Flex 2.5.33 or newer. If
|
||||
the detected Flex version is not recent enough, configure will disable the
|
||||
BSDL subsystem. The detection result is summarized at the end of configure:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag is now configured for
|
||||
...
|
||||
Build BSDL subsystem : yes</PRE
|
||||
><P
|
||||
>Flex is only required when you're working on a check-out of the Subversion
|
||||
repository. In this case Flex has to be called to transform bsdl_flex.l to
|
||||
bsdl_flex.c. When you're compiling from released sources, the local Flex
|
||||
version is not relevant since the output file of Flex is part of the
|
||||
tarball. I.e. even if the local Flex fails the check, the BSDL subsystem is
|
||||
enabled and will be compiled from the released C files.</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_system_requirements.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_usage.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>System requirements</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Usage</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,146 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Copyright</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="General"
|
||||
HREF="_general.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_copyright"
|
||||
></A
|
||||
>Chapter 1. Copyright</H1
|
||||
><P
|
||||
>Copyright 2007, 2008 Kolja Waschk and the respective authors.</P
|
||||
><P
|
||||
>Permission is granted to copy, distribute and/or modify this document under the
|
||||
terms of the GNU Free Documentation License, Version 1.2 or any later version
|
||||
published by the Free Software Foundation. A copy of the license is included in
|
||||
the section entitled "GNU Free Documentation License".</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Universal JTAG library, server and tools</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>General</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,183 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Data file format</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Internals"
|
||||
HREF="_internals.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Drivers"
|
||||
HREF="_drivers.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Development"
|
||||
HREF="_development.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_drivers.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 4. Internals</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_development.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_data_file_format"
|
||||
>4.3. Data file format</A
|
||||
></H1
|
||||
><P
|
||||
>JTAG declarations files are located in directory "data". The files contains
|
||||
common part specific JTAG information in parseable form, e.g. list of the JTAG
|
||||
commands, boundary scan register, list of JTAG registers, etc.</P
|
||||
><P
|
||||
>Syntax of the JTAG declaration file is defined in the following subsections.</P
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_general_rules"
|
||||
>4.3.1. General rules</A
|
||||
></H2
|
||||
><P
|
||||
>JTAG declaration file is text file which consists of lines. Empty lines are
|
||||
ignored. Text after first "#" on the line to the end of line is ignored. This
|
||||
is useful for comments. All other lines are significant.</P
|
||||
><P
|
||||
>Each significant line consists of tokens separated by whitespace. Whitespace
|
||||
could be spaces and/or tabs.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_signal_definition"
|
||||
>4.3.2. Signal Definition</A
|
||||
></H2
|
||||
><P
|
||||
>Signal definition line consists of word "signal" followed by whitespace and
|
||||
signal name (without spaces in the name). Rest of the line should contain
|
||||
whitespace separated list of pins of the part. This list is currently not used
|
||||
for any purpose in JTAG Tools. It is intended for future use.</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_drivers.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_development.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Drivers</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_internals.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Development</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,213 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Development</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Internals"
|
||||
HREF="_internals.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Data file format"
|
||||
HREF="_data_file_format.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="F.A.Q."
|
||||
HREF="_f_a_q.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_data_file_format.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 4. Internals</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_f_a_q.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_development"
|
||||
>4.4. Development</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_future_plans"
|
||||
>4.4.1. Future Plans</A
|
||||
></H2
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> C API and library package
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Bindings for Python, Perl, …
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> TCP/IP access
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> New cable drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> …
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_how_to_contribute"
|
||||
>4.4.2. How to contribute</A
|
||||
></H2
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> Using Subversion
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Create and submit a patch
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Use SourceForge trackers
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_data_file_format.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_f_a_q.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Data file format</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_internals.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>F.A.Q.</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,606 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Drivers</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Internals"
|
||||
HREF="_internals.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Internals"
|
||||
HREF="_internals.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Data file format"
|
||||
HREF="_data_file_format.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_internals.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 4. Internals</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_data_file_format.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_drivers"
|
||||
>4.2. Drivers</A
|
||||
></H1
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> Cable-specific drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Parport drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> TAP drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Chain drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Bus drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Flash drivers
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Commands
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_cable_specific_drivers_src_tap_cable"
|
||||
>4.2.1. Cable-specific drivers (src/tap/cable)</A
|
||||
></H2
|
||||
><P
|
||||
>Cable-specific drivers are those which are visible to the user through
|
||||
the "jtag" command shell. They're listed in response to the "help cable"
|
||||
command. Each driver has to provide the following functions:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> connect(), init() - Initialization
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> done(), cable_free(), disconnect() - Cleaning up
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> set_frequency() - set bitrate for shifting data through the chain
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> clock(), get_tdo(), transfer() - immediate JTAG activities
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> flush() - internally used to actually perform JTAG activities
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> help() - a help text to be displayed by the jtag command shell
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_initialization"
|
||||
>4.2.1.1. Initialization</A
|
||||
></H3
|
||||
><P
|
||||
>After allocating a "cable_t" structure, a pointer to it and further
|
||||
parameters (as strings) have to be passed first to the selected cable's
|
||||
connect() function.</P
|
||||
><P
|
||||
>Following that, the init() function is called via cable_init(). If cable_init()
|
||||
returns a zero value, all is fine and the cable is ready for use.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_cleaning_up"
|
||||
>4.2.1.2. Cleaning up</A
|
||||
></H3
|
||||
><P
|
||||
>There are two functions for actual cleanup:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> done() is responsible for driving the hardware to a safe and consistent state.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_free() then can be used to clean up eventually extra allocated memory etc.
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>Both are usually called from chain_disconnect().</P
|
||||
><P
|
||||
>An additional mechanism allows to clean up if a disconnection was detected by
|
||||
the low level driver (e.g. USB or parallel port driver). A cable has to provide
|
||||
a disconnect() function for this purpose:</P
|
||||
><P
|
||||
></P
|
||||
><OL
|
||||
TYPE="1"
|
||||
><LI
|
||||
><P
|
||||
> Low level (e.g. parport) driver calls cable driver->disconnect()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable driver->disconnect() calls chain_disconnect()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> chain_disconnect() calls cable driver->done()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> chain_disconnect() then calls cable driver->cable_free()
|
||||
</P
|
||||
></LI
|
||||
></OL
|
||||
><P
|
||||
>After return from chain_disconnect() to cable driver->disconnect(), the cable_t
|
||||
structure has been freed and must not be accessed anymore.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_jtag_activities"
|
||||
>4.2.1.3. JTAG Activities</A
|
||||
></H3
|
||||
><P
|
||||
>Currently the API provides five different functions for performing operations
|
||||
at the JTAG interface on the low level signal level (using the four signals
|
||||
TMS, TCK, TDI, and TDO).</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> clock(tms,tdi,n) takes values for TMS and TDI output as its parameters, ensures that actual cable signals are set accordingly, and does a 0-1 transition on TCK (n times)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_tdo() returns the current value at the TDO input.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> set_trst(x) sets the TRST signal and returns the current value.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_trst() returns the current value of the TRST signal.
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>For many JTAG adapters, there's almost no delay when doing alternating clock()
|
||||
and get_tdo(). Writing and reading happens immediately and the result is
|
||||
available immediately as well. This is the case with most parallel port
|
||||
adapters (but not when attached to USB-to-parallel adapters or USB docking
|
||||
stations) and memory mapped IO (e.g. general purpose I/O pins of
|
||||
microcontrollers).</P
|
||||
><P
|
||||
>But there are adapters, especially USB and Ethernet based adapters, which
|
||||
exhibit a rather long delay between the initiation of reading a bit and the
|
||||
delivery of the value of the bit. It is at least 1 millisecond with USB,
|
||||
which would limit the transfer rate to 1 kHz. One way to workaround this
|
||||
is to transmit bits compacted into bytes and chunks of bytes, which is
|
||||
possible with the transfer() function.</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> transfer(in, out)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>The transfer() function does a series of TCK pulses, with data for TDI read as
|
||||
bytes from memory. The bytes are automatically serialized. TMS is set to zero
|
||||
during transfer()s. Optionally, prior to each bit shifted out to the interface,
|
||||
TDO input can be read into memory (deserialized into a byte array of the same
|
||||
size as the input array).</P
|
||||
><P
|
||||
>It still doesn't yield much improvement if the operation consists of many read
|
||||
and write transitions (e.g. repeatedly writing an instruction and some data
|
||||
register values, then reading from the data register, as it is necessary for
|
||||
memory access). For that reason, the above functions are also available in
|
||||
variants that don't cause immediate activity, but rather schedule it for later.
|
||||
In the API, they're visible as</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> cable_defer_clock()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_defer_get_tdo()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_defer_set_trst()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_defer_get_trst()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_defer_transfer()
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>These functions aren't implemented in the cable driver (but currently in
|
||||
src/tap/cable.c). The cable driver just has to provide a flush() function to
|
||||
actually execute the queued activity in some cable-specific optimal way, and
|
||||
to store the results of get_tdo() and transfer() activity. The caller later
|
||||
can pick up the results using these functions (implemented in cable.c):</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> cable_get_tdo_late()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_get_trst_late()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_transfer_late()
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>As an example, consider the following sequence of activities:</P
|
||||
><P
|
||||
></P
|
||||
><OL
|
||||
TYPE="1"
|
||||
><LI
|
||||
><P
|
||||
> clock()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_tdo()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> clock()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_tdo()
|
||||
</P
|
||||
></LI
|
||||
></OL
|
||||
><P
|
||||
>If the result of the first get_tdo() isn't absolutely required before the
|
||||
second clock(), the sequence can be optimized into the following sequence (if</P
|
||||
><P
|
||||
></P
|
||||
><OL
|
||||
TYPE="1"
|
||||
><LI
|
||||
><P
|
||||
> defer_clock()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> defer_clock()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> flush()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_tdo_late()
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> get_tdo_late()
|
||||
</P
|
||||
></LI
|
||||
></OL
|
||||
><P
|
||||
>The next sections explain the queueing mechanism and its limits in detail.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_when_flushing_occurs"
|
||||
>4.2.1.4. When flushing occurs ======</A
|
||||
></H3
|
||||
><P
|
||||
>The cable_flush() function is used to flush the queue towards the cable. It
|
||||
takes one additional argument, "how_much", which may be one of</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> OPTIONALLY: The cable driver may flush if it's reasonable (e.g. if the
|
||||
queue has been filled so that some buffer limit for the cable interface
|
||||
is reached). It would be wise to flush early to keep the queue small, if
|
||||
there is no point in queueing up more items because the transfer to the
|
||||
cable would have to be split into smaller chunks anyway. This is used by
|
||||
UrJTAG immediately after adding items to the queue.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> TO_OUTPUT: The cable driver should at least flush as much so that one
|
||||
output becomes available in the output queue. If there's already something
|
||||
in the output queue, this should be interpreted similar to OPTIONALLY. This
|
||||
is used by UrJTAG immediately before it wants to use that output.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> COMPLETELY: The cable driver has to flush the queue completely. This is
|
||||
used by UrJTAG immediately before actions that circumvent the queueing
|
||||
such as calls to the legacy clock/get_tdo functions. It could also be
|
||||
used by application code to ensure that some action is actually done in
|
||||
time.
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_jtag_activity_queueing"
|
||||
>4.2.1.5. JTAG activity queueing</A
|
||||
></H3
|
||||
><P
|
||||
>The source in src/tap/cable.c provides to important functions to access the
|
||||
two queues "todo" (with activity to be done) and "done" (with results):</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> cable_add_queue_item
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> cable_get_queue_item
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>In src/tap/cable/generic.c you'll find two implementations of dequeueing
|
||||
algorithms, i.e. implementations of the flush() function. These could be used
|
||||
by any new cable driver unless it provides a more sophisticated algorithm
|
||||
itself:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> generic_flush_one_by_one() simply calls the "classic" functions one after
|
||||
another. The performance of the cable driver using this implementation will
|
||||
be the same whether the immediate or defer variants of the functions are used.
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> generic_flush_using_transfer() tries to optimize as many clock() and
|
||||
get_tdo() by transforming them into calls to transfer() instead. This can
|
||||
give a slight advantage.
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>The generic implementations also serve as a template for new cable-specific
|
||||
implementations.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H3
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_generic_implementations"
|
||||
>4.2.1.6. Generic implementations</A
|
||||
></H3
|
||||
><P
|
||||
>As a reference and in many cases completely sufficient for new cables, take a
|
||||
look at the code in src/tap/cable/generic.c, which contains generic routines,
|
||||
suitable for parallel port based cables (and some for other types of cables as
|
||||
well).</P
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_internals.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_data_file_format.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Internals</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_internals.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Data file format</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,219 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>F.A.Q.</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Development"
|
||||
HREF="_development.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Licensing"
|
||||
HREF="_licensing.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_development.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_f_a_q"
|
||||
></A
|
||||
>Chapter 5. F.A.Q.</H1
|
||||
><P
|
||||
>For a list of known problems in current versions, please also check the "Bugs"
|
||||
tracker at the UrJTAG website!</P
|
||||
><P
|
||||
></P
|
||||
><DIV
|
||||
CLASS="variablelist"
|
||||
><DL
|
||||
><DT
|
||||
>Q. The documentation is incomplete. Where can I get more information?</DT
|
||||
><DD
|
||||
><P
|
||||
> A. Please ask in the "Using UrJTAG" Forum on http://urjtag.org
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. My flash isn't detected or can't be programmed. What can I do?</DT
|
||||
><DD
|
||||
><P
|
||||
> A. Please record the output of the "detect" and "detectflash" commands and ask in the Forum. If possible, re-compile UrJTAG before with "—enable-jedec-exp" to get extra information.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. My CPU/FPGA/etc. chip isn't detected. What can I do?</DT
|
||||
><DD
|
||||
><P
|
||||
> A. First try to get hold of a "BSDL" description of the chip from the vendor, and specify where to find this file to UrJTAG using "bsdl path" before you "detect". Second, a bus driver has to be selected. Maybe "ejtag" or "prototype" work.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. When I type "cable parallel 0x378 DLC5" (in a Cygwin environment) I get "Unknown port driver: parallel"?</DT
|
||||
><DD
|
||||
><P
|
||||
> A. Please install the Cygwin ioperm package, and re-configure/compile.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. When I type "cable parallel 0x378 DLC5" (in a Cygwin environment) I get "Error: Cable initialization failed!".</DT
|
||||
><DD
|
||||
><P
|
||||
> A. Please install ioperm.sys driver using <TT
|
||||
CLASS="literal"
|
||||
>ioperm -i</TT
|
||||
> command.
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. When running autogen.sh, I get "Can't exec "autopoint": No such file or directory"</DT
|
||||
><DD
|
||||
><P
|
||||
> A. You need the headers for gettext (e.g. Debian package "gettext-devel").
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. During compilation, I get "svf_bison.y: No such file or directory"</DT
|
||||
><DD
|
||||
><P
|
||||
> A. You need "bison".
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. During compilation, I get "flex: can't open … src/svf/svf_flex.l"</DT
|
||||
><DD
|
||||
><P
|
||||
> A. You need "flex"
|
||||
</P
|
||||
></DD
|
||||
><DT
|
||||
>Q. During compilation, I get "src/svf/svf_flex.l", line 27: unrecognized %option: bison-locations"</DT
|
||||
><DD
|
||||
><P
|
||||
> A. You need a newer version of flex. It should be 2.5.31 or newer;
|
||||
Unfortunately, Cygwin comes with only 2.5.4a. You may try to compile and
|
||||
install a newer version of flex from source to solve this. The distributed
|
||||
source tarball contains source pregenerated with a current flex version,
|
||||
you need flex yourself only to compile from fresh SVN checkouts.
|
||||
</P
|
||||
></DD
|
||||
></DL
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_development.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Development</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Licensing</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,293 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>General</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Copyright"
|
||||
HREF="_copyright.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="UrJTAG"
|
||||
HREF="_urjtag.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_copyright.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_urjtag.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_general"
|
||||
></A
|
||||
>Chapter 2. General</H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_jtag"
|
||||
>2.1. JTAG</A
|
||||
></H1
|
||||
><P
|
||||
>JTAG basics can be found all over the internet. This section should go into
|
||||
some more details about working with JTAG. What hardware do you need, what is
|
||||
the usage of JTAG, where do I get files. What file formats are available…</P
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_introduction"
|
||||
>2.1.1. Introduction</A
|
||||
></H2
|
||||
><P
|
||||
>JTAG (IEEE 1149.1) is a serial interface for testing devices with
|
||||
integrated circuits. The problem that the JTAG interface was designed to solve
|
||||
is checking if connections between ICs are OK. Therefore you can set and check
|
||||
in- and outputs of ICs. In order to save pins and logic a very simple serial
|
||||
design was invented.</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> One pin serial input
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> One pin serial output
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> One pin clock
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> One pin control
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>The control pin (together with clock) allows to switch device states. A state
|
||||
machine inside each chip can be controlled, e.g. to reset the device. This
|
||||
control machine also allows to have two internal shift registers in each device
|
||||
(although we only have on in- and one output-pin). The registers are called
|
||||
instruction register (IR) and data register (DR). The current UrJTAG tool
|
||||
allows you to set the IR and set and get the DR. It doesn't allow you to
|
||||
directly control the statemachine (yet).</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_interfaces"
|
||||
>2.1.2. Interfaces</A
|
||||
></H2
|
||||
><P
|
||||
>The simplest interface that you can build is like the Xilinx parallel cable
|
||||
(also called DLC5). If your device works with a 5V or 3.3V supply voltage then
|
||||
this device can even be build just with passive parts. (picture missing here)
|
||||
UrJTAG also supports a number of other interface adapters.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_additions"
|
||||
>2.1.3. Additions</A
|
||||
></H2
|
||||
><P
|
||||
>In the meantime the jtag specification was used as a basis for programming
|
||||
flash files and debugging processors. UrJTAG supports programming a couple of
|
||||
different flash devices. It also supports programming of non-flash devices via
|
||||
svf files. UrJTAG does not support debugging yet. Other open source solutions
|
||||
such as OpenOCD allow you to debug ARM processors with gdb.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_bsdl_and_urjtag_data_files"
|
||||
>2.1.4. BSDL and UrJTAG data files</A
|
||||
></H2
|
||||
><P
|
||||
>The BSDL file format describes the jtag interface for one IC. It is a VHDL
|
||||
syntax with the needed information (like pin-names, register lengths and
|
||||
commands) that is usually done by the supplier. e.g. Xilinx BSDL files are
|
||||
all included in their free web-pack (using file extension ".bsd").</P
|
||||
><P
|
||||
>UrJTAG uses a different file format internally. So in order to add a new device
|
||||
to UrJTAG you need to convert those files and produce a directory structure.
|
||||
Currently there are at least three tools available to do that; included with
|
||||
UrJTAG is "bsdl2jtag". Please ask on the mailing list in case of problems with
|
||||
that. Please also send proven working files back to this project.</P
|
||||
><P
|
||||
>Starting with post-0.7 releases, UrJTAG contains a BSDL subsystem that
|
||||
retrieves the descriptions for chips in the chain from BSDL files on the
|
||||
fly. Be aware that this feature is currently experimental and may not work
|
||||
with every BSDL file yet.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_svf_files"
|
||||
>2.1.5. SVF files</A
|
||||
></H2
|
||||
><P
|
||||
>The SVF file format contains a number of high level commands to drive the jtag
|
||||
bus. For example you can shift the IR or DR and even check for the results.
|
||||
The Xilinxs impact and Altera QuartusII tools allow you to write this file to
|
||||
program devices.</P
|
||||
><P
|
||||
>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</P
|
||||
><P
|
||||
>UrJTAG features an "SVF player" that can read SVF files and perform the
|
||||
described actions on the bus.</P
|
||||
><P
|
||||
>SVF 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/.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_jam_stapl_files"
|
||||
>2.1.6. JAM/STAPL files</A
|
||||
></H2
|
||||
><P
|
||||
>Another format for describing actions over JTAG interfaces is STAPL, actually
|
||||
standardized as JEDEC "JESD-71A". Compared to SVF, it looks more like an
|
||||
actual programming language and features looping, conditional execution, and
|
||||
more. STAPL is not yet supported by UrJTAG.</P
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_copyright.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_urjtag.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Copyright</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>UrJTAG</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,546 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>GNU Free Documentation License (FDL)</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Licensing"
|
||||
HREF="_licensing.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Licensing"
|
||||
HREF="_licensing.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="GNU General Public License (GPL)"
|
||||
HREF="_gnu_general_public_license_gpl.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 6. Licensing</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_gnu_general_public_license_gpl.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_gnu_free_documentation_license_fdl"
|
||||
>6.2. GNU Free Documentation License (FDL)</A
|
||||
></H1
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
> GNU Free Documentation License
|
||||
Version 1.2, November 2002
|
||||
|
||||
|
||||
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
|
||||
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
|
||||
0. PREAMBLE
|
||||
|
||||
The purpose of this License is to make a manual, textbook, or other
|
||||
functional and useful document "free" in the sense of freedom: to
|
||||
assure everyone the effective freedom to copy and redistribute it,
|
||||
with or without modifying it, either commercially or noncommercially.
|
||||
Secondarily, this License preserves for the author and publisher a way
|
||||
to get credit for their work, while not being considered responsible
|
||||
for modifications made by others.
|
||||
|
||||
This License is a kind of "copyleft", which means that derivative
|
||||
works of the document must themselves be free in the same sense. It
|
||||
complements the GNU General Public License, which is a copyleft
|
||||
license designed for free software.
|
||||
|
||||
We have designed this License in order to use it for manuals for free
|
||||
software, because free software needs free documentation: a free
|
||||
program should come with manuals providing the same freedoms that the
|
||||
software does. But this License is not limited to software manuals;
|
||||
it can be used for any textual work, regardless of subject matter or
|
||||
whether it is published as a printed book. We recommend this License
|
||||
principally for works whose purpose is instruction or reference.
|
||||
|
||||
|
||||
1. APPLICABILITY AND DEFINITIONS
|
||||
|
||||
This License applies to any manual or other work, in any medium, that
|
||||
contains a notice placed by the copyright holder saying it can be
|
||||
distributed under the terms of this License. Such a notice grants a
|
||||
world-wide, royalty-free license, unlimited in duration, to use that
|
||||
work under the conditions stated herein. The "Document", below,
|
||||
refers to any such manual or work. Any member of the public is a
|
||||
licensee, and is addressed as "you". You accept the license if you
|
||||
copy, modify or distribute the work in a way requiring permission
|
||||
under copyright law.
|
||||
|
||||
A "Modified Version" of the Document means any work containing the
|
||||
Document or a portion of it, either copied verbatim, or with
|
||||
modifications and/or translated into another language.
|
||||
|
||||
A "Secondary Section" is a named appendix or a front-matter section of
|
||||
the Document that deals exclusively with the relationship of the
|
||||
publishers or authors of the Document to the Document's overall subject
|
||||
(or to related matters) and contains nothing that could fall directly
|
||||
within that overall subject. (Thus, if the Document is in part a
|
||||
textbook of mathematics, a Secondary Section may not explain any
|
||||
mathematics.) The relationship could be a matter of historical
|
||||
connection with the subject or with related matters, or of legal,
|
||||
commercial, philosophical, ethical or political position regarding
|
||||
them.
|
||||
|
||||
The "Invariant Sections" are certain Secondary Sections whose titles
|
||||
are designated, as being those of Invariant Sections, in the notice
|
||||
that says that the Document is released under this License. If a
|
||||
section does not fit the above definition of Secondary then it is not
|
||||
allowed to be designated as Invariant. The Document may contain zero
|
||||
Invariant Sections. If the Document does not identify any Invariant
|
||||
Sections then there are none.
|
||||
|
||||
The "Cover Texts" are certain short passages of text that are listed,
|
||||
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
|
||||
the Document is released under this License. A Front-Cover Text may
|
||||
be at most 5 words, and a Back-Cover Text may be at most 25 words.
|
||||
|
||||
A "Transparent" copy of the Document means a machine-readable copy,
|
||||
represented in a format whose specification is available to the
|
||||
general public, that is suitable for revising the document
|
||||
straightforwardly with generic text editors or (for images composed of
|
||||
pixels) generic paint programs or (for drawings) some widely available
|
||||
drawing editor, and that is suitable for input to text formatters or
|
||||
for automatic translation to a variety of formats suitable for input
|
||||
to text formatters. A copy made in an otherwise Transparent file
|
||||
format whose markup, or absence of markup, has been arranged to thwart
|
||||
or discourage subsequent modification by readers is not Transparent.
|
||||
An image format is not Transparent if used for any substantial amount
|
||||
of text. A copy that is not "Transparent" is called "Opaque".
|
||||
|
||||
Examples of suitable formats for Transparent copies include plain
|
||||
ASCII without markup, Texinfo input format, LaTeX input format, SGML
|
||||
or XML using a publicly available DTD, and standard-conforming simple
|
||||
HTML, PostScript or PDF designed for human modification. Examples of
|
||||
transparent image formats include PNG, XCF and JPG. Opaque formats
|
||||
include proprietary formats that can be read and edited only by
|
||||
proprietary word processors, SGML or XML for which the DTD and/or
|
||||
processing tools are not generally available, and the
|
||||
machine-generated HTML, PostScript or PDF produced by some word
|
||||
processors for output purposes only.
|
||||
|
||||
The "Title Page" means, for a printed book, the title page itself,
|
||||
plus such following pages as are needed to hold, legibly, the material
|
||||
this License requires to appear in the title page. For works in
|
||||
formats which do not have any title page as such, "Title Page" means
|
||||
the text near the most prominent appearance of the work's title,
|
||||
preceding the beginning of the body of the text.
|
||||
|
||||
A section "Entitled XYZ" means a named subunit of the Document whose
|
||||
title either is precisely XYZ or contains XYZ in parentheses following
|
||||
text that translates XYZ in another language. (Here XYZ stands for a
|
||||
specific section name mentioned below, such as "Acknowledgements",
|
||||
"Dedications", "Endorsements", or "History".) To "Preserve the Title"
|
||||
of such a section when you modify the Document means that it remains a
|
||||
section "Entitled XYZ" according to this definition.
|
||||
|
||||
The Document may include Warranty Disclaimers next to the notice which
|
||||
states that this License applies to the Document. These Warranty
|
||||
Disclaimers are considered to be included by reference in this
|
||||
License, but only as regards disclaiming warranties: any other
|
||||
implication that these Warranty Disclaimers may have is void and has
|
||||
no effect on the meaning of this License.
|
||||
|
||||
|
||||
2. VERBATIM COPYING
|
||||
|
||||
You may copy and distribute the Document in any medium, either
|
||||
commercially or noncommercially, provided that this License, the
|
||||
copyright notices, and the license notice saying this License applies
|
||||
to the Document are reproduced in all copies, and that you add no other
|
||||
conditions whatsoever to those of this License. You may not use
|
||||
technical measures to obstruct or control the reading or further
|
||||
copying of the copies you make or distribute. However, you may accept
|
||||
compensation in exchange for copies. If you distribute a large enough
|
||||
number of copies you must also follow the conditions in section 3.
|
||||
|
||||
You may also lend copies, under the same conditions stated above, and
|
||||
you may publicly display copies.
|
||||
|
||||
|
||||
3. COPYING IN QUANTITY
|
||||
|
||||
If you publish printed copies (or copies in media that commonly have
|
||||
printed covers) of the Document, numbering more than 100, and the
|
||||
Document's license notice requires Cover Texts, you must enclose the
|
||||
copies in covers that carry, clearly and legibly, all these Cover
|
||||
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
|
||||
the back cover. Both covers must also clearly and legibly identify
|
||||
you as the publisher of these copies. The front cover must present
|
||||
the full title with all words of the title equally prominent and
|
||||
visible. You may add other material on the covers in addition.
|
||||
Copying with changes limited to the covers, as long as they preserve
|
||||
the title of the Document and satisfy these conditions, can be treated
|
||||
as verbatim copying in other respects.
|
||||
|
||||
If the required texts for either cover are too voluminous to fit
|
||||
legibly, you should put the first ones listed (as many as fit
|
||||
reasonably) on the actual cover, and continue the rest onto adjacent
|
||||
pages.
|
||||
|
||||
If you publish or distribute Opaque copies of the Document numbering
|
||||
more than 100, you must either include a machine-readable Transparent
|
||||
copy along with each Opaque copy, or state in or with each Opaque copy
|
||||
a computer-network location from which the general network-using
|
||||
public has access to download using public-standard network protocols
|
||||
a complete Transparent copy of the Document, free of added material.
|
||||
If you use the latter option, you must take reasonably prudent steps,
|
||||
when you begin distribution of Opaque copies in quantity, to ensure
|
||||
that this Transparent copy will remain thus accessible at the stated
|
||||
location until at least one year after the last time you distribute an
|
||||
Opaque copy (directly or through your agents or retailers) of that
|
||||
edition to the public.
|
||||
|
||||
It is requested, but not required, that you contact the authors of the
|
||||
Document well before redistributing any large number of copies, to give
|
||||
them a chance to provide you with an updated version of the Document.
|
||||
|
||||
|
||||
4. MODIFICATIONS
|
||||
|
||||
You may copy and distribute a Modified Version of the Document under
|
||||
the conditions of sections 2 and 3 above, provided that you release
|
||||
the Modified Version under precisely this License, with the Modified
|
||||
Version filling the role of the Document, thus licensing distribution
|
||||
and modification of the Modified Version to whoever possesses a copy
|
||||
of it. In addition, you must do these things in the Modified Version:
|
||||
|
||||
A. Use in the Title Page (and on the covers, if any) a title distinct
|
||||
from that of the Document, and from those of previous versions
|
||||
(which should, if there were any, be listed in the History section
|
||||
of the Document). You may use the same title as a previous version
|
||||
if the original publisher of that version gives permission.
|
||||
B. List on the Title Page, as authors, one or more persons or entities
|
||||
responsible for authorship of the modifications in the Modified
|
||||
Version, together with at least five of the principal authors of the
|
||||
Document (all of its principal authors, if it has fewer than five),
|
||||
unless they release you from this requirement.
|
||||
C. State on the Title page the name of the publisher of the
|
||||
Modified Version, as the publisher.
|
||||
D. Preserve all the copyright notices of the Document.
|
||||
E. Add an appropriate copyright notice for your modifications
|
||||
adjacent to the other copyright notices.
|
||||
F. Include, immediately after the copyright notices, a license notice
|
||||
giving the public permission to use the Modified Version under the
|
||||
terms of this License, in the form shown in the Addendum below.
|
||||
G. Preserve in that license notice the full lists of Invariant Sections
|
||||
and required Cover Texts given in the Document's license notice.
|
||||
H. Include an unaltered copy of this License.
|
||||
I. Preserve the section Entitled "History", Preserve its Title, and add
|
||||
to it an item stating at least the title, year, new authors, and
|
||||
publisher of the Modified Version as given on the Title Page. If
|
||||
there is no section Entitled "History" in the Document, create one
|
||||
stating the title, year, authors, and publisher of the Document as
|
||||
given on its Title Page, then add an item describing the Modified
|
||||
Version as stated in the previous sentence.
|
||||
J. Preserve the network location, if any, given in the Document for
|
||||
public access to a Transparent copy of the Document, and likewise
|
||||
the network locations given in the Document for previous versions
|
||||
it was based on. These may be placed in the "History" section.
|
||||
You may omit a network location for a work that was published at
|
||||
least four years before the Document itself, or if the original
|
||||
publisher of the version it refers to gives permission.
|
||||
K. For any section Entitled "Acknowledgements" or "Dedications",
|
||||
Preserve the Title of the section, and preserve in the section all
|
||||
the substance and tone of each of the contributor acknowledgements
|
||||
and/or dedications given therein.
|
||||
L. Preserve all the Invariant Sections of the Document,
|
||||
unaltered in their text and in their titles. Section numbers
|
||||
or the equivalent are not considered part of the section titles.
|
||||
M. Delete any section Entitled "Endorsements". Such a section
|
||||
may not be included in the Modified Version.
|
||||
N. Do not retitle any existing section to be Entitled "Endorsements"
|
||||
or to conflict in title with any Invariant Section.
|
||||
O. Preserve any Warranty Disclaimers.
|
||||
|
||||
If the Modified Version includes new front-matter sections or
|
||||
appendices that qualify as Secondary Sections and contain no material
|
||||
copied from the Document, you may at your option designate some or all
|
||||
of these sections as invariant. To do this, add their titles to the
|
||||
list of Invariant Sections in the Modified Version's license notice.
|
||||
These titles must be distinct from any other section titles.
|
||||
|
||||
You may add a section Entitled "Endorsements", provided it contains
|
||||
nothing but endorsements of your Modified Version by various
|
||||
parties--for example, statements of peer review or that the text has
|
||||
been approved by an organization as the authoritative definition of a
|
||||
standard.
|
||||
|
||||
You may add a passage of up to five words as a Front-Cover Text, and a
|
||||
passage of up to 25 words as a Back-Cover Text, to the end of the list
|
||||
of Cover Texts in the Modified Version. Only one passage of
|
||||
Front-Cover Text and one of Back-Cover Text may be added by (or
|
||||
through arrangements made by) any one entity. If the Document already
|
||||
includes a cover text for the same cover, previously added by you or
|
||||
by arrangement made by the same entity you are acting on behalf of,
|
||||
you may not add another; but you may replace the old one, on explicit
|
||||
permission from the previous publisher that added the old one.
|
||||
|
||||
The author(s) and publisher(s) of the Document do not by this License
|
||||
give permission to use their names for publicity for or to assert or
|
||||
imply endorsement of any Modified Version.
|
||||
|
||||
|
||||
5. COMBINING DOCUMENTS
|
||||
|
||||
You may combine the Document with other documents released under this
|
||||
License, under the terms defined in section 4 above for modified
|
||||
versions, provided that you include in the combination all of the
|
||||
Invariant Sections of all of the original documents, unmodified, and
|
||||
list them all as Invariant Sections of your combined work in its
|
||||
license notice, and that you preserve all their Warranty Disclaimers.
|
||||
|
||||
The combined work need only contain one copy of this License, and
|
||||
multiple identical Invariant Sections may be replaced with a single
|
||||
copy. If there are multiple Invariant Sections with the same name but
|
||||
different contents, make the title of each such section unique by
|
||||
adding at the end of it, in parentheses, the name of the original
|
||||
author or publisher of that section if known, or else a unique number.
|
||||
Make the same adjustment to the section titles in the list of
|
||||
Invariant Sections in the license notice of the combined work.
|
||||
|
||||
In the combination, you must combine any sections Entitled "History"
|
||||
in the various original documents, forming one section Entitled
|
||||
"History"; likewise combine any sections Entitled "Acknowledgements",
|
||||
and any sections Entitled "Dedications". You must delete all sections
|
||||
Entitled "Endorsements".
|
||||
|
||||
|
||||
6. COLLECTIONS OF DOCUMENTS
|
||||
|
||||
You may make a collection consisting of the Document and other documents
|
||||
released under this License, and replace the individual copies of this
|
||||
License in the various documents with a single copy that is included in
|
||||
the collection, provided that you follow the rules of this License for
|
||||
verbatim copying of each of the documents in all other respects.
|
||||
|
||||
You may extract a single document from such a collection, and distribute
|
||||
it individually under this License, provided you insert a copy of this
|
||||
License into the extracted document, and follow this License in all
|
||||
other respects regarding verbatim copying of that document.
|
||||
|
||||
|
||||
7. AGGREGATION WITH INDEPENDENT WORKS
|
||||
|
||||
A compilation of the Document or its derivatives with other separate
|
||||
and independent documents or works, in or on a volume of a storage or
|
||||
distribution medium, is called an "aggregate" if the copyright
|
||||
resulting from the compilation is not used to limit the legal rights
|
||||
of the compilation's users beyond what the individual works permit.
|
||||
When the Document is included in an aggregate, this License does not
|
||||
apply to the other works in the aggregate which are not themselves
|
||||
derivative works of the Document.
|
||||
|
||||
If the Cover Text requirement of section 3 is applicable to these
|
||||
copies of the Document, then if the Document is less than one half of
|
||||
the entire aggregate, the Document's Cover Texts may be placed on
|
||||
covers that bracket the Document within the aggregate, or the
|
||||
electronic equivalent of covers if the Document is in electronic form.
|
||||
Otherwise they must appear on printed covers that bracket the whole
|
||||
aggregate.
|
||||
|
||||
|
||||
8. TRANSLATION
|
||||
|
||||
Translation is considered a kind of modification, so you may
|
||||
distribute translations of the Document under the terms of section 4.
|
||||
Replacing Invariant Sections with translations requires special
|
||||
permission from their copyright holders, but you may include
|
||||
translations of some or all Invariant Sections in addition to the
|
||||
original versions of these Invariant Sections. You may include a
|
||||
translation of this License, and all the license notices in the
|
||||
Document, and any Warranty Disclaimers, provided that you also include
|
||||
the original English version of this License and the original versions
|
||||
of those notices and disclaimers. In case of a disagreement between
|
||||
the translation and the original version of this License or a notice
|
||||
or disclaimer, the original version will prevail.
|
||||
|
||||
If a section in the Document is Entitled "Acknowledgements",
|
||||
"Dedications", or "History", the requirement (section 4) to Preserve
|
||||
its Title (section 1) will typically require changing the actual
|
||||
title.
|
||||
|
||||
|
||||
9. TERMINATION
|
||||
|
||||
You may not copy, modify, sublicense, or distribute the Document except
|
||||
as expressly provided for under this License. Any other attempt to
|
||||
copy, modify, sublicense or distribute the Document is void, and will
|
||||
automatically terminate your rights under this License. However,
|
||||
parties who have received copies, or rights, from you under this
|
||||
License will not have their licenses terminated so long as such
|
||||
parties remain in full compliance.
|
||||
|
||||
|
||||
10. FUTURE REVISIONS OF THIS LICENSE
|
||||
|
||||
The Free Software Foundation may publish new, revised versions
|
||||
of the GNU Free Documentation License from time to time. Such new
|
||||
versions will be similar in spirit to the present version, but may
|
||||
differ in detail to address new problems or concerns. See
|
||||
http://www.gnu.org/copyleft/.
|
||||
|
||||
Each version of the License is given a distinguishing version number.
|
||||
If the Document specifies that a particular numbered version of this
|
||||
License "or any later version" applies to it, you have the option of
|
||||
following the terms and conditions either of that specified version or
|
||||
of any later version that has been published (not as a draft) by the
|
||||
Free Software Foundation. If the Document does not specify a version
|
||||
number of this License, you may choose any version ever published (not
|
||||
as a draft) by the Free Software Foundation.
|
||||
|
||||
|
||||
ADDENDUM: How to use this License for your documents
|
||||
|
||||
To use this License in a document you have written, include a copy of
|
||||
the License in the document and put the following copyright and
|
||||
license notices just after the title page:
|
||||
|
||||
Copyright (c) YEAR YOUR NAME.
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.2
|
||||
or any later version published by the Free Software Foundation;
|
||||
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
|
||||
A copy of the license is included in the section entitled "GNU
|
||||
Free Documentation License".
|
||||
|
||||
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
|
||||
replace the "with...Texts." line with this:
|
||||
|
||||
with the Invariant Sections being LIST THEIR TITLES, with the
|
||||
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
|
||||
|
||||
If you have Invariant Sections without Cover Texts, or some other
|
||||
combination of the three, merge those two alternatives to suit the
|
||||
situation.
|
||||
|
||||
If your document contains nontrivial examples of program code, we
|
||||
recommend releasing these examples in parallel under your choice of
|
||||
free software license, such as the GNU General Public License,
|
||||
to permit their use in free software.</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_gnu_general_public_license_gpl.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Licensing</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>GNU General Public License (GPL)</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,477 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>GNU General Public License (GPL)</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="Licensing"
|
||||
HREF="_licensing.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="GNU Free Documentation License (FDL)"
|
||||
HREF="_gnu_free_documentation_license_fdl.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_gnu_free_documentation_license_fdl.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 6. Licensing</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
> </TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_gnu_general_public_license_gpl"
|
||||
>6.3. GNU General Public License (GPL)</A
|
||||
></H1
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
> GNU GENERAL PUBLIC LICENSE
|
||||
Version 2, June 1991
|
||||
|
||||
Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The licenses for most software are designed to take away your
|
||||
freedom to share and change it. By contrast, the GNU General Public
|
||||
License is intended to guarantee your freedom to share and change free
|
||||
software--to make sure the software is free for all its users. This
|
||||
General Public License applies to most of the Free Software
|
||||
Foundation's software and to any other program whose authors commit to
|
||||
using it. (Some other Free Software Foundation software is covered by
|
||||
the GNU Lesser General Public License instead.) You can apply it to
|
||||
your programs, too.
|
||||
|
||||
When we speak of free software, we are referring to freedom, not
|
||||
price. Our General Public Licenses are designed to make sure that you
|
||||
have the freedom to distribute copies of free software (and charge for
|
||||
this service if you wish), that you receive source code or can get it
|
||||
if you want it, that you can change the software or use pieces of it
|
||||
in new free programs; and that you know you can do these things.
|
||||
|
||||
To protect your rights, we need to make restrictions that forbid
|
||||
anyone to deny you these rights or to ask you to surrender the rights.
|
||||
These restrictions translate to certain responsibilities for you if you
|
||||
distribute copies of the software, or if you modify it.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must give the recipients all the rights that
|
||||
you have. You must make sure that they, too, receive or can get the
|
||||
source code. And you must show them these terms so they know their
|
||||
rights.
|
||||
|
||||
We protect your rights with two steps: (1) copyright the software, and
|
||||
(2) offer you this license which gives you legal permission to copy,
|
||||
distribute and/or modify the software.
|
||||
|
||||
Also, for each author's protection and ours, we want to make certain
|
||||
that everyone understands that there is no warranty for this free
|
||||
software. If the software is modified by someone else and passed on, we
|
||||
want its recipients to know that what they have is not the original, so
|
||||
that any problems introduced by others will not reflect on the original
|
||||
authors' reputations.
|
||||
|
||||
Finally, any free program is threatened constantly by software
|
||||
patents. We wish to avoid the danger that redistributors of a free
|
||||
program will individually obtain patent licenses, in effect making the
|
||||
program proprietary. To prevent this, we have made it clear that any
|
||||
patent must be licensed for everyone's free use or not licensed at all.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
GNU GENERAL PUBLIC LICENSE
|
||||
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
||||
|
||||
0. This License applies to any program or other work which contains
|
||||
a notice placed by the copyright holder saying it may be distributed
|
||||
under the terms of this General Public License. The "Program", below,
|
||||
refers to any such program or work, and a "work based on the Program"
|
||||
means either the Program or any derivative work under copyright law:
|
||||
that is to say, a work containing the Program or a portion of it,
|
||||
either verbatim or with modifications and/or translated into another
|
||||
language. (Hereinafter, translation is included without limitation in
|
||||
the term "modification".) Each licensee is addressed as "you".
|
||||
|
||||
Activities other than copying, distribution and modification are not
|
||||
covered by this License; they are outside its scope. The act of
|
||||
running the Program is not restricted, and the output from the Program
|
||||
is covered only if its contents constitute a work based on the
|
||||
Program (independent of having been made by running the Program).
|
||||
Whether that is true depends on what the Program does.
|
||||
|
||||
1. You may copy and distribute verbatim copies of the Program's
|
||||
source code as you receive it, in any medium, provided that you
|
||||
conspicuously and appropriately publish on each copy an appropriate
|
||||
copyright notice and disclaimer of warranty; keep intact all the
|
||||
notices that refer to this License and to the absence of any warranty;
|
||||
and give any other recipients of the Program a copy of this License
|
||||
along with the Program.
|
||||
|
||||
You may charge a fee for the physical act of transferring a copy, and
|
||||
you may at your option offer warranty protection in exchange for a fee.
|
||||
|
||||
2. You may modify your copy or copies of the Program or any portion
|
||||
of it, thus forming a work based on the Program, and copy and
|
||||
distribute such modifications or work under the terms of Section 1
|
||||
above, provided that you also meet all of these conditions:
|
||||
|
||||
a) You must cause the modified files to carry prominent notices
|
||||
stating that you changed the files and the date of any change.
|
||||
|
||||
b) You must cause any work that you distribute or publish, that in
|
||||
whole or in part contains or is derived from the Program or any
|
||||
part thereof, to be licensed as a whole at no charge to all third
|
||||
parties under the terms of this License.
|
||||
|
||||
c) If the modified program normally reads commands interactively
|
||||
when run, you must cause it, when started running for such
|
||||
interactive use in the most ordinary way, to print or display an
|
||||
announcement including an appropriate copyright notice and a
|
||||
notice that there is no warranty (or else, saying that you provide
|
||||
a warranty) and that users may redistribute the program under
|
||||
these conditions, and telling the user how to view a copy of this
|
||||
License. (Exception: if the Program itself is interactive but
|
||||
does not normally print such an announcement, your work based on
|
||||
the Program is not required to print an announcement.)
|
||||
|
||||
These requirements apply to the modified work as a whole. If
|
||||
identifiable sections of that work are not derived from the Program,
|
||||
and can be reasonably considered independent and separate works in
|
||||
themselves, then this License, and its terms, do not apply to those
|
||||
sections when you distribute them as separate works. But when you
|
||||
distribute the same sections as part of a whole which is a work based
|
||||
on the Program, the distribution of the whole must be on the terms of
|
||||
this License, whose permissions for other licensees extend to the
|
||||
entire whole, and thus to each and every part regardless of who wrote it.
|
||||
|
||||
Thus, it is not the intent of this section to claim rights or contest
|
||||
your rights to work written entirely by you; rather, the intent is to
|
||||
exercise the right to control the distribution of derivative or
|
||||
collective works based on the Program.
|
||||
|
||||
In addition, mere aggregation of another work not based on the Program
|
||||
with the Program (or with a work based on the Program) on a volume of
|
||||
a storage or distribution medium does not bring the other work under
|
||||
the scope of this License.
|
||||
|
||||
3. You may copy and distribute the Program (or a work based on it,
|
||||
under Section 2) in object code or executable form under the terms of
|
||||
Sections 1 and 2 above provided that you also do one of the following:
|
||||
|
||||
a) Accompany it with the complete corresponding machine-readable
|
||||
source code, which must be distributed under the terms of Sections
|
||||
1 and 2 above on a medium customarily used for software interchange; or,
|
||||
|
||||
b) Accompany it with a written offer, valid for at least three
|
||||
years, to give any third party, for a charge no more than your
|
||||
cost of physically performing source distribution, a complete
|
||||
machine-readable copy of the corresponding source code, to be
|
||||
distributed under the terms of Sections 1 and 2 above on a medium
|
||||
customarily used for software interchange; or,
|
||||
|
||||
c) Accompany it with the information you received as to the offer
|
||||
to distribute corresponding source code. (This alternative is
|
||||
allowed only for noncommercial distribution and only if you
|
||||
received the program in object code or executable form with such
|
||||
an offer, in accord with Subsection b above.)
|
||||
|
||||
The source code for a work means the preferred form of the work for
|
||||
making modifications to it. For an executable work, complete source
|
||||
code means all the source code for all modules it contains, plus any
|
||||
associated interface definition files, plus the scripts used to
|
||||
control compilation and installation of the executable. However, as a
|
||||
special exception, the source code distributed need not include
|
||||
anything that is normally distributed (in either source or binary
|
||||
form) with the major components (compiler, kernel, and so on) of the
|
||||
operating system on which the executable runs, unless that component
|
||||
itself accompanies the executable.
|
||||
|
||||
If distribution of executable or object code is made by offering
|
||||
access to copy from a designated place, then offering equivalent
|
||||
access to copy the source code from the same place counts as
|
||||
distribution of the source code, even though third parties are not
|
||||
compelled to copy the source along with the object code.
|
||||
|
||||
4. You may not copy, modify, sublicense, or distribute the Program
|
||||
except as expressly provided under this License. Any attempt
|
||||
otherwise to copy, modify, sublicense or distribute the Program is
|
||||
void, and will automatically terminate your rights under this License.
|
||||
However, parties who have received copies, or rights, from you under
|
||||
this License will not have their licenses terminated so long as such
|
||||
parties remain in full compliance.
|
||||
|
||||
5. You are not required to accept this License, since you have not
|
||||
signed it. However, nothing else grants you permission to modify or
|
||||
distribute the Program or its derivative works. These actions are
|
||||
prohibited by law if you do not accept this License. Therefore, by
|
||||
modifying or distributing the Program (or any work based on the
|
||||
Program), you indicate your acceptance of this License to do so, and
|
||||
all its terms and conditions for copying, distributing or modifying
|
||||
the Program or works based on it.
|
||||
|
||||
6. Each time you redistribute the Program (or any work based on the
|
||||
Program), the recipient automatically receives a license from the
|
||||
original licensor to copy, distribute or modify the Program subject to
|
||||
these terms and conditions. You may not impose any further
|
||||
restrictions on the recipients' exercise of the rights granted herein.
|
||||
You are not responsible for enforcing compliance by third parties to
|
||||
this License.
|
||||
|
||||
7. If, as a consequence of a court judgment or allegation of patent
|
||||
infringement or for any other reason (not limited to patent issues),
|
||||
conditions are imposed on you (whether by court order, agreement or
|
||||
otherwise) that contradict the conditions of this License, they do not
|
||||
excuse you from the conditions of this License. If you cannot
|
||||
distribute so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you
|
||||
may not distribute the Program at all. For example, if a patent
|
||||
license would not permit royalty-free redistribution of the Program by
|
||||
all those who receive copies directly or indirectly through you, then
|
||||
the only way you could satisfy both it and this License would be to
|
||||
refrain entirely from distribution of the Program.
|
||||
|
||||
If any portion of this section is held invalid or unenforceable under
|
||||
any particular circumstance, the balance of the section is intended to
|
||||
apply and the section as a whole is intended to apply in other
|
||||
circumstances.
|
||||
|
||||
It is not the purpose of this section to induce you to infringe any
|
||||
patents or other property right claims or to contest validity of any
|
||||
such claims; this section has the sole purpose of protecting the
|
||||
integrity of the free software distribution system, which is
|
||||
implemented by public license practices. Many people have made
|
||||
generous contributions to the wide range of software distributed
|
||||
through that system in reliance on consistent application of that
|
||||
system; it is up to the author/donor to decide if he or she is willing
|
||||
to distribute software through any other system and a licensee cannot
|
||||
impose that choice.
|
||||
|
||||
This section is intended to make thoroughly clear what is believed to
|
||||
be a consequence of the rest of this License.
|
||||
|
||||
8. If the distribution and/or use of the Program is restricted in
|
||||
certain countries either by patents or by copyrighted interfaces, the
|
||||
original copyright holder who places the Program under this License
|
||||
may add an explicit geographical distribution limitation excluding
|
||||
those countries, so that distribution is permitted only in or among
|
||||
countries not thus excluded. In such case, this License incorporates
|
||||
the limitation as if written in the body of this License.
|
||||
|
||||
9. The Free Software Foundation may publish revised and/or new versions
|
||||
of the General Public License from time to time. Such new versions will
|
||||
be similar in spirit to the present version, but may differ in detail to
|
||||
address new problems or concerns.
|
||||
|
||||
Each version is given a distinguishing version number. If the Program
|
||||
specifies a version number of this License which applies to it and "any
|
||||
later version", you have the option of following the terms and conditions
|
||||
either of that version or of any later version published by the Free
|
||||
Software Foundation. If the Program does not specify a version number of
|
||||
this License, you may choose any version ever published by the Free Software
|
||||
Foundation.
|
||||
|
||||
10. If you wish to incorporate parts of the Program into other free
|
||||
programs whose distribution conditions are different, write to the author
|
||||
to ask for permission. For software which is copyrighted by the Free
|
||||
Software Foundation, write to the Free Software Foundation; we sometimes
|
||||
make exceptions for this. Our decision will be guided by the two goals
|
||||
of preserving the free status of all derivatives of our free software and
|
||||
of promoting the sharing and reuse of software generally.
|
||||
|
||||
NO WARRANTY
|
||||
|
||||
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
||||
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
||||
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
||||
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
||||
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
||||
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
||||
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
||||
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
||||
REPAIR OR CORRECTION.
|
||||
|
||||
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
||||
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
||||
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
||||
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
||||
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
||||
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
||||
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
||||
POSSIBILITY OF SUCH DAMAGES.
|
||||
|
||||
END OF TERMS AND CONDITIONS
|
||||
|
||||
How to Apply These Terms to Your New Programs
|
||||
|
||||
If you develop a new program, and you want it to be of the greatest
|
||||
possible use to the public, the best way to achieve this is to make it
|
||||
free software which everyone can redistribute and change under these terms.
|
||||
|
||||
To do so, attach the following notices to the program. It is safest
|
||||
to attach them to the start of each source file to most effectively
|
||||
convey the exclusion of warranty; and each file should have at least
|
||||
the "copyright" line and a pointer to where the full notice is found.
|
||||
|
||||
<one line to give the program's name and a brief idea of what it does.>
|
||||
Copyright (C) <year> <name of author>
|
||||
|
||||
This program is free software; you can redistribute it and/or modify
|
||||
it under the terms of the GNU General Public License as published by
|
||||
the Free Software Foundation; either version 2 of the License, or
|
||||
(at your option) any later version.
|
||||
|
||||
This program is distributed in the hope that it will be useful,
|
||||
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
GNU General Public License for more details.
|
||||
|
||||
You should have received a copy of the GNU General Public License along
|
||||
with this program; if not, write to the Free Software Foundation, Inc.,
|
||||
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program is interactive, make it output a short notice like this
|
||||
when it starts in an interactive mode:
|
||||
|
||||
Gnomovision version 69, Copyright (C) year name of author
|
||||
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
||||
This is free software, and you are welcome to redistribute it
|
||||
under certain conditions; type `show c' for details.
|
||||
|
||||
The hypothetical commands `show w' and `show c' should show the appropriate
|
||||
parts of the General Public License. Of course, the commands you use may
|
||||
be called something other than `show w' and `show c'; they could even be
|
||||
mouse-clicks or menu items--whatever suits your program.
|
||||
|
||||
You should also get your employer (if you work as a programmer) or your
|
||||
school, if any, to sign a "copyright disclaimer" for the program, if
|
||||
necessary. Here is a sample; alter the names:
|
||||
|
||||
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
||||
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
||||
|
||||
<signature of Ty Coon>, 1 April 1989
|
||||
Ty Coon, President of Vice
|
||||
|
||||
This General Public License does not permit incorporating your program into
|
||||
proprietary programs. If your program is a subroutine library, you may
|
||||
consider it more useful to permit linking proprietary applications with the
|
||||
library. If this is what you want to do, use the GNU Lesser General
|
||||
Public License instead of this License.</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_gnu_free_documentation_license_fdl.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>GNU Free Documentation License (FDL)</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_licensing.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,350 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Internals</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="JTAG commands"
|
||||
HREF="_jtag_commands.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Drivers"
|
||||
HREF="_drivers.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_jtag_commands.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_drivers.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_internals"
|
||||
></A
|
||||
>Chapter 4. Internals</H1
|
||||
><P
|
||||
>This section yet is only a placeholder for the information that will
|
||||
be added soon…</P
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_files"
|
||||
>4.1. Files</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_source_code_overview"
|
||||
>4.1.1. Source code Overview</A
|
||||
></H2
|
||||
><DIV
|
||||
CLASS="informaltable"
|
||||
><P
|
||||
></P
|
||||
><A
|
||||
NAME="AEN817"
|
||||
></A
|
||||
><TABLE
|
||||
BORDER="0"
|
||||
FRAME="void"
|
||||
RULES="none"
|
||||
CLASS="CALSTABLE"
|
||||
><COL
|
||||
WIDTH="3*"><COL
|
||||
WIDTH="7*"><TBODY
|
||||
VALIGN="top"
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> doc/
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Documentation
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> data/
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Part descriptions (Data files)
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> include/
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> C header files
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> C source code
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/bsdl
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> BSDL subsystem
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/bus
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Bus driver for various CPUs and other parts
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/cmd
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Implementation of the commands for the "jtag" shell
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/flash
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Flash detection and programming algorithms
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/jim
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> JIM, the JTAG target simulator
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/lib
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Utility functions
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/part
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Functions for accessing specific parts in a chain
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/svf
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> SVF player
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
><P
|
||||
> src/tap
|
||||
</P
|
||||
></TD
|
||||
><TD
|
||||
> <P
|
||||
> Functions for accessing the chain in general
|
||||
</P
|
||||
>
|
||||
</TD
|
||||
></TR
|
||||
></TBODY
|
||||
></TABLE
|
||||
><P
|
||||
></P
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_jtag_commands.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_drivers.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>JTAG commands</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Drivers</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,152 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Licensing</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="F.A.Q."
|
||||
HREF="_f_a_q.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="GNU Free Documentation License (FDL)"
|
||||
HREF="_gnu_free_documentation_license_fdl.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_f_a_q.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_gnu_free_documentation_license_fdl.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_licensing"
|
||||
></A
|
||||
>Chapter 6. Licensing</H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_overview_2"
|
||||
>6.1. Overview</A
|
||||
></H1
|
||||
><P
|
||||
>Various licenses are used for the UrJTAG project. The GPL is used for most
|
||||
of the code except for some include files, JIM, and cable driver source, where
|
||||
a BSD or MIT license is used; this is noted in the file headers.</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_f_a_q.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_gnu_free_documentation_license_fdl.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>F.A.Q.</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>GNU Free Documentation License (FDL)</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,536 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>System requirements</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="General"
|
||||
HREF="_general.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="UrJTAG"
|
||||
HREF="_urjtag.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Compilation and installation"
|
||||
HREF="_compilation_and_installation.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_urjtag.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 2. General</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_compilation_and_installation.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_system_requirements"
|
||||
>2.3. System requirements</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_supported_host_operating_systems"
|
||||
>2.3.1. Supported host operating systems</A
|
||||
></H2
|
||||
><P
|
||||
>JTAG Tools should run on all Unix like operating systems including MS Windows
|
||||
with Cygwin installed.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_required_software_for_running_urjtag"
|
||||
>2.3.2. Required software for running UrJTAG</A
|
||||
></H2
|
||||
><P
|
||||
>Required only for MS Windows:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> current Cygwin net installation from http://cygwin.com
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> ioperm package (a part of the standard Cygwin net installation)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
><P
|
||||
>It may be necessary to run the command "ioperm -i" to install the IOPERM.SYS
|
||||
driver in the system.</P
|
||||
><P
|
||||
>If UrJTAG was compiled to use the readline library, it has to be present on
|
||||
the system as well. It's probably a standard part of your distribution.</P
|
||||
><P
|
||||
>More software is needed if you want to compile UrJTAG (which you probably want
|
||||
because currently no pre-compiled binaries are avaible…). See "Installation"
|
||||
below.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_supported_jtag_adapters_cables"
|
||||
>2.3.3. Supported JTAG adapters/cables</A
|
||||
></H2
|
||||
><P
|
||||
>See <SPAN
|
||||
CLASS="emphasis"
|
||||
><I
|
||||
CLASS="emphasis"
|
||||
>help cable</I
|
||||
></SPAN
|
||||
> command for up-to-date info.</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> Arcom JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Altera ByteBlaster/ByteBlaster II/ByteBlasterMV Parallel Port Download Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Altera USB-Blaster and compatible http://www.ixo.de/info/usb_jtag
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx DLC5 JTAG Parallel Cable III
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> ETC EA253 JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> ETC EI012 JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Ka-Ro TRITON (PXA255/250) JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Keith &amp; Koep JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Lattice Parallel Port JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Mpcbdm JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Macraigor Wiggler JTAG Cable
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Amontec JTAGkey (FT2232-based)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Olimex ARM-USB-JTAG (FT2232-based)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Olimex ARM-USB-TINY (FT2232-based)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> OOCDLink-s (FT2232-based) (experimental) http://www.joernonline.de/dw/doku.php?id=projects:oocdlink:2_oocdlinks
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Other FT2232-based USB JTAG cables (experimental)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xverve Signalyzer Tool (FT2232-based) (experimental)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Turtelizer 2 (FT2232-based) (experimental) http://www.ethernut.de/en/hardware/turtelizer/
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> USB to JTAG Interface (FT2232-based) (experimental) http://www.hs-augsburg.de/~hhoegl/proj/usbjtag/usbjtag.html
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx Platform USB Cable (experimental)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_jtag_aware_parts_chips"
|
||||
>2.3.4. JTAG-aware parts (chips)</A
|
||||
></H2
|
||||
><P
|
||||
>The data/ directory of the UrJTAG installation has some more, but at
|
||||
least the following are supported:</P
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> Altera EP1C20F400
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Altera EPM7128AETC100
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Analog Devices Sharc-21065L
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Atmel ATmega128 (partial support)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Broadcom BCM1250
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Broadcom BCM3310 (partial support)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Broadcom BCM5421S
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Broadcom BCM4712 (partial support)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> DEC SA1100
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Hitachi HD64465
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Hitachi SH7727
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Hitachi SH7729
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> IBM PowerPC 440GX
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Intel IXP425
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Intel SA1110
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Intel PXA250/PXA255/PXA260/PXA261/PXA262/PXA263
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Lattice LC4032V
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Lattice M4A3-64/32
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Lattice M4A3-256/192
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Motorola MPC8245
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Samsung S3C4510B
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Sharp LH7A400
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Toshiba TX4925/TX4926
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx XC2C256-TQ144
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx XCR3032XL-VQ44
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx XCR3128XL-CS144
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx XCR3128XL-VQ100
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Xilinx XCR3256XL-FT256
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_flash_chips"
|
||||
>2.3.5. Flash chips</A
|
||||
></H2
|
||||
><DIV
|
||||
CLASS="note"
|
||||
><P
|
||||
></P
|
||||
><TABLE
|
||||
CLASS="note"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="25"
|
||||
ALIGN="CENTER"
|
||||
VALIGN="TOP"
|
||||
><IMG
|
||||
SRC="../images/note.gif"
|
||||
HSPACE="5"
|
||||
ALT="Note"></TD
|
||||
><TD
|
||||
ALIGN="LEFT"
|
||||
VALIGN="TOP"
|
||||
><P
|
||||
>Not all chips are supported in every possible configuration, there may
|
||||
be untested combinations of chip type, bus width, …</P
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
><P
|
||||
></P
|
||||
><UL
|
||||
><LI
|
||||
><P
|
||||
> Intel 28FxxxJ3A (28F320J3A, 28F640J3A, 28F128J3A)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Intel 28FxxxK3 (28F640K3, 28F128K3, 28F256K3)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> Intel 28FxxxK18 (28F640K18, 28F128K18, 28F256K18)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> AMD Am29LV64xD (Am29LV640D, Am29LV641D, Am29LV642D)
|
||||
</P
|
||||
></LI
|
||||
><LI
|
||||
><P
|
||||
> AMD Am29xx040B (Am29F040B, Am29LV040B)
|
||||
</P
|
||||
></LI
|
||||
></UL
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_urjtag.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_compilation_and_installation.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>UrJTAG</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Compilation and installation</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,268 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>UrJTAG</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="UP"
|
||||
TITLE="General"
|
||||
HREF="_general.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="General"
|
||||
HREF="_general.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="System requirements"
|
||||
HREF="_system_requirements.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="section"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
>Chapter 2. General</TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_system_requirements.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_urjtag"
|
||||
>2.2. UrJTAG</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_introduction_2"
|
||||
>2.2.1. Introduction</A
|
||||
></H2
|
||||
><P
|
||||
>UrJTAG Tools is a software package which enables working with JTAG-aware (IEEE
|
||||
1149.1) hardware devices (parts) and boards through JTAG adapter.</P
|
||||
><P
|
||||
>This package has open and modular architecture with ability to write
|
||||
miscellaneous extensions (like board testers, flash memory programmers, and so
|
||||
on).</P
|
||||
><P
|
||||
>JTAG Tools package 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 JTAG Tools. Please read
|
||||
COPYING file for more info.</P
|
||||
><DIV
|
||||
CLASS="warning"
|
||||
><P
|
||||
></P
|
||||
><TABLE
|
||||
CLASS="warning"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="25"
|
||||
ALIGN="CENTER"
|
||||
VALIGN="TOP"
|
||||
><IMG
|
||||
SRC="../images/warning.gif"
|
||||
HSPACE="5"
|
||||
ALT="Warning"></TD
|
||||
><TD
|
||||
ALIGN="LEFT"
|
||||
VALIGN="TOP"
|
||||
><P
|
||||
>This software may damage your hardware!</P
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
><P
|
||||
>Feedback and contributions are welcome.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_about_this_document"
|
||||
>2.2.2. About this document</A
|
||||
></H2
|
||||
><P
|
||||
>This documentation is far from being complete. You're encouraged to amend and
|
||||
supplement it and submit your changes in the Bugs or Enhancements tracker
|
||||
at the UrJTAG website.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_urjtag_website"
|
||||
>2.2.3. UrJTAG Website</A
|
||||
></H2
|
||||
><P
|
||||
>The most current version of this documentation and UrJTAG sourcecode
|
||||
is always available from the project homepage at http://www.urjtag.org</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_the_name_urjtag"
|
||||
>2.2.4. The name "UrJTAG"</A
|
||||
></H2
|
||||
><P
|
||||
>I (Kolja) favour short names, so I thought about adding only a few
|
||||
letters to "JTAG". The prefix "Ur" in German means "ancestral", an "Ur-Vater"
|
||||
is a forefather. UrJTAG shall become the forefather, the prototype for many
|
||||
other JTAG tools. By mere chance the "Ur" is also another name for an aurochs,
|
||||
an animal similar to the GNU…</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_authors_contributors_8230_thanks"
|
||||
>2.2.5. Authors, contributors, … thanks</A
|
||||
></H2
|
||||
><P
|
||||
>A list of contributors is maintained in the file THANKS in the source
|
||||
distribution. Special thanks go to Marcel Telka, who actually "invented" the
|
||||
JTAG tools and wrote most of this basis of UrJTAG, and Arnim Laeuger for his
|
||||
continuous support and development of SVF and BSDL subsystem and FT2232
|
||||
drivers.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_urjtag_and_openwince_jtag_tools"
|
||||
>2.2.6. UrJTAG and openwince JTAG Tools</A
|
||||
></H2
|
||||
><P
|
||||
>The JTAG Tools originally were developed by Marcel Telka as part of
|
||||
the openwince project. Still a large portion of the source code is his work.
|
||||
However, the last release of the JTAG tools was version 0.5.1 in 2003. After a
|
||||
few years the development completely stalled. Every few months or so on the
|
||||
project's mailing list someone asked about continuing, but a critical mass
|
||||
wasn't reached before late 2007. A fork of the JTAG tools was created under the
|
||||
wings of the UrJTAG project at Sourceforge.</P
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_system_requirements.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>General</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_general.html"
|
||||
ACCESSKEY="U"
|
||||
>Up</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>System requirements</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,322 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Usage</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="HOME"
|
||||
TITLE="Universal JTAG library, server and tools"
|
||||
HREF="index.html"><LINK
|
||||
REL="PREVIOUS"
|
||||
TITLE="Compilation and installation"
|
||||
HREF="_compilation_and_installation.html"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="JTAG commands"
|
||||
HREF="_jtag_commands.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="chapter"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="NAVHEADER"
|
||||
><TABLE
|
||||
SUMMARY="Header navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TH
|
||||
COLSPAN="3"
|
||||
ALIGN="center"
|
||||
>Universal JTAG library, server and tools</TH
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="left"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_compilation_and_installation.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="80%"
|
||||
ALIGN="center"
|
||||
VALIGN="bottom"
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="10%"
|
||||
ALIGN="right"
|
||||
VALIGN="bottom"
|
||||
><A
|
||||
HREF="_jtag_commands.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
></TABLE
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"></DIV
|
||||
><DIV
|
||||
CLASS="chapter"
|
||||
><H1
|
||||
><A
|
||||
NAME="_usage"
|
||||
></A
|
||||
>Chapter 3. Usage</H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H1
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_quick_start"
|
||||
>3.1. Quick start</A
|
||||
></H1
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_run_the_software"
|
||||
>3.1.1. Run the software</A
|
||||
></H2
|
||||
><P
|
||||
>Connect your JTAG adapter between your PC and target device and turn
|
||||
on your device.</P
|
||||
><P
|
||||
>To run JTAG Tools type "jtag" and press Enter. jtag should start and
|
||||
display some initial informations. Output should end with line like this:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>This is "jtag command prompt". Type "help" and press Enter for initial help
|
||||
about available commands. To exit JTAG Tools type "quit" and press Enter.</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_configure_the_cable"
|
||||
>3.1.2. Configure the cable</A
|
||||
></H2
|
||||
><P
|
||||
>Type "help cable" for list of supported JTAG cables.</P
|
||||
><P
|
||||
>Type "cable" command followed by the cable name and possibly further
|
||||
arguments for cable configuration. Example:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> cable EA253 parallel 0x378
|
||||
Initializing ETC EA253 JTAG Cable on parallel port at 0x378</PRE
|
||||
><P
|
||||
>See the section about the "cable" command for details and USB support.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_detect_parts_on_the_jtag_chain"
|
||||
>3.1.3. Detect parts on the JTAG chain</A
|
||||
></H2
|
||||
><P
|
||||
>Type "detect" at the jtag command prompt:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> detect</PRE
|
||||
><P
|
||||
>Your output should look like this:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>IR length: 5
|
||||
Chain length: 1
|
||||
Device Id: 01011001001001100100000000010011
|
||||
Manufacturer: Intel
|
||||
Part: PXA250
|
||||
Stepping: C0
|
||||
Filename: /usr/local/share/urjtag/intel/pxa250/pxa250c0</PRE
|
||||
><P
|
||||
>If you get empty output or an error message your JTAG adapter is not connected
|
||||
properly, or your target board doesn't work, or it is turned off.</P
|
||||
><P
|
||||
>The "detect" command is required before all other commands.</P
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_print_current_jtag_chain_status"
|
||||
>3.1.4. Print current JTAG chain status</A
|
||||
></H2
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> print chain
|
||||
No. Manufacturer Part Stepping Instruction Register
|
||||
---------------------------------------------------------
|
||||
0 Intel PXA250 C0 BYPASS BR</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_sample_device_pin_status"
|
||||
>3.1.5. Sample device pin status</A
|
||||
></H2
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> instruction SAMPLE/PRELOAD
|
||||
jtag> shift ir
|
||||
jtag> shift dr
|
||||
jtag> dr
|
||||
1000110010000010000110010111111111111111111001101110...
|
||||
jtag> print chain
|
||||
No. Manufacturer Part Stepping Instruction Register
|
||||
------------------------------------------------------------
|
||||
0 Intel PXA250 C0 SAMPLE/PRELOAD BSR
|
||||
jtag> get signal BOOT_SEL[0]
|
||||
BOOT_SEL[0] = 0
|
||||
jtag></PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>Note: BSR is "Boundary Scan Register"</PRE
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="section"
|
||||
><H2
|
||||
CLASS="section"
|
||||
><A
|
||||
NAME="_burn_flash_connected_to_the_part"
|
||||
>3.1.6. Burn flash connected to the part</A
|
||||
></H2
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> flashmem 0 brux.b
|
||||
0x00000000
|
||||
Note: Supported configuration is 2 x 16 bit only
|
||||
BOOT_SEL: Asynchronous 32-bit ROM</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>2 x 16 bit CFI devices detected (QRY ok)!</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>program:
|
||||
block 0 unlocked
|
||||
erasing block 0: 0
|
||||
addr: 0x00002854
|
||||
verify:
|
||||
addr: 0x00002854
|
||||
Done.
|
||||
jtag></PRE
|
||||
><P
|
||||
>or:</P
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>jtag> flashmem msbin xboot.bin
|
||||
Note: Supported configuration is 2 x 16 bit only
|
||||
BOOT_SEL: Asynchronous 32-bit ROM</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>2 x 16 bit CFI devices detected (QRY ok)!</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>block 0 unlocked
|
||||
erasing block 0: 0
|
||||
program:
|
||||
record: start = 0x00000000, len = 0x00000004, checksum = 0x000001EB
|
||||
record: start = 0x00000040, len = 0x00000008, checksum = 0x000001B0
|
||||
record: start = 0x00001000, len = 0x00002B30, checksum = 0x00122CAB
|
||||
record: start = 0x00004000, len = 0x00000160, checksum = 0x0000684B
|
||||
record: start = 0x00005000, len = 0x00000054, checksum = 0x000008EE
|
||||
record: start = 0x00005054, len = 0x00000030, checksum = 0x00000DA9
|
||||
record: start = 0x00000000, len = 0x00001000, checksum = 0x00000000</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>verify:
|
||||
record: start = 0x00000000, len = 0x00000004, checksum = 0x000001EB
|
||||
record: start = 0x00000040, len = 0x00000008, checksum = 0x000001B0
|
||||
record: start = 0x00001000, len = 0x00002B30, checksum = 0x00122CAB
|
||||
record: start = 0x00004000, len = 0x00000160, checksum = 0x0000684B
|
||||
record: start = 0x00005000, len = 0x00000054, checksum = 0x000008EE
|
||||
record: start = 0x00005054, len = 0x00000030, checksum = 0x00000DA9
|
||||
record: start = 0x00000000, len = 0x00001000, checksum = 0x00000000</PRE
|
||||
><PRE
|
||||
CLASS="literallayout"
|
||||
>Done.
|
||||
jtag></PRE
|
||||
></DIV
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_compilation_and_installation.html"
|
||||
ACCESSKEY="P"
|
||||
>Prev</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="index.html"
|
||||
ACCESSKEY="H"
|
||||
>Home</A
|
||||
></TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_jtag_commands.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
>Compilation and installation</TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>JTAG commands</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
@ -0,0 +1,475 @@
|
||||
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
|
||||
<HTML
|
||||
><HEAD
|
||||
><TITLE
|
||||
>Universal JTAG library, server and tools</TITLE
|
||||
><META
|
||||
NAME="GENERATOR"
|
||||
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
|
||||
REL="NEXT"
|
||||
TITLE="Copyright"
|
||||
HREF="_copyright.html"><LINK
|
||||
REL="STYLESHEET"
|
||||
TYPE="text/css"
|
||||
HREF="UrJTAG.css"></HEAD
|
||||
><BODY
|
||||
CLASS="book"
|
||||
BGCOLOR="#FFFFFF"
|
||||
TEXT="#000000"
|
||||
LINK="#0000FF"
|
||||
VLINK="#840084"
|
||||
ALINK="#0000FF"
|
||||
><DIV
|
||||
CLASS="BOOK"
|
||||
><A
|
||||
NAME="AEN1"
|
||||
></A
|
||||
><DIV
|
||||
CLASS="TITLEPAGE"
|
||||
><H1
|
||||
CLASS="title"
|
||||
><A
|
||||
NAME="AEN2"
|
||||
>Universal JTAG library, server and tools</A
|
||||
></H1
|
||||
><H3
|
||||
CLASS="author"
|
||||
><A
|
||||
NAME="AEN5"
|
||||
></A
|
||||
>Kolja Waschk (Ed.)</H3
|
||||
><HR></DIV
|
||||
><DIV
|
||||
CLASS="TOC"
|
||||
><DL
|
||||
><DT
|
||||
><B
|
||||
>Table of Contents</B
|
||||
></DT
|
||||
><DT
|
||||
>1. <A
|
||||
HREF="_copyright.html"
|
||||
>Copyright</A
|
||||
></DT
|
||||
><DT
|
||||
>2. <A
|
||||
HREF="_general.html"
|
||||
>General</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>2.1. <A
|
||||
HREF="_general.html#_jtag"
|
||||
>JTAG</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>2.1.1. <A
|
||||
HREF="_general.html#_introduction"
|
||||
>Introduction</A
|
||||
></DT
|
||||
><DT
|
||||
>2.1.2. <A
|
||||
HREF="_general.html#_interfaces"
|
||||
>Interfaces</A
|
||||
></DT
|
||||
><DT
|
||||
>2.1.3. <A
|
||||
HREF="_general.html#_additions"
|
||||
>Additions</A
|
||||
></DT
|
||||
><DT
|
||||
>2.1.4. <A
|
||||
HREF="_general.html#_bsdl_and_urjtag_data_files"
|
||||
>BSDL and UrJTAG data files</A
|
||||
></DT
|
||||
><DT
|
||||
>2.1.5. <A
|
||||
HREF="_general.html#_svf_files"
|
||||
>SVF files</A
|
||||
></DT
|
||||
><DT
|
||||
>2.1.6. <A
|
||||
HREF="_general.html#_jam_stapl_files"
|
||||
>JAM/STAPL files</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>2.2. <A
|
||||
HREF="_urjtag.html"
|
||||
>UrJTAG</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>2.2.1. <A
|
||||
HREF="_urjtag.html#_introduction_2"
|
||||
>Introduction</A
|
||||
></DT
|
||||
><DT
|
||||
>2.2.2. <A
|
||||
HREF="_urjtag.html#_about_this_document"
|
||||
>About this document</A
|
||||
></DT
|
||||
><DT
|
||||
>2.2.3. <A
|
||||
HREF="_urjtag.html#_urjtag_website"
|
||||
>UrJTAG Website</A
|
||||
></DT
|
||||
><DT
|
||||
>2.2.4. <A
|
||||
HREF="_urjtag.html#_the_name_urjtag"
|
||||
>The name "UrJTAG"</A
|
||||
></DT
|
||||
><DT
|
||||
>2.2.5. <A
|
||||
HREF="_urjtag.html#_authors_contributors_8230_thanks"
|
||||
>Authors, contributors, … thanks</A
|
||||
></DT
|
||||
><DT
|
||||
>2.2.6. <A
|
||||
HREF="_urjtag.html#_urjtag_and_openwince_jtag_tools"
|
||||
>UrJTAG and openwince JTAG Tools</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>2.3. <A
|
||||
HREF="_system_requirements.html"
|
||||
>System requirements</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>2.3.1. <A
|
||||
HREF="_system_requirements.html#_supported_host_operating_systems"
|
||||
>Supported host operating systems</A
|
||||
></DT
|
||||
><DT
|
||||
>2.3.2. <A
|
||||
HREF="_system_requirements.html#_required_software_for_running_urjtag"
|
||||
>Required software for running UrJTAG</A
|
||||
></DT
|
||||
><DT
|
||||
>2.3.3. <A
|
||||
HREF="_system_requirements.html#_supported_jtag_adapters_cables"
|
||||
>Supported JTAG adapters/cables</A
|
||||
></DT
|
||||
><DT
|
||||
>2.3.4. <A
|
||||
HREF="_system_requirements.html#_jtag_aware_parts_chips"
|
||||
>JTAG-aware parts (chips)</A
|
||||
></DT
|
||||
><DT
|
||||
>2.3.5. <A
|
||||
HREF="_system_requirements.html#_flash_chips"
|
||||
>Flash chips</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>2.4. <A
|
||||
HREF="_compilation_and_installation.html"
|
||||
>Compilation and installation</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>2.4.1. <A
|
||||
HREF="_compilation_and_installation.html#_required_software_for_compiling_urjtag"
|
||||
>Required software for compiling UrJTAG</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.2. <A
|
||||
HREF="_compilation_and_installation.html#_required_libraries_for_usb_support"
|
||||
>Required libraries for USB support</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.3. <A
|
||||
HREF="_compilation_and_installation.html#_installing_from_source_tar_gz"
|
||||
>Installing from source tar.gz</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.4. <A
|
||||
HREF="_compilation_and_installation.html#_installing_from_subversion_repository"
|
||||
>Installing from Subversion repository</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.5. <A
|
||||
HREF="_compilation_and_installation.html#_linking_to_ftd2xx_dll_in_cygwin_environment"
|
||||
>Linking to FTD2XX.DLL in Cygwin environment</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.6. <A
|
||||
HREF="_compilation_and_installation.html#_using_libusb_win32_in_cygwin_environment"
|
||||
>Using LibUSB-Win32 in Cygwin environment</A
|
||||
></DT
|
||||
><DT
|
||||
>2.4.7. <A
|
||||
HREF="_compilation_and_installation.html#_building_the_bsdl_subsystem"
|
||||
>Building the BSDL subsystem</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>3. <A
|
||||
HREF="_usage.html"
|
||||
>Usage</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>3.1. <A
|
||||
HREF="_usage.html#_quick_start"
|
||||
>Quick start</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>3.1.1. <A
|
||||
HREF="_usage.html#_run_the_software"
|
||||
>Run the software</A
|
||||
></DT
|
||||
><DT
|
||||
>3.1.2. <A
|
||||
HREF="_usage.html#_configure_the_cable"
|
||||
>Configure the cable</A
|
||||
></DT
|
||||
><DT
|
||||
>3.1.3. <A
|
||||
HREF="_usage.html#_detect_parts_on_the_jtag_chain"
|
||||
>Detect parts on the JTAG chain</A
|
||||
></DT
|
||||
><DT
|
||||
>3.1.4. <A
|
||||
HREF="_usage.html#_print_current_jtag_chain_status"
|
||||
>Print current JTAG chain status</A
|
||||
></DT
|
||||
><DT
|
||||
>3.1.5. <A
|
||||
HREF="_usage.html#_sample_device_pin_status"
|
||||
>Sample device pin status</A
|
||||
></DT
|
||||
><DT
|
||||
>3.1.6. <A
|
||||
HREF="_usage.html#_burn_flash_connected_to_the_part"
|
||||
>Burn flash connected to the part</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>3.2. <A
|
||||
HREF="_jtag_commands.html"
|
||||
>JTAG commands</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>3.2.1. <A
|
||||
HREF="_jtag_commands.html#_overview"
|
||||
>Overview</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.2. <A
|
||||
HREF="_jtag_commands.html#_basic_commands"
|
||||
>Basic commands</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.3. <A
|
||||
HREF="_jtag_commands.html#_chain_management"
|
||||
>Chain management</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.4. <A
|
||||
HREF="_jtag_commands.html#_part_definition_commands"
|
||||
>Part definition commands</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.5. <A
|
||||
HREF="_jtag_commands.html#_tap_control"
|
||||
>TAP control</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.6. <A
|
||||
HREF="_jtag_commands.html#_ram_flash_access"
|
||||
>RAM/Flash access</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.7. <A
|
||||
HREF="_jtag_commands.html#_highlevel_commands"
|
||||
>Highlevel commands</A
|
||||
></DT
|
||||
><DT
|
||||
>3.2.8. <A
|
||||
HREF="_jtag_commands.html#_unsupported_commands"
|
||||
>Unsupported commands</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>4. <A
|
||||
HREF="_internals.html"
|
||||
>Internals</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>4.1. <A
|
||||
HREF="_internals.html#_files"
|
||||
>Files</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>4.1.1. <A
|
||||
HREF="_internals.html#_source_code_overview"
|
||||
>Source code Overview</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>4.2. <A
|
||||
HREF="_drivers.html"
|
||||
>Drivers</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>4.2.1. <A
|
||||
HREF="_drivers.html#_cable_specific_drivers_src_tap_cable"
|
||||
>Cable-specific drivers (src/tap/cable)</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>4.3. <A
|
||||
HREF="_data_file_format.html"
|
||||
>Data file format</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>4.3.1. <A
|
||||
HREF="_data_file_format.html#_general_rules"
|
||||
>General rules</A
|
||||
></DT
|
||||
><DT
|
||||
>4.3.2. <A
|
||||
HREF="_data_file_format.html#_signal_definition"
|
||||
>Signal Definition</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>4.4. <A
|
||||
HREF="_development.html"
|
||||
>Development</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>4.4.1. <A
|
||||
HREF="_development.html#_future_plans"
|
||||
>Future Plans</A
|
||||
></DT
|
||||
><DT
|
||||
>4.4.2. <A
|
||||
HREF="_development.html#_how_to_contribute"
|
||||
>How to contribute</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DD
|
||||
><DT
|
||||
>5. <A
|
||||
HREF="_f_a_q.html"
|
||||
>F.A.Q.</A
|
||||
></DT
|
||||
><DT
|
||||
>6. <A
|
||||
HREF="_licensing.html"
|
||||
>Licensing</A
|
||||
></DT
|
||||
><DD
|
||||
><DL
|
||||
><DT
|
||||
>6.1. <A
|
||||
HREF="_licensing.html#_overview_2"
|
||||
>Overview</A
|
||||
></DT
|
||||
><DT
|
||||
>6.2. <A
|
||||
HREF="_gnu_free_documentation_license_fdl.html"
|
||||
>GNU Free Documentation License (FDL)</A
|
||||
></DT
|
||||
><DT
|
||||
>6.3. <A
|
||||
HREF="_gnu_general_public_license_gpl.html"
|
||||
>GNU General Public License (GPL)</A
|
||||
></DT
|
||||
></DL
|
||||
></DD
|
||||
></DL
|
||||
></DIV
|
||||
></DIV
|
||||
><DIV
|
||||
CLASS="NAVFOOTER"
|
||||
><HR
|
||||
ALIGN="LEFT"
|
||||
WIDTH="100%"><TABLE
|
||||
SUMMARY="Footer navigation table"
|
||||
WIDTH="100%"
|
||||
BORDER="0"
|
||||
CELLPADDING="0"
|
||||
CELLSPACING="0"
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
><A
|
||||
HREF="_copyright.html"
|
||||
ACCESSKEY="N"
|
||||
>Next</A
|
||||
></TD
|
||||
></TR
|
||||
><TR
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="left"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="34%"
|
||||
ALIGN="center"
|
||||
VALIGN="top"
|
||||
> </TD
|
||||
><TD
|
||||
WIDTH="33%"
|
||||
ALIGN="right"
|
||||
VALIGN="top"
|
||||
>Copyright</TD
|
||||
></TR
|
||||
></TABLE
|
||||
></DIV
|
||||
></BODY
|
||||
></HTML
|
||||
>
|
Loading…
Reference in New Issue