X-Git-Url: https://review.openocd.org/gitweb?p=openocd.git;a=blobdiff_plain;f=doc%2Fopenocd.texi;h=8641531944d69faaf2cdbfc916bd1c969f457cf4;hp=81a45d196b73f87e04f7b947eb56993b41f351d5;hb=442f1540d5066b9ef091cab677b505f2c8196313;hpb=9a6d6b51b7428ddac6ada28dd9db589deb616f4d diff --git a/doc/openocd.texi b/doc/openocd.texi index 81a45d196b..8641531944 100644 --- a/doc/openocd.texi +++ b/doc/openocd.texi @@ -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} +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