J-Link / J-Trace User Guide

1 J-Link / J-TraceUser GuideDocument: UM08001 Software Version: : August 3, 2022 A product of SEGGER Microcontroller information written in this document is assumed to be accurate without guarantee. Theinformation in this manual is subject to change for functional or performance improvementswithout notice. SEGGER Microcontroller GmbH (SEGGER) assumes no responsibility for any errorsor omissions in this document. SEGGER disclaims any warranties or conditions, express, impliedor statutory for the fitness of the product for a particular purpose. It is your sole responsibilityto evaluate the fitness of the product for any specific noticeYou may not extract portions of this manual or modify the PDF file in any way without the priorwritten permission of SEGGER.

2 The software described in this document is furnished under alicense and may only be used or copied in accordance with the terms of such a license. 2004-2021 SEGGER Microcontroller GmbH, Monheim am Rhein / GermanyTrademarksNames mentioned in this manual may be trademarks of their respective and product names are trademarks or registered trademarks of their respective addressSEGGER Microcontroller GmbHEcolab-Allee 5D-40789 Monheim am / J-Trace (UM08001) 2004-2021 SEGGER Microcontroller GmbH3 Manual versionsThis manual describes the current software version. If you find an error in the manual or aproblem in the software, please report it to us and we will try to assist you as soon as us for further information on topics or functions that are not yet date: August 3, Target interfaces and adapters * Section 20-pin J-Link connector : Added sub-section Pinout for QSPI Open Flashloader * Section General procedure : Updated information regarding usage ofJLinkDevices folder.

3 * Section Information for Silicon Vendors : Updated information regardingusage of JLinkDevices folder. Working with J-Link and J-Trace * Section J-Link Command Strings : Added Reset strategies *Moved section to the Target interfaces and adapters *Section 20-pin J-Link connector *Section Pinout for SWD *Section Target power supply :The word perm was part of the wrong column. Target interfaces and adapters *Section Reference voltage (VTref) :Typo: on instead of one. Target interfaces and adapters *Section Reference voltage (VTref) :Added link to wiki article for setting a fixed VTref via J-Link Working with J-Link and J-Trace *Section JTAG interface *Section Multiple devices in the scan chain :Number of supported JTAG-chain devices updated to 32.

4 Working with J-Link and J-Trace *Section J-Link script files *Section Supported Operators :Modulo operator was listed as supported even though it is not. Working with J-Link and J-Trace *Section J-Link Command Strings added command string RTT *Section API functions :SEGGER_RTT_ConfigDownBuffer and SEGGER_RTT_ConfigUpBuffer: In the Example section both functions were falsely named. J-Link Command Strings Added missing parameters of command SetCFIF lash JTAGLoad Added missing command line option -LogFile J-Link GDB Server *Section Command line options :Replaced occurrences of OS X with macOS .Chapter J-Flash SPI Updated for recently added cross-platform availability of J-Flash J-Link Commander (Command line tool) *Section Command line options :Moved to SEGGER wiki.

5 *Section Using J-Link Command Files :Moved to SEGGER J-Link Commander (Command line tool) *Section Commands :Moved to SEGGER / J-Trace (UM08001) 2004-2021 SEGGER Microcontroller Working with J-Link and J-Trace *Section J-Link Command Strings :Expanded coresight baseaddr RTT *Section Implementation :Added API function SEGGER_RTT_GetAvailWriteSpace(). J-Link GDB Server *Section Command line options :Added information for command line option -rtos where to request theSDK for creating J-Link software and documentation package *Section J-Link Commander (Command line tool) :Added note for VTREF Working with J-Link and J-Trace *Section J-Link script files.

