|
|
@@ -449,18 +449,17 @@ product. The driver can be configured to search for any VID/PID pair |
|
|
|
@* Link: @url{http://www.altera.com/literature/ug/ug_usb_blstr.pdf} |
|
|
|
@end itemize |
|
|
|
|
|
|
|
@section USB JLINK based |
|
|
|
There are several OEM versions of the Segger @b{JLINK} adapter. It is |
|
|
|
an example of a micro controller based JTAG adapter, it uses an |
|
|
|
@section USB J-Link based |
|
|
|
There are several OEM versions of the SEGGER @b{J-Link} adapter. It is |
|
|
|
an example of a microcontroller based JTAG adapter, it uses an |
|
|
|
AT91SAM764 internally. |
|
|
|
|
|
|
|
@itemize @bullet |
|
|
|
@item @b{ATMEL SAMICE} Only works with ATMEL chips! |
|
|
|
@* Link: @url{http://www.atmel.com/dyn/products/tools_card.asp?tool_id=3892} |
|
|
|
@item @b{SEGGER JLINK} |
|
|
|
@item @b{SEGGER J-Link} |
|
|
|
@* Link: @url{http://www.segger.com/jlink.html} |
|
|
|
@item @b{Atmel SAM-ICE} (Only works with Atmel chips!) |
|
|
|
@* Link: @url{http://www.atmel.com/tools/atmelsam-ice.aspx} |
|
|
|
@item @b{IAR J-Link} |
|
|
|
@* Link: @url{http://www.iar.com/en/products/hardware-debug-probes/iar-j-link/} |
|
|
|
@end itemize |
|
|
|
|
|
|
|
@section USB RLINK based |
|
|
@@ -1960,7 +1959,7 @@ Examples: |
|
|
|
@cindex translation |
|
|
|
If you have a configuration file for another hardware debugger |
|
|
|
or toolset (Abatron, BDI2000, BDI3000, CCS, |
|
|
|
Lauterbach, Segger, Macraigor, etc.), translating |
|
|
|
Lauterbach, SEGGER, Macraigor, etc.), translating |
|
|
|
it into OpenOCD syntax is often quite straightforward. The most tricky |
|
|
|
part of creating a configuration script is oftentimes the reset init |
|
|
|
sequence where e.g. PLLs, DRAM and the like is set up. |
|
|
@@ -2717,63 +2716,69 @@ This is a write-once setting. |
|
|
|
@end deffn |
|
|
|
|
|
|
|
@deffn {Interface Driver} {jlink} |
|
|
|
Segger J-Link family of USB adapters. It currently supports JTAG and SWD transports. |
|
|
|
SEGGER J-Link family of USB adapters. It currently supports JTAG and SWD |
|
|
|
transports. |
|
|
|
|
|
|
|
@quotation Compatibility Note |
|
|
|
Segger released many firmware versions for the many harware versions they |
|
|
|
SEGGER released many firmware versions for the many harware versions they |
|
|
|
produced. OpenOCD was extensively tested and intended to run on all of them, |
|
|
|
but some combinations were reported as incompatible. As a general |
|
|
|
recommendation, it is advisable to use the latest firmware version |
|
|
|
available for each hardware version. However the current V8 is a moving |
|
|
|
target, and Segger firmware versions released after the OpenOCD was |
|
|
|
target, and SEGGER firmware versions released after the OpenOCD was |
|
|
|
released may not be compatible. In such cases it is recommended to |
|
|
|
revert to the last known functional version. For 0.5.0, this is from |
|
|
|
"Feb 8 2012 14:30:39", packed with 4.42c. For 0.6.0, the last known |
|
|
|
version is from "May 3 2012 18:36:22", packed with 4.46f. |
|
|
|
@end quotation |
|
|
|
|
|
|
|
@deffn {Command} {jlink caps} |
|
|
|
Display the device firmware capabilities. |
|
|
|
@deffn {Command} {jlink hwstatus} |
|
|
|
Display various hardware related information, for example target voltage and pin |
|
|
|
states. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink info} |
|
|
|
Display various device information, like hardware version, firmware version, current bus status. |
|
|
|
@deffn {Command} {jlink freemem} |
|
|
|
Display free device internal memory. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink hw_jtag} [@option{2}|@option{3}] |
|
|
|
Set the JTAG protocol version to be used. Without argument, show the actual JTAG protocol version. |
|
|
|
@deffn {Command} {jlink jtag} [@option{2}|@option{3}] |
|
|
|
Set the JTAG command version to be used. Without argument, show the actual JTAG |
|
|
|
command version. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config} |
|
|
|
Display the J-Link configuration. |
|
|
|
Display the device configuration. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config kickstart} [val] |
|
|
|
Set the Kickstart power on JTAG-pin 19. Without argument, show the Kickstart configuration. |
|
|
|
@deffn {Command} {jlink config targetpower} [@option{on}|@option{off}] |
|
|
|
Set the target power state on JTAG-pin 19. Without argument, show the target |
|
|
|
power state. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config mac_address} [@option{ff:ff:ff:ff:ff:ff}] |
|
|
|
Set the MAC address of the J-Link Pro. Without argument, show the MAC address. |
|
|
|
@deffn {Command} {jlink config mac} [@option{ff:ff:ff:ff:ff:ff}] |
|
|
|
Set the MAC address of the device. Without argument, show the MAC address. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config ip} [@option{A.B.C.D}(@option{/E}|@option{F.G.H.I})] |
|
|
|
Set the IP configuration of the J-Link Pro, where A.B.C.D is the IP address, |
|
|
|
E the bit of the subnet mask and |
|
|
|
F.G.H.I the subnet mask. Without arguments, show the IP configuration. |
|
|
|
Set the IP configuration of the device, where A.B.C.D is the IP address, E the |
|
|
|
bit of the subnet mask and F.G.H.I the subnet mask. Without arguments, show the |
|
|
|
IP configuration. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config usb_address} [@option{0x00} to @option{0x03} or @option{0xff}] |
|
|
|
Set the USB address; this will also change the product id. Without argument, show the USB address. |
|
|
|
@deffn {Command} {jlink config usb} [@option{0} to @option{3}] |
|
|
|
Set the USB address of the device. This will also change the USB Product ID |
|
|
|
(PID) of the device. Without argument, show the USB address. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config reset} |
|
|
|
Reset the current configuration. |
|
|
|
@end deffn |
|
|
|
@deffn {Command} {jlink config save} |
|
|
|
Save the current configuration to the internal persistent storage. |
|
|
|
@end deffn |
|
|
|
@deffn {Config} {jlink pid} val |
|
|
|
Set the USB PID of the interface. As a configuration command, it can be used only before 'init'. |
|
|
|
@deffn {Command} {jlink config write} |
|
|
|
Write the current configuration to the internal persistent storage. |
|
|
|
@end deffn |
|
|
|
@deffn {Config} {jlink serial} serial-number |
|
|
|
Set the @var{serial-number} of the interface, in case more than one adapter is connected to the host. |
|
|
|
If not specified, serial numbers are not considered. |
|
|
|
@deffn {Config} {jlink usb} <@option{0} to @option{3}> |
|
|
|
Set the USB address of the interface, in case more than one adapter is connected |
|
|
|
to the host. If not specified, USB addresses are not considered. Device |
|
|
|
selection via USB address is deprecated and the serial number should be used |
|
|
|
instead. |
|
|
|
|
|
|
|
Note that there may be leading zeros in the @var{serial-number} string |
|
|
|
that will not show in the Segger software, but must be specified here. |
|
|
|
Debug level 3 output contains serial numbers if there is a mismatch. |
|
|
|
As a configuration command, it can be used only before 'init'. |
|
|
|
@end deffn |
|
|
|
@deffn {Config} {jlink serial} <serial number> |
|
|
|
Set the serial number of the interface, in case more than one adapter is |
|
|
|
connected to the host. If not specified, serial numbers are not considered. |
|
|
|
|
|
|
|
As a configuration command, it can be used only before 'init'. |
|
|
|
@end deffn |
|
|
|