These are the notes for building the Advanced JTAG Bridge program.
|
These are the notes for building the Advanced JTAG Bridge program.
|
Nathan Yawn, nathan.yawn@opencores.org
|
Nathan Yawn, nathan.yawn@opencores.org
|
|
|
BUILDING
|
BUILDING
|
|
|
This program doesn't use automake. It has been developed using the cygwin
|
This program doesn't use automake. It has been developed using the cygwin
|
environment under winXP, and should also compile under various GNU/Linux
|
environment under winXP, and should also compile under various GNU/Linux
|
distributions. It has been tested and in known to work with Ubuntu 9.04.
|
distributions. It has been tested and in known to work with Ubuntu 9.04.
|
There are two sets of build flags defined in the Makefile,
|
There are two sets of build flags defined in the Makefile,
|
one for cygwin and one for Linux - one set is used, one is commented out.
|
one for cygwin and one for Linux - one set is used, one is commented out.
|
Edit the Makefile for your system, type "make," and see what happens...
|
Edit the Makefile for your system, type "make," and see what happens...
|
|
|
The program may be built with support for the Advanced Debug Interface
|
The program may be built with support for the Advanced Debug Interface
|
(the default), or the legacy "debug_if" interface. To compile for the
|
(the default), or the legacy "debug_if" interface. To compile for the
|
legacy interface, __LEGACY__ should be added to CFLAGS in the Makefile
|
legacy interface, __LEGACY__ should be added to CFLAGS in the Makefile
|
(the line is present but commented out by default). Note that support
|
(the line is present but commented out by default). Note that support
|
for the two different debug hardware units is mutually exclusive; both
|
for the two different debug hardware units is mutually exclusive; both
|
cannot be supported in the same build.
|
cannot be supported in the same build.
|
|
|
DEPENDENCIES
|
DEPENDENCIES
|
|
|
Adv_jtag_bridge has three dependencies:
|
Adv_jtag_bridge has three dependencies:
|
|
|
- The pthreads library (probably already installed)
|
- The pthreads library (probably already installed)
|
- Cygwin only: libioperm (for parallel port device access permissions)
|
- Cygwin only: libioperm (for parallel port device access permissions)
|
- libusb
|
- libusb
|
|
|
Since adv_jtag_bridge was written, a newer version of libusb has been
|
Since adv_jtag_bridge was written, a newer version of libusb has been
|
released (1.0), which used a different interface. We still use the old
|
released (1.0), which used a different interface. We still use the old
|
interface (0.1), so be sure you install the "compatibility layer" if you
|
interface (0.1), so be sure you install the "compatibility layer" if you
|
install the latest libusb. As of December 2008, libUSB-Win32 still used
|
install the latest libusb. As of December 2008, libUSB-Win32 still used
|
v0.1, so cygwin users may not need to install any additional compatibility
|
v0.1, so cygwin users may not need to install any additional compatibility
|
layer.
|
layer.
|
|
|
BUGS
|
BUGS
|
|
|
GDB 6.8 has a bug which prevents it from working when no stack frame is
|
GDB 6.8 has a bug which prevents it from working when no stack frame is
|
present (such as at start-up on a bare-metal debugger, such as this one).
|
present (such as at start-up on a bare-metal debugger, such as this one).
|
A simple patch applied to GDB 6.8 will work around the problem (a general
|
A simple patch applied to GDB 6.8 will work around the problem (a general
|
solution is not yet available). This patch can be found in the source
|
solution is not yet available). This patch can be found in the source
|
directory of adv_jtag_bridge as "gdb-6.8-bz436037-reg-no-longer-active.patch".
|
directory of adv_jtag_bridge as "gdb-6.8-bz436037-reg-no-longer-active.patch".
|
|
|
LICENSE
|
LICENSE
|
|
|
This code is based on "jp2", which was distributed under the GNU Public
|
This code is based on "jp2", which was distributed under the GNU Public
|
License, version 2. Adv_jtag_bridge is therefore also distributed under
|
License, version 2. Adv_jtag_bridge is therefore also distributed under
|
this license.
|
this license.
|
|
|
WARRANTY
|
WARRANTY
|
|
|
This program is distributed in the hope that it will be useful, but WITHOUT
|
This program is distributed in the hope that it will be useful, but WITHOUT
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
|
more details.
|
more details.
|
|
|