6 Added default return value information for J-Link script file Working with J-Link and J-Trace *Section J-Link WiFi setup Semihosting *Section Debugger Support Took off Keil MDK-ARM of the list of supported IDEs as MDK does not sup-port RTT *Section Example code J-Link software and documentation package *Section J-Link Remote Server Added command -TunnelEncrypt Added subsection Encrypted connection J-Link software and documentation package *Section J-Link Remote Server : Updated screenshots*Section J-Link Remote Server : Created examples for the syntax of J-Link software and documentation package * Section J-Link GDB Server : Command line option -JLinkDevicesXML-Path J-Link software and documentation package * Section J-Link Commander (Command line tool)Added command SetTimeoutCmd Added command readcsr Added command stepover Added command writecsr J-Link software and documentation package * Section J-Link Commander (Command line tool)Added command WebUSBE nable Added command WebUSBD isable J-Link software and documentation package * Section J-Link RTT Viewer : Updated screenshots.

7 * Section J-Link RTT Viewer : Menu entry Channel .* Section J-Link Remote Server : Updated list of available command Target interfaces and adapters * Section 20-pin J-Link connector : Corrected information for pins 14, 16,18, J-Link software and documentation pacakge * Updated J-Mem Chapter J-Mem Target interfaces and adapters * Added diagram showing J-Trace PRO connection with target J-Link software and documentation package * Section J-Link GDB Server : Command line options J-Link software and documentation package * Section J-Link Commander : Added memory zone example for com-mand mem . J-Link / J-Trace (UM08001) 2004-2021 SEGGER Microcontroller Working with J-Link and J-Trace * Section J-Link Script Files : Added new Scripting functions for ETB Working with J-Link and J-Trace * Section J-Link Command Strings : Expanded map region J-Link software and documentation package * Section J-Link SWO Viewer: Added description of command line option -usb.

8 ARM SWD specifics addedChapter ARM SWD specifics * Section SWD multi-drop J-Link software and documentation package * Section J-Link SWO Viewer : Updated description and Working with J-Link and J-Trace * Section J-Link Command Strings : Added new J-Link command string RTTT elnetAllowNonLocalClient . Target interfaces and adapters * Section 19-pin JTAG/SWD and trace connector : Added informationabout pitch of J-Link Commander * Section Commands: Added description of VTREF . Working with J-Link and J-Trace * Section J-Link Script files : Added new Script file functions to replacegeneric trace module J-Link GDB Server * Section Supported remote (monitor) commands : Added new monitorcommand flash erase.

9 J-Link software and documentation package * Section J-Flash Lite J-Link software and documentation package * Section J-Link Commander (Command line tool) : Added new commandline option -Log . Open Flashloader * Section XML Tags and Attributes : Added new <ChipInfo> attribute Aliases . J-Link software and documentation package * Section J-Link SWO Viewer : Refined CL option Working with J-Link and J-Trace * Section J-Link Command Strings : Added new J-Link command string SetEnableMemCache .Chapter Environmental Conditions & Safety J-Flash SPI * Section Command Line Interface : Updated description of CL option -jflashlog.* Section Command Line Interface : Updated description of CL option Working with J-Link and J-Trace * Section Script file API functions : Added new API functions JLINK_MEM_Preserve() , JLINK_MEM_Restore() , JLINK_MEM_Fill().

10 Working with J-Link and J-Trace * Section J-Link Command Strings : Added new J-Link command string MemPreserveOnReset . contents of chapter Segger-specific GDB protocol extensions toseparate manual (UM08036) J-Link GDB Server to separate chapterAdded Segger specific GDB protocol extension qSeggerSTRACE:capsAdded Segger specific GDB protocol extension Working with J-Link and J-Trace * Section J-Link Command Strings : Added new J-Link command string SetAllowStopMode . J-Link / J-Trace (UM08001) 2004-2021 SEGGER Microcontroller Working with J-Link and J-Trace * Section J-Link Script Files : Added new function SWO_EnableTarget();.* Section J-Link Script Files : Renamed function GetSWOBaseClock() to SWO_GetSWOBaseClock(); Added unit information of clock speed Working with J-Link and J-Trace * Section J-Link Script Files : Added new function: HandleBeforeFlashProg();* Section J-Link Script Files : Added new function HandleAfterFlashProg().