Home
J-Link / J-Trace User Guide (UM08001)
Contents
1. magaalaga al E ARM 1 Registers p 22 void Taskl void 4 Register Value 23 while 1 current 45 4 24 LED_ToggleLED1 ro 0x20001580 25 05 Delay 200 irl 0x20001588 26 i 27 2 0 00000150 0 00001 80 0 2000063 Fes 0 00001 70 29 31 main 6 0 00000000 000000000 000000000 000000000 0 00002780 33 RRRARAARARARARERE EEE REAARAREREREREREER ERA RARERERERERERE ERS 35 int main void 1 36 05 IncDI Initially disable interrupts 37 08 InitKern initialize 05 lt x 0x00000000 38 05 InitHV initialize Hardware for 05 0x00000451 39 LED Init initialize LED ports 0 200015 0 40 You need to create at least one task here 0 00001 5 41 O5_CREATETASK sTCBO HP Task Task0 100 Stack0 iene 0x00000450 42 05 CREATETASK amp TCBl LP Task Taskl 50 Stackl i cpsr nzcvqIFT SVC 43 05 Start Start multitasking i AERE 44 return 0 25 nzcvqift_User 45 E User Systen de 46 EFI ese zi ARM 1 Memory Start address 0x0 Tabl Hex No prefix Tab2 Hex No prefix Tab3 Hex No prefix Tab4 alel sE C temp embOS_StarSTR71x4RC codi ARM 1 ES9FF018 59 018 ES9FFO18 0 00000010 59 018 1400000 59 014 59 014 0 00000020 00002444 00000030 00000040 00000044 0 00000030 00000048 000022 0 0000004 EAFFFFFE 0
2. 432 G General Query Packets 120 H HalfWOrd gt 432 432 PP 432 ICE Extension Unit 432 en a ane gel 433 IEEE 1149 1 433 Image 433 In Circuit Emulator 433 Instruction Register 433 IR ore eer eder vem eee EE 433 J JzFlash ARM ur iE x TER ER 140 J Link J Trace UM08001 J Link Adapters s RA ERE 406 Developer Pack DLL 154 Supported chips 242 243 258 259 266 274 J Link Commander 83 J Link GDB Server 102 JeLink RDI 149 J Link STR9 Commander 150 J Link TCP IP Server 135 J Mem Memory Viewer 139 Joint Test Action Group JTAG 433 JTAG SR ek ERE E v PIT a ee 286 408 TAP controller 2 7 2 7 409 ITAGLOAG 148 L Little endian 433 M Memory coherency 433 Memory management unit MMU 433 Memory Protection Unit MPU 433 Menu SERUCTURG roug 281 MulticICE sages Rae aia 433 N 390 4
3. 1 6 6 254 6 8 Using the DLL flash loaders in custom applications 255 7 Hash breakpoliss isn 257 7 1 MES 258 7 2 LICENSING EE 259 7 2 1 Free for evaluation and non commercial 2 0 6 259 7 3 Supported odore Mete d exea ERR YA EX VETE annales 260 7 4 Setup amp compatibility with various debuggers 4 261 7 4 1 Setup iere deme ins pee eee D T Vere Der va ea NR S RE E ERU RR EE XR ERE MEE RR 261 7 4 2 Compatibility with various mme 261 7 5 Flash Breakpoints in QSPI flash ss 262 7 5 1 Setup 262 7 6 263 8 Monitor Mode DEBUGGING ss erre rin epe eg xt cbr peg Eben bb rd di rd 265 8 1 TMEFOGU CE OM D LL 266 8 2 Enable monitor 3 2 nmm eene 267 8 2 1 GDB based debug solutions tn en Reread a 267 8 2 2 IAR EWARM er e ea a ver E E 267 8 2 3 J LINK Commander over exert me eh CE o we re el 268 8 2 4 Generic way of enabling 4 2 41 4 4 414 44 0 nee 268 8 3 Availability and limitations of mon
4. 191 TAP Controller 7 155 e Rue ders 434 E ex REX METER 434 TEK NM LN 390 434 EL 285 TDR ESA DAR tees tats 390 434 yo E 390 435 Test Access Port 435 Transistor transistor logic TTL 435 U USB E 285 Watchpoint 2 4 435 eto A etc Re ANN pat 435 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG
5. ir Initialize the CPU registers on start of GDB Server Default noir Do not initialize CPU registers on start of GDB Server localhostonly Allow only localhost connections Windows default nolocalhostonly Allow connections from outside localhost Linux default logtofile Generate a GDB Server log file nologtofile Do not generate a GDB Server log file Default halt Halt the target on start of GDB Server nohalt Do not halt the target on start of GDB Server Default silent Do not show log output nosilent Show log output Default stayontop Set the GDB Server GUI to be the topmost window nostayontop Do not be the topmost window Default timeout Set the time after which the target has to be connected notimeout Set infinite timeout for target connection vd Verify after downloading novd Do not verify after downloading Default Table 3 8 Persistent command line options J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 124 CHAPTER 3 J Link software and documentation package Following additional command line options are available These options are tempo rary for each start of GDB Server Command line option Explanation jtagconf Configures a JTAG scan chain with multiple devices on it log Logs the GDB Server communication to a specific file singlerun Starts GDB Server in single run mode scriptfile U
6. At C Tool C EMIDEV 1 1 arm Example Vendor ATMEL_ 1 Src Main c 28 At C Tool C EMIDEV 1 1 arm Example Vendor ATMEL_ 1 Src Main c 29 Command Console GDB can be used stand alone as a console application To connect GDB to GDB Server enter target remote localhost 2331 into the run ning GDB Within GDB all GDB commands and the remote monitor commands are available For more information about debugging with GDB refer to its online manual available at http sourceware org gdb current onlinedocs gdb A typical startup of a debugging session can be like J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 107 gdb file C temp Blinky elf Reading symbols from C temp Blinky elf done gdb target remote localhost 2331 Remote debugging using localhost 2331 0x00000000 in gdb monitor reset Resetting target gdb load Loading section isr vector size 0x188 lma 0x8000000 Loading section text size 0x568 1 0x8000188 Loading section init array size 0x8 lma 0x80006f0 Loading section fini array size 0x4 lma 0x80006f8 Loading section data size 0x428 lma 0x80006fc Start address 0x8000485 load size 2852 Transfer rate 146 KB sec 570 bytes write gdb break main Breakpoint 1 at 0x800037a file Src main c line 38 gdb continue Continuing Breakpoint 1 main at Src main c 38 38 Cnt 0 gdb Eclipse CDT Eclipse is an op
7. penta Rex dle Ede DLE RE RR E 203 5 10 4 Mentor Sourcery CodeBench for nnn 203 5 11 vie Cor eg Ea HERE RE cR E ES 204 5 11 1 Actions that be customized 0 02 44 nnn 204 5 11 2 Script file API FUNCIONS cioe eut eek edet riers eines prr eR essai rana TEE SE Da 204 5 11 3 Global DLL variables s ccce crx nen n cer e E e e ER e n Re x 210 5 11 4 Global DELE cofistants E nA 213 5 11 5 Script file language octo pore meme etes cese tetuer iam pe er Cae da 215 5 11 6 Script file writing example 1 1 nnn nnn 216 5 11 7 Executing J Link script files eee e ne co e n dvd t x e nk Ri 216 5 12 Command strings cei ese et tear eer ick tea REL EY ERE E Lae SERE RAINER pes 218 5 12 1 List of available commands ss 218 5 12 2 Using command strings sce pt eno e XXE EY 235 5 13 Switching off CPU clock during debug 237 5 14 Cache handling Cocke 238 5 14 1 Cache COnerency amener ove es 238 5 14 2 Cache clean area Cece eel oid ee eee rs ee E Ec NE AER es 238 5 14 3 Cache handling of ARM7 0 10 238 5 14 4 Cache h
8. ES Section ST updated and corrected Chapter J Link and J Trace related software Section SWO Viewer added Chapter Device specifics Section ST subsection ETM init for some STM32 devices added Reno ER Section Texas Instruments updated Chapter Target interfaces and adapters Section Pinout for SWD updated Chapter Device specifics 20919 Section Texas Instruments updated V4 46 Rev O 120416 EL Chapter Support updated Chapter Working with J Link Tages De EL Section J Link script files updated Chapter Flash download added Chapter Flash breakpoints added Chapter Target interfaces and adapters V4 36 Rev 1 110927 EL Section 20 pin JTAG SWD connector updated Chapter RDI added Chapter Setup updated Chapter Device specifics updated Chapter Working with J Link Meo Reve AS Section J Link script files updated Chapter Introduction Videos s Section J Link J Trace models corrected V4 26 Rev O 110427 Several corrections Chapter Introduction Section J Link J Trace models corrected AG Chapter Device specifics Section ST Microelectronics updated Chapter Device specifics Section Samsung added V4 24 Rev 0 110216 Chapter Working with J Link Section Reset strategies updated Chapter Target interfaces and adapters Sect
9. Configure both watchdog timers to be halted if the CPU is halted by the debugger volatile int 0xE0042008 1 lt lt 11 1 12 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 384 CHAPTER 13 Device specifics 13 16 4 STM32F4xxx These devices are Cortex M4 based All devices of this family are supported by J Link 13 16 4 1ETM init The following sequence can be used to prepare STM32F4xxx devices for 4 bit ETM tracing int v Enable GPIOE clock volatile int 0x40023830 0x00000010 Assign trace pins to alternate function in order to make them usable as trace pins PE2 Trace clock PE3 TRACE_DO TRACE D1 PE5 TRACE D2 PE6 TRACE D3 volatile int 0x40021000 0 00002 0 DBGMCU_CR enable trace I O and configure pins for 4 bit trace v volatile int 0 0042004 v amp 7 lt lt 5 Preserve all bits except the trace pin configuration v 7 lt lt 5 Enable trace I O and configure pins for 4 bit trace volatile int 0xE0042004 13 16 4 2Debugging with software watchdog enabled If the device shall be debugged with one of the software watchdogs independed watchdog window watchdog enabled there is an additional init step necessary to make the watchdog counter stop when the CPU is halted by the debugger This is
10. EN nj sd st enable the clock of the PIO PMC EnablePeriphClock 91 BASE PMC 1 lt lt AT91C ID PIOA We configure the PIO Lines corresponding to LEDI to LED4 be outputs No need to set these pins to be driven by the PIO because it i Options CfgOutput 91 BASE PIOA LED MASK X J Che LED s the EB55 we must apply a 1 to turn off LEDs SetOutput 91 BASE LED Rit timer interrupt Once a Shot on each led i 0 i lt NB LEB i 91F Clear utput AT91C BASE PIOA led nask i Stop Bond ti 91F_PIO SetOutput 91 BASE PIOA led_mask i 0 ME Once a Shot on each led for i NBLEB 1 i 0 i AT91F_PIO ClearOutput AT91C BASE PIOA led mask i wait AT91F_PIO_SetOutput AT91C_BASE_PIOA led 1 wait 2 Choose Project Options and select the Debugger category Change the J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 305 Driver option to RDI Options for node Basic Custom Build Build Actions Third Party Driver 3 Go to the RDI page of the Debugger options select the manufacturer driver JLinkRDI d11 and click OK Options for node Basic LI Third Party Driver 4 Now an extra menu RDI has been added to the menu bar Choose RDI Configure to c
11. Override 0 to Override 1 Select the settings file to be used in Sourcery CodeBench Name 5 32 4071 Debug E Main 09 Arguments PG Environment ES Debugger E Source Common Debug interface nk 7 WP Board stmazr4discovery Change Matches project settings Debugger Options J Link Startup 1 Memory Map Advanced Settings File workspace_loc STM32F4071E_Test Sample jinksettings x Browse Semihosting ot z Additional steps for enabling Flash Breakpoints feature By default Mentor Sourcery CodeBench does not allow the user to use the J Link unlimited number of breakpoints in flash feature since it only allows hardware breakpoints being set by default Enabling this feature requires an additional tweak in the J Link settings file 6 4 4 Make sure that all steps from Mentor Sourcery CodeBench on page 248 to enable flash download have been performed Make sure that Sourcery CodeBench uses a J Link DLL with version V4 85d or later If an earlier version is used this tweak does not work To update the DLL used by CodeBench copy the J Link DLL from the J Link installation directory to C Tool C Mentor CodeBench bin arm none eabi jlinkarm dll Open the settings file in a text editor and scroll to the BREAKPOINTS section Add the line ForcelmpTypeAny 1 Make sure that CodeBench uses the settings file J Link GDB Server The configurati
12. or ci BPHandle Description Removes an instruction breakpoint where lt BPHandle gt is the handle of breakpoint to be removed If no handle is specified this command removes all pending breakpoints Example gt monitor clrbp 1 or monitor ci 1 3 3 3 2 cp15 Syntax 15 CRn CRm lt 1 gt lt op2 gt lt data gt Description Reads or writes from to cp15 register If lt data gt is specified this command writes the data to the cp15 register Otherwise this command reads from the cp15 register For further information please refer to the ARM reference manual Example Read gt monitor 15 1 2 6 7 lt Reading CP15 register 1 2 6 7 0x0460B77D Write gt monitor 15 1 2 6 7 OxFFFFFFFF 3 3 3 3 device Note Deprecated Use command line option device instead Syntax device lt DeviceName gt Description Selects the specified target device This is necessary for the connection and some special handling of the device Note The device should be selected via commandline option device when starting GDB Server Example gt monitor device 5 32 417 lt Selecting device STM32F417IG 3 3 3 4 DisableChecks Syntax DisableChecks J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 111 Description Disables checking if a memory read caused an abort ARM7 9 devices only On some CPUs duri
13. 3FOFOFOF 01 05 07 3FOFOFOF gt JTAGSpeed 06 1 00 4000 OD 0c 01 40 00 10 ES OF 00 00 00 05 00 01 FF 00 00 RDI Testing speed 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOFAuto JTAG gt 2EF gt 0C 00 OkHz gt 48 gt 00 Writing 0x4 00 Writing 0x4 00 Writing 0x4 Data EA Writing 0x4 EA 00 Writing 0x4 27 00 00 FF Writing 0x4 00 00 00 00 00 00 00 00 00 EA FE FF FF EA 01 00 00 00 02 00 00 00 30 B5 15 48 01 68 82 68 00 FO 00 30 00 14 12 47 B5 47 B5 00 00 4A 00 00 00 00 13 27 24 00 00 48 24 Writing 0x54 bytes 0x00000178 gt 3E68 gt 4C 00 00 03 B4 Warning Chip has already been halted 34 08 00 00 81 4D 49 00 00 BO bytes bytes bytes 00 by EA Ces bytes bytes Writing 0x4 bytes 2004 2015 SEGGER Microcontroller GmbH amp Co KG 329 11 5 Semihosting Semihosting is a mechanism for ARM targets to communicate input output requests from application code to a host computer running a debugger It effectively allows the target to do disk operations and console I O and is used pri marily for flash loaders with ARM debuggers such as AXD 11 5 1 Overview Semihosting Semihosting is a mechanism for ARM targets to communicate input output reque
14. Asm Linker Debug Utiities C Use Simulator Settings Use Cortex M R J LINK J Trace Settings Limit Speed to Real Time Load Application at Startup Runto main Load Application at Startup Runto main lnitialization File lnitialization File El Edit Edit Restore Debug Session Settings 3 Restore Debug Session Settings 3 IV Breakpoints Toolbox IV Breakpoints Toolbox Watch Windows amp Performance Analyzer Watch Windows Memory Display IV Memory Display CPU DLL Paramet Driver DLL Paramet SARMCM3 DLL DLL Dialog DLL Paramet Dialog DLL Parameter DARMSTM DLL Es 03ZE TARMSTM DLL estma2Fi 03ZE Now setup the Download Options at Project gt Options for Target gt Debug gt Settings Check Verify Code Download and Download to Flash as shown in the screenshot below Cortex JLink JTrace Target Driver Setup Debug Trace Flash Download r J Link J Trace Adapter JTAG Device Chain SN 173000305 gt usB amp o v IDCODE Device Name IRlen Move Device Junk ARM Pro TDO 0x3BA00477 CoreSight JTAG DP 006414041 Unknown JTAG device HW V300 V4 35c TDI gt Down FW J Link ARM Pro V3x compilec Port Max Clock 6 Automatic Detection ID CODE 7 7 Manual Configuration
15. This pin is not connected in J Link nected This pin is not used by J Link If the device may also be 3 Not Used NC accessed via JTAG this pin may be connected to nTRST otherwise leave open This pin is used as VCOM Tx out on J Link side in case 5 J Link Tx Output VCOM functionality of J Link is enabled For further informa tion about VCOM please refer to Virtual COM Port VCOM on page 239 Single bi directional data pin A pull up resistor is required 1 0 ARM recommends 100 kOhms Clock signal to target CPU It is recommended that this pin is pulled to a defined state 3 SWGEK the target board Typically connected to of target CPU This pin is not used by J Link when operating in SWD mode 11 Not used NC If the device may also be accessed via JTAG this pin may be connected to RTCK otherwise leave open Serial Wire Output trace port Optional not required for SWD communication Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is typically called nRST nRESET or RESET This pin is used as VCOM Rx in on J Link side in case 17 J Link Rx input VCOM functionality of J Link is enabled For further informa tion please refer to Virtual COM Port VCOM on page 239 This pin can be used to supply power to the target hard 5V Sup ware Older J Links may not be able to supply power on this 19 Output pin For more information about
16. 003154 0 0800 5 4 003189 003193 0 080083 8 003201 OXO800BECS 003203 003224 0 0800 00 003226 OX0800B37C 003241 0 0800 06 003243 0 08008334 003260 OXO800BEDE 003262 0 0800 2 4 003277 0 0800 4 003279 0 0800070 003303 0 0800 003305 0 08000746 003327 0 0800 003329 0 0800077 003349 0 0800 003351 OXO800B2AC 003371 003372 OXO800BFES 003375 0800088 GetFlagstatus clk_Init 66 GetFlagstatus Clk_Init 66 RCC_GetFlagstatus u8 CIkK_Init 66 RCC GetFlagstatus clk_iInit 66 RCC GetFlagstatus Clk_Init 66 RCC_GetFlagstatus u8 Clk_Init 66 GetFlagstatus u8 Clk_Init 66 RCC_GetFlagstatus u8 Clk_Init 66 RCC_GetFlagstatus u8 Clk_Init 66 RCC GetFagstatus u8 clk_Init 66 RCC_GetFlagstatus u8 ClkInit 66 RCC_GetFlagstatus Clk_Init 66 RCC_GetFlagstatus u8 CIK_ImitC 66 RCC_USBCLKConfig u32 clk_Init 76 RCC_ADCCLKConTig u32 _ 84 RCC_PCLK2Config u32 Clk_Init 90 RCC PCLK1Config u32 Clkrnit 98 RCC_HCLKContig u32 104 FLASH_SetLatency u32 clk_Init 110 FLASH HalfCycleAccesscmd u32 c1k_Init 116 FLASH PrefetchBuffercmd u32 Clk Init 122 RCC sYSCLKConfi g u32 _ 128 main 16 NV
17. 0 Bytes downloaded 1 JTAG device 2 GNU Project Debugger GDB is freely available debugger distributed under the terms of the GPL The latest Unix version of the GDB is freely available from the GNU committee under http www gnu org software gdb download J Link GDB Server is distributed free of charge 3 3 4 J Link GDB Server CL Windows Linux J Link GDB Server CL is a commandline only version of the GDB Server The command line version is part of the Software and Documentation Package and also included in the Linux and MAC versions Except for the missing GUI J Link GDB Server CL is identical to the normal version All sub chapters apply to the command line version too J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 103 3 3 2 Debugging with J Link GDB Server With J Link GDB Server programs can be debugged via GDB directly on the target device like a normal application The application can be loaded into RAM or flash of the device Before starting GDB Server make sure a J Link and the target device are connected 3 3 2 1 Setting up GDB Server GUI version The GUI version of GDB Server is part of the Windows J Link Software Package JLinkGDBServer exe When starting GDB Server a configuration dialog pops up letting you select the needed configurations to connect to J Link and the target SEGGER J Link GDB Server V4 74 Config m Connection to
18. 8 9 9 99 9 9 8 O 9 9 9 9 8 9 9 9 9 9 Renesas RX63T o 0 00000 0 0 Table 1 2 J Link BASE hardware lt 7 o 7 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 36 CHAPTER 1 Introduction 1 3 3 J Link PLUS J Link PLUS is a JTAG emulator designed for ARM cores It con nects via USB to a PC running Microsoft Windows 2000 or later For a complete list of all operating systems which are sup ported please refer to Supported OS on page 27 J Link PLUS has a built in 20 pin JTAG connector which is compatible with the standard 20 pin connector defined by ARM J Link PLUS comes with licenses for all J Link related SEGGER software 1 3 3 1 Additional features Direct download into flash memory of most popular micro controllers supported Full speed USB 2 0 interface Serial Wire Debug supported Serial Wire Viewer supported Download speed up to 1 MBytes second Debug interface JTAG SWD speed up to 15 MHz RDI interface available which allows using J Link with RDI compliant software Comes with built in licenses for Unlimited number of breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming software The actual speed depends on various factors such as JTAG SWD clock speed host CPU core etc 1 3 3 2 Specifications The following table gives
19. HIGH level output voltage Voy with a load of 10 kOhm VoH gt 90 of Vig For 3 6 lt Vir lt 5V LOW level output voltage with a load of 10 kOhm VoL lt 20 of VIF HIGH level output voltage Voy with a load of 10 kOhm VoH gt 80 of VIF JTAG SWD Interface Timing SWO sampling frequency Max 7 5 MHz Data input rise time Trai lt 20ns Data input fall time Trai lt 20ns Data output rise time Trao Trdo lt 10ns Data output fall time Trg Tfdo lt 10ns Clock rise time lt 3ns Clock fall time lt 3ns Table 1 3 J Link specifications 1 3 3 3 Hardware versions Version 9 1 e Initial design based on STM32F205 Version 9 2 Identical to version 9 1 with the following exception e Pin 1 VTref is used for measuring target reference voltage only Buffers on J Link side are no longer powered through this pin but via the J Link internal volt age supplied via USB Hardware version 9 1 9 2 Hardware features USB JTAG interface SWD interface Table 1 4 J Link PLUS hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 38 CHAPTER 1 Introduction Hardware version 9 1 9 2 SWO interface Microchip ICSP interface Renesas FINE inter face 9
20. Debugger Start the application v Run to main GDB commands after connection monitor reset load Project targets options mmm Project settings Build targets Build scripts Notes C C parser options Debugger JLink GDBServer Select target i Target Device AM3359 Little Endian Device list Target Connection SWD 7 4000 7 kHz IP Address localhost 2331 Override register definition file E J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 386 CHAPTER 13 Device specifics 13 17 1 2Selecting the device when using GDBServer When using the J Link GDBServer the device needs to be known before GDB con nects to the GDBServer since GDBServer connects to the device as soon as it is started So selecting the device via monitor command is too late In order to select the device before GDBServer connects to it simply start it with the following com mand line device lt DeviceName gt Example JLinkGDBServer device AM3359 13 17 1 3Selecting the device when using J Link Commander For J Link Commander type device lt DeviceName gt Then J Link Commander will perform a reconnect with the device name selected before 13 17 1 4Known values for lt DeviceName gt For a list of all supported devices please refer to http www segger com jlink_supported_devices html 13 17 1 5Required J Link hardware version The spe
21. Parameter Meaning Delay Amount of time to sleep in ms Example sleep 200 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 96 CHAPTER 3 J Link software and documentation package 3 2 1 40 speed This command sets the speed for communication with the CPU core Syntax speed Freq auto adaptive Parameter Meaning Freq Specifies the interface frequency in kHz auto Selects auto detection of JTAG speed adaptive Selects adaptive clocking as JTAG speed Example speed 4000 speed auto 3 2 1 41 st This command prints the current hardware status Prints the current status of TCK TDI TDO TMS TRES TRST and the interface speeds supported by the target Also shows the Target Voltage Syntax st 3 2 1 42 step s Target needs to be halted before calling this command Executes a single step on the target The instruction is overstepped even if it is breakpointed Prints out the disas sembly of the instruction to be stepped Syntax step 3 2 1 43 unlock This command unlocks a device which has been accidentally locked by malfunction of user software Syntax unlock lt DeviceName gt Parameter Meaning Name of the device family to unlock Supported Devices LM3Sxxx DeviceName 2 Kinetis EFM32Gxxx Example unlock Kinetis 3 2 1 44 usb Closes any existing connection to J Link and opens a new one via USB It is possible to sel
22. 2004 2015 SEGGER Microcontroller GmbH amp Co KG 412 CHAPTER 15 Background information 15 2 3 1 Code coverage Disassembly tracing IAR Embedded Workbench IDE 195 ttendif 196 197 ENTREGRTZBECTEONG 198 Init c system 199 1 InitO 27 NUIC init 203 wifaact FLASH Set the Vector Table base location at 0 20000000 204 NUIC SetUectorTable NUIC FECHA 8x85 205 telse TAB FLASH 206 Set the Vector Table Bae location at 0 08000000 207 NUIC SetUectorTable NUIC UectTab FLASH 8x05 coe NUIC PriorityGroupConfig NUIC PriorityGroup 45 7 SysTick end of count event each 1s with input clock equal to 9MHz CHCLK 8 defaul Seis En Si y interrupt SusTick ITConf ig ENABLE 5 SysTick CounterCnd SysTick Counter Enable 4 Buttons port init 44 GPIO enable clock and release Reset RCC_APB2PeriphResetCmd RCC_APB2Periph_GPIOA 1 RCC_APB2Periph_GPIOG DISABLE RCC_APB2PeriphClockCmd RCC_APB2Periph_GPIOA RCC_APB2Periph_GPIOG ENABLE GPIO InitStructure GPIO Pin B1_MASK GPIO InitStructure GPIO Mode GPIO Mode IN FLORTING GPIO InitStructure GPIO Speed GPIO Rene _S MHz GPIO_Init B1_PORT amp GPIO InitStructure GPIO InitStructure GPIO Pin B2 GPIO InitStructure GPIO Mode GPIO Mode IN FLORTING GPIO InitStructure GPIO Speed OE TEE GPIO InitCB2 PORT amp GPIO InitStructure EXT CRT SECTIONO 7 port and ADC init 44 Enable ADC1 a
23. Hardware features USB JTAG interface SWD interface SWO interface Microchip ICSP interface Renesas FINE inter face 9 OOQ Oo 9 9 9 9 9 9 Supported cores ARM legacy cores ARM7 ARM11 ARM Cortex cores Cortex A5 Cortex A7 Cortex A8 Table 1 6 J Link ULTRA hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 44 CHAPTER 1 Introduction Hardware version gt Cortex A9 Cortex A12 Cortex A15 Cortex A17 Cortex MO Cortex MO Cortex M1 Cortex M3 Cortex M4 Cortex M7 Cortex R4 Cortex R5 5 000 MO secure O 0 9 9 9 9 9 9 9 9 SC300 M3 secure 9 9 9 9 9 9 9 9 9 9 9 2 Microchip PIC32MX e Table 1 6 J Link ULTRA hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 45 Hardware version 1 1 4 0 Microchip PIC32MZ e Q Renesas RX Renesas RX110 Renesas RX111 Renesas RX210 Renesas RX21A Renesas RX220 Renesas RX610 Renesas RX621 Renesas RX62G Renesas RX62N Renesas RX62T Renesas RX630 Renesas RX631 Renesa
24. LJ i D J Link Pro Webserver SEGGER Microcontroller Home Home Network information Network configuration Emulator information System information Firmware build Dec 22 2008 09 24 26 Serial Number Emulator status About Network information Configuration type User assigned IP Address 192 168 90 11 16 Gateway 192 168 1 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 163 The Network configuration page allows configuration of network related settings IP address subnet mask default gateway of J Link The user can choose between automatic IP assignment settings are provided by a DHCP server in the network and manual IP assignment by selecting the appropriate radio button umm e J Link Pro Webserver SEGGER Microcontroller Home Network configuration Network information Network configuration C Automatic Manual System information M DHCP IP address rez 168 eo n Subnet mask 255 255 About Gateway 168 Emulator status J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 164 CHAPTER 4 Setup 4 4 FAQs How can I use J Link with GDB and Ethernet A You have to use the J Link GDB Server in order to connect to J Link via GDB and Ethernet J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 4 5 J Link Configurator Normally no configuration
25. SWO TDO Input When using SWD this pin is used as Serial Wire Output trace port optional not required for SWD communica tion JTAG data output from target CPU Typically connected to TDO of the target CPU This pin normally pin 7 is not existent on the 19 pin JTAG SWD and Trace connector TDI Output JTAG data input of target CPU It is recommended that this pin is pulled to a defined state on the target board Typically connected to TDI of the target CPU For CPUs which do not provide TDI SWD only devices this pin is not used J Link will ignore the signal on this pin when using SWD 9 NC TRST NC By default TRST is not connected but the Cortex M Adapter comes with a solder bridge NR1 which allows TRST to be connected to pin 9 of the Cortex M adapter Table 14 12 9 pin JTAG SWD pinout Pins 3 and 5 are GND pins connected to GND on the Cortex M adapter They should also be connected to GND in the target system J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 405 14 5 Reference voltage VTref VTref is the target reference voltage It is used by the J Link to check if the target has power to create the logic level reference for the input comparators and to con trol the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor In cases where the VTref signal should no
26. To select from a list of all available emulators on Ethernet please use as lt IPAddr gt SelectEmuBySN Connect to a J Link with a specific serial number via USB Useful if multiple J Links are connected to the same PC Syntax SelectEmuBySN lt SerialNo gt Example JLinkSTM32 exe SelectEmuBySN 580011111 Speed Starts J Link STM32 Unlock Utility with a given initial speed Available parameters are adaptive auto ora freely selectable integer value in kHz It is recom mended to use either a fixed speed or if it is available on the target adaptive speeds Default interface speed is 1000 kHz Syntax Speed lt Speed_kHz gt SetPowerTarget The connected debug probe will power the target via pin 19 of the debug connector Syntax J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 153 SetPowerTarget lt Mode gt Example JLinkSTM32 exe SetPowerTarget 1 Target power will be set SetDeviceFamily This command allows to specify a device family so that no user input is required to start the unlocking process Syntax SetDeviceFamily lt Parameter gt Parameter There are two different options to specify the device family to be used a Pass the list index from the list which shows all supported familys on start up b Pass the defined device name ListIndex Name 1 STM32FOxxxx 2 STM32F1xxxx 3 STM32F2xxxx 4 STM32F3X
27. 060711 OO Subchapter 5 2 2 Corrected JTAG Trace connec tor pinout table 12 060628 OO Subchapter 4 1 Added ARM966E S to List of sup ported ARM cores 11 060607 SK Subchapter 5 5 2 2 changed Subchapter 5 5 2 3 added 10 060526 SK ARM9 download speed updated Subchapter 8 2 1 Screenshot Start sequence updated Subchapter 8 2 2 ID sequence removed Chapter Support and FAQ merged Various improvements 060324 OO Chapter Literature and references added Chapter Hardware Added common information trace signals Added timing diagram for trace Chapter Designing the target board for trace added 060117 OO Chapter Related Software Added JLinkARM dll Screenshots updated 051208 OO Chapter Working with J Link Sketch added 051118 OO Chapter Working with J Link Connecting multiple J Links to your PC added Chapter Working with J Link Multi core debug ging added Chapter Background information J Link firm ware added 051103 TQ Chapter Setup JTAG Speed added 051025 OO Chapter Background information Flash program ming added Chapter Setup Scan chain configuration added Some smaller changes J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 3 051021 Performance values updated
28. 84 RCC_PCLK2Confi g u32 Clk Init 90 RCC PCLK1Config u32 clk_init 98 RCC HCLKConfi g u32 ClkoInit 104 FLASH SetLatency u32 Clkanit 110 002725 002760 002764 002799 002803 002838 002842 002877 002881 002916 002920 002955 002959 002994 002998 903033 003037 003072 003076 003111 003115 003150 003154 003189 003193 003201 003203 003224 003226 003241 003243 003260 003262 003277 003279 003303 003305 003327 003329 003349 003351 003371 003372 003375 003393 Clk Init 116 Clk_Init 122 RCC SYscLKconfi g u32 Ck Init 128 main 16 main 26 003096 003414 OxO800BFCA 4876 main 34 J Link J Trace UM08001 FLASH Ha fCycleAccesscmd u32 FLASH PrefetchBufferCmd u32 NVIC setVectorTable u32 u32 2004 2015 SEGGER Microcontroller GmbH amp Co KG 415 15 3 Embedded Trace Buffer ETB The ETB is a small circular on chip memory area where trace information is stored during capture It contains the data which is normally exported immediately after it has been captured from the ETM The buffer can be read out through the JTAG port of the device once capture has been completed No additional special trace port is required so that the ETB can be read via J Link The trace functionality via J Link is limited by the size of the ETB While capturing runs the trace information in the buffer will be overwritten every time the buffer size has bee
29. If the target provides the RTCK signal select the adaptive clocking function to syn chronize the clock to the processor clock outside the core This ensures there are no synchronization problems over the JTAG interface If you use the adaptive clocking feature transmission delays gate delays and syn chronization requirements result in a lower maximum clock frequency than with non adaptive clocking 2004 2015 SEGGER Microcontroller GmbH amp Co KG 183 5 4 SWD interface The J Link support ARMs Serial Wire Debug SWD SWD replaces the 5 pin JTAG port with a clock SWDCLK and a single bi directional data pin SWDIO providing all the normal JTAG debug and test functionality SWDIO and SWCLK are overlaid on the TMS and TCK pins In order to communicate with a SWD device J Link sends out data on SWDIO synchronous to the SWCLK With every rising edge of SWCLK one bit of data is transmitted or received on the SWDIO 5 4 1 SWD speed Currently only fixed SWD speed is supported by J Link The target is clocked at a fixed clock speed The SWD speed which is used for target communication should not exceed target CPU speed 10 The maximum SWD speed which is supported by J Link depends on the hardware version and model of J Link For more information about the maximum SWD speed for each J Link J Trace model please refer to J Link J Trace models on page 28 5 4 2 SWO Serial Wire Output SWO support means support for a
30. for target communication CORESIGHT IndexAHBAPTOUse 1 EMU JTAG _ DisableHWTransmissions Table 5 11 Global DLL variables J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 213 Variable Description R W CORESIGHT IndexAPBAPToUse Pre selects an AP as an APB AP that J Link uses for debug communication Cortex A R Setting this variable is necessary for example when debugging multi core devices where multiple APB APs are present one for each device This function can only be used if an AP layout has been configured via JLINK CORESIGHT AddAP Example JLINK CORESIGHT AddAP 0 CORESIGHT AHB AP JLINK CORESIGHT AddAP 1 CORESIGHT AP JLINK CORESIGHT AddAP 2 CORESIGHT AP Use third AP as APB AP for target communication CORESIGHT_IndexAPBAPToUSe 2 MA IN ResetType Used to determine what reset type is currently selected by the debugger This is useful if the script has to behave differently in case a specific reset type is selected by the debugger and the script file has a ResetTarget function which overrides the J Link reset strategies Example if MAIN ResetType 2 seal else 53 N_IsFirstIdentify Used to ch
31. 256 Bytes 5 12 1 48SetlgnoreReadMemErrors This command can be used to ignore read memory errors Disabled by default Syntax SetIgnoreReadMemErrors 0 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 231 Example SetIgnoreReadMemErrors SetIgnoreReadMemErrors 5 12 1 49SetlgnoreWriteMemErrors This command can be used to ignore read memory errors Disabled by default Syntax SetIgnoreWriteMemErrors 0 1 1 Read memory errors will be ignored 0 Read memory errors will be reported Example SetIgnoreWriteMemErrors 1 Write memory errors will be ignored SetIgnoreWriteMemErrors 0 Write memory errors will be reported 5 12 1 50SetMonModeDebug This command is used to enable disable monitor mode debugging Disabled by default Syntax SetMonModeDebug 0 1 Example SetMonModeDebug 1 Monitor mode debugging is enabled SetMonModeDebug 0 Monitor mode debugging is disabled 5 12 1 51 SetResetPulseLen This command defines the length of the RESET pulse in milliseconds The default for the RESET pulse length is 20 milliseconds Syntax SetResetPulseLen value Example SetResetPulseLen 50 5 12 1 52 SetResetType This command selects the reset strategy which shall be used by J Link to reset the device The value which is used for this command is analog to the reset type which shall be selected For a list of all reset t
32. 5V LOW level input voltage Vip lt 40 of Table 1 1 J Link specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 31 HIGH level input voltage gt 60 of VIF For 1 8V lt Vir lt 3 6V LOW level output voltage VoL with a load of 10 kOhm VoL lt 10 of VIF HIGH level output voltage Voy with a load of 10 kOhm gt 90 of VIF For 3 6 lt Vir lt 5V LOW level output voltage with a load of 10 kOhm VoL lt 20 of Vig HIGH level output voltage Voy with a load of 10 kOhm Vou gt 80 of Vig JTAG SWD Interface Timing SWO sampling frequency Max 7 5 MHz Data input rise time Trai lt 20ns Data input fall time Trai lt 20ns Data output rise time Trao Trdo lt 10ns Data output fall time Tfdo lt 10ns Clock rise time Tre lt 3ns Clock fall time Tg lt 3ns Table 1 1 J Link specifications 1 3 2 3 Hardware versions Versions 1 4 Obsolete Obsolete Version 5 0 Obsolete Identical to version 4 0 with the following exception e Uses a 32 bit RISC CPU e Maximum download speed using DCC is over 700 Kbytes second e JTAG speed Maximum JTAG frequency is 12 MHz possible JTAG speeds are 48 MHz n where n is 4 5 resulting in speeds of 12 000 M
33. Basically the custom sequence is separated into different steps where each step con tains the fields as in the table below Some commands require to pass parameter to it They are stored in ValueO and Valuei as described in the table below Step Description ExitStepX Action SActions Any action as described in the table below User can specify any comment here This field is optional and not taken into account ExitStepX ValueO valueos Value depends on the action See table below ExitStepX_Valuei valuei1 Value depends on the action See table below ExitStepX Comment comment The number of exit steps needs to be specified right behind the ExitStep sequence with the line NumExitSteps lt NumExitSteps gt see example below Actions Parameter Description Activate CS none Set CS signal low Deactive CS none Set CS signal high Send a number of bytes via the SPI inter UM face to the SPI Please note that the num Value1 x ByteStream Write data ber of bytes has to be specified right max NumBytes is 16 behind Valuel in square brackets e g ExitStep4_Value1 3 0x44 0x00 0x10 Delay Value0 Delay in ms Waits a given time Below is a small example excerpt from a J Flash project which shows a example sequence to erase sector 0 of the SPI flash using the 0 08 command Further exam ples can be found in the installation directory of
34. J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 83 3 2 J Link Commander Command line tool J Link Commander JLink exe is a tool that can be used for verifying proper instal lation of the USB driver and to verify the connection to the target CPU as well as for simple analysis of the target system It permits some simple commands such as memory dump halt step go etc to verify the target connection C Program FilesSEGGER JLinkARM 86 SEGGER J Link Commander 03 86 Compiled Jun 27 2008 19 42 4 DLL version U3 86 compiled Jun 27 2008 19 42 28 Firmware J Link ARM 06 compiled Jun 27 2008 18 35 51 06 99 for help gt J Link gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 84 3 2 1 Commands CHAPTER 3 J Link software and documentation package The table below lists the available commands of J Link Commander All commands are listed in alphabetical order within their respective categories Detailed descrip tions of the commands can be found in the sections that follow Command short form Explanation Basic clrBP Clear breakpoint clrWP Clear watchpoint device Selects a device erase Erase internal flash of selected device exec Execute command string exit qc q Closes J
35. Multicore Plugins Assembler Output Converter Driver Run to Custom Buld J Link J Trace M _MainLoop Build Actions Linker Setup macros 7 Use macro file s En PROJ_DIRS Sre EnableMonMode mac Angel CMSIS DAP GDB Server IAR ROM monitor Device description file Idet JTAGjet SE Jink J Trace Overide default TI Stellaris STOOLKIT_DIRS CONFIG debugger AnalogDevices ioCM40 Macraigor PE micro RDI ST LINK Third Party Driver J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 268 CHAPTER 8 Monitor Mode Debugging 8 2 3 J Link Commander In J Link Commander the appropriate command to enable monitor mode can be exe cuted directly J Link gt exec SetMonModeDebug 1 8 2 4 Generic way of enabling There is always the possibility to perform the monitor mode enable command manu ally via the J Link control panel This works independently from the IDE For more information about the J Link control panel please refer to J Link control panel on page 191 I Link V5 01h beta Control panel s aa General Settings Breakpoints Log CPU Regs Target Power SWV RAWTrace lt Start minimized Always on top lt Process C Tool C IARARM_V 7402 common bin larl dePm exe DLL CATooNCXARNARM V7402NarmNbinNJLink amp RM dll J Link SEGGER J Link ARM V9 2 SN 59200000 Device CM402_384_2048 compatible tc Little endian
36. Set the timeout after which the target connection has to be established If no con nection could be established GDB Server will close The default timeout is 5 seconds for the GUI version and O for the command line ver sion Note The recommended order is to power the target connect it to J Link and then start GDB Server Syntax timeout lt Timeout ms gt Example Allow target connection within 10 seconds jlinkgdbserver timeout 10000 3 3 5 28 strict Description Starts GDB Server in sctrict mode When strict mode is active GDB Server checks the correctness of settings and exits in case of a failure Currently the device name is checked If no device name is given or the device is unknown to the J Link GDB Server exits instead of selecting Unspecified as device or showing the device selection dialog Syntax strict Example Following executions of GDB Server CL will cause exit of GDB Server jlinkgdbserver strict device UnknownDeviceName jlinkgdbservercl strict Following execution of GDB Server will show the device selction dialog under Win dows or select Unspecified directly under Linux OS X jlinkgdbserver device UnknownDeviceName J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 133 3 3 5 29 swoport Description Set up port on which GDB Server should listen for an incoming connection that reads the SWO data from GDB Server Default port is 2332 Note
37. are chip internally wired to a fixed 14 MHz clock AUXHFRCO This will cause the auto detection of J Link to not work by default for these devices if the CPU is running at a different speed than AUXHFRCO utilities that use SWO speed auto detection like the J Link SWOViewer need to be told that the CPU is run ning at 14 MHz to make SWO speed auto detection work no matter what speed the CPU is really running at J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 380 CHAPTER 13 Device specifics 13 16 ST Microelectronics J Link has been tested with the following ST Microelectronics devices STR710FZ1 STR710FZ2 STR711FRO STR711FR1 STR711FR2 STR712FRO STR712FR1 STR712FR2 STR715FRO STR730FZ1 STR730FZ2 STR731FVO STR731FV1 STR731FV2 STR735FZ1 STR735FZ2 STR736FVO STR736FV1 STR736FV2 STR750FVO STR750FV1 STR750FV2 STR751FRO STR751FR1 STR751FR2 STR752FRO STR752FR1 STR752FR2 STR755FRO STR755FR1 STR755FR2 STR755FVO STR755FV1 STR755FV2 STR911FM32 STR911FM44 STR911FW32 STR911FW44 STR912FM32 STR912FM44 STR912FW32 STR912FW44 STM32F101C6 STM32F101C8 STM32F101R6 STM32F101R8 STM32F101RB STM32F101V8 STM32F101VB STM32F103C6 STM32F103C8 STM32F103R6 STM32F103R8 STM32F103RB STM32F103V8 STM32F103VB J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 13 16 1 STR91x 13 16 1 1JTAG settings These device are ARM966E S based We recommend to use
38. mapped to 0x0 in order to debug the application from addr 0x0 13 11 4 LPC43xx All devices of the LPC43xx are dual core devices One Cortex M4 core and one Cor tex MO core For these devices a J Link script file is needed exact file depends on if the Cortex M4 or the Cortex MO shall be debugged in order to guarantee proper functionality Script file can be found at JLINK_INST_DIR Samples JLink Scripts For more information about how to use J Link script files please refer to Executing J Link script files on page 216 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 376 CHAPTER 13 Device specifics 13 12 J Link has been tested with the following OKI devices ML67Q4002 ML67Q4003 ML67Q4050 ML67Q4051 ML67Q4060 ML67Q4061 Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 377 13 13 Renesas J Link has been tested with the following Renesas devices R5F56104 R5F56106 R5F56107 R5F56108 R5F56216 R5F56217 R5F56218 R5F562N7 R5F562N8 R5F562T6 R5F562T7 R5F562TA Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 378 CHAPTER 13 Device specifics 13 14 Samsung J Link has been tested with the following Samsung devices e S3FN60D 13 14 1 SSFN60D On the S3FN60D the watchdog may be running after rese
39. 2 051011 Chapter Working with J Link added 1 050818 TW Initial version J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG About this document Assumptions This document assumes that you already have a solid knowledge of the following e The software tools used for building your application assembler linker C com piler e The C programming language e The target processor e DOS command line If you feel that your knowledge of C is not sufficient we recommend The C Program ming Language by Kernighan and Richie ISBN 0 13 1103628 which describes the standard in C programming and in newer editions also covers the ANSI C standard How to use this manual This manual explains all the functions and macros that the product offers It assumes you have a working knowledge of the C language Knowledge of assembly program ming is not required Typographic conventions for syntax This manual uses the following typographic conventions Style Used for Body Body text Text that you enter at the command prompt or that appears on keyword the display that is system functions file or pathnames Parameter Parameters in API functions Sample Sample code in program examples Sample comment Comments in programm examples Reference to chapters sections tables and figures
40. 371 13 10 1 Unlocking LM3Sxxx devices 050 372 13 11 Up A MG 373 13 11 1 LPC ARM7 based 1 66 66 nnn nnn 374 13 11 2 Reset Cortex M3 based devices ss 375 13 11 3 1 288 flash programming 1 emen 375 13 11 4 socket arcade etat amet 375 13 12 evi exe alo try eosin ua EC ina needs eect 376 13 13 eem 377 13 14 S MS NG PR E Aaa 378 13 24 12 S3ENG0D eni ie d RATS 378 13 15 feeit ER 379 13 15 1 EFM32 series devices iocis eerte von iv sua Deom rare RR TAAA ERR 379 13 16 ST Microelectronics vis uiscera xe evan ave a xav Ve Re e C a v n 380 13226 1 5 92 381 13 16 2 STM32F10390 5 icem iie conway alia 381 13 26 32 SIMS 2E2XxXK iiie oves state 383 13 16 4 STM32F4KXXK X VA o p Ri T e E x hes vee eed 384 13 17 Texas Instruments 255 tradu eek xr radar ner SE EE RAE E tetes 385 13 17 4 AM335X are paite elas baer dete he adnate a v vr e E CX V ME Ea P 385 13 17 2 3 5 i eR C
41. 4 1 8 Xilinx 8 Xilinx 8 ARM 4 2 16 Table 5 5 Example scan chain configurations J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 182 5 3 4 1 CHAPTER 5 Working with J Link and J Trace Device 0 Device 1 Device 2 ane Chip IR len Chip IR len Chip IR len Position 18180 ARM 4 Xilinx 8 ARM 4 0 0 ARM 4 Xilinx 8 ARM 4 2 12 Xilinx 8 ARM 4 Xilinx 8 1 8 Table 5 5 Example scan chain configurations The target device is marked in blue 5 3 4 JTAG Speed There are basically three types of speed settings e Fixed JTAG speed e Automatic JTAG speed e Adaptive clocking These are explained below Fixed JTAG speed The target is clocked at a fixed clock speed The maximum JTAG speed the target can handle depends on the target itself In general CPU cores without JTAG synchroniza tion logic such as ARM7 TDMI can handle JTAG speeds up to the CPU speed ARM cores with JTAG synchronization logic such as ARM7 TDMI S ARM946E S ARM966EJ S can handle JTAG speeds up to 1 6 of the CPU speed JTAG speeds of more than 10 MHz are not recommended 5 3 4 2 Automatic JTAG speed Selects the maximum JTAG speed handled by the TAP controller Note On ARM cores without synchronization logic this may not work reliably because the CPU core may be clocked slower than the maximum JTAG speed 5 3 4 3 Adaptive clocking J Link J Trace UM08001
42. KKK KKK KEK KEK ck ck ck ck ck ck ck ko ck ck ck ko ko ko ck ko ko ko ko 5 2012 2013 SEGGER Microcontroller GmbH amp Co KG m www segger com Support support segger com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 145 Ck ckckckckckockckckck ck ckck ckckckckck KK KKK ck ckck KKK KK ck kck ck ck ckockck ck ckck ck ck ckokck ck ckck ck ckck ck ck ck ckck ck kck kk ck kk kk File SWO c Purpose Simple implementation for output via SWO for Cortex M processors It can be used with any IDE This sample implementation ensures that output via SWO is enabled in order to gurantee that the application does not hang END OF HEADER kk kk kkk kkk kkk kkk kkk kk kkk Prototypes to be placed in a header file such as SWO h Ef void SWO_PrintChar char c void SWO_PrintString const char s RRR RRR RKKEKRK kc kc k kc KKK RR KR KK KEK KK RR KR KR KKK RK EEK EEK KE EE EEK EEE KE EX EEK kck ck KE KK Defines for Cortex M debug unit define 5 032 volatile unsigned int 0xE0000000 STIM word access define STIM 08 volatile char 0xE0000000 STIM Byte access define ITM ENA volatile unsigned int OxEO000E00 ITM Enable Reg define ITM TCR volatile unsigned 0 0000 80 ITM Trace Control Reg f Rhe ke kk kk kk ke ke ke
43. Select DS 5 Debugger on the left side Press New button In the Connection tab select The target from the device database Bare Metal Debug Debug via DSTREAM RVI Click on the Browse button right to the Text box at the bottom connection e In the Dialog select the J Link which is connected to the target e g JLinkUSB 174200001 Select Debug Hardware x Unknown J LinkUSB 59200005 J Link J LinkLISB 174200001 Unknown JLinkIP 192 168 11 122 J Link Pro Unknown J LinkIP 192 168 6 4 J Link Unknown J LinkIP 192 168 6 1 J Link Unknown J LinkIP 192 168 6 2 J Link ARM e Click e Add the device name to the connection string e g JLinkUSB 174200001 Device J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 172 STM32F103ZG E Debug Configurations Create manage and run configurations C C Application C C Attach to Application E C C Postmortem Debugger E C C Remote Application 4 05 5 Debugger Filter platforms TAR 4 DSTRAM_Atmel ATS15AM Jh DStream A DSTREAM flash blinky Mc 96 Jh Atmel AT915AM9G2 i i Iron Python Run eV Tron Python unittest Java Applet 3 Java Application CHAPTER 4 Setup MCBSTR9 Evaluation Board E d Jython unittest B Launch Group 0 PyDev Django 43 PyDev Google App Run Python Run Python unittest Remote Java Appl
44. Starts GDB Server in single run mode When active GDB Server will close when all client connections are closed In normal run mode GDB Server will stay open and wait for new connections When started in single run mode GDB Server will close immediately when connecting to the target fails Make sure it is powered and connected to J Link before starting GDB Server Syntax s singlerun 3 3 5 25 speed Description Starts GDB Server with a given initial speed HH Available parameters are adaptive auto or freely selectable integer value in kHz It is recommended to use either a fixed speed or if it is available on the target adaptive speeds Note Using GDB Server CL this option is mandatory to correctly connect to the target and should be given before connection via GDB Syntax speed lt Speed_kHz gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 132 CHAPTER 3 J Link software and documentation package Example jlinkgdbserver speed 2000 3 3 5 26 stayontop Description Starts the GDB Server in topmost mode It will be placed above all non topmost win dows and maintains it position even when it is deactivated Note For the CL version this setting has no effect Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax stayontop 3 3 5 27 timeout Description
45. UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 112 CHAPTER 3 J Link software and documentation package Description Starts the target CPU Example gt monitor go 3 3 3 9 halt Syntax halt Description Halts the target CPU Example gt monitor halt 3 3 3 10 interface Note Deprecated Use command line option i instead Syntax interface lt InterfaceIdentifier gt Description Selects the target interface used by J Link J Trace 3 3 3 11 jtagconf Syntax jtagconf lt IRPre gt lt DRPre gt Description Configures a JTAG scan chain with multiple devices on it lt IRPre gt is the sum of IRLens of all devices closer to TDI where IRLen is the number of bits in the IR Instruction Register of one device lt DRPre gt is the number of devices closer to TDI For more detailed information of how to configure a scan chain with multiple devices please refer to See Determining values for scan chain configuration on page 181 Note To make sure the connection to the device can be established correctly it is recommended to configure the JTAG scan chain via command line options at the start of GDB Server Example Select the second device where there is 1 device in front with IRLen 4 gt monitor jtagconf 4 1 3 3 3 12 memU8 Syntax MemU8 lt address gt lt value gt Description Reads or writes a byte from to a given address If lt value gt is specified this com m
46. Using GDB Server CL this option is mandatory to correctly connect to the target and should be given before connection via GDB Syntax if lt Interface gt Example jlinkgdbserver if SWD Add information Currently the following values are accepted for lt Interface gt JTAG SWD FINE 2 wire JTAG PIC32 3 3 5 5 ir Description Initializes the CPU register with default values on startup Note For the GUI version this setting is persistent for following uses of GDB Server until changed via noir or the GUI Example jlinkgdbserver ir 3 3 5 6 jtagconf Syntax jtagconf lt IRPre gt lt DRPre gt Description Configures a JTAG scan chain with multiple devices on it lt IRPre gt is the sum of IRLens of all devices closer to TDI where IRLen is the number of bits in the IR Instruction Register of one device lt DRPre gt is the number of devices closer to TDI For more detailed information of how to configure a scan chain with multiple devices please refer to See Determining values for scan chain configuration on page 181 Example Select the second device where there is 1 device in front with IRLen 4 jlinkgdbserver jtagconf 4 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 127 3 3 5 7 localhostonly Description Starts the GDB Server with the option to listen on localhost only This means that only TCP IP connections from localhost are accepted or
47. Using multiple instances of GDB Server setting custom values for this option is necessary Syntax SWOPort Port Example jlinkgdbserver SWOPort 2553 3 3 5 30 telnetport Description Set up port on which GDB Server should listen for an incoming connection that gets target s printf data Semihosting and anylized SWO data Default port is 2333 Note Using multiple instances of GDB Server setting custom values for this option is necessary Syntax TelnetPort Port Example jlinkgdbserver TelnetPort 2554 3 3 5 31 vd Description Verifys the data after downloading it Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax vd 3 3 5 32 x Description Starts the GDB Server with a gdbinit configuration file In contrast to the xc com mand line option the GDB Server runs the commands in the gdbinit file once only direct after the first connection of a client Syntax x lt ConfigurationFilePath gt Example jlinkgdbserver x C MyProject Sample gdb J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 134 CHAPTER 3 J Link software and documentation package 3 3 5 33 xc Description Starts the GDB Server with a gdbinit configuration file GDB Server executes the commands specified in the gdbinit file with every connection of a client start of a debugging session Syntax
48. WriteStatus poo 10 4 2 Global Settings Global settings are available from the Options menu in the main window Operation Auto mode affects VERSET Disconnect after each operation Perform blank check before program Skip blank areas on read Automatically unlock sectors if necessary Logging Enable J Link logfile Enable J Flash logfile General log level Level 2 5 4 C Program Files x86 SEGGER JLink_V49 El C Program Files x86 SEGGER JLink_ 49 Projects Save Project file on close 10 4 2 1 Operation Cancel 287 You may define the behavior of some operations such as Auto or Program amp Ver ify 10 4 2 1 1 Disconnect after each operation If this option is checked connection to the target will be closed at the end of each operation J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 288 CHAPTER 10 J Flash SPI 10 4 2 1 2 Automatically unlock sectors If this option is checked all sectors affected by an erase or program operation will be automatically unlocked if necessary 10 4 2 1 3 Perform blank check If this option is checked a blank check is performed before any program operation to examine if the affected flash sectors are completely empty The user will be asked to erase the affected sectors if they are not empty 10 4 2 1 4 Skip blank ar
49. define FFCR volatile unsigned int 0xE0040304 Formatter and flush Control Register 032 _ITMPort 0 The stimulus port from which SWO data is received and displayed U32 TargetDiv 1 Has to be calculated according to N the CPU speed and the output baud rate static void _EnableSwo U32 StimulusRegs 7 Enable access to SWO registers DEMCR 1 lt lt 24 LSR OxC5ACCE55 7 Initially disable ITM and stimulus port To make sure that nothing is transferred via SWO when changing the SWO prescaler etc StimulusRegs ITM_ENA StimulusRegs amp 1 lt lt _ITMPort ITM_ENA StimulusRegs Disable ITM stimulus port ITM_TCR 0 Disable ITM 7 Initialize SWO prescaler etc 7 TPIU_SPPR 0 00000002 Select NRZ mode TPIU_ACPR TargetDiv 1 Example 72 48 1 5 MHz ITM_TPR 0x00000000 DWT_CTRL 0x400003FE FFCR 0x00000100 Enable ITM and stimulus port ITM_TCR 0x1000D Enable ITM ITM_ENA StimulusRegs 1 lt lt ITMPort Enable ITM stimulus port 3 7 4 Target example code for terminal output f 5k kk ERR ERE ERE EERE EERE KERR ERE KERR REE SEGGER MICROCONTROLLER GmbH amp Co KG E Solutions for real time microcontroller applications KKK KKK KEKE KKK KKK KEKE KKK KKK
50. e No support Please understand that we cannot give any support if you are running into prob lems when using a PC side implementation Note Due to these limitations we recommend to use PC side implementations for evaluation only J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 1 6 3 Firmware intelligence per model There are different models of J Link J Trace which have built in intelligence for dif ferent CPU cores In the following we will give you an overview about which model of J Link J Trace has intelligence for which CPU core 1 6 3 1 Current models The table below lists the firmware CPU support for J Link amp J Trace models currently available lt S ARM Renesas J Link J Trace 7 9 11 A R Cortex M RX600 model 3 JTAG JTAG JTAG JTAG SWD JTAG J Link BASE J Link PRO 3 J link ULTRA 1 J Link Lite ARM 8 J Link Lite Cortex M J Link Lite RX J Trace ARM 0000 9 9 O OOOO J Trace for Cortex M 3 9 9 OOOOO O 00000 9 8 3800 00 9 00 Table 1 16 Built in intelligence of current J Links J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 64 CHAPTER 1 Introduction 1 6 3 2 Older models The table below lists the firmware CPU support for older J Link amp J Trace models which are not sold anymo
51. fsz Display size of file on emulator fwrite fwr Write file to emulator Connection ip Connect to J Link Pro via TCP IP usb Connect to J Link via USB J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 86 CHAPTER 3 J Link software and documentation package 3 2 1 1 cIrBP This command removes a breakpoint set by J Link Syntax ClrBP BP Handle Parameter Meaning BP Handle Handle of breakpoint to be removed Example clrBP 1 3 2 1 2 cIrWP This command removes a watchpoint set by J Link Syntax ClrWP WP Handle Parameter Meaning WP Handle Handle of watchpoint to be removed Example clrWP 0x2 3 2 1 3 device Selects a specific device J Link shall connect to and performs a reconnect In most cases explicit selection of the device is not necessary Selecting a device enables the user to make use of the J Link flash programming functionality as well as using unlimited breakpoints in flash memory For some devices explicit device selection is mandatory in order to allow the DLL to perform special handling needed by the device Some commands require that a device is set prior to use them Syntax device lt DeviceName gt Parameter Meaning Valid device name Device is selected DeviceName gt Shows a device selection dialog Example device stm32f407ig 3 2 1 4 erase Erases all flash sectors of t
52. o Supported cores ARM Cortex cores Cortex MO Cortex M0 Cortex M1 Cortex M3 Cortex M4 e Cortex M7 e 5 000 MO secure SC300 M3 secure o Table 1 14 J Trace for Cortex M hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 57 1 3 10 Flasher ARM Flasher ARM is a programming tool for microcontrollers with on chip or external Flash memory and ARM core Flasher ARM is designed for programming flash targets with the J Flash soft ware or stand alone In addition to that Flasher ARM has all of the J Link functionality For more information about Flasher ARM please refer to UM08007 Flasher ARM User s Guide Flasher 1 3 10 1 Specifications The following table gives an overview about the specifications general mechanical electrical for Flasher ARM General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 19 Mechanical USB interface USB 2 0 full speed Target interface JTAG SWD 20 pin JTAG Interface Electrical USB powered Max 50mA Target Supply current Power supply Target interface voltage Vir 1 2V 5V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300mA For the whole target voltage range 1 8V lt Vip l
53. rdiserv Connections for a complete list of pos sible arguments Connection Editor EN Comeet LE care nen J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG CHAPTER 11 RDI 5 Confirm the choices by clicking the Apply button after the Connect button Connection E ditor config dll C Program Files SEGGER JLinkARM_V350g JLinkRDI dil modeedosrioad reer config dl C Program Fies GEGGERWLAKARM_VS0gULFKRDI di OK cancel 6 The J Link RDI Configuration dialog will open For more information about the generic setup of J Link RDI please refer to Configuration on page 320 7 Click the OK button to connect to the target Build the project and start the debugger Note that at least one action for example step or run has to be per formed in order to initiate the download of the application ES C Work Basic ghs MULTI Debugger void wait void Begin 0 20027 wait 0 20027 0 2 change speed 0 200280 wait Ox4 0x200284 0 8 0 200286 wait Oxa maD 0200268 wait Oxc 0 20028 wait 0xe 0x20028c wait 0x10 0 20028 wait 0x12 e 0 200290 wait 0x14 End 0 200292 wait Ox16 0x200294 vwait 0x18 0 200296 wait Oxla unsigned int waiting time b500 b084 f7rrttas for waiting time 0 waiting time lt LedSpeed waiting time 2000 e000 30
54. the TCK and TMS lines of all JTAG device are connected while the TDI and TDO lines form a bus to Device1 to Device Currently up to 8 devices in the scan chain are supported One or more of these devices can be CPU cores the other devices can be of any other type but need to comply with the JTAG standard 5 3 1 1 Configuration The configuration of the scan chain depends on the application used Read JTAG interface on page 178 for further instructions and configuration examples 5 3 2 Sample configuration dialog boxes As explained before it is the responsibility of the application to allow the user to con figure the scan chain This is typically done in a dialog box some sample dialog boxes are shown below J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 179 SEGGER J Flash configuration dialog This dialog box can be found at Options Project settings J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 180 CHAPTER 5 Working with J Link and J Trace SEGGER J Link RDI configuration dialog box This dialog can be found under RDI Configure for example in IAR Embedded Work bench For detailed information check the IAR Embedded Workbench user guide J Link RDI Configuration IAR J Link configuration dialog box This dialog box can be found under Project Options f Options for node at91sam7s ek General Op
55. using the J Link RDI configuration dialog 11 4 1 Configuration file JLinkRDl ini All settings are stored in the file JLinkRDI ini This file is located in the same direc tory as JLinkRDI dll 11 4 2 Using different configurations It can be desirable to use different configurations for different targets If this is the case a new folder needs to be created and the JLinkARM d11 as well as the JLinkRDI d11 needs to be copied into it Project A needs to be configured to use JLinkRDI d11 A in the first folder project B needs to be configured to use the DLL in the second folder Both projects will use separate configuration files stored in the same directory as the DLLs they are using If the debugger allows using a project relative path such as IAR EWARM Use for example PROJ_DIR RDI it can make sense to create the directory for the DLLs and configuration file in a subdirectory of the project 11 4 3 Using mutliple J Links simulatenously Same procedure as using different configurations Each debugger session will use their own instance of the JLinkRDI dll 11 4 4 Configuration dialog The configuration dialog consists of several tabs making the configuration of J Link RDI very easy J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 321 11 4 4 1 General tab J Link RDI Configuration 24 x General Init JTAG Flash Breakpoints CPU Loa J L
56. xc lt ConfigurationFilePath gt Example jlinkgdbserver xc C MyProject Sample gdb 3 3 6 Program termination J Link GDB Server is normally terminated by a close or Ctrl C event When the single run mode is active it will also close when an error occurred during start or after all connections to GDB Server are closed On termination GDB Server will close all connections and disconnect from the target device letting it run 3 3 6 1 Exit codes J Link GDB Server terminates with an exit code indicating an error by a non zero exit code The following table describes the defined exit codes of GDB Server Exit code Description 0 No error GDB Server closed normally 1 Unknown error Should not happen 2 Failed to open listener port Default 2331 Could not connect to target No target voltage detected or connection failed 4 Failed to accept a connection from GDB Failed to parse the command line options wrong or missing m command line parameter 6 Unknown or no device name set 7 Failed to connect to J Link Table 3 11 GDB Server exit codes J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 135 3 4 J Link Remote Server J Link Remote Server allows using J Link J Trace remotely via TCP IP This enables you to connect to and fully use a J Link J Trace from another computer Perfor mance is just slightly about 10 lower than with direct
57. 00000514 MAIN LED main Line 35 11 3 4 GHS MULTI 11 3 4 1 Software version J Link RDI has been tested with GHS MULTI version 4 07 There should be no prob lems with other versions of GHS MULTI All screenshots are taken from GHS MULTI version 4 07 11 3 4 2 Configuring to use J Link RDI 1 Start Green Hills Software MULTI integrated development environment Click Con nect Connection Organizer to open the Connection Organizer d Connection rganizer J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 315 2 Click Method New in the Connection Organizer dialog Ez Connection Organizer 3 The Create a new Connection Method will be opened Enter a name for your configuration in the Name field and select Custom in the Type list Confirm your choice with the Create button Create New Connection Method 4 The Connection Editor dialog will be opened Enter rdiserv in the Server field and enter the following values in the Arguments field config dll lt FullPathToJLinkDLLs gt Note that JLinkRDI d11 and JLinkARM d11 must be stored the same directory If the standard J Link installation path or another path that includes spaces has been used enclose the path in quotation marks Example config dll C Program Files NSEGGERNJLinkARM V350gNJLinkRDI dll Refer to GHS manual MULTI Configuring Connections for ARM Targets chapter ARM Remote Debug Interface
58. 0800 F7FFFA20 BL APB2Periphclockcmd GPIO Initstructure GPIO Pin B1 MASK DSODBFFO F44F7080 MOV RO 0 100 0800 4 F8AD0000 STRH RO SP GPIO_Initstructure PIO Mode cero mode IN FLOATING P SCB gt VTOR NVIC VectTab Offset amp u32 0x1FFFFF80 SetVectorTable 4 003068 003386 OXDSDDDSBA LOR RO PC 0x10 003069 003387 oxosoonsec ANDS RO RO RS 003070 003388 0 080008 ORRS RO RO R4 003071 003389 0x080008C0 LOR R1 0 10 003072 003390 oxosoopscz LOR R1 R1 003073 003392 0x0800D8C4 STR RO R1 0 8 003074 003392 oxosoonsce RO R4 R5 PC NVIC PriorityGroupconfig NVIC PriorityGroup 4 003075 003393 DX0S0DBFC2 RO 0 300 003076 003394 0x0800BFC6 BL NVIC PriorityGroupconfig void NVIC PriorityGroupconfig us2 NVIC_PriorityGroup t PriorityGroupconfig 003077 003078 003395 003396 oxosoons4c 0 0800084 PUSH wovs R4 R4 LR RO assert param IS NVIC PRIORITY GROUP NVIC PriorityGroup 003079 003397 0 08000850 R4 0x700 003080 003398 0x08000854 003081 003399 0x08000856 CMP R4 0 600 003082 003400 0X0800085A 003083 003401 Ox0800D85C R4 0 500 003084 003402 008000860 003085 003403 008000862 R4 0 400 003086 003404 0 08000866 003087 003405 0 08000868 CMP R4 0x300 003088 003406 0x0800D86C EN OU On Di 003089 003407 0 0800086 NVIC PriorityGroupconfig
59. 0x10000505 CS2 timing reg read access w4 0 000010 0x10000505 CS2 timing reg write access J Link J Trace UM08001 Speed 4000 mem 0x64000000 100 loadfile C NSTMB672 STM32F103ZE TestBlinky bin 0x64000000 mem 0x64000000 100 2004 2015 SEGGER Microcontroller GmbH amp Co KG 253 6 6 Setup for various debuggers SPIFI flash The J Link DLL supports programming of SPIFI flash and the J Link flash download feature can be used therefor by different debuggers such as IAR Embedded Work bench Keil MDK GDB based IDEs There is nothing special to be done by the user to also enable download into SPIFI flash The setup and behavior is the same as if download into internal flash For more information about how to setup different debuggers for downloading into SPIFI flash memory please refer to Setup for various debuggers internal flash on page 245 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 254 CHAPTER 6 Flash download 6 7 QSPI flash support The J Link DLL also supports programming of any Q SPI flash connected to a device that is supported by the J Link DLL if the device allows memory mapped access to the flash Most modern MCUs CPUs provide a so called QSPI area in their mem ory map which allows the CPU to read access a Q SPI flash as regular memory RAM internal flash etc 6 7 1 Setup the DLL for QSPI flash download There is nothing special to be do
60. 2 executed executed executed executed executed SCB AIRCR AIRCR VECTKEY MASK NVIC_PriorityGroup NVIC PriorityGroupconfig 2 003090 003408 0x0800087A LDR W RO PC 58 003091 003409 0 0800087 LOR Ro RO 003092 003410 0x08000880 LOR R1 PC 0x4 003093 003411 0 08000882 R1 R1 R4 003094 003412 0 08000884 SR Ri RO 0xC 1 003095 003413 0x08000886 POP R4 PC SysTick setReload 900000 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 15 2 3 2 Code coverage Source code tracing 2 IAR Embedded Workbench IDE 200 system Clk_InitO 47 NUIC init zu ifndef FLASH Set the Vector Table base location at 0 20000000 NUIC SetUectorTable NUIC UectTab RAM 8x85 205 else UECT TRB FLASH 2806 2807 Set the Vector Table base location at 0 08000000 x mS SetUectorTable NUIC UectTab FLASH 8x85 tend NUIC PrioricyGroupConFig NUIC Priority roup 45 Z4 SysTick end of count event each 1s with input clock equal to 9MHz CHCLK 8 defaul ITConf ig ENABLED SysTick_CounterCmd SysTick_Counter_Enable gt 7 Buttons rt init 44 GPIO enable clock and release Reset RCC_APB2PeriphResetCmd RCC_APB2Periph_GPIOA i RCC_APB2Periph_GPIOG DISABLE RCC_APB2PeriphClockCmd RCC_APB2Periph_GPIOA i RCC_APB2Periph_GPIOG ENABLE GPIO InitStructure GPIO Pin MASK GP
61. 2004 2014 SEGGER Microcontroller GmbH amp Co KG 272 CHAPTER 8 Monitor Mode Debugging 8 6 Having servicing interrupts in debug mode Under some circumstances it may be useful or even necessary to have some servic ing interrupts still firing while the CPU is halted for the debugger meaning it has taken the debug interrupt and is executing the monitor code This can be for keep ing motor controls active or a Bluetooth link etc In general it is possible to have such interrupts by just assigning a higher priority to them than the debug interrupt has Please keep in mind that there are some limitations for such interrupts e They cannot be debugged e No breakpoints must be set in any code used by these interrupts J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 273 Chapter 9 Low Power Debugging This chapter describes how to debug low power modes on a supported target CPU J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 274 9 1 CHAPTER 9 Low Power Debugging Introduction As power consumption is an important factor for embedded systems CPUs provide different kinds of low power modes to reduce power consumption of the target sys tem The useful this is for the application the problematic it is during debug In gen eral how far debugging target applications that make use of low power modes is possible heavily depends on the device being used as sever
62. 3 Minimizing Crosstalk Normal high speed design rules must be observed For example do not run dynamic signals parallel to each other for any significant distance keep them spaced well apart and use a ground plane and so forth Particular attention must be paid to the TRACECLK signal If in any doubt place grounds or static signals between the TRACECLK and any other dynamic signals 16 1 4 Using impedance matching and termination Termination is almost certainly necessary but there are some circumstances where it is not required The decision is related to track length between the ASIC and the JTAG Trace connector see Terminating the trace signal on page 423 for further ref erence J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 423 16 2 Terminating the trace signal To terminate the trace signal you can choose between three termination options e Matched impedance e Series source termination e DC parallel termination Matched impedance Where available the best termination scheme is to have the ASIC manufacturer match the output impedance of the driver to the impedance of the PCB track on your board This produces the best possible signal Series source termination This method requires a resistor fitted in series with signal The resistor value plus the output impedance of the driver must be equal to the PCB track impedance DC parallel termination This requires either a singl
63. B Target interface JTAG 4000kHz Actual 4000 kHz Host interface USB Port 0 License About 4 exec SetMonModeDebug 1 Ready JLINK ReadMemU32 Done 1 295 sec in 419 calls J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 8 3 269 Availability and limitations of monitor mode Many CPUs only support one of these debug modes halt mode or monitor mode In the following it is explained for which CPU cores monitor mode is available and any limitations if any 8 3 1 Cortex M3 See Cortex M4 on page 269 8 3 2 Cortex M4 For Cortex M4 monitor mode debugging is supported The monitor code provided by SEGGER can easily be linked into the user application Considerations amp Limitations The user specific monitor functions must not block the generic monitor for more than 100ms Manipulation of the stackpointer register SP from within the IDE is not possible as the stackpointer is necessary for resuming the user application on Go The unlimited number of flash breakpoints feature cannot be used in monitor mode This restriction may be removed in a future version It is not possible to debug the monitor itself when using monitor mode J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 270 CHAPTER 8 Monitor Mode Debugging 8 4 Monitor code A CPU core specific monitor code is necessary to perform monitor mod
64. DBGEXT CHAIN and the RANGE bit used to connect one watchpoint with the other one are automatically masked out In order to use these bits you have to set the watchpoint by writing the ICE registers directly Syntax SetWP lt Addr gt lt AccessType gt lt Size gt lt Data gt lt DataMask gt lt AddrMask gt Parameter Meaning Addr Address to be watchpointed Specifies the control data on which data event has been set Accesstype R read access W write access Valid values S8 S16 S32 Specifies to monitor an n bit access width at the selected address Data Specifies the Data on which watchpoint has been set Specifies data mask used for comparison Bits set to 1 are masked out so not taken into consideration during data comparison Please DataMask note that for certain cores not all Bit Mask combinations are sup ported by the core debug logic On some cores only complete bytes can be masked out e g PIC32 or similar Specifies the address mask used for comparison Bits set to 1 are masked out so not taken into consideration during address compar AddrMask ison Please note that for certain cores not all Bit Mask combina tions are supported by the core debug logic On some cores only complete bytes can be masked out e g PIC32 or similar Size Example SetWP 0x20000000 W S8 OxFF 3 2 1 39 sleep Waits the given time in milliseconds Syntax Sleep Delay
65. Date By Explanation Chapter Related Software Section GDB Server SEGGER specific GDB protocol extensions added V4 80 Rev O 131105 JL Chapter Flash Download Replaced references to GDB Server manual Chapter Working withc J Link Replaced references to GDB Server manual V4 76 Rev 3 130823 JL Chapter Related Software V4 76 Rev 2 1130821 JL Section GDB Server Remote commands added Chapter Related Software V4 76 Rev 1 1130819 1 Section SWO Viewer Sample code updated Chapter Related Software Sections reordered and updated Chapter Setup Section Using JLinkARM dll moved here V4 76 Rev 0 130809 JL Chapter Related Software V4 71b Rev 0 130507 Section SWO Viewer Added new command line options Chapter Introduction V4 66 Rev 0 130221 JL Section Supported OS Added Linux and Mac OSX Chapter Introduction V4 62b Rev 0 130219 Section J Link J Trace models Clock rise and fall times updated Chapter Introduction V4 62 Rev 0 130129 JL Section J Link J Trace models Sub section J link ULTRA updated Chapter Target interfaces and adapters V4 62 Rev 0 130124 EL Section 9 pin JTAG SWD connector Pinout description corrected Chapter Intoduction Mo eta Section J Link J Trace models updated Chapter Working with J Link Section J Link script files Sub section Executing J
66. Destination address Required for bin files Example loadfile C Work test bin 0x20000000 3 2 1 21 log Set path to logfile allowing the DLL to output logging information If the logfile already exist the contents of the current logfile will be overwritten Syntax log lt Filename gt Parameter Meaning Filename Log filename J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 91 Example log C Work log txt 3 2 1 22 mem The command reads memory from the target system If necessary the target CPU is halted in order to read memory Syntax mem Zone Addr lt NumBytes gt hex Parameter Meaning zone Name of memory zone to access Addr Start address Numbytes Number of bytes to read Maximum is 0x100000 Example mem 0 100 3 2 1 23 mem8 The command reads memory from the target system in units of bytes If necessary the target CPU is halted in order to read memory Syntax mem8 Zone Addr lt NumBytes gt hex Parameter Meaning Zone Name of memory zone to access Addr Start address NumBytes Number of bytes to read Maximum is 0x10000 Example mem8 0 100 3 2 1 24 mem16 The command reads memory from the target system in units of 16 bits If necessary the target CPU is halted in order to read memory Syntax mem16 Zone Addr NumBytes hex Param
67. Explanation Thh 1 5ns Data hold high Tsl 2 5ns Data setup low Thl 1 5ns x Data hold low Table 14 9 Clock frequency The diagram below shows the TRACECLK frequencies and the setup and hold timing of the trace signals with respect to TRACECLK Tperiod Full TRACECLK Tch Tcl DATA Tsh Thh Tsl Thl Half rate TRACECLK Note 1 supports half rate clocking mode Data is output on each edge of the TRACECLK signal and TRACECLK max lt 100MHz For half rate clocking the setup and hold times at the JTAG Trace connector must be observed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 402 CHAPTER 14 Target interfaces and adapters 14 3 19 JTAG SWD and Trace connector J Trace provides a JTAG SWD Trace connector This connector is a 19 pin connector It connects to the target via an 1 1 cable VTref 1ee2 SWDIO TMS GND 3 4 SWCLK TCK GND 5 6 SWO TDO ses 7 e8 TDI NC 9 ee 10 nRESET 5V Supply 11 12 TRACECLK 5V Supply 13 14 TRACEDATA O0 GND 15 e 16 TRACEDATA 1 GND 17 18 TRACEDATA 2 GND 19 e 20 TRACEDATA 3 The following table lists the J Link J Trace SWD pinout PIN SIGNAL TYPE Description VTref Input This is the target reference voltage It is used to check if the target has power to create the logic level reference for the input com
68. First choose the right device in the project settings if not already done The device settings can be found at Project gt Options gt General Options gt Target Options for node at91sam7s ek C C Compiler Assembler Output Converter Custom Build Build Actions Linker Debugger Simulator Angel GDB Server IAR ROM monitor J Link J Trace LMI FTDI Macraigor RDI Third Party Driver To use the J Link flash loaders the IAR flash loader has to be disabled To disable the IAR flash loader the checkbox Use flash loader s at Project gt Options gt Debug ger gt Download has to be disabled as shown below Options for node at91sam7s ek General Options C C Compiler Assembler Output Converter Custom Build Build Actions Linker Angel GDB Server IAR ROM monitor J Link J Trace LMI FTDI Third Party Driver 6 4 2 Keil To use the J Link flash download feature in Keil MDK the following steps need to be performed J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 246 CHAPTER 6 Flash download First choose the device in the project settings if not already done The device set tings can be found at Project gt Options for Target gt Device X Options for Target MCBSTM32E Flash Device Target Output Listing User Linker Debug Utities Database Generic CPU Data Base 71 Vendor STMicroelectronics Device STM32
69. J Flash SPI contains seven drop down menus File Edit View Target Options Window Help Any option within these drop down menus that is followed by a three period ellipsis is an option that requires more information before proceeding J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG File menu elements CHAPTER 10 J Flash SPI Command Description Open data file Opens a data file that may be used to flash the target device The data file must be an Intel HEX file a Motorola S file or a Binary file hex mot srec Or bin Merge data file Merges two data files hex mot srec Or bin All gaps will be filled with FF Find below a short example of merging two data files named FileO bin and File1 bin into File3 bin FileO bin gt Addr 0x0200 OxO2FF File1 bin gt Addr 0x1000 Ox13FF Merge FileO bin amp File1 bin 0x0200 OxO2FF Data of FileO bin 0x0300 OxOFFF gap will be filled with OxFF if image is saved as bin file 0x1000 Ox13FF Data of Filei bin Can be saved in new data file File3 bin Save data file Saves the data file that currently has focus Save data file as Saves the data file that currently has focus using the name and location given New Project Creates a new project using the default settings Open Project Opens a project file Note that only one project file may be open at a time Open
70. J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 199 5 8 2 Strategies for Cortex M devices J Link supports different specific reset strategies for the Cortex M cores All of the following reset strategies are available in JTAG and in SWD mode All of them halt the CPU after the reset Note It is recommended that the correct device is selected in the debugger so the debugger can pass the device name to the J Link DLL which makes it possible for J Link to detect what is the best reset strategy for the device Moreover we recom mend that the debugger uses reset type 0 to allow J Link to dynamically select what reset is the best for the connected device 5 8 2 1 Type 0 Normal This is the default strategy It does whatever is the best way to reset the target device If the correct device is selected in the debugger this reset strategy may also perform some special handling which might be necessary for the connected device This for example is the case for devices which have a ROM bootloader that needs to run after reset and before the user application is started especially if the debug interface is disabled after reset and needs to be enabled by the ROM bootloader For most devices this reset strategy does the same as reset strategy 8 does 1 Make sure that the device halts immediately after reset before it can execute any instruction of the user application by setting the vc CORERESET the DEMC
71. J Link is selected following pop up will shop and allow the user to select the proper J Link SEGGER J Link V4 90a Emulator selection Please select the emulator you want to connect to USB Identification 1 SN 284200004 2 SN 421000000 3 SN 651000001 4 SN 58200006 Gee The sketch below shows a host running two application programs Each application communicates with one CPU core via a separate J Link J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 190 CHAPTER 5 Working with J Link and J Trace Older J Links may report USBO 3 instead of unique serial number when enumerating via USB For these J Links we recommend to re configure them to use the new enu meration method report real serial number since the USBO 3 behavior is obsolete Re configuration can be done by using the J Link Configurator which is part of the J Link software and documentation package For further information about the J Link configurator and how to use it please refer to J Link Configurator on page 165 Re configuration to the old USB 0 3 enumeration method In some special cases it may be necessary to switch back to the obsolete USB 0 3 enumeration method For example old IAR EWARM versions supports connecting to a J Link via the USBO 3 method only As soon as more than one J Link is connected to the pc there is no oppertunity to pre select the J Link which should be used for a deb
72. J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 100 CHAPTER 3 J Link software and documentation package Additional information To select from a list of all available emulators on Ethernet please use as lt IPAddr gt 3 2 2 7 JLinkScriptFile Passes the path of a J Link script file to the J Link Commander J Link scriptfiles are mainly used to connect to targets which need a special connection sequence before communication with the core is possible For more information about J Link script files please refer to J Link script files on page 204 Syntax JLink exe JLinkScriptFile lt File gt Example JLink exe JLinkScriptFile C My Projects MDefault JLinkScript 3 2 2 8 SelectEmuBySN Connect to a J Link with a specific serial number via USB Useful if multiple J Links are connected to the same PC and multiple instances of J Link Commander shall run and each connects to another J Link Syntax SelectEmuBySN SerialNo Example JLink exe SelectEmuBySN 580011111 3 2 2 9 SettingsFile DescriptionSelect a J Link settings file to be used for the target device The settings fail can contain all configurable options of the Settings tab in J Link Control panel Syntax SettingsFile lt PathToFile gt Example JLink exe SettingsFile C Work settings txt 3 2 2 10 Speed Starts J Link Commander with a given initial speed Available parameters are adap tive auto or a freely s
73. JTAG Table 1 11 Download speed differences between hardware revisions J Trace Rev 1 All tests have been performed in the testing environment which is described on Mea suring download speed on page 426 The actual speed depends on various factors such as JTAG clock speed host CPU core etc 1 3 8 4 Hardware versions Version 1 This J Trace uses a 32 bit RISC CPU Maximum download speed is approximately 420 KBytes second 600 KBytes second using DCC J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 54 CHAPTER 1 1 3 9 J Trace for Cortex M J Trace for Cortex M is a JTAG SWD emulator designed for Cor tex M cores which includes trace ETM support J Trace for Cortex M can also be used as a J Link and it also supports ARM7 9 cores Tracing ARM7 9 targets is not supported 1 3 9 1 Additional features e Has all the J Link functionality e Supports tracing on Cortex M targets e Comes with built in licenses for breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming software 1 3 9 2 Specifications Unlimited number of Introduction The following table gives an overview about the specifications general mechanical electrical for J Trace for Cortex M All values are valid for the latest hardware ver sion of J Trace for Cortex M General Supported OS For a complete list of all operating
74. Link Commander exitonerror eoe Commander exits after error Prints firmware info go Starts the CPU core halt h Halts the CPU core hwinfo Show hardware info is Scan chain select register length loadfile Load data file into target memory log Enables log to file mem Read memory mem8 Read 8 bit items mem16 Read 16 bit items mem32 Read 32 bit items mem64 Read 64 bit items mr Measures reaction time of RTCK pin ms Measures length of scan chain power Switch power supply for target Resets and halts the target regs Shows all current register values rnh Resets without halting the target rreg Shows a specific register value rx Reset target with delay savebin Saves target memory into binary file setBP Set breakpoint SetPC Set the PC to specified value SetWP Set watchpoint sleep Waits the given time in milliseconds Speed Set target interface speed st Shows the current hardware status step s Single step the target chip unlock Unlocks a device verifybin Compares memory with data file wl Write 8 bit items w2 Write 16 bit items w4 Write 32 bit items wreg Write register Flasher I O fdelete fdel Delete file on emulator flist List directory on emulator fread frd Read file from emulator J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 85 Command short form Explanation fshow Read and display file from emulator fsize
75. Link RDI log file c NJLinkRDI log J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 328 CHAPTER 11 Example of logfile content 060 028 0000 Logging started 2005 10 28 07 36 060 028 0000 DLL Compiled Oct 4 2005 09 14 54 060 031 0026 ARM SetMaxSpeed 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOF Speed 4000 kHz 060 059 0000 ARM SetEndian ARM ENDIAN LITTLE 060 060 0000 ARM SetEndian ARM ENDIAN LITTLE 060 060 0000 ARM ResetPullsRESET ON 060 060 0116 ARM Reset SpeedIsFixed 0 060 176 0000 ARM WriteIceReg 0x02 00000000 060 177 0016 ARM WriteMem FFFFFC20 0004 Data 8 OxFFFFFC20 gt 1D7 gt 060 194 0014 ARM WriteMem FFFFFC2C 0004 Data 8 OxFFFFFC2C gt 195 gt 060 208 0015 ARM WriteMem FFFFFC30 0004 Data 8 OxFFFFFC30 gt 195 gt 060 223 0002 ARM ReadMem 00000000 0004 speed 060 225 0001 ARM WriteMem 00000000 0004 Data 0x00000000 gt 195 gt 060 226 0001 ARM_ReadMem 00000000 0004 Data 060 227 0001 ARM WriteMem FFFFFF00 0004 Data 8 OxFFFFFFOO gt 195 gt 060 228 0001 ARM ReadMem FFFFF240 0004 Data 060 229 0001 ARM ReadMem FFFFF244 0004 Data 060 230 0001 ARM ReadMem FFFFFF6C 0004 Data 060 232 0000 ARM WriteMem FFFFF124 0004 Data 8 OxFFFFF124 gt 195 gt 060 232 0001 ARM_ReadMem FFFFF130 0004 Data 060 233 0001 ARM ReadMem FFFFF130 0004 Data 060 234 0001 ARM Rea
76. Link script files updated V4 58 Rev O 121126 JL Chapter Related Software Section J Link SWO Viewer Added sub section Configure SWO output after device reset V4 56b Rev 0 1121112 JL Chapter Related Software Section J Link Commander V4 56a Rev 0 121106 JL Renamed Commander script files to Commander files and script mode to batch mode Renamed J Link TCP IP Server to J Link Remote V4 56 Rev O 121022 Server Chapter Related Software V4 54 Rev 1 121009 Section TCP IP Server subsection Tunneling Mode added J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation Chapter Flash Breakpoints Section Licensing updated V4 54 Rev O 120913 Chapter Device specifics Section Freescale subsection Data flash support added 4 5 20 120904 Chabter Licensing Section Device based license updated Chapter Flash download Section J Link commander updated Chapter Support and FAQs Meron RENEO VEE Section Frequently asked questions updated Chapter J Link and J Trace related software Section J Link Commander updated Chapter Working with J Link V4 51e Rev 1 120704 EL Section Reset strategies updated and corrected Added reset type 8 Chapter Device specifics
77. O 9 9 Supported cores ARM legacy cores ARM7 ARM9 ARM11 eo ARM Cortex cores Cortex A5 Cortex A7 Cortex A8 Cortex A9 Cortex A12 Cortex A15 Cortex A17 eo Table 1 4 J Link PLUS hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 39 Hardware version N 5 000 MO secure SC300 M3 secure Cortex MO Cortex M0 Cortex M1 Cortex M3 Cortex M4 Cortex M7 Cortex R4 Cortex R5 Microchip PIC32 Microchip PIC32MX Microchip PIC32MZ Renesas RX Renesas RX110 Renesas RX111 Table 1 4 J Link PLUS hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 40 CHAPTER 1 Introduction N Hardware version Renesas RX210 Renesas RX21A Renesas RX220 Renesas RX610 Renesas RX621 Renesas RX62G Renesas RX62N Renesas RX62T Renesas RX630 Renesas RX631 Renesas RX63N O 9 6 6 6 6 6 6 6 06 0 9 9 6 6 9 6 6 06 9 9 Renesas RX63T Table 1 4 J Link PLUS hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller Gmb
78. RAM during execution of the application in the back ground This process normally takes just fractions of a second and does not delay program execution I am debugging a RAM only application J Link finds an RTT buffer but I get no output What can I do In case the init section of an application is stored in RAM J Link migh falsely iden tify the block in the init section instead of the actual one in the data section To prevent this set the define SEGGER_RTT_IN_RAM to 1 Now J Link will find the correct RTT buffer but only after calling the first SEGGER_RTT function in the application A call to SEGGER_RTT_Init at the beginning of the application is rec ommended Can this also be used on targets that do not have the SWO pin Yes the debug interface is used This can be JTAG or SWD 2pins only on most Cortex M devices or even the FINE interface on some Renesas devices just like the Infineon SPD interface single pin Can this also be used on Cortex MO MO Yes Some terminal output printf Solutions crash program execution when executed outside of the debug environment because they use a Software breakpoint that triggers a hardfault without debugger or halt because SWO is not initialized That makes it impossible to run a Debug build in stand alone mode What about SEGGER RTT SEGGER RTT uses non blocking mode per default which means it does not halt program execution if no debugger is present and J Link is not
79. REG CTRL STAT JLINK CORESIGHT DP REG SELECT JLINK CORESIGHT DP REG RDBUF JLINK CORESIGHT AP CTRL JLINK CORESIGHT AP ADDR JLINK CORESIGHT AP REG DATA JLINK CORESIGHT AP REG BDO JLINK CORESIGHT AP REG BD1 JLINK CORESIGHT AP REG BD2 JLINK CORESIGHT AP REG BD3 JLINK CORESIGHT AP REG ROM JLINK CORESIGHT AP REG IDR 5 11 4 3 Constants for global variable MAIN ActiveTIF e 1 e JLINK TIF SWD J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 215 5 11 5 Script file language The syntax of the J Link script file language follows the conventions of the C lan guage but it does not support all expresisons and operators which are supported by the C language In the following the supported operators and expressions are listed 5 11 5 1 Supported Operators The following operators are supported by the J Link script file language Multiplicative operators Additive operators Bitwise shift operators lt lt gt gt Relational operators lt gt lt gt Equality operators Bitwise operators amp Logical operators amp amp Assignment operators lt lt gt gt amp s 5 11 5 2 Supported type specifiers The following type specifiers are supported by the J Link script file language void char int 32 bit int64 5 11 5 3 Supported type qualifiers The following type qualifi
80. Support support segger com ck ck ckck KEK KKK KKK ck ck ck ck ckckck ckck ck ck ck ck ck ck ck ck ck kc k k File s Purpose Simple implementation for output via RTT It can be used with any IDE END OF HEADER include SEGGER RTT h static void _Delay int period int i 100000 period do while i int main void int Cnt 0 SEGGER RTT WriteString 0 Hello World from SEGGER n do SE GGER RTT printf sCounter s d n RTT CTRL TEXT BRIGHT WHITE RTT CTRL TEXT BRIGHT GREEN Cnt if Cnt 100 SEGGER RTT TerminalOut 1 RTT CTRL TEXT BRIGHT RED Counter overflow Ent 0 _Delay 100 Cnt while 1 return 0 fORCKCKCKk kc kckck c kckckckckckckckckckckck XXE EX End of file XCKCkckckckck kck ck ck ck ckckckck ck KKK KEK KK KKK J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 353 12 6 FAQ Q A How does J Link find the RTT buffer There are two ways If the debugger IDE knows the address of the SEGGER RTT Control Block it can pass it to J Link This is for example done by J Link Debugger If another application that is not SEGGER RTT aware is used then J Link searches for the ID in the known target
81. The batch mode of J Link Commander is similar to the execution of a batch file The com mand file is parsed line by line and one command is executed at a time J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 151 Syntax CommanderScript lt CommandFilePath gt Example See Using command files on page 100 DRPre DRPost IRPre and IRPost Scan Chain Configuration STR91x allows to configure a specific scan chain via command line To use this fea ture four command line options have to be specified in order to allow a proper con nection to the proper device In case of passing an incomplete configuration the utility tries to auto detect Syntax DRPre lt DRPre gt DRPost lt DRPost gt IRPre lt IRPre gt IRPost lt IRPost gt Example JLink exe DRPre 1 DRPost 4 IRPre 16 IRPost 20 IP Selects IP as host interface to connect to J Link Default host interface is USB Syntax IP lt IPAddr gt Example JLinkSTR91x exe IP 192 168 1 17 Additional information To select from a list of all available emulators on Ethernet please use as lt IPAddr gt SelectEmuBySN Connect to a J Link with a specific serial number via USB Useful if multiple J Links are connected to the same PC and multiple instances of J Link STR91x Commander shall run and each connects to another J Link Syntax SelectEmuBySN lt SerialNo gt Example JLinkSTR91x exe SelectEmuBySN 580011111
82. The normal J Link however comes without any licenses For more information about licensing itself and which devices have a device based license please refer to Licensing on page 67 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 304 CHAPTER 11 RDI 11 3 Setup for various debuggers The J Link RDI software is an ARM Remote Debug Interface RDI for J Link It makes it possible to use J Link with any RDI compliant debugger Basically J Link RDI con sists of a additional DLL JLinkRDI d11 which builds the interface between the RDI API and the normal J Link DLL The JLinkRDI d11 itself is part of the J Link software and documentation package 11 3 1 IAR Embedded Workbench IDE J Link RDI can be used with IAR Embedded Workbench for ARM 11 3 1 1 Supported software versions J Link RDI has been tested with IAR Embedded Workbench IDE version 4 40 There should be no problems with other versions of IAR Embedded Workbench IDE All screenshots are taken from IAR Embedded Workbench version 4 40 Note Since IAR EWARM V5 30 J Link is fully and natively supported by EWARM so RDI is no longer needed 11 3 1 2 Configuring to use J Link RDI 1 Start the IAR Embedded Workbench and open the tutor example project or the desired project This tutor project has been preconfigured to use the simulator driver In order to run the J Link RDI the driver needs to be changed 1 Embedded Workbench IDE
83. This is the target reference voltage It is used to check if the target has power to create the logic level reference for 1 VTref Input the input comparators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor 2 NOLO NC This pin is not connected in J Link nected This pin is not used by J Link If the device may also be 3 Not Used NC accessed via JTAG this pin may be connected to nTRST otherwise leave open This pin is not used by J Link If the device may also be 5 Not used NC accessed via JTAG this pin may be connected to TDI other wise leave open Single bi directional data pin A pull up resistor is required mENDBIO 1 0 ARM recommends 100 kOhms Clock signal to target CPU It is recommended that this pin is pulled to a defined state CLR eu on the target board Typically connected to TCK of target CPU This pin is not used by J Link when operating in SWD mode 11 Not used NC If the device may also be accessed via JTAG this pin may be connected to RTCK otherwise leave open Serial Wire Output trace port Optional not required for 92 499 Input SWD communication Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is typically called nRST nRESET or RESET 17 Not used NC This pin is not connected in J Link This pin can be used to supply power to the target hard 5V Sup w
84. USB connection IPStat Connected to 127 0 0 1 R Total 21 21 5 30 USBStat fide wW WR 7 9 waiting for client on port 19020 The J Link Remote Server also accepts commands which are passed to the J Link Remote Server via the command line 3 4 1 List of available commands The table below lists the commands accepted by the J Link Remote Server Command Description Selects the port on which the J Link Remote Server is pe listening SelectEmuBySN Selects the J Link to connect to by its Serial Number Table 3 12 Available commands 3 4 1 1 port Syntax port lt Portno gt Example To start the J Link Remote Server listening on port 19021 the command should look as follows port 19021 3 4 1 2 SelectEmuBySN Syntax SelectEmu Example BySN S N To select the emulator with Serial Number 268000000 the command should look as follows SelectEmu J Link J Trace UM08001 BySN 268000000 2004 2015 SEGGER Microcontroller GmbH amp Co KG 136 CHAPTER 3 J Link software and documentation package 3 4 2 Tunneling mode The Remote server provides a tunneling mode which allows remote connection to a J Link J Trace from any computer even from outside the local network To give access to a J Link neither a remote desktop or vpn connection nor changing some difficult firewall settings is necessary When started in tu
85. X n en e EE D tr Rc a 317 11 4 ri eth Ed re Rat Ex Fer nets EDAX ER be beth S E E LONE EORR 320 11 4 1 Configuration file m Hmm 320 11 4 2 Using different configurations 320 11 4 3 Using mutliple J Links 320 11 4 4 Configuration dialog 320 11 5 STi EIE 329 11 5 1 P 329 11 5 2 The SWI interface esee eere een nenne en m ey n en s ENS 329 11 5 3 Implementation of semihosting in J Link RDI eee 330 11 5 4 Semihosting With AX Dies iretur delat iced de rs E pae du WEE al Hy SW da a 330 11 5 5 Unexpected Unhandled 5 16 2 7 1 6 331 M LM CD TED MENU PPM MEN UE 333 12 1 Introductions svedese E Er eripe Ere aod RD EE Era wie asad aS 334 12 2 Dee roe eu o 335 12 2 1 Target implementation 1 1111 335 12 2 2 Locating the control a xe elated 335 12 2 3 Internal Structures x ee res ree EA wale 335 12 2 4 Req ltetrmernts ac cece led cuca e a Vide reb AN edat ades ice wean ia gres qa i 336 12 2 5 Performance ER 33
86. a built in 20 pin JTAG SWD connector Incl Licen 21723 vede Mean cs Lin ashloaders J Link GDB Server Pas J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI J Link PRO is a JTAG emulator designed for ARM cores It connects via USB or Ethernet to a PC running Microsoft Windows Apple OSX or Linux J Link has a built in 20 pin JTAG connector which is compatible with the standard 20 pin connector defined by ARM Included Licenses J Link Flashloaders J Link GDB Server J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI 2 4 5J Trace ARM 1 ARM is JTAG emulator designed for ARM cores which includes trace ETM support It connects via USB to a PC run ning Microsoft Windows Apple OSX or Linux J Trace has a built in 20 pin JTAG connector and a built in 38 pin JTAG Trace connector which is compatible with the standard 20 pin con nector and 38 pin connector defined by ARM Included Licenses J Link Flashloaders J Link GDB Server J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 73 2 4 6 J Trace for Cortex M J Link J Trace UM08001 J Trace for Cortex M is a JTAG SWD emulator designed for Cor tex M cores which include trace ETM support J Trace for Cor tex M can also be used as a regular J Link Included Licenses J Link Flashloaders J Link GDB S
87. about the J Link STM32 Commander please refer to J Link STM32 Unlock Command line tool on page 151 Note memory Unsecuring a secured device will cause a mass erase of the internal flash 13 16 2 4Hardware watchdog J Link J Trace UM08001 The hardware watchdog of a STM32F10x device can be enabled by programming the option bytes If the hardware watchdog is enabled the device is reset periodically if the watchdog timer is not refreshed and reaches If the hardware watchdog is enabled by an application which is located in flash and which does not refresh the watchdog timer the device can not be debugged anymore 2004 2015 SEGGER Microcontroller GmbH amp Co KG 383 Disabling the hardware watchdog In order to disable the hardware watchdog the option bytes have to be re pro grammed SEGGER offers a free command line tool which reprograms the option bytes in order to disable the hardware watchdog For more information about the STM32 commander please refer to J Link STM32 Unlock Command line tool on page 151 13 16 2 5Debugging with software watchdog enabled If the device shall be debugged with one of the software watchdogs independed watchdog window watchdog enabled there is an additional init step necessary to make the watchdog counter stop when the CPU is halted by the debugger This is configured in the DBGMCU CR register The following sequence can be used to enable debugging with software watchdogs enable
88. adaptive clocking for these devices 13 16 1 2Unlocking The devices have 3 TAP controllers built in When starting J Link exe it reports 3 JTAG devices A special tool J Link STR9 Commander JLinkSTR91x exe is available to directly access the flash controller of the device This tool can be used to erase the flash of the controller even if a program is in flash which causes the ARM core to stall For more information about the J Link STR9 Commander please refer to J Link STR91x Commander Command line tool on page 150 When starting the STR91x commander a command sequence will be performed which brings MCU into Turbo Mode While enabling the Turbo Mode a dedicated test mode signal is set and controls the GPIOs in output The IOs are maintained in this state until a next JTAG instruction is sent ST Microelectronics Enabling Turbo Mode is necessary to guarantee proper function of all commands in the STR91x Commander 13 16 1 3Switching the boot bank The bootbank of the STR91x devices can be switched by using the J Link STR9 Com mander which is part of the J Link software and documentation package For more information about the J Link STR9 Commander please refer to J Link STR91x Com mander Command line tool on page 150 13 16 2 STM32F10xxx These devices are Cortex M3 based All devices of this family are supported by J Link 13 16 2 1ETM init The following sequence can be used to prepare STM32F10xxx devices for 4
89. after reset The ROM bootloader is NOT executed 5 8 2 7 Type 6 Reset for Freescale Kinetis devices Performs a via reset strategy 0 normal first in order to reset the core amp peripherals and halt the CPU immediately after reset After the CPU is halted the watchdog is disabled since the watchdog is running after reset by default If the target applica tion does not feed the watchdog J Link loses connection to the device since it is reset permanently 5 8 2 8 Type 7 Reset for Analog Devices CPUs ADI Halt after kernel Performs a reset of the core and peripherals by setting the SYSRESETREQ bit in the AIRCR The core is allowed to perform the ADI kernel which enables the debug inter face but the core is halted before the first instruction after the kernel is executed in order to guarantee that no user application code is performed after reset 5 8 2 9 Type 8 Reset core and peripherals J Link tries to reset both core and peripherals by setting the SYSRESETREQ bit in the AIRCR VC CORERESET in the DEMCR is also set to make sure that the CPU is halted immediately after reset and before executing any instruction Reset procedure 1 Make sure that the device halts immediately after reset before it can execute any instruction of the user application by setting the vc CORERESET in the DEMCR 2 Reset the core and peripherals by setting the SYSRESETREQ bit in the AIRCR 3 Wait for the
90. allows to specify the instruction register organization of the tar get system This may be needed if there are more devices located on the target sys tem than the ARM chip you want to access or if more than one target system is connected to one J Link at once J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 325 11 4 4 4 Flash tab J Link RDI Configuration 24 x General Int JTAG Flash Breakpoints CPU Log w Enable flash programming Allows programming the flash This is required to download a program into flash memory or to set software breakpoints in flash flash breakpoints Device Atmel ATS1SAM7S64 Clock speed 48000000 Hz RAM 16 KB address 0 200000 rw Cache flash contents Allows caching of flash contents This avoids reading data twice and speeds up the transfer between debugger and target Allow flash download Allows program download to flash Y our debugger does not need to have a flash loader This feature requires an additional license FlashDL Show info window during download Cancel Apply Enable flash programming This checkbox enables flash programming Flash programming is needed to use either flash download or flash breakpoints If flash programming is enabled you must select the correct flash memory and flash base address Furthermore it is necessary for some chips to enter the correct CPU clock fr
91. bit If no mask is given an ARM instruction breakpoint will be set Example Set a breakpoint implicit for ARM instructions gt monitor setbp 0x00000000 Set a breakpoint on a THUMB instruction gt monitor setbp 0x00000100 0x01 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 117 3 3 3 25 sleep Syntax sleep lt Delay gt Description Sleeps for a given time where lt Delay gt is the time period in milliseconds to delay While sleeping any communication is blocked until the command returns after the given period Example gt monitor sleep 1000 lt Sleep 1000ms 3 3 3 26 speed Note Deprecated For setting the initial connection speed use command line option speed instead Syntax speed lt kHz gt auto adaptive Description Sets the JTAG speed of J Link J Trace Speed can be either fixed in kHz automatic recognition or adaptive In general Adaptive is recommended if the target has an RTCK signal which is connected to the corresponding RTCK pin of the device S cores only For detailed information about the different modes refer to JTAG Speed on page 182 The speed has to be set after selecting the interface to change it from its default value Example monitor speed auto Select auto target interface speed 8000 kHz monitor speed 4000 Target interface speed set to 4000 kHz monitor speed adaptive Select adaptive clocking instead of fix
92. bit ETM tracing int v DBGMCU_CR enable trace I O and configure pins for 4 bit trace v volatile int 0xE0042004 v amp 7 lt lt 5 Preserve all bits except the trace pin configuration v 7 lt lt 5 Enable trace I O and configure pins for 4 bit trace volatile int 0xE0042004 13 16 2 2 Option byte programming J Flash supports programming of the option bytes for STM32 devices In order to program the option bytes simply choose the appropriate Device which allows option byte programming in the CPU settings tab e g STM32F103ZE allow opt bytes J Flash will allow programming a virtual 16 byte sector at address J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 382 CHAPTER 13 Device specifics 0x06000000 which represents the 8 option bytes and their complements You do not have to care about the option bytes complements since they are computated auto matically The following table describes the structure of the option bytes sector Address 31 24 23 16 15 8 7 0 0x06000000 complement Option byte 1 complement Option byte 0 0x06000004 complement Option byte 3 complement Option byte 2 0x06000008 complement Option byte 5 complement Option byte 4 0x0600000C complement Option byte 7 complement Option byte 6 Table 13 1 Option bytes sector description Note Writing a value of OxFF inside
93. cause a read modify write operation SetFlashDLThreshold Set minimum amount of data to be downloaded SetIgnoreReadMemErrors Specifies if read memory errors will be ignored SetIgnoreWriteMemErrors Specifies if write memory errors will be ignored SetMonModeDebug Enables Disables monitor mode debugging SetResetPulseLen Defines the length of the RESET pulse in milliseconds SetResetType Selects the reset strategy SetRestartOnClose Specifies restart behavior on close SetRTTAddr Set address of the RTT buffer SetRTTSearchRanges Set ranges to be searched for RTT buffer SetRXIDCode Specifies an ID Code for Renesas RX devices to be used by the J Link DLL SetSkipProgOnCRCMatch Specifies the CRC match compare mode to be used Deprecated use SetCompareMode instead SetSysPowerDownOnIdle Used to power down the target CPU when there are no transmissions between J Link and target CPU for a specified timeframe SetVerifyDownload Specifies the verify option to be used SetWorkRAM Specifies RAM area to be used by the J Link DLL ShowControlPanel Opens control panel SilentUpdateFW Update new firmware automatically SupplyPower Activates Deactivates power supply over pin 19 of the JTAG connector SupplyPowerDefault Activates Deactivates power supply over pin 19 of the JTAG connector permanently SuppressContro
94. configured in the DBGMCU 1 FZ register The following sequence can be used to enable debugging with software watchdogs enabled Configure both watchdog timers to be halted if the CPU is halted by the debugger volatile int 0xE0042008 1 lt lt 11 1 12 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 13 17 Texas Instruments 385 J Link has been tested with the following Texas Instruments devices AM3352 AM3354 AM3356 AM3357 AM3358 AM3359 OMAP3530 OMAP3550 OMAP4430 OMAP L138 TMS470M TMS470R1A64 TMS470R1A128 TMS470R1A256 TMS470R1A288 TMS470R1A384 TMS470R1B512 TMS470R1B768 TMS470R1B1M TMS470R1VF288 TMS470R1VF688 TMS470R1VF689 13 17 1 AM335x AM335x series devices need some special handling which requires the correct device is selected in the J Link DLL When used out of a debugger this is usually done automatically see Software reset on page 356 For J Link Commander amp J Link GDBServer this needs to be done manually 13 17 1 1Selecting the device in the IDE When using J Link in an IDE there is usually a way to directly select the device in the IDE since it usually also needs this information for peripheral register view etc The selected device is then usually automatically passed to the J Link DLL The screenshot below is an example for a device selection inside emIDE http www emide org
95. connector 402 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 14 3 1 Target pOwer SUDDIY veh ev eee seta reco Qv EX S bende reer eet 403 14 4 9 JTAG SWD 1 1242 24 14 4 aan nnn nnn 404 14 5 Reference voltage 66 6 nena nnn nnn 405 14 6 Adapters sce cic tee xr nevi breads e rae aia uve RR veces 406 15 3Backgrourid Informations cq es ERR neca ea ava d Poe CERE Ene adn tendent 407 15 1 an ES 408 15 1 1 Test access port TAP swiss cece erie nan p 408 15 1 2 Data registers serais xt kx e verde ene tie ax aa aga Y Ra era 408 15 1 3 Instruction register coriis arrani Vanas xe de mee 408 15 1 4 The TAP controller ie nier 409 15 2 Embedded Trace Macrocell ETM rss 411 15 2 1 Trigger condition tr EVER 411 15 2 2 Code tracing and data 00 411 15 2 3 J Trace integration example Embedded Workbench for ARM 411 15 3 Embedded Trace Buffer ETB 2 44 mnes 415 15 4 Flash programming eco
96. const char s Parameters Parameter Meaning Terminalld Id of the virtual terminal 0 9 S Pointer to O terminated string to be sent Table 12 7 SEGGER RTT TerminalOut parameter list Return value gt 0 Number of bytes sent to the terminal Example Sent a string to terminal 1 without changing the standard terminal SEGGER RTT TerminalOut 1 ERROR Buffer overflow Additional information SEGGER RTT TerminalOut does not affect following data which is sent via channel 0 12 4 1 10SEGGER RTT Write Description Send data to the host on an RTT channel Prototype int SEGGER RTT Write unsigned BufferIndex const char pBuffer unsigned NumBytes J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 349 Parameters Parameter Meaning BufferIndex Index of the up channel to send data to pBuffer Pointer to data to be sent NumBytes Number of bytes to send Table 12 8 SEGGER_RTT_Write parameter list Return value gt 0 Number of bytes which have been sent Additional information With SEGGER_RTT_Write all kinds of data not only printable one can be sent 12 4 1 11SEGGER_RTT_WaitKey Description Waits until at least one character is avaible in SEGGER RTT buffer 0 Once a character is available it is read and returned Prototype int SEGGER RTT WaitKey void Return value gt 0 Character
97. controlled via the J Link commander The following commands are available to control power Command Explanation power on Switch target power on power off Switch target power off power on perm Set target power supply default to on power off perm Set target power supply default to off Table 14 4 Command List J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 395 14 1 3 Pinout for SWD Virtual COM Port VCOM The J Link and J Trace JTAG connector is also compatible to ARM s Serial Wire Debug SWD Vater bd INE Not used 3e 4 GND On later J Link products like the J link ULTRA Jj LinkTx 5e GND these pins are reserved for firmware extension swbpio 79 e8 GND purposes They can be left open or connected to SWCLK 9e 10 GND GND in normal debug environment They are not Notused 11e e 12 GND essential for JTAG SWD in general swo 13 14 GND RESET 159 916 GND The following table lists the J Link J Trace SWD j LinkRx 179 18 GND pinout 5V Supply 99 20 GND PIN SIGNAL TYPE Description This is the target reference voltage It is used to check if the target has power to create the logic level reference for 1 VTref Input the input comparators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor 2
98. created on first start of a debug session There is one settings file per build configuration for the project Naming is _ lt ProjectName gt _ lt DebugConfigName gt jlink The settings file is created in the same directory where the project file emProject is located Example The SES project is called MyProject and has two configurations Debug and Release For each of the configurations a settings file will be created at the first start of the debug session _MyProject_Debug jlink _MyProject_Release jlink 5 10 2 Keil MDK ARM uVision Settings file with default settings is created on first start of a debug session There is one settings file per project Naming is JLinksettings ini The settings file is created in the same directory where the project file uvprojx is located 5 10 3 IAR EWARM Settings file with default settings is created on first start of a debug session There is one settings file per build configuration for the project Naming is lt ProjectName gt _ lt DebugConfig gt jlink The settings file is created in a settings subdirectory where the project file is located 5 10 4 Mentor Sourcery CodeBench for ARM CodeBench does not directly specify a J Link settings file but allows the user to spec ify a path to one in the project settings under Debugger Settings File We rec ommend to copy the J Link settings file template from SJLINK_INST_DIR Samples JLink SettingsFiles Sample
99. does not affect device operation J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 424 CHAPTER 16 Designing the target board for trace 16 3 Signal requirements The table below lists the specifications that apply to the signals as seen at the JTAG Trace connector Signal Value Fmax 200MHz Ts setup time min 2 0ns Th hold time min 1 0ns TRACECLK high pulse width min 1 5ns TRACECLK high pulse width min 1 5ns Table 16 1 Signal requirements J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 425 Chapter 17 Support and FAQs This chapter contains troubleshooting tips as well as solutions for common problems which might occur when using J Link J Trace There are several steps you can take before contacting support Performing these steps can solve many problems and often eliminates the need for assistance This chapter also contains a collection of frequently asked questions FAQs with answers J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 426 CHAPTER 17 Support and FAQs 17 1 Measuring download speed 17 1 1 Test environment JLink exe has been used for measurement performance The hardware consisted of PC with 2 6 GHz Pentium 4 running Win2K USB 2 0 port USB 2 0 hub J Link Target with ARM7 running at 50OMHz Below is a screenshot of JLink exe after the measurement has bee
100. e Modify breakpoints during execution This dropdown box allows the user to change the behavior of the DLL when setting breakpoints if the CPU is running The following options are available Allow Allows settings breakpoints while the CPU is running If the CPU needs to be halted in order to set the breakpoint the DLL halts the CPU sets the break points and restarts the CPU Allow if CPU does not need to be halted Allows setting breakpoints while the CPU is running if it does not need to be halted in order to set the breakpoint If the CPU has to be halted the breakpoint is not set Ask user if CPU needs to be halted If the user tries to set a breakpoint while the CPU is running and the CPU needs to be halted in order to set the breakpoint the user is asked if the breakpoint should be set If the breakpoint can be set without halting the CPU the breakpoint is set without explicit confirmation by the user Do not allow It is not allowed to set breakpoints while the CPU is running J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 194 CHAPTER 5 Working with J Link and J Trace 5 7 1 3 Break Watch In the Break Watch section all breakpoints and watchpoints which are in the DLL internal breakpoint and watchpoint list are shown 13 SEGGER J Link ARM Control panel BE x General Settings Break watch Log CPU Reas Target Power Sw Device Emulator alej Breakpoints Handie Ad
101. each rising edge of each TRACECLK or on each alternate rising or falling edge 14 2 1 Connecting the target board J Trace connects to the target board via a 38 pin trace cable This cable has a recep tacle on the one side and a plug on the other side Alternatively J Trace can be con nected with a 20 pin JTAG cable Warning Never connect trace cable and JTAG cable at the same time because this may harm your J Trace and or your target eiqeo e qe9 2921L 91989 E o o J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 398 14 2 2 Pinout The following table lists the JTAG Trace connector pinout It is compatible to the Trace Port Physical Interface described in ETM 8 2 2 Single target connector CHAPTER 14 Target interfaces and adapters pinout PIN SIGNAL Description 1 NC Not connected 2 INC Not connected 3 NC Not connected 4 NC Not connected 5 GND Signal ground 6 TRACECLK Clocks trace data on rising edge or both edges 7 DBGRQ Debug request Debug acknowledge from the test chip high when in 8 PRGACK bug state i 9 RESET Open collector output from the run control to the target system reset 10 EXTTRIG Optional external trigger signal to the Embedded trace Macrocell ETM Not used Leave open on target system 11 TDO Test data output from target JTA
102. flash download and J Flash 2004 2015 SEGGER Microcontroller GmbH amp Co KG 75 2 4 9 Flasher PPC Flasher PPC is a programming tool for PowerPC based microcon trollers with on chip or external Flash memory Flasher PPC is designed for programming flash targets with the J Flash soft ware or stand alone In addition to that Flasher PPC has all of the J Link functionality Flasher PPC connects via USB or via RS232 interface to a PC running Microsoft Windows 2000 or later Flasher PPC has a built in 20 pin JTAG connector which is compatible with the standard 20 pin connector defined by ARM E E Licenses Flasher Comes with built in licenses for flash download J Flash J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 76 CHAPTER 2 Licensing 2 5 J Link OEM versions There are several different OEM versions of J Link on the market The OEM versions look different but use basically identical hardware Some of these OEM versions are limited in speed some can only be used with certain chips and some of these have certain add on features enabled which normally requires a license In any case it should be possible to use the J Link software with these OEM versions However proper function cannot be guaranteed for OEM versions SEGGER Microcontroller does not support OEM versions support is provided by the respective OEM 2 5 1 Analog Devices mIDASLink mIDASLink is an OEM
103. gd 169 4 7 2 Updating the DLL in third party programs 169 4 7 3 Determining the version of JLink DLL 170 4 7 4 Determining which DLL is used by a 170 4 8 Getting started with J Link and ARM DS 5 0 171 4 8 1 Replacing the RDDI DLL 4 4 2 44 1 1 nns 171 4 8 2 Using J Link 05 5 Development Studio 171 5 Working with J Link and de Traesent de be RERO ERE ceed needs 173 5 1 Connecting the target system eee mene eene nene 174 5 1 1 Power on SEQUENCE eere e nite acdsee x a RE E EK EE ERE EANA eee 174 5 1 2 Verifying target device teeta mene 174 5 1 3 Problem Sa DEDE 174 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 5 2 INGIGACONS ERREUR 175 5 2 1 Main indicator cipia E 175 5 2 2 INPUtNGICATOM wrk ex 177 5 2 3 Output indicator sas rm e raten e o oe e e E e ol 177 5 3 JTAG intefa Cente ren sentence PT 178 5 3 1 Multiple devices in the scan chain ss 178 5 3 2 Sample configuration dialog boxes 178 5 3 3 Determining values for scan chain 181 5 3 4 JTAG Speed earbsa EUER 18
104. hit or when Num Steps is reached a 0 Do not start the CPU if a BP is in range of NumSteps CU 1 Overstep BPs Example go Simply starts the CPU go 20 1 3 2 1 16 halt h Halts the CPU Core If successful shows the current CPU registers Syntax halt 3 2 1 17 hwinfo This command can be used to get information about the power consumption of the target if the target is powered via J Link It also gives the information if an over current happened Syntax hwinfo J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 90 CHAPTER 3 J Link software and documentation package 3 2 1 18 ip Closes any existing connection to J Link and opens a new one via TCP IP If no IP Address is specified the Emulator selection dialog shows up Syntax ip lt Addr gt Parameter Meaning Valid values ada IP Address Connects the J Link with the specified IP Address Host Name Resolves the host name and connects to it Invokes the Emulator selection dialog Example ip 192 168 6 3 3 2 1 19 is This command returns information about the length of the scan chain select register Syntax 3 2 1 20 loadfile This command programs a given data file to a specified destination address Currently supported data files are mot srec s19 hex bin Syntax loadfile lt Filename gt lt Addr gt Parameter Meaning Filename Source filename Addr
105. in command line mode but is also integrated in many IDEs like emIDE or Eclipse J Link GDB Server is a remote server for GDB making it possible for GDB to connect to and communicate with the target device via J Link GDB Server and GDB commu nicate via a TCP IP connection using the standard GDB remote protocol GDB Server receives the GDB commands does the J Link communication and replies with the answer to GDB With J Link GDB Server debugging in ROM and Flash of the target device is possible and the Unlimited Flash Breakpoints can be used It also comes with some functionality not directly implemented in the GDB These can be accessed via monitor commands sent directly via GDB too SEGGER J Link GDB Server V4 74 eJ File Help Localhost only GDB Connected to 127 0 0 1 initial SWD speed 4000kHz 7 Stay ontop Show log window J Link Connected i Current SWD speed 4000 kHz Generate logfile Cache reads CPU STM32F41 715 Executing 330v B Little endian mo Init regs on start Log output Clear loa J Link is connected Firmware J Link Pro V4 compiled Jul 16 2013 21 45 59 Feature s RDI FlashBP FlashDL JFlash GDB a Checking target voltage Listening on TCP IP port 2331 Connecting to target Connected to target Waiting for GDB connection Connected to 127 0 0 1 n Read 4 bytes address 0 00000000 Data 0x20001850 Starting target CPU 4 4
106. is different from the one for internal flash Initialization of the external memory interface the CFI flash is con nected to is user s responsibility and is expected by the J Link software to be done prior to performing accesses to the specified CFI area In this section the setup for different debuggers is explained 6 5 1 IAR Embedded Workbench Keil Using the J Link flash download feature with IAR Embedded Workbench Keil MDK is quite simple First start the debug session and open the J Link Control Panel In the tab Settings you will find the location of the settings file 13 SEGGER J Link 4 15r beta Control panel Close the debug session and open the settings file with a text editor Add the follow ing lines to the file CFI CFISize lt FlashSize gt CFIAddr lt FlashAddr gt GENERAL WorkRAMSize lt RAMSize gt WorkRAMAddr lt RAMAddr gt After this the file should look similar to the sample in the following screenshot FE Default ini Notepad E BREAKPOINTS Showrnfowin skipProgoncrcmatch 1 verifyDownload 1 ATTowCaching 1 EnableFlashDL 2 override Device ADUC7020x62 0 4000 0x200000 Save the settings file and restart the debug session J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 252 CHAPTER 6 Flash download 6 5 2 J Link GDB Server 6 5 3 The configuration for the J L
107. is started correctly 2 Make sure the entered serial number is correct 3 Make sure port 19020 is not blocked by any firewall Contact network admin Table 3 13 To test whether a connection to the tunnel server can be established or not a network protocol analyzer like Wireshark can help The network transfer of a successful connection should look like 192 168 11 31 88 84 155 118 TCP 192 168 11 31 88 84 155 118 TCP 192 168 11 31 88 84 155 118 TCP 88 84 155 118 192 168 11 31 TCP 88 84 155 118 192 168 11 31 TCP 88 84 155 118 192 168 11 31 TCP 192 168 11 31 88 84 155 118 TCP 192 168 11 31 88 84 155 118 TCP 88 84 155 118 192 168 11 31 TCP J Link J Trace UM08001 51439 gt j link 51439 gt j link 51439 gt j link j link gt 51439 j link 51439 j link gt 51439 51439 gt j link 51439 gt j link j link gt 51439 Seg 1 Ack 1 ACK Seq 1 A ACK Seq 5 A Seq 1 Ack 5 Seq 1 Ack 9 ACK Seq 1 ACK Seq 9 A ACK Seq 13 Seq 5 Ack 80 2004 2015 SEGGER Microcontroller GmbH amp Co KG 139 3 5 Memory Viewer J Mem displays memory contents of target systems and allows modifications of RAM and SFRs Special Function Registers while the target is running This makes it pos sible to look into the memory of a target system at run time RAM can be modified and SFRs can be written You can choose between 8 16 32 bit size for read and write accesses J Mem works nicely when modifying
108. is too low if no target is connected to J Link J Trace and the speed selection The screenshot below shows an example a C Program FilessSEGGER JLinkARM_ 386 JLink exe SEGGER J Link Commander 1 C for help Compiled Jun 27 2608 19 DLL version U3 86 compiled Jun 27 2008 19 42 28 i are J Link ARM U6 compiled Jun 27 2008 18 35 51 06 00 t 0 0000 JTAG speed 5 kHz J Link gt In addition you can verify the driver installation by consulting the Windows device manager If the driver is installed and your J Link J Trace is connected to your com puter the device manager should list the J Link USB driver as a node below Univer sal Serial Bus controllers as shown in the following screenshot De e Manage JOf x ain Yew e Sm 9 9 VMBASIC Batteries Computer Disk drives Display adapters 23 DVD CD ROM drives 52 Floppy disk controllers amp 9 Floppy disk drives amp IDE ATA ATAPI controllers E Keyboards A Mice and other pointing devices EF Network adapters 7 Ports COM amp LPT qr Sound video and game controllers System devices Universal Serial Bus controllers Intel 823714B EB PCI to USB Universal Host Controller J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp C
109. no reset just changing the CPU registers such as PC and CPSR This reset strategy sets the CPU registers to their after Reset values PC 0 0xD3 Supervisor mode ARM IRQ FIQ disabled All SPSR registers 0x10 All other registers which are unpredictable after reset are set to O The hardware RESET pin is not affected 5 8 1 8 Type 7 Reserved Reserved reset type 5 8 1 9 Type 8 Software for ATMEL AT91SAM7 MCUs The reset pin of the device is disabled by default This means that the reset strate gies which rely on the reset pin low pulse on reset do not work by default For this reason a special reset strategy has been made available It is recommended to use this reset strategy This special reset strategy resets the peripherals by writing to the RSTC CR register Resetting the peripherals puts all peripherals in the defined reset state This includes memory mapping register which means that after reset flash is mapped to address O It is also possible to achieve the same effect by writing 0x4 to the RSTC CR register located at address OxfffffdOO 5 8 1 10 Type 9 Hardware for NXP LPC MCUs After reset a bootloader is mapped at address 0 on ARM 7 LPC devices This reset strategy performs a reset via reset strategy Type 1 in order to reset the CPU It also ensures that flash is mapped to address 0 by writing the MEMMAP register of the LPC This reset strategy is the recommended one for all ARM 7 LPC devices
110. not require special settings All that is required is proper setup of the scan chain for each debugger This enables J Link J Trace to debug more than one core on a target at the same time The following figure shows a host debugging two CPU cores with two instances of the same debugger Both debuggers share the same physical connection The core to debug is selected through the JTAG settings as described below J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 186 CHAPTER 5 Working with J Link and J Trace 5 5 2 Using multi core debugging in detail 4 5 Connect your target to J Link J Trace Start your debugger for example IAR Embedded Workbench for ARM Choose Project Options and configure your scan chain The picture below shows the configuration for the first CPU core on your target Options for node BTL_AT91_ 430 Category Factory Settings General Options C C Compiler Setup Connection Assembler m Communication Custom Build Build Actions USB Linker aaa bbb ccc ddd Debugger Simulator JTAG scan chain Angel JTAG scan chain with multiple targets TAP number o Scan chain contains non amp RM devices IAR ROM monitor Macraigor RDI T Third Party Driver Freceeding bits 7 Log communication TOOLKIT DIR cspycomm log Start debugging the first core Start another debugger f
111. of gt 50 KB s can be achieved J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 299 10 10 Background information This chapter provides some background information about specific parts of the J Flash SPI software 10 10 1 SPI interface connection For direct SPI flash programming J Link needs to be wired to the SPI flash in a spe cific way For more information about the pinout for the J Link SPI target interface please refer to UMO8001 J Link J Trace User Guide The minimum pins that need to be connected are VTref GND SPI CLK MOSI MISO If other components on the target hardware need to be kept in reset while programming the SPI flash e g a CPU etc nRESET also needs to be connected J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 300 CHAPTER 10 J Flash SPI 10 11 Support The following chapter provides advises on troubleshooting for possible typical problems and information about how to contact our support 10 11 1 Troubleshooting 10 11 1 1Typical problems Target system has no power Meaning J Link could not measure the target flash reference voltage on pin 1 of its connec tor Remedy The target interface of J Link works with level shifters to be as flexible as possible Therefore the reference I O voltage the flash is working with also needs to be con nected to pin 1 of the J Link connector Programming Erasing failed Mean
112. of supported cores see section Supported CPU cores on page 60 Converting data files I want to download my application into flash memory using J Link Commander but my application is a hex data file and J Link Commander supports bin files only How do I download it Please use the J Flash which is part of the J Link software and documentation package software to convert your hex mot file to a bin file For data file conversion no J Flash license is necessary Using J Link in my application I want to write my own application and use J Link J Trace Is this possible Yes We offer a dedicated Software Developer Kit SDK See section J Link Soft ware Developer Kit SDK on page 154 for further information Using DCC with J Link Can I use J Link J Trace to communicate with a running target via DCC Yes The DLL includes functions to communicate via DCC on cores which support DCC such as ARM7 9 11 Cortex A R series Read status of JTAG pins Can J Link J Trace read back the status of the JTAG pins Yes the status of all pins can be read This includes the outputs of J Link J Trace as well as the supply voltage which can be useful to detect hardware problems on the target system J Link support of ETM Does J Link support the Embedded Trace Macrocell ETM No ETM requires another connection to the ARM chip and a CPU with built in ETM Most current ARM7 ARM9 chips do not have ETM built in J Link sup
113. option byte O will read protect the STM32 In order to keep the device unprotected you have to write the key value OxA5 into option byte 0 Note originally located at address OxiFFFF800 Ox1FFFF800 is done automatically by J Flash Example The address 0x06000000 is a virtual address only The option bytes are remap from 0 06000000 to To program the option bytes 2 and 3 with the values OxAA and OxBB but leave the device unprotected your option byte sector at addr 0x06000000 should look like as follows Address 31 24 23 16 15 8 7 0 0x06000000 0x00 OxFF Ox5A OxA5 0x06000004 0x44 OxBB 0x55 OxAA 0x06000008 0x00 OxFF 0x00 OxFF 0x0600000C 0x00 OxFF 0x00 OxFF Table 13 2 Option bytes programming example For a detailed description of each option byte please refer to ST programming man ual PM0042 section Option byte description 13 16 2 3Securing unsecuring the device The user area internal flash of the STM32 devices can be protected secured against read by untrusted code The J Flash software allows securing a STM32F10x device For more information about J Flash please refer to UM08003 J Flash User Guide In order to unsecure a read protected STM32F10x device SEGGER offers two software components e J Flash e J Link STM32 Commander command line utility For more information about J Flash please refer to UM08003 J Flash User Guide For more information
114. required You should make sure that the emulator you are looking at supports your target CPU For more information about which J Link features are supported by each emulator please refer to Model comparison on page 29 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 1 2 J Link J Trace can be used on the following operating systems J Link J Trace UM08001 Supported OS Microsoft Windows 2000 Microsoft Windows XP Microsoft Windows XP x64 Microsoft Windows Vista Microsoft Windows Vista x64 Windows 7 Windows 7 x64 Windows 8 Windows 8 x64 Windows 10 Linux Mac OSX 10 5 and higher 27 2004 2015 SEGGER Microcontroller GmbH amp Co KG 28 CHAPTER 1 Introduction 1 3 J Link J Trace models J Link J Trace is available in different variations each designed for different pur poses target devices Currently the following models of J Link J Trace are avail able J Link BASE J Link PLUS J Link PRO J Link ULTRA J Trace ARM J Trace for Cortex M In the following the different J Link J Trace models are described and the changes between the different hardware versions of each model are listed To determine the hardware version of your J Link J Trace the first step should be to look at the label at the bottom side of the unit J Links J Traces have the hardware version printed on the back label If this is not the case with your J Link J Trace start JLink e
115. set tings can be configured When a license for J Link FlashDL is found the color indi cator is green and License found appears right to the J Link FlashDL usage settings E Flash download Auto License found C On Skip download on CRC match C Off Verify download Enabled 10272 bytes downloaded e Auto This is the default setting of J Link FlashDL usage If a license is found J Link FlashDL is enabled Otherwise J Link FlashDL will be disabled inter nally e On Enables the J Link FlashDL feature If no license has been found an error message appears e Off Disables the J Link FlashDL feature e Skip download on CRC match J Link checks the CRC of the flash content to determine if the current application has already been downloaded to the flash If a CRC match occurs the flash download is not necessary and skipped Only available if J Link FlashDL usage is configured as Auto or On e Verify download If this checkbox is enabled J Link verifies the flash content after the download Only available if J Link FlashDL usage is configured as Auto or On Section Flash breakpoints In this section settings for the use of the FlashBP feature and related settings can be configured When a license for FlashBP is found the color indicator is green and License found appears right to the FlashBP usage settings E Flash breakpoints Auto License found C On 7 Show info window dur
116. specification of a set of procedures functions data structures and constants that are used to interface two or more software components together Big endian Memory organization where the least significant byte of a word is at a higher address than the most significant byte See Little endian Cache cleaning The process of writing dirty data in a cache to main memory Coprocessor An additional processor that is used for certain operations for example for floating point math calculations signal processing or memory management Dirty data When referring to a processor data cache data that has been written to the cache but has not been written to main memory is referred to as dirty data Only write back caches can have dirty data because a write through cache writes data to the cache and to main memory simultaneously See also cache cleaning Dynamic Linked Library DLL A collection of programs any of which can be called when needed by an executing program A small program that helps a larger program communicate with a device such as a printer or keyboard is often packaged as a DLL Embedded Trace Macrocell ETM ETM is additional hardware provided by debuggable ARM processors to aid debugging with trace functionality Embedded Trace Buffer ETB ETB is a small circular on chip memory area where trace information is stored during capture EmbeddedICE The additional hardware provided by debuggable ARM processors to a
117. taken for output to a minimum and allows printing debug information to the host computer while the application is performing time critical real time tasks The implementation code also includes a simple version of printf which can be used to write formatted strings via RTT It is smaller than most standard library printf implementations and does not require heap and only a configureable ammount of stack The SEGGER RTT implementation is fully configureable at compile time with pre pro cessor defines The number of channels the size of the default channels can be set Reading and writing can be made task safe with definable Lock and Unlock rou tines 12 4 1 functions The following API functions are available the RTT Implementation To use them SEGGER_RTT h has to be included in the calling sources 12 4 1 1 SEGGER_RTT_ConfigDownBuffer Description Configure or add a down buffer by specifying its name size and flags Prototype int SEGGER_RTT_ConfigDownBuffer unsigned BufferIndex const char sName char pBuffer int BufferSize int Flags Parameters Parameter Meaning Tee Index of the buffer to configure Must be lower than Burrertncex SEGGER_RTT_MAX_NUM_DOWN_CHANNELS Pointer to a O terminated string to be displayed as the name of the sName channel pBuffer Pointer to a buffer used by the channel BufferSize Size of the buffer in Bytes Flags Flag
118. the buffers are the areas that contain valid data For Up buffers the Write Pointer is written by the target the Read Pointer is written by the debug probe J Link Host J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 336 CHAPTER 12 RTT When Read and Write Pointers point to the same element the buffer is empty This assures there is never a race condition The image shows the simplified structure in the target SEGGER RTT Control Block Buffers 12 2 4 Requirements SEGGER RTT does not need any additional pin or hardware despite a J Link con nected via the standard debug port to the target It does not require any configura tion of the target or in the debugging environment and can even be used with varying target speeds RTT can be used in parallel to a running debug session without intrusion as well as without any IDE or debugger at all J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 12 2 5 Performance The performance of SEGGER RTT is significantly higher than any other technology used to output data to a host PC An average line of text can be output in one micro second or less Basically only the time to do a single memcopy Time to output 82 characters RTT li SWO 120 Semihosting af T us 0 22 40 60 80 100 120 140 10000 12000 12 2 6 Memory footprint The RTT implementation code uses 500 Bytes of ROM and 24 Bytes ID 24 Byt
119. the memory content of a run ning target and allows editing as well J Flash Stand alone flash programming application For more informa tion about J Flash please refer to J Flash ARM User s Guide 0 08003 J Link SWO Viewer Free of charge utility for J Link Displays the terminal output of the target using the SWO pin Can be used in parallel with a debugger or stand alone J Scope J Scope is a free of charge software to analyze and visualize data on a microcontroller in real time while the target is run ning J Link SWO Ana lyzer Command line tool that analyzes SWO RAW output and stores it into a file JTAGLoad Command line tool that opens an sv file and sends the data it via J Link J Trace to the target J Link Configurator GUI based configuration tool for J Link Allows configuration of USB identification as well as TCP IP identification of J Link For more information about the J Link Configurator please refer to J Link Configurator on page 165 RDI support Provides Remote Debug Interface RDI support This allows the user to use J Link with any RDI compliant debugger Processor specific tools Free command line tools for handling specific processors Included are STR9 Commander and STM32 Unlock Table 3 1 J Link J Trace related software a Full featured J Link PLUS PRO ULTRA or an additional license for J Link base model required J Link
120. time Trai Max 20ns Data output rise time Trao Max 10ns Data output fall time Max 10ns Clock rise time Max 10ns Clock fall time Tgc Max 10ns Table 1 8 J Link Lite specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 1 3 7 J Link Lite CortexM J Link Lite CortexM is a specific OEM version of SEGGER J Link Lite which is designed to be used with Cortex M devices If you are selling evaluation boards J Link Lite CortexM is an inex 51 pensive emulator solution for you Your customer receives a widely acknowledged JTAG SWD emulator which allows to start right away with development Very small form factor JTAG clock up to 4 MHz SWD SWO supported 3 3V target interface voltage 1 3 7 1 Specifications Fully software compatible to J Link Any Cortex M0 M0 M1i M3 M4 core supported Flash download into supported MCUs Standard 9 or 19 pin 0 05 Samtec FTSH connector The following table gives an overview about the specifications general mechanical electrical for J Link Lite Cortex M General Supported OS For a complete list of all operating sys tems which are supported please refer to Supported OS on page 27 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 209C 65 C Relative humidity non condensing Max 90 rH Size with
121. use cases 12 3 3 RTT Logger With J Link RTT Logger data from Up Channel 1 can be read and logged to a file This channel can for example be used to send performance analysis data to the host J Link RTT Logger opens a dedicated connection to J Link and can be used stand alone without running a debugger The application is part of the J Link Software and Documentation Pack for Windows Linux and OS X The source of J Link RTT Logger can be used as a starting point to integrate RTT in other PC applications like debuggers and is part of the J Link SDK 12 3 4 RTT in other host applications RTT can also be integrated in any other PC application like a debugger or a data visu alizer in either of two ways 1 The application can establish a socket connection to the RTT Telnet Server which is opened on localhost 19021 when a J Link connection is active 2 The application creates its own connection to J Link and uses the J Link RTT API which is part of the J Link SDK to directly configure and use RTT J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 344 CHAPTER 12 RTT 12 4 Implementation The SEGGER RTT implementation code is written in ANSI C and can be integrated into any embedded application by simply adding the available sources RTT can be used via a simple and easy to use API It is even possible to override the standard printf functions to be used with RTT Using RTT reduces the time
122. used to configure control J Flash SPI CL are exactly the same as for the command line interface of the J Flash SPI GUI version For further informa tion please refer to Command Line Interface on page 289 10 1 3 Features e Directly communicates with the SPI flash via SPI protocol no MCU in between needed e Programming of all kinds of SPI flashes is supported e Can also program SPI flashes that are connected to CPUs that are not supported by J Link e Verbose logging of all communication e hex mot srec and bin support e Intuitive user interface 10 1 4 Requirements 10 1 4 1 Host J Flash SPI requires a PC running Microsoft Windows 2000 or Windows XP with a free USB port dedicated to a J Link A network connection is required only if you want to use J Flash SPI together with J Link Remote Server 10 1 4 2 Target The flash device must be an SPI flash that supports standard SPI protocols J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 279 10 2 Licensing The following chapter provides an overview of J Flash SPI related licensing options 10 2 1 Introduction A J Link PLUS ULTRA PRO or Flasher ARM PRO is required to use J Flash SPI No additional license is required available J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 280 CHAPTER 10 J Flash SPI 10 3 Getting Started This chapter presents an introduction to J Flash SPI It
123. v OxFF FlexNVM partition code already configured return 74 Configure EEPROM size and data flash size via the program partition command FCCOBO 0x80 Program partition FCCOB4 Ox3F EEPROM data size code 0 KB EEPROM FCCOB5 0x00 FlexNVM partition code 256 KB data flash FSTAT 0x80 Start command execution while FSTAT amp 0x80 0 Wait until flash controller has finished J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 368 13 7 Fujitsu J Link has been tested with the following Fujitsu devices Currently there are no specifics for these devices MB9AF102N MB9AF102R MB9AF104N MB9AF104R MB9BF104N MB9BF104R MB9BF105N MB9BF105R MB9BF106N MB9BF106R MB9BF304N MB9BF304R MB9BF305N MB9BF305R MB9BF306N MB9BF306R MB9BF404N MB9BF404R MB9BF405N MB9BF405R MB9BF406N MB9BF406R MB9BF504N MB9BF504R MB9BF505N MB9BF505R MB9BF506N MB9BF506R J Link J Trace UM08001 CHAPTER 13 Device specifics 2004 2015 SEGGER Microcontroller GmbH amp Co KG 369 13 8 Itron J Link has been tested with the following Itron devices e TRIFECTA Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 370 13 9 Infineon CHAPTER 13 Device specifics J Link has been tested with the following Infineon devices UMF1110 UMF1120 UMF5110 UMF5
124. with EWARM only Debug Flash Flash Trace IDE 4 3 support download breakpoints support IAR EWARM yes no no no Rowley yes no no no Yargato GDB yes no no no Requires J Link RDI license for download of more than 32KBytes Coming soon Requires emulator with trace support Debug support includes the following Download to RAM memory read write CPU register read write Run control go step halt software breakpoints in RAM and hardware breakpoints in flash memory U N J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 66 CHAPTER 1 Introduction J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 67 Chapter 2 Licensing This chapter describes the different license types of J Link related software and the legal use of the J Link software with original SEGGER and OEM products J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 68 CHAPTER 2 Licensing 2 1 Components requiring a license The following programs features require a full featured J Link PLUS ULTRA PRO J Trace or an additional license for the J Link base model J Flash J Link RDI J Link Debugger Flash breakpoints FlashBP J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 69 2 2 License types For each of the software components which require an additional license there are dif
125. with J Link GDB Server 103 3 3 3 Supported remote monitor 1 6 108 3 3 4 SEGGER specific GDB protocol extensions nennen 120 3 3 5 Command line options 66 nnne nnns 123 3 3 6 Programi termination eina peux diee Gide 134 3 4 J LINK Remote Server uus e Eee xe Rv xe redde a E x ur eds 135 3 4 1 List of available commands ss 135 3 4 2 TUNNELING en cae ne cada PARERE fave 136 3 5 J Mem Memory Viewer I Nera ueri ERU Tae epu aa 139 3 6 140 3 7 J Link SWO VIeWGF iere tous ee 141 3 7 1 Lodge coke e ent ter RID E ER DERE NR ERE 142 3 7 2 List of available command line options 1 0 42 1 1 1 142 3 7 3 Configure SWO output after device 144 3 7 4 Target example code for terminal output 144 3 8 SWO AnalyZ6et ass eger dr rne ERR entame a A de tee E RA ne en ER 147 3 9 JTAGLoad Command line tool 148 3 10 J Link RDI Remote Debug Interface 149 3 10 1 Flash download and flash breakpoints 6 149 3 11 Processor spec
126. 0 4 Settings The following chapter provides an overview of the program settings Both general and per project settings are considered 10 4 1 Project Settings Project settings are available from the Options menu in the main window or by using the ALT F7 keyboard shortcut 10 4 1 1 General Settings This dialog is used to choose the connection to J Link The J Link can either be connected over USB or via TCP IP to the host system Refer to the J Link manual for more information regarding the operation of J Link and J Link TCP IP Server Project settings General interface Flash J Flash SPI is a software for J Link This software is capable of programming SPI flash memories Connection to J Link USB Device 0 USB SN 0 mre p 10 4 1 1 1 USB If this option is checked J Flash SPI will connect to J Link over the USB port You may change the device number if you want to connect more than one J Link to your PC The default device number is 0 For more information about how to use multiple J Links on one PC please see also the chapter Working with J Link of the J Link User s Guide 10 4 1 1 2 TCP IP If this option is selected J Flash SPI will connect to J Link via J Link TCP IP Server You have to specify the hostname of the remote system running the J Link TCP IP Server J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 286 CHAPTER 10 J Flash SPI 10
127. 0 7 1 SPI flashes with multiple erase commands Some SPI flashes support multiple erase commands that allow to erase different units on the flash For example some flashes provide a sector erase erase 4 KB units and a block erase erase 16 KB or 64 KB units command In general it is up to the user which command to use as the EraseSector command can be overridden by the user When manually changing the SectorErase command in the Options gt Project settings gt Flash tab make sure that the SectorSize parameter matches the command being used J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 297 10 8 Target systems 10 8 1 Which flash devices can be programmed In general all kinds of SPI flash can be programmed Since all flash parameters are configurable also flashes with non standard command sets can be programmed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 298 CHAPTER 10 J Flash SPI 10 9 Performance The following chapter lists programming performance for various SPI flash devices 10 9 1 Performance values In direct programming mode J Link directly connects to the pins of the SPI flash the programming speed is mainly limited by the SPI communication speed the USB speed of J Link if a Full Speed or Hi Speed based J Link is used and the maximum programming speed of the flash itself For most SPI flash devices in direct programming mode speeds
128. 00 0xA5000004 0x00008000 0x00000601 0x00191C05 0x00000007 0x00320300 13 2 2 915 9 13 2 2 1 JTAG settings We recommend using adaptive clocking 361 Set JTAG speed to 30 kHz Perform peripheral reset Disable watchdog Set PLL Set PLL and divider Select master clock and processor clock Set flash wait states This information is applicable to the following devices AT91RM9200 AT91SAM9260 AT91SAM9261 AT91SAM9262 AT91SAM9263 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 362 CHAPTER 13 Device specifics 13 3 DSPGroup J Link has been tested with the following DSPGroup devices e DA56KLF Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 363 13 4 Ember For more information please refer to Silicon Labs on page 379 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 364 CHAPTER 13 Device specifics 13 5 Energy Micro For more information please refer to Silicon Labs on page 379 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 13 6 Freescale J Link has been tested with the following Freescale devices 13 6 1 Kinetis family 13 6 1 1 Unlocking MAC7101 MAC7106 MAC7111 MAC7112 MAC7116 MAC7121 MAC7122 MAC7126 MAC7131 MAC7136 MAC7141 MAC7142 M
129. 0000 3 Perform Auto operation in J Flash by default this performs erase program verify 4 Close J Flash SPI The return value will be checked and in case of an error message will be displayed Adapt the example according to the requirements of your project ECHO OFF ECHO Open a project and data file start auto processing and exit JFlashSPI exe openprjC Projects Default jflash openC Data data bin 0x100000 auto exit IF ERRORLEVEL 1 goto ERROR goto END ERROR ECHO J Flash SPI Error pause END Starting J Flash minimized Adapt this example call to start J Flash SPI minimized start min wait J Flash JFlashSPI exe openprjC Projects Default jflash auto exit Note that every call of JFlashSPI exe has to be completed with the exit option otherwise the execution of the batch file stops and the following commands will not be processed 10 5 4 Programming multiple targets in parallel In order to program multiple targets in parallel using J Flash SPI the following is needed e Multiple J Flash SPI projects each configured to connect to a specific J Link Flasher emulator to connect to is selected by serial number The easiest way is to setup the appropriate project once and then make multiple cop ies of this project Now modify the Connection to J Link setting in each project in order to let J Flash SPI connect to the different programmers as shown in the screen shot b
130. 0000 R11 200000000 R12 200000000 SPSR 00000010 SPSR 00000010 SPSR 00000010 SPSR 00000010 SPSR 00000010 Resets and halts the target CPU Make sure the device is selected prior to using this command to make use of the correct reset strategy Add information There are different reset strategies for different CPUs Moreover the reset strategies which are available differ from CPU core to CPU core J Link can perform various reset strategies and always selects the best fitting strategy for the selected device Example gt monitor reset Resetting target 3 3 3 18 semihosting breakOnError Syntax semihosting breakOnerror Value J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 115 Description Enables or disables halting the target at the semihosting breakpoint in SVC handler if an error occurred during a semihosting command for example a bad file handle for SYS_WRITE The GDB Server log window always shows a warning in these cases breakOnError is disabled by default Example Enable breakOnError gt monitor semihosting breakOnError 1 3 3 3 19 semihosting enable Syntax semihosting enable lt VectorAddr gt Description Enables semihosting with the specified vector address If no vector address is speci fied the SWI vector at address 0x8 will be used GDBServer will output semihost ing terminal data from the target via a separate connection on port 2333 Some IDE
131. 000000 0x40003fff Additional information e StartAddressOfArea has to be a 256 byte aligned address The region size has to be a multiple of 256 bytes 5 12 1 31map region This command is used to specify memory areas with various region types Syntax map region StartAddressOfArea EndAddressOfArea lt RegionType gt Region type Description N Normal C Cacheable X Excluded XI Excluded amp Illegal I Indirect access Alias static e g RAM flash that is aliased multiple times in A one area Does not change during the debug session AD Alias dynamic e g memory areas where different memo ries can be mapped to Example map region 0x100000 Ox1FFFFF C 5 12 1 32map reset This command restores the default memory mapping which means all memory accesses are permitted Typical applications Used with other map commands to return to the default values The map reset command should be called before any other map command is called Syntax map reset Example map reset 5 12 1 33ProjectFile This command is used to specify a file used by the J Link DLL to save the current configuration Using this command is recommended if settings need to be saved This is typically the case if Flash breakpoints are enabled and used It is recommended that an IDE uses this command to allow the JLinkARM dll to store its settings in the same direc tory as the project and
132. 00000040 EAFFFFFE EAFFFFFE EAFFFFFE iIennnnnnsn wannnnnn _ weaornenn No Pos J Link ARM_1 Start STR7Ixax 7 For Help press F1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 309 11 3 3 ARM RVDS RealView developer suite 11 3 3 1 Software version J Link RDI has been tested with ARM RVDS version 2 1 and 3 0 There should be no problems with earlier versions of RVDS up to version v3 0 1 All screenshots are taken from ARM s RVDS version 2 1 Note RVDS version 3 1 does not longer support RDI protocol to communicate with the debugger 11 3 3 2 Configuring to use J Link RDI 1 Start the Real View debugger Z RYDEBUG lt Start_STR71x gt Not connected no PC or scope Click to Connect to a Target No Register Context J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 310 CHAPTER 11 RDI 2 Select File Connection Connect to Target 2 RVDEBUG Start STR71x _ lt No Register Context 3 Inthe Connection Control dialog use the right mouse click on the first item and select Add Remove Edit Devices Connection Control SouhailXredebug brd erface parallel port Remote nn serial port Server localhos E epit nect 41 ARMOAK Mess Jonnect ARM 0ak is ARM Vehicle SRMOT WIGGLER Macraigor Wiggler E
133. 01 4922 680b 4298 d3fa b004 beos 4718 PUSH SUB BL MOV ADD LR SP SP 16 Oxffffffa change speed 0x20022c RO waiting time 0 OxO wait Oxe 0 20028 RO waiting time 1 Ri PC 136 sLedSpeed 0x200314 R3 R1 0 RO waiting time R3 Oxfffffff4 wait O0xc 0x200288 SP 16 Finished executing setup script Downloading program text and data Please Wait Download complete running C Work Basic ghs J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 317 11 3 5 KEIL uVision IDE 11 3 5 1 Software version J Link has been tested with KEIL MDK 3 34 There should be no problems with other versions of KEIL uVision All screenshots are taken from MDK 3 34 11 3 5 2 Configuring to use J Link RDI Start KEIL uVision and open the project MZ Blinky pVision3 C XKeil3030XARMXRV30XBoardsXK eil MCB 2300 Blinky Abstract txt es Hi LPC2378 Flash The Blinky project is a simple program for the LPC2378 using Keil MCB2300 Evaluation Board and demonstrating interrupt functionality Example functionality 29 Documentation Clock Settings XTAL PLL processor clock USB clock peripheral clock UART1 settings baudrate 9600 8 data bits 1 stop bits no parity TimerO timer is activating clock is every 1 second starting AD conversion every 1 ms and displa
134. 0617 AG Several corrections 86 100504 AG Chapter Introduction Section J Link J Trace models updated Chapter Target interfaces and adapters Section Adapters updated 85 100428 AG Chapter Introduction Section J Link J Trace models updated 84 100324 KN Chapter Working with J Link and J Trace Several corrections Chapter Flash download amp flash breakpoints Section Supported devices updated 83 100223 KN Chapter Introduction Section J Link J Trace models updated 82 100215 AG Chapter Working with J Link Section J Link script files added 81 100202 KN Chapter Device Specifics Section Luminary Micro updated Chapter Flash download and flash breakpoints Section Supported devices updated 80 100104 KN Chapter Flash download and flash breakpoints Section Supported devices updated 79 091201 AG Chapter Working with J Link and J Trace Section Reset strategies updated Chapter Licensing Section J Link OEM versions updated J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 78 091023 AG Chapter Licensing Section J Link OEM versions updated 77 090910 AG Chapter Introduction Section J Link J Trace models updated 76 0908
135. 1 2615 18 10 40 Waiting for new firmware to boot New firmware booted successfully J Link gt In the screenshot the red box contains information about the formerly used J Link J Trace firmware version Use an application for example JLink exe which uses the desired version of JLinkARM dll This automatically replaces the invalidated firmware with its embedded firmware J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG J Link J Trace UM08001 El C Program Files x86 SEGGERULink V498elLink exe SEGGER J Link Commander U4 98e for help Compiled May 5 2015 11 01 31 J Link 09 compiled Apr 21 2015 18 10 40 ink U9 compiled APR 21 2615 18 16 46 for new Firmware to boot booted AC ion U4 98e compil le 5 2015 11 08 52 J Link 09 compiled Apr 21 2015 18 10 40 RDI FlashBP FlashDL JFlash In the screenshot e Updating firmware identifies the new firmware Replacing firmware identifies the old firmware which has been replaced 419 2004 2015 SEGGER Microcontroller GmbH amp Co KG 420 CHAPTER 15 Background information J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 421 Chapter 16 Designing the target board for trace This chapter describes the hardware requirements which have to be met by the tar get board J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 422 C
136. 1 3 Data flash support Some devices of the Kinetis family have an additional area called FlexNVM which can be configured as data flash The size of the FlexNVM to be used as data flash is con figurable and needs to be configured first before this area can be used as data flash The sample below shows how to configure the FlexNVM area to be used as data flash out of the target application For J Flash there are also projects that are preconfigured to setup the data flash size of Kinetis device The projects can be found at SJLINK INST DIR Sam ples JFlash ProjectFiles One of these sample projects is the MKA40DX256xxx10 ConfigureDataFlash jflash For more information about how configuration of the data flash works please refer to the appropriate user manual of the device Configure FlexNVM area as data flash The follwing sample configures the data flash size of Kinetis device It is created for a MK40DX256xxx10 device The sequence is almost the same for all Kinetis devices only the lines which configure size of the data flash may be modified In this sample the data flash is set to max size EEPROM size is set to 0 bytes define FSTAT volatile unsigned char 0x40020000 0x00 define FCCOBO volatile unsigned char 0x40020000 0x07 define FCCOB1 volatile unsigned char 0x40020000 0x06 define FCCOB2 volatile unsigned char 0x40020000 0x05 define FCCOB3 volat
137. 1 5 2 1 Changing the semihosting SWI numbers It is strongly recommended that you do not change the semihosting SWI numbers 0x123456 ARM or OxAB Thumb If you do so you must e change all the code in your system including library code to use the new SWI number e reconfigure your debugger to use the new SWI number 11 5 3 Implementation of semihosting in J Link RDI When using J Link RDI in default configuration semihosting is implemented as fol lows e A breakpoint vector catch is set on the SWI vector e When this breakpoint is hit J Link RDI examines the SWI number e If the SWI is recognized as a semihosting SWI J Link RDI emulates it and trans parently restarts execution of the application e Ifthe SWI is not recognized as a semihosting SWI J Link RDI halts the processor and reports an error See Unexpected unhandled SWIs on page 331 11 5 3 1 DCC semihosting J Link RDI does not support using the debug communications channel for semihost ing 11 5 4 Semihosting with AXD This semihosting mechanism can be disabled or changed by the following debugger internal variables semihosting enabled Set this variable to 0 to disable semihosting If you are debugging an application run ning from ROM this allows you to use an additional watchpoint unit Set this variable to 1 to enable semihosting This is the default Set this variable to 2 to enable Debug Communications Channel DCC semihosting The S bit in v
138. 120 XMC1100 TO16F00xx XMC1100 TO38F00xx XMC1100 TO38FOxxx 1201 028 XMC1201 TO38FOxxx 1202 016 00 1202 028 00 1202 038 00 1203 016 0 XMC1301 TO16F00xx XMC1302 T038X0xxx XMC4100 128 XMC4104 128 XMC4104 64 XMC4200 256 XMC4400 256 XMC4400 512 XMC4402 256 XMC4500 1024 XMC4500 768 XMC4502 XMC4504 Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 371 13 10 Luminary Micro J Link has been tested with the following Luminary Micro devices LM3S101 LM3S102 LM3S301 LM3S310 LM3S315 LM3S316 LM3S317 LM3S328 LM3S601 LM3S610 LM3S611 LM3S612 LM3S613 LM3S615 LM3S617 LM3S618 LM3S628 LM3S801 LM3S811 LM3S812 LM3S815 LM3S817 LM3S818 LM3S828 LM3S2110 LM3S2139 LM3S2410 LM3S2412 LM3S2432 LM3S2533 LM3S2620 LM3S2637 LM3S2651 LM3S2730 LM3S2739 LM3S2939 LM3S2948 LM3S2950 LM3S2965 LM3S6100 LM3S6110 LM3S6420 LM3S6422 LM3S6432 LM3S6610 LM3S6633 LM3S6637 LM3S6730 LM3S6938 LM3S6952 LM3S6965 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 372 CHAPTER 13 Device specifics 13 10 1 Unlocking LM3Sxxx devices If your device has been locked accidentially e g by bad application code in flash which mis configures the PLL and J Link can not identify it anymore there is a spe cial unlock sequence which erases the flash memo
139. 2 5 4 SW Diinterface siponi a aa a E NE 183 5 4 1 SWD Speed ER 183 5 4 2 SMO CE 183 5 5 Multi core debugging 185 5 5 1 How multi core debugging works 185 5 5 2 Using multi core debugging in detail 186 5 5 3 Things you should be aware of 187 5 6 Connecting multiple J Links J Traces to your PE 189 5 6 1 How does it WOFK ev aere eee dean vidas Dee T Y idea ets 189 5 7 J iink controlpanel 191 5 7 1 exea re es n x ne e er dod On on Vici dei On e DO CE Re X ieee 191 5 8 Reset strategies eec edie a ar a bedi ka dye gara ria na 197 5 8 1 Strategies for ARM 7 9 4 1 nnn nnn 197 5 8 2 Strategies for Cortex M devices 199 5 9 Using DCC for memory access 202 5 9 1 What is required m 202 5 9 2 Target DCC handler c elites pia ented ee cene ee AN rd dein wept 202 5 9 3 Target DEC abort handler eoe x th ence YER ERR REXRR ER ERE crete eed 202 5 10 The J Link settings files rr er eme en c ne en elg e c ne 203 5 10 1 SEGGER Embedded 1 04 4 66 nennen nnn nnn 203 5 10 2 Keil MDK ARM UVISIOD ge iad ee pee eere kr me Y tg as 203 5 10 3 IAR EWARM date Re vax a a
140. 28 KN Chapter Introduction Section Specifications updated Section Hardware versions updated Section Common features of the J Link product family updated Chapter Target interfaces and adapters Section 5 Volt adapter updated 75 090729 AG Chapter Introduction Section J Link J Trace models updated Chapter Working with J Link and J Trace Section SWD interface updated 74 090722 KN Chapter Introduction Section Supported IDEs added Section Supported CPU cores updated Section Model comparison chart renamed to Model comparison Section J Link bundle comparison chart removed 73 090701 KN Chapter Introduction Section J Link and J Trace models added Sections Model comparison chart amp J Link bundle comparison chart added Chapter J Link and J Trace models removed Chapter Hardware renamed to Target interfaces amp adapters Section JTAG Isolator added Chapter Target interfaces and adapters Section Target board design updated Several corrections 72 090618 AG Chapter Working with J Link Section J Link control panel updated Chapter Flash download and flash breakpoints Section Supported devices updated Chapter Device specifics Section NXP updated 71 090616 AG Chapter Device specifics Section NXP updated 70 090605 AG Chapter Introduction Secti
141. 3 11 2 J Link STM32 Unlock Command line tool J Link STM32 Unlock JLinksTM32 exe is a free command line tool which can be used to disable the hardware watchdog of STM32 devices which can be activated by programming the option bytes Moreover the J Link STM32 Commander unsecures a read protected STM32 device by re programming the option bytes J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 152 CHAPTER 3 J Link software and documentation package Note Unprotecting a secured device or will cause a mass erase of the flash memory C Program Files 686 SEGGERULink V498e ILinkSTM32 exe Le SEGGER J Link Unlock tool for STM32 devices Compiled May 5 2615 11 61 58 lt c 2889 2815 SEGGER Microcontroller GmbH amp Co KG www segger com Solutions for real time microcontroller applications m Exit STM32F xxxx STM32F1xxxx 2 correct device family 3 i i S K 1888 kHz Reset target 0 K Reset option bytes may take 28 seconds 0 K Press any key to exit 3 11 2 1 Command Line Options The J Link STM32 Unlock Utility can be started with different command line options for test and automation purposes In the following the available command line options are explained IP Selects IP as host interface to connect to J Link Default host interface is USB Syntax IP lt IPAddr gt Example JLinkSTM32 exe IP 192 168 1 17 Additional information
142. 32 002836 002871 002875 002883 002885 002906 002908 002923 002925 002942 002944 002959 002961 002985 002987 003009 003011 003031 003033 003053 003054 003057 003075 0 0800 5 4 0 0800 OX080085 A4 0x0800BEBE 0x0800B5A4 0x0800BEBE 0x0800B5A4 0x0800BEBE 080085 4 0 0800 0 080085 4 00800854 OXOBOOBEBE OX080085 A4 0 0800 OXO800E5 A4 008008544 0 0800 OX080085 A4 0x0800BEBE 0x080085A4 0x0800BEBE 0x0800B5A4 0 0800 oxosooBecs OxOB00B3EC 0x0800BED0 0x0800837C 0 0800 06 0 08008334 Ox0800BEDE 0 080082 4 0x0800BEE4 0 0800070 OXO800BEEA 0 08000746 0 0800 0 0 0800077 0x0800BEFE 0x0800B2AC OXO800BEFC 0x0800BFB8 0x0800088C 0x0800BFC2 GetFlagstatus _ 66 RCC_GetFlagStatus us Clk_Init 66 RCC_GetFlagStatus us Clk_Init 66 RCC GetFlagstatus clk_init 66 RCC_GetFlagstatus Clk_Init 66 RCC GetFlagstatus u8 Clk Init 66 GetFlagstatus clk_init 66 RCC_GetFlagstatus us Clk_iInit 66 RCC_GetFlagStatus us Ck Init 66 GetFlagstatus Clk Init 66 RCC GetFlagstatus us Clknit 66 RCC_GetFlagStatus us Clk_Init 66 GetFlagstatus Clk Init 66 RCC_USBCLKConfi g u32 76 RCC ADCCLKConfi g u32 1 _
143. 33 O Open collector 433 Processor Core 434 Program Status Register PSR 434 R RDI S ppOort eer eere ese ead ages 149 REMAPPING 22 eter 434 Remote Debug Interface RDI 434 RESET sean e EC RA et ey Eee Sent 433 2004 2015 SEGGER Microcontroller GmbH amp Co KG 440 Index S dq 434 RTOS v IR M NE ek E 434 S Scan Chaim oue tec dieses rase 434 Semihosting 2 2 2 434 Server command CIFDD AM te 110 CDI See les 110 DisableChecks 110 EnableChecks 111 flash breakpoints 111 og tad awake 111 112 jtagconf rie KAY ete 112 113 oer 112 113 An Es 114 de Re RR teens ns 114 116 nM Sai eee ad ae dee ste 117 Speed deese 117 21 19 M 117 seine eer 119 119 SetDbgPowerDownOnClose 229 232 SetSysPowerDownOnldle 233 STRAGE 121 425 431 Supported flash devices 244 245 251 260 SWI Ain Ne ARE raa a sate ares 434 Syntax conventions used 15 T TADS
144. 4 1 2 Interface This dialog is used to configure the SPI interface settings like SPI communication speed etc Project settings 9 General Interface Flash 4000 v kHz Interface speed 10 4 1 2 1 Interface Speed Specifies the SPI communication speed J Link uses to communicate with the SPI flash 10 4 1 3 Flash Settings This dialog is used to select and configure the parameters of the SPI flash that J Flash SPI will connect to Examples for flash parameters are Sector size Smallest erasable unit page size smallest programmable unit Flash ID etc There is also the option to try to auto detect the connected flash device The latter option will prompt J Flash SPI to try to identify the flash by its Flash ID looking up in an internal list of known flash devices Project settings P General Interface Fash J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG ID Len o NumPages Detect SPI flash Flash ID 0x00 0500 0 00 0x00 0 00 0 00 0 00 0 00 0 00 000 PageSize 0 01 SectorSize 001 SPI Instructions Instruction Address bytes WiiteEnable 0x00 WriteDisable 0x00 WritePage oon p EraseSector oon lo EraseBulk oon Instruction Address bytes ReadD 0x00 ReadData 0 ReadFast on 0 ReadStatus o0
145. 56 bytes 5 12 1 29map indirectread This command can be used to read a memory area indirectly Indirect reading means that a small code snippet is downloaded into RAM of the target device which reads and transfers the data of the specified memory area to the host Before map indi rectread can be called a RAM area for the indirect read code snippet has to be defined Use therefor the map ram command and define a RAM area with a size of gt 256 byte Typical applications Refer to chapter Fast GPIO bug on page 374 for an example Syntax map indirectread lt StartAddressOfArea gt lt EndAddress gt Example map indirectread Ox3fffc000 Ox3fffcfff Additional information e StartAddressOfArea has to be 256 byte aligned address The region size has to be a multiple of 256 bytes 5 12 1 30map ram This command should be used to define an area in RAM of the target device The area must be 256 byte aligned The data which was located in the defined area will not be corrupted Data which resides in the defined RAM area is saved and will be restored if necessary This command has to be executed before map indirectread will be called Typical applications Refer to chapter Fast GPIO bug on page 374 for an example Syntax map ram lt StartAddressOfArea gt lt EndAddressOfArea gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 226 CHAPTER 5 Working with J Link and J Trace Example map ram 0x40
146. 6 Measure a Cancel When running in normal mode J Link SWO Viewer automatically performs the neces sary initialization to enable SWO output on the target in GDB Server mode the ini tialization has to be done by the debugger 3 7 2 List of available command line options J Link SWO Viewer can also be controlled from the command line if used in a auto mated test environment etc When passing all necessary information to the utility via command line the configu ration dialog at startup is suppressed Minimum information needed by J Link SWO Viewer is the device name to enable CPU frequency auto detection or the CPU clock speed The table below lists the commands accepted by the J Link SWO Viewer Command Description cpufreq Select the CPU frequency device Select the target device Selects a set of itm stimulus ports which should be used itmmask 2 to listen to Selects a itm stimulus port which should be used to listen itmport to outputfile Print the output of SWO Viewer to the selected file settingsfile Specify a J Link settings file swofreq Select the CPU frequency Table 3 14 Available command line options 3 7 2 1 cpufreq Defines the speed in Hz the CPU is running at If the CPU is for example running at 96 MHz the command line should look as below Syntax cpufreq lt CPUFreq gt Example cpufreq 96000000 3 7 2 2 device Select the target device to enable t
147. 67 4 6 J Link USB identification In general when using USB there are two ways in which a J Link can be identified e serial number e By USB address Default configuration of J Link is Identification by serial number Identification via USB address is used for compatibility and not recommended Background information USB address really means changing the USB Product ID PID The following table shows how J Links enumerate in the different identification modes Identification PID Serial number Serial number is real serial number of the J Link or user assigned USB address 0 Deprecated 0 0101 123456 USB address 1 Deprecated 0x0102 123456 USB address 2 Deprecated 0x0103 123456 USB address 3 Deprecated 0x0104 123456 Table 4 1 J Link enumeration in different identification modes Serial number default 0x0101 4 6 1 Connecting to different J Links connected to the same host PC via USB In general when having multiple J Links connected to the same PC the J Link to connect to is explicitly selected by its serial number Most software debuggers pro vide an extra field to type in the serial number of the J Link to connect to The following screenshot shows the connection dialog of the J Flash software Project settings J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 168 CHAPTER 4 Setup The following screenshot shows the co
148. 7 12 2 6 Memory footprint esce HIN A IMEEM IUE 337 12 3 RIT Communication ERE E re M RENE EE xr EE 338 12 3 1 3 coire teen m aux cen ee xe me ae one Mave cade xime e o 338 12 3 2 RTT CHENG ici erede e itm ER Ra RE ERRARE RPRR Pat En TRIER ERR IRE ER ER 343 12 3 3 RA T Eogget aie EC m M MUI M ML EE 343 12 3 4 RTT in other host applications sis 343 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 22 12 4 ImplemieritatiOh citri es ea cv a pr 344 12 4 1 APT amp eec 344 12 4 2 Configuration defines E 350 12 5 Example code ie ert rci diae i a en o n a 352 12 6 opp EET 353 DCNIB IURI eller E 355 13 1 Analog DEVIS dat eret e pot etapa Fu gan aoe 356 13 1 1 ADUCI oque 356 13 2 358 13 2 1 ATITSAM Z aien RL 359 13 2 2 Duaci 361 13 3 DSPGrIOUDp i codec A E Ka Ex RF REIN E aera Fa 362 13 4 EM DET ade law ave eters ven tee deeds bees 363 13 5 Energy Micro MEER 364 13 6 Freescale e ees 365 13 6 1 Kinetis farmily cava ouo vea mue For v wi x de en nn an sd RED 365 13 7 acl 368 13 8 lige Eer 369 13 9 uis E 370 13 10 Euminary
149. 73001008 173001040 173001041 173001042 173001043 173001044 173001045 173001046 173001048 173001049 192 168 6 6 192 168 6 5 192 168 8 4 192 168 8 7 192 168 8 6 192 168 8 2 192 168 8 3 192 168 8 5 192 168 4 253 192 168 6 2 192 168 6 4 00 22 C7 E 00 22 C7 02 04 12 00 22 C7 02 04 13 00 22 7 02 04 14 00 22 7 02 04 15 00 22 7 02 04 16 00 22 C7 02 04 18 00 22 C7 02 04 19 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 1 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 16 37 2011 Sep 16 37 2011 Aug 18 19 57 Old 2011 Aug 18 19 57 Old 2011 Jul 26 17 24 Old 2011 Jul 26 17 24 Old 2011 Sep 6 16 37 2011 Aug 11 17 30 Old 2011 Jul 26 17 24 Old 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Sep 6 16 37 2011 Jul 26 17 24 Old 2004 2015 SEGGER Microcontroller GmbH amp Co KG 166 CHAPTER 4 Setup In order to configure an old J Link which uses the old USB 0 3 USB identification method to use the new USB identification method reporting the real serial number simply select Real SN as USB identification method and click the OK button The same dialog also allows configuration of the IP settings of the connected J Link if it supports the Ethernet interface Configure J Link J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 1
150. 8 SEGGER J Link Lite ARM J Link Lite ARM is a fully functional OEM version of SEGGER J Link If you are selling evaluation boards J Link Lite ARM is an inexpensive emulator solution for you Your customer receives a widely acknowledged JTAG emulator which allows to start right away with development Limitations JTAG speed is limited to 4 MHz Licenses No licenses are included All licenses can be added Note J Link Lite ARM is only delivered and supported as part of Starter Kits It is not sold to end customers and not guaranteed to work with custom hardware J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 79 2 6 J Link OBs J Link OBs J Link On Board are single chip versions of J Link which are used on var ious evalboards It is legal to use J Link software with these boards J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 80 CHAPTER 2 Licensing 2 7 Mlegal Clones Clones are copies of SEGGER products which use the copyrighted SEGGER Firmware without a license It is strictly prohibited to use SEGGER J Link software with illegal clones of SEGGER products Manufacturing and selling these clones is an illegal act for various reasons amongst them trademark copyright and unfair business practise issues The use of illegal J Link clones with this software is a violation of US European and other international laws and is prohibited If you are in doub
151. AM7SE all devices AT91SAM7X all devices AT91SAM7XC all devices AT91SAM7A all devices 13 2 1 3 Recommended init sequence In order to work with an ATMEL AT91SAM7 device it has to be initialized The follow ing paragraph describes the steps of an init sequence An example for different soft ware tools such as J Link GDB Server IAR Workbench and RDI is given Set JTAG speed to 30kHz Reset target Perform peripheral reset Disable watchdog Initialize PLL Use full JTAG speed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 360 CHAPTER 13 Device specifics Samples GDB Sample connect to the J Link gdb server target remote localhost 2331 monitor flash device AT91SAM7S256 monitor flash download 1 monitor flash breakpoints 1 Set JTAG speed to 30 kHz monitor endian little monitor speed 30 Reset the target monitor reset 8 monitor sleep 10 Perform peripheral reset monitor long OxFFFFFDOO 0xA5000004 monitor sleep 10 Disable watchdog monitor long OxFFFFFD44 0x00008000 monitor sleep 10 Initialize PLL monitor long OxFFFFFC20 0x00000601 monitor sleep 10 monitor long OxFFFFFC2C 0x00480a0e monitor sleep 10 monitor long OxFFFFFC30 0x00000007 monitor sleep 10 monitor long OxFFFFFF60 0x00480100 monitor sleep 100 monitor speed 12000 break main load continue IAR Sample f kk kk kk kk kc kkk he he e kkk kkk kk ke he ke he ehe h
152. AS IRE DIR RM Ltd Direct Connection 3 S VPB926EJ S U Versatile Platform for ARMS26EJ S USB port RealViewICE H SRealview ICE ARM JT G debug interface TCP IP J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 311 4 Now select Add DLL to add the JLinkRDI d11 Select the installation path of the software for example C Program FilesNSEGGERNJLinkARM V350gNJLinkRDI dll RDI Target List Name Version Description Remote v1 2 Angel debug protocol serial port Ex Multi ICE v2 2 5 ARM JTAG debug interface parallel port 4RMulator v1 4 ARM instruction set simulator Bonnae Duplicate M 5 After adding the DLL an additional Dialog opens and asks for description These values are voluntary if you do not want change them just click OK Use the fol lowing values and click OK Short Name JLinkRDI Description J Link RDI Interface Create New RDI Target JLinkRDI J Link ARM ADI Interface __ cancel 6 Back in the RDI Target List Dialog select JLink RDI and click Configure For more information about the generic setup of J Link RDI please refer to Configu ration on page 320 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 312 CHAPTER 11 RDI RDI Target List Name Version Description JLinkADI J Link ARM RDI Interface Remote v1 2 Angel debug
153. Built in intelligence for supported CPU cores 4 1 6 61 1 6 1 Intelligence in the J Link firmware 61 1 6 2 Intelligence on the PC side 4 6 61 1 6 3 Firmware intelligence per model 63 1 7 SUPPOrted 65 2 IGI SR EE PE ET 67 D Components requiring a license68 2 2 dl acces a 69 2 2 1 Ie 69 2 2 2 Key based license rece ae o ere ei Tdi ee 69 2 3 Legal use of SEGGER J Link software 70 2 3 1 Use of the software with 3rd party tools 70 2 4 Original amp EGGER prod cts 5 He taa abi pU 71 2 4 1 71 2 4 2 J LINK PLUS eie cx exec xen xa e m en ert i e X e e E Oc o Rn 71 2 4 3 J link ULTRA cesser aea dE EY Gag ieee cel e Sa 72 2 4 4 PRO ER 72 2 4 5 2 AEN a 72 2 4 6 J Trace for Cortex M c ceret x tein e RR TR Fe TE UO ERE eas 73 2 4 7 FIASNEMARM eU 74 2 4 8 Flasher RX ect EE 74 2 4 9 IE ES EE ENNER CATENA a 75 2 5 J Link OEM versions ec ee x ee x xa e i e T e a a v
154. C00C Cortex MO o600000000050555 Cortex MO e090 801000190 9 90 9 Cortex M1 e000 0000900 9 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 34 CHAPTER 1 Introduction Hardware version 3 0 4 0 5 0 5 2 5 3 5 4 6 0 7 0 8 0 9 1 9 N Cortex M3 6000000002727 Cortex M4 6000000000792 Cortex M7 6000000000505 Cortex R4 6000000002727 Cortex R5 eee 88010889090 90 scooo Mo secure O 5 300 M3 secure 090 Microchip PIC32 Microchip PIC32MX Q Q Q Q Microchip PIC32MZ Q Q Q Q Q Q Q Q Renesas RX110 Renesas RX111 Renesas RX210 Renesas RX21A Renesas RX220 9 Q 9 O Oo 9 9 9 9 9 Table 1 2 J Link BASE hardware version 7 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG A e e N A e N Hardware version Renesas RX610 Renesas RX621 Renesas RX62G Renesas RX62N Renesas RX62T Renesas RX630 Renesas RX631 Renesas RX63N O 00000 0 00000 0 0 9 000 00 8 9 00000 8 00 00 8 O O O 00 8 O 9 00000 0
155. Co KG 116 CHAPTER 3 J Link software and documentation package Description Sets the SWI number used for semihosting in ARM mode The default value for the ARMSWI is 0x123456 Example gt monitor semihosting ARMSWI 0x123456 Semihosting ARM SWI number set to 0x123456 3 3 3 22 semihosting ThumbSWI Syntax semihosting ThumbSWI Value Description Sets the SWI number used for semihosting in thumb mode The default value for the ThumbSWI is OxAB Example gt monitor semihosting ThumbSWI 0xAB lt Semihosting Thumb SWI number set to 3 3 3 23 setargs Syntax setargs ArgumentString Description Set arguments for the application where all arguments are in one Argument String separated by whitespaces The argument string can be gotten by the application via semihosting command SYS GET CMDLINE 0x15 Semihosting has to be enabled for getting the argumentstring semihosting enable monitor setargs can be used before enabeling semihosting The maximum length for lt ArgumentString gt is 512 characters Example gt monitor setargs test 0 1 2 arg0 4 lt Arguments test 0 1 2 arg0 4 3 3 3 24 setbp Syntax setbp Addr lt Mask gt Description Sets an instruction breakpoint at the given address where Mask can be 0x03 for ARM instruction breakpoints Instruction width 4 Byte mask out lower 2 bits or 0x01 for THUMB instruction breakpoints Instruction width 2 Byte mask out lower
156. Cortex A5 A8 A9 Cortex M0 M0 M1 M3 M4 Cortex R4 R5 core JTAG clock up to 4 MHz 1 3 6 2 Specifications SWD SWO supported for Cortex M devices Flash download into supported MCUs Standard 20 pin 0 1 inch JTAG connector compatible to J Link The following table gives an overview about the specifications general mechanical electrical for J Link Lite ARM All values are valid for J Link hardware version 8 General Supported OS For a complete list of all operating sys tems which are supported please refer to Supported OS on page 27 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 20 C 65 C Relative humidity non condensing Max 90 rH Size without cables 28mm x 26mm x 7mm Weight without cables 6g Mechanical USB interface USB 2 0 full speed Target interface JTAG 20 pin 14 pin adapter available JTAG SWD Interface Electrical Power supply USB powered Max 50mA Target Supply current Target interface voltage Vir 3 3V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300 LOW level input voltage Max 40 of Vir HIGH level input voltage Min 60 of VIF JTAG SWD Interface Timing Data input rise time Taqi Max 20ns Data input fall
157. Cortex M4 Cortex M7 Cortex R4 Cortex R5 5 000 MO secure SC300 M3 secure O O O 8 9 9 9 O 9 9 9 9 9 O O 9 9 9 9 9 9 9 2 Microchip PIC32MX Microchip PIC32MZ e Renesas RX Renesas RX110 e e Table 1 7 J Link PRO hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 49 Hardware version o A o Renesas RX111 Renesas RX210 Renesas RX21A Renesas RX220 Renesas RX610 Renesas RX621 Renesas RX62G Renesas RX62N Renesas RX62T Renesas RX630 Renesas RX631 Renesas RX63N Renesas RX63T 9 6 O 6 6 0000 00 O O 6 9 6 6 6 6 6 6 O 9 9 9 9 9 6 6 6 9 06 9 Table 1 7 J Link PRO hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 50 CHAPTER 1 1 3 6 J Link Lite ARM J Link Lite ARM is a fully functional OEM version of J Link If you are selling evaluation boards J Link Lite ARM is an inex pensive emulator solution for you Your customer receives a Introduction widely acknowledged debug probe which allows to start right away with development 1 3 6 1 Additional features e Very small form factor e Fully software compatible to J Link e Supports any ARM7 9 11
158. DR Save the current data file Please note that the parameters lt SADDR gt lt EADDR gt apply only if the data file is a bin file or c file saveas FILE NAME gt lt SADDR gt lt EADDR gt Save the current data file into the specified file Please note that the parameters lt SADDR gt lt EADDR gt apply only if the data file is a bin file or c file saveprj Save the current project saveprjas lt FILENAME gt Save the current project in the specified file verify Verify target memory usb lt SN gt Overrides connection settings to USB ip XXx XXX XXX XXX 2 ip lt HostName gt Overrides connection settings to IP Table 10 9 J Flash SPI command line options J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 291 10 5 3 Batch processing J Flash SPI can be used for batch processing purposes All important options are available in command line mode as well When providing command line options the application does not wait for manual user input All command line operations will be performed in exactly the order they are passed So for example issuing a program command before a project has been opened will cause the program command to fail The example batchfile below will cause J Flash SPI to perform the following opera tions 1 Open project C Projects Default jflash 2 Open bin file C Data data bin and set start address to 0x10
159. Device Name Auto Ok Add Delete Update IR len Si r Debug Connect amp Reset Options Cache Options Download Options Reset Normal IV Cache Code Verify Code Download v eset iter Connect Cache Memory IV Download to Flash m Interface TCP IP Misc USB C TCP P CT IP Address Port Auto 0 Autodetect JLink Info Scan 27 1 0 1 EIE 9 Ping State ready J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 248 6 4 3 CHAPTER 6 Flash download Mentor Sourcery CodeBench To use the J Link flash download feature in Mentor Sourcery CodeBench the follow ing steps need to be performed Current versions of Sourcery CodeBench do not pass the device name selected in CodeBench to the J Link DLL Therefore a device override via J Link settings file is needed Copy the J Link settings file template from SJLINK_INST_DIRS Samples JLink SettingsFiles Sample jlinksettings to the directory where the CodeBench project is located Open the Sample jlinksettings in a text editor and scroll to the FLASH sec tion Change the line Device UNSPECIFIED to the device name that shall be selected keep the quotation marks A list of valid device names found here http www segger com jlink supported devices html List of known devices Change the line
160. Example ms 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 93 3 2 1 29 power This command sets the status of the power supply over pin 19 of the JTAG connector The KS Kickstart versions of J Link have the 5V supply over pin 19 activated by default This feature is useful for some targets that can be powered over the JTAG connector Syntax power lt State gt perm Parameter Meaning State Valid values On Off perm Sets the specified State value as default Example f 3 2 1 30 r Resets and halts the target Syntax E 3 2 1 31 regs Shows all current register values Syntax regs 3 2 1 32 rnh This command performs a reset but without halting the device Syntax rnh 3 2 1 33 rreg The function prints the value of the specified CPU register Syntax rreg lt RegIndex gt Parameter Meaning RegIndex Register to read Example rreg 15 3 2 1 34 rx Resets and halts the target It is possible to define a delay in milliseconds after reset This function is useful for some target devices which already contain an application or a boot loader and therefore need some time before the core is stopped for example to initialize hardware the memory management unit MMU or the external bus interface J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 94 CHAPTER 3 J Link software and documentation pack
161. F103ZE Toolset ARM 3 STM32F103VF 3 STM32F103VG 3 STM32F103ZC 3 STM32F1037D ARM 32bit Cortex M3 Microcontroller 72MHz 512kB Flash 64 lt SRAM 2 0B Active 3 12 bit 16 ch A D Converter 2 1254 D A Converter d 034 3 sTM32F1032G 1 SDIO Fast 0 Pots 3 STM32F105R8 3 STM32F105RB STM32F105RC 3 STM32F105V8 STM32F105VB STM32F105VC CA STM32F107RB STM32F107RC To enable the J Link flash loader J Link J Trace at Project gt Options for Tar get gt Utilities has to be selected It is important that Update Target before Debug ging is unchecked since otherwise uVision tries to use its own flashloader Device Target Output Listing User C C Asm Linker Debug Utitties r Configure Flash Menu Command Use Target Driver for Flash Programming Cortex M R J LINK J Trace Settings Update Target before Debugging RET Est Use Extemal Tool for Flash Programming Omed Amets _ Run Independent oats Lose J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 247 Then J Link has to be selected as debugger To select J Link as debugger simply choose J Link J Trace from the list box which can be found at Project gt Options for Target gt Debug V Options for Target MCBSTM32E Flash Device Target Output Listing User
162. Firmware J Link compiled Feb 2007 19 59 46 ARM Rev 5 Hardware 05 30 S N UTarget 3 3130 Example exec SupplyPower 1 exec map reset exec map exclude 0x10000000 0x3FFFFFFF J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 236 CHAPTER 5 Working with J Link and J Trace 5 12 2 2 IAR Embedded Workbench The J Link command strings can be supplied using the C SPY debugger of the IAR Embedded Workbench Open the Project options dialog box and select Debugger Options for node Project General Options C C Compiler Assembler Custom Build Build Actions Linker Debugger Simulator Angel IAR ROM monitor J Link J Trace LMI FTDI Macraigor RDI Third Party Driver On the Extra Options page select Use command line options Enter jlink_exec_command lt CommandLineOption gt in the textfield as shown in the screenshot below If more than one command should be used separate the com mands with semicolon Options for node Project General Options C C Compiler Assembler Custom Build Build Actions Linker Simulator Angel IAR ROM monitor J LinkAl Trace LMI FTDI Macraigor RDI Third Party Driver J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 237 5 13 Switching off CPU clock during debug We recommend not to switch off CPU clock during debug However if you do you should consider the following Non synthes
163. G data input of target CPU It is recommended that this pin is pulled to a defined state on the target board Typically connected to TDI of the target CPU TMS Output JTAG mode set input of target CPU This pin should be pulled up on the target Typically connected to TMS of the target CPU TCK Output JTAG clock signal to target CPU It is recommended that this pin is pulled to a defined state of the target board Typically connected to TCK of the target CPU 11 RTCK Input Return test clock signal from the target Some targets must synchronize the JTAG inputs to internal clocks To assist in meeting this requirement you can use a returned and retimed TCK to dynamically control the TCK rate J Link supports adaptive clocking which waits for TCK changes to be echoed correctly before making further changes Con nect to RTCK if available otherwise to GND 13 TDO Input JTAG data output from target CPU Typically connected to TDO of the target CPU Table 14 1 J Link J Trace pinout J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG PIN SIGNAL TYPE Description Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is typically called nRST nRESET or RESET This pin is not connected in J Link It is reserved for com patibility with other equipment to be used as a deb
164. G port Signal level reference It is normally fed from Vdd of the 12 VTRef target board and must not have a series resistor 13 RTCK Return test clock from the target JTAG port 14 VSupply Supply voltage It is normally fed from Vdd of the target board and must not have a series resistor 15 Test clock to the run control unit from the JTAG port Trace signal For more information please refer to 16 Trace signal 12 Assignment of trace information pins between ETM archi tecture versions on page 400 17 TMS Test mode select from run control to the JTAG port Trace signal For more information please refer to 18 Trace signal 11 Assignment of trace information pins between ETM archi tecture versions on page 400 19 TDI Test data input from run control to the JTAG port Trace signal For more information please refer to 20 Trace signal 10 Assignment of trace information pins between ETM archi tecture versions on page 400 21 nTRST Active low JTAG reset Table 14 7 JTAG Trace connector pinout J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 399 PIN SIGNAL Description 22 Trace signal 9 23 Trace signal 20 24 Trace signal 8 25 Trace signal 19 26 Trace signal 7 27 Trace signal 18 28 Trace signal 6 29 Trace signal 17 Trace signals For more information please refer to 30 Trace sign
165. GGER Microcontroller GmbH amp Co KG Analog ADuC7026x62 Analog ADuC7027x62 Analog ADuC7030 Analog ADuC7031 Analog ADuC7032 Analog ADuC7033 Analog ADuC7128 Analog ADuC7129 Analog ADuC7229x126 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 358 13 2 ATMEL CHAPTER 13 Device specifics J Link has been tested with the following ATMEL devices AT91SAM3A2C 915 4 AT91SAM3A8C AT91SAM3N1A AT91SAM3N1B AT91SAM3N1C AT91SAM3N2A AT91SAM3N2B AT91SAM3N2C AT91SAM3N4A AT91SAM3N4B AT91SAM3N4C AT91SAM3S1A AT91SAM3S1B AT91SAM3S1C AT91SAM3S2A AT91SAM3S2B AT91SAM3S2C AT91SAM3S4A AT91SAM3S4B AT91SAM3S4C AT91SAM3U1C AT91SAM3U2C AT91SAM3U4C AT91SAM3U1E AT91SAM3U2E AT91SAM3UAE AT91SAM3X2C 915 2 AT91SAM3X2G AT91SAM3X2H AT91SAM3X4C AT91SAM3X4E AT91SAM3X4G AT91SAM3X4H AT91SAM3X8C AT91SAM3X8E AT91SAM3X8G AT91SAM3X8H AT91SAM7A3 AT91SAM7L64 AT91SAM7L128 AT91SAM7S16 AT91SAM7S161 915 7532 915 75321 915 7564 915 75128 915 75256 915 75512 AT91SAM7SE32 AT91SAM7SE256 AT91SAM7SE512 AT91SAM7X128 AT91SAM7X256 AT91SAM7X512 AT91SAM7XC128 AT91SAM7XC256 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 359 e 915 7 512 e 915 9 128 e 1 915 9 256 13 2 1 915 7 13 2 1 1 Reset strategy The reset pin of the device is per default disabled This means th
166. H amp Co KG 41 1 3 4 J Link ULTRA J Link ULTRA is a JTAG SWD emulator designed for ARM Cor tex and other supported CPUs It is fully compatible to the standard J Link and works with the same PC software Based on the highly optimized and proven J Link it offers even higher speed as well as target power measurement capabilities due to the faster CPU built in FPGA and High speed USB interface It connects via USB to a PC running Microsoft Windows 2000 or later For a complete list of all operating systems which are sup ported please refer to Supported OS on page 25 J link ULTRA has a built in 20 pin JTAG SWD connector 1 3 4 1 Additional features Fully compatible to the standard J Link Very high performance for all supported CPU cores Hi Speed USB 2 0 interface Download speed up to 3 MByte second Debug interface JTAG SWD speed up to 15 MHz Serial Wire Debug SWD supported Serial Wire Viewer SWV supported SWO sampling frequencies up to 100 MHz Serial Wire Output SWO supported Target power can be supplied Comes with built in licenses for Unlimited number of breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming software e Target power consumption can be measured with high accuracy plink The actual speed depends on various factors such as JTAG SWD clock speed host CPU core etc 1 3 4 2 Specifications The following table gives a
167. HAPTER 16 Designing the target board for trace 16 1 Overview of high speed board design Failure to observe high speed design rules when designing a target system contain ing an ARM Embedded Trace Macrocell ETM trace port can result in incorrect data being captured by J Trace You must give serious consideration to high speed signals when designing the target system The signals coming from an ARM ETM trace port can have very fast rise and fall times even at relatively low frequencies Note These principles apply to all of the trace port signals TRACEPKT 0 15 PIPESTAT 0 2 TRACESYNC but special care must be taken with TRACECLK 16 1 1 Avoiding stubs Stubs are short pieces of track that tee off from the main track carrying the signal to for example a test point or a connection to an intermediate device Stubs cause impedance discontinuities that affect signal quality and must be avoided Special care must therefore be taken when ETM signals are multiplexed with other pin functions and where the PCB is designed to support both functions with differing tracking requirements 16 1 2 Minimizing Signal Skew Balancing PCB Track Lengths You must attempt to match the lengths of the PCB tracks carrying all of TRACECLK PIPESTAT TRACESYNC and TRACEPKT from the ASIC to the mictor connector to be within approximately 0 5 inches 12 5mm of each other Any greater differences directly impact the setup and hold time requirements 16 1
168. HAPTER 5 Working with J Link and J Trace 5 14 Cache handling Most target systems with external memory have at least one cache Typically ARM7 systems with external memory come with a unified cache which is used for both code and data Most 9 systems with external memory come with separate caches for the instruction bus I Cache and data bus D Cache due to the hardware archi tecture 5 14 1 Cache coherency When debugging or otherwise working with a system with processor with cache it is important to maintain the cache s and main memory coherent This is easy in sys tems with a unified cache and becomes increasingly difficult in systems with hard ware architecture A write buffer and a D Cache configured in write back mode can further complicate the problem ARM9 chips have no hardware to keep the caches coherent so that this is the responsibility of the software 5 14 2 Cache clean area J Link J Trace handles cache cleaning directly through JTAG commands Unlike other emulators it does not have to download code to the target system This makes setting up J Link J Trace easier Therefore a cache clean area is not required 5 14 3 Cache handling of ARM7 cores Because ARM7 cores have a unified cache there is no need to handle the caches dur ing debug 5 14 4 Cache handling of ARM9 cores ARM cores with cache require J Link J Trace to handle the caches during debug If the processor enters debug state with ca
169. Hz n 4 9 600 MHz n 5 8 000 MHz n 6 6 857 MHz n 7 6 000 MHz n 8 5 333 MHz n 9 4 800 MHz n 10 e Supports adaptive clocking Version 5 2 Obsolete Identical to version 5 0 with the following exception e Target interface RESET is open drain Version 5 3 Obsolete Identical to version 5 2 with the following exception e 5V target supply current limited 5V target supply pin 19 of Kick Start versions of J Link is current monitored and limited J Link automatically switches off 5V supply in case of over current to protect both J Link and host computer Peak current lt 10 ms limit is 1A operating current limit is 300mA J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 32 CHAPTER 1 Introduction Version 5 4 Obsolete Identical to version 5 3 with the following exception e Supports 5V target interfaces Version 6 0 Obsolete Identical to version 5 4 with the following exception Outputs can be tristated Effectively disabling the JTAG interface Supports SWD interface SWD speed Software implementation 4 MHz maximum SWD speed J Link supports SWV Speed limited to 500 kHz Version 7 0 Obsolete Identical to version 6 0 with the following exception e Uses an additional pin to the UART unit of the target hardware for SWV support Speed limited to 6 MHz Version 8 0 Identical to version 7 0 with the following exception e SWD support fo
170. IC setVectorTable u32 u32 J Link J Trace UM08001 003393 OxOS00BFCZ 003395 0x0800084C maint 26 NVIC_PriorityGroupconfig u32 1 _0 0800 4 Ox800BF28 08008 6 9800 RO RO 0 0 0800 8 PUSH R4 LR OSODBFAA BOSS SUB SP SP 40x20 debug OSO0BFAC FODIFSAS BL debug ENTR SECTION IK Init i OSODBFB4 F7FFFF62 BL Clk Init NVIC SetvectorTable NVIC VectTab FLASH 0x0 08006 2100 R1 OSODBFBA 05 6000 MOVS RO 0 8000000 DSODBFBE 001 65 BL nvic_setvectortable Pi ir riori 0800 2 44 7040 MOV RO 0x300 0800 6_ FOOIFC41 BL Prioritysroupconfig Tick ITConf O800BFDO 2001 IMS O800BFD2 FOO1FB1A BL T 0x1 sysTick_rrconti g 0800 06 2001 MOVS RO 0800 8 FOOIFAEB BL SytT ick countercmd APB2Peri PIOA RCCCAPB2Periph GPIOG DISABLE 0800 0 2100 MOVS R1 0x0 OSODBFDE F44F7082 MOV RO 0 104 OSOOBFE2 F7FFFASO BL RCC_APB2PeriphResetcmd APB2Periphclockcmd RCC_APB2Periph GPIOA RCC APB2Periph GPIOG ENABLE 0800 6 2101 MOVS R1 0xl OSDDBFES F44F7082 MOV RO 0 104 0800 F7FFFA20 BL RCC_APB2 Peri phcl ockcmd GPIO Initstructure GPIO Pin B1 MASK DSODBFFO F44F7080 MOV RO 0 100 OSDOBFF4 8 00000 STRH RO SP GPIO Initstructure s GPIO Mode IN FLOATING OSDOBFFS 2004 RO 0x4 08008 22200003 STRE RO SP 0x3 GPIO Initstructure GPIO speed G
171. IO InitStructure GPIO Mode GPIO Mode IN FLORTING GPIO InitStructure GPIO Speed GPIO Speed 5UMHz GPIO Init Bi PORT amp GPIO_InitStructure GPIO InitStructure GPIO Pin B2 MASK GPIO InitStructure GPIO Mode GPIO Mode IN FLORTING GPIO InitStructure GPIO Speed GPIO Speed 5UMHz GPIO Init B2 PORT amp GPIO_InitStructure EXT CRT SECTIONCO 4 4 port and ADC init 44 Enable ADC1 and GPIOC clock M ccc fPB2Periph GPIOC DISABLE RCC_APB2PeriphClockCmd lt RCC_APB2Periph_ADC1 i RCC 2 GPIOC ENABLE 002403 002407 002442 002446 002481 002485 002520 002524 002559 002563 002598 002602 002637 002641 002676 002680 002715 002719 002754 002758 002793 002797 002832 002836 002871 002875 002883 002885 002906 002908 002923 002925 002942 002944 002959 002961 002985 002987 003009 003011 003031 003033 003053 003054 003057 OX0800B5A4 0x0800BEBE 002725 Ox0800BSA4 002760 002764 0 0800 5 4 002799 002803 Ox0800B5A4 002838 002842 Ox0800BSA4 002877 002881 Ox0800BSA4 002916 002920 Ox0800B5A4 002955 OxO800BEBE 002959 Ox0800BSA4 002994 002998 Ox0800BSA4 003033 0 0800 003037 0 0800 5 4 003072 003076 008008544 003111 0 0800 003115 Ox0800B5A4 003150
172. J Link Serial No m Target device STM32F4171G Little endian m Target interface Speed Auto selection Adaptive clocking e 4000 kHz Command line option select USB device STM32F417lG if SWD speed 4000 All configurations can optionally be given in the command line options Note To make sure the connection to the target device can be established cor retly the device as well as the interface and interface speed have to be given on start of GDB Server either via command line options or the configuration dialog If the target device option device is given the configuration dialog will not pop up 3 3 2 2 Setting up GDB Server CL version The command line version of GDB Server is part of the J Link Software Package for all supported platforms On Windows its name is JLinkGDBServerCL exe on Linux and Mac it is JLinkGDB Server J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 104 CHAPTER 3 J Link software and documentation package Starting GDB Server on Windows To start GDB Server CL on Windows open the Run prompt Windows R or a com mand terminal cmd and enter lt PathToJLinkSoftware gt JLinkGDBServerCL exe lt CommandLineOptions gt Starting GDB Server on Linux Mac To start GDB Server CL on Linux Mac open a terminal and call JLinkGDBServer lt Comm
173. J Link J Trace User Guide TUA Software Version V5 10 Manual Rev 0 Date November 27 2015 Document UM08001 SEGGER A product of SEGGER Microcontroller GmbH amp Co KG www segger com Disclaimer Specifications written in this document are believed to be accurate but are not guar anteed to be entirely free of error The information in this manual is subject to change for functional or performance improvements without notice Please make sure your manual is the latest edition While the information herein is assumed to be accurate SEGGER Microcontroller GmbH amp Co KG the manufacturer assumes no responsibility for any errors or omissions The manufacturer makes and you receive no warranties or conditions express implied statutory or in any communication with you The manufacturer specifically disclaims any implied warranty of merchantability or fitness for a particular purpose Copyright notice You may not extract portions of this manual or modify the PDF file in any way without the prior written permission of the manufacturer The software described in this doc ument is furnished under a license and may only be used or copied in accordance with the terms of such a license 2015 SEGGER Microcontroller GmbH amp Co KG Hilden Germany Trademarks Names mentioned in this manual may be trademarks of their respective companies Brand and product names are trademarks or registered t
174. JTAG buffer Before calling this function please make sure that the JTAG chain has been config ured correctly by setting the appropriate global DLL variables For more information about the known global DLL variables please refer to Global DLL variables on page 210 Prototype api int JTAG StoreDR unsigned int64 tdi int NumBits 5 11 2 11JTAG Write Description Writes a JTAG sequence max 64 bits per pin J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 207 Prototype api int JTAG Write unsigned _ int64 tms unsigned _ int64 tdi int NumBits 5 11 2 12JTAG Store Description Stores a JTAG sequence max 64 bits per pin in the DLL JTAG buffer Prototype api int JTAG_Store unsigned _ int64 tms unsigned _ int64 tdi int NumBits 5 11 2 13 TAG_GetU32 Description Gets 32 bits JTAG data starting at given bit position Prototype int JTAG_GetU32 int BitPos 5 11 2 14JTAG_WriteClocks Description Writes a given number of clocks Prototype int JTAG WriteClocks int NumClocks 5 11 2 15JTAG_StoreClocks Description Stores a given number of clocks in the DLL JTAG buffer Prototype int JTAG_StoreClocks int NumClocks 5 11 2 16JTAG_Reset Description Performs a TAP reset and tries to auto detect the JTAG chain Total IRLen Number of devices If auto detection was successful the global DLL variables which d
175. K10DN512 MK10DX128 MK10DX256 MK20DN512 MK20DX128 MK20DX256 MK30DN512 MK30DX128 MK30DX256 MK40N512 MK40X128 MK40X256 MK50DN512 MK50DX256 MK50DN512 MK50DX256 MK51DX256 MK51DN512 MK51DX256 MK51DN512 MK51DN256 MK51DN512 MK52DN512 MK53DN512 MK53DX256 MK60N256 MK60N512 MK60X256 365 If your device has been locked by setting the MCU security status to secure and mass erase via debug interface is not disabled J Link is able to unlock your Kinetis K40 K60 device The device can be unlocked by using the unlock command in J Link Commander For more information regarding the MCU security status of the Kinetis devices please refer to the user manual of your device 13 6 1 2 Tracing The first silicon of the Kinetis devices did not match the data setup and hold times which are necessary for ETM Trace On these devices a low drive strength should be configured for the trace clock pin in order to match the timing requirements J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 366 CHAPTER 13 Device specifics On later silicons this has been corrected This bug applies to all devices with mask 0M33Z from the 100MHz series The J Link software and documentation package comes with a sample project for the Kinetis K40 and K60 devices which is pre configured for the TWR 40 and TWR 60 eval boards and ETM ETB Trace This sample project can be found at Sam ples JLink Projects 13 6
176. M is available 0 ETM is not available Default Writing amounts of 1 KB 0x400 to flash causes J Link to perform a read modify write on the flash Example 1 with default config Flash has 2 1 KB sectors Debugger writes 512 bytes J Link will perform a read modify write on the first sector preserving contents of 512 1023 bytes Second sector is left untouched Example 2 with default config Flash has 2 1 KB sectors Debugger writes 1280 bytes J Link will erase program 1 KB of first sector J Link will erase program 256 bytes of second sector Previous 768 bytes from sec ond sector are lost The default makes sense for flash programming where old contents in remaining space of affected sectors are usually not needed anymore Writes of 1 KB usually mean that the user is performing flash manipulation from within a memory window in a debugger to manipulate the application behavior during runtime e g by writing some constant data used by the application In such cases it is important to pre serve the remaining data in the sector to allow the application to further work cor rectly Syntax SetFlashDLNoRMWThreshold value Example SetFlashDLNoRMWThreshold 0x100 256 Bytes 5 12 1 47SetFlashDLThreshold This command is used to set a minimum amount of data to be downloaded by the flash download feature Syntax SetFlashDLThreshold value Example SetFlashDLThreshold 0x100
177. M08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 437 Chapter 19 Literature and references This chapter lists documents which we think may be useful to gain deeper under standing of technical details J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 438 CHAPTER 19 Literature and references Reference Title Comments Embedded Trace Macrocell ETM Architecture Specification ARM 00143 This document defines the ETM standard including signal protocol and physical interface It is publicly available from ARM www arm com RealView ICE and RealView RVI Trace User Guide ARM DUI 0155C This document describes ARM s realview ice emulator and require ments on the target side It is publicly available from ARM www arm com Table 19 1 Literature and References J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 439 Index A Adaptive clocking 432 Application Program Interface 432 B Big endia e eet eet tesi 432 Cache cleaning 432 CODFOCGOSSOFE ee REEL En rre REOR yeas 432 D Dirty 432 Dynamic Linked Library DLL 432 E Embedded Trace Buffer ETB 415 432 Embedded Trace Macrocell ETM 411 432 EmbeddedICE
178. Most likely reasons a The JTAG cable is defective b The target hardware is defective Remedy Follow the steps described in General procedure on page 427 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 429 17 3 Contacting support Before contacting support make sure you tried to solve your problem by following the steps outlined in section General procedure on page 427 You may also try your J Link J Trace with another PC and if possible with another target system to see if it works there If the device functions correctly the USB setup on the original machine or your target hardware is the source of the problem not J Link J Trace If you need to contact support send the following information to support segger com A detailed description of the problem J Link J Trace serial number Output of JLink exe if available Your findings of the signal analysis Information about your target hardware processor board etc J Link J Trace is sold directly by SEGGER or as OEM product by other vendors We can support only official SEGGER products J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 430 CHAPTER 17 Support and FAQs 17 4 Frequently Asked Questions Q A Q Q A Supported CPUs Which CPUs are supported J Link J Trace should work with any ARM7 9 and Cortex M3 core For a list
179. NXP LPC2148 MCU Memory map 0x00000000 0x0007FFFF On chip flash memory 0x00080000 0x3FFFFFFF Reserved 0x40000000 0x40007FFF On chip SRAM 0x40008000 0x7FCFFFFF Reserved Ox7FD00000 0x7FDO1FFF On chip USB DMA RAM Ox7FD02000 0x7FD02000 Reserved Ox7FFFDO000 0x7FFFFFFF Boot block remapped from on chip flash memory 0x80000000 0xDFFFFFFF Reserved OxE0000000 OxEFFFFFFF VPB peripherals OxF0000000 0xFFFFFFFF AHB peripherals The problematic memory areas are 0x00080000 0x3FFFFFFF Reserved 0x40008000 0x7FCFFFFF Reserved Ox7FD02000 0x7FD02000 Reserved 0x80000000 0xDFFFFFFF Reserved J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 225 To exclude these areas from being accessed through J Link the map exclude com mand should be used as follows map exclude 0x00080000 0x3FFFFFFF map exclude 0x40008000 0x7FCFFFFF map exclude 0x7FD02000 0x7FD02000 map exclude 0x80000000 0xDFFFFFFF 5 12 1 28map illegal This command marks a specified memory region as an illegal memory area All sub sequent memory accesses to this memory region produces a warning message and the memory access is ignored This command can be used to mark more than one memory region as an illegal area by subsequent calls Syntax Map Illegal lt SAddr gt lt EAddr gt Example Map Illegal OxF0000000 OxFFDFFFFF Additional information SAddr has to be a 256 byte aligned address The region size has to be a multiple of 2
180. ODE SetCPUConnectIDCODE 4433221188776655 5 12 1 43SetDbgPowerDownOnClose When using this command the debug unit of the target CPU is powered down when the debug session is closed Note This command works only for Cortex M3 devices Typical applications This feature is useful to reduce the power consumption of the CPU when no debug session is active Syntax SetDbgPowerDownOnClose lt value gt Example 1 Enables debug power down on close 0 Disables debug power down on close SetDbgPowerDownOnClose SetDbgPowerDownOnClose 5 12 1 44SetETBIsPresent This command is used to select if the connected device has an ETB Syntax SetETBIsPresent 0 1 Example SetETBIsPresent 1 ETB is available SetETBIsPresent 0 ETB is not available 5 12 1 45SetETMIsPresent This command is used to select if the connected device has an ETM Syntax SetETMIsPresent 0 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 230 CHAPTER 5 Working with J Link and J Trace Example SetETMIsPresent SetETMIsPresent 5 12 1 46SetFlashDLNoRMWThreshold This command sets the J Link DLL internal threshold when a write to flash memory does not cause a read modify write RMW operation For example when setting this value to 0x800 all writes of amounts of data 2 KB will cause the DLL to perform a read modify write operation on incomplete sectors 1 ET
181. P unsigned int RegIndex unsigned int Data Example JLINK CORESIGHT WriteAP JLINK CORESIGHT REG BD1 0 1 5 11 2 23JLINK_CORESIGHT_WriteDP Description Writes a specific DP register For JTAG makes sure that DP is selected automatically Prototype int JLINK CORESIGHT WriteDP unsigned int RegIndex unsigned int Data Example JLINK CORESIGHT WriteDP JLINK CORESIGHT DP REG ABORT 0 1 5 11 3 Global DLL variables The script file feature also provides some global variables which are used for DLL configuration Some of these variables can only be set to some specific values others can be set to the whole datatype with In the following all global variables and their value ranges are listed and described Note All global variables are treated as unsigned 32 bit values and are zero ini tialized Variable Description R W Pre selects target CPU J Link is communicating with Used in InitTarget to skip the core auto detection of J Link This variable can only be set pui to a known global J Link DLL constant For a list W of all valid values please refer to Global DLL con stants on page 213 Example CPU ARM926EJS Used for JTAG chain configuration Sets the num ber of IR bits of all devices which are closer to JTAG IRPre TDO than the one we want to communicate with R W Example JTAG IRPre 6 Used for JTAG chain configuration Sets the num be
182. PIO Speed 50MHz 413 2004 2015 SEGGER Microcontroller GmbH amp Co KG 414 CHAPTER 15 Background information AR Embedded Workbench IDE SCB gt HFSR UxFFFFFFFF SCB gt DFSR xFFFFFFFF M Function Name Description Input NIC PriorityGroupConfig Configures t and subpriority NIC PriorityGroup specifies the length This parameter can be one of the 4 bits for subpriority XXX Xx x Xxx 3 bits for subpriority NUIC PriorityGroup_2 2 bits for pre emption priority 2 bits for subpriority NUIC PriorituGroup 3 3 bits for pre emption priority 1 bits for subpriority NUIC PriorituGroup 4 4 bits for pre emption priority bits for subpriority Check the parameters assert paran IS NUIG PRIORITY GROUPCNUIC PriorityGroup priorit e priority grouping pre emption priority rouping bits Following values NUIC PriorityGroup 0 bits for pre emption priority NUIC PriorityGroup 1 1 bits for pre emption priority Set the PRIGROUPI18 81 bits FIER d to NUIC PriorityGroup value SCB gt AIRCR AIRCR_UECTKEY_MASK NUIC PriorityGroup Function Nane 108 Description Input NUIC_Init Initializes the NUIC parameters in the InitStruct NUIC InitStruct pointer to a NUIC InitT that contains the configuration informat specified NUIC peripheral None None LE Output Return E pu NUIC_Init lt NUIC_InitTypeDef NUIC_InitStruct g
183. R 2 Reset the core and peripherals by setting the SYSRESETREQ bit in the AIRCR 3 Wait for the s RESET ST bit in the DHCSR to first become high reset active and then low reset no longer active afterwards 4 Clear vC CORERESET 5 8 2 2 Type 1 Core Only the core is reset via the vECTRESET bit The peripherals are not affected After setting the vECTRESET bit J Link waits for the s RESET ST bit in the Debug Halting Control and Status Register DHCSR to first become high and then low afterwards The CPU does not start execution of the program because J Link sets the VC CORERESET bit before reset which causes the CPU to halt before execution of the first instruction Note In most cases it is not recommended to reset the core only since most tar get applications rely of the reset state of some peripherals PLL External memory interface etc and may be confused if they boot up but the peripherals are already configured 5 8 2 3 Type 2 ResetPin J Link pulls its RESET pin low to reset the core and the peripherals This normally causes the CPU RESET pin of the target device to go low as well resulting in a reset of both CPU and peripherals This reset strategy will fail if the RESET pin of the target device is not pulled low The CPU does not start execution of the program because J Link sets the vc CORERESET bit before reset which causes the CPU to halt be
184. RESIGHT SetIndexAHBAPTOUse 2 5 12 1 3 CORESIGHT SetlndexAPBAPToUse This command is used to select a specific APB AP to be used when connected to an ARM Cortex A or Cortex R device Usually it is not necessary to explicitly select an AHB AP to be used as J Link auto detects the AP automatically For multi core sys tems with multiple APB APs it might be necessary The index selected here is an absolute index For example if the connected target provides the following AP layout e AP 0 APB AP e AP 1 AHB AP e AP 2 APB AP e 3 JTAG AP In order to select the second APB AP to be used use 2 as index Syntax CORESIGHT SetIndexAPBAPToUse lt Index gt Example CORESIGHT SetIndexAPBAPTOUse 2 5 12 1 4 device This command selects the target device J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 221 Syntax device DeviceID DeviceID has to be a valid device identifier For a list of all available device identifi ers please refer to chapter Supported devices on page 244 Example device AT91SAM7S256 5 12 1 5 DisableAutoUpdateFW This command is used to disable the automatic firmware update if a new firmware is available Syntax DisableAutoUpdateFW 5 12 1 6 DisableCortexMXPSRAutoCorrectTBit Usually the J Link DLL auto corrects the T bit of the XPSR register to 1 for Cortex M devices This is because having i
185. Related Software Section J Link Commander V4 98 Rev O 150320 NG Sub Section Commands added Chapter Working with J Link and J Trace Section J Link script files updated Chapter Related Software V4 96f Rev 0 150204 Section GDB Server Exit code description added V5 02f Rev 1 151022 NG V5 02f Rev 1 151022 EL V5 02f Rev 0 151007 RH V5 02e Rev O 151001 AG V5 02c Rev 0 150914 RH V5 00 Rev O 150609 V5 00 Rev 0 150520 EL V4 98b Rev 0 150410 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation Chapter RTT added Chapter Related Software V4 96 Rev O 141219 JL Section GDB Server Command line option strict added Command line option timeout added Chapter Related Software V4 90d Rev O 141112 Section J Link Remote Server updated Section J Scope updated Chapter Related Software Section JTAGLoad updated Chapter Working with J Link and J Trace Section Connecting multiple J Links J Traces V4 90b Rev 1 140813 to your PC updated Chapter J Link software Section J Link Configurator updated Chapter Related Software Section J Scope added Chapter Device specifics V4 86 Rev 2 140606 AG Section Silicon Labs EFM32 series devices added Chapter Related Software Section GDB
186. SFRs especially because it writes the SFR only after the complete value has been entered 3 3 Mem oo J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 140 CHAPTER 3 J Link software and documentation package 3 6 J Flash J Flash is an application to program data images to the flash of a target device With J Flash the internal flash of all J Link supported devices can be programmed as well as common external flashes connected to the device Beside flash programming all other flash operations like erase blank check and flash content verification can be done J Flash requires an additional license from SEGGER to enable programming For license keys as well as evaluation licenses got to http www segger com or contact us directly Connection USB Init JTAG speed 30 JTAG speed Auto TAP number not used IR len not used Chip Generic ARM7 ARMS Clock speed don t care Endian Little Check coreld No ARM core Id 00 Use target RAM address 050 RAM size BKB Use DCC mode Yes Manufacturer device selected Device no device selected Size no lected Flash Id no device selected Base address device selected Organization no device selected J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 141 3 7 J L
187. Server Command line options halt nohalt added Description for GDB Server CL version added Chapter Flash download Section Mentor Sourcery CodeBench added Chapter Working with J Link Section Virtual COM Port VCOM improved V4 84 Rev 0 140321 EL Chapter Target interfaces and adapters Section Pinout for SWD Virtual COM Port VCOM added Chapter Related Software Section Command line options Extended command line option speed Chapter J Link software and documentation package Section J Link STR91x Commander Added command line option parameter to specify a customized scan chain Chapter Working with J Link Section Virtual COM Port VCOM added Chapter Setup Section Getting started with J Link and DS 5 Chapter Related Software V4 82 Rev 0 140218 JL Section GDB Server Command line option notimout added Chapter Related Software Section GDB Server Command line options and remote commands added Chapter Related Software Section GDB Server Remote commands and command line options description improved Several corrections V4 90c Rev 0 1140924 JL V4 90b Rev 0 140813 NG V4 86 Rev 1 1140527 JL V4 86 Rev 0 140519 AG V4 82 Rev 1 140228 EL V4 80f Rev 0 140204 JL JL V4 80 Rev 1 131219 NG J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision
188. Syntax DisablePowerSupplyOnClose 5 12 1 13EnableAutoUpdateFW This command is used to enable the automatic firmware update if a new firmware is available Syntax EnableAutoUpdateFW 5 12 1 14EnableEraseAllFlashBanks Used to enable erasing of other flash banks than the internal like Q SPI flash or CFI flash Syntax EnableEraseAllFlashBanks 5 12 1 15EnableFlashBPs This command enables the FlashBP feature Syntax EnableFlashBPs 5 12 1 16EnableFlashDL This command enables the J Link ARM FlashDL feature Syntax EnableFlashDL 5 12 1 17EnablelnfoWinFlashBPs This command is used to enable the flash download window for the flash breakpoint feature Enabled by default Syntax EnablelInfoWinFlashBPs 5 12 1 18EnablelnfoWinFlashDL This command is used to enable the flash download information window for the flash download feature Syntax EnableInfoWinFlashDL J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 223 5 12 1 19EnableMOEHandling The J Link DLL outputs additional information about mode of entry MOE in case the target CPU halted entered debug mode Disabled by default Additional information is output via log callback set with JLINK_OpenEx JLINK_LOG pfLog JLINK LOG pfErrorOut Syntax EnableMOEHandling 5 12 1 20EnableRemarks The J link DLL provides more detailed output d
189. TT MODE BLOCK IF FIFO FULL Additional information Once a channel is configured only the flags of the channel should be changed 12 4 1 3 SEGGER RTT GetKey Description Reads one character from SEGGER RTT buffer O Host has previously stored data there Prototype int SEGGER RTT GetKey void Return value lt 0 No character available empty buffer gt 0 Character which has been read 0 255 Example int c SEGGER RTT GetKey if c exit J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 346 CHAPTER 12 RTT 12 4 1 4 SEGGER_RTT _HasKey Description Checks if at least one character for reading is available in SEGGER RTT buffer 0 Prototype int SEGGER_RTT_HasKey void Return value 0 No characters are available to be read 1 At least one character is available in the buffer Example if SEGGER RTT HasKey int c SEGGER RTT GetKey 12 4 1 5 SEGGER_RTT_Init Description Initializes the RTT Control Block Prototype void SEGGER_RTT_Init void Additional information Should be used in RAM targets at start of the application 12 4 1 6 SEGGER_RTT_printf Description Send a formatted string to the host Prototype int SEGGER_RTT_printf unsigned BufferIndex const char sFormat Parameters Parameter Meaning BufferIndex Index of the up channel to sent the
190. Te REA x E rene en ARR EP TNR E REIR 278 10 2 Licensing exei teer 279 10 2 1 IMNEFOGUGH ON hee EE LER DAE 279 10 3 Getting Started Renee elevate v 280 10 3 1 Setup uses i RR eRERR RE RERRTIR RID NER RINR RA NIA RENDER 280 10 3 2 Using J Flash SPI for the first time ss 280 10 3 3 MENU str ctute dite nato esie eee 281 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 10 4 Io 285 10 4 1 Project Settinigs n etui die ove DA es 285 10 4 2 Global Settings o uen 287 10 5 Command Line Interface amena anna rennen nnn 289 10 5 1 OVERVIEW e turre LE FEEYRE CE esas 289 10 5 2 Command line 4 2 66 289 10 5 3 Batch processing 2 o sex FAX ERR EX EU vel UNE ERA FERE sited E ELE ali 291 10 5 4 Programming multiple targets in parallel 291 10 6 Create a new J Flash SPI project 10 m emnes 293 10 6 1 Creating a new J Flash SPI project 293 10 6 2 Serial number programming 294 10 6 3 Send custom commands 294 10 7 Device Specifies pein rns ean rara retra peru tn beeen IER Eritre
191. UN eU TREE Tera ie ar eva o 386 13 17 3 OMAP4430 o erede d er t V e ee c E c 386 19 17 4 OMAP E138 esos evens sente ren mme een menti eee AEN canes 386 13 17 5 TMS470M ss esten e tw cem v xe Ra y vae cer LR Va y WEN esta VERE EET 386 13 176 VOMAPSS30 rien Me ARR RU de su Re 387 13 17 7 ux vere xe x ab ne en E RR et X ERE whet ven nues 387 13 18 Toshiba esee etr edi ie E Pee ans EATER TN ERES 388 14 Target interfaces and adapters nnns 389 14 1 20 pin J Link connector nennen mnm nnne nennen nn nnn nnn 390 14 1 1 PilioUut for JTAG aane Sera ENDE ND UE EL ae oL 390 14 1 2 PINOUEFOR PEE 393 14 1 3 Pinout for SWD Virtual COM Port 2 395 14 1 4 4 ey deg Oita pen reta A PER lands E Ee RIEN I ERREUR 396 14 2 38 Mictor JTAG and Trace 4 397 14 2 1 Connecting the target board 8008 397 14 2 2 PINOUT o eee rV ca EDAM 398 14 2 3 Assignment of trace information pins between ETM architecture versions 400 14 2 4 Trace signals ee mex Phe rec Per lees erre e ER RUPEE E 400 14 3 19 pin JTAG SWD and Trace
192. V lt Vir lt 3 6V LOW level output voltage VoL with a lt 10 of V load of 10 kOhm OL 0 OT VIF HIGH level output voltage Von with V gt 90 of V load of 10 kOhm Sn For 3 6 lt Vie lt 5V LOW level output voltage with a VoL lt 20 of V load of 10 kOhm OL 0 OT VIF HIGH level output voltage Von with a V gt 80 of V load of 10 kOhm SH ubt JTAG SWD Interface Timing SWO sampling frequency Max 100 MHz Data input rise time Trai lt 20ns Data input fall time Trai lt 20ns Data output rise time Trgo Trdo lt 10ns Data output fall time Trao Trao lt 10ns Clock rise time Tre lt 3ns Clock fall time lt 3ns Analog power measurement interface Sampling frequency 50 kHz Resolution 1 mA Table 1 5 J link ULTRA specifications 1 3 4 3 Hardware versions Version 1 1 Compatible to J Link e Initial design based on ATMEL SAM3U without FPGA Version 4 e New design based on STM32F407 FPGA Cyclone IV Version 4 3 Identical to version 4 with the following exception Pin 1 VTref is used for measuring target reference voltage only Buffers on J Link side are no longer powered through this pin but via the J Link internal voltage sup plied via USB J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 43 Hardware version 1 1
193. a separate J Link IAR J Link does not sup port kickstart power Licenses No licenses are included All licenses can be added 2 5 5 AR J Link Lite IAR J Link Lite is an OEM version of J Link sold by IAR Limitations IAR J Link Lite cannot be used with Keil MDK This limitation can NOT be lifted if you would like to use J Link with Keil MDK you need to buy a separate J Link JTAG speed is limited to 4 MHz Licenses No licenses are included All licenses can be added Note IAR J Link is only delivered and supported as part of Starter Kits It is not sold to end customer directly and not guaranteed to work with custom hardware J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 78 CHAPTER 2 Licensing 2 5 6 J Trace IAR J Trace is OEM version of J Trace sold by IAR Limitations IAR J Trace cannot be used with Keil MDK This limitation can NOT be lifted if you would like to use J Trace with Keil MDK you need to buy a separate J Trace Licenses No licenses are included All licenses can be added 2 5 7 J Link Lite LPC Edition J Link Lite LPC Edition is an OEM version of J Link sold by NXP Limitations J Link Lite LPC Edition only works with NXP devices This limita tion can NOT be lifted if you would like to use J Link with a device from an other manufacturer you need to buy a separate J Link Licenses No licenses are included 2 5
194. a tte 296 10 7 1 SPI flashes with multiple erase commands 296 10 8 Target systems eor dx er erant ida xa e xau ua a nar Ra xau ada nd nara 297 10 8 1 Which flash devices can be programmed 297 10 9 MR ES 298 10 9 1 Performance values eere a xg rx ister E XR 298 10 10 Background information ccrte une i ire e yea Fe XE rer anim e ce CERA E Rada 299 10 10 1 SPI interface connection sea areae 299 10 11 Wu 300 10 11 1 Troubleshooting n er terr e oc a e gets pl apa ee este 300 1012 2 Contacting SUpbOrt evene ERE UTP eR CERRO oT Exe REN ees 300 TM BB diat li era Cei ob ab ta ctor a boe bn Cuba AR 301 11 1 Introduction eei e eer eh Pax ved RO ERE Kb E ead RE me DER e m E B n 302 11 1 1 pee 302 11 2 c 303 11 3 Setup for various debuggers 0 304 11 3 1 Embedded Workbench 6 304 11 3 2 ARM ARM Developer Suite 5 7 01 6 307 11 3 3 ARM RVDS RealView developer suite ss 309 11 3 4 GHS MULETE desde Rr a ete mere le bn a VOY Leva da 314 11 3 5 KEIL MDK iVision IDE niue teen n mni een
195. ace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 162 CHAPTER 4 Setup 4 3 Setting up the IP interface Some emulators of the J Link family have or future members will have an additional Ethernet interface to communicate with the host system These emulators will also come with a built in web server which allows configuration of the emulator via web interface In addition to that you can set a default gateway for the emulator which allows using it even in large intranets For simplicity the setup process of J Link Pro referred to as J Link is described in this section 4 3 1 Configuring J Link using J Link Configurator The J Link software and documentation package comes with a free GUI based utility called J Link Configurator which auto detects all J Links that are connected to the host PC via USB amp Ethernet The J Link Configurator allows the user to setup the IP interface of J Link For more information about how to use the J Link Configurator please refer to J Link Configurator on page 165 4 3 2 Configuring J Link using the webinterface All emulators of the J Link family which come with an Ethernet interface also come with a built in web server which provides a web interface for configuration This enables the user to configure J Link without additional tools just with a simple web browser The Home page of the web interface shows the serial number the current IP address and the MAC address of the J Link
196. ach tab Terminal O Terminal 15 displays the output which has been sent to this Terminal The Terminal tabs interpret and display Text Control Codes as sent by the application to show colored text or erase the screen By default if the RTT application does not set a Terminal Id the output is displayed in Terminal O The Teminal O tab can additionally display the user input Check Input gt Echo input gt Echo to Terminal 0 Each Terminal tab can be shown or hidden via the menu Terminals Terminals or their respective shortcuts as described below 12 3 1 4 Sending Input RTT Viewer supports sending user input to RTT Down Channel 0 which can be read by the target application with RTT GetKey and SEGGER RTT Read Input can be entered in the text box below the Teminal Tabs RTT Viewer can be configured to directly send each character while typing or buffer it until Enter is pressed Menu Input Sending In stand alone mode RTT Viewer can retry to send input in case the target input buffer is full until all data could be sent to the target via Input gt Sending gt Block if FIFO full Sending input Please Wait 43 of 69 Bytes sent to target 12 3 1 5 Logging Data Additionally to displaying output of Channel 0 RTT Viewer can log data which is sent on RTT Channel 1 into a file This can for example be used to sent instrumentalized event tracing data The data log file co
197. ack heap or top of memory defined using defaults Connected Target is ARM Vehicle ARM MultiP RDI vl 51 via DLL Mode Little Endian J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 314 CHAPTER 11 RDI 10 A project or an image is needed for debugging After downloading J Link is used to debug the target 2 RYDEBUG Start_STR71x ARM_0 ARM A RR while 1 LED_ToggleLED1 0000C580 0000 588 08 Delay 200 00000150 00001F60 D 0000B63C 00001 50 00000000 00000000 00000000 00000000 00002890 00000000 00000515 0000 5 0 00001 85 00000514 CPSR 000000 3 05 IncDI Initially disable interrupts 05 InitKern initialize 05 05 InitHW initialize Hardware for 0 LED Init initialize LED ports You need to create at least one task here 05 CREATETASK amp TCBO HP Task Task0 100 Stack0 05 CREATETASK amp TCBl LP Task Taskl 50 Stackl NS Sra 4 s IS RAC ace E 0 59 018 0 59 018 Instr MAIN LED 35 0 xESSFFOl8 OxE1A00000 0 59 014 0 59 014 x 0 00002584 0 0000003 0 00000040 0 00000044 0 00000048 0x000023D0 0 0000004 OxEAFFFFFE OxEAFFFFFE OxEAFFFFFE OxEAFFFFFE OxEAFFFFFE 0 000000 0 0007 0 28 028 0 89 0 00 gt bi MAIN_LED 35 0 gt go Stopped at 0 00000514 due to SW Instruction Breakpoint Stopped at 0
198. activated by default Typical applications This feature is useful for some eval boards that can be powered over the JTAG con nector Syntax SupplyPowerDefault 0 1 Example SupplyPowerDefault 1 5 12 1 65SuppressControlPanel Using this command ensures that the control panel will not pop up automatically Syntax SuppressControlPanel 5 12 1 66SuppressinfoUpdateFW After using this command information about available firmware updates will be sup pressed Note We strongly recommend not to use this command latest firmware ver sions should always be used Syntax SuppressInfoUpdateFW 5 12 1 67SWOSetConversionMode This command is used to set the SWO conversion mode J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 235 Syntax SWOSetConversionMode lt ConversionMode gt Conversion mode Description 0 If only n is received make it r n to make the line end Windows compliant Default behavior 1 Leave everything as it is do not add any characters Example SWOSetConversionMode 0 5 12 2 Using command strings 5 12 2 1 J Link Commander The J Link command strings can be tested with the J Link Commander Use the com mand exec supplemented by one of the command strings 2 J Link ARM 3 58c oy x SEGGER J Link Commander U3 58c for help Compiled Jan 12 2007 12 54 38 DLL version U3 58c compiled Jan 12 2007 12 54 35
199. age Syntax rx lt DelayAfterReset gt Parameter Meaning DelayAfter Delay in ms Reset Example rx 10 3 2 1 35 savebin Saves target memory into binary file Syntax savebin lt Filename gt lt Addr gt lt NumBytes gt hex Parameter Meaning Filename Destination file Addr Source address NumBytes Number of bytes to read Example savebin C Work test bin 0x0000000 0x100 3 2 1 36 setBP This command sets a breakpoint of a specific type at a specified address Which breakpoint modes are available depends on the CPU that is used Syntax setBP lt Addr gt A T W H S H Parameter Meaning Addr Address to be breakpointed Only for ARM7 9 11 and Cortex R4 devices A T A ARM mode T THUMB mode Only for MIPS devices W H W MIPS32 mode Word H MIPS16 mode Half word c S Force software BP H Force hardware BP Example SetBP 0x8000036 3 2 1 37 setPC Sets the PC to the specified value J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 95 Syntax setpc lt Addr gt Parameter Meaning Addr Address the PC should be set to Example setpc 0x59C 3 2 1 38 setWP This command inserts a new watchpoint that matches the specified parameters The enable bit for the watchpoint as well as the data access bit of the watchpoint unit are set automatically by this command Moreover the bits
200. al 15 TRACEPKT 10 TRACEPKT 10 TRACEDATA 10 Trace signal 16 TRACEPKT 11 TRACEPKT 11 TRACEDATA 11 Trace signal 17 TRACEPKT 12 TRACEPKT 12 TRACEDATA 12 Trace signal 18 TRACEPKT 13 TRACEPKT 13 TRACEDATA 13 Trace signal 19 TRACEPKT 14 TRACEPKT 14 TRACEDATA 14 Trace signal 20 TRACEPKT 15 TRACEPKT 15 TRACEDATA 15 Table 14 8 Assignment of trace information pins between ETM architecture versions 14 2 4 Trace signals Data transfer is synchronized by TRACECLK 14 2 4 1 Signal levels The maximum capacitance presented by J Trace at the trace port connector including the connector and interfacing logic is less than 6pF The trace port lines have a matched impedance of 50 The J Trace unit will operate with a target board that has a supply voltage range of 3 0V 3 6V 14 2 4 2 Clock frequency For capturing trace port signals synchronous to TRACECLK J Trace supports a TRACECLK frequency of up to 200MHz The following table shows the TRACECLK fre quencies and the setup and hold timing of the trace signals with respect to TRACE CLK Parameter Min Max Explanation Tperiod 5ns 1000ns Clock period Fmax 1MHz 200MHz Maximum trace frequency Tch 2 5ns High pulse width Tcl 2 5ns a Low pulse width Tsh 2 5ns E Data setup high Table 14 9 Clock frequency J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 401 Parameter Min Max
201. al 5 Assignment of trace information pins between ETM archi 31 Trace signal 16 tecture versions on page 400 32 Trace signal 4 33 Trace signal 15 34 Trace signal 3 35 Trace signal 14 36 Trace signal 2 37 signal 13 38 Trace signal 1 Table 14 7 JTAG Trace connector pinout J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 400 CHAPTER 14 Target interfaces and adapters 14 2 3 Assignment of trace information pins between ETM architecture versions The following table show different names for the trace signals depending on the ETM architecture version Trace signal ETMv1 ETMv2 ETMv3 Trace signal 1 PIPESTAT 0 PIPESTAT 0 TRACEDATA O Trace signal 2 PIPESTAT 1 PIPESTAT 1 TRACECTL Trace signal 3 PIPESTAT 2 PIPESTAT 2 Logic 1 Trace signal 4 TRACESYNC PIPESTAT 3 Logic O Trace signal 5 TRACEPKT 0 TRACEPKT 0 Logic O Trace signal 6 TRACEPKT 1 TRACEPKT 1 TRACEDATA 1 Trace signal 7 TRACEPKT 2 TRACEPKT 2 TRACEDATA 2 Trace signal 8 TRACEPKT 3 TRACEPKT 3 TRACEDATA 3 Trace signal 9 TRACEPKT 4 TRACEPKT 4 TRACEDATA 4 Trace signal 10 TRACEPKT 5 TRACEPKT 5 TRACEDATA 5 Trace signal 11 TRACEPKT 6 TRACEPKT 6 TRACEDATA 6 Trace signal 12 TRACEPKT 7 TRACEPKT 7 TRACEDATA 7 Trace signal 13 TRACEPKT 8 TRACEPKT 8 TRACEDATA 8 Trace signal 14 TRACEPKT 9 TRACEPKT 9 TRACEDATA 9 Trace sign
202. al behavior is implemen tation defined and differs from device to device The following cases are the most common ones 1 The device provides specific special function registers for debugging to keep some clocks running necessary for debugging while the device is in a low power mode 2 The device wakes up automatically as soon as there is a request by the debug probe on the debug interface 3 The device powers off the debug interface partially allowing the debug probe to read access certain parts but does not allow to control the CPU 4 The device powers off the debug interface completely and the debug probe loses the connection to the device temporarily While cases 1 3 are the most convenient ones from the debug perspective because the low power mode is transparent to the end user they do not provide a real world scenario because certain things cannot be really tested if certain clocks are still active which would not be in the release configuration with no debug probe attached In addition to that the power consumption is significantly higher than in the release config which may cause problems on some hardware designs which are specifically designed for very low power consumption The last case debug probes temporarily loses connection usually causes the end of a debug session because the debugger would get errors on accesses like check if CPU is halted hit a BP To avoid this there is a special setting for J Link that can be a
203. al number the target proces sor s core ID the J Link J Trace is working properly and cannot be the cause of your problem 14 If the problem persists and you own an original product not an OEM version see section Contacting support on page 429 DURWN 17 2 2 Typical problem scenarios J Link J Trace LED is off Meaning The USB connection does not work Remedy Check the USB connection Try to re initialize J Link J Trace by disconnecting and reconnecting it Make sure that the connectors are firmly attached Check the cable connections on your J Link J Trace and the host computer If this does not solve the problem check if your cable is defective If the USB cable is ok try a different host computer J Link J Trace LED is flashing at a high frequency Meaning J Link J Trace could not be enumerated by the USB controller Most likely reasons a Another program is already using J Link J Trace b The J Link USB driver does not work correctly Remedy a Close all running applications and try to reinitialize J Link J Trace by disconnect ing and reconnecting it b If the LED blinks permanently check the correct installation of the J Link USB driver Deinstall and reinstall the driver as shown in chapter Setup on page 155 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 428 CHAPTER 17 Support and FAQs J Link J Trace does not get any connection to the target
204. alue assigned to reset pin reflects the state 0 Low 1 high JTAG_ResetPin Example W JTAG ResetPin 0 SYS Sleep 5 Give pin some time to get low JTAG ResetPin 1 Pulls reset pin low Releases nTRST pin Used to issue a reset of the debug logic of the CPU Value assigned to reset pin reflects the state 0 Low JTAG TRSTPin 1 high W Example JTAG_TRSTPin 0 SYS_Sleep 5 Give pin some time to get low JTAG_TRSTPin 1 Pulls TCK pin LOW HIGH Value assigned to JTAG TCKPin reset pin reflects the state 0 LOW 1 HIGH R W Example JTAG TCKPin 0 Pulls TDI pin LOW HIGH Value assigned to JTAG TDIPin reset pin reflects the state 0 LOW 1 HIGH R W Example JTAG TDIPin 0 Pulls TMS pin LOW HIGH Value assigned to JTAG TMSPin reset pin reflects the state 0 LOW 1 HIGH R W Table 5 11 Global DLL variables J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 212 CHAPTER 5 Working with J Link and J Trace Variable Description R W If the connected device has an ETB and you want to use it with J Link this variable should be set to 1 Setting this variable in another function as InitEmu does not have any effect W Example void InitEmu void EMU ETB IsPresent 1 EMU ETB IsPresent Uses ETB instead of RAWTRACE capability of the emulator Setting this variable in another func EMU_ETB_UseETB tion aS InitEmu does not have
205. am is located in RAM In these cases the J Link software cannot determine the breakpoints set and the list is empty Section Data In this section all data breakpoints which are listed in the DLL internal breakpoint list are shown Handle Shows the handle of the data breakpoint Address Shows the address where the data breakpoint is set AddrMask Specifies which bits of Address are disregarded during the compari son for a data breakpoint match A 1 in the mask means disregard this bit Data Shows on which data to be monitored at the address where the data breakpoint is set Data Mask Specifies which bits of Data are disregarded during the comparison for a data breakpoint match A 1 in the mask means disregard this bit Ctrl Specifies the access type of the data breakpoint read write CtriMask Specifies which bits of Ctrl are disregarded during the comparison for a data breakpoint match 5 7 1 4 Log In this section the log output of the DLL is shown The user can determine which function calls should be shown in the log window J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 195 Available function calls to log Register read write Memory read write set clear breakpoint step go halt is halted EEE m 5 7 1 5 CPU Regs In this section the name and the value of the CPU registers are shown 13 J Link ARM 0 00100 8 0x00000000 5 7 1 6 Target Power In t
206. an not find xxx device return 1 j JTAG DRPre 0 Cortex A8 is closest to TDO no no pre devices JTAG DRPost 1 1 device custom device comes after the Cortex A8 JTAG IRPre 0 Cortex A8 is closest to no no pre IR bits JTAG IRPost 5 custom device after Cortex A8 has 5 bits IR len JTAG IRLen 4 We selected the Cortex A8 it has 4 bits IRLen CPU CORTEX A8 We are connected to a Cortex A8 JTAG AllowTAPReset 1 We are allowed to enter JTAG TAP reset We have a non CoreSight compliant Cortex A8 here which does not allow auto detection of the Core debug components base address so set it manually to overwrite the DLL auto detection CORESIGHT_CoreBaseAddr 0x80030000 5 11 7 Executing J Link script files 5 11 7 1 In J Link commander When J Link commander is started it searches for a script file called Default JLinkScript in the folder wich contains the JLink exe and the J Link DLL by default the installation folder e g C Program Files GEGGER JLinkKARM_V456 If this file is found it is executed instead of the standard auto detection of J Link If this file is not present J Link commander behaves as before and the normal auto detection is performed 5 11 7 2 In Keil MDK ARM Keil MDK ARM does not provide any native support for J Link script files so usage of them cannot be configured from within the GUI of the IDE itself Anyhow it is possi ble to us
207. an overview about the specifications general mechanical electrical for J Link PLUS General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 27 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 20 C 65 C Relative humidity non condensing Max 90 rH Mechanical Size without cables 100mm x 53mm x 27mm Weight without cables 70g Available interfaces USB interface USB 2 0 full speed JTAG 20 pin Target interface 14 pin adapter available JTAG SWD Interface Electrical Power supply USB powered Max 50mA Target Supply current Target interface voltage Vir 1 2V 5V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300mA Reset Type Open drain Can be pulled low or tristated Table 1 3 J Link specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 37 Reset low level output voltage VoL lt 10 of Vig For the whole target voltage range 1 2V lt Vip lt 5V LOW level input voltage lt 40 of VIF HIGH level input voltage Vin gt 60 of VIF For 1 8V lt Vir lt 3 6V LOW level output voltage with a load of 10 kOhm VoL lt 10 of Vir
208. and writes the value to the given address Otherwise this command reads from the given address J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 113 Example Read gt monitor memU8 0x50000000 lt Reading from address 0x50000000 Data 0x04 Write gt monitor memU8 0x50000000 OxFF lt Writing OxFF address 0x50000000 3 3 3 13 memU16 Syntax memU16 lt address gt lt value gt Description Reads or writes a halfword from to a given address If lt value gt is specified this com mand writes the value to the given address Otherwise this command reads from the given address Example Read gt monitor memU16 0x50000000 lt Reading from address 0x50000000 Data 0x3004 Write gt monitor memU16 0x50000000 OxFFO00 lt Writing OxFF00 8 address 0x50000000 3 3 3 14 memU32 Syntax MemU32 address value Description Reads or writes a word from to a given address If value is specified this com mand writes the value to the given address Otherwise this command reads from the given address This command is similar to the long command Example Read gt monitor memU32 0x50000000 lt Reading from address 0x50000000 Data 0x10023004 Write gt monitor memU32 0x50000000 0x10023004 lt Writing 0x10023004 address 0x50000000 3 3 3 15 reg Syntax reg lt RegName gt lt value gt or reg RegName lt address gt De
209. andLineOptions gt Command Line Options When using GDB Server CL at least the mandatory command line options have to be given Additional command line options can be given to change the default behavior of GDB Server For more information about the available command line options please refer to Com mand line options on page 123 3 3 23 GDB Server user interface The J Link GDB Server s user interface shows information about the debugging pro cess and the target and allows to configure some settings during execution SEGGER J Link GDB Server V4 74 e File Help Localhost only GDB waiting for connection Initial SWD speed 4000 kHz Stay on top n Show log window J Link Connected i Current SWD speed 4000 kHz Generate logfile z Cache reads CPU 5 32 41 3 30 a Little endian Verify download Init regs on start 0 Bytes downloaded 1 JTAG device It shows following information The IP address of host running debugger Connection status of J Link Information about the target core Measured target voltage Bytes that have been downloaded Status of target Log output of the GDB Server optional if Show log window is checked Initial and current target interface speed Target endianess These configurations can be made from inside GDB Server Localhost only If checked only connections from 127 0 0 1 are accepted Stay on top Show log wind
210. andling of ARMO9 COreS ss 238 5 15 Virtual COM Port VCOM mnn hene annee nnn nnn nnn 239 5 15 1 Configuring Virtual COM Port 239 etas downlOB sen nantes prendre 241 6 1 IttkOdliction uere a xe e ne xr heaven eevee rw xe e CR V e te a DG e Ba 242 6 2 eii oM 243 6 3 Supported devices e eedem ea dine oy ted ve ee v c aw iv Dei al ONE E Va 244 6 4 Setup for various debuggers internal 245 6 4 1 TAR Embedded emen mne 245 6 4 2 Bu GET 245 6 4 3 Mentor Sourcery CodeBench 4 4 6 66 6 nnn nnn nnn 248 6 4 4 J Link GDB SEV eP P EP 248 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 20 6 4 5 J LIN kK Commande sspe EE ETE DEL LIT 249 6 4 6 BEN Mp 250 6 5 Setup for various debuggers CFI flash 0 2 44 0 4 2 0424 0 251 6 5 1 Embedded Workbench mnn nnn 251 6 5 2 J GDB Serve icere LET 252 6 5 3 J LinkK commande tirsir oec reete wv kx ER X FR CHER ORE 252 6 6 Setup for various debuggers SPIFI flash 253 6 7 QSPI flash support oe eve ai e bre ik rey ev vir Ex kw X YR evar EXTRAS 254 6 7 1 Setup the DLL for QSPI flash download
211. anel 7 4 2 Compatibility with various debuggers Flash breakpoints can be used in all debugger which use the proper J Link API to set breakpoints Compatible debuggers debug interfaces are IAR Embedded Workbench Keil MDK GDB based debuggers Freescale Codewarrior Mentor Graphics Sourcery CodeBench RDI compliant debuggers Incompatible debuggers debug interfaces e Rowley Crossworks J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 262 CHAPTER 7 Flash breakpoints 7 5 Flash Breakpoints QSPI flash Many modern CPUs allow direct execution from QSPI flash in a so called QSPI area in their memory map This feature is called execute in place XIP On some cores like Cortex M where hardware breakpoints are only available in a certain address range sometimes J Link flash breakpoints are the only possibility to set breakpoints when debugging code running in QSPI flash 7 5 1 Setup The setup for the debugger is the same as for downloading into QSPI flash For more information please refer to QSPI flash support on page 254 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 263 7 6 FAQ Why can flash breakpoints not be used with Rowley Crossworks A Because Rowley Crossworks does not use the proper J Link API to set breakpoints Instead of using the breakpoint API Crossworks programs the debug hardware directly leaving J Link no cho
212. any effect R Example EMU_ETB_UseETB 0 Selects whether an ETM is present on the target or not Setting this variable in another function EMU ETM IsPresent as InitEmu does not have any effect R W Example EMU ETM IsPresent 0 Uses ETM as trace source Setting this variable in another function as InitEmu does not have any EMU ETM UseETM effect W Example EMU ETM USeETM 1 Disables use of hardware units for JTAG trans missions since this can cause problems on some hardware designs W Example EMU JTAG DisableHWTransmissions 1 Sets base address of core debug component for CoreSight compliant devices Setting this vari able disables the J Link auto detection of the core debug component base address Used on CORESIGHT CoreBaseAddr devices where auto detection of the core debug component base address is not possible due to incorrect CoreSight information Example CORESIGHT CoreBaseAddr 0x80030000 Pre selects an AP as an AHB AP that J Link uses for debug communication Cortex M Setting this variable is necessary for example when debugging multi core devices where multiple AHB APs are present one for each device This function can only be used if a AP layout has been configured via JLINK CORESIGHT AddAP CORESIGHT Example W IndexAHBAPToUse JLINK_CORESIGHT_AddAP 0 CORESIGHT_AHB_AP JLINK CORESIGHT AddAP 1 CORESIGHT AHB AP JLINK CORESIGHT AddAP 2 CORESIGHT APB AP Use second AP as AHB AP
213. are Older J Links may not be able to supply power on this 19 Output pin For more information about how to enable disable the ply power supply please refer to Target power supply on page 394 Table 14 3 J Link J Trace SWD pinout Pins 4 6 8 10 12 14 16 18 20 are GND pins connected to GND in J Link They should also be connected to GND in the target system J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 394 CHAPTER 14 Target interfaces and adapters 14 1 2 1 Target board design We strongly advise following the recommendations given by the chip manufacturer These recommendations are normally in line with the recommendations given in the table Pinout for SWD on page 393 In case of doubt you should follow the recommen dations given by the semiconductor manufacturer Typical target connection for SWD JTAG connector Target board 5V supply Voltage Optional to supply the target board from J Link 14 1 2 2 Pull up pull down resistors A pull up resistor is required on SWDIO on the target board ARM recommends 100 kOhms In case of doubt you should follow the recommendations given by the semiconductor manufacturer 14 1 2 3 Target power supply Pin 19 of the connector can be used to supply power to the target hardware Supply voltage is 5V max current is 300mA The output current is monitored and protected against overload and short circuit Power can be
214. arget device is actually an LPC 2xxx and have a device based license 3 10 1 Flash download and flash breakpoints Flash download and flash breakpoints are supported by J Link RDI For more infor mation about flash download and flash breakpoints please refer to J Link RDI User s Guide UM08004 chapter Flash download and chapter Breakpoints in flash memory J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 150 CHAPTER 3 J Link software and documentation package 3 11 Processor specific tools The J Link software and documentation package includes some tools which support processor specific functionalities like unlocking a device 3 11 1 J Link STR91x Commander Command line tool J Link STR91x Commander JLinkSTR91x exe is a tool that can be used to configure STR91x cores It permits some STR9 specific commands like Set the configuration register to boot from bank or 1 Erase flash sectors Read and write the OTP sector of the flash Write protect single flash sectors by setting the sector protection bits Prevent flash from communicate via JTAG by setting the security bit All of the actions performed by the commands excluding writing the OTP sector and erasing the flash can be undone This tool can be used to erase the flash of the con troller even if a program is in flash which causes the CPU core to stall ork JLinkARM OutputDebug JLinkSTR91x exe e of the primary flash manually Sy
215. as flash download flash breakpoints and instruction set simulation The J Link control panel window can be accessed via the J Link tray icon in the tray icon list This icon is available when the debug session is started 13 35 To open the status window simply click on the tray icon 12 J Link ARM Ic fx Settings Break watch Log CPU Regs Target Power Swv Show tray icon Iv Start minimized Always on top Process JESTooNCMARVARM_V520_beta902 common bin larld J Link J Link ARM 0 5 00 7 i Target interface TAG Adaptive Endian 327 I Device Jatstsam7s256 License About 5 7 1 Tabs The J Link status window supports different features which are grouped in tabs The organization of each tab and the functionality which is behind these groups will be explained in this section 5 7 1 1 General In the General section general information about J Link and the target hardware are shown Moreover the following general settings can be configured e Show tray icon If this checkbox is disabled the tray icon will not show from the next time the DLL is loaded e Start minimized If this checkbox is disabled the J Link status window will show up automatically each time the DLL is loaded e Always on top if this checkbox is enabled the J Link status window is always visible even if other windows will be opened The general information about target hardware and J Link w
216. at the reset strate gies which rely on the reset pin low pulse on reset do not work per default For this reason a special reset strategy has been made available It is recommended to use this reset strategy This special reset strategy resets the peripherals by writing to the RSTC_CR register Resetting the peripherals puts all peripherals in the defined reset state This includes memory mapping register which means that after reset flash is mapped to address O It is also possible to achieve the same effect by writing 0x4 to the RSTC CR register located at address Oxfffffd00 This information is applicable to the following devices AT91SAM7S all devices AT91SAM7SE all devices AT91SAM7X all devices AT91SAM7XC all devices AT91SAM7A all devices 13 2 1 2 Memory mapping Either flash or RAM can be mapped to address O After reset flash is mapped to address 0 In order to majlink supported devices html RAM to address 0 a 1 can be written to the RSTC CR register Unfortunately this remap register is a toggle regis ter which switches between RAM and flash every time bit zero is written In order to achieve a defined mapping there are two options 1 Use the software reset described above 2 Test if RAM is located at 0 using multiple read write operations and testing the results Clearly 1 is the easiest solution and is recommended This information is applicable to the following devices AT91SAM7S all devices AT91S
217. ated 30 071211 AG Chapter Device specifics Section Analog Devices updated Section ATMEL updated Section Freescale added Section Luminary Micro added Section NXP updated Section OKI added Section ST Microelectronics updated Section Texas Instruments updated Chapter Related software Section J Link STR91x Commander updated 29 070912 SK Chapter Hardware section Target board design updated 28 070912 SK Chapter Related software Section J LinkSTR91x Commander added Chapter Device specifics Section ST Microelectronics added Section Texas Instruments added Subsection AT91SAM9 added 28 070912 AG Chapter Working with J Link J Trace Section Command strings updated 27 070827 TQ Chapter Working with J Link J Trace Section Command strings updated 26 070710 SK Chapter Introduction Section Features of J Link updated Chapter Background Information Section Embedded Trace Macrocell added Section Embedded Trace Buffer added 25 070516 SK Chapter Working with J Link J Trace Section Reset strategies in detail Software for Analog Devices ADuC7xxx MCUs updated Software for ATMEL AT91SAM7 MCUs added Chapter Device specifics Section Analog Devices added Section ATMEL added 24 070323 SK Chapter Setup Uninstalling the J Link driver updated Sup
218. aximum JTAG speed The maximum JTAG speed of all cores in the same chain is the minimum of the maximum JTAG speeds For example e Core 1 e Core 2 2MHz maximum JTAG speed 4MHz maximum JTAG speed e Scan chain 2MHz maximum JTAG speed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 188 CHAPTER 5 Working with J Link and J Trace 5 5 3 2 Resetting the target All cores share the same RESET line You should be aware that resetting one core through the RESET line means resetting all cores which have their RESET pins con nected to the RESET line on the target J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 189 5 6 Connecting multiple J Links J Traces to your PC In general it is possible to have an unlimited number of J Links J Traces connected to the same PC Current J Link models are already factory configured to be used ina multi J Link environment older J Links can be re configured to use them in a multi J link environment 5 6 1 How does it work USB devices are identified by the OS by their product ID vendor id and serial num ber The serial number reported by current J Links is a unique number which allows to have an almost unlimited number of J Links connected to the same host at the same time In order to connect to the correct J Link the user has to make sure that the correct J Link is selected by SN or IP In cases where no specific
219. be guaranteed that these J Links are always fast enough in disabling the watchdog 5 8 2 11 Type 10 Reset for Samsung S3FN60D devices On the Samsung S3FN60D devices the watchdog may be running after reset if the watchdog is active after reset or not depends on content of the smart option bytes at addr OxCO The watchdog keeps counting even if the CPU is in debug mode e g halted by a halt request or halted by vector catch When using this reset strategy J Link performs a reset of the CPU and peripherals using the SYSRESETREQ bit and sets VC CORERESET in order to halt the CPU after reset before it executes a single instruc tion Then the watchdog of the S3FN60D device is disabled J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 202 CHAPTER 5 Working with J Link and J Trace 5 9 Using DCC for memory access The ARM7 9 architecture requires cooperation of the CPU to access memory when the CPU is running not in debug mode This means that memory cannot normally be accessed while the CPU is executing the application program The normal way to read or write memory is to halt the CPU put it into debug mode before accessing mem ory Even if the CPU is restarted after the memory access the real time behavior is significantly affected halting and restarting the CPU costs typically multiple millisec onds For this reason most debuggers do not even allow memory access if the CPU is
220. ble channels can be configured at compile time and each buffer can be configured and added by the application at run time Up and down buffers can be handled separately Each channel can be configured to be blocking or non blocking In blocking mode the application will wait when the buffer is full until all memory could be written result ing in a blocked application state but preventing data from getting lost In non block ing mode only data which fits into the buffer or none at all will be written and the rest will be discarded This allows running in real time even when no debugger is connected The developer does not have to create a special debug version and the code can stay in place in a release application 12 2 2 Locating the Control Block When RTT is active on the host computer either by using RTT directly via an applica tion like RTT Viewer or by connecting via Telnet to an application which is using J Link like a debugger J Link automatically searches for the SEGGER RTT Control Block in the target s known RAM regions The RAM regions or the specific address of the Control Block can also be set via the host applications to speed up detection or if the block cannot be found automatically 12 2 3 Internal structures There may be any number of Up Buffer Descriptors Target gt Host as well as any number of Down Buffer Descriptors Host Target Each buffer size can be con figured individually The gray areas in
221. by memory reads writes via DCC to be handled gracefully If the data abort has been caused by the DCC commu nication it returns to the instruction right after the one causing the abort allowing the application program to continue to run In addition to that it allows the host to detect if a data abort occurred In order to use the DCC abort handler 3 things need to be done e Place a branch to DCC_Abort at address 0x10 vector used for data aborts e Initialize the Abort mode stack pointer to an area of at least 8 bytes of stack memory required by the handler the DCC abort handler assembly file to the application J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 203 5 10 The J Link settings file Most IDEs provide a path to a J Link settings file on a per project per debug config uration basis This file is used by J Link to store various debug settings that shall sur vive between debug sessions of a project It also allows the user to perform some override of various settings If a specific behavior setting can be overridden via the settings file is explained in the specific sections that describe the behavior setting Since the location and name of the settings file is different for various IDEs in the following the location and naming convention of the J Link settings file for various IDEs is explained 5 10 1 SEGGER Embedded Studio Settings file with default settings is
222. ce for test purposes The circuit functionality is defined in IEEE1149 1 Target The actual processor real silicon or simulated on which the application program is running TCK The electronic clock signal which times data on the TAP data lines TMS TDI and TDO TDI The electronic signal input to a TAP controller from the data source upstream Usu ally this is seen when connecting the J Link J Trace Interface Unit to the first TAP controller J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 435 TDO The electronic signal output from a TAP controller to the data sink downstream Usually this is seen connecting the last TAP controller to the J Link J Trace Inter face Unit Test Access Port TAP The port used to access a device s TAP Controller Comprises TCK TMS TDI TDO and nTRST optional Transistor Transistor logic TTL A type of logic design in which two bipolar transistors drive the logic output to one or zero LSI and VLSI logic often used TTL with HIGH logic level approaching 5V and LOW approaching OV Watchpoint A location within the image that will be monitored and that will cause execution to stop when it changes Word A 32 bit unit of information Contents are taken as being an unsigned integer unless otherwise stated J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 436 CHAPTER 18 Glossary J Link J Trace U
223. ch allows programming multiple breakpoints by programming just a single sector The contents of program memory are cached avoiding time consuming reading of the flash sectors A smart combination of soft ware and hardware breakpoints allows us to use hardware breakpoints a lot of times especially when the debugger is source level stepping avoiding re programming the flash in these situations A built in instruction set simulator further reduces the num ber of flash operations which need to be performed This minimizes delays for the user while maximizing the life time of the flash All resources of the ARM microcon troller are available to the application program no memory is lost for debugging J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 259 7 2 Licensing In order to use the flash breakpoints feature a separate license is necessary for each J Link For some devices J Link comes with a device based license and some J Link models also come with a full license for flash breakpoints but the normal J Link comes without any licenses For more information about licensing itself and which devices have a device based license please refer to Licensing on page 67 7 2 1 Free for evaluation and non commercial use In general the unlimited flash breakpoints feature of the J Link DLL can be used free of charge for evaluation and non commercial use If used in a commercial project a license needs to be purchas
224. ches enabled J Link J Trace does the fol lowing When entering debug state J Link J Trace performs the following e It stores the current write behavior for the D Cache e It selects write through behavior for the D Cache When leaving debug state J Link J Trace performs the following e It restores the stored write behavior for the D Cache e It invalidates the D Cache Note The implementation of the cache handling is different for different cores However the cache is handled correctly for all supported ARM9 cores J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 239 5 15 Virtual COM Port VCOM 5 15 1 Configuring Virtual COM Port In general the VCOM feature can be disabled and enabled for debug probes which comes with support for it via J Link Commander and J Link Configurator Below a small description of how to use use them to configure the feature is given Note VCOM can only be used when debugging via SWD target interface Pin 5 J Link Tx out Pin 17 J Link Rx in Note Currently only J Link models with hardware version 9 or newer comes with VCOM capabilites 5 15 1 1 Via J Link Configurator The J Link software and documentation package comes with a free GUI based utility called J Link Configurator which auto detects all J Links that are connected to the host PC via USB amp Ethernet The J Link Configurator allows the user to enable and disable the VCOM For m
225. cial handling for the AM335x cannot be supported by some older hardware versions of J Link so the device cannot be used with these versions The following hardware versions come with AM335x support J Link V8 or later J Link PRO V3 or later J Link ULTRA V4 or later Flasher ARM V4 or later 13 17 2 AM35xx AM37xx Script is not needed Refer to AM335x special handling Same needs to be done for AM35xx AM37xx 13 17 3 OMAP4430 Script is not needed Refer to AM335x special handling Same needs to be done for AM35xx AM37xx 13 17 4 OMAP L138 Needs a J Link script file to guarantee proper functionality J Link script file can be found at JLINK_INST_DIR Samples JLink Scripts For more information about how to use J Link script files please refer to Executing J Link script files on page 216 13 17 5 TMS470M Needs a J Link script file to guarantee proper functionality J Link script file can be found at JLINK_INST_DIR Samples JLink Scripts For more information about how to use J Link script files please refer to Executing J Link script files on page 216 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 13 17 6 OMAP3530 Needs a J Link script file to guarantee proper functionality J Link script file can be found at JLINK_INST_DIR Samples JLink Scripts For more information about how to use J Link script files please refer to Executing J Li
226. come the industry standard for debug access to ARM cores Corporate Office http www segger com United States Office http wWww segger us com EMBEDDED SOFTWARE Middleware emWin Graphics software and GUI emWin is designed to provide an effi cient processor and display control ler independent graphical user interface GUI for any application that operates with a graphical display embOS Real Time Operating System embOS is an RTOS designed to offer the benefits of a complete multitasking system for hard real time applications with minimal resources embOS IP TCP IP stack embOS IP a high performance TCP IP stack that has been optimized for speed versatility and a small memory footprint emFile File system emFile is an embedded file system with FAT12 FAT16 and FAT32 support Var ious Device drivers e g for NAND and NOR flashes SD MMC and Compact Flash cards are available USB Stack USB device host stack A USB stack designed to work on any embedded system with a USB control ler Bulk communication and most stan dard device classes are supported J Link J Trace UM08001 SEGGER TOOLS Flasher Flash programmer Flash Programming tool primarily for micro con trollers J Link JTAG emulator for ARM cores USB driven JTAG interface for ARM cores J Trace JTAG emulator with trace USB driven JTAG interface for ARM cores with Trace memory suppor
227. connected J Link J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 144 CHAPTER 3 J Link software and documentation package Syntax swofreq lt SWOFreq gt Example swofreq 6000 3 7 3 Configure SWO output after device reset In some situations it might happen that the target application is reset and it is desired to log the SWO output of the target after reset during the booting process For such situations the target application itself needs to initialize the CPU for SWO output since the SWO Viewer is not restarted but continuously running Example code for enabling SWO out of the target application define ITM ENA volatile unsigned 0 0000 00 ITM Enable define ITM_TPR volatile unsigned 0 0000 40 Trace Privilege Register define ITM_TCR volatile unsigned 0 0000 80 ITM Trace Control Reg define ITM_LSR volatile unsigned 0000 0 ITM Lock Status Register define DHCSR volatile unsigned 0 000 0 Debug register define DEMCR volatile unsigned int O0xEOO00EDFC Debug register define TPIU ACPR volatile unsigned int 0xE0040010 Async Clock N presacler register define TPIU SPPR volatile unsigned 0 00400 0 Selected Pin Protocol Register define DWT CTRL volatile unsigned int 0xE0001000 DWT Control Register
228. connection from a GDB client is accepted Note Using GDB Server CL device interface endian and speed are mandatory options to correctly connect to the target and should be given before connection via GDB Using GDB Server GUI the mandatory options can also be selected in the con figuration dialog Command line option Explanation device Select the connected target device endian Select the device endianness if Select the interface to connect to the target speed Select the target communication speed Table 3 6 Mandatory command line options Note Using multiple instances of GDB Server setting custom values for port SWOPort and TelnetPort is necessary Command line option Explanation port Select the port to listen for GDB clients swoport Select the port to listen for clients for SWO RAW output telnetport Select the port to listen for clients for printf output Table 3 7 Port selection command line options The GDB Server GUI version uses persistent settings which are saved across different instances and sessions of GDB Server These settings can be toggled via the check boxes in the GUI Note GDB Server CL always starts with the settings marked as default For GUI and CL the settings can be changed with following command line options For all persistent settings there is a pair of options to enable or disable the feature Command line option Explanation
229. controller GmbH amp Co KG 258 CHAPTER 7 Flash breakpoints 7 1 Introduction The J Link DLL supports a feature called flash breakpoints which allows the user to set an unlimited number of breakpoints in flash memory rather than only being able to use the hardware breakpoints of the device Usually when using hardware break points only a maximum of 2 ARM 7 9 11 to 8 Cortex A R breakpoints can be set The flash memory can be the internal flash memory of a supported microcontroller or external CFI compliant flash memory In the following sections the setup for different debuggers for use of the flash breakpoints feature is explained How do breakpoints work There are basically 2 types of breakpoints in a computer system Hardware break points and software breakpoints Hardware breakpoints require a dedicated hardware unit for every breakpoint In other words the hardware dictates how many hardware breakpoints can be set simultaneously ARM 7 9 cores have 2 breakpoint units called watchpoint units in ARM s documentation allowing 2 hardware breakpoints to be set Hardware breakpoints do not require modification of the program code Software breakpoints are different The debugger modifies the program and replaces the breakpointed instruction with a special value Additional software breakpoints do not require additional hardware units in the processor since simply more instructions are replaced This is a standard procedure that most d
230. ctivated to handle such cases in a better way which is explained in the following J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 275 9 2 Activating low power mode handling for J Link While usually the J Link DLL handles communication losses as errors there is a pos sibility to enable low power mode handling in the J Link DLL which puts the DLL into a less restrictive mode low power handling mode when it comes to such loss cases The low power handling mode is disabled by default to allow the DLL to react on tar get communication breakdowns but this behavior is not desired when debugging cases where the target is unresponsive temporarily How the low power mode han dling mode is enabled depends on the debug environment In the following the most common scenarios are described 9 2 1 SEGGER Embedded Studio Low power handling mode has to be activated in the J Link settings file Open the J Link settings file in a text editor and add the following line in the CPU section LowPowerHandlingMode 1 For more information about how to locate the settings file please refer to The J Link settings file on page 203 9 2 2 Keil MDK ARM Low power handling mode has to be activated in the J Link settings file Open the J Link settings file in a text editor and add the following line in the CPU section LowPowerHandlingMode 1 For more information about how to locate the settings file please re
231. d Configure both watchdog timers to be halted if the CPU is halted by the debugger volatile int 0 0042004 1 lt lt 8 1 lt lt 9 13 16 3 STM32F2xxx These devices are Cortex M3 based All devices of this family are supported by J Link 13 16 3 1ETM init The following sequence can be used to prepare STM32F2xxx devices for 4 bit ETM tracing int v Enable GPIOE clock volatile int 0x40023830 0x00000010 Assign trace pins to alternate function in order to make them usable as trace pins PE2 Trace clock TRACE_DO TRACE D1 PES TRACE D2 PE6 TRACE D3 volatile int 0x40021000 0 00002 0 DBGMCU_CR enable trace I O and configure pins for 4 bit trace volatile int 0xE0042004 7 lt lt 5 Preserve all bits except the trace pin configuration 7 lt lt 5 Enable trace I O and configure pins for 4 bit trace volatile int 0xE0042004 v 13 16 3 2Debugging with software watchdog enabled If the device shall be debugged with one of the software watchdogs independed watchdog window watchdog enabled there is an additional init step necessary to make the watchdog counter stop when the CPU is halted by the debugger This is configured in the DBGMCU 1 FZ register The following sequence can be used to enable debugging with software watchdogs enabled
232. d in the Options drop down menu may be read back The Entire chip may be read back A specified Range may be read back Table 10 5 Target menu elements Options menu elements Command Description Project settings Location of the project settings that are displayed in the snapshot view found in the Project window of the J Flash SPI application Furthermore various settings needed to locate the J Link and pass specified commands needed for chip initialization Global settings Settings that influence the general operation of J Flash SPI Table 10 6 Options menu elements J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 284 Window menu elements CHAPTER 10 J Flash SPI Command Description Cascade Arranges all open windows one above the other with the active window at the top Tile Horizontal Tiles the windows horizontally with the active window at the top Tile Vertical Tiles the windows vertically with the active window at the left Table 10 7 Window menu elements Help menu elements Command Description J Link User s Guide Shows the J Link User s Guide in a PDF viewer such as Adobe Reader About J Flash SPI and company information Table 10 8 Help menu elements J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 285 1
233. d USB 2 0 interface Serial Wire Debug supported Serial Wire Viewer supported Download speed up to 1 MBytes second Debug interface JTAG SWD speed up to 15 MHz RDI interface available which allows using J Link with RDI compliant software The actual speed depends on various factors such as JTAG SWD clock speed host CPU core etc 1 3 2 2 Specifications The following table gives an overview about the specifications general mechanical electrical for J Link BASE General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 27 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 209C 65 C Relative humidity non condensing Max 90 rH Mechanical Size without cables 100mm x 53mm x 27mm Weight without cables 70g Available interfaces USB interface USB 2 0 full speed JTAG 20 pin 14 pin adapter available JTAG SWD Interface Electrical USB powered Max 50mA Target Supply current Target interface Power supply Target interface voltage Vir 1 2V 5V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300 Open drain Can be pulled low or Reset type deu Reset low level output voltage VoL VoL lt 10 of Vir For the whole target voltage range 1 2V lt Vip lt
234. dMem FFFFF130 0004 Data 060 236 0000 ARM ReadMem FFFFF130 0004 Data 060 237 0000 ARM ReadMem FFFFF130 0004 Data 060 238 0001 ARM ReadMem FFFFF130 0004 Data 060 239 0001 ARM ReadMem FFFFF130 0004 Data 060 240 0001 ARM ReadMem FFFFF130 0004 Data 060 241 0001 ARM WriteMem FFFFFD44 0004 Data OxFFFFFD44 gt 195 gt 060 277 0000 ARM WriteMem 00000000 0178 Data 060 277 0000 ARM WriteMem 000003C4 0020 Data Writing 0x178 bytes 0x00000000 060 277 0000 ARM WriteMem 000001CC 00F4 Data Writing 0x20 bytes 8 0 000003 4 060 277 0000 ARM WriteMem 000002C0 0002 Data 060 278 0000 ARM WriteMem 000002C4 0068 Data Writing OxF6 bytes 0x000001CC 060 278 0000 ARM WriteMem 0000032C 0002 Data 060 278 0000 ARM WriteMem 00000330 0074 Data Writing 0x6A bytes 0 000002 4 060 278 0000 ARM WriteMem 000003B0 0014 Data Writing 0x74 bytes 0x00000330 060 278 0000 ARM WriteMem 000003A4 000C Data Writing 0x14 bytes 0x000003B0 060 278 0000 ARM WriteMem 00000178 0054 Data Writing OxC bytes 0x000003A4 060 278 0000 ARM SetEndian ARM ENDIAN LITTLE 060 278 0000 ARM SetEndian ARM ENDIAN LITTLE 060 278 0000 ARM ResetPullsRESET OFF 060 278 0009 ARM Reset 060 287 0001 ARM Halt J Link J Trace UM08001
235. dated Chapter Hardware updated Chapter Working with J Link el Doone Section Cortex M3 specific reset strategies Chapter Working with J Link s SOA RE Section Cortex specific reset strategies Chapter Hardware 59 090108 KN Section Target board design for JTAG updated Section Target board design for SWD added Chapter Working with J Link Pro 58 090105 AG Section Connecting J Link Pro the first time updated Chapter Working with J Link Pro Section Introduction updated 57 081222 Section Configuring J Link Pro via web interface updated Chapter Introduction Section J Link Pro overview updated Chapter Working with J Link Pro Section FAQs added 2 987215 29 Chapter and FAQs Section Frequently Asked Questions updated 55 081218 Chapter Hardware updated Chapter Working with J Link and J Trace 25 a Section Command strings updated 53 081216 Chapter Working with J Link Pro updated Chapter Working with J Link Pro added 52 081212 AG Chapter Licensing Section Original SEGGER products updated 51 081202 Several corrections Chapter Flash download and flash breakpoints 87 0610807 Section Supported devices 49 081029 Several corrections Chapter Working with J Link and J Trace 48 080916 AG Section Connecting multiple J Links J Traces to your PC updated 47 080910 Chapter Licens
236. de If J Link is unable to locate a valid monitor in the target memory it will default back to halt mode debugging in order to still allow debugging in general In the following some examples on how to enable monitor mode debugging for dif ferent IDEs are given 8 2 1 GDB based debug solutions For GDB based debug solutions there is a gdbinit file which contains commands that can be executed by GDB GDBServer In this gdbinit file the following line needs to be added to enable monitor mode debugging monitor exec SetMonModeDebug 1 8 2 2 IAR EWARM In IAR EWARM there are so called macro files available to customize certain opera tions In this file the following function with the following line needs to be present f ke KE KE k e ke k k k k AK ERE execUserSetup Function description Called once after the target application is downloaded Implement this macro to set up the memory map breakpoints i interrupts register macro files etc execUserSetup __message Macro execUserSetup Enabling monitor mode jlinkExecCommand SetMonModeDebug 1 H The macro file also needs to be selected to be used in the project Options for node Button LED GPIO Category Factory Settings General Options Static Analysis Runtime Checking Compiler Setup Download images Extra Options
237. dress Mode Permission Implementation 1 0 0800011 Unknown Flash TBC 2 008000128 Unknown Flash 3 0 08000124 Unknown Flash TBC 4 0 080001 34 Unknown Any Flash TBC 5 0 08000150 Unknown Flash TBC 6 0080001 64 Unknown Flash TBC Watchpoints Address Access 1 Ox8000000 0 08000120 000001000 Write 16 bit Vector catch EP Ready JLINKARM ReadMem Done 1 494 sec in 219 calls 2 Section Code Lists all breakpoints which are in the DLL internal breakpoint list are shown Handle Shows the handle of the breakpoint Address Shows the address where the breakpoint is set Mode Describes the breakpoint type ARM THUMB Permission Describes the breakpoint implementation flags Implementation Describes the breakpoint implementation type The break point types are RAM Flash Hard An additional TBC to be cleared or TBS to be set gives information about if the breakpoint is still written to the target or if it s just in the breakpoint list to be written cleared Note It is possible for the debugger to bypass the breakpoint functionality of the J Link software by writing to the debug registers directly This means for ARM7 ARM9 cores write accesses to the ICE registers for Cortex M3 devices write accesses to the memory mapped flash breakpoint registers and in general simple write accesses for software breakpoints if the progr
238. e E HE LX ETATE 416 15 4 1 How does flash programming via J Link J Trace 416 15 4 2 Data download to RAM 1 2 4 4 6 66 6 nnne nnn nnn nnn nnn 416 15 4 3 Data download via DCC 41 2 41 1 4 16 116 66 416 15 4 4 Available options for flash programming 416 15 5 J Link J Trace firmware p Aia EN ANAAL 418 15 5 1 Firmware Update fs seen rats eda ee E CAR a va Pea Que eae 418 15 5 2 siens eerte EH A E rx ere 418 16 Designing the target board for trace 2 421 16 1 Overview of high speed board design 422 16 1 1 Avoiding StUbs ete e rere xD ta esa deae 422 16 1 2 Minimizing Signal Skew Balancing PCB Track 422 16 1 3 Minimizing Crosstalk i ii icccccetieseesgatedeuvecatatvssecdsoteeaaseateltvatenvaceuaaacsieddaaecas 422 16 1 4 Using impedance matching and termination 422 16 2 Terminating the trace signal 423 16 2 1 Rules for series terminators 2 nemen eene nnn 423 16 3 Signal requirements esser eva donna ee na pit ne done sn Se
239. e J Link commander finds and lists all of the J Link s licenses automatically as can be seen in the screenshot below E C Windows system32 cmd exe als SEGGER J Link Commander 04 80 for help Compiled Dec 26 2613 19 38 62 DLL version 04 80 compiled Dec 26 2013 1 Firmware J Link 09 compiled Dec 11 2813 M FlashBP FlashDL JFlash with ID x2BA61477 M4 r8pi Little endian CBP slots and 2 literal slots Total IRLen 4 ied Target interface speed 168 kHz J Link gt The J Link PLUS in the example above contains licenses for all features Note that GDB and FlashDL feature are no longer required 2 2 2 Key based license When using a key based license a license key is required in order to enable the fea ture License keys can be added via the J Link License Manager How to enter a license via the license manager is described in Licensing on page 259 Like the built in license the key based license is only valid for one J Link so if another J Link is used it needs a separate license J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 70 CHAPTER 2 Licensing 2 3 Legal use of SEGGER J Link software The software consists of proprietary programs of SEGGER protected under copyright and trade secret laws All rights title and interest in the software are and shall remain with SEGGER For details please refer to the license agreement w
240. e JTAG instruction register WriteJTAG DR nBits Data Writes the JTAG data register Table 11 2 Macro file commands Example of macro file f kk e ck ke e ke cec kc e she ke e e he e e ke ke ke KR EKER ER he ke ck ck ck kkk Macro file for J LINK RDI KEKE KKK KKK KKK KK ck ck ck ckockckck ck ck ckck ck ck ck ck kc ck ckck kk kk File Purpose LPC2294 setup Setup for Philips LPC2294 chip ck ck ckck kckckckck ck ckock KKK KKK KKK KEK ckck ckckck ckckck kck ck ck ck ck ck ck ck ck kk kk SetJUTAGSpeed 1000 Reset 0 Write32 0xE01FC040 0x00000001 Write32 0xFFE00000 0x20003CE3 Write32 0xE002C014 0 0 6001 4 SetJTAGSpeed 2000 J Link J Trace UM08001 Map User Flash into Vector area at 0 3f Setup CSO Setup PINSEL2 Register 2004 2015 SEGGER Microcontroller GmbH amp Co KG 324 CHAPTER 11 RDI 11 4 4 3 JTAG tab mum RDI Configuration METTI contig JTAG speed This allows the selection of the JTAG speed There are basically three types of speed settings which are explained below e Fixed JTAG speed e Automatic JTAG speed e Adaptive clocking For more information about the different speed settings supported by J Link please refer to JTAG Speed on page 182 JTAG scan chain with multiple devices The JTAG scan chain
241. e a J Link script file by making use of the J Link DLL auto search feature e Navigate to the folder where the uVision project uvproj uvprojx is located that shall use the script file 1 gt ETM Trace IntermallRC16MHz KeilV515 5 Search STM32F407 ETM_Trace_Interna 2 File Edit View Tools Help Organize Include in library Share with v New folder e 4 Date modified Type Size Desktop d RTE 15 10 01 10 11 File folder n Downloads Src 15 10 01 10 11 File folder 2 Dropbox _ Generic CortexM uvoptx 15 09 25 13 52 UVOPTX File 12 KB T Recent Places 18 Generic CortexM uvprojx 15 09 25 13 51 HVisionS Project 17 KB amp JLinkSettings ini 15 09 25 13 42 Configuration sett 1KB gt Desktop 5 items e Copy the J Link script file to there J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 217 e Rename the J Link script to JLinkSettings JLinkScript gt STM32F407 Trace InternallRC16MHz KeilV515 gt Search STM32F407 ETM Trace Interna ww z File Edit View Tools Help Organize v Include in library Share with v New folder Ev i e Favorites Name 5 Date modified Type Size RE Desktop RTE 15 10 01 10 11 File folder Downloads src 15 10 01 10 11 File folder 2 Dropbox _ Generic CortexM uvoptx 15 09 25 13 52 UVOPTX File 12 Recent Places 8 Generic CortexM uv
242. e debugging with J Link This monitor performs the communication with J Link while the CPU is in debug mode meaning in the monitor exception The monitor code needs to be com piled and linked as a normal part of the application Monitors for different cores are available from SEGGER upon request at support_jlink segger com In general the monitor code consists of three files e JLINK MONITOR c Contains user specific functions that are called on debug mode entry exit and periodically while the CPU is in debug mode Functions can be filled with user specific code None of the functions must block the generic monitor for more than 100ms e JLINK MONITOR h Header file to populate JLINK MONITOR functions e JLINK MONITOR ISR s Generic monitor assembler file Should not be modified by the user Do NOT touch J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 271 8 5 Debugging interrupts In general it is possible to debug interrupts when using monitor mode debugging but there are some things that need to be taken care of when debugging interrtups in monitor mode e Only interrupts with a lower priority than the debug monitor interrupt can be debugged stepped e Setting breakpoints in interrupt service routines ISRs with higher priority than the debug monitor interrupt will result in malfunction because the CPU cannot take the debug interrupt when hitting the breakpoint J Link J Trace UM08001
243. e is opened All command line options return O if the processing was successful A return value unequal 0 means that an error occured Option Description Displays help dialog auto Erases program and verify target connect Connects to target delrange lt SADDR gt lt EADDR gt Deletes data in the given range disconnect Disconnects from target merge lt FILENAME gt bin lt ADDR gt eliminate Eliminates blank areas in data file erasechip Erases the entire flash chip erasesectors Erases all sectors exit Exits application help Displays help dialog Merges a given file with the one currently opened merge lt FILENAME gt Note that when passing a bin file via this com mand also the start address where it shall be merged the file currently openend in J Flash SPI must be given too since bin files do not contain any address information open lt FILENAME gt lt SADDR gt Open a data file Please note that the lt SADDR gt parameter applies only if the data file is a bin file Open an existing project file This will also openprj lt FILENAME gt automatically open the data file that has been recently used with this project program Program target programverify Program and verify target readchip Read entire flash chip readrange lt SADDR gt lt EADDR gt Read specified range of target memory save SADDR EAD
244. e of memory zone to access Addr Start address Data 32 bits of data to write Example w4 0x0 OxAABBCCFF 3 2 1 49 wreg Writes into a register The value is written into the register on CPU start Syntax wreg lt RegName gt lt Data gt Parameter Meaning RegName Register to write to Data Data to write to the specified register Example wreg R14 OxFF 3 2 2 Command line options J Link Commander can be started with different command line options for test and automation purposes In the following the command line options which are available for J Link Commander are explained Command Explanation CommanderScript Passes a CommandrFile to J Link CommandFile Passes a CommandFile to J Link Device Pre selects the device J Link Commander shall connect to ExitOnError Commander exits after error If Pre selects the target interface IP Selects IP as host interface JLinkScriptFile Passes a JLinkScriptFile to J Link SelectEmuBySN Connects to a J Link with a specific S N over USB SettingsFile Passes a SettingsFile to J Link Speed Starts J Link Commander with a given initial speed Table 3 2 Available command line options 3 2 2 1 CommanderScript Similar to CommandFile J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 99 3 2 2 2 CommandFile Selects a command file and starts J Link Commande
245. e or disable the instruction set simulation By default the instruction set simulation is enabled Syntax SetAllowSimulation 0 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 228 CHAPTER 5 Working with J Link and J Trace Example SetAllowSimulation 1 Enables instruction set simulation 5 12 1 38SetBatchMode This command is used to tell the J Link DLL that it is used in batch mode automa tized mode so some dialogs etc will automatically close after a given timeout Dis abled by default Syntax SetBatchMode 0 1 Example SetBatchMode 1 Enables batch mode 5 12 1 39SetCFIFlash This command can be used to set a memory area for CFI compliant flashes Syntax SetCFIFlash StartAddressOfArea EndAddressOfArea Example SetCFIFlash 0x10000000 0x100FFFFF 5 12 1 40 SetCheckModeAfterRead This command is used to enable or disable the verification of the CPSR current pro cessor status register after each read operation By default this check is enabled However this can cause problems with some CPUs e g if invalid CPSR values are returned Please note that if this check is turned off SetCheckModeAfterRead 0 the success of read operations cannot be verified anymore and possible data aborts are not recognized Typical applications This verification of the CPSR can cause problems with some CPUs e g if invalid CPSR values are returned Not
246. e resistor to ground or a pull up pull down combination of resistors Thevenin termination fitted at the end of each signal and as close as pos sible to the JTAG Trace connector If a single resistor is used its value must be set equal to the PCB track impedance If the pull up pull down combination is used their resistance values must be selected so that their parallel combination equals the PCB track impedance Caution At lower frequencies parallel termination requires considerably more drive capability from the ASIC than series termination and so in practice DC parallel termination is rarely used 16 2 1 Rules for series terminators Series source termination is the most commonly used method The basic rules are 1 The series resistor must be placed as close as possible to the ASIC pin less than 0 5 inches 2 The value of the resistor must equal the impedance of the track minus the output impedance of the output driver So for example a 50 PCB track driven by an out put with a 17 impedance requires a resistor value of 33 3 source terminated signal is only valid at the end of the signal path At any point between the source and the end of the track the signal appears distorted because of reflections Any device connected between the source and the end of the signal path therefore sees the distorted signal and might not operate cor rectly Care must be taken not to connect devices in this way unless the distor tion
247. e that if this check is turned off SetCheckModeAfterRead 0 the success of read operations cannot be verified anymore and possible data aborts are not recognized Syntax SetCheckModeAfterRead 0 1 Example SetCheckModeAfterRead 0 5 12 1 41SetCompareMode This command is used to configure the compare mode Syntax SetCompareMode lt Mode gt Compare mode Description 0 Skip 1 Using fastest method default 2 Using CRC 3 Using readback J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 229 Example SetCompareMode 1 Select using fastest method 5 12 1 42SetCPUConnectIDCODE Used to specify an IDCODE that is used by J Link to authenticate itself when connect ing to a specific device Some devices allow the user to lock out a debugger by default until a specific unlock code is provided that allows further debugging This function allows to automate this process if J Link is used in a production environ ment The IDCODE stream is expected as a hex encoded byte stream If the CPU e g works on a word basis for the IDCODE this stream is interpreted as a little endian format ted stream where the J Link library then loads the words from and passes them to the device during connect Syntax SetCPUConnectIDCODE lt IDCODE_Stream gt Example CPU has a 64 bit IDCODE on word basis and expects 0x11223344 0x55667788 as IDC
248. eas on read If this option is checked a blank check is performed before any read back operation to examine which flash areas need to be read back from target This improves perfor mance of read back operations since it minimizes the amount of data to be trans ferred via JTAG and USB 10 4 2 2 Logging You may set some logging options to customize the log output of J Flash SPI 10 4 2 2 1 General log level This specifies the log level of J Flash SPI Increasing log levels result in more infor mation logged in the log window 10 4 2 2 2 Enable J Link logfile If this option is checked you can specify a file name for the J Link logfile The J Link logfile differs from the log window output of J Flash SPI It does not log J Flash SPI operations performed Instead of that it logs the J Link ARM DLL API functions called from within J Flash SPI J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 289 10 5 Command Line Interface This chapter describes the J Flash SPI command line interface The command line allows using J Flash SPI in batch processing mode and other advanced uses 10 5 1 Overview In addition to its traditional Windows graphical user interface GUI J Flash SPI sup ports a command line mode as well This makes it possible to use J Flash SPI for batch processing purposes All important options accessible from the menus are available in command line mode as well If you provide command
249. ebuggers are capable of however this usually requires the program to be located in RAM What is special about software breakpoints in flash Flash breakpoints allows setting an unlimited number of breakpoints even if the user application is not located in RAM On modern microcontrollers this is the standard scenario because on most microcontrollers the internal RAM is not big enough to hold the complete application When replacing instructions in flash memory this requires re programming of the flash which takes much more time than simply replacing a instruction when debugging in RAM The J Link flash breakpoints feature is highly optimized for fast flash programming speed and in combination with the instruction set simulation only re programs flash that is absolutely necessary This makes debugging in flash using flash breakpoints almost as flawless as debugging in RAM What performance expect Flash algorithm specially designed for this purpose sets and clears flash breakpoints extremely fast on microcontrollers with fast flash the difference between software breakpoints in RAM and flash is hardly noticeable How is this performance achieved We have put a lot of effort in making flash breakpoints really usable and convenient Flash sectors are programmed only when necessary this is usually the moment exe cution of the target program is started A lot of times more than one breakpoint is located in the same flash sector whi
250. eck if this is the first time we are run ning into InitTarget Useful if some init steps only need to be executed once per debug ses sion Example if MAIN IsFirstIdentify 1 L2 else PERN Table 5 11 Global DLL variables 5 11 4 Global DLL constants Currently there are only global DLL constants to set the global DLL variable cpu If necessary more constants will be implemented in the future 5 11 4 1 Constants for global variable CPU The following constants can be used to set the global DLL variable cpu ARM7 ARM7TDMI ARM7TDMIR3 ARM7TDMIR4 ARM7TDMIS ARM7TDMISR3 ARM7TDMISR4 ARM9 ARM9TDMIS ARM920T ARM922T ARM926EJS 946 15 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 214 CHAPTER 5 Working with J Link and J Trace 966 5 968 5 ARM11 ARM1136 ARM1136J ARM1136JS ARM1136JF ARM1136JFS ARM1156 ARM1176 ARM1176J ARM1176JS ARM1176IF ARM1176JFS CORTEX MO CORTEX M1 CORTEX M3 CORTEX CORTEX_M3R1P1 CORTEX_M3R2P0 CORTEX_M4 CORTEX_M7 CORTEX_A5 CORTEX_A7 8 9 12 15 17 CORTEX R4 CORTEX R5 5 11 4 2 Constants for JLINK CORESIGHT functions APs CORESIGHT AHB AP CORESIGHT APB AP JTAG CORESIGHT CUSTOM AP DP AP register indexes JLINK CORESIGHT DP REG IDCODE JLINK CORESIGHT DP REG ABORT JLINK CORESIGHT DP
251. eck k kkk kk kkk k k k kkk kkk kkk k kk kkk 7 _Init emulatorSpeed 30000 Set JTAG speed to 30 kHz __writeMemory32 0xA5000004 0xFFFFFDOO Memory Perform peripheral reset leep 20000 H iteMemory32 0x00008000 OxFFFFFD44 Memory Disable Watchdog 20000 iteMemory32 0x00000601 0xFFFFFC20 Memory PLL Leep 20000 iteMemory32 0x10191c05 0xFFFFFC2C Memory PLL 20000 iteMemory32 0x00000007 0xFFFFFC30 Memory PLL 20000 iteMemory32 0x002 0100 0xFFFFFF60 Memory Set 1 wait state for Sleep 20000 flash 2 cycles emulatorSpeed 12000000 Use full JTAG speed Kt Kt K H EAER N H M H D OHO RRR RRR RK RR KKK Sk RK KR KKK RR KR KK KKK ck ckckckckckckckckchckckckc k EEE EEE kkk kk kkk kkk kck ck execUserReset execUserReset message execUserReset _Init JEKKKKKKKKKKKXEEXEEX KERR ck ckckckckckckckckckckckckckckckckckckchckckckckckckckckckckckckck kk kkk kkk kkk k k execUserPreload execUserPreload message execUserPreload _Init J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG RDI Sample SetJTAGSpeed 30 Reset 0 0 Write32 0xFFFFFDOO Write32 OxFFFFFD44 Write32 OxFFFFFC20 Delay 200 Write32 OxFFFFFC2C Delay 200 Write32 OxFFFFFC30 Write32 OxFFFFFF60 SetJTAGSpeed 120
252. ect a specific J Link by port number J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Syntax usb lt Port gt 97 Parameter Meaning Port Valid values 0 3 Example usb 3 2 1 45 verifybin Verifies if the specified binary is already in the target memory at the specified address Syntax verifybin Filename lt Addr gt Parameter Meaning Filename Sample bin Addr Start address of memory to verify Example verifybin C Work test bin 0x0000000 3 2 1 46 w1 The command writes one single byte to the target system Syntax wl Zone Addr Data hex Parameter Meaning Zone Name of memory zone to access Addr Start address Data 8 bits of data to write Example wl 0x10 OxFF 3 2 1 47 w2 The command writes a unit of 16 bits to the target system Syntax w2 lt Zone gt lt Addr gt lt Data gt hex Parameter Meaning Zone Name of memory zone to access Addr Start address Data 16 bits of data to write Example w2 0x0 OxFFFF J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 98 CHAPTER 3 J Link software and documentation package 3 2 1 48 w4 The command writes a unit of 32 bits to the target system Syntax w4 lt Zone gt lt Addr gt lt Data gt hex Parameter Meaning zone Nam
253. ector catch has no effect unless semihosting is disabled semihosting vector This variable controls the location of the breakpoint set by J Link RDI to detect a semihosted SWI It is set to the SWI entry in the exception vector table by default 11 5 4 1 Using SWIs in your application If your application requires semihosting as well as having its own SWI handler set semihosting_ vector to an address in your SWI handler This address must point to an instruction that is only executed if your SWI handler has identified a call to a semihosting SWI All registers must already have been restored to whatever values they had on entry to your SWI handler J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 11 5 5 Unexpected unhandled SWIs When an unhandled SWI is detected by J Link RDI the message box below is shown J Link RDI Warning J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 332 CHAPTER 11 RDI J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 333 Chapter 12 RTT SEGGER s Real Time Terminal RTT is a technology for interactive user I O in embed ded applications It combines the advantages of SWO and semihosting at very high performance J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 334 CHAPTER 12 RTT 12 1 Introduction With RTT it is possible to output information fro
254. ector defined by ARM 1 3 8 1 Additional features Supports tracing on ARM7 9 targets JTAG speed up to 12 MHz Download speed up to 420 Kbytes second DCC speed up to 600 Kbytes second Comes with built in licenses for Unlimited number of breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming software Measured with J Trace ARM7 50 MHz 12MHz JTAG speed 1 3 8 2 Specifications General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 27 Electromagnetic Compatibility EMC EN 55022 EN 55024 Operating Temperature 5 C 40 C Storage Temperature 20 C 65 C Relative Humidity non condensing lt 90 rH Size without cables 123mm x 68mm x 30mm Weight without cables 120g Mechanical USB Interface USB 2 0 full speed JTAG 20 pin 14 pin ter availabl Target Interface 1 JTAG SWD Interface Electrical Power Supply USB powered lt 300mA Supported Target interface voltage 3 0 3 6 V 5V adapter available Table 1 10 J Trace specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 53 1 3 8 3 Download speed The following table lists performance values Kbytes s for writing to memory RAM Hardware ARM7 via JTAG ARM via JTAG 420 0 Kbytes s 280 0 Kbytes s 12MHz JTAG 12MHz
255. ed JTAG speed 3 3 3 27 step Syntax step lt NumSteps gt or si NumSteps Description Performs one or more single instruction steps where lt NumSteps gt is the number of instruction steps to perform If NumSteps is not specified only one instruction step will be performed Example gt monitor step 3 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 118 CHAPTER 3 J Link software and documentation package 3 3 3 28 SWO DisableTarget Syntax SWO DisableTarget PortMask 0x01 OxFFFFFFFF Description Disables the output of SWO data on the target Undoes changes from SWO Enable Target and stops J Link to capture it Example Disable captureing SWO from stimulus ports 0 and 1 monitor SWO DisableTarget 3 SWO disabled succesfully 3 3 3 29 SWO EnableTarget Syntax SWO EnableTarget CPUFreq Hz SWOFreq Hz PortMask 0x01 0xFFFFFFFF Mode 0 Description Configures the target to be able to output SWO data and starts J Link to capture it CPU and SWO frequency can be for auto detection If CPUFreq is 0 J Link will measure the current CPU speed If SWOFreq is 0 J Link will use the highest available SWO speed for the selected measured CPU speed Note CPUFreq has to be the speed at which the target will be running when doing SWO If the speed is different from the current speed when issuing CPU speed auto detec tion getting SWO data might
256. ed when the evaluation is complete There is no time limit on the evaluation period This feature allows set ting an unlimited number of breakpoints even if the application program is located in flash memory thereby utilizing the debugging environment to its fullest The debugger is trying to set a breakpoint in flash memory at address 008000200 The target CPU has run out of hardware breakpoints In order to set the requested breakpoint a software breakpoint in flash memory can be set Unlimited breakpoints in flash memory Flash Breakpoints is an enhanced feature of J Link which requires an additional license Some members of the J Link family such as the J Link Pro and J Link EDU already come with a built in license for unlimited breakpoints in flash memory In order to buy a license for unlimited breakpoints in flash memory for the connected emulator please get in touch with sales segger com For more information regarding this feature please refer to http www segger com jlink_buy_flashbps html However using this feature without the additional license is possible and permitted if used for evaluation only Evaluate unlimited breakpoints in flash memory now J Link S N 58004070 B breakpoints are currently set 1 Addr 0508000200 Type Implementation Hard 2 Addr 0208000206 Type Any Implementation Hard 3 Addr 0208000220 Type Implementation Hard 4 Addr 0 0800023 Any Impleme
257. eda 76 2 5 1 Analog Devices MIDASLINK eene rbi nex neces eid eevee 76 2 5 2 Atmel SAMCE res one tux ve peta aw eevee ey tee pasen Fe Tag iv Sw rra dioc YE ears 76 2 5 3 Digi JTAG TEES 77 2 5 4 TAR J Link J LINK KS ueteri yx rt xen e E E EC n RR 77 2 5 5 TAR J LINK Lite En 77 2 5 6 IAR J Ira Eaei ETE 78 2 5 7 NXP J Eink Lite EPC Edition devaneio eene yr sivas ae 78 2 5 8 SEGGER J Link Lite ARM osito exe en en e e cia he m o RE 78 2 6 J GNK OBS rss 79 2 7 EEUU 80 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 18 J Link software and documentation 81 3 1 Software nhan aea a DEEDES area DEES GEESE EEE SEES ES 82 3 2 J Link Commander Command line tool 83 3 2 1 ata dca wien le erates ba et EK i Gand TE NE ne rM RR CREE ES 84 3 2 2 Command lire Options It E oou Re E NA D Uo REV ere ERE TS 98 3 2 3 Using command fils sise e Re EIE n Ra xr e REN RU 100 3 3 J Link GDB SOR CB de Ex mae ee Red bie dnb e e e e 102 3 3 1 J Link GDB Server CL Windows Linux Mac 102 3 3 2 Debugging
258. egies Section Cortex M3 specific reset strategies updated 37 080617 AG Chapter Reset strategies Section Cortex M3 specific reset strategies updated 36 080530 AG Chapter Hardware Section Differences between different versions updated Chapter Working with J Link and J Trace Section Cortex M3 specific reset strategies added 35 080215 AG Chapter J Link and J Trace related software Section J Link software and documentation package in detail updated 34 080212 AG Chapter J Link and J Trace related software Section J Link TCP IP Server Remote J Link J Trace use updated Chapter Working with J Link and J Trace Section Command strings updated Chapter Flash download and flash breakpoints Section Introduction updated Section Licensing updated Section Using flash download and flash breakpoints with different debuggers updated J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 33 080207 AG Chapter Flash download and flash breakpoints added Chapter Device specifics Section ATMEL AT91SAM7 Recommended init sequence added 32 0080129 SK Chapter Device specifics Section NXP LPC Fast GPIO bug list of device enhanced 31 0080103 SK Chapter Device specifics Section NXP LPC Fast GPIO bug upd
259. elect the target device to connect to This allows J Link to search in the known RAM of the target Select the target interface and its speed If known enter the address of the RTT Control Block in the target application Other wise leave as O for auto detection Attaching to a connection In attach mode RTT Viewer does not need any settings Select Existing Session For attach mode a connection to J Link has to be opened and configured by another application like a debugger or simply J Link Commander If the RTT Control Block cannot be found automatically configuration of its location has to be done by the debugger application 12 3 1 3 The Terminal Tabs RTT Viewer allows displaying the output of Channel in different virtual Terminals The target application can switch between terminals with SEGGER RIT SetTerminal and SEGGER RTT TerminalOut RTT Viewer displays the Terminals in different tabs All Terminals l Real Time Terminal Sample Sending some input J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 340 CHAPTER 12 RTT All Terminals All Terminals tab displays the complete output of RTT Channel 0 and can display the user input Check Input gt Echo input gt Echo to All Terminals Each output line is prefixed by the Terminal it has been sent to Additionally output on Terminal 1 is shown in red output on Terminals 2 15 in grey Terminal 0 15 E
260. electable integer value in kHz It is recommended to use either a fixed speed or if it is available on the target adaptive speeds Default inter face speed is 100kHz Syntax Speed Speed kHz Example JLink exe Speed 4000 3 2 3 Using command files J Link commander can also be used in batch mode which allows the user to use J Link commander for batch processing and without user interaction Please do not confuse command file with J Link script files please refer to J Link script files on page 204 for more information about J Link script files When using J Link com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 101 mander in batch mode the path to a command file is passed to it The syntax in the command file is the same as when using regular commands in J Link commander one line per command SEGGER recommends to always pass the device name via command line option due some devices need special handling on connect reset in order to guarantee proper function Example JLink exe device STM32F103ZE CommanderScript C CommandFile jlink Contents of CommandFile jlink sil speed 4000 r h loadbin C firmware bin 0x08000000 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 102 CHAPTER 3 J Link software and documentation package 3 3 J Link GDB Server The GNU Project Debugger GDB is a freely available and open source debugger It can be used
261. elow Find below a small sample which shows how to program multiple targets in parallel J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 292 CHAPTER 10 J Flash SPI Project settings EN General interface Fash J Flash SPI is a software for J Link This software is capable of programming SPI flash memories Connection to J Link USB Device 0 ICP IP ECHO OFF ECHO Open first project which is configured to connect to the first J Link Open data file start auto processing and exit open JFlashSPI exe openprjC Projects Project01 jflash openC Data data bin 0x100000 auto exit IF ERRORLEVEL 1 goto ERROR ECHO Open second project which is configured to connect to the second J Link Open data file start auto processing and exit open JFlashSPI exe openprjC Projects Project02 jflash openC Data data bin 0x100000 auto exit IF ERRORLEVEL 1 goto ERROR ECHO Open third project which is configured to connect to the third J Link Open data file start auto processing and exit open JFlashSPI exe openprjC Projects Project03 jflash openC Data data bin 0x100000 auto exit IF ERRORLEVEL 1 goto ERROR goto END ERROR ECHO J Flash SPI Error pause END Note that every call of JFlashSPI exe has to completed with the exit option oth erwise stops the execution of the batch file and the fol
262. em which is able to erase and program the flash This program is called RAM code and knows how to program the flash it contains an implementa tion of the flash programming algorithm for the particular flash Different flash chips have different programming algorithms the programming algorithm also depends on other things such as endianess of the target system and organization of the flash memory for example 1 8 bits 1 16 bits 2 16 bits or 32 bits The RAM code requires data to be programmed into the flash memory There are 2 ways of supply ing this data Data download to RAM or data download via DCC 15 4 2 Data download to RAM The data or part of it is downloaded to another part of the RAM of the target sys tem The Instruction pointer R15 of the CPU is then set to the start address of the RAM code the CPU is started executing the RAM code The RAM code which con tains the programming algorithm for the flash chip copies the data into the flash chip The CPU is stopped after this This process may have to be repeated until the entire data is programmed into the flash 15 4 3 Data download via DCC In this case the RAM code is started as described above before downloading any data The RAM code then communicates with the host computer via DCC JTAG and J Link J Trace transferring data to the target The RAM code then programs the data into flash and waits for new data from the host The WriteMemory functions of J Lin
263. en source platform independent software framework which has typi cally been used to develop integrated development environment IDE Therefore Eclipse can be used as C C IDE if you extend it with the CDT plug in http www eclipse org cdt CDT means C C Development Tooling project and is designed to use the GDB as default debugger and works without any problems with the GDB Server Refer to http www eclipse org for detailed information about Eclipse Note We only support problems directly related to the GDB Server Problems and questions related to your remaining toolchain have to be solved on your own J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 108 CHAPTER 3 J Link software and documentation package 3 3 3 Supported remote monitor commands J Link GDB Server comes with some functionalities which are not part of the standard GDB These functions can be called either via a gdbinit file passed to GDB Server or via monitor commands passed directly to GDB forwarding them to GDB Server To indicate to GDB to forward the command to GDB Server monitor has to be prepended to the call For example a reset can be triggered in the gdbinit file with reset or via GDB with monitor reset Following remote commands are available Remote command Explanation clrbp Removes an instruction breakpoint epis Reads or writes from to cp15 register device Select the specified target dev
264. ends on J Link model Any ARM7 9 11 including thumb mode Cortex A5 A8 Cortex M0 M1 M3 M4 Cortex R4 core supported Automatic core recognition Maximum JTAG speed 12 25 MHz depends on J Link model Seamless integration into all major IDEs https segger com jlink ide integra tion html No power supply required powered through USB Support for adaptive clocking All JTAG signals can be monitored target voltage can be measured Support for multiple devices Fully plug and play compatible Standard 20 pin JTAG SWD connector 19 pin JTAG SWD and Trace connector standard 38 pin JTAG Trace connector USB and 20 pin ribbon cable included Memory viewer J Mem included Remote server included which allows using J Trace via TCP IP networks RDI interface available which allows using J Link with RDI compliant software Flash programming software J Flash available Flash DLL available which allows using flash functionality in custom applications Software Developer Kit SDK available Full integration with the IAR C SPY debugger advanced debugging features available from IAR C SPY debugger 14 pin JTAG adapter available J Link 19 pin Cortex M Adapter available J Link 9 pin Cortex M Adapter available Adapter for 5V JTAG targets available for hardware revisions up to 5 3 Optical isolation adapter for JTAG SWD interface available Target power supply via pin 19 of the JTAG SWD interface up to 300 mA to tar get with overload protecti
265. ent the bypass and the bound ary scan register Other registers are allowed but are not obligatory Bypass data register A single bit register that passes information from TDI to TDO Boundary scan data register A test data register which allows the testing of board interconnections access to input and output of components when testing their system logic and so on 15 1 3 Instruction register The instruction register holds the current instruction and its content is used by the TAP controller to decide which test to perform or which data register to access It consist of at least two shift register cells J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 409 15 1 4 The TAP controller The TAP controller is a synchronous finite state machine that responds to changes at the TMS and TCK signals of the TAP and controls the sequence of operations of the circuitry TAP controller state diagram Reset gt tms 1 tms 0 IR Scan DR Scan tms 0 tms 0 Capture DR Capture IR tms 1 tms 0 tms 0 tms 0 Pause DR Pause IR tms 1 tms 0 tms 1 tms 0 ime Exit2 DR tms 0 Exit2 IR tms 1 tms 1 Update IR tms 1 tms 0 Update DR M 15 1 4 1 State descriptions Reset The test logic is disabled so that normal operation of the chip logic can continue unhindered No matter in which state the TAP c
266. equence Cache flash contents If enabled the flash content is cached by the J Link RDI software to avoid reading data twice and to speed up the transfer between debugger and target Allow flash download This allows the J Link RDI software to download program into flash A small piece of code will be downloaded and executed in the target RAM which then programs the flash memory This provides flash loading abilities even for debuggers without a build in flash loader An info window can be shown during download displaying the current operation Depending on your JTAG speed you may see the info window only very short J Link flash programming Finished flash programming J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 326 CHAPTER 11 RDI 11 4 4 5 Breakpoints tab J Link RDI Configuration 24 x General Init JTAG Flash Breakpoints CPU Log Software breakpoints as opposed to hardware breakpoints are breakpoints which modify program memory This allows setting an unlimited number of breakpoints if the program is located in RAM Use flash breakpoints Allows setting an unlimited number of breakpoints if the program is located in RAM or flash which is extremely valuable when debugging a program located in flash This feature is available only if flash programming is enabled v Show info window during program Cancel Apply Use softwa
267. er folder You can choose not to install J Link ARM V3 58c by clicking Cancel to exit Setup Destination Folder CX SSEGGERMLinkARM V358c 4 The Choose options dialog is opened The Install J Link Serial Port Driver installs the driver for J Links with CDC functionality It is not preselected since J Links without CDC functionality do not need this driver The Create entry in start menu creates an entry in start menu It is prese lected The Add shortcuts to desktop option can be selected in order to create a shortcut on the desktop Accept or deselect the options and confirm the selection with the Next button a Choose options Choose options for creating shortcuts Create entry in start menu IV Add shortcuts to desktop J Link J Trace UM08001 Cancel 2004 2015 SEGGER Microcontroller GmbH amp Co KG 158 CHAPTER 4 Setup 5 The installation process will start 6 The J Link DLL Updater pops up which allows you to update the DLL of an installed IDE to the DLL verion which is included in the installer For further infor mation about the J Link DLL updater please refer to J Link DLL updater on page 169 The following 3rd party applications using JLink amp RM dll have been found Keil MDK V4 72a DLL V4 68a in C KeilV472a 4RM Segger Select All SelectNone Select the ones you would like to replace by this version The previous ve
268. ers are supported by the J Link script file language e const e signed e unsigned 5 11 5 4 Supported declarators The following type qualifiers are supported by the J Link script file language e Array declarators 5 11 5 5 Supported selection statements The following selection statements are supported by the J Link script file language e if statements e if else statements 5 11 5 6 Supported iteration statements The following iteration statements are supported by the J Link script file language e while e do while 5 11 5 7 Jump statements The following jump statements are supported by the J Link script file language return 5 11 5 8 Sample script files The J Link software and documentation package comes with sample script files for different devices The sample script files can be found at SJLINK_INST_DIR Sam ples JLink Scripts J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 216 CHAPTER 5 Working with J Link and J Trace 5 11 6 Script file writing example In the following a short example of how a J Link script file could look like In this example we assume a JTAG chain with two devices on it Cortex A8 4 bits IRLen cus tom device 5 bits IRLen void InitTarget void Report J Link script example JTAG Reset Perform TAP reset and J Link JTAG auto detection if JTAG TotalIRLen 9 Basic check if JTAG chain information matches MessageBox C
269. erver J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI Note In order to use ETM trace on ARM7 9 targets a J Trace is needed 2004 2015 SEGGER Microcontroller GmbH amp Co KG 74 CHAPTER 2 2 4 7 Flasher ARM Flasher ARM is a programming tool for microcontrollers with on chip or external Flash memory and ARM core Flasher ARM is designed for programming flash targets with the J Flash soft ware or stand alone In addition to that Flasher ARM has all of the J Link functionality Flasher ARM connects via USB or via RS232 interface to a PC running Microsoft Windows 2000 or later Flasher ARM has a built in 20 pin JTAG connector which is compatible with the standard 20 pin connector defined by ARM Licenses Comes with built in licenses for flash download and J Flash Flasher Licensing 2 4 8 Flasher RX Flasher RX is a programming tool for Renesas RX600 series microcontrollers with on chip or external flash memory and Renesas RX core Flasher RX is designed for programming flash targets with the J Flash software or stand alone In addition to that Flasher RX has all of the J Link RX functionality Flasher RX connects via Ethernet USB or via RS232 interface to a PC run ning Microsoft Windows 2000 or later Flasher RX itself has a built in 20 pin JTAG connector but is J Link J Trace UM08001 Licenses shipped with an 14 pin adapter for Renesas RX devices Comes with built in licenses for
270. erwise specified by developer s manual pull ups pull downs are recom mended to 100 kOhms 14 1 1 3 Target power supply Pin 19 of the connector can be used to supply power to the target hardware Supply voltage is 5V max current is 300mA The output current is monitored and protected against overload and short circuit Power can be controlled via the J Link com mander The following commands are available to control power Command Explanation power on Switch target power on power off Switch target power off power on perm Set target power supply default to on power off perm Set target power supply default to off Table 14 2 Command List J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 393 14 1 2 Pinout for SWD The J Link and J Trace JTAG connector is also com 798 patible to ARM s Serial Wire Debug SWD Notused GND 5e e6 On later J Link products like the J link ULTRA 2 cee these pins reserved for firmware extension pur 9e e10 GND poses They can be left open or connected to GND in Notused 11e e12 GND normal debug environment They are not essential swo 13 14 GND for JTAG SWD in general RESET 15 16 GND Not used 17 18 GND The following table lists the J Link J Trace SWD 5v supply 19 e20 GND pinout PIN SIGNAL TYPE Description
271. es per channel for the control block in RAM Each channel requires some memory for the buffer The recommended sizes are 1 kByte for up channels and 16 to 32 Bytes for down channels depending on the load of in output J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 338 CHAPTER 12 RTT 12 3 RTT Communication Communication with the RTT implementation on the target can be done with different applications The functionality can even be integrated into custom applications using the J Link SDK Using RTT in the target application is made easy The implementation code is freely available for download and can be integrated into any existing application To com municate via RTT any J Link can be used The simple way to communicate via the Terminal Channel 0 is to create a connec tion to localhost 19021 with a Telnet client or similar when a connection to J Link e g via a debug session is active The J Link Software Package comes with some more advanced applications which demonstrates RTT functionality for different purposes 12 3 1 J Link RTT Viewer E J Link RTT Viewer V4 96 o F e Terminals Input Data Help BG CYAN RTT CTRL BG WHITE J Link RTT Viewer is a Windows GUI application to use all features of RTT in one application It supports Displaying terminal output of Channel 0 Up to 16 virtual Terminals on Channel O Sending text input to Channel 0 Interpr
272. es of the fast GPIO registers in the C SPY debugger are correct and can be used for debugging For more information about J Link command line options refer to subchapter Command strings on page 218 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 375 13 11 1 2RDI J Link comes with a device based RDI license for NXP LPC21xx LPC24xx devices This means the J Link RDI software can be used with LPC21xx LPC24xx devices free of charge For more information about device based licenses please refer to License types on page 69 13 11 2 Reset Cortex M3 based devices For Cortex M3 based NXP LPC devices the reset itself does not differ from the one for other Cortex M3 based devices After the device has been reset the core is halted before any instruction is performed For the Cortex M3 based LPC devices this means the CPU is halted before the bootloader which is mapped at address 0 after reset The user should write the memmap register after reset to ensure that user flash is mapped at address 0 Moreover the user have to correct the Stack pointer R13 and the PC R15 manually after reset in order to debug the application 13 11 3 LPC288x flash programming In order to use the LPC288x devices in combination with the J Link flash download feature the application you are trying to debug should be linked to the original flash addr 0x10400000 Otherwise it is user s responsibility to ensure that flash is re
273. etLED 0 while 1 BSP ToggleLED cente _Delay 0 0 0x0 Filename Address Unitsize 8bit Address 0 000000 Go 5 aa 000000000 04 0 1f eS Bc 00 10 00 60 00 9f e5 OF 0 a0 ei xi 8c e0 ae Code C Tool C emiIDE V21VermVExempleWend oxoooo0010 10 f 26 ei 58 10 94 es 58 20 9f es 58 30 9f es Code C Too C emiDE V21 arm Example Vend 0x00000020 03 00 52 ei 04 00 91 34 04 00 82 34 fb ff ff 0500000030 48 10 9f eS 48 20 9f eS 00 30 a0 e3 02 00 51 el 0x0 0x0 0x2004 0 209841 0 0 0 0x0 0 0 0 0 6 0x00000040 04 30 81 14 fc ff ff 1a 00 00 Of el cO 00 cO 0500000050 00 0 29 1 00 00 a0 e3 00 10 a0 24 20 9f e5 0x00000060 Of e0 a0 el 12 ff 2f el fe ff ff ea le ff 2f el 0x00000070 00 10 00 60 02 10 00 00 00 20 00 00 00 20 00 0x00000080 00 00 20 00 00 00 20 00 28 02 10 00 db 0 21 Variable Value 0x00000090 2c 40 eS 47 0 21 e3 28 40 9f e5 d1 0 21 cut 0x00000000 0 000000 0 24 40 9f eS d2 0 21 e3 20 40 9f 5 43 0 21 0x000000b0 1 dO 9f eS 1c 00 9f eS 0f a0 el 10 ff 2f el 05000000 0 fe ff ea 00 01 20 00 00 01 20 00 00 00 20 00 0x00000040 00 01 20 00 00 OS 20 00 00 10 00 10 30 9f es 0x000000e0 02 29 a0 00 20 83 eS 01 30 a0 03 00 a0 1 0x000000f0 1e ff 2f el 44 ff ff 3c 30 9f eS 38 20 9 5
274. etRXIDCode 112233445566778899AABBCCDDEEFF00 5 12 1 57SetSkipProgOnCRCMatch Note Deprecated Use SetCompareMode instead This command is used to configure the CRC match compare mode Syntax SetSkipProgOnCRCMatch lt CompareMode gt Compare mode Description 0 Skip 1 Using fastest method default 2 Using CRC 3 Using readback Example SetSkipProgOnCRCMatch 1 Select using fastest method J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 233 5 12 1 58 SetSysPowerDownOnldle When using this command the target CPU is powered down when no transmission between J Link and the target CPU was performed for a specific time When the next command is given the CPU is powered up Note This command works only for Cortex M3 devices Typical applications This feature is useful to reduce the power consumption of the CPU Syntax SetSysPowerDownOnIdle lt value gt Note A 0 for value disables the power down on idle functionality Example SetSysPowerDownOnIdle 10 The target CPU is powered down when there is no transmission between J Link and target CPU for at least 10ms 5 12 1 59SetVerifyDownload This command is used to configure the verify mode Syntax SetVerifyDownload lt VerifyMode gt Verify mode Description Skip Programmed sectors fastest method default Programmed sectors using CRC Programmed sectors using
275. eter Meaning Zone Name of memory zone to access Addr Start address NumBytes Number of bytes to read Maximum is 0x8000 Example memi16 0 100 3 2 1 25 mem32 The command reads memory from the target system in units of 32 bits If necessary the target CPU is halted in order to read memory J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 92 CHAPTER 3 J Link software and documentation package Syntax mem32 lt Zone gt lt Addr gt lt NumBytes gt hex Parameter Meaning zone Name of memory zone to access Addr Start address NumBytes Number of bytes to read Maximum is 0x4000 Example mem32 0 100 3 2 1 26 mem64 The command reads memory from the target system in units of 64 bits If necessary the target CPU is halted in order to read memory Syntax mem64 lt Zone gt lt Addr gt lt NumBytes gt hex Parameter Meaning zone Name of memory zone to access Addr Start address NumBytes Number of bytes to read Maximum is 0x4000 Example mem64 0 100 3 2 1 27 mr Measure reaction time of RTCK pin Syntax mr lt RepCount gt Parameter Meaning RepCount Number of times the test is repeated Default 1 Example mr 3 3 2 1 28 ms Measures the number of bits in the specified scan chain Syntax ms lt ScanChain gt Parameter Meaning ScanChain Scan chain to be measured
276. etermine the JTAG chain configuration are set to the correct values For more information about the known global DLL variables please refer to Global DLL variables on page 210 Note This will not work for devices which need some special init for example to add the core to the JTAG chain which is lost at a TAP reset Prototype api int JTAG Reset void 5 11 2 17SYS Sleep Description Waits for a given number of miliseconds During this time J Link does not communi cate with the target J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 208 CHAPTER 5 Working with J Link and J Trace Prototype api int SYS Sleep int Delayms 5 11 2 18 JLINK CORESIGHT AddAPY Description Allows the user to manually configure the AP layout of the device J Link is connected to This makes sense on targets on which J Link can not perform a auto detection of the APs which are present on the target system Type can only be a known global J Link DLL AP constant For a list of all available constants please refer to Global DLL constants on page 213 Prototype api int JLINK CORESIGHT AddAP int Index unsigned int Example JLINK CORESIGHT AddAP 0 CORESIGHT AHB AP First AP is a AHB AP JLINK CORESIGHT AddAP 1 CORESIGHT APB AP Second AP is a APB AP JLINK CORESIGHT AddAP 2 CORESIGHT JTAG AP Third AP is a JTAG AP 5 11 2 19JLINK_CORESIGHT_Configure Descripti
277. eting text control codes for colored text and controling the Terminal Logging data on Channel 1 12 3 1 1 RTT Viewer Startup Make sure J Link and target device are connected and powered up Start RTT Viewer by opening the executable JLinkRTTViewer exe from the installa tion folder of the J Link Software or the start menu The Configuration Dialog will pop up Configure the Connection Settings as described below and click OK The connection settings and all in app configuration will be saved for the next start of RTT Viewer 12 3 1 2 Connection Settings RTT Viewer can be used in two modes e Stand alone opening an own connection to J Link and target J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 339 e In attach mode connecting to an existing J Link connection of a debugger J Link RTT Viewer V4 96 Configuration p Connection to J Link USB Serial No 174200001 C TCP IP C Existing Session Target Device STM32FA07IE Target Interface amp Speed swo 12000 kHz Control Block Address 0 Auto 0 Stand alone connection settings In stand alone mode RTT Viewer needs to know some settings of J Link and target device Select USB or TCP IP as the connection to J Link For USB a specific J Link serial number can optionally be entered for TCP IP the IP or hostname of the J Link has to be entered S
278. even connected The application program will continue to work I do not see any output although the use of RTT in my application is correct What can I do In some cases J Link cannot locate the RTT buffer in the known RAM region In this case the possible region or the exact address can be set manually via a J Link exec command Set ranges to be searched for RTT buffer SetRTTSearchRanges RangeStart Hex lt RangeSize gt lt RangelStart Hex lt RangeiSize gt e g SetRTT SearchRanges 0x10000000 0x1000 0x2000000 0x1000 Set address of the RTT buffer SetRTTAddr RTTBufferAddress Hex e g Set RTTAddr 0x20000000 Set address of the RTT buffer via J Link Control Panel RTTerminal Note J Link exec commands can be executed in most applications for example in J Link Commander via exec lt Command gt in J Link GDB Server via monitor exec lt Command gt or IAR EW via jlinkExecCommand Command from a macro file J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 354 CHAPTER 12 RTT J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 355 Chapter 13 Device specifics This chapter describes for which devices some special handling is necessary to use them with J Link J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 356 13 1 Analog Devices J Link has been tested with the follo
279. execute some instructions before it is halted The number of instructions executed depends primarily on the JTAG speed the higher the JTAG speed the faster the CPU can be halted Some CPUs can actually be halted before executing any instruction because the start of the CPLI is delayed after reset release If a pause has been specified J Link waits for the specified time before trying to halt the CPU This can be useful if a bootloader which resides in flash or ROM needs to be started after reset Cancel Apply Instruction set simulation This enables instruction set simulation which speeds up single stepping instructions especially when using flash breakpoints Reset strategy This defines the way J Link RDI should handle resets called by software J Link supports different reset strategies This is necessary because there is no single way of resetting and halting an ARM core before it starts to execute instructions For more information about the different reset strategies which are supported by J Link and why different reset strategies are necessary please refer to Reset strategies on page 197 11 4 4 7 Log tab A log file can be generated for the J Link DLL and for the J Link RDI DLL This log files may be useful for debugging and evaluating They may help you to solve a prob lem yourself but is also needed by customer support help you Default path of the J Link log file c NJLinkARM log Default path of the J
280. fail SWOFreq has to be a quotient of the CPU and SWO speeds and their prescalers To get available speed use SWO GetSpeediInfo PortMask can be a decimal or hexadecimal Value Values starting with the Prefix Ox are handled hexadecimal Example Configure SWO for stimulus port 0 measure CPU frequency and calculate SWO frequency gt monitor SWO EnableTarget 0 01 0 SWO enabled succesfully Configure SWO for stimulus ports 0 2 fixed SWO frequency and measure CPU frequency gt monitor SWO EnableTarget 0 1200000 5 0 SWO enabled succesfully Configure SWO for stimulus ports 0 255 fixed CPU and SWO frequency gt monitor SWO EnableTarget 72000000 6000000 OxFF 0 SWO enabled succesfully 3 3 3 30 SWO GetMaxSpeed Syntax SWO GetMaxSpeed CPUFrequency Hz Description Prints the maximum SWO speed supported by and matching both J Link and the target CPU frequency Example Get SWO speed for 72MHz CPU speed gt monitor SWO GetMaxSpeed 72000000 Maximum supported SWO speed is 6000000 Hz J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 119 3 3 3 31 SWO GetSpeedinfo Syntax SWO GetSpeedInfo Description Prints the base frequency and the minimum divider of the connected J Link With this the available SWO speeds for J Link can be calculated and the matching one for the target CPU frequency can be selected Example gt monitor SWO GetSpeedIn
281. fer to The J Link settings file on page 203 9 2 3 IAR EWARM Low power handling mode has to be activated in the J Link settings file Open the J Link settings file in a text editor and add the following line in the CPU section LowPowerHandlingMode 1 For more information about how to locate the settings file please refer to The J Link settings file on page 203 9 2 4 Mentor Sourcery CodeBench for ARM Low power handling mode has to be activated in the J Link settings file Open the J Link settings file in a text editor and add the following line in the CPU section LowPowerHandlingMode 1 For more information about how to locate the settings file please refer to The J Link settings file on page 203 9 2 5 GDB GDBServer based setups Eclipse etc As no settings file is created for such setups the low power handling mode has to be activated from the gdbinit gdbinit file by adding the following command monitor exec LowPowerHandlingMode 1 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 276 9 3 CHAPTER 9 Low Power Debugging Restrictions As the connection to the target is temporary lost while it is in low power mode some restrictions during debug apply Make sure that the IDE does not perform periodic accesses to memory while the target is in a low power mode E g Disable periodic refresh of memory windows close live watch windows etc Avoid issuing manual halt
282. ferent types of licenses which are explained in the following Built in License This type of license is easiest to use The customer does not need to deal with a license key The software automatically finds out that the connected J Link contains the built in license s The license is burned into the J Link debug probe and can be used on any computer the J Link is connected to This type of license applies to the J Link PLUS J Link ULTRA and J Link Pro Key based license This type of license is used if you already have a J Link but order a license for a J Link software component at a later time In addition to that the key based license is used for trial licenses To enable this type of license you need to obtain a license key from SEGGER Free trial licenses are available upon request from www segger com This license key has to be added to the J Link license management How to enter a license key is described in detail in Licensing on page 259 Every license can be used on different PCs but only with the J Link the license is for This means that if you want to use flash breakpoints with other J Links every J Link needs a license 2 2 1 Built in license This type of license is easiest to use The customer does not need to deal with a license key The software automatically finds out that the connected J Link contains the built in license s To check what licenses the used J Link have simply open the J Link commander JLink exe Th
283. firmware on page 418 Syntax InvalidateFW 5 12 1 27map exclude This command excludes a specified memory region from all memory accesses All subsequent memory accesses to this memory region are ignored Memory mapping Some devices do not allow access of the entire 4GB memory area Ideally the entire memory can be accessed if a memory access fails the CPU reports this by switching to abort mode The CPU memory interface allows halting the CPU via a WAIT signal On some devices the WAIT signal stays active when accessing certain unused mem ory areas This halts the CPU indefinitely until RESET and will therefore end the debug session This is exactly what happens when accessing critical memory areas Critical memory areas should not be present in a device they are typically a hard ware design problem Nevertheless critical memory areas exist on some devices To avoid stalling the debug session a critical memory area can be excluded from access J Link will not try to read or write to critical memory areas and instead ignore the access silently Some debuggers such as IAR C SPY can try to access memory in such areas by dereferencing non initialized pointers even if the debugged program the debuggee is working perfectly In situations like this defining critical memory areas is a good solution Syntax map exclude lt SAddr gt lt EAddr gt Example This is an example for the map exclude command in combination with an
284. flash The loadfile command supports bin hex mot and srec files Addr is the start address the data file should be written to J Link Commander TAG peed 106 kHz J Link gt speed 4600 JTAG speed 4868 kHz ink gt h R15 gt 66188794 CPSR 28888087F System mode THUMB FIQ dis 66000061 Ri 60202060 R3 8010198F 666001F4 R5 99000088 025992 CEG 660000880 88000000 R11 00000000 R12 6660605F 13 808201FD8 8249 96000000 a E 3 Rii 8B8BBBBBB R12 66600000 028028088 1 6 66666666 d Device 9 gt 1 lt 256 KB flash 64 KB RAM J Link gt loadhin C Te Ri bi targ m 0x00100090 Link Flash mload Flash programming performed for 1 range 16384 byt J Link Flash download Total time needed 6 844s Prepare 6 116s Compar s Program 6 654s Uerify 0 0155 Restore 8 837s5 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 250 CHAPTER 6 Flash download 6 4 6 J Link RDI The configuration for J Link RDI is done via the J Link RDI configuration dialog 5 SEGGER J Link R ta Configuration For more information about the J Link RDI configuration dialog please refer to 0 08004 J Link RDI User Guide chapter Configuration dialog J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 251 6 5 Setup for various debuggers CFI flash The setup for download into CFI compliant memory
285. fo Base frequency 60000000Hz MinDiv 8 Available SWO speeds for J Link are 7 5MHz 6 66MHz 6MHz 3 3 3 32 waithalt Syntax waithalt lt Timeout gt or wh lt Timeout gt Description Waits for target to halt code execution where Timeout is the maximum time period in milliseconds to wait Example Wait for halt with a timeout of 2 seconds monitor waithalt 2000 3 3 3 33 wice Syntax wice RegIndex value or RegIndex value Description Writes to given IceBreaker register where value is the data to write Example gt monitor wice 0x0C 0x100 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 120 CHAPTER 3 J Link software and documentation package 3 3 4 SEGGER specific GDB protocol extensions J Link GDB Server implements some functionality which not part of the standard GDB remote protocol in general query packets These SEGGER specific general query packets can be sent to GDB Server on the low level of GDB via maintanace com mands or with a custom client connected to GDB Server General query packets start with a q SEGGER specific general queries are followed by the identifier Segger plus the command group the actual command and its parameters Following SEGGER specific general query packets are available Query Packet Explanation qSeggerSTRACE config Configure STRACE for usage qSeggerSTRACE sta
286. foWinFlashBPs Disables info window for programming FlashBPs DisableInfoWinFlashDL Disables info window for FlashDL Disables output of additional information about mode DisableMOEHandling of entry in case the target CPU is halted entered debug mode aaa Disables power supply on close EnableAutoUpdateFW Enables automatic firmware update 5 eEraseAllFlashBen Enables erase for all accessible flash banks EnableFlashBPs Enables the FlashBP feature EnableFlashDL Enables the J Link FlashDL feature EnableInfoWinFlashBPs Enables info window for programming FlashBPs EnableInfoWinFlashDL Enables info window for FlashDL Enables output of additional information about mode EnableMOEHandling of entry in case the target CPU is halted entered debug mode Enable detailed output during CPU detection connec EnableRemarks tion process scdudePilahachelange Invalidate flash ranges in flash cache that are config ured to be excluded from flash cache Hide device selection Hide device selection dialog HSSLogFile Logs all HSS Data to file regardless of the application using HSS InvalidateCache Invalidates Cache InvalidateFW Invalidating current firmware map exclude Ignores all memory accesses to specified area Table 5 12 Available command strings J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 219 Command Descr
287. fore execution of the first instruction 5 8 2 4 Type 3 Connect under Reset J Link connects to the target while keeping Reset active reset is pulled low and remains low while connecting to the target This is the recommended reset strategy for STM32 devices This reset strategy has been designed for the case that communi cation with the core is not possible in normal mode so the vc CORERESET bit can not be set in order to guarantee that the core is halted immediately after reset J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 200 CHAPTER 5 Working with J Link and J Trace 5 8 2 5 Type 4 Reset core amp peripherals halt after bootloader Same as type 0 but bootloader is always executed This reset strategy has been designed for MCUs CPUs which have a bootloader located in ROM which needs to run at first after reset since it might initialize some target settings to their reset state When using this reset strategy J Link will let the bootloader run after reset and halts the target immediately after the bootloader and before the target application is started This is the recommended reset strategy for LPC11xx and LPC13xx devices where a bootloader should execute after reset to put the chip into the real reset state 5 8 2 6 Type 5 Reset core amp peripherals halt before bootloader Basically the same as reset type 8 Performs a reset of core amp peripherals and halts the CPU immediately
288. get interface voltage Vip 1 2V 5V Voltage interface low pulse Viri Max 40 of Vir Voltage interface high pulse Vr Min 6096 of Vir Trace Interface Timing TRACECLK low pulse width Ty Min 2ns TRACECLK high pulse width Twp Min 2ns Data rise time T4 Max 3ns Data fall time Tra Max 3ns Clock rise time Max 3ns Clock fall time Max 3ns Data setup time Ti Min 3ns Data hold time Ty Min 2ns Table 1 12 J Trace for Cortex M3 specifications 1 3 9 3 Download speed The following table lists performance values Kbytes s for writing to memory RAM Hardware Cortex M3 190 Kbytes s 12MHz SWD 760 KB s 12 MHz JTAG 190 Kbytes s 12MHz SWD 1440 KB s 25 MHz JTAG Table 1 13 Download speed differences between hardware revisions J Trace for Cortex M3 V2 J Trace for Cortex M V3 1 The actual speed depends on various factors such as JTAG clock speed host CPU core etc 1 3 9 4 Hardware versions Version 2 Obsolete Version 3 1 Identical to version 2 0 with the following exceptions e Hi Speed USB e Voltage range for trace signals extended to 1 2 3 3 V e Higher download speed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 56 CHAPTER 1 Introduction Hardware version 2 3 1 Hardware features USB JTAG interface SWD interface SWO interface ETM Trace
289. gister Shift IR The instruction register shifts the values in the instruction register towards TDO with each clock Exit1 IR Temporary controller state Pause IR Wait state that temporarily halts the instruction shifting Exit2 IR Temporary controller state Allows to either go back into Shift IR state or go on to Update IR Update IR The values contained in the instruction register are loaded into a latched parallel out put from the shift register path Once latched this new instruction becomes the cur rent one The parallel latch prevents changes at the parallel output of the instruction register from occurring during the shifting process J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 411 15 2 Embedded Trace Macrocell ETM Embedded Trace Macrocell ETM provides comprehensive debug and trace facilities for ARM processors ETM allows to capture information on the processor s state with out affecting the processor s performance The trace information is exported immedi ately after it has been captured through a special trace port Microcontrollers that include an ETM allow detailed program execution to be recorded and saved in real time This information can be used to analyze program flow and execution time perform profiling and locate software bugs that are otherwise very hard to locate A typical situation in which code trace is extremely valuable is to find out how and why a pr
290. gure target for SWO and enable it in J Link SWO GetMaxSpeed Prints the maximum supported SWO speed for J Link and Target CPU SWO GetSpeedInfo Prints the available SWO speed and its minimum divider waithalt Waits for target to halt code execution wice Writes to given IceBreaker register Table 3 3 GDB remote commands J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 109 Following remote commands are deprecated and only available for backward compa bility Remote command Explanation Select the specified target device device Note Use command line option device instead Select the target interface interface Note Use command line option i instead Sets the JTAG speed of J Link J Trace speed Note For the initial connection speed use com mand line option speed instead Table 3 4 GDB remote commands Note The remote commands are case insensitive Note Optional parameters are set into square brackets Note The examples are described as follows Lines starting with are comments and not used GDB GDB Server Lines starting with gt gt are input commands from the GDB Lines starting with is the output from GDB Server as printed in GDB J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 110 CHAPTER 3 J Link software and documentation package 3 3 3 1 clrbp Syntax CIrBP lt BPHandle gt
291. has been adapted to work on every target even if the reset pin Pin 15 is not connected What is the problem if the core executes some instructions after RESET The instructions which are executed can cause various problems Some cores can be completely confused which means they can not be switched into debug mode CPU can not be halted In other cases the CPU may already have initialized some hard ware components causing unexpected interrupts or worse the hardware may have been initialized with illegal values In some of these cases such as illegal PLL set tings the CPU may be operated beyond specification possibly locking the CPU 5 8 1 Strategies for ARM 7 9 devices 5 8 1 1 Type 0 Hardware halt after reset normal The hardware reset pin is used to reset the CPU After reset release J Link continu ously tries to halt the CPU This typically halts the CPU shortly after reset release the CPU can in most systems execute some instructions before it is halted The num ber of instructions executed depends primarily on the JTAG speed the higher the JTAG speed the faster the CPU can be halted Some CPUS can actually be halted before executing any instruction because the start of the CPU is delayed after reset release If a pause has been specified J Link waits for the specified time before trying to halt the CPU This can be useful if a bootloader which resides in flash or ROM needs to be started after reset This reset stra
292. he CPU frequency auto detection of the J Link DLL To select a ST STM32F207IG as target device the command line should look as below J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 143 For a list of all supported device names please refer to lt Ref gt Syntax device lt DeviceID gt Example deivce STM32F2071G 3 7 2 3 itmmask Defines a set of stimulusports from which SWO data is received and displayed by SWO Viewer If itmmask is given itmport will be ignored Syntax itmmask Mask Example Listen on ports 0 and 2 itmmask 0x5 3 7 2 4 itmport Defines the stimulus port from which SWO data is received and displayed by the SWO Viewer Default is stimulus port 0 The command line should look as below Syntax itmport lt ITMPortIndex gt Example itmport 0 3 7 2 5 outputfile Define a file to which the output of SWO Viewer is printed Syntax outputfile lt PathToFile gt Example outputfile C Temp Output log 3 7 2 6 settingsfile Select a J Link settings file to use for the target device Syntax settingsfile lt PathToFile gt Example settingsfile C Temp Settings jlink 3 7 2 7 swofreq Define the SWO frequency that shall be used by J Link SWO Viewer for sampling SWO data Usually not necessary to define since optimal SWO speed is calculated automatically based on the CPU frequency and the capabilities of the
293. he checkbox left to the IAR installation which has been found Click Ok in order to update the JLinkARM d11 used by the IAR installation 13 SEGGER J Link DLL Updater 3 86 x The following 3rd party applications using JLink amp RM dll have been found IAR Embedded Workbench for ARM 4 404 DLL V3 20h in VA40ANARMbin IAR Embedded Workbench for ARM 4 414 DLL V3 80c in C ToolKCMARARM_V4414 4RM bin IAR Embedded Workbench for ARM 4 424 DLL V3 84 in V442ANARMbin vi IAR Embedded Workbench for ARM 4 314 DLL V3 82 in CAT ool C AR WARM_V4314 4RM bin IAR Embedded Workbench for ARM 4 304 DLL V3 80c in C Tool CMARARM_V4304 4RM bin IAR Embedded Workbench for ARM 5 10 DLL V3 78d in ENTooNCMARNARM V5TONARMbin IAR Embedded Workbench for ARM 5 20 DLL V3 85f in C NTooNCMARNSARM 520 betaB85ARMbin IAR Embedded Workbench for ARM 5 20 DLL V3 85j in C NTooNCXARNARM V520 beta302NARMbin IAR Embedded Workbench for ARM 5 11 DLL V3 78 in NTooNCMARNSARM V511 BETA B 7XARMbin IAR Embedded Workbench for ARM 5 11 DLL V3 85h in C T ooh CMAR SARM V511 3799V4RMbin Select All Select None Select the ones you would like to replace by this version The previous version will be renamed and kept in the same folder allowing manual undo In case of doubt do not replace existing DLL s fou can a
294. he current device A device has to be specified previously Syntax erase 3 2 1 5 exec Execute command string For more information about the usage of command strings please refer to Command strings on page 218 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 87 Syntax exec lt Command gt Parameter Meaning Command Command string to be executed Example exec SupplyPower 1 3 2 1 6 exit qc q This command closes the target connection the connection to the J Link and exits J Link Commander Syntax 3 2 1 7 exitonerror eoe This command toggles whether J Link Commander exits on error or not Syntax ExitOnError 1 0 Parameter Meaning lt 1 0 gt 1 J Link Commander will now exit on Error 0 J Link Commander will no longer exit on Error Example eoe 1 3 2 1 8 f Prints firmware and hardware version info Please notice that minor hardware revi sions may not be displayed as they do not have any effect on the feature set Syntax f 3 2 1 9 fdelete fdel On emulators which support file I O this command deletes a specific file Syntax fdelete FileName Parameter Meaning FileName File to delete from the Flasher Example fdelete Flasher dat J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 88 CHAPTER 3 J Link software and documentation package 3 2 1 10 fl
295. hich are shown in this section are e Process Shows the path of the file which loaded the DLL e J Link Shows OEM of the connected J Link the hardware version and the Serial number If no J Link is connected it shows not connected and the color indica tor is red Target interface Shows the selected target interface JTAG SWD and the cur rent JTAG speed The target current is also shown Only visible if J Link is con nected Endian Shows the target endianess Only visible if J Link is connected Device Shows the selected device for the current debug session License Opens the J Link license manager About Opens the about dialog J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG CHAPTER 5 Working with J Link and J Trace 5 7 1 2 Settings In the Settings section project and debug specific settings can be set It allows the configuration of the use of flash download and flash breakpoints and some other tar get specific settings which will be explained in this topic Settings are saved in the configuration file This configuration file needs to be set by the debugger If the debugger does not set it settings can not be saved All settings which are modified during the debug session have to be saved by pressing Save settings otherwise they are lost when the debug session is closed Section Flash download In this section settings for the use of the J Link FlashDL feature and related
296. hich needs to be accepted when installing the software The text of the license agreement is also available as entry in the start menu after installing the software Use of software SEGGER J Link software may only be used with original SEGGER products and autho rized OEM products The use of the licensed software to operate SEGGER product clones is prohibited and illegal 2 3 1 Use of the software with 3rd party tools For simplicity some components of the J Link software are also distributed by part ners with software tools designed to use J Link These tools are primarily debugging tools but also memory viewers flash programming utilities as well as software for other purposes Distribution of the software components is legal for our partners but the same rules as described above apply for their usage They may only be used with original SEGGER products and authorized OEM products The use of the licensed soft ware to operate SEGGER product clones is prohibited and illegal J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 71 2 4 Original SEGGER products All of the follwing SEGGER products are supported by the OSs stated in Chapter 1 2 Supported OS The following products are original SEGGER products for which the use of the J Link software is allowed 2 4 1 J Link BASE J Link BASE is a JTAG emulator designed for ARM cores It con nects via USB or Ethernet to a PC running Microsoft Wind
297. hing sequence etc once JLINK CORESIGHT Configure completes 5 11 2 20JLINK CORESIGHT ReadAPY Description Reads a specific AP register For JTAG makes sure that AP is selected automatically Makes sure that actual data is returned meaning for register read accesses which usually only return data on the second access this function performs this automati cally so the user will always see valid data Prototype int JLINK CORESIGHT ReadAP unsigned int RegIndex Example v JLINK CORESIGHT ReadAP JLINK CORESIGHT AP REG DATA Reportl DATA v 5 11 2 21JLINK CORESIGHT ReadDPY Description Reads a specific DP register For JTAG makes sure that DP is selected automatically Makes sure that actual data is returned meaning for register read accesses which usually only return data on the second access this function performs this automati cally so the user will always see valid data Prototype int JLINK CORESIGHT ReadDP unsigned int RegIndex Example v JLINK CORESIGHT ReadDP JLINK CORESIGHT DP REG IDCODE Reporti DAP IDCODE v J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 210 CHAPTER 5 Working with J Link and J Trace 5 11 2 22JLINK_CORESIGHT_WriteAP Description Writes a specific AP register For JTAG makes sure that AP is selected automatically Prototype int JLINK CORESIGHT WriteA
298. his section currently just the power consumption of the target hardware is shown 13 J Link ARM J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 196 CHAPTER 5 Working with J Link and J Trace 5 7 1 7 SWV In this section SWV information are shown 13 J Link ARM e Status Shows the encoding and the baudrate of the SWV data received by the target Manchester UART currently J Link only supports UART encoding e Bytes in buffer Shows how many bytes are in the DLL SWV data buffer e Bytes transferred Shows how many bytes have been transferred via SWV since the debug session has been started e Refresh counter Shows how often the SWV information in this section has been updated since the debug session has been started e Host buffer Shows the reserved buffer size for SWV data on the host side e Emulator buffer Shows the reserved buffer size for SWV data on the emulator side J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 197 5 8 Reset strategies J Link J Trace supports different reset strategies This is necessary because there is no single way of resetting and halting a CPU core before it starts to execute instruc tions For example reset strategies which use the reset pin can not succeed on tar gets where the reset pin of the CPU is not connected to the reset pin of the JTAG connector Reset strategy 0 is always the recommended one because it
299. how to enable disable the ply power supply please refer to Target power supply on page 394 Table 14 5 J Link J Trace SWD pinout Pins 4 6 8 10 12 14 16 18 20 are GND pins connected to GND in J Link They should also be connected to GND in the target system J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 396 CHAPTER 14 Target interfaces and adapters 14 1 4 Pinout for SPI On later J Link products like the J link ULTRA in normal debug environment these pins are reserved for firmware extension pur 222 be left open or connected to GND virer A NC NC 3e GND DI 5e e GND nCS 7e e GND CLK 9e e GND NC P e 12 GND DO 13 e GND nRESET 15 e e GND NC 17 e GND The following table lists the pinout for the SPI inter 5V Supply 19 e GND face on J Link PIN SIGNAL TYPE Description This is the target reference voltage It is used to check if the target has power to create the logic level reference for 1 VTref Input the input comparators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor Not con 2 nected NC Leave open on target side Not con 3 nected NC Leave open on target side Data input of target SPI Output of J Link used to transmit ax data to the target SPI 7 5 Output Chi
300. ication Filter matched 32 of 32 items e Click Apply e Inthe Files tab select the application to download e In the Debugger tab select Debug from symbol and enter main or select Debug from entry point Click Apply Start a new debug session with the newly created debug configuration Now the debug session should start and downloaded the application to the tar get J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 173 Chapter 5 Working with J Link and J Trace This chapter describes functionality and how to use J Link and J Trace J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 174 CHAPTER 5 Working with J Link and J Trace 5 1 Connecting the target system 5 1 1 Power on sequence In general J Link J Trace should be powered on before connecting it with the target device That means you should first connect J Link J Trace with the host system via USB and then connect J Link J Trace with the target device via JTAG Power on the device after you connected J Link J Trace to it 5 1 2 Verifying target device connection If the USB driver is working properly and your J Link J Trace is connected with the host system you may connect J Link J Trace to your target hardware Then start JLink exe which should now display the normal J Link J Trace related information and in addition to that it should report that it found a JTAG targe
301. ice Do not check if an abort occurred after memory read DisableChecks ARM7 9 only oe 5 if an abort occurred after memory read 7 9 flash breakpoints Enables Disables flash breakpoints getargs Get the arguments for the application go Starts the target CPU halt Halts the target CPU jtagconf Configures a JTAG scan chain with multiple devices on it memu8 Reads or writes a byte from to given address memU16 Reads or writes a halfword from to given address memU32 Reads or writes a word from to given address reg Reads or writes from to given register regs Reads and displays all CPU registers reset Resets and halts the target CPU B te preakOn Enable or disable halting the target on semihosting error semihosting enable Enables semihosting semihosting IOClient Set semihosting I O to be handled via Telnet port or GDB semihosting ARMSWI Sets the SWI number used for semihosting in ARM mode i Sets the SWI number used for semihosting in thumb semihosting ThumbSWI mode setargs Set the arguments for the application setbp Sets an instruction breakpoint at a given address sleep Sleeps for a given time period speed Sets the JTAG speed of J Link J Trace step Performs one or more single instruction steps SWO DisableTarget Undo target configuration for SWO and disable it in J Link SWO EnableTarget Confi
302. ice to use its flash breakpoints J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 264 CHAPTER 7 Flash breakpoints J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 265 Chapter 8 Monitor Mode Debugging This chapter describes how to use monitor mode debugging support with J Link J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 266 8 1 CHAPTER 8 Monitor Mode Debugging Introduction In general there are two standard debug modes available for CPUs 1 Halt mode 2 Monitor mode Halt mode is the default debug mode used by J Link In this mode the CPU is halted and stops program execution when a breakpoint is hit or the debugger issues a halt request This means that no parts of the application continue running while the CPU is halted in debug mode and peripheral interrupts can only become pending but not taken as this would require execution of the debug interrupt handlers In circum stances halt mode may cause problems during debugging specific systems 1 Certain parts of the application need to keep running in order to make sure that com munication with external components does not break down This is the case for Blue tooth applications where the Bluetooth link needs to be kept up while the CPU is in debug mode otherwise the communication would fail and a resume or single stepping of the user application would not be po
303. icense for flash download is required The flash breakpoint feature allows setting an unlimited num ber of breakpoints even if the application program is not located in RAM but in flash memory Without this feature the number of breakpoints which can be set in flash is limited to the number of hardware breakpoints typically two for ARM 7 9 up to six for Cortex M For more information about flash breakpoints please refer to Flash breakpoints on page 257 2 Most IDEs come with its own flashloaders so in most cases this feature is not essential for debugging applications in flash The J Link flash download feature is mainly used in debug environments where the debugger does not come with an own flashloader for example the GNU Debugger For more information about how flash download via FlashDL works please refer to Flash download on page 241 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 30 CHAPTER 1 Introduction 1 3 2 J Link BASE J Link BASE is a JTAG emulator designed for ARM cores It con nects via USB to a PC running Microsoft Windows 2000 or later For a complete list of all operating systems which are sup ported please refer to Supported OS on page 27 J Link BASE has a built in 20 pin JTAG connector which is compatible with the standard 20 pin connector defined by ARM 1 3 2 1 Additional features e Direct download into flash memory of most popular micro controllers supported Full spee
304. id debugging Halfword A 16 bit unit of information Contents are taken as being an unsigned integer unless otherwise stated Host A computer which provides data and other services to another computer Especially a computer providing debugging services to a target being debugged ICache Instruction cache ICE Extension Unit A hardware extension to the EmbeddedICE logic that provides more breakpoint units J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 433 ID Identifier IEEE 1149 1 The IEEE Standard which defines TAP Commonly but incorrectly referred to as JTAG Image An executable file that has been loaded onto a processor for execution In Circuit Emulator ICE A device enabling access to and modification of the signals of a circuit while that cir cuit is operating Instruction Register When referring to a TAP controller a register that controls the operation of the TAP IR See Instruction Register Joint Test Action Group JTAG The name of the standards group which created the IEEE 1149 1 specification Little endian Memory organization where the least significant byte of a word is at a lower address than the most significant byte See also Big endian Memory coherency A memory is coherent if the value read by a data read or instruction fetch is the value that was most recently written to that location Obtaining memory coherency is difficult when there are multip
305. ific tools 150 3 11 1 J Link STR91x Commander Command line tool 150 3 11 2 J Link STM32 Unlock Command line tool 151 3 12 J Link Software Developer Kit SDK sis 154 155 41 Installing the J Link software and documentation 156 4 1 1 Setup procedure re xe dx ne dE Rer RV RR ER 156 4 2 Setting up the USB interface 159 4 2 1 Verifying correct driver installation 1 1 mene 159 4 2 2 Uninstalling the J Link USB driver ss 160 4 3 Setting up the IP interface oe dee Exe Y x Aa E reds 162 4 3 1 Configuring J Link using J Link 162 4 3 2 Configuring J Link using the webinterface eee mmn 162 4 4 FAOS TP 164 4 5 JeLink CONFIGURATOR ain ecce t een e er era er e Xl i 165 4 5 1 Configure J Links using the J Link Configurator 165 4 6 J Link USB identification ee nennen nne 167 4 6 1 Connecting to different J Links connected to the same host PC via USB 167 4 7 Using the J Link DLE 169 4 7 1 What is the JEINK DEL 2s 28008 Prades des dan E EN EU
306. ile unsigned char 0x40020000 0x04 define FCCOB4 volatile unsigned char 0x40020000 Ox0B define FCCOB5 volatile unsigned char 0x40020000 0x0A define FCCOB6 volatile unsigned char 0x40020000 0x09 define FCCOB7 volatile unsigned char 0x40020000 0x08 define FCCOB8 volatile unsigned char 0x40020000 0 0 void ConfigureDataFlash void KR KKK KKK KKK KKK KEK KEK KKK KKK KEK KKK KEK KEK KE KKK KKK KKK KKK KEK KEK KEKE KK KEKE KK KEKE ko ko ko ko ko ko ConfigureDataFlash Notes Needs to be located in RAM since it performs flash operations which make instruction fetching from flash temporarily not possible void ConfigureDataFlash void 1 unsigned char v Read out current configuration first FSTAT 0x70 Clear error flags in status register FCCOBO 0x03 Read resource FCCOB1 0x80 Read from data flash IFR area with offset OxFC 0x8000FC FCCOB2 0x00 FCCOB3 OxFC FCCOB8 0x00 Select IFR area to be read FSTAT 0x80 Start command execution while FSTAT amp 0x80 0 Wait until flash controller has finished 7 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 367 Check current data flash amp EEPROM config 14 v FCCOB6 IFR offset OxFD if v OxFF EEPROM data set size already configured return j v FCCOB7 IFR offset OxFC if
307. index 0 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 206 CHAPTER 5 Working with J Link and J Trace Prototype api int JTAG GetDeviceId int DeviceIndex 5 11 2 7 JTAG WritelR Description Writes a JTAG instruction Before calling this function please make sure that the JTAG chain has been config ured correctly by setting the appropriate global DLL variables For more information about the known global DLL variables please refer to Global DLL variables on page 210 Prototype api int JTAG WriteIR unsigned int Cmd 5 11 2 8 JTAG_StorelR Description Stores a JTAG instruction in the DLL JTAG buffer Before calling this function please make sure that the JTAG chain has been config ured correctly by setting the appropriate global DLL variables For more information about the known global DLL variables please refer to Global DLL variables on page 210 Prototype api int JTAG StoreIR unsigned int Cmd 5 11 2 9 JTAG_WriteDR Description Writes JTAG data Before calling this function please make sure that the JTAG chain has been config ured correctly by setting the appropriate global DLL variables For more information about the known global DLL variables please refer to Global DLL variables on page 210 Prototype api int JTAG WriteDR unsigned _ int64 tdi int NumBits 5 11 2 10JTAG_StoreDR Description Stores JTAG data in the DLL
308. ing The SPI communication speed may be too high for the given signal quality Remedy Try again with a slower speed If it still fails check the quality of the SPI signals Failed to verify Flash ID Meaning J Link could not verify the ID of the connected flash Remedy Check the Flash ID entered in the flash parameters dialog for correctness 10 11 2 Contacting support If you experience a J Flash SPI related problem and advice given in the sections above does not help you to solve it you may contact our support In this case please provide us with the following information e A detailed description of the problem e The relevant log file and project file In order to generate an expressive log file set the log level to All messages see section Global Settings on page 287 for information about changing the log level in J Flash SPI e The relevant data file as a hex or mot file if possible e The processor and flash types used Once we received this information we will try our best to solve the problem for you Our contact address is as follows SEGGER Microcontroller GmbH amp Co KG In den Weiden 11 D 40721 Hilden Germany Tel 49 2103 2878 0 49 2103 2878 28 Email support segger com Internet http www segger com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 301 Chapter 11 RDI RDI Remote Debug Interface is a standard defined by ARM trying to
309. ing C of program nabled Auto This is the default setting of FlashBP usage If a license has been found the FlashBP feature will be enabled Otherwise rlashBP will be disabled inter nally e Enables the FlashBP feature If no license has been found an error message appears e Disables the FlashBP feature e Show window during program When this checkbox is enabled the Program ming flash window is shown when flash is re programmed in order to set clear flash breakpoints J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 193 Flash download and flash breakpoints independent settings These settings do not belong to the J Link flash download and flash breakpoints set tings section They can be configured without any license needed General Settings Breakpoints Log CPU Reas Target Power SWV Device Emulator male Log file T Override JEMLink log Clear r Settings file T Gyeride Not specified E Flash download B Flash breakpoints Auto License found Auto License found C On Skip download on CRC match C On IV Show info window during C Off Iv Verify download C Off program Disabled Disabled Override device selection Allow caching of flash contents On Allow instruction set simulati Gyeride memory map Modify breakpoints during execution allow x Ready JLINKARM GetSpeed D
310. ing updated J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 46 080904 AG Chapter Licensing added Chapter Hardware Section J Link OEM versions moved to chapter Licensing 45 080902 AG Chapter Hardware Section JTAG Trace connector JTAG Trace connector pinout corrected Section J Link OEM versions updated 44 080827 AG Chapter J Link control panel moved to chapter Working with J Link Several corrections 43 080826 AG Chapter Flash download and flash breakpoints Section Supported devices updated 42 080820 AG Chapter Flash download and flash breakpoints Section Supported devices updated 41 080811 AG Chapter Flash download and flash breakpoints updated Chapter Flash download and flash breakpoints section Supported devices updated 40 080630 AG Chapter Flash download and flash breakpoints updated Chapter J Link status window renamed to J Link control panel Various corrections 39 080627 AG Chapter Flash download and flash breakpoints Section Licensing updated Section Using flash download and flash breakpoints with different debuggers updated Chapter J Link status window added 38 080618 AG Chapter Support and FAQs Section Frequently Asked Questions updated Chapter Reset strat
311. ing a project will close any other project currently open Save Project Saves a project file Save Project as Saves a project file using the name and location given Close Project Closes a project file Recent Files Contains a list of the most recently open data files Recent Projects Contains a list of the most recently open project files Exit Exits the application Table 10 2 File menu elements Edit menu elements Command Description Relocate Relocates the start of the data file to the supplied hex offset from the current start location Delete range Deletes a range of values from the data file starting and ending at given addresses The End address must be greater than the Start address otherwise nothing will be done Eliminate blank areas Eliminates blank regions within the data file Table 10 3 Edit menu elements View menu elements Command Description Opens and or brings the log window to the active win Log dow Opens and or brings the project window to the active REMECE window d Table 10 4 View menu elements J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Target menu elements 283 Command Description Connect Creates a connection through the J Link using the config uration options set in the Project settings of
312. ink GDB Server is done by the gdbinit file The follow ing commands have to be added to the gdbinit file to enable the flash download feature lt SAddr gt lt EAddr gt lt SAddr gt lt EAddr gt monitor WorkRAM monitor flash CFI For more information about the GDB monitor commands please refer to J Link GDB Server on page 102 J Link commander J Link Commander supports downloading bin files into external CFI flash memory In the following it is explained which steps are necessary to prepare J Link Commander for download into external CFI flash memory based on a sample sequence for a ST STM32F103ZE device r speed 1000 exec setcfiflash 0x64000000 Ox64FFFFFF exec setworkram 0x20000000 0x2000FFFF w4 0x40021014 0x00000114 RCC AHBENR FSMC clock enable w4 0x40021018 0x000001FD GPIOD G clock enable w4 0x40011400 OxB4BB44BB GPIOD low config NOE NWE gt Output NWAIT gt Input w4 0x40011404 OxBBBBBBBB GPIOD high config A16 A18 w4 0x40011800 OxBBBBBBBB GPIOE low config A19 A23 w4 0x40011804 OxBBBBBBBB GPIOE high config D5 D12 w4 0x40011C00 Ox44BBBBBB GPIOF low config 0 5 w4 0x40011C04 OxBBBB4444 GPIOF high config A6 A9 w4 0x40012000 0 44 GPIOG low config A10 A15 w4 0 40012004 0x444B4BB4 GPIOG high config NE2 gt output w4 0xA0000008 0x00001059 CS control reg 2 16 bit write enable Type NOR flash w4 0 000000
313. ink RDI is an ADI compliant software for J Link ARM It requires a license RDI which can be obtained from SEGGER www segger com This software is also capable of programming the flash memory of several ARM micros which can be used to download your program to flash Requires the add license FlashDL and to set an unlimited number of software breakpoints in flash Requires the add license FlashBP Connection to J Link USB Device 0 ICPAP About Location of contig ma e El License Reset Config Cancel Apply Connection to J Link This setting allows the user to configure how the DLL should connect to the J Link Some J Link models also come with an Ethernet interface which allows to use an emulator remotely via TCP IP connection License J Link RDI License managment 1 The License button opens the J Link RDI License management dialog J Link RDI requires a valid license J Link RDI License management X Feature Serial number Expiration Add license Display serial number 2 Click the Add license button and enter your license Confirm your input by click J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 322 CHAPTER 11 ing the OK button Add license 3 The J Link RDI license is now added J Link RDI License management LAO Macro file RDI A macro file can be specified to load cu
314. ink SWO Viewer Free of charge utility for J Link Displays the terminal output of the target using the SWO pin The stimulus port s from which SWO data is received can be chosen by using the port checkboxes 0 to 31 Can be used in parallel with a debugger or stand alone This is especially useful when using debuggers which do not come with built in support for SWO such as most GDB GDB Eclipse based debug environments SEGGER J Link SWO Viewer V4 78j File Edit Help Seo 16 15 LiT 877 0 CREUSER Pause Stop Clear 31 24 23 Data from stimulus Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Loops sec 4485 Lg 4 r Device STM32F103ZG CPUFreq 72016 kHz SWOFreq 6000 kHz 2984 bytes 2 3 7 0 4 J Link SWO Viewer CL Command line only version of SWO Viewer All commands avaible for J Link SWO Viewer can be used with J Link SWO Viewer Cl Similar to the GUI Version J Link SWO Viewer Cl asks for a device name or CPU clock speed at startup to be able to calculate the correct SWO speed or to connect to a running J Link GDB Server C Program Files x86 SEGGER LinkARM_V478 JLinkSWOViewerCL exe e SEGGER J Link SWO Viewer Compiled Nov 22 2613 26 69 16 lt c 2812 SEGGER Microcontroller GmbH amp Co KG wuw segger com Solutions for
315. ion 9 pin JTAG SWD connector added J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation V4 23d 110202 AG Chapter J Link and J Trace related software Section J Link software and documentation package in detail updated Chapter Introduction Section Built in intelligence for supported CPU cores added V4 21g 101130 AG Chapter Working with J Link Section Reset strategies updated Chapter Device specifics Section Freescale updated Chapter Flash download and flash breakpoints Section Supported devices updated Section Setup for different debuggers CFI flash updated V4 21 101025 AG Chapter Device specifics Section Freescale updated 4 201 101019 Chapter Working with J Link Section Reset strategies updated V4 20b 100923 AG Chapter Working with J Link Section Reset strategies updated 90 100818 AG Chapter Working with J Link Section J Link script files updated Section Command strings upadted Chapter Target interfaces and adapters Section 19 pin JTAG SWD and Trace connector corrected Chapter Setup Section J Link configurator added 89 100630 AG Several corrections 88 100622 AG Chapter J Link and J Trace related software Section SWO Analyzer added 87 10
316. ion 1 2 0 1 2 1 There should be no problems with other versions of ARM s AXD All screenshots are taken from ARM s AXD version 1 2 0 11 3 2 2 Configuring to use J Link RDI 1 Start the ARM debugger and select Options Configure Target This opens the Choose Target dialog box Choose Target ARM TPA 151 CXToohC SRVT DLL ARMUL 1 5 1 CAT Sarnulate dll 2 Press the Add Button to add the JLinkRDI dll Open JLinkRDI JLinkArm dll J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 308 CHAPTER 11 RDI 3 Now J Link RDI is available in the Target Environments list Choose Target Target Environments Target aD File ARM TPA 1 551 C ToolKCS NAYT BLL 1 0 0 19 ARMUL 151 C ToolKC armulate dll 1 4 0 89 Flemave J Link 1 51 C AJLinkRDIMJLinkADI dll Rename Save As Configure AAA Segger JLink ARM JTAG Cancel Help 4 Select J Link and press OK to connect to the target via J Link For more informa tion about the generic setup of J Link RDI please refer to Configuration on page 320 After downloading an image to the target board the debugger window looks as follows AXD ARM 1 C work emb0S emb0S_ARM_RYDS21 start CPU_STR71X SAMPLE Main_LED c Eile Search Processor Views SystemViews Execute Options Window Help c5 HIDE alee
317. ion 3 Identical to version 1 1 with the following exception e SWD support for non 3 3V targets Version 4 e New design based on STM32F407 FPGA Cyclone IV Version 4 3 Identical to version 4 with the following exception e Pin 1 VTref is used for measuring target reference voltage only Buffers on J Link side are no longer powered through this pin but via the J Link internal volt age supplied via USB Hardware version 1 1 3 0 4 0 Hardware features USB Ethernet JTAG interface Table 1 7 J Link PRO hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 47 Hardware version 1 1 3 0 4 0 SWD interface SWO interface Mi hip ICSP R FINE inter pues inter o 9 ETB Trace Supported cores ARM legacy cores ARM7 ARM9 11 ARM Cortex cores Cortex A5 eo Cortex A7 Cortex A8 e eo Cortex A9 Cortex A12 99 Cortex A15 X Table 1 7 J Link PRO hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 48 CHAPTER 1 Introduction Hardware version gt 17 Cortex MO Cortex M0O Cortex M1 Cortex M3
318. iption map indirectread Specifies an area which should be read indirect Marks a specified memory region as an illegal memory map illegal 3 area Memory accesses to this region are ignored map ram Specifies location of target RAM map region Specifies a memory region Restores the default mapping which means all mem map reset ory accesses are permitted ProjectFile Specifies a file or directory which should be used by the J Link DLL to save the current configuration ScriptFile Set script file path SelectTraceSource Selects which trace source should be used for tracing SetAllowFlashCache Enables Disables flash cache usage SetAllowSimulation Enables Disables instruction set simulation SetBatchMode Enables Disables batch mode SetCFIFlash Specifies CFI flash area SetCheckModeAfterRead Enables Disables CPSR check after read operations SetCompareMode Specifies the compare mode to be used SetCPUConnect IDCODE Specifies an CPU IDCODE that is used to authenticate the debug probe when connecting to the CPU SetDbgPowerDownOnClose Used to power down the debug unit of the target CPU when the debug session is closed SetETBIsPresent Selects if the connected device has an ETB SetETMIsPresent Selects if the connected device has an ETM SetFlashDLNoRMWThreshol d Specifies a threshold when writing to flash memory does not
319. is required especially when using J Link via USB For spe cial cases like having multiple older J Links connected to the same host PC in paral lel they need to be re configured to be identified by their real serial number when enumerating on the host PC This is the default identification method for current J Links J Link with hardware version 8 or later For re configuration of old J Links or for configuration of the IP settings use DHCP IP address subnet mask of a J Link supporting the Ethernet interface SEGGER provides a GUI based tool called J Link Configurator The J Link Configurator is part of the J Link software and docu mentation package and can be used free of charge DLL J Link Server via Server via SWD 34ink RDI Config J dink TCP IP Server uh J Mem License Agreement 93 Remove J Link ARM V4 35e 4 5 1 165 Configure J Links using the J Link Configurator A J Link can be easily configured by selecting the appropriate J Link from the emula tor list and using right click Configure 13 SEGGER J Link Configuration V4 35e beta 0 1 2 3 4 S 6 8 8 1 0 J Link J Trace UM08001 J Link ARM Pro V3 00 Link ARM Pro V3 00 J Link ARM Pro 3 00 J Link ARM Pro V3 00 J Link ARM Pro V3 00 J Link ARM Pro V3 00 ARM Pro V3 00 J Link ARM Pro V3 00 J Link ARM Pro V3 00 J Link ARM Pro V3 00 J Link ARM Pro V3 00 173001007 1
320. ist On emulators which support file I O this command shows the directory tree of the Flasher Syntax flist 3 2 1 11 fread frd On emulators which support file I O this command reads a specific file Offset applies to both destination and source file Syntax fread lt EmuFile gt lt HostFile gt lt Offset gt lt NumBytes gt Parameter Meaning EmuFile File name to read from HostFile Destination file on the host Offset Specifies the offset in the file at which data reading is started NumBytes Maximum number of bytes to read Example fread Flasher dat C Project Flasher dat 3 2 1 12 fshow On emulators which support file I O this command reads and prints a specific file Currently only Flasher models support file I O Syntax fshow lt FileName gt a lt Offset gt lt NumBytes gt Parameter Meaning FileName Source file name to read from the Flasher a If set Input will be parsed as text instead of being shown as hex Offset Specifies the offset in the file at which data reading is started NumBytes Maximum number of bytes to read Example fshow Flasher dat 3 2 1 13 fsize fsz On emulators which support file I O this command gets the size of a specific file Cur rently only Flasher models support file I O Syntax fsize lt FileName gt Parameter Meaning FileName Source file name to read from the Flasher Example fs
321. ith these chips only J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 198 CHAPTER 5 Working with J Link and J Trace 5 8 1 4 Type 3 No reset No reset is performed Nothing happens 5 8 1 5 Type 4 Hardware halt with WP The hardware RESET pin is used to reset the CPU After reset release J Link continu ously tries to halt the CPU using a watchpoint This typically halts the CPU shortly after reset release the CPU can in most systems execute some instructions before it is halted The number of instructions executed depends primarily on the JTAG speed the higher the JTAG speed the faster the CPU can be halted Some CPUs can actually be halted before executing any instruction because the start of the CPU is delayed after reset release 5 8 1 6 Type 5 Hardware halt with DBGRQ The hardware RESET pin is used to reset the CPU After reset release J Link continu ously tries to halt the CPU using the DBGRQ This typically halts the CPU shortly after reset release the CPU can in most systems execute some instructions before it is halted The number of instructions executed depends primarily on the JTAG speed the higher the JTAG speed the faster the CPU can be halted Some CPUs can actually be halted before executing any instruction because the start of the CPU is delayed after reset release 5 8 1 7 Type 6 Software This reset strategy is only a software reset Software reset means basically
322. itor mode 269 8 3 1 Corte GMI ic oT EP i eU I E ds ints Ss ate EMEN ds See Sa ate E EE 269 8 3 2 Cortex v c eevee blu 4 269 8 4 Monitor code doi ed ER ERR 270 8 5 Debugging interrupts coii Renee a er ead ER UE E ERE 271 8 6 Having servicing interrupts in debug mode 272 9 Low Power Debudggll s eck el eae els 273 9 1 Introduction street iranienne ain nn annee de 274 9 2 Activating low power mode handling for 275 9 2 1 SEGGER Embedded Studio 7 1 7 4 4 6 275 9 2 2 Keil MDKSARMi 38 es 275 9 2 3 TAR EWARM cv cepere date ete ewe gala IV p Va date er 275 9 2 4 Mentor Sourcery CodeBench for ARM 66 3 275 9 2 5 GDB GDBServer based setups Eclipse 11 275 9 3 RESEICUONS cT TET 276 AO Flash SPI ut PT PE 277 10 1 ItitrodlCction m ido eene eso er venderet esee ne era 278 10 1 1 What is JsFlashi SPI Re RE EU Ree V e ERN OE UE RAS 278 10 1 2 J Flash SPI CL Windows Linux Mac ss 278 10 1 3 E LE TL 278 10 1 4 Requirementsz 2 2 eri e tex
323. izable cores ARM7TDMI ARM9TDMI ARM920 etc With these cores the TAP controller uses the clock signal provided by the emulator which means the TAP controller and ICE Breaker continue to be accessible even if the CPU has no clock Therefore switching off CPU clock during debug is normally possible if the CPU clock is periodically typically using a regular timer interrupt switched on every few ms for at least a few us In this case the CPU will stop at the first instruction in the ISR typically at address 0x18 Synthesizable cores ARM7TDMI S 5 etc With these cores the clock input of the TAP controller is connected to the output of a three stage synchronizer which is fed by clock signal provided by the emulator which means that the TAP controller and ICE Breaker are not accessible if the CPU has no clock If the RTCK signal is provided adaptive clocking function can be used to synchronize the JTAG clock provided by the emulator to the processor clock This way the JTAG clock is stopped if the CPU clock is switched off If adaptive clocking is used switching off CPU clock during debug is normally possi ble if the CPU clock is periodically typically using a regular timer interrupt switched on every few ms for at least a few us In this case the CPU will stop at the first instruction in the ISR typically at address 0x18 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 238 C
324. ize Flasher dat J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 89 3 2 1 14 fwrite fwr On emulators which support file I O this command writes a specific file Currently only Flasher models support file I O NumBytes is limited to 512 bytes at once This means if you want to write e g 1024 bytes you have to send the command twice using an appropriate offset when send ing it the second time Offset applies to both destination and source file Syntax fwrite EmuFile HostFile Offset lt NumBytes gt Parameter Meaning EmuFile File name to write to HostFile Source file on the host Offset Specifies the offset in the file at which data writing is started NumBytes Maximum number of bytes to write Example fwrite Flasher dat C Project Flasher dat 3 2 1 15 go g Starts the CPU In order to avoid setting breakpoints it allows to define a maximum number of instructions which can be simulated emulated This is particulary useful when the program is located in flash and flash breakpoints are used Simulating instructions avoids to reprogram the flash and speeds up single stepping Syntax go lt NumSteps gt lt Flags gt Parameter Meaning Maximum number of instructions allowed to be simulated Instruc tion simulation stops whenever a breakpointed instruction is hit an SERRE instruction which cannot be simulated emulated is
325. jlinkgdbserver nologtofile log C pathto file log Will generate log file jlinkgdbserver log C pathto file log nologtofile Will not generate a log file J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 129 3 3 5 14 nohalt Description When connecting to the target after starting GDB Server the target is not explicitly halted and the CPU registers will not be inited After closing all GDB connections the target is started again and continues running Some IDEs rely on the target to be halted after connect In this case do not use nohalt but halt Note For the GUI version this setting is persistent for following uses of GDB Server until changed via halt or the GUI Syntax nohalt Example jlinkgdbserver nohalt 3 3 5 15 nosilent Description Starts the GDB Server in non silent mode All log window messages will be shown Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax nosilent 3 3 5 16 nostayontop Description Starts the GDB Server in non topmost mode All windows can be placed above it Note For the CL version this setting has no effect Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax nostayontop 3 3 5 17 notimeout Description GDB Server automaticall
326. jlinksettings to the directory where the CodeBench project is located once when creating a new project Then select this file in the project options J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 204 CHAPTER 5 Working with J Link and J Trace 5 11 J Link script files In some situations it it necessary to customize some actions performed by J Link In most cases it is the connection sequence and or the way in which a reset is per formed by J Link since some custom hardware needs some special handling which cannot be integrated into the generic part of the J Link software J Link script files are written in C like syntax in order to have an easy start to learning how to write J Link script files The script file syntax supports most statements if else while dec laration of variables which are allowed in C but not all of them Moreover there are some statements that are script file specific The script file allows maximum flex ibility so almost any target initialization which is necessary can be supported 5 11 1 Actions that can be customized The script file support allows customizing of different actions performed by J Link Depending on whether the corresponding function is present in the script file or not a generically implemented action is replaced by an action defined in a script file In the following all J Link actions which can be customized using a script file are lis
327. k J Trace are used to transfer the RAM code only but not to transfer the data The CPU is started and stopped only once Using DCC for communication is typically faster than using WriteMemory for RAM download because the overhead is lower 15 4 4 Available options for flash programming There are different solutions available to program internal or external flashes con nected to ARM cores using J Link J Trace The different solutions have different fields of application but of course also some overlap 15 4 4 1 J Flash Complete flash programming solution J Flash is a stand alone Windows application which can read write data files and program the flash in almost any ARM system J Flash requires an extra license from SEGGER 15 4 4 2 RDI flash loader Allows flash download from any RDI compliant tool chain RDI Remote debug interface is a standard for debug transfer agents such as J Link It allows using J Link from any RDI compliant debugger RDI by itself does not include download to flash To debug in flash you need to somehow program your application program debuggee into the flash You can use J Flash for this purpose use the flash loader supplied by the debugger company if they supply a matching flash loader or use the flash loader integrated in the J Link RDI software The RDI software as well as the RDI flash loader require licenses from SEGGER J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH a
328. ke hehe ke kk kk kc kk sk ke ck hec kc kc kc kkk kkk kkk kkk kkk kk kkk kk kkk kkk k k k kk k SWO PrintChar Function description Checks if SWO is set up If it is not return to avoid program hangs if no debugger is connected ud If it is set up print a character to the ITM STIM register in order to provide data for SWO Parameters Chacracter to be printed Notes Additional checks for device specific registers can be added m void SWO PrintChar char c Check if ITM_TCR ITMENA is set if ITM TCR amp 1 0 return Check if stimulus port is enabled if ITM_ENA amp 1 0 return Wait until STIMx is ready then send data while ITM_STIM_U8 amp 1 0 ITM_STIM_U8 c J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 146 CHAPTER 3 J Link software and documentation package f kk ERE REE ERE ERR EKER ERE EKER EER SWO PrintString Function description Print a string via SWO void SWO_PrintString const char Print out character per character while s SWO_PrintChar s J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 147 3 8 SWO Analyzer SWO Analyzer SWoAnalyzer exe is tool that analyzes SWO output Status and summary of the analysis are output to standard out the details of
329. lLink exe SEGGER J Link Commander U4 98e for help i 5 2015 11 61 31 i are J Link 09 compiled Apr 21 2015 18 16 46 Replacing f 2 J Link 09 compiled Jan 29 2015 11 4 Waiting for n ar boot fully compiled May 5 2015 11 00 52 J Link 09 compiled Apr 21 2015 18 10 40 U9 26 6686 s GDB RDI FlashBP FlashDL JFlash 6 666U In the screenshot e The red box identifies the new firmware e The green box identifies the old firmware which has been replaced 15 5 2 Invalidating the firmware Downdating J Link J Trace is not performed automatically through an old JLinkARM dll J Link J Trace will continue using its current newer firmware when using older versions of the JLinkARM dll Note Downdating J Link J Trace is not recommended you do it at your own risk Note Note also the firmware embedded in older versions of JLinkARM dll might not execute properly with newer hardware versions To downdate J Link J Trace you need to invalidate the current J Link J Trace firm ware using the command exec InvalidateFW El C Program Files x86 SEGGERVULink V498elLink exe SEGGER J Link Commander U4 98e for help Compiled May 5 2015 11 01 31 version U4 98e compiled May 5 2015 11 00 52 J Link 09 compiled Apr 21 2615 18 16 46 RDI FlashBP FlashDL JFlash exec invalidatefw Updating firmware J Link U compiled APR 21 2015 18 10 40 Replacing firmware J Link 09 compiled Apr 2
330. lPanel Suppress pop up of the control panel SuppressInfoUpdateFW Suppress information regarding firmware updates SWOSetConversionMode Set SWO Conversion mode Table 5 12 Available command strings J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 220 CHAPTER 5 Working with J Link and J Trace 5 12 1 1 AppendToLogFile This command can be used to configure the AppendToLogFile feature If enabled new log data will always be appended to an existing logfile Otherwise each time a new connection will be opened existing log data will be overwritten By default new log data will not be always appended to an existing logfile Syntax AppendToLogFile 0 1 Example AppendToLogFile 1 Enables AppendToLogFile 5 12 1 2 CORESIGHT SetlndexAHBAPTOUse This command is used to select a specific AHB AP to be used when connected to an ARM Cortex M device Usually it is not necessary to explicitly select an AHB AP to be used as J Link auto detects the AP automatically For multi core systems with multi ple AHB APs it might be necessary The index selected here is an absolute index For example if the connected target provides the following AP layout e AP 0 AHB AP e 1 APB AP e AP 2 AHB AP e AP 3 JTAG AP In order to select the second AHB AP to be used use 2 as index Syntax CORESIGHT SetIndexAHBAPTOUse Index Example CO
331. le possible physical locations that are involved such as a system that has main memory a write buffer and a cache Memory management unit MMU Hardware that controls caches and access permissions to blocks of memory and translates virtual to physical addresses Memory Protection Unit MPU Hardware that controls access permissions to blocks of memory Unlike an MMU an MPU does not translate virtual addresses to physical addresses Multi ICE Multi processor EmbeddedICE interface ARM registered trademark RESET Abbreviation of System Reset The electronic signal which causes the target system other than the TAP controller to be reset This signal is also known as nSRST nSYSRST nRST or NRESET in some other manuals See also nTRST nTRST Abbreviation of TAP Reset The electronic signal that causes the target system TAP controller to be reset This signal is known as nICERST in some other manuals See also nSRST Open collector A signal that may be actively driven LOW by one or more drivers and is otherwise passively pulled HIGH Also known as a wired AND signal J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 434 CHAPTER 18 Glossary Processor Core The part of a microprocessor that reads instructions from memory and executes them including the instruction fetch unit arithmetic and logic unit and the register bank It excludes optional coprocessors caches and the memor
332. line options J Flash SPI will still start its GUI but processing will start immediately The screenshot below shows the command line help dialog which is displayed if you start J Flash SPI in a console window with JFlashSPI exe help Or JFlashSPI exe Commandline mx o Valid command line options ci openprj Opens an existing project Syntax openprj FILENAME saveprjas Saves current project in a different file Syntax saveprjas FILENAME saveprj Saves current project Syntax saveprj open Opens a data file Syntax open lt FILENAME gt lt SADDR gt saveas Saves current data file in a different file Syntax saveas FILENAME SADDR EADDR save Saves current data file Syntax save lt SADDR gt lt EADDR gt merge Merges a given data file with the one currently opened in J Flash Syntax merge lt FILENAME gt or merge lt FILENAME gt bin lt ADDR gt relocate Relocates data by given offset Syntax relocate lt OFFSET gt delrange Deletes data range Syntax delrange lt SADDR gt lt EADDR gt eliminate Eliminates blank areas in data file connect Connects to target disconnect Disconnects from target erasesectors Erases selected sectors erasechip Erases entire flash chip programverify Programs and verifies target program Programs target auto Erases programs and verifies target verify Verifies target program readchip Reads the entire flash chip readrange Reads specified range of
333. lly required GDB commands are Initially reset the target monitor reset Load the application load Other commands to set up the target e g Set PC to RAM initialize external flashes can be entered here too emIDE will automatically start GDB Server on start of the debug session If it does not or an older version of GDB Server starts in emIDE click on JLink gt Run the JLink plugin configuration J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 106 CHAPTER 3 J Link software and documentation package The screenshot below shows a debug session in IDE For download and more infor mation about emIDE please refer to http emide org 28 eft Bei 10 include BSP h 11 0 00100228 ir 12 FSIS IIIS II III III III IIR IIIS OE 0x0010022C sp sp 12 59 0500100230 r3 0 0x00100234 r3 sp 4 14 ER 0x00100238 0x1000f8 BSP Init 15 static void Delay void 16 volatile int i 0x00100240 0 10014 lt BSP_SetLED gt 17 0x00100244 ro 1 0 00100248 0 10019 lt BSP_ToggleLED 1 9 i 1000 0x0010024C r3 isp 4 19 while i 0x00100250 r3 r3 1 20 0x00100254 r3 sp 4 0x00100258 0 1001 lt Delay 0x0010025C 0x100244 lt 28 gt OI III III III III III ttt main ES Clint main void 4 volatile int cnt cnt 0 BSP_Init Initiali BSP S
334. load feature of the DLL can be used in dif ferent debugger environments J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 242 CHAPTER 6 Flash download 6 1 Introduction The J Link DLL comes with a lot of flash loaders that allow direct programming of internal flash memory for popular microcontrollers Moreover the J Link DLL also allows programming of CFI compliant external NOR flash memory The flash down load feature of the J Link DLL does not require an extra license and can be used free of charge Why should use the J Link flash download feature Being able to download code directly into flash from the debugger or integrated IDE significantly shortens the turn around times when testing software The flash down load feature of J Link is very efficient and allows fast flash programming For example if a debugger splits the download image into several pieces the flash download software will collect the individual parts and perform the actual flash pro gramming right before program execution This avoids repeated flash programming Moreover the J Link flash loaders make flash behave like RAM This means that the debugger only needs to select the correct device which enables the J Link DLL to automatically activate the correct flash loader if the debugger writes to a specific memory address This also makes it very easy for debugger vendors to make use of the flash download feature because almost n
335. lowing commands will not be processed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 293 10 6 Create a new J Flash SPI project This chapter contains information about the required steps for the setup of a new J Flash SPI project 10 6 1 Creating a new J Flash SPI project Creating a new project for J Flash is pretty simple In the following all necessary steps to create a project file are explained 1 Select File gt New Project to create a new project with default settings 2 Open the Project Settings context menu Select Options gt Project Settings to open the Project settings dialog and select the type of connection to J Link Project settings General interface Fash J Flash SPI is a software for J Link This software is capable of programming SPI flash memories Connection to J Link USB SN 0 Select C 3 Define the SPI communication speed The default settings work without any problem for most targets but to achieve the last quantum of performance man ual tuning may be necessary Project settings Fe General Interface Flash Interface speed 4000 v kHz 4 Open the Flash and either select Automatically detect SPI flash or manually enter the flash parameters 5 Save the project File gt Save Project and test it J Link J Trace UM08001 2004 2015 SEGGER Microcont
336. lways perform this operation at a later time via start menu taa J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 170 CHAPTER 4 Setup 4 7 3 Determining the version of JLink DLL To determine which version of the JLinkARM dll you are using the DLL version can be viewed by right clicking the DLL in explorer and choosing Properties from the con text menu Click the Version tab to display information about the product version jlinkarm dll Properties Company Name Internal Name Product Name 4 7 4 Determining which DLL is used by a program To verify that the program you are working with is using the DLL you expect it to use you can investigate which DLLs are loaded by your program with tools like Sysinter nals Process Explorer It shows you details about the DLLs used by your program such as manufacturer and version Process Explorer Sysinternals www sysinternals com E System Idle Process Interrupts E E System explorer exe procexp exe SEGGER J Link ARM interface DLL Sy 3 00 0004 0000 IAR C SPY Debugger 4 06 0000 0000 Windows NT BASE API Client DLL i i 5 00 2195 6688 IAR Log Window 4 06 0000 0000 LZ Expand Compress API DLL i i 5 00 2185 6611 MFCDLL Shared Library Retail Ve Mi i 7 10 3077 0000 Multiple Provider Router DLL i i 5 00 2185 6611 CPU Usage 1 Commit Charge 12 24 Processes 34 Process Explorer is a
337. m the target microcontroller as well as sending input to the application at a very high speed without affecting the target s real time behavior SEGGER RTT can be used with any J Link model and any supported target processor which allows background memory access which are Cortex M and RX targets RTT supports multiple channels in both directions up to the host and down to the target which can be used for different purposes and provide the most possible free dom to the user The default implementation uses one channel per direction which are meant for printable terminal input and output With the J Link RTT Viewer this channel can be used for multiple virtual terminals allowing to print to multiple windows e g one for standard output one for error output one for debugging output with just one target buffer An additional up to host channel can for example be used to send profiling or event tracing data Hella World From CPU ta terminal in 845 with RTT J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 335 12 2 How RTT works 12 2 1 Target implementation Real Time Terminal uses a SEGGER RTT Control Block structure in the target s mem ory to manage data reads and writes The control block contains an ID to make it findable in memory by a connected J Link and a ring buffer structure for each available channel describing the channel buffer and its state The maximum number of availa
338. meter Meaning BufferIndex Index of the down channel to read from pBuffer Pointer to a character buffer to store the read characters BufferSize Number of bytes available in the buffer Table 12 5 SEGGER RTT Read parameter list Return value gt 0 Number of bytes that have been read Example char acIn 4 int NumBytes sizeof acIn NumBytes SEGGER RTT Read 0 amp acIn 0 NumBytes if NumBytes AnalyzeInput acIn 12 4 1 8 SEGGER_RTT_SetTerminal Description Set the virtual terminal to send following data on channel Prototype void SEGGER RTT SetTerminal char TerminalId J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 348 CHAPTER 12 RTT Parameters Parameter Meaning Terminalld Id of the virtual terminal 0 9 Table 12 6 SEGGER_RTT_SetTerminal parameter list Example Send a string to terminal 1 which is used as error out SEGGER RTT SetTerminal 1 Select terminal 1 SEGGER RTT WriteString 0 ERROR Buffer overflow SEGGER RTT SetTerminal 0 Reset to standard terminal Additional information All following data which is sent via channel 0 will be printed on the set terminal until the next change 12 4 1 9 SEGGER RTT TerminalOut Description Send one string to a specific virtual terminal Prototype int SEGGER RTT TerminalOut char TerminalID
339. mp Co KG 417 15 4 4 3 Flash loader of compiler debugger vendor such as IAR A lot of debuggers some of them integrated into an IDE come with their own flash loaders The flash loaders can of course be used if they match your flash configura tion which is something that needs to be checked with the vendor of the debugger 15 4 4 4 Write your own flash loader Implement your own flash loader using the functionality of the JLinkARM dll as described above This can be a time consuming process and requires in depth knowl edge of the flash programming algorithm used as well as of the target system J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG CHAPTER 15 Background information 15 5 J Link J Trace firmware The heart of J Link J Trace is a microcontroller The firmware is the software exe cuted by the microcontroller inside of the J Link J Trace The J Link J Trace firm ware sometimes needs to be updated This firmware update is performed automatically as necessary by the JLinkARM dll 15 5 1 Firmware update Every time you connect to J Link J Trace JLinkARM dll checks if its embedded firm ware is newer than the one used the J Link J Trace The DLL will then update the firmware automatically This process takes less than 3 seconds and does not require a reboot It is recommended that you always use the latest version of JLinkARM dll El C Program Files x86 SEGGERULink V498e
340. mple setup where we have TDI gt Cortex M 4 bits IRLen gt TDO JLINK CORESIGHT Configure IRPre 0 DRPre 0 IRPost 0 DRPost 0 IRLenDevice 4 else For SWD no special setup is needed just output the switching sequence JLINK CORESIGHT Configure J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 209 v JLINK_CORESIGHT_ReadDP JLINK_CORESIGHT_DP_REG_CTRL_STAT Report1 DAP CtrlStat v Complex setup where we have TDI gt ICEPick 6 bits IRLen gt Cortex M 4 bits IRLen gt TDO JLINK CORESIGHT Configure IRPre 0 DRPre 0 IRPost 6 DRPost 1 IRLenDevice 4 v JLINK CORESIGHT ReadDP JLINK CORESIGHT DP CTRL STAT Report1 DAP CtrlStat v Known setup parameters Parameter Type Explanation IRPre DecValue Sum of IRLen of all JTAG devices in the JTAG chain closer to TDO than the actual one J Link shall commu nicate with DRPre DecValue Number of JTAG devices in the JTAG chain closer to TDO than the actual one J Link shall communicate with IRPost DecValue Sum of IRLen of all JTAG devices in the JTAG chain fol lowing the actual one J Link shall communicate with DRPost DecValue Number of JTAG devices in the JTAG chain following the actual one J Link shall communicate with IRLenDevice DecValue IRLen of the actual device J Link shall communicate with PerformTIFInit DecValue 0 Do not output switc
341. mpleted Performing this kind of task with only PC side intelligence requires to either make some assumption like Operation is completed after a given number of cycles Or it requires to make a lot of USB Ethernet transactions The first option fast mode will not work under some circumstances such as low CPU speeds the second slow mode will be more reliable but very slow due to the high number of USB Ethernet transactions It simply boils down to The best solution is having intel ligence in the emulator itself J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 62 CHAPTER 1 Introduction 1 6 2 1 Limitations of PC side implementations e Instability especially on slow targets Due to the fact that a lot of USB transactions would cause a very bad perfor mance of J Link PC side implementations are on the assumption that the CPU Debug interface is fast enough to handle the commands requests without the need of waiting So when using the PC side intelligence stability cannot be guaranteed in all cases especially if the target interface speed JTAG SWD is significantly higher than the CPU speed e Poor performance Since a lot more data has to be transferred over the host interface typically USB the resulting download speed is typically much lower than for implementa tions with intelligence in the firmware even if the number of transactions over the host interface is limited to a minimum fast mode
342. n overview about the specifications general mechanical electrical for J link ULTRA All values are valid for J link ULTRA hardware version 1 Note Some specifications especially speed are likely to be improved in the future with newer versions of the J Link software freely available General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 27 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 Storage temperature 209C 65 C Relative humidity non condensing Max 90 rH Mechanical Size without cables 100mm x 53mm x 27mm Weight without cables 73g Available interfaces USB interface USB 2 0 Hi Speed Target interface 20 pin J Link debug interface connector JTAG SWD Interface Electrical Target interface voltage Vir 1 8V 5V Target supply voltage 4 5V 5V Table 1 5 J link ULTRA specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 42 CHAPTER 1 Introduction Target supply current Max 300mA Open drain Can be pulled low or Reset Type wider Reset low level output voltage VoL VoL lt 10 of Vir For the whole target voltage range 1 8V lt Vip lt 5V LOW level input voltage Vit lt 40 of Vir HIGH level input voltage Vy Vin gt 60 of Vir For 1 8
343. n performed EGGER J Link Commander 03 86 Compiled Jun 27 2008 19 42 43 asion U3 86 compiled Jun 27 2668 19 42 28 J Link ARM U6 compiled Jun 27 2008 18 35 51 JTAG speed Info TotalIRLen 4 IRPrint x 1 Found 1 JTAG device Total IRLen 4 Id of device H8 x3JF F F F Found ARM with core Id 8x3FB8FBFBF J Link gt speed 12666 JTAG speed 12688 kHz J Link gt testwspeed Speed test Writing 8 128kb into memory address 6x66666000 128 kByte written in 185ms 706 6 kb sec J Link gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 427 17 2 Troubleshooting 17 2 1 General procedure If you experience problems with J Link J Trace you should follow the steps below to solve these problems Close all running applications on your host system Disconnect the J Link J Trace device from USB Disable power supply on the target Re connect J Link J Trace with the host system attach USB cable Enable power supply on the target Try your target application again If the problem remains continue the following procedure 7 Close all running applications on your host system again 8 Disconnect the J Link J Trace device from USB 9 Disable power supply on the target 10 Re connect J Link J Trace with the host system attach the USB cable 11 Enable power supply on the target 12 Start JLink exe 13 If JLink exe displays the J Link J Trace seri
344. n reached 2 J Link ARM SEGGER J Link Commander U3 72c for help gt Compiled Jul 4 2007 26 17 14 DLL P 2c compiled Jul 4 2607 20 17 09 Firmware J Link compiled Jun 14 2007 14 36 33 ARM Rev 5 Hardware U5 38 S N 1 Feature s gt RDI FlashBP FlashDL JFlash GDB U kHz 6 Gx41869264 ARM x1D192192 i 1 FGF lt ARM gt 8 data comp MM CETBL x 61 gt 1 9 CETB x 11 gt 66666868 lt x82 1 36 66668866 66686668 66686668 J 32 gt DCache 32kB 4 256 32 gt 4 counters sequencer The result of the limited buffer size is that not more data can be traced than the buffer can hold Because of this limitation an ETB is not a fully alternative to the direct access to an ETM via J Trace J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 416 CHAPTER 15 Background information 15 4 Flash programming J Link J Trace comes with a DLL which allows amongst other functionalities reading and writing RAM CPU registers starting and stopping the CPU and setting breakpoints The standard DLL does not have API functions for flash programming However the functionality offered can be used to program the flash In that case a flashloader is required 15 4 1 How does flash programming via J Link J Trace work This requires extra code This extra code typically downloads a program into the RAM of the target syst
345. nd GPIOC clock RCC_APB2PeriphResetCmd RCC_APB2Periph_ADC1 RCC_APB2Periph_GPIOC DISABLE RCC_APB2PeriphClockCmd lt RCC_APB2Periph_ADCi RCC_APB2Periph_GPIOC ENABLE 0800 BOLA SP SP 0 68 O800BFA2 B070 R4 R5 R6 PC DrawTable 0 08008 4 0x800BF28 98008 6 0800 RO RO 0 0 os BFAS PUSH R4 LR OSO0BFAA Boss SUB SP SP 0x20 debug 0800 001 8 8 BL debug ENTR SECTION S itl 0800 4 F7FFFFG2 BL Clk Init NVIC setvectorTable NVIC VectTab FLASH 0x0 OSOOBFBS 2100 MOVS R1 0x0 OS00BFBA 05 6000 MOVS RD 0 8000000 0800 rODirCes BL nvic_setvectorrable riori OSOGBFCI F4AF7040 MOV RO 0 300 0800 6_ FOD1FC4l PriorityGroupconfig Ti Tick ITCont NA i O800BFDO 2001 IOVS RO 0 1 Re RER BL 4 Eres 1 2001 MOVS RO xi 08008 08 FOO1FAEB BL SysTick c oun TE PB2PeriphRese h A I Rew ETE 5108 DISABLE 0800BFDC 2100 HOVS R1 0 0 OSODBFDE F44F7082 MOV 0 104 0800 2 F7FFFASO BL RCC_APB2PeriphRes etcmd APB2Periphclockcmd RCC APB2Periph GPIOA RCC APB2Periph GPIOG ENABLE NVIC SetVectorTable 2 assert param IS NVIC OFFSET Offset NVIC setvectorTable 2 003065 003383 0 080008 LOR PC 0x1C 003066 003384 O0X0800D8AC CMP RS RO 003067 003385 0X0800D8AE Bcc NVIC_SetvectorTable_4 08008 6 2101 HOVS R1 0 1 08008 8 F44F7082 MOV RO 0X104
346. nd transfers the data of the specified memory area to the debugger Indirect reading solves the fast GPIO problem because only direct reg ister access corrupts the register contents Define a 256 byte aligned area in RAM of the LPC target device with the J Link com mand map ram and define afterwards the memory area which should be read indirect with the command map indirectread to use the indirectly reading feature of J Link Note that the data in the defined RAM area is saved and will be restored after using the RAM area This information is applicable to the following devices LPC2101 LPC2102 LPC2103 LPC213x 01 LPC214x all devices LPC23xx all devices LPC24xx all devices Example J Link commands line options can be used for example with the C SPY debugger of the IAR Embedded Workbench Open the Project options dialog and select Debug ger Select Use command line options in the Extra Options tap and enter in the textfield jlink exec command map ram 0 40000000 0 40003 map indirec tread Ox3fffc000 Ox3fffcfff map exclude Ox3fffd000 Ox3fffffff as shown in the screenshot below ptions for node Project General ptions C C Compiler Assembler Custom Build Build Actions Linker link exec command map ram 0 40000000 040003fff map indire gt Simulator Angel IAR ROM monitor J LinkAJ Trace LMI FTDI Macraigor RDI Third Party Driver With these additional commands the valu
347. ndis If checked sent input will be dis played the All Terminals ie S nai eu If checked sent input will be dis played in the Terminal Tab 0 Data en ee ao logging data of Channel 1 toa F5 Stop logging Stops loggind data and close the file Shift F5 Help About Shows version info of RTT Viewer F12 Table 12 1 RTT Viewer Menus and Shortcuts J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 342 CHAPTER 12 RTT Menu entry Contents Shortcut gt J Link Manual Opens the J Link Manual PDF file F11 RTT Webpage Opens the RTT webpage F10 Right Click on Tab Clears the displayed output of this Terminal Tab Table 12 1 RTT Viewer Menus and Shortcuts Clear Terminal 12 3 1 7 Using virtual Terminals in RTT For virtual Terminals the target application needs only Up Channel 0 This is espe cially important on targets with low RAM If nothing is configured all data is sent to Terminal 0 The Teminal to output all following via Write WriteString or printf can be set with SEGGER RTT SetTerminal Output of only one string via a specific Terminal can be done with SEGGER RTT TerminalOut The sequences sent to change the Terminal are interpreted by RTT Viewer Other applications like a Telnet Client will ignore them 12 3 1 8 Using Text Control Codes RTT allow
348. ne by the user to also enable download into a QSPI flash connected to a specific device The setup and behavior is the same as if down load into internal flash which mainly means the device has to be selected and noth ing else would be performed For more information about how to setup the J Link DLL for download into internal flash memory please refer to Setup for various debug gers internal flash on page 245 The sectorization command set and other flash parameters are fully auto detected by the J Link DLL so no special user setup is required J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 255 6 8 Using the DLL flash loaders in custom applica tions The J Link DLL flash loaders make flash behave as RAM from a user perspective since flash programming is triggered by simply calling the J Link API functions for memory reading writing For more information about how to setup the J Link API for flash programming please refer to UM08002 J Link SDK documentation available for SDK customers only J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 256 CHAPTER 6 Flash download J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 257 Chapter 7 Flash breakpoints This chapter describes how the flash breakpoints feature of the DLL can be used in different debugger environments J Link J Trace UM08001 2004 2015 SEGGER Micro
349. ng the init sequence for enabling access to the internal memory for exam ple on the TMS470 some dummy reads of memory are required which will cause an abort as long as the access init is not completed 3 3 3 5 EnableChecks Syntax EnableChecks Description Enables checking if a memory read caused an abort ARM7 9 devices only On some CPUs during the init sequence for enabling access to the internal memory for exam ple on the TMS470 some dummy reads of memory are required which will cause an abort as long as the access init is not completed The default state is Checks enabled 3 3 3 6 flash breakpoints Syntax monitor flash breakpoints lt Value gt Description This command enables disables the Flash Breakpoints feature By default Flash Breapkoints are enabled and can be used for evaluation Example Disable Flash Breakpoints gt monitor flash breakpoints 0 lt Flash breakpoints disabled Enable Flash Breakpoins gt monitor flash breakpoints 1 lt Flash breakpoints enabled 3 3 3 7 getargs Syntax getargs Description Get the currently set argument list which will be given to the application when calling semihosting command SYS_GET_CMDLINE 0x15 The argument list is given as one string Example No arguments set via setargs gt monitor getargs lt No arguments Arguments set via setargs gt monitor getargs lt Arguments test 0 1 2 arg0 4 3 3 3 8 go Syntax go J Link J Trace
350. nk script files on page 216 13 17 7 OMAP3550 Needs a J Link script file to guarantee proper functionality J Link script file can be found at JLINK_INST_DIR Samples JLink Scripts For more information about how to use J Link script files please refer to Executing J Link script files on page 216 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 388 13 18 Toshiba J Link has been tested with the following Toshiba devices TMPM321F10FG TMPM322F10FG TMPM323F10FG TMPM324F10FG TMPM330FDFG TMPM330FWFG TMPM330FYFG TMPM332FWUG TMPM333FDFG TMPM333FWFG TMPM333FYFG TMPM341FDXBG TMPM341FYXBG TMPM360F20FG TMPM361F10FG TMPM362F10FG TMPM363F10FG TMPM364F10FG TMPM366FDFG TMPM366FWFG TMPM366FYFG TMPM370FYDFG TMPM370FYFG TMPM372FWUG TMPM373FWDUG TMPM374FWUG TMPM380FWDFG TMPM380FWFG TMPM380FYDFG TMPM380FYFG TMPM382FSFG TMPM382FWFG TMPM395FWXBG CHAPTER 13 Device specifics Currently there are no specifics for these devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 389 Chapter 14 Target interfaces and adapters This chapter gives an overview about J Link J Trace specific hardware details such as the pinouts and available adapters J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 390 CHAPTER 14 Target interfaces and adapters 14 1 20 pin J Link connector 14 1 1 Pino
351. nna a 424 17 Supported FAQ apt org xul edo d ie ano ated Son Kudai 425 17 1 Measuring download speed memes 426 17 1 1 Test environment es 426 17 2 Troublesho ting ecce ce pret pi perve peste ci wi pet Fu pele die 427 17 2 1 aae eee ote ote oa ERREUR Y EA afa Ea el x 427 17 2 2 Typical problem lt nennen nnns 427 17 3 Contacting Support 429 17 4 Frequently Asked Questions 430 NECI CC MEE 431 19 gt Literat re and KE men 437 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 24 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 25 Chapter 1 Introduction This chapter gives a short overview about J Link and J Trace J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 26 CHAPTER 1 Introduction 1 1 Requirements Host System To use J Link or J Trace you need a host system running Windows 2000 or later For a list of all operating systems which are supported by J Link please refer to Supported OS on page 27 Target System A target system with a supported CPU is
352. nnection dialog of IAR EWARM Options for node Generic Cortex M General Options C C Compiler Assembler Output Converter Custom Build Build Actions Linker Debugger Simulator Angel GDB Server IAR ROM monitor J Link J Trace TI Stellaris Macraigor PE micro RDI ST LINK Third Party Driver 05100 A debugger software which does not provide such a functionality the J Link DLL automatically detects that multiple J Links are connected to the PC and shows a selection dialog which allows the user to select the appropriate J Link to connect to F SEGGER J Link V4 15y beta Emulator selection So even in IDEs which do not have an selection option for the J Link it is possible to connect to different J Links J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 169 4 7 Using the J Link DLL 4 7 1 What is the JLink DLL The J LinkARM d11 is a standard Windows DLL typically used from C C but also Visual Basic or Delphi projects It makes the entire functionality of the J Link J Trace available through the exported functions The functionality includes things such as halting stepping the ARM core reading writing CPU and ICE registers and reading writing memory Therefore it can be used in any kind of application accessing a CPU core 4 7 2 Updating the DLL in third party programs The JLink DLL can be used by any debugger that i
353. nneling mode the Remote server connects to the SEGGER tunnel server via port 19020 and registers with its serial number To connect to the J Link from the remote computer an also simple connection to tunnel lt SerialNo gt can be established and the debugger is connected to the J Link TCP IP Debugger Server J Link 4 4 4 IPStat Connected to 88 84 155 118 USBStat ide r About Status Connected to tunnel server Example scenario A device vendor is developing a new device which shall be supported by J Link Because there is only one prototype a shipment to SEGGER is not possible Instead the vendor can connect the device via J Link to a local computer and start the Remote server in tunneling mode The serial number of the J Link is then sent to a to an engineer at SEGGER The engineer at SEGGER can use J Link Commander or a debugger to test and debug the new device without the need to have the device on the desk J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 137 Start J Link Remote Server in tunneling mode di J Link ARM V4 80 EJ J Flash E J Link Commander J Link Configurator FJ J Link DLL Updater Link GDB Server J Link SWO Viewer E J Mem _ License Agreement 8 Remove J Link ARM V4 80 d Manuals L B Processor Specific Utilities di Release Notes 4 Back Connect to the J Link J Trace via J Link commander J Link Commander can be used to
354. ntains header and footer and the binary data as received from the application Logging can be started via Data Start Logging Note Logging is only available in stand alone mode J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 12 3 1 6 Menus and Shortcuts 341 Menu entry Contents Shortcut File Closes connection and exit RTT Exit Alt Q Viewer Terminals Re mes terminai Opens the next available Terminal Alt A Tab gt Close active terminal Closes the active Terminal Tab Alt C gt Show Log Opens or closes the Log Tab Alt L Terminals gt Terminals AIt 0 gt Terminal 0 9 Opens or closes the Terminal Tab Alt 9 gt Terminal 10 15 Opens or closes the Terminal Tab Input t field Clears the input field without sending Button ont m entered data Clear Input gt Sending mm If selected entered input will be sent x E directly to the target while typing Sesani on hater If selected entered input will be sent 2 2 when pressing Enter If checked RTT Viewer will retry to gt Block if FIFO full send all input to the target when the target buffer is full Input gt End of line gt Windows format CR LF Unix format LF Selects the end of line character to Mac format CR be sent on Enter None Input gt Echo input asso
355. ntation Hard 5 Addr 008000286 Implementation Hard 6 Addr 008000266 Implementation Hard J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 260 CHAPTER 7 Flash breakpoints 7 3 Supported devices J Link supports flash breakpoints for a large number of microcontrollers You can always find the latest list of supported devices on our website http www segger com jlink supported devices html In general J Link can be used with any ARM7 9 11 Cortex MO M1 M3 M4 and Cor tex A5 A8 R4 core even if it does not provide internal flash Furthermore flash breakpoints are also available for all CFI compliant external NOR flash devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 261 7 4 Setup amp compatibility with various debuggers 7 4 1 Setup In compatible debuggers flash breakpoints work if the J Link flash loader works and a license for flash breakpoints is present No additional setup is required The flash breakpoint feature is available for internal flashes and for external flash parallel NOR CFI flash as well as QSPI flash For more information about how to setup vari ous debuggers for flash download please refer to Setup for various debuggers inter nal flash on page 245 Whether flash breakpoints are available can be verified using the J Link control panel x SEGGER J Link 4 35g beta Control p
356. ntax ze 01 11213 where sele 256 Kbytes device 1 a 512 Kbytes device 2 a 1024 KBy vice and 3 a 2648 Kbytes device Show configuration register content and security status Read memory Syntax mem lt Addr gt lt NumBytes gt Er 3 sectors OTP can n be erased gt of bank s of bank 1 onfiguration sector ser Code sector All other bi 6 available gt blank secure Set the E ects deuice from read or debu d by a ful unsecure tion regist protect 8 4 of bank 1 unprotect Unprotect fla Syntax unpro S 1 corMask gt Bank SectorMa a or 8 of bank BankiSectorMa 1 as or 4 of bank 1 Read OTP sect Write words to the OTP sectors Syntax writeotp lt Word1 gt lt Word2 gt lt Word8 gt When starting the STR91x commander a command sequence will be performed which brings MCU into Turbo Mode While enabling the Turbo Mode a dedicated test mode signal is set and controls the GPIOs in output The IOs are maintained in this state until a next JTAG instruction is sent ST Microelectronics Enabling Turbo Mode is necessary to guarantee proper function of all commands in the STR91x Commander 3 11 1 1 Command line options J Link STR91x Commander can be started with different command line options In the following the command line options which are available for J Link STR91x Com mander are explained CommandFile Selects a command file and starts J Link STR91x Commander in batch mode
357. nto your computer s USB port extract the setup tool Setup JLinkARM V VersionNumber zip The setup wizard will install the software and documentation pack that also includes the certified J Link USB driver Start the setup by double clicking Setup JLinkARM V Version Number gt exe The license Agreement dialog box will be opened Accept the terms with the Yes button S3 License Agreement J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 157 2 The Welcome dialog box is opened Click Next gt to open the Choose Destina tion Location dialog box a Welcome Welcome to J Link ARM V 3 58c Setup program This program will install J Link ARM V3 58c on your FA computer Click Cancel to quit Setup click Next to continue with the Setup program WARNING This program is protected by copyright law and international treaties Unauthorized reproduction or distribution of this program or any portion of it may result in severe civil and criminal penalties and will be prosecuted to the maximum extent possible under law 3 Accept the default GERNJLinkARM V lt VersionNumber gt your choice with the Next button A Choose Destination Location installation path C Program Files SEG or choose an alternative location Confirm Setup will install J Link ARM V3 58c in the following folder To install into a different folder click Browse and select anoth
358. ntroller GmbH amp Co KG 278 CHAPTER 10 J Flash SPI 10 1 Introduction The following chapter introduces J Flash SPI highlights some of its features and lists its requirements on host and target systems 10 1 1 What is J Flash SPI J Flash SPI is a stand alone flash programming software for PCs running Microsoft Windows which allows direct programming of SPI flashes without any additional hardware The following Microsoft Windows versions are supported Microsoft Windows 2000 Microsoft Windows XP Microsoft Windows XP x64 Microsoft Windows 2003 Microsoft Windows 2003 x64 Microsoft Windows Vista Microsoft Windows Vista x64 Microsoft Windows 7 Microsoft Windows 7 x64 Windows 8 Windows 8 x64 J Flash SPI has an intuitive user interface and makes programming flash devices con venient J Flash SPI requires a J Link or Flasher to interface to the hardware It is able to program all kinds of SPI flashes even if the CPU they are connected to is not supported by J Link Flasher because J Flash SPI communicates directly with the SPI flash bypassing all other components of the hardware 10 1 2 J Flash SPI CL Windows Linux Mac J Flash SPI CL is a commandline only version of the J Flash SPI programming tool The command line version is included in the J Link Software and Documentation Package for Windows Linux and Mac cross platform Except from the missing GUI J Flash SPI CL is identical to the normal version The commands
359. o KG 160 CHAPTER 4 Setup Right click on the driver to open a context menu which contains the command Prop erties If you select this command a J Link driver Properties dialog box is opened and should report This device is working properly driver Properties Use tis device enable If you experience problems refer to the chapter Support and FAQs on page 425 for help You can select the Driver tab for detailed information about driver provider version date and digital signer mem driver Properties 4 2 2 Uninstalling the J Link USB driver If J Link J Trace is not properly recognized by Windows and therefore does not enu merate it makes sense to uninstall the J Link USB driver This might be the case when e The LED on the J Link J Trace is rapidly flashing e The J Link J Trace is recognized as Unknown Device by Windows To have a clean system and help Windows to reinstall the J Link driver follow this procedure 1 Disconnect J Link J Trace from your PC 2 Open the Add Remove Programs dialog Start Settings Control Panel gt Add Remove Programs and select Windows Driver Package Segger J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 161 jlink USB and click the Change Remove button Ea Add Remove Programs 3 Confirm the uninstallation process Uninstall Driver Package Q J Link J Tr
360. o extra work is necessary on the debugger side since the debugger does not have to differ between memory writes to RAM and memory writes to flash J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 243 6 2 Licensing No extra license required The flash download feature can be used free of charge J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 244 CHAPTER 6 Flash download 6 3 Supported devices J Link supports download into the internal flash of a large number of microcontrol lers You can always find the latest list of supported devices on our website http www segger com jlink supported devices html In general J Link be used with any ARM7 9 11 Cortex MO M1 M3 M4 and Cor tex A5 A8 R4 core even if it does not provide internal flash Furthermore flash download is also available for all CFI compliant external NOR flash devices J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 245 6 4 Setup for various debuggers internal flash The J Link flash download feature can be used by different debuggers such as IAR Embedded Workbench Keil MDK GDB based IDEs For different debuggers there are different steps required to enable J Link flash download In this section the setup for different debuggers is explained 6 4 4 IAR Embedded Workbench Using the J Link flash download feature in IAR EWARM is quite simple
361. of the J Link can be customized via command strings passed to the JLinkARM d11 which controls J Link Applications such as the J Link Commander but also the C SPY debugger which is part of the IAR Embedded Workbench allow pass ing one or more command strings Command line strings can be used for passing commands to J Link such as switching on target power supply as well as customize the behavior by defining memory regions and other things of J Link The use of command strings enables options which can not be set with the configuration dialog box provided by C SPY 5 12 1 List of available commands The table below lists and describes the available command strings Command Description Enables Disables always appending new loginfo to log AppendToLogFile file CORESIGHT_SetIndexAHBAP Selects a specific AHB AP to be used to connect to a ToUse Cortex M device CORESIGHT_SetIndexAPBAP Selects a specific APB AP to be used to connect to a ToUse Cortex A or Cortex R device device Selects the target device DisableAutoUpdateFW Disables automatic firmware update DisableCortexMXPSRAutoC Disables auto correction of XPSR T bit for Cortex M OfrrectTBit devices DisableFlashBPs Disables the FlashBP feature DisableFlashDL Disables the J Link FlashDL feature DisableIn
362. ogram crash occurred in case of a runaway program count A debugger provides the user interface to J Trace and the stored trace data The debugger enables all the ETM facilities and displays the trace information that has been captured J Trace is seamlessly integrated into the IAR Embedded Workbench IDE The advanced trace debugging features can be used with the IAR C SPY debug ger 15 2 1 Trigger condition The ETM can be configured in software to store trace information only after a specific sequence of conditions When the trigger condition occurs the trace capture stops after a programmable period 15 2 2 Code tracing and data tracing Code trace Code tracing means that the processor outputs trace data which contain information about the instructions that have been executed at last Data trace Data tracing means that the processor outputs trace data about memory accesses read write access to which address and which data has been read stored In general J Trace supports data tracing but it depends on the debugger if this option is available or not Note that when using data trace the amount of trace data to be captured rises enormously 15 2 3 J Trace integration example IAR Embedded Work bench for ARM In the following a sample integration of J Trace and the trace functionality on the debugger side is shown The sample is based on IAR s Embedded Workbench for ARM integration of J Trace J Link J Trace UM08001
363. on Has to be called once before using any other _CORESIGHT_ function that accesses the DAP Takes a configuration string to prepare target and J Link for CoreSight function usage Configuration string may contain multiple setup parameters that are set Setup parameters are separated by a semicolon At the end of the JLINK_CORESIGHT_Configure the appropriate target interface switching sequence for the currently active target interface is output if not disabled via setup parameter This function has to be called again each time the JTAG chain changes for dynami cally changing JTAG chains like those which include a TI ICEPick in order to setup the JTAG chain again For JTAG The SWD gt JTAG switching sequence is output This also triggers a TAP reset on the target TAP controller goes through gt Reset gt Idle state The IRPre DRPre IRPost DRPost parameters describe which device inside the JTAG chain is currently selected for communication For SWD The JTAG gt SWD switching sequence is output It is also made sure that the overrun mode enable bit in the SW DP CTRL STAT reg ister is cleared as in SWD mode J Link always assumes that overrun detection mode is disabled Make sure that this bit is NOT set by accident when writing the SW DP CTRL STAT register via the _CORESIGHT_ functions Prototype int JLINK CORESIGHT Configure const char sConfig Example if MAIN ActiveTIF JLINK TIF JTAG Si
364. on alternatively on pins 11 and 13 of the Cortex M 19 pin trace connector J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 60 CHAPTER 1 Introduction 1 5 Supported CPU cores J Link J Trace has been tested with the following cores but should work with any ARM7 9 11 Cortex M0 M1 M3 M4 and Cortex A5 A8 A9 R4 core If you experience problems with a particular core do not hesitate to contact Segger ARM7TDMI Rev 1 ARM7TDMI Rev 3 ARM7TDMI S Rev 4 ARM720T ARM920T ARM922T ARM926EJ S ARM946E S ARM966E S ARM1136JF S ARM1136J S ARM1156T2 S ARM1156T2F S ARM1176JZ S ARM1176JZF ARM1176JZF S Cortex A5 Cortex A8 Cortex A9 Cortex MO Cortex M1 Cortex M3 Cortex M4 Cortex R4 Renesas RX J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 61 1 6 Built in intelligence for supported CPU cores In general there are two ways to support a CPU core in the J Link software 1 Intelligence in the J Link firmware 2 Intelligence on the PC side DLL Having the intelligence in the firmware is ideal since it is much more powerful and robust The J Link PC software automatically detects which implementation level is supported for the connected CPU core If intelligence in the firmware is available it is used If you are using a J Link that does not have intelligence in the firmware and only PC side intelligence is available for the connected CPU a warning message is
365. on Common features of the J Link product family updated 69 090515 AG Chapter Working with J Link Section Reset strategies updated Section Indicators updated Chapter Flash download and flash breakpoints Section Supported devices updated 68 090428 AG Chapter J Link and J Trace related software Section J Link STM32 Commander added Chapter Working with J Link Section Reset strategies updated 67 090402 AG Chapter Working with J Link Section Reset strategies updated J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation Chapter Background information Section Embedded Trace Macrocell ETM updated 68 990927 AC ene J Link and J Trace related software Section Dedicated flash programming utilities for J Link updated 65 090320 Several changes the manual structure Chapter Working with J Link 54 OPES 12 Section Indicators added Chapter Hardware 63 090212 Several corrections Section Hardware Versions Version 8 0 added Chapter Working with J Link and J Trace Section Reset strategies updated Chapter J Link and J Trace related software Section J Link STR91x Commander 62 DE AG Command line tool updated Chapter Device specifics Section ST Microelectronics up
366. on J Link script files updated Chapter Licensing Sectin Original SEGGER products updated V5 02c Rev 1 150925 Chapter Flash download Section Setup for various debuggers CFI flash updated Chapter Flash download V5 02c Rev 0 150916 RH Section Setup for various debuggers SPIFI flash added Chapter Introduction Section J Link J Trace models updated Section Supported OS Added Windows 10 V5 02a Rev 0 150903 AG Chapter Monitor Mode Debugging added Chapter Working with J Link and J Trace V5 02 Rev O 150820 AG Section Command strings DisableCortexMXPSRAutoCorrectTBit added V5 02 Rev 0 150813 Chapter Monitor Mode Debugging added Chapter Related Software V5 00 Rev 1 1150728 Section J Link Commander Sub Section Command line options updated Chapter Flash download Section QSPI flash support added Chapter Flash breakpoints Section Flash Breakpoints in QSPI flash added Chapter J Flash SPI Initial version added Chapter Related Software V4 99b Rev 0 150520 Section J Link STM32 Unlock Added command line options Chapter Target interfaces and Adapters V4 99a Rev 0 150429 Chapter 20 J Link connector section Pinout for SPI added Chapter Related Software V4 98d Rev 0 150427 EL Section Configure SWO output after device reset updated Chapter Licensing Section J Trace for Cortex M updated Chapter
367. on any IP address To allow remote debugging connecting to GDBServer from another PC deactivate this option If no parameter is given it will be set to 1 active Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax LocalhostOnly State Example jlinkgdbserver LocalhostOnly 0 Listen on any IP address Linux MAC default jlinkgdbserver LocalhostOnly 1 Listen on localhost only Windows default 3 3 5 8 log Description Starts the GDB Server with the option to write the output into a given log file The file will be created if it does not exist If it exists the previous content will be removed Paths including spaces need to be set between quotes Syntax log LogFilePath Example jlinkgdbserver log C my path to file log 3 3 5 9 logtofile Description Starts the GDB Server with the option to write the output into a log file If no file is given via 1og the log file will be created in the GDB Server application directory Note For the GUI version this setting is persistent for following uses of GDB Server until changed via nologtofile or the GUI Syntax logtofile Example jlinkgdbserver logtofile jlinkgdbserver logtofile log C my path to file log 3 3 5 10 halt Description Halts the target after connecting to it on start of GDB Server For most IDEs this option is mandato
368. on for the J Link GDB Server is done by the gdbinit file The follow ing command has to be added to the gdbinit file to enable the J Link flash down load feature monitor flash device DeviceName J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 249 lt DeviceName gt is the name of the device for which download into internal flash mem ory shall be enabled For a list of supported devices please refer to Supported devices on page 244 For more information about the GDB monitor commands please refer to J Link GDB Server on page 102 6 4 5 J Link Commander J Link Commander supports downloading bin files into internal flash memory of pop ular microcontrollers In the following it is explained which steps are necessary to prepare J Link Commander for download into internal flash memory 6 4 5 1 Preparing J Link Commander for flash download To configure J Link Commander for flash download simply select the connected device by typing in the following command exec device lt DeviceName gt DeviceName is the name of the device for which download into internal flash mem ory shall be enabled For a list of supported devices please refer to Supported devices on page 244 In order to start downloading the binary data file into flash please type in the following command loadfile filename lt addr gt Filename is the path of the binary data file which should be downloaded into the
369. one 1 208 sec in 32 calls 2 e Log file Shows the path where the J Link log file is placed It is possible to override the selection manually by enabling the Override checkbox If the Over ride checkbox is enabled a button appears which let the user choose the new location of the log file e Settings file Shows the path where the configuration file is placed This config uration file contains all the settings which can be configured in the Settings tab e Override device selection If this checkbox is enabled a dropdown list appears which allows the user to set a device manually This especially makes sense when J Link can not identify the device name given by the debugger or if a particular device is not yet known to the debugger but to the J Link software e Allow caching of flash contents If this checkbox is enabled the flash con tents are cached by J Link to avoid reading data twice This speeds up the trans fer between debugger and target Allow instruction set simulation If this checkbox is enabled instructions will be simulated as far as possible This speeds up single stepping especially when FlashBPs are used e Save settings When this button is pushed the current settings in the Settings tab will be saved in a configuration file This file is created by J Link and will be created for each project and each project configuration e g Debug RAM Debug Flash If no settings file is given this button is not visible
370. onfigure the J Link For more information about the generic setup of J Link RDI please refer to Configuration on page 320 Embedded Workbench IDE Iul J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 306 CHAPTER 11 RDI 11 3 1 3 Debugging on Cortex M3 devices The RDI protocol has only been specified by ARM for ARM 7 9 cores For Cortex M there is no official extension of the RDI protocol regarding the register assignement that has been approved by ARM Since IAR EWARM version 5 11 it is possible to use J Link RDI for Cortex M devices because SEGGER and IAR have come to an agree ment regarding the RDI register assignment for Cortex M The following table lists the register assignment for RDI and Cortex M Assigned register 0 RO 1 R1 2 R2 3 R3 4 R4 5 R5 6 R6 7 R7 8 R8 9 R9 10 R10 11 R11 12 R12 13 MSP PSP depending on mode 14 R14 LR 16 R15 PC 17 XPSR 18 APSR 19 IPSR 20 EPSR 21 IAPSR 22 EAPSR 23 IEPSR 24 PRIMASK 25 FAULTMASK 26 BASEPRI 27 BASEPRI MAX 28 CFBP CONTROL FAULT BASEPRI PRIMASK Table 11 1 Cortex M register mapping for IAR J Link RDI J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 11 3 2 ARM AXD ARM Developer Suite ADS 11 3 2 1 Software version The JLinkRDI d11 has been tested with ARM s AXD vers
371. ontroller currently is it can change into Reset state if TMS is high for at least 5 clock cycles As long as TMS is high the TAP controller remains in Reset state Idle Idle is a TAP controller state between scan DR or IR operations Once entered this state remains active as long as TMS is low DR Scan Temporary controller state If TMS remains low a scan sequence for the selected data registers is initiated IR Scan Temporary controller state If TMS remains low a scan sequence for the instruction register is initiated Capture DR Data may be loaded in parallel to the selected test data registers Shift DR The test data register connected between TDI and TDO shifts data one stage towards the serial output with each clock J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 410 CHAPTER 15 Background information Exit1 DR Temporary controller state Pause DR The shifting of the test data register between TDI and TDO is temporarily halted Exit2 DR Temporary controller state Allows to either go back into Shift DR state or go on to Update DR Update DR Data contained in the currently selected data register is loaded into a latched parallel output for registers that have such a latch The parallel latch prevents changes at the parallel output of these registers from occurring during the shifting process Capture IR Instructions may be loaded in parallel into the instruction re
372. opened For more information about the generic setup of J Link RDI please refer to Configuration on page 320 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 319 After finishing configuration the project can be built Project Build Target and the debugger can be started Debug Start Stop debug session Blinky uVision3 Disassembly R10 BH R12 7 R13 SP R14 LR R15 PC J Link J Trace UM08001 358 341 342 343 355 355 346 347 348 ES9FF 618 E59FF 618 E59FF 618 E59FF 618 E59FF 618 B9266E56 0x00000018 E51FF128 Reset fiddr Undef fddr SWI_Addr Pabt Rddr DAbt_Addr IRQ_Addr FIQ_Addr PC Reset fiddr PC PC 10x8018 PC Undef PC PC 6x0018 PC SUI_Addr PC PC 6x6018 PAbt_Addr PC PC 6x6618 PC DAbt_Addr PC PC 6x0618 Reserved Vector PC IRQ_Addr R6 R4 R6 R9 R11 R13 R14 PC PC 6x6126 Vector from VicUectAddr PC PC 6x0126 PC FIQ Addr Reset_Handler Undef_Handler SWI_Handler PAbt_Handler DAbt_Handler 6 Reserved Address IRQ_Handler FIQ Handler 00000000 00000000 00000000 00000000 600000DF 00000000 00000000 00000000 600000DF 00000000 00000000 00000000 00000000 00000000 600000DF 00000000 2004 2015 SEGGER Microcontroller GmbH amp Co KG 320 CHAPTER 11 RDI 11 4 Configuration This section describes the generic setup of J Link RDI same for all debuggers
373. or example another instance of IAR Embedded Work bench for ARM J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 187 6 Choose Project Options and configure your second scan chain The following dialog box shows the configuration for the second ARM core on your target Options for node BTL_AT91_ 430 Category General Options C C Compiler Assembler Custom Build Build Actions Linker Debugger Simulator Angel IAR ROM monitor Macraigor RDI Third Party Driver Setup Connection Factory Settings r Communication USB Meee aaa bbb cec ddd JTAG scan chain TAP number fi JTAG scan chain with multiple targets Scan chain contains non amp RM devices Preceeding bits fo Log communication TOOLKIT DIR cspycomm log 7 Start debugging your second core Example TAP number TAP number Core 1 Core 2 Core 3 debugger 41 debugger 2 ARM7TDMI ARM7TDMI S ARM7TDMI 0 1 ARM7TDMI ARM7TDMI ARM7TDMI 0 2 ARM7TDM I S ARM7TDMI S ARM7TDMI S 1 2 Table 5 9 Multicore debugging Cores to debug are marked in blue 5 5 3 Things you should be aware of Multi core debugging is more difficult than single core debugging You should be aware of the pitfalls related to JTAG speed and resetting the target JTAG speed 5 5 3 1 Each core has its own m
374. or other docu Reference ments GUIElement Buttons dialog boxes menu names menu commands Emphasis Very important sections Table 1 1 Typographic conventions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 16 CHAPTER SEGGER Microcontroller GmbH amp Co KG develops and distributes software development tools and ANSI C software components middleware for embedded sys tems in several industries such as telecom medical technology consumer electronics automotive industry and industrial automation SEGGER SEGGER s intention is to cut software development time for embedded applications by offering compact flexible and easy to use middleware allowing developers to concentrate on their application Our most popular products are emWin a universal graphic software package for embed ded applications and embOS a small yet efficient real time kernel emWin written entirely in ANSI C can easily be used on any CPU and most any display It is comple mented by the available PC tools Bitmap Converter Font Converter Simulator and Viewer embOS supports most 8 16 32 bit CPUs Its small memory footprint makes it suitable for single chip applications Apart from its main focus on software tools SEGGER develops and produces programming tools for flash micro controllers as well as J Link a JTAG emulator to assist in develop ment debugging and production which has rapidly be
375. ore information about the J Link Configurator please refer to J Link Configurator on page 165 Configure J Link General Product SEGGER J Link ARM V9 00 SN 59200005 Nickname USB Identification Real SN v Real SN 59200006 Virtual COM Port T Note The new configuration Disable applies after power cycling the debug probe 5 15 1 2 Via J Link Commander Simply start J Link Commander which is part of the J Link software and documenta tion package and enter the vcom enable disable command as in the screenshot below After changing the configuration a power on cycle of the debug probe is nec essary in order to use the new configuration For feature information about how to use the J Link Commander please refer to J Link Commander Command line tool on page 83 3 C Work JLinkARM Output Release JLink exe EE SEGGER J Link Commander U4 81f for help Compiled Mar 6 2614 11 02 49 version U4 81f compiled Mar 6 2014 11 02 41 J Link 09 compiled Feb 12 2014 21 47 56 9 00 FlashBP FlashDL JFlash J e The new configuration applies after power cycling the debug probe J Link gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 240 CHAPTER 5 Working with J Link and J Trace J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 241 Chapter 6 Flash download This chapter describes how the flash down
376. out cables 4imm x 34mm x 8mm Weight without cables 6g Mechanical USB interface USB 2 0 full speed Target interface 19 0 05 Samtec FTSH connector 9 pin 0 05 Samtec FTSH connector Power supply JTAG SWD Interface Electrical USB powered Max 50mA Target Supply current Target interface voltage Vir 3 3V Target supply voltage 4 5V 5V Target supply current Max 300 LOW level input voltage Vr Max 40 of Vir HIGH level input voltage Min 60 of JTAG SWD Interface Timing Data input rise time T qj Max 20ns Data input fall time Trai Max 20ns Data output rise time T go Max 10ns Data output fall time Trao Max 10ns Clock rise time Max 10ns Clock fall time T4 Max 10ns Table 1 9 J Link Lite Cortex M specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 52 CHAPTER 1 Introduction 1 38 J Trace ARM J Trace ARM is a JTAG emulator designed for ARM cores which includes trace ETM support It connects via USB to a PC run ning Microsoft Windows 2000 or later For a complete list of all operating systems which are supported please refer to Sup ported OS on page 25 J Trace has a built in 20 pin JTAG con nector and a built 38 pin JTAG Trace connector which are compatible to the standard 20 pin connector and 38 pin con n
377. ow Generate logfile If checked a log file with the GDB lt gt GDB Server lt gt J Link communication will be created e Verify download If checked the memory on the target will be verified after download e Init regs on start If checked the register values of the target will be set to a reasonable value before on start of GDB Server 3 3 2 4 Running GDB from different programs We assume that you already have a solid knowledge of the software tools used for building your application assembler linker C compiler and especially the debugger and the debugger frontend of your choice We do not answer questions about how to install and use the chosen toolchain J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 105 GDB is included in many IDEs and most commonly used in connection with the GCC compiler toolchain This chapter shows how to configure some programs to use GDB and connect to GDB Server For more information about any program using GDB please refer to its user manual emIDE emIDE is a full featured free and open source IDE for embedded development including support for debugging with J Link To connect to GDB Server with emIDE the GDB Server configurations need to be set in the project options at Project gt Properties gt Debugger Select the target device you are using the target connection endianess and speed and enter the additional GDB start commands The typica
378. ows Apple OSX or Linux J Link BASE has a built in 20 pin JTAG con nector which is compatible with the standard 20 pin connector defined by ARM Included Licenses J Link Flashloaders J Link GDB Server Optional Licenses J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI 2 4 2 J Link PLUS J Link J Trace UM08001 J Link PLUS is a USB powered JTAG emu lator supporting a large number of CPU cores Based on a 32 bit RISC CPU it can communicate at high speed with the supported target CPUs J Link is used around the world in tens of thousand places for development and production flash programming purposes J Link is supported by all major IDEs such as IAR EWARM Keil MDK Rowley CrossWorks Atollic TrueSTUDIO IAR EWRX Renesas HEW Renesas e2studio and many others Included Licenses J Link Flashloaders J Link GDB Server J Link Debugger J Flash Unlimited Flash Breakpoints RDI RDDI 2004 2015 SEGGER Microcontroller GmbH amp Co KG 72 CHAPTER 2 Licensing 2 4 3 J link ULTRA 2 4 4 J Link PRO J link ULTRA is a JTAG SWD emulator designed for ARM Cor tex and other supported CPUs It is fully compatible to the stan dard J Link and works with the same PC software Based on the highly optimized and proven J Link it offers even higher speed as well as target power measurement capabilities due to the faster CPU built in FPGA and High speed USB interface J link ULTRA has
379. p select of target SPI active LOW 9 CLK Output SPI clock signal Vee cons c Leave open on target side nected Data out of target SPI Input of J Link used to receive data 592 from the target SPI Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is typically called nRST nRESET or RESET Leave open on target side nected This pin can be used to supply power to the target hard 5V Sup ware Older J Links may not be able to supply power on this 19 Output pin For more information about how to enable disable the ply power supply please refer to Target power supply on page 392 Table 14 6 J Link J Trace pinout Pins 4 6 8 10 12 are GND pins connected to GND in J Link They should also be connected to GND in the target system J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 14 2 38 pin Mictor JTAG and Trace connector 1 provides JTAG Trace connector This connector is a 38 pin mictor plug It connects to the target via a 1 1 cable The connector on the target board should be TYCO type 5767054 1 or a compatible receptacle J Trace supports 4 8 and 16 bit data port widths with the high density target connector described below Target board trace connector Target system Pin 1 chamfer J Trace can capture the state of signals PIPESTAT 2 0 TRACESYNC and TRACEPKT n 0 at
380. parators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor SWDIO TMS I O output SWDIO Single bi directional data pin JTAG mode set input of target CPU This pin should be pulled up on the target Typically connected to TMS of the target CPU SWCLK TCK Output SWCLK Clock signal to target CPU It is recommended that this pin is pulled to a defined state of the target board Typically connected to TCK of target CPU JTAG clock signal to target CPU SWO TDO Input JTAG data output from target CPU Typically connected to TDO of the target CPU When using SWD this pin is used as Serial Wire Output trace port Optional not required for SWD communica tion This pin normally pin 7 is not existent on the 19 pin JTAG SWD and Trace connector TDI Output JTAG data input of target CPU It is recommended that this pin is pulled to a defined state on the target board Typically connected to TDI of the target CPU For CPUs which do not provide TDI SWD only devices this pin is not used J Link will ignore the signal on this pin when using SWD NC NC Not connected inside J Link Leave open on target hard ware 10 nRESET I O Target CPU reset signal Typically connected to the RESET pin of the target CPU which is typically called nRST nRESET or RESET 11 5V Supply Out
381. pective pur pose The J Link SDK requires an additional license and is available upon request from www segger com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 155 Chapter 4 Setup This chapter describes the setup procedure required in order to work with J Link J Trace Primarily this includes the installation of the J Link software and documenta tion package which also includes a kernel mode J Link USB driver in your host sys tem J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 156 CHAPTER 4 Setup 4 1 Installing the J Link software and documentation pack J Link is shipped with a bundle of applications corresponding manuals and some example projects and the kernel mode J Link USB driver Some of the applications require an additional license free trial licenses are available upon request from www segger com Refer to chapter J Link software and documentation package on page 81 for an over view of the J Link software and documentation pack 4 1 1 Setup procedure To install the J Link software and documentation pack follow this procedure Note We recommend to check if a newer version of the J Link software and doc umentation pack is available for download before starting the installation Check therefore the J Link related download section of our website http www segger com download_jlink html 1 Before you plug your J Link J Trace i
382. port of ETB Does J Link support the Embedded Trace Buffer ETB Yes J Link supports ETB Most current ARM7 ARM9 chips do not have ETB built in Registers on ARM 7 ARM 9 targets I m running J Link exe in parallel to my debugger on an ARM 7 target I can read memory okay but the processor registers are different Is this normal If memory on an ARM 7 9 target is read or written the processor registers are modified When memory read or write operations are performed J Link preserves the register values before they are modified The register values shown in the debugger s register window are the preserved ones If a second instance in this case J Link exe reads the processor registers it reads the values from the hard ware which are the modified ones This is why it shows different register values J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 431 Chapter 18 Glossary This chapter describes important terms used throughout this manual J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 432 CHAPTER 18 Glossary Adaptive clocking A technique in which a clock signal is sent out by J Link J Trace J Link J Trace waits for the returned clock before generating the next clock pulse The technique allows the J Link J Trace interface unit to adapt to differing signal drive capabilities and differing cable lengths Application Program Interface A
383. ported ARM cores updated 23 070320 SK Chapter Hardware Using the JTAG connector with SWD updated 22 070316 SK Chapter Hardware Using the JTAG connector with SWD added 21 070312 SK Chapter Hardware Differences between different versions supplemented J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 20 070307 SK Chapter J Link J Trace related software J Link GDB Server licensing updated 19 070226 SK Chapter J Link J Trace related software updated and reorganized Chapter Hardware List of OEM products updated 18 070221 SK Chapter Device specifics added Subchapter Command strings added 17 070131 SK Chapter Hardware Version 5 3 Current limits added Version 5 4 added Chapter Setup Installating the J Link USB driver removed Installing the J Link software and documentation pack added Subchapter List of OEM products updated OS support updated 16 061222 SK Chapter Preface Company description added J Link picture changed 15 060914 OO Subchapter 1 5 1 Added target supply voltage and target supply current to specifications Subchapter 5 2 1 Pictures of ways to connect J Trace 14 060818 TQ Subchapter 4 7 Using DCC for memory reads added 13
384. power on power off Switch target power off power on perm Set target power supply default to on power off perm Set target power supply default to off Table 14 11 Command List J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 404 CHAPTER 14 Target interfaces and adapters 14 4 9 pin JTAG SWD connector Some target boards only provide a 9 pin JTAG SWD connector for Cortex M For these devices SEGGER provides a 20 pin 9 pin Cortex M adapter 1ee2 SWDIO TMS 3 4 SWCLK GND Sees SWO TDO 7 8 TDI 9 e e 10 nRESET The following table lists the output of the 9 pin Cortex M connector PIN SIGNAL TYPE Description VTref Input This is the target reference voltage It is used to check if the target has power to create the logic level reference for the input comparators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor SWDIO TMS I O output SWDIO Single bi directional data pin JTAG mode set input of target CPU This pin should be pulled up on the target Typically connected to TMS of the target CPU SWCLK TCK Output SWCLK Clock signal to target CPU It is recommended that this pin is pulled to a defined state of the target board Typically connected to TCK of target CPU JTAG clock signal to target CPU
385. projx 15 09 25 13 51 Visions Project 17 KB 15 09 25 13 42 Configuration sett 1KB Desktop 15 10 01 9 47 JLINKSCRIPT File 4KB A 6 items The JLinkSettings ini is a settings file created by the J Link DLL on debug session start If no script file is explicitly passed to the DLL it will search in the directory of the JLinkSettings ini for a script file named like the settings file only with a different file extension 5 11 7 3 In other debugger IDE environments To execute a J Link script file out of your debugger IDE simply select the script file to execute in the Settings tab of the J Link control panel and click the save button after the debug session has been started Usually a project file for J Link is set by the debugger which allows the J Link DLL to save the settings of the control panel in this project file After selecting the script file restart your debug session From now on the script file will be executed when starting the debug session 5 11 7 4 In GDB Server In order to execute a script file when using J Link GDB Server simply start the GDB Server using the following command line paramter scriptfile lt file gt For more information about the scriptfile command line parameter please refer to J Link GDB Server on page 102 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 218 CHAPTER 5 Working with J Link and J Trace 5 12 Command strings The behavior
386. protocol serial port Ex Multi ICE v2 25 ARM JTAG debug interface parallel port ARMulator v1 4 ARM instruction set simulator 7 Click the OK button in the configuration dialog Now close the RDI Target List dialog Make sure your target hardware is already connected to J Link 8 In the Connection control dialog expand the JLink ARM RDI Interface and select the ARM 0 Processor Close the Connection Control Window fg ARM A RR ARM Ltd RDI targets Separator ARM instruction set simulator ES JLinkRDI dll J Link ARM RDI Interface Connection Broker Simulator Broker al Motorola Macraigor Wiggler emulator 82 MOT_WIGGLER Macraigor Wiggler pple ree ARM Ltd Direct Connection HF 26 5 U Versatile Platform for 926 0 5 USB port J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 313 9 Now the RealView Debugger is connected to J Link 2 RVDEBUG lt Start_STR71x gt 0 ARM A RR No source for context _ENTRY_ lt entry point J Click to Load C temp emb0S Start STR71x RAM Start STR7lx axf 00000000 re nn 00000000 00000000 00000000 00000000 00000000 00000000 00000000 CPSR 00000003 0x0000000 Unknown Location gt connect route 2 gt connect 10 Advanced_info searched in Local Advanced_info Using Advanced info based on Default or All Warning Vector catching specification is not supported by target Warning No st
387. provides an overview of the included sample projects and describes the menu structure of J Flash SPI in detail 10 3 1 Setup For J Link setup procedure required in order to work with J Flash SPI please refer to chapter Setup on page 155 10 3 1 1 What is included The following table shows the contents of all subdirectories of the J Link software and documentation pack with regard to J Flash SPI Directory Contents The J Flash SPI application Please refer to the J Link manual for more information about the other J Link related tools Contains the J Flash SPI documentation and the other J Link related manuals Table 10 1 J Flash SPI directory structure 10 3 2 Using J Flash SPI for the first time Start J Flash SPI from the Windows Start menu The main window will appear which contains a log window at the bottom and the Project window of a default project on the left The application log will initially display NDoc e version and time of compilation for the application e The version and time of compilation for the J Link DLL e The location of the default project The Project window contains an overview of the current project settings initially a default project is opened J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 281 Connection USB Device 0 Interface speed 4000 kHz Flash memory Auto detection 10 3 3 Menu structure The main window of
388. pter STRACE J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 122 CHAPTER 3 J Link software and documentation package Response lt ReturnValue gt ReturnValue is a 4 Byte signed integer gt 0 lt 0 Error Note ReturnValue is hex encoded Return value 0 is 00000000 return value 1 is FFFFFFFF 3 3 4 4 qSeggerSTRACE read Syntax qSeggerSTRACE read lt NumItems gt Parameter NumItems Maximum number of trace data addresses to be read Hexadecimal Description Read the last recently called instruction addresses The addresses are returned LIFO meaning the last recent address is returned first Note For more information please refer to UM08002 J Link SDK user guide chapter STRACE Response lt ReturnValue gt lt Item0 gt lt Iteml gt ReturnValue is a 4 Byte signed integer gt 0 Number of items read lt 0 Error ItemN is a 4 Byte unsigned integer 0x00000000 OxFFFFFFFF Address of the executed instruction Note ReturnValue and ItemN are hex encoded e g 3 Items read 0x08000010 0x08000014 0x08000018 Response will be 00000003080000100800001408000018 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 123 3 3 5 Command line options There are several command line options available for the GDB Server which allow configuration of the GDB Server before any connection to a J Link is attempted or any
389. put This pin can be used to supply power to the target hard ware For more information about how to enable disable the power supply please refer to Target power supply on page 403 12 TRACECLK Input Input trace clock Trace clock 1 2 CPU clock 13 5V Supply Output This pin can be used to supply power to the target hard ware For more information about how to enable disable the power supply please refer to Target power supply on page 403 14 TRACE DATA 0 Input Input Trace data pin O Table 14 10 19 pin JTAG SWD and Trace pinout J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 403 PIN SIGNAL TYPE Description 16 DATAE Input Input Trace data pin 0 18 Input Input Trace data 0 20 Taal Input Input Trace data pin O Table 14 10 19 pin JTAG SWD and Trace pinout Pins 3 5 15 17 19 are GND pins connected to GND in J Trace CM3 They should also be connected to GND in the target system 14 3 1 Target power supply Pins 11 and 13 of the connector can be used to supply power to the target hardware Supply voltage is 5V max current is 300mA The output current is monitored and protected against overload and short circuit Power can be controlled via the J Link commander The following commands are available to control power Command Explanation power on Switch target
390. r in batch mode The batch mode of J Link Commander is similar to the execution of a batch file The command file is parsed line by line and one command is executed at a time Syntax CommandFile lt CommandFilePath gt Example See Using command files on page 100 3 2 2 3 Device Pre selects the device J Link Commander shall connect to For some devices J Link already needs to know the device at the time of connecting since special handling is required for some of them For a list of all supported device names please refer to http www segger com jlink_supported_devices html Syntax Device lt DeviceName gt Example JLink exe Device STM32F103ZE 3 2 2 4 ExitOnError Similar to the exitonerror eoe command 3 2 2 5 If Selects the target interface J Link shall use to connect to the target By default J Link Commander first tries to connect to the target using the target interface which is currently selected in the J Link firmware If connecting fails J Link Commander goes through all target interfaces supported by the connected J Link and tries to connect to the device Syntax If lt TargetInterface gt Example JLink exe If SWD Additional information Currently the following target interfaces are supported e SWD 3 2 2 6 IP Selects IP as host interface to connect to J Link Default host interface is USB Syntax IP lt IPAddr gt Example JLink exe IP 192 168 1 17 J Link
391. r non 3 3V targets Version 9 1 e New design based on STM32F205 Version 9 2 Identical to version 9 1 with the following exception e Pin 1 VTref is used for measuring target reference voltage only Buffers on J Link side are no longer powered through this pin but via the J Link internal volt age supplied via USB Hardware version 3 0 4 0 5 0 5 2 5 3 5 4 6 0 7 0 8 0 9 1 9 2 Hardware features USB 0 00 JTAG interface SWD interface SWO interface Microchip ICSP interface 9 Q O O O 9 6 O QO Q OO 9 9 9 Q 9 9 9 O 9 9 9 9 O 9 9 9 9 O e O 9 9 O Renesas FINE inter face Table 1 2 J Link BASE hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Hardware version 3 0 4 0 5 0 5 2 5 3 5 4 6 0 7 0 8 0 9 1 9 2 ETB Trace 0000009090000 Supported cores ARM legacy cores ARM7 0000009090000 ARMS 0000009090000 ARM11 6 666606 9 00 ARM Cortex cores Cortex A5 686666666600 Cortex A7 eg 9 69 6 6 0 Cortex A8 e090 01000190 9 90 9 Cortex A9 e000 00000 Cortex A12 e090 010 00190 0 90 9 Cortex A15 600000000075 0 Cortex A17 6 666666660
392. r of devices which are closer to TDO than the JTAG DRPre one we want to communicate with R Example JTAG DRPre 2 Used for JTAG chain configuration Sets the num ber of IR bits of all devices which are closer to JTAG IRPost TDI than the one we want to communicate with R Example JTAG IRPost 6 Table 5 11 Global DLL variables J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 211 Example JTAG_TMSPin 0 Variable Description R W Used for JTAG chain configuration Sets the num ber of devices which are closer to TDI than the JTAG_DRPost one we want to communicate with R Example JTAG_DRPost 0 IR Len in bits of the device we want to commu JTAG_TRLen nicate with R Example JTAG IRLen 4 Computed automatically based on the values of JTAG IRPre JTAG DRPre JTAG IRPost and JTAG TotalIRLen JTAG DRPost R Example v JTAG TotalIRLen En Disables auto JTAG detection of J Link Has to be disabled for devices which need some spe cial init for example to add the core to the JTAG JTAG AllowTAPReset chain which is lost at a TAP reset W Allowed values 0 Auto detection is enabled 1 Auto detection is disabled Sets the JTAG interface speed Speed is given in kHz JTAG_Speed Example W JTAG_Speed 2000 2MHz JTAG speed Pulls reset pin low Releases nRST pin Used to issue a reset of the CPU V
393. rademarks of their respec tive holders Contact address SEGGER Microcontroller GmbH amp Co KG In den Weiden 11 D 40721 Hilden Germany Tel 49 2103 2878 0 49 2103 2878 28 Email support segger com Internet http www segger com Revisions This manual describes the J Link and J Trace device For further information on topics or routines not yet specified please contact us Revision Date By Explanation Chapter Related Software 8924 SecHoh J Scope removed Chapter Working with J Link and J Trace V5 02m Rev 0 151125 Section The J Link settings file added Chapter Low Power Debugging added Various Chapters V5 02I Rev 0 1151123 AG Some typos corrected Chapter J Flash SPI 151106 RH Section Send custom commands added Chapter Related Software Section J Link Commander exec command added Chapter Working with J Link and J Trace Section Command strings New commands added V5 02i Rev 0 151105 J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation Chapter Related Software Section J Scope updated Chapter Target interfaces and adapters Section Reference volatge VTref added Chapter Working with J Link and J Trace Section J Link script files updated Chapter Working with J Link and J Trace Secti
394. re ARM ARM Cortex Cortex M Renesas J Link J Trace 7 9 11 AIR RX600 model UOISJ9A JTAG JTAG JTAG JTAG SWD JTAG ia o xe J Link 8 J Link 0 kr J Link so eo 8 QO O nk o 3 Link Pro 9 3 Trace for Cortexml1 O O Q Table 1 17 Built in intelligence of older J Link models J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 65 1 7 Supported IDEs J Link J Trace can be used with different IDEs Some IDEs support J Link directly for other ones additional software such as J Link RDI is necessary in order to use J Link The following tables list which features of J Link J Trace can be used with the different IDEs ARM7 9 Debug Flash Flash Trace IDE A 3 support download breakpoints support IAR EWARM yes yes yes yes Keil MDK yes yes yes no Rowley yes yes no no CodeSourcery yes no no no Yargato GDB yes yes yes no RDI compliant toolchains such as yes yes yes no RVDS ADS ARM Cortex M3 Debug Flash Flash Trace SWO IDE 4 2 support download breakpoints support support IAR EWARM yes yes yes yes yes Keil MDK yes yes yes yes yes Rowley yes yes no no no CodeSourcery yes no no no no Yargato GDB yes yes yes no no ARM11 ARM11 has currently been tested
395. re breakpoints This allows to set an unlimited number of breakpoints if the program is located in RAM by setting and resetting breakpoints according to program code Use flash breakpoints This allows to set an unlimited number of breakpoints if the program is located either in RAM or in flash by setting and resetting breakpoints according to program code An info window can be displayed while flash breakpoints are used showing the cur rent operation Depending on your JTAG speed the info window may hardly to be seen Programming sector 0 128 Bytes addr 0x00000000 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 327 11 4 4 6 CPU tab J Link RDI Configuration 24 x General Init JTAG Flash Breakpoints CPU Log Allows the emulator to simulate individual instructions when single stepping instructions This does not normally have any disadvantages and makes debugging much faster especially when using flash breakpoints Reset strategy J Link supports different reset strategies This is necessary because there is no single way of resetting and halting an amp RM core before it starts to execute instructions Hardware halt after reset normal Delay after reset 0 ms The hardware RESET pin is used to reset the CPU After reset release J Link continuously tries to halt the CPU This typically halts the CPU shortly after reset release the CPU can in most systems
396. readback All sectors using fastest method All sectors using CRC All sectors using read back Programmed sectors using checksum DIN DIU AI WU All sectors using checksum Example SetVerifyDownload 1 Select programmed sectors fastest method 5 12 1 60SetWorkRAM This command can be used to configure the RAM area which will be used by J Link Syntax SetWorkRAM lt StartAddressOfArea gt lt EndAddressOfArea gt Example SetWorkRAM 0x10000000 0x100FFFFF 5 12 1 61ShowControlPanel Executing this command opens the control panel Syntax ShowControlPanel J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 234 CHAPTER 5 Working with J Link and J Trace 5 12 1 62SilentUpdateFW After using this command new firmware will be updated automatically without open ing a message box Syntax SilentUpdateFW 5 12 1 63 SupplyPower This command activates power supply over pin 19 of the JTAG connector The KS Kickstart versions of J Link have the V5 supply over pin 19 activated by default Typical applications This feature is useful for some eval boards that can be powered over the JTAG con nector Syntax SupplyPower 0 1 Example SupplyPower 1 5 12 1 64 SupplyPowerDefault This command activates power supply over pin 19 of the JTAG connector perma nently The KS Kickstart versions of J Link have the V5 supply over pin 19
397. real time microcontroller applications Please enter the target CPU frequency or press lt enter gt to select device for automatic CPU frequency detection CPU gt anna Target CPU is running Receiving SWO data 6000 kHz Data from imulus port s gt Using the syntax given below List of available command line options you can directly start J Link SWO Viewer Cl with parameters ES Command Prompt C Program Files x86 SEGGERULInkARM V478jULinkSWOViewerCL exe device stm32f103zg ba a a C gt C Program Files x86 gt SEGGER JLinkARM_U478 j JLinkSWOUiewerCL exe device stm32f1 3zg SEGGER J Link SWO Viewer Compiled Nov 22 2613 20 09 16 lt c 2812 SEGGER Microcontroller GmbH amp Co KG www segger com Solutions for real time microcontroller applications CPU is running I a Receiving SWO data 6600 Data from stimulus Loops sec Loops sec J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 142 CHAPTER 3 J Link software and documentation package 3 7 1 Usage J Link SWO Viewer is available via the start menu It asks for a device name or CPU clock speed at startup to be able to calculate the correct SWO speed or to connect to a running J Link GDB Server SEGGER J Link SWO Viewer V4 78j Config Please enter the target CPU frequency or select a device for automatic CPU frequency detection Device STM32F1032G Select CPU frequency kHz 7201
398. refer to J Link script files on page 204 Syntax scriptfile lt ScriptFilePath gt Example scriptfile C My Projects Default JLinkScript 3 3 5 21 select Description Specifies the host interface to be used to connect to J Link Currently USB and TCP IP are available Syntax select lt Interface gt lt SerialNo gt lt IPAddr gt Example jlinkgdbserver select usb 580011111 jlinkgdbserver select ip 192 168 1 10 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 131 Additional information For backward compatibility when USB is used as interface serial numbers from 0 3 are accepted as USB 0 3 to support the old method of connecting multiple J Links to a PC This method is no longer recommended to be used Please use the connect via emulator serial number method instead 3 3 5 22 settingsfile Description Select a J Link settings file to be used for the target device The settings fail can con tain all configurable options of the Settings tab in J Link Control panel Syntax SettingsFile lt PathToFile gt Example jlinkgdbserver SettingsFile C Temp GDB Server jlink 3 3 5 23 silent Description Starts the GDB Server in silent mode No log window messages will be shown Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax silent 3 3 5 24 singlerun Description
399. requests to the target while it is in a low power mode Do not try to set breakpoints while the target already is in a low power mode If a breakpoint in a wake up routine shall be hit as soon as the target wakes up from low power mode set this breakpoint before the target enters low power mode Single stepping instructions that enter a low power mode e g WFI WFE on Cor tex M is not possible supported Debugging low power modes that require a reset to wake up can only be debugged on targets where the debug interface is not reset by such a reset Oth erwise breakpoints and other settings are lost which may result in unpredictable behavior J Link does it s best to handle cases where one or more of the above restrictions is not considered but depending on how the IDE reacts to specific operations to fail error messages may appear or the debug session will be terminated by the IDE J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 277 Chapter 10 J Flash SPI This chapter describes J Flash SPI and J Flash SPI CL which are seperate software executables which allows direct programming of SPI flashes without any additional hardware Both J Flash SPI and J Flash SPI CL are part of the J Link software and documentation package which is available free of charge This chapter assumes that you already possess working knowledge of the J Link device J Link J Trace UM08001 2004 2015 SEGGER Microco
400. ring in a message box In addition to that a given value can be a constant value the return value of a function or a variable is added right behind the string Prototype int MessageBoxl const char sMsg int v 5 11 2 3 Report Description Outputs a constant character string on stdio Prototype api int Report const char sMsg 5 11 2 4 Report1 Description Outputs a constant character string on stdio In addition to that a given value can be a constant value the return value of a function or a variable is added right behind the string Prototype api int Reportl const char sMsg int v 5 11 2 5 JTAG SetDeviceld Description Sets the JTAG ID of a specified device in the JTAG chain The index of the device depends on its position in the JTAG chain The device closest to TDO has index 0 The Id is used by the DLL to recognize the device Before calling this function please make sure that the JTAG chain has been config ured correctly by setting the appropriate global DLL variables For more information about the known global DLL variables please refer to Global DLL variables on page 210 Prototype api int JTAG SetDeviceId int DeviceIndex unsigned int Id 5 11 2 6 JTAG GetDeviceld Description Retrieves the JTAG ID of a specified device in the JTAG chain The index of the device depends on its position in the JTAG chain The device closest to TDO has
401. rmation For further information on semihosting and the C libraries see the C and C Libraries chapter in ADS Compilers and Libraries Guide Please see also the Writing Code for ROM chapter in ADS Developer Guide 11 5 2 The SWI interface The ARM and Thumb SWI instructions contain a field that encodes the SWI number used by the application code This number can be decoded by the SWI handler in the system See the chapter on exception handling in ADS Developer Guide for more information on SWI handlers Semihosting operations are requested using a single SWI number This leaves the other SWI numbers available for use by the application or operating system The SWI used for semihosting is 0x123456 in ARM state OxAB in Thumb state The SWI number indicates to the debug agent that the SWI is a semihosting request In order to distinguish between operations the operation type is passed in rO All other parameters are passed in a block that is pointed to by r1 The result is returned in rO either as an explicit return value or as a pointer to a data block Even if no result is returned assume that rO is corrupted J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 330 CHAPTER 11 RDI The available semihosting operation numbers passed in rO are allocated as follows 0x00 to 0x31 These are used by ARM 0x32 to OxFF These are reserved for future use by ARM 0 100 to Ox1FF Reserved for applications 1
402. roller GmbH amp Co KG 294 CHAPTER 10 J Flash SPI 10 6 2 Serial number programming J Flash SPI supports programming of serial numbers In order to use the serial num ber programming feature the J Flash SPI project to be used as well as some files in the working folder depending on the configuration need to be configured first In general J Flash SPI supports two ways of programming a serial number into the target 1 Programming continuous serial numbers Serial number is 1 4 bytes in size Start serial number increment serial number size and address have to be configured in the J Flash SPI project production settings 2 Programming custom serial numbers from a serial number list file Start line of the serial number list file line increment serial number size and address is con figured in J Flash SPI production project settings Serial number list file needs to be specified and created by user 10 6 3 Send custom commands J Flash SPI supports sending custom sequences over SPI which may be different for different SPI flashes e g program OTP program security register etc Due to the generic syntax this feature can be used to implement any required command sequence The sequence has to be specified in the J Flash SPI project file jflash and therefore it can be included in automated production environments without any problems The exit steps are executed right after programming the device using the auto command
403. rsion will be renamed and kept in the same folder allowing manual undo In case of doubt do not replace existing DLL s You can always perform this operation at a later time via start menu 7 The Installation Complete dialog box appears after the copy process Close the installation wizard with the Finish gt button The J Link software and documentation pack is successfully installed on your PC 2 Installation Complete 8 Connect your J Link via USB with your PC The J Link will be identified and after a short period the J Link LED stops rapidly flashing and stays on permanently J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 159 4 2 Setting the USB interface After installing the J Link software and documentation package it should not be nec essary to perform any additional setup sequences in order to configure the USB inter face of J Link 4 2 1 Verifying correct driver installation To verify the correct installation of the driver disconnect and reconnect J Link J Trace to the USB port During the enumeration process which takes about 2 seconds the LED on J Link J Trace is flashing After successful enumeration the LED stays on permanently Start the provided sample application JLink exe which should display the compila tion time of the J Link firmware the serial number a target voltage of 0 000V a complementary error message which says that the supply voltage
404. rt Start STRACE qSeggerSTRACE stop Stop STRACE qSeggerSTRACE read Read STRACE data Table 3 5 General Queries J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 121 3 3 4 1 qSeggerSTRACE config Syntax qSeggerSTRACE config ConfigString Parameter ConfigString String containing the configuration data separating settings by Description Configures STRACE for usage Configuration for example includes specification of the trace port width to be used for tracing 1 bit 2 bit 4 bit default Port Width Var Note For more information please refer to UM08002 J Link SDK user guide chapter STRACE Response lt ReturnValue gt ReturnValue is a 4 Byte signed integer gt 0 lt 0 Error Note ReturnValue is hex encoded Return value 0 is 00000000 return value 1 is FFFFFFFF 3 3 4 2 qSeggerSTRACE start Syntax qSeggerSTRACE start Description Starts capturing of STRACE data Note For more information please refer to UM08002 J Link SDK user guide chapter STRACE Response lt ReturnValue gt ReturnValue is a 4 Byte signed integer gt 0 lt 0 Error Note ReturnValue is hex encoded Return value 0 is 00000000 return value 1 is FFFFFFFF 3 3 4 3 qSeggerSTRACE stop Syntax qSeggerSTRACE stop Description Stops capturing of STRACE data Note For more information please refer to UM08002 J Link SDK user guide cha
405. running However there is one other option DCC Direct communication channel can be used to communicate with the CPU while it is executing the application program All that is required is the application program to call a DCC handler from time to time This DCC handler typically requires less than 1 us per call The DCC handler as well as the optional DCC abort handler is part of the J Link soft ware package and can be found in the Samples DCC IAR directory of the package 5 9 1 What is required e An application program on the host typically a debugger that uses DCC e target application program that regularly calls the DCC handler e The supplied abort handler should be installed optional An application program that uses DCC is JLink exe 5 9 2 Target DCC handler The target DCC handler is a simple C file taking care of the communication The func tion DCC_Process needs to be called regularly from the application program or from an interrupt handler If an RTOS is used a good place to call the DCC handler is from the timer tick interrupt In general the more often the DCC handler is called the faster memory can be accessed On most devices it is also possible to let the DCC generate an interrupt which can be used to call the DCC handler 5 9 3 Target DCC abort handler An optional DCC abort handler a simple assembly file can be included in the appli cation The DCC abort handler allows data aborts caused
406. ry of the device even if it cannot be identified This unlock sequence can be sent to the target by using the unlock command in J Link Commander J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 373 13 11 NXP J Link has been tested with the following NXP devices LPC1111 LPC1113 LPC1311 LPC1313 LPC1342 LPC1343 LPC1751 LPC1751 LPC1752 LPC1754 LPC1756 LPC1758 LPC1764 LPC1765 LPC1766 LPC1768 LPC2101 LPC2102 LPC2103 LPC2104 LPC2105 LPC2106 LPC2109 LPC2114 LPC2119 LPC2124 LPC2129 LPC2131 LPC2132 LPC2134 LPC2136 LPC2138 LPC2141 LPC2142 LPC2144 LPC2146 LPC2148 LPC2194 LPC2212 LPC2214 LPC2292 LPC2294 LPC2364 LPC2366 LPC2368 LPC2378 LPC2468 LPC2478 LPC2880 LPC2888 LPC2917 LPC2919 LPC2927 LPC2929 PCF87750 SJA2010 SJA2510 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 374 CHAPTER 13 Device specifics 13 11 1 LPC ARM7 based devices 13 11 1 1Fast GPIO bug The values of the fast GPIO registers cannot be read directly via JTAG from a debug ger The direct access to the registers corrupts the returned values This means that the values in the fast GPIO registers normally cannot be checked or changed by a debugger Solution Workaround J Link supports command strings which can be used to read a memory area indi rectly Indirect reading means that a small code snippet will be written into RAM of the target device which reads a
407. ry since they rely on the target to be halted after connecting to GDB Server J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 128 CHAPTER 3 J Link software and documentation package Note For the GUI version this setting is persistent for following uses of GDB Server until changed via nohalt or the GUI Syntax halt Example jlinkgdbserver halt 3 3 5 11 noir Description Do not initialize the CPU registers on startup Note For the GUI version this setting is persistent for following uses of GDB Server until changed via ir or the GUI Syntax noir 3 3 5 12 nolocalhostonly Description Starts GDB Server with the option to allow remote connections from outside local host Same as localhostonly 0 Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax nolocalhostonly 3 3 5 13 nologtofile Description Starts the GDB Server with the option to not write the output into a log file Note For the GUI version this setting is persistent for following uses of GDB Server until changed via nologtofile or the GUI Note When this option is used after log no log file will be generated when log is used after this option a log file will be generated and this setting will be overrid den Syntax nologtofile Example jlinkgdbserver nologtofile Will not generate a log file
408. s already establish a connection automatically on this port and show terminal data in a specific window in the IDE For IDEs which do not support semihosting terminal output directly the easiest way to view semihosting output is to open a telnet connection to the GDBServer on port 2333 The connection on this port can be opened all the time as soon as GDBServer is started even before this remote command is executed Example gt monitor semihosting enable lt Semihosting enabled VectorAddr 0x08 3 3 3 20 semihosting lOClient Syntax semihosting IOClient lt ClientMask gt Description GDB itself can handle file I O operations too With this command it is selected wheter to print output via TELNET port 2333 GDB or both lt ClientMask gt is e 1for TELNET Client Standard port 2333 Default e 2 for GDB Client e or 3 for both Input via GDB Client Example Select TELNET port as output source gt monitor semihosting ioclient 1 lt Semihosting I O set to TELNET Client Select GDB as output source gt monitor semihosting ioclient 2 lt Semihosting I O set to GDB Client Select TELNET port and GDB as output source gt monitor semihosting ioclient 3 lt Semihosting I O set to TELNET and GDB Client 3 3 3 21 semihosting ARMSWI Syntax semihosting ARMSWI lt Value gt J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp
409. s RESET ST bit in the DHCSR to first become high reset active and then low reset no longer active afterwards 4 Clear CORERESET This type of reset may fail if e J Link has no connection to the debug interface of the CPU because it is in a low power mode e The debug interface is disabled after reset and needs to be enabled by a device internal bootloader This would cause J Link to lose communication after reset since the CPU is halted before it can execute the internal bootlader 5 8 2 10 Type 9 Reset for LPC1200 devices On the NXP LPC1200 devices the watchdog is enabled after reset and not disabled by the bootloader if a valid application is in the flash memory Moreover the watchdog keeps counting if the CPU is in debug mode When using this reset strategy J Link performs a reset of the CPU and peripherals using the SYSRESETREQ bit in the ATRCR and halts the CPU after the bootloader has been performed and before the first J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 201 instruction of the user code is executed Then the watchdog of the LPC1200 device is disabled This reset strategy is only guaranteed to work on modern J Links J Link V8 J Link Pro J link ULTRA J Trace for Cortex M J Link Lite and if a SWD speed of min 1 MHz is used This reset strategy should also work for J Links with hardware version 6 but it can not
410. s RX63N Renesas RX63T 9 9 0606 06 6 6 6 6 6 6 06 O 9 9 9 GG 99 9 6 6 Q Table 1 6 J Link ULTRA hardware versions J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 46 CHAPTER 1 Introduction 1 3 5 J Link PRO 1 3 5 1 Additional features J Link PRO is a JTAG emulator designed for ARM cores It is fully compatible to J Link and connects via Ethernet USB to a PC running Microsoft Windows 2000 or later Linux or Mac OS X For a complete list of all operating systems which are sup ported please refer to Supported OS on page 25 J Link PRO comes with licenses for all J Link related SEGGER software e Fully compatible to J Link e More memory for future firmware extensions ARM11 X Scale Cortex R4 and Cortex A8 e Additional LEDs for power and RESET indication Comes with web interface for easy TCP IP configuration built in web server Serial Wire Debug supported Serial Wire Viewer supported Download speed up to 3 MByte second Comes with built in licenses for Unlimited number of breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming software e Embedded Trace Buffer ETB support e Galvanic isolation from host via Ethernet 1 3 5 2 Hardware versions Version 1 1 Compatible to J Link e Provides an additional Ethernet interface which allows to communicate with J Link via TCP IP Vers
411. s designed to work with it Some debuggers are usually shipped with the J Link DLL already installed Anyhow it may make sense to replace the included DLL with the latest one available to take advan tage of improvements in the newer version 4 7 2 1 Updating the J Link DLL in the IAR Embedded Workbench for ARM EWARM It is recommended to use the J Link DLL updater to update the J Link DLL in the IAR Embedded Workbench The IAR Embedded Workbench IDE is a high performance integrated development environment with an editor compiler linker debugger The compiler generates very efficient code and is widely used It comes with the J LinkARM d11 in the arm bin subdirectory of the installation directory To update this DLL you should backup your original DLL and then replace it with the new one Typically the DLL is located in C Program Files IAR SystemsV Embedded Work bench 6 n arm bin After updating the DLL it is recommended to verify that the new DLL is loaded as described in Determining which DLL is used by a program on page 170 J Link DLL updater The J Link DLL updater is a tool which comes with the J Link software and allows the user to update the JLinkARM d11 in all installations of the IAR Embedded Work bench in a simple way The updater is automatically started after the installation of a J Link software version and asks for updating old DLLs used by IAR The J Link DLL updater can also be started manually Simply enable t
412. s of the channel blocking or non blocking Table 12 2 SEGGER_RTT_ConfigDownBuffer parameter list Return value gt 0 lt 0 Error Example Configure down channel 1 SEGGER RTT ConfigDownChannel 1 DataIn amp abDataIn 0 sizeof abDataIn SEGGER RTT MODE NO BLOCK Additional information Once a channel is configured only the flags of the channel should be changed J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 345 12 4 1 2 SEGGER_RTT_ConfigUpBuffer Description Configure or add an up buffer by specifying its name size and flags Prototype int SEGGER_RTT_ConfigUpBuffer unsigned BufferIndex const char sName char pBuffer int BufferSize int Flags Parameters Parameter Meaning Index of the buffer to configure Must be lower than SEGGER_RTT_MAX_NUM_UP_CHANNELS Pointer to a O terminated string to be displayed as the name of the BufferIndex sName channel pBuffer Pointer to a buffer used by the channel BufferSize Size of the buffer in Bytes Flags Flags of the channel blocking or non blocking Table 12 3 RTT ConfigUpBuffer parameter list Return value gt 0 O K lt 0 Example Configure up channel 1 to work in blocking mode SEGGER RTT ConfigUpChannel 1 DataOut amp abDataOut 0 sizeof abDataOut SEGGER R
413. s used to give the user some information about the emulator to target connection 5 2 3 1 Bi color output indicator Indicator status Meaning OFF Target power supply via Pin 19 is not active GREEN Target power supply via Pin 19 is active Target power supply via Pin 19 is active Emulator pulls ORANGE RESET low active RED Emulator pulls RESET low active Table 5 4 J Link bi color output indicator J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 178 CHAPTER 5 Working with J Link and J Trace 5 3 JTAG interface By default only one device is assumed to be in the JTAG scan chain If you have mul tiple devices in the scan chain you must properly configure it To do so you have to specify the exact position of the CPU that should be addressed Configuration of the scan is done by the target application A target application can be a debugger such as the IAR C SPY debugger ARM s AXD using RDI a flash programming application such as SEGGER s J Flash or any other application using J Link J Trace It is the applica tion s responsibility to supply a way to configure the scan chain Most applications offer a dialog box for this purpose 5 3 1 Multiple devices in the scan chain J Link J Trace can handle multiple devices in the scan chain This applies to hard ware where multiple chips are connected to the same JTAG connector As can be seen in the following figure
414. s using Text Control Codes ANSI escape codes to configure the display of text RTT Viewer supports changing the text color and background color and can erase the Terminal These Control Codes are pre defined in the RTT application and can easily be used in the application Example 1 SEGGER RTT WriteString 0 RTT CTRL RESET Red RTT TEXT BRIGHT RED This text is red RTT CTRL TEXT BLACK nn RTT BG BRIGHT RED This background is red RTT CTRL RESET Normal text again Example 2 SEGGER RTT printf 0 sTime s s 7d n RTT CTRL RESET RTT CTRL BG BRIGHT RED RTT CTRL TEXT BRIGHT WHITE 1111111 Clear the terminal The first line will not be shown after this command SEGGER_RTT_WriteString 0 RTT_CTRL_CLEAR SEGGER RTT printf 0 sTime s s 7d n RTT RESET RTT CTRL BG BRIGHT RED RTT CTRL TEXT BRIGHT WHITE 2222222 y J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 343 12 3 2 RTT Client J Link RTT Client acts as a Telnet client but automatically tries to reconnect to a J Link connection when a debug session is closed The J Link RTT Client is part of the J Link Software and Documentation Pack for Win dows Linux and OS X and can be used for simple RTT
415. scan chain For a single device in chain header and trailer data on DR and IR are 0 Set TAP to IDLE state STATE IDLE Configure end state of DR and IR after scan operations ENDDR IDLE ENDIR IDLE Start of test 32 bit scan on DR In 32 0 bits Expected out Device ID 0x0BA00477 SDR 32 TDI 0 TDO 0BA00477 MASK OFFFFFFF Set TAP to IDLE state STATE IDLE End of test SVD files allow even more complex tasks basically everything which is possible via JTAG and the devices in the scan chain like configuring an FPGA or loading data into memory J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 149 3 10 J Link RDI Remote Debug Interface The J Link RDI software is a remote debug interface for J Link It makes it possible to use J Link with any RDI compliant debugger The main part of the software is an RDI compliant DLL which needs to be selected in the debugger There are two additional features available which build on the RDI software foundation Each additional fea ture requires an RDI license in addition to its own license Evaluation licenses are available free of charge For further information go to our website or contact us directly Note The RDI software as well as flash breakpoints and flash downloads do not require a license if the target device is an LPC2xxx In this case the software ver ifies that the t
416. scription Reads or writes from to given register If lt value gt is specified this command writes the value into the given register If lt address gt is specified this command writes the memory content at address lt address gt to register lt RegName gt Otherwise this com mand reads the given register J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 114 Example gt monitor reg pc lt Writing register gt monitor reg 0 lt Writing register gt monitor reg PC lt Reading register 3 3 3 16 regs Syntax regs Description Read register value P R P CHAPTER 3 J Link software and documentation package Write value to register 0x00100230 C 0x00100230 0x00000040 0 0x14813004 C 0x00100230 Reads all CPU registers Example gt monitor regs lt PC 00100230 CPSR RO 14813004 R1 R4 00000000 R5 USR R8 00000000 R13 00000000 R8 00000000 R13 00200000 SVC R13 002004E8 ABT R13 00200100 IRQ 13 00200100 UND R13 00200100 3 3 3 17 reset Syntax reset Description 20000013 S 00000001 R2 00000000 R6 R9 00000000 R14 00000000 R9 00000000 R14 00000000 R14 0010025C R14 00000000 R14 00000000 R14 00000000 Write value from address to register VC mode ARM 00000001 R3 000003B5 00000000 R7 00000000 10 00000000 R11 00000000 R12 00000000 R10 0000
417. ses a J Link scriptfile select Selects the interface to connect to J Link USB IP settingsfile Selects the J Link Settings File strict Starts GDB Server in strict mode Executes gdb file first connection xc Executes a gdb file on every connection cpu Selects the CPU core Deprecated use device instead Table 3 9 General command line options J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 125 3 3 5 1 cpu Description Pre select the CPU core of the connected device so the GDB Server already knows the register set even before having established a connection to the CPU Note Deprecated please use device instead Anyhow it does not hurt if this option is set too Syntax CPU lt CPUCore gt Example jlinkgdbserver CPU ARM7 9 Add information The following table lists all valid values for cPUCore lt CPUCore gt Supported CPU cores CPU_FAMILY_ARM7_9 Pre select ARM7 and ARMO as CPU cores CPU_FAMILY_CORTEX_A_R Pre select Cortex A and Cortex R as CPU cores CPU_FAMILY_CORTEX_M Pre select Cortex M as CPU core CPU FAMILY RX600 Pre select Renesas RX600 as CPU core Table 3 10 GDB allowed values for CPUCore 3 3 5 2 device Description Tells GDBServer to which device J Link is connected before the connect sequence is actually performed It is recommended to use the command line op
418. settings file of the IDE The recommended extension for project files is jlink Assuming the Project is saved under C Work Work and the project contains to tar gets name Debug and Release the debug version could set the file name C Work Work Debug jlink J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 227 The release version could use C Work Work Release jlink Note Spaces in the filename are permitted Syntax ProjectFile lt FullFileName gt Example ProjectFile C Work Release jlink 5 12 1 34ScriptFile This command is used to set the path to a J Link script file which shall be executed J Link scriptfiles are mainly used to connect to targets which need a special connec tion sequence before communication with the core is possible Syntax ScriptFile lt FullFileName gt Example ScriptFile C Work Default JLinkScript 5 12 1 35SelectTraceSource This command selects the trace source which shall be used for tracing Syntax SelectTraceSource lt SourceNumber gt Trace source number Description 0 ETB 1 ETM Example SelectTraceSource 0 Select ETB 5 12 1 36SetAllowFlashCache This command is used to enable disable caching of flash contents Enabled by default Syntax SetAllowFlashCache 0 1 Example SetAllowFlashCache 1 Enables flash cache 5 12 1 37 SetAllowSimulation This command can be used to enabl
419. shown J Link x x Warning 1 6 1 Intelligence in the J Link firmware On newer J Links the intelligence for a new CPU core is also available in the J Link firmware which means that for these J Links the target sequences are no longer generated on the PC side but directly inside the J Link Having the intelligence in the firmware leads to improved stability and higher performance 1 6 2 Intelligence on the PC side DLL This is the basic implementation level for support of a CPU core This implementation is not J Link model dependent since no intelligence for the CPU core is necessary in the J Link firmware This means all target sequences JTAG SWD are generated on the PC side and the J Link simply sends out these sequences and sends the result back to the DLL Using this way of implementation also allows old J Links to be used with new CPU cores as long as a DLL Version is used which has intelligence for the CPU But there is one big disadvantage of implementing the CPU core support on the DLL side For every sequence which shall be sent to the target a USB or Ethernet transac tion is triggered The long latency especially on a USB connection significantly affects the performance of J Link This is true especially when performing actions where J Link has to wait for the CPU frequently An example is a memory read write operation which needs to be followed by status read operations or repeated until the memory operation is co
420. single pin output signal from the core The Instrumentation Trace Macrocell ITM and Serial Wire Output SWO can be used to form a Serial Wire Viewer SWV The Serial Wire Viewer provides a low cost method of obtaining information from inside the MCU Usually it should not be necessary to configure the SWO speed because this is usually done by the debugger 5 4 2 1 Max SWO speeds The supported SWO speeds depend on the connected emulator They can be retrieved from the emulator To get the supported SWO speeds for your emulator use J Link Commander J Link si 1 Select target interface SWD J Link SWOSpeed Currently following speeds are supported Emulator Speed formula Resulting max speed J Link V9 60MHz n n gt 8 7 5 MHz J Link Pro ULTRA V4 3 2GHz n n gt 64 50 MHz Table 5 6 J Link supported SWO input speeds 5 4 2 2 Configuring SWO speeds The max SWO speed in practice is the max speed which both target and J Link can handle J Link can handle the frequencies described in SWO on page 183 whereas the max deviation between the target and the J Link speed is about 3 The computation of possible SWO speeds is typically done in the debugger The SWO output speed of the CPU is determined by TRACECLKIN which is normally the same as the CPU clock Example Target CPU running at 72 MHz n is be between 1 and 8192 Possible SWO output speeds are 72MHz 36MHz 24MHz J Link V9 S
421. ssible 2 Some peripherals are also stopped when the CPU enters debug mode For exam ple Pulse width modulation PWM units for motor control applications may be halted while in an undefined or even dangerous state resulting in unwanted side effects on the external hardware connected to these units This is where monitor mode debugging becomes effective In monitor debug mode the CPU is not halted but takes a specific debug exception and jumps into a defined exception handler that executes usually in a loop a debug monitor software that performs communication with J Link in order to read write CPU registers and so on The main effect is the same as for halting mode the user application is interrupted at a specific point but in contrast to halting mode the fact that the CPU executes a handler also allows it to perform some specific operations on debug entry exit or even periodically during debug mode with almost no delay This enables the handling of such complex debug cases as those explained above J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 267 8 2 Enable monitor debugging As explained before by default J Link uses halt mode debugging In order to enable monitor mode debugging the J Link software needs to be explicitly told to use moni tor mode debugging This is done slightly differently from IDE to IDE In general the IDE does not notice any difference between halting and monitor debug mo
422. standardize a debugger debug probe interface It is defined only for cores that have the same CPU register set as ARM7 CPUs This chapter describes how to use the RDI DLL which comes with the J Link software and documentation package The J Link RDI DLL allows the user to use J Link with any RDI compliant debugger and IDE J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 302 CHAPTER 11 RDI 11 1 Introduction Remote Debug Interface RDI is an Application Programming Interface API that defines a standard set of data structures and functions that abstract hardware for debugging purposes J Link RDI mainly consists of a DLL designed for ARM cores to be used with any RDI compliant debugger The J Link DLL feature flash download and flash breakpoints can also be used with J Link RDI RDI compliant ad Debugger J Link RDI DLL 11 1 1 Features Can be used with every RDI compliant debugger Easy to use Flash download feature of J Link DLL can be used Flash breakpoints feature of J Link DLL can be used Instruction set simulation improves debugging performance J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 303 11 2 Licensing In order to use the J Link RDI software a separate license is necessary for each J Link For some devices J Link comes with a device based license and some J Link models also come with a full license for J Link RDI
423. stom settings to configure J Link RDI with advanced commands for special chips or operations For example a macro file can be used to initialize a target to use the PLL before the target application is downloaded in order to speed up the download J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG Comands in the macro file 323 Command Description SetJTAGSpeed Sets the JTAG speed x speed in kHz 0 Auto Waits a given time Perey poen x delay in milliseconds Resets the target x delay in milliseconds Go Starts the ARM core Halt Halts the ARM core Read8 Addr Read16 Addr Read32 Addr Reads a 8 16 32 bit value Addr address to read as hex value Verify8 Addr Data Verifies a 8 16 32 bit value Verifyl16 Addr Data Addr address to verify as hex value Verify32 Addr Data Data data to verify as hex value Write8 Addr Data Writes a 8 16 32 bit value Writel6 Addr Data Addr address to write as hex value Write32 Addr Data Data data to write as hex value WriteVerify8 Addr Data Writes and verifies a 8 16 32 bit value WriteVerifyl16 Addr Data Addr address to write as hex value WriteVerify32 Addr Data Data data to write as hex value WriteRegister Reg Data Writes a register WriteJTAG IR Cmd Writes th
424. string to sFormat Pointer to format string followed by arguments for conversion Table 12 4 SEGGER_RTT_printf parameter list Return value gt 0 Number of bytes which have been sent lt 0 Error Example SEGGER RTT printf 0 SEGGER RTT Sample Uptime 10dms OS Time 890912 Formatted output on channel 0 SEGGER RTT Sample Uptime 890912ms Additional information 1 Conversion specifications have following syntax flags FieldWidth Precision ConversionSpecifier J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 347 2 Supported flags e Left justify within the field width e Always print sign extension for signed conversions e 0 Pad with O instead of spaces Ignored when using flag or precision 3 Supported conversion specifiers Print the argument as one char Print the argument as a signed integer Print the argument as an unsigned integer Print the argument as an hexadecimal integer Print the string pointed to by the argument Print the argument as an 8 digit hexadecimal integer Argument shall be a ointer to void 12 4 1 7 SEGGER_RTT_Read TON xXKXC AO Description Read characters from any RTT down channel which have been previously stored by the host Prototype int SEGGER RTT Read unsigned BufferIndex char pBuffer unsigned BufferSize Parameters Para
425. sts from application code to a host computer running a debugger This mechanism is used to allow functions in the C library such as printf and scanf to use the screen and keyboard of the host rather than having a screen and keyboard on the target system This is useful because development hardware often does not have all the input and output facilities of the final system Semihosting allows the host computer to provide these facilities Semihosting is also used for Disk I O and flash programming a flash loader uses semihosting to load the target program from disk Semihosting is implemented by a set of defined software interrupt SWI operations The application invokes the appropriate SWI and the debug agent then handles the SWI exception The debug agent provides the required communication with the host In many cases the semihosting SWI will be invoked by code within library functions Usage of semihosting The application can also invoke the semihosting SWI directly Refer to the C library descriptions in the ADS Compilers and Libraries Guide for more information on sup port for semihosting in the ARM C library Semihosting is not used by all tool chains most modern tool chains such as IAR use different mechanisms to achive the same goal Semihosting is used primarily by ARM s tool chain and debuggers such as AXD Since semihosting has been used primarily by ARM documents published by ARM are the best source of add info
426. sys tems which are supported please refer to Supported OS on page 19 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 20 C 65 C Relative humidity non condensing Max 90 rH Size without cables 123mm x 68mm x 30mm Weight without cables 120g Mechanical USB interface USB 2 0 Hi Speed Target interface JTAG SWD 20 pin 14 pin adapter available JTAG SWD Trace 19 pin JTAG SWD Interface Electrical Power supply USB powered Max 50mA Target Supply current Target interface voltage Vie 1 2V 5V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300 LOW level input voltage Max 40 of Vir HIGH level input voltage Vy Min 60 of VIF JTAG SWD Interface Timing Data input rise time Max 20ns Data input fall time Tfai Max 20ns Data output rise time Trgo Max 10ns Data output fall time Max 10ns Table 1 12 J Trace for Cortex M3 specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 55 Clock rise time Max 3ns Clock fall time Max 3ns Trace Interface Electrical USB powered Power supply Max 50mA Target Supply current Tar
427. t 318 u32 tmppriority 0 00 tmpreg 0x00 tnpmask 0 005 B 9 u32 tmppre 6 tmpsub eripheral according to the specified Def structure n for the 08000842 4770 Dma2_Channe 1_IRQHand er A2_Channel1_IRQHandler ext 67 08000844 4770 Bx DMA2 Channe12 IRQHandler DMA2 Channe12 IRQHander text 68 08000846 4770 Dmaz2_channe13_IRQHandier A2_Channe13_IRQHandier text 69 08000848 4770 MA2 Channel4 5 IRQHandler DMA2 Channel 4 s IRQHandler text 70 0800084 4770 LR oid NVIC priori tvsroupconfiofu32 NVIC Prioritysroup R4 RO P R4 0x700 NVIC PriorityGroupconfig o R4 0X600 NVIC PriorityGroupconfig 0 R4 0x500 08000860 EQ 2 NVIC PriorityGroupconfig o 08000862 5 46 80 R4 0x400 08000866 0002 NVIC PriorityGroupconfig o 08000868 R4 0 300 2eNVIC_Pri ori tyGroupconfi g_1 NVIC PriorityGroupconfig 2 N 5 46 0008 F5B46FC0 0008 08000850 08000854 08000856 0800085 0800085 FSB46FAO 0005 0X5C 08000876 F7FEFCAB BL assert failed SCB gt AIRCR AIRCR VECTKEY MASK NVIC Priori tyGroup NVIC Prierityaroupconfig 2 0800087 F8DF0058 LDR W 0800087 6800 LOR RO Ro RO PC 0 58 9 of 002368 002403 002407 002442 002446 002481 002485 002520 002524 002559 002563 002598 002602 002637 002641 002676 002680 002715 002719 002754 002758 002793 002797 0028
428. t 5V LOW level input voltage Vi Max 40 of Vir HIGH level input voltage Min 60 of Vir For 1 8V lt Vip lt 3 6V LOW level output voltage with a load of 10 kOhm HIGH level output voltage Voy with a load of 10 kOhm Max 10 of Vir Min 90 of VIF For 3 6 lt Vir lt 5 LOW level output voltage with a 20 of Vir load of 10 kOhm HIGH level output voltage with a Min 80 of load of 10 SWD Interface Electrical USB powered Power supply Max 50mA Target Supply current 1 2V 5V SWD interface is 5V tolerant Target interface voltage Vir but can output a maximum of 3 3V SWD signals Target supply voltage 4 5V 5V if powered with 5V on USB Table 1 15 Flasher ARM specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 58 CHAPTER 1 Introduction Target supply current Max 300mA LOW level input voltage Max 0 8V HIGH level input voltage Min 2 0V LOW level output voltage with a load of 10 kOhm Max 0 5V HIGH level output voltage Voy with a load of 10 kOhm Min 2 85V Table 1 15 Flasher ARM specifications J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 1 4 59 Common features of the J Link product family USB 2 0 interface Full Speed Hi Speed dep
429. t depends on the content of the smart option bytes at addr OxCO The watchdog keeps counting even if the CPU is in debug mode e g halted So please do not use the watchdog when debug ging to avoid unexpected behavior of the target application A special reset strategy has been implemented for this device which disables the watchdog right after a reset has been performed We recommend to use this reset strategy when debugging a Samsung S3FN60D device J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 13 15 Silicon Labs 379 J Link has been tested with the following Silicon Labs devices 13 15 1 EFM32 series devices EFM32G200F16 EFM32G200F32 EFM32G200F64 EFM32G210F128 EFM32G230F32 EFM32G230F64 EFM32G230F128 EFM32G280F32 EFM32G280F64 EFM32G280F128 EFM32G290F32 EFM32G290F64 EFM32G290F128 EFM32G840F32 EFM32G840F64 EFM32G840F128 EFM32G880F32 EFM32G880F64 EFM32G880F128 EFM32G890F32 EFM32G890F64 EFM32G890F128 EFM32TG108F4 EFM32TG108F8 EFM32TG108F16 EFM32TG108F32 EFM32TG110F4 EFM32TG110F8 EFM32TG110F16 EFM32TG110F32 EFM32TG210F8 EFM32TG210F16 EFM32TG210F32 EFM32TG230F8 EFM32TG230F16 EFM32TG230F32 EFM32TG840F8 EFM32TG840F16 EFM32TG840F32 EM351 EM357 13 15 1 1SWO Usually the SWO output frequency of a device is directly dependent on the CPU speed The SWO speed is calculated as lt CPUFreq gt n On the EFM32 series this is not the case The SWO related units ITM TPIU
430. t and the target s core ID The screenshot below shows the output of JLink exe As can be seen it reports a J Link with one JTAG device connected C Program Files SEGGER JLinkARM_ 386 JLink exe SEGGER J Link Commander 03 86 for help gt Compiled Jun 27 2008 19 42 43 ersion 03 86 compiled Jun 27 2008 19 42 28 J Link ARM 06 compiled Jun 27 2008 18 35 51 00 IRPrint x 1 Total IRLen 4 ce 89 Found ARM with core Id x3F F F F lt ARM gt J Link 5 1 3 Problems If you experience problems with any of the steps described above read the chapter Support and FAQs on page 425 for troubleshooting tips If you still do not find appro priate help there and your J Link J Trace is an original SEGGER product you can contact SEGGER support via e mail Provide the necessary information about your target processor board etc and we will try to solve your problem A checklist of the required information together with the contact information can be found in chapter Support and FAQs on page 425 as well J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 175 5 2 Indicators J Link uses indicators LEDs to give the user some information about the current status of the connected J Link All J Links feature the main indicator Some newer J Links such as the J Link Pro Ultra come with additional input output Indicators In the following the meaning of
431. t be wired to save one more pin place on the target hardware interface connector e g in production environments SEGGER offers a special adapter called J Link Supply Adapter which can be used for such pur poses Further information regarding this can be found on the SEGGER website https www segger com jlink adapters supply html To gurantee proper debug functionality please make sure to connect at least on of the GND pins to GND Pin 4 6 8 10 12 14 16 18 20 Note On later J Link products like the J Link ULTRA these pins are reserved for firmware extension purposes They can be left open or connected to GND in nor mal debug environment They are not essential for JTAG SWD in general J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 406 CHAPTER 14 Target interfaces and adapters 14 6 Adapters There are various adapters available for J Link as for example the JTAG isolator the J Link RX adapter or the J Link Cortex M adapter For more information about the different adapters please refer to http www segger com jlink adapters html J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 407 Chapter 15 Background information This chapter provides background information about JTAG and ARM The ARM7 and ARM9 architecture is based on Reduced Instruction Set Computer RISC principles The instruction set and the related decode mechanism are greatl
432. t if your unit may be legally used with SEGGER J Link software please get in touch with us End users may be liable for illegal use of J Link software with clones J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 81 Chapter 3 J Link software and documenta tion package This chapter describes the contents of the J Link software and documentation pack age which can be downloaded from www segger com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG CHAPTER 3 J Link software and documentation package Software overview The J Link software and documentation package which is available for download from http www segger com jlink software html includes some applications to be used with J Link It also comes with USB drivers for J Link and documentations in pdf format Software Description JLink Commander Command line tool with basic functionality for target analysis J Link GDB Server The J Link GDB Server is a server connecting to the GNU Debugger GDB via TCP IP It is required for toolchains using the GDB protocol to connect to J Link J Link GDB Server command line ver sion Command line version of the J Link GDB Server Same func tionality as the GUI version J Link Remote Server Utility which provides the possibility to use J Link J Trace remotely via TCP IP J Mem Memory Viewer Target memory viewer Shows
433. t set as 0 is an invalid state and would cause several problems during debugging especially on devices where the erased state of the flash is 0 00 and therefore on empty devices the T bit in the XPSR would be Anyhow if for some reason explicit disable of this auto correction is necessary this can be achieved via the following command string Syntax DisableCortexMXPSRAutoCorrectTBit 5 12 1 7 DisableFlashBPs This command disables the FlashBP feature Syntax DisableFlashBPs 5 12 1 8 DisableFlashDL This command disables the J Link FlashDL feature Syntax DisableFlashDL 5 12 1 9 DisablelnfoWinFlashBPs This command is used to disable the flash download window for the flash breakpoint feature Enabled by default Syntax DisableInfoWinFlashBPs 5 12 1 10DisablelnfoWinFlashDL This command is used to disable the flash download information window for the flash download feature Enabled by default Syntax DisableInfoWinFlashDL J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 222 CHAPTER 5 Working with J Link and J Trace 5 12 1 11DisableMOEHandling The J Link DLL outputs additional information about mode of entry MOE in case the target CPU halted entered debug mode Disabled by default Syntax DisableMOEHandling 5 12 1 12DisablePowerSupplyOnClose This command is used to ensure that the power supply for the target will be disabled on close
434. t the time of writing a free utility which can be downloaded from www sysinternals com J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 171 4 8 Getting started with J Link and ARM DS 5 J Link supports ARM DS 5 Development via the RDDI protocol For commercially using J Link via RDDI in ARM DS 5 an RDI RDDI license is required J Link models which come with an RDI license can also be used via RDDI RDDI can be evaluated free of charge In order to use J Link in ARM DS 5 Development Studio the RDDI DLL in DS 5 needs to be replaced by the SEGGER version of this DLL The SEGGER version of the RDDI still allows using ARM s DSTREAM in DS 5 After installing the J Link software and documentation package the J Link DLL Updater is started which allows easily updat ing the RDDI DLL in DS 5 An backup of the original DLL is made automatically 4 8 1 Replacing the RDDI DLL manually If J Link DLL Updater is unable to find a DS 5 installation and does not list it for updating the RDDI DLL can always be replaced manually For more information about how to manually update the RDDI DLL please refer to SJLINK INST DIRS NMRDDIMManuallInstallation txt 4 8 2 Using J Link in DS 5 Development Studio Please follow the following steps in order to use J Link in DS 5 after replacing the RDDI DLL accordingly Connect J Link and target Open ARM DS 5 Open DS 5 Project for target Open Debug Configurations
435. target memory Syntax readrange SADDR EADDR exit Terminates application automatically help Displays this box Displays this box jflashlog Set a temporary J Flash log file Syntac jflashlog FILENAME jlinklog Set a temporary J Link log file Syntax jlinklog FILENAME usb Overrides connection settings to USB S N Syntac usb lt SN gt ip Overrides connection settings to IP Syntax ip lt 200 200 20020K gt or ip lt HostName gt 10 5 2 Command line options This section lists and describes all available command line options Some options accept additional parameters which are enclosed in angle brackets e g lt FILE NAME gt If these parameters are optional they are enclosed in square brackets too e g lt SADDR gt Neither the angel nor the square brackets must be typed on the command line they are used here only to denote optional parameters Also note that a parameter must follow immediately after the option e g JFlashSPI exe openprjC Projects Default jflash J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 290 CHAPTER 10 J Flash SPI The command line options are evaluated in the order they are passed to J Flash so please ensure that a project and data file has already been opened when evaluating a command line option which requires this It is recommended to always use open lt FILENAME gt lt SADDR gt to make sure the right data fil
436. ted and explained 5 11 1 1 ResetTarget Description If present it replaces the reset strategy performed by the DLL when issuing a reset Prototype void ResetTarget void 5 11 1 2 InitEMU Description If present it allows configuration of the emulator prior to starting target communica tion Currently this function is only used to configure whether the target which is connected to J Link has an ETB or not For more information on how to configure the existence of an ETB please refer to Global DLL variables on page 210 Prototype void InitEMU void 5 11 1 3 InitTarget Description If present it can replace the auto detection capability of J Link Some targets can not be auto detected by J Link since some special target initialization is necessary before communication with the core is possible Moreover J Link uses a TAP reset to get the JTAG IDs of the devices in the JTAG chain On some targets this disables access to the core Prototype void InitTarget void 5 11 2 Script file API functions In the following the API functions which can be used in a script file to communicate with the DLL are explained J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 205 5 11 2 1 MessageBox Description Outputs a string in a message box Prototype api_ int MessageBox const char sMsg 5 11 2 2 MessageBox1 Description Outputs a constant character st
437. tegy is typically used if nRESET and nTRST are coupled If nRESET and nTRST are coupled either on the board or the CPU itself reset clears the breakpoint which means that the CPU can not be stopped after reset with the BP O reset strat egy 5 8 1 2 Type 1 Hardware halt with BP 0 The hardware reset pin is used to reset the CPU Before doing so the ICE breaker is programmed to halt program execution at address 0 effectively a breakpoint is set at address O If this strategy works the CPU is actually halted before executing a sin gle instruction This reset strategy does not work on all systems for two reasons e If nRESET and nTRST are coupled either on the board or the CPU itself reset clears the breakpoint which means the CPU is not stopped after reset e Some MCUs contain a bootloader program sometimes called kernel which needs to be executed to enable JTAG access 5 8 1 3 Type 2 Software for Analog Devices ADuC7xxx MCUs This reset strategy is a software strategy The CPU is halted and performs a sequence which causes a peripheral reset The following sequence is executed The CPU is halted A software reset sequence is downloaded to RAM A breakpoint at address 0 is set The software reset sequence is executed This sequence performs a reset of CPU and peripherals and halts the CPU before exe cuting instructions of the user program It is the recommended reset sequence for Analog Devices ADuC7xxx MCUs and works w
438. the Options drop down menu Disconnect Disconnects a current connection that has been made through the J Link Test gt Two test functions are implemented Generates test data generates data which can be used to test if the flash can be programmed correctly The size of the gen erated data file can be defined Tests up download speed writes data of an specified size to a defined address reads the written data back and measures the up and download speed Erase sectors Erases all selected flash sectors Erase chip Erases the entire chip Program Programs the chip using the currently active data file Program amp Verify Programs the chip using the currently active data file and then verifies that it was written successfully Auto The Auto command performs a sequence of steps It con nects to the device erases sectors and programs the chip using the currently active data file before the written data is finally verified The range of sectors to be erased can be configured through the Flash tab of the Project settings dialog and through the Global settings dialog Verify Verifies the data found on the chip with the data file Read back gt Reads back the data found on the chip and creates a new data file to store this information There are three ways in which the data can be read back The Selected sectors identified on the Flash tab of the Project Settings foun
439. the J Link software and documenta tion package CPU Vind Set write enable ExitStep0_ Action Activate CS J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG ExitStepO ValueO ExitStep0_Valuel ExitStepl_ Action ExitStepl_Comment ExitStepl_Value0 ExitStep1 Valuel 1 ExitStep2 Action ExitStep2 Comment ExitStep2 1 0 ExitStep2_Valuel Erase sector 0 bef ExitStep3_Action ExitStep3_Comment ExitStep3 1 0 ExitStep3 Valuel ExitStep4 Action ExitStep4 Comment ExitStep4 Value0 ExitStep4_Valuel 4 ExitStep5 Action ExitStep5 Comment ExitStep5 ValueO ExitStep5_Valuel Wait until secto ht ExitStep6_Action ExitStep6_Comment ExitStep6 1 0 ExitStep6_Valuel NumExitSteps 7 J Link J Trace UM08001 0x00000000 0x00000000 Write data Set write enable 1 0x06 Deactivate CS Deactivate CS 0x00000000 0x00000000 Activate CS Activate CS 0x00000000 0x00000000 Write data Set write enable 4 0xD8 0x00 0x00 0x00 Deactivate CS Deactivate CS 0x00000000 0x00000000 r has been erased Delay Wait until sector has been erased 0x00000080 0x00000000 295 2004 2015 SEGGER Microcontroller GmbH amp Co KG 296 CHAPTER 10 J Flash SPI 10 7 Device specifics This chapter gives some additional information about specific devices 1
440. the analysis are stored in a file ating a problem gt Usage SWOAnalyzer exe SWOfile This can be achieved by simply dragging the SWO output file created by the J Link DLL onto the executable Creating an SWO output file In order to create the SWO output file which is th input file for the SWO Analyzer the J Link config file needs to be modified It should contain the following lines SWO SWOLogFile C TestSwo dat J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 148 CHAPTER 3 J Link software and documentation package 3 9 JTAGLoad Command line tool JTAGLoad is a tool that can be used to open and execute an svf Serial vector format file for JTAG boundary scan tests The data in the file will be sent to the target via J Link J Trace JTAGLoad SEGGER JTAG Load Compiled 13 33 56 on Dec 2 2005 Executing file C J Trace sufl SVF is a standard format for boundary scan vectors to be used with different tools and targets SVF files contain human readable ASCII SVF statements consisting of an SVF command the data to be sent the expected response a mask for the response or additional information JTAGLoad supports following SVF commands ENDDR ENDIR FREQUENCY HDR HIR PIOMAP PIO RUNTEST SDR SIR STATE TDR TIR A simple SVF file to read the JTAG ID of the target can look like following Set JTAG frequency FREQUENCY 12000000HZ Configure
441. these indicators will be explained 5 2 4 Main indicator For J Links up to V7 the main indicator is single color Green J Link V8 comes with a bi color indicator Green amp Red LED which can show multiple colors green red and orange J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 5 2 1 1 CHAPTER 5 Working with J Link and J Trace Single color indicator J Link V7 and earlier Indicator status Meaning GREEN flashing at 10 Hz Emulator enumerates GREEN flickering Emulator is in operation Whenever the emulator is exe cuting a command the LED is switched off temporarily Flickering speed depends on target interface speed At low interface speeds operations typically take longer and the OFF periods are typically longer than at fast speeds GREEN constant Emulator has enumerated and is in idle mode GREEN switched off for 10ms once per second J Link heart beat Will be activated after the emulator has been in idle mode for at least 7 seconds GREEN flashing at 1 Hz Emulator has a fatal error This should not normally hap pen Table 5 1 J Link single color main indicator 5 2 1 2 Bi color indicator J Link V8 Indicator status Meaning GREEN flashing at 10 Hz Emulator enumerates GREEN flickering Emulator is in operation Whenever the emulator is exe cuting a command the LED is switched off temporaril
442. ting the ARM ETM Embed ded Trace Macrocell J Link J Trace Related Software Add on software to be used with SEGGER s indus try standard JTAG emulator this includes flash programming software and flash breakpoints Table 1 1 2004 2015 SEGGER Microcontroller GmbH amp Co KG Table of Contents Mta ae eh need 25 1 1 rer tee E er eR dera eRe ae Ca CEDE 26 1 2 Supported OS s oe ve xu Mrs exer ne ant RE Ra int 27 1 3 J Link7 J2Trace models reete ve o C E E P Ul e ED leg 28 1 3 1 Model expe er x Ea 29 1 3 2 J LMK BASE Duo NR I UI ND uei DC ats UE 30 1 3 3 JzEInK PLUS i sat soeur eee sede nd etse tea ee deed oa eet AA 36 1 3 4 J LINK ULTRA ree ee eee tede od v nex eoe er eret Ere een 41 1 3 5 E 46 1 3 6 JzLink D IRA CL ne 50 1 3 7 COFEEXM c is ie e de E ere E EE Kr Masa d E eee 51 1 3 8 TRACE ARM us oor rc rte De d Cintecele A dt ee 52 1 3 9 J Trace for Cortex M ides annees ern RR da dire et ete nn anne inner een deg 54 1 3 10 Flasher ARMES cutee oir ORS ee RS Arn a ine ut erc dd got me 57 1 4 Common features of the J Link product family 2 59 1 5 Supported CPU Coresa oo oe ee xxx breton e ndi n the ra eee P Eee 60 1 6
443. tion to select the device instead of using the remote command since for some devices J Link already needs to know the device at the time of connecting to it since some devices need special connect sequences e g devices with TI ICEPick modules In such cases it is not possible to select the device via remote commands since they are configured after the GDB client already connected to GDBServer and requested the target regis ters which already requires a connection to the target Note Using GDB Server CL this option is mandatory to correctly connect to the target and should be given before connection via GDB Syntax device lt DeviceName gt Example jlinkgdbserver device AT91SAM7SE256 Add information For a list of all valid values for lt DeviceName gt please refer to http www seg ger com jlink supported devices html 3 3 5 3 endian Description Sets the endianess of the target where endianess can either be little or big Note Using GDB Server CL this option is mandatory to correctly connect to the target and should be given before connection via GDB J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 126 CHAPTER 3 J Link software and documentation package Syntax endian lt endianess gt Example jlinkgdbserver endian little 3 3 5 4 if Description Selects the target interface which is used by J Link to connect to the device The default value is JTAG Note
444. tions C C Compiler Assembler Output Converter Custom Build Build Actions Linker Debugger Simulator J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 181 5 3 3 Determining values for scan chain configuration When do I need to configure the scan chain If only one device is connected to the scan chain the default configuration can be used In other cases J Link J Trace may succeed in automatically recognizing the devices on the scan chain but whether this is possible depends on the devices present on the scan chain How do configure the scan chain 2 values need to be known e The position of the target device in the scan chain e The total number of bits in the instruction registers of the devices before the tar get device IR len The position can usually be seen in the schematic the IR len can be found in the manual supplied by the manufacturers of the others devices ARM7 ARM9 have an IR len of four Sample configurations The diagram below shows a scan chain configuration sample with 2 devices con nected to the JTAG port Device 0 Device 1 TDI TDO TDI TDO Examples The following table shows a few sample configurations with 1 2 and 3 devices in dif ferent configurations Device 0 Device 1 Device 2 Chip IR len Chip IR Chip IR len Position IRon ARM 4 s 0 0 ARM 4 Xilinx 8 0 0 Xilinx 8 ARM
445. ug IBBORO NG request signal to the target system Typically connected to DBGRQ if available otherwise left open This pin can be used to supply power to the target hard 5V Sup ware Older J Links may not be able to supply power on this 19 Output pin For more information about how to enable disable the ply power supply please refer to Target power supply on page 392 Table 14 1 J Link J Trace pinout Pins 4 6 8 10 12 14 16 18 20 are GND pins connected to GND in J Link They should also be connected to GND in the target system 14 1 1 1 Target board design We strongly advise following the recommendations given by the chip manufacturer These recommendations are normally in line with the recommendations given in the table Pinout for JTAG on page 390 In case of doubt you should follow the recommen dations given by the semiconductor manufacturer You may take any female header following the specifications of DIN 41651 For example Harting Molex Tyco Electronics J Link J Trace UM08001 part no 09185206803 part no 90635 1202 part no 2 215882 0 2004 2015 SEGGER Microcontroller GmbH amp Co KG 392 CHAPTER 14 Target interfaces and adapters Typical target connection for JTAG JTAG connector Target board supply Voltage NTRST and RTCK may not be available on some CPUs Optional to supply the target board from J Link 14 1 1 2 Pull up pull down resistors Unless oth
446. ug session Below a small instruction of how to re configure J Link to enumerate with the old obsolete enumeration method in order to prevent compatibility problems a short instruction is give on how to set USB enumeration method to USB 2 is given Config area byte Meaning USB Address Can be set to 0 3 OxFF is default which 0 means USB Address 0 Enumeration method 1 0x00 OxFF USB Address is used for enumeration 0x01 Real SN is used for enumeration Table 5 10 Config area layout USB Enumeration settings Example for setting enumeration method to USB 2 1 Start J Link Commander JLink exe which is part of the J Link software 2 Enter wconf 0 02 Set USB Address 2 3 Enter wconf 1 00 Set enumeration method to USB Address 4 Power cycle J Link in order to apply new configuration Re configuration to REAL SN enumeration can be done by using the J Link Configura tor which is part of the J Link software and documentation package For further information about the J Link configurator and how to use it please refer to J Link Configurator on page 165 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 191 5 7 J Link control panel Since software version V3 86 J Link the J Link control panel window allows the user to monitor the J Link status and the target status information in real time It also allows the user to configure the use of some J Link features such
447. upported SWO input speeds are 60MHz gt 8 7 5MHz 6 66MHz 6MHz J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 184 CHAPTER 5 Working with J Link and J Trace Permitted combinations are SWO output SWO input Deviation percent 6MHz n 12 6MHz n 10 0 4MHz n 18 4MHz n 15 0 Sa lt 3 2MHz n 36 2MHz n 30 0 Table 5 7 Permitted SWO speed combinations Example 2 Target CPU running at 10 MHz Possible SWO output speeds are 10MHz 5MHz 3 33MHz J Link V7 Supported SWO input speeds are 6MHz n n gt 1 6MHz 3MHz 2MHz 1 5MHz Permitted combinations are SWO output SWO input Deviation percent 2 2 5 2 2 n 3 0 1MHz n 10 1MHz 6 0 769kHz n 13 750kHz n 8 2 53 Table 5 8 Permitted SWO speed combinations J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 185 5 5 Multi core debugging J Link J Trace is able to debug multiple cores on one target system connected to the same scan chain Configuring and using this feature is described in this section 5 5 1 How multi core debugging works Multi core debugging requires multiple debuggers or multiple instances of the same debugger Two or more debuggers can use the same J Link J Trace simultaneously Configuring a debugger to work with a core in a multi core environment does
448. uring CPU detection connection pro cess Kind of verbose option Disabled by default therefor only an enable option Will be reset to disabled on each call to JLINK Open reconnect to J Link Syntax EnableRemarks 5 12 1 21ExcludeFlashCacheRange This command is used to invalidate flash ranges in flash cache that are configured to be excluded from the cache Example ExcludeFlashCacheRange 0x10000000 0x100FFFFF 5 12 1 22GetCPUVars 5 12 1 23Hide device selection This command can be used to suppress the device selection dialog If enabled the device selection dialog will not be shown in case an unknown device is selected Syntax HideDeviceSelection 0 1 Example HideDeviceSelection 1 Device selection will not show up 5 12 1 24HSSLogFile This command enables HSS Logging Separate to the application using HSS all HSS Data will be stored in the specified file Syntax HSSLogFile Path Example HSSLogFile C Test log 5 12 1 25InvalidateCache This command is used to invalidate cache Syntax InvalidateCache J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 224 CHAPTER 5 Working with J Link and J Trace 5 12 1 26InvalidateFW This command is used to invalidate the current firmware of the J Link J Trace Inval idating the firmware will force a firmware update Can be used for downdating For more information please refer to J Link J Trace
449. ut for JTAG J Link and J Trace have a JTAG connector compati ble to ARM s Multi ICE The JTAG connector is a 20 way Insulation Displacement Connector IDC keyed box header 2 54mm male that mates with IDC sockets mounted on a ribbon cable later J Link products like the J link ULTRA these pins are reserved for firmware extension pur poses They can be left open or connected to GND in normal debug environment They are not essential On VTref 1e e 2 NC nTRST 3e 4 GND TDI 5e e 6 GND TMS 7 e 8 GND TCK 9e e 10 GND RTCK 11 e 12 GND TDO 13 e 14 GND RESET 15 e 16 GND DBGRQ 17 e 18 GND 5V Supply 19 e e 20 GND for JTAG SWD in general The following table lists the J Link J Trace JTAG pinout PIN SIGNAL TYPE Description VTref Input This is the target reference voltage It is used to check if the target has power to create the logic level reference for the input comparators and to control the output logic levels to the target It is normally fed from Vdd of the target board and must not have a series resistor Not con nected NC This pin is not connected in J Link nTRST Output JTAG Reset Output from J Link to the Reset signal of the target JTAG port Typically connected to nTRST of the target CPU This pin is normally pulled HIGH on the target to avoid unintentional resets when there is no connection TDI Output JTA
450. verify a connection to the J Link can be estab lished as follows Start J Link Commander From within J Link Commander enter ip tunnel lt SerialNo gt If the connection was successful it should look like in this screenshot 3 J Link ARM v4 54 SEGGER J Link Commander 04 54 for help Compiled Sep 11 2012 18 33 18 Can not connect to J Link via USB J Link gt ip tunnel 59888888 Connecting to tunnel 59080008 DLL version 04 54 compiled Sep 11 2012 18 32 59 Firmware J Link U9 compiled Oct 2 2612 89 11 43 Hardware 1 9 S N 5980880888 UTarget 3 3120 Info TotalIRLen 9 IRPrint 6x 611 Info Found Cortex M4 r p1 Little endian Info TPIU fitted Info EIM fitted Info FPUnit 6 code BP slots and 2 literal slots Found 2 JTAG devices Total IRLen 9 Id x4BA86477 IRLen 04 IRPrint CoreSight JTAG DP CARM 1 Id 6x66413641 IRLen 85 IRPrint 8x1 STM32 Boundary Scan Cortex M4 identified JTAG speed 100 kHz J Link J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 138 CHAPTER 3 Troubleshooting J Link software and documentation package Problem Solution Remote server cannot connect to tunnel server 1 Make sure the Remote server is not blocked by any firewall 2 Make sure port 19020 is not blocked by any firewall 3 Contact network admin J Link Commander cannot connect to tunnel server 1 Make sure Remote server
451. version of J Link sold by Analog Devices Limitations mIDASLink works with Analog Devices chips only This limitation can NOT be lifted if you would like to use J Link with a device from an other manufacturer you need to buy a separate J Link Licenses Licenses for RDI J Link FlashDL and FlashBP are included Other licenses can be added per 2 5 2 Atmel SAM ICE SAM ICE is an OEM version of J Link sold by Atmel Limitations SAM ICE works with Atmel devices only This limitation can NOT be lifted if you would like to use J Link with a device from an other manufacturer you need to buy a separate J Link Licenses Licenses for RDI and GDB Server are included Other licenses can be added J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 77 2 5 3 Digi JTAG Link Digi JTAG Link is an OEM version of J Link sold by Digi Interna tional Limitations Digi JTAG Link works with Digi devices only This limitation can NOT be lifted if you would like to use J Link with a device from an other manufacturer you need to buy a separate J Link Licenses License for GDB Server is included Other licenses can be added 2 5 4 IAR J Link J Link KS IAR J Link IAR J Link KS are OEM versions of J Link sold by IAR Limitations IAR J Link IAR J Link KS cannot be used with Keil MDK This lim itation can NOT be lifted if you would like to use J Link with Keil MDK you need to buy
452. which has been read 0 255 Example int c 0 do c SEGGER RTT WaitKey while c 12 4 1 128EGGER RTT WrtiteString Description Write a O terminated string to an up channel via RTT Prototype int SEGGER RTT WriteSting unsigned BufferIndex const char Parameters Parameter Meaning BufferIndex Index of the up channel to send string to S Pointer to O terminated string to be sent Table 12 9 SEGGER RTT WriteString parameter list Return value gt 0 Number of bytes which have been sent Example SEGGER RTT WriteString 0 Hello World from your target n J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 350 CHAPTER 12 RTT 12 4 2 Configuration defines 12 4 2 1 RTT configuration SEGGER_RTT_MAX_NUM_DOWN_BUFFERS Maximum number of down to target channels SEGGER_RTT_MAX_NUM_UP_BUFFERS Maximum number of up to host cahnnels BUFFER SIZE DOWN Size of the buffer for default down channel 0 BUFFER SIZE UP Size of the buffer for default up channel O SEGGER RTT PRINT BUFFER SIZE Size of the buffer for SEGGER RTT printf to bulk send chars SEGGER RTT LOCK Locking routine to prevent interrupts and task switches from within an RTT operation SEGGER RTT UNLOCK Unlocking routine to allow interrupts and task switches after an RTT operation SEGGER RTT IN RAM Indicate the whole application is in RAM to prevent falsly identif
453. wing MCUs from Analog Devices AD7160 ADuC7020x62 ADuC7021x32 ADuC7021x62 ADuC7022x32 ADuC7022x62 ADuC7024x62 ADuC7025x32 ADuC7025x62 ADuC7026x62 ADuC7027x62 ADuC7028x62 ADuC7030 ADuC7031 ADuC7032 ADuC7033 ADuC7034 ADuC7036 ADuC7038 ADuC7039 ADuC7060 ADuC7061 ADuC7062 ADuC7128 ADuC7129 ADuC7229x126 ADuCRFO2 ADuCRF101 13 1 1 ADuC7xxx 13 1 1 1 Software reset CHAPTER 13 Device specifics A special reset strategy has been implemented for Analog Devices ADUC7xxx MCUs This special reset strategy is a software reset Software reset means basically RESET pin is used to perform the reset the reset is initiated by writing special func tion registers via software The software reset for Analog Devices ADUC7xxxx executes the following sequence The CPU is halted A software reset sequence is downloaded to RAM A breakpoint at address 0 is set The software reset sequence is executed It is recommended to use this reset strategy This sequence performs a reset of CPU and peripherals and halts the CPU before executing instructions of the user program It is the recommended reset sequence for Analog Devices ADUC7xxx MCUs and works with these devices only This information is applicable to the following devices Analog ADuC7020x62 Analog ADuC7021x32 Analog ADuC7021x62 Analog ADuC7022x32 Analog ADuC7022x62 Analog ADuC7024x62 Analog ADuC7025x32 Analog ADuC7025x62 J Link J Trace UM08001 2004 2015 SE
454. xe As part of the initial message the hardware version is displayed com 12 2 Link ARM 08 compiled Mar 12 2 8 0040 5 kHz 5 2 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 29 1 3 1 Model comparison The following tables show the features which are included in each J Link J Trace model Hardware features J Link J Link J Link J Link J Trace J Trace BASE PLUS ULTRA PRO for Cortex M ARM USB yes yes yes yes yes yes Ethernet no no no yes no no Tracing Cortex M3 M4 ARM7 9 11 No tracing Cortex A5 A8 A9 R4 ARM7 9 11 SUDRertse Goles Cor EMO MOS MIME 1 Renesas RX M1 Cortex A5 A8 A9 R4 JTAG yes yes yes yes yes yes SWD yes yes yes yes yes no SWO yes yes yes yes yes no ETM Trace no no no no yes yes Software features Software features are features implemented in the software running on the host Software features can either come with the J Link or be added later using a license string from Segger J Link J Link J Link J Link J Trace BASE PLUS ULTRA PRO ARM Cortex M J Flash yes opt yes yes yes yes yes Flash breakpoints yes opt yes yes yes yes yes Flash download yes yes yes yes yes yes GDB Server yes yes yes yes yes yes RDI yes opt yes yes yes yes yes 1 In order to use the flash breakpoints with J Link no additional l
455. xxx 5 STM32F4xxxx 6 STM32L1xxxx Table 3 15 Available Parameter for SetDeviceFamily Example JLinkSTM32 exe SetDeviceFamily 6 Selects STM32L1 series JLinkSTM32 exe SetDeviceFamily STM32L1xxxx Selects STM32L1 series Exit In general the J Link STM32 utility waits at the end of the unlock process for any user input before application closes This option allows to skip this step so that the utility closes automatically Syntax Exit lt Mode gt Example JLinkSTM32 exe Exit 1 J Link STM32 utility closes automatically J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 154 CHAPTER 3 J Link software and documentation package 3 12 J Link Software Developer Kit SDK The J Link Software Developer Kit is needed if you want to write your own program with J Link J Trace The J Link DLL is a standard Windows DLL typically used from C programs Visual Basic or Delphi projects are also possible It makes the entire functionality of J Link J Trace available through its exported functions such as halt ing stepping the CPU core reading writing CPU and ICE registers and reading writing memory Therefore it can be used in any kind of application accessing a CPU core The standard DLL does not have API functions for flash programming However the functionality offered can be used to program flash In this case a flash loader is required The table below lists some of the included files and their res
456. y Flickering speed depends on target interface speed At low interface speeds operations typically take longer and the OFF periods are typically longer than at fast speeds GREEN constant Emulator has enumerated and is in idle mode GREEN switched off for 10ms once per second J Link heart beat Will be activated after the emulator has been in idle mode for at least 7 seconds ORANGE Reset is active on target RED flashing at 1 Hz Emulator has a fatal error This should not normally hap pen Table 5 2 J Link single color LED main color indicator J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 177 5 2 2 Input indicator Some newer J Links such as the J Link Pro Ultra come with additional input output indicators The input indicator is used to give the user some information about the status of the target hardware 5 2 2 1 Bi color input indicator Indicator status Meaning GREEN Target voltage could be measured Target is connected ORANGE Target voltage could be measured RESET is pulled low active on target side RESET is pulled low active on target side If no target is RED x connected reset will also be active on target side Table 5 3 J Link bi color input indicator 5 2 3 Output indicator Some newer J Links such as the J Link Pro Ultra come with additional input output indicators The output indicator i
457. y closes after a timout of 5 seconds when no target voltage can be measured or connection to target fails This command line option prevents GDB Server from closing to allow connecting a target after starting GDB Server Note The recommended order is to power the target connect it to J Link and then start GDB Server Syntax notimeout J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 130 CHAPTER 3 J Link software and documentation package 3 3 5 18 novd Description Do not explicitly verify downloaded data Note For the GUI version this setting is persistent for following uses of GDB Server until changed via command line option or the GUI Syntax vd 3 3 5 19 port Description Starts GDB Server listening on a specified port This option overrides the default lis tening port of the GDB Server The default port is 2331 Note Using multiple instances of GDB Server setting custom values for this option is necessary Syntax port Port Example jlinkgdbserver port 2345 3 3 5 20 scriptfile Description Passes the path of a J Link script file to the GDB Server This scriptfile is executed before the GDB Server starts the debugging identifying communication with the tar get J Link scriptfiles are mainly used to connect to targets which need a special con nection sequence before communication with the core is possible For more information about J Link script files please
458. y management unit Program Status Register PSR Contains some information about the current program and some information about the current processor state Therefore often referred to as Processor Status Register Also referred to as Current PSR CPSR to emphasize the distinction to the Saved PSR SPSR The SPSR holds the value the PSR had when the current function was called and which will be restored when control is returned Remapping Changing the address of physical memory or devices after the application has started executing This is typically done to make RAM replace ROM once the initialization has been done Remote Debug Interface RDI RDI is an open ARM standard procedural interface between a debugger and the debug agent The widest possible adoption of this standard is encouraged RTCK Returned TCK The signal which enables Adaptive Clocking RTOS Real Time Operating System Scan Chain A group of one or more registers from one or more TAP controllers connected between TDI and TDO through which test data is shifted Semihosting A mechanism whereby the target communicates I O requests made in the application code to the host system rather than attempting to support the I O itself SWI Software Interrupt An instruction that causes the processor to call a programer specified subroutine Used by ARM to handle semihosting TAP Controller Logic on a device which allows access to some or all of that devi
459. y simplified com pared with microprogrammed Complex Instruction Set Computer CISC J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 408 CHAPTER 15 Background information 15 1 JTAG JTAG is the acronym for Joint Test Action Group In the scope of this document the JTAG standard means compliance with IEEE Standard 1149 1 2001 15 1 1 Test access port TAP JTAG defines a TAP Test access port The TAP is a general purpose port that can provide access to many test support functions built into a component It is composed as a minimum of the three input connections TDI TCK TMS and one output con nection TDO An optional fourth input connection nTRST provides for asynchro nous initialization of the test logic PIN Type Explanation TCK Input uu test clock input TCK provides the clock for the test ogic TDI Input Serial test instructions and data are received by the test logic at test data input TDI TMS ou The signal received at test mode select TMS is P decoded by the TAP controller to control test operations Test data output TDO is the serial output for test TOS QUEPUE instructions and data from the test logic nTRST Input The optional test reset nTRST input provides for asyn optional chronous initialization of the TAP controller Table 15 1 Test access port 15 1 2 Data registers JTAG requires at least two data registers to be pres
460. ying bargraph on 8 LEDs it works in interrupt mode D conversion is done in interrupt mode D value is sent every 1 second on UART1 text is displayed to textual LCD bargraph is displayed to textual LCD according to potentiometer position 8 LEDs state represent the potentiometer position 12 MHz 288 MHz 57 6 MHz 48 MHz 14 4 MHz The Blinky program is available in different targets Simulator configured for software Simulator MCB2300 Flash runs from Internal Flash located on chip used for production or target debugging EN E croco E Bic E Lco 4c B B Load C Kei13030 ARM RV30 Boards Keil MCB2300 Blinky Flash Blinky AXF J Link J Trace 0 08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 318 CHAPTER 11 RDI Select Project Options for Target lt NameOfTarget gt to open the project options dialog and select the Debug tab Options for Target LPC2378 Flash RDI Interface Driver ULINK ARM D ULINK Cortes M EIL Loeb Choose RDI Interface Driver from the list as shown above click the Settings button Select the location of JLinkRDI d11 in Browse for RDI Driver DLL field and click the Configure RDI Driver button RDI Interface Driver Setup x C Program Files SEGGER LinkARM_V359a JLinkRDI_dll FERE lemos The J Link RDI Configuration dialog will be
461. ying the RTT Control Block in the init segment by defining as 1 12 4 2 2 Channel buffer configuration SEGGER RTT MODE BLOCK IF FIFO FULL SEGGER RTT NO BLOCK SKIP SEGGER RTT NO BLOCK TRIM 12 4 2 3 Color control sequences RTT CTRL RESET Reset the text color and background color RTT CTRL TEXT Set the text color to one of the following colors BLACK RED GREEN YELLOW BLUE MAGENTA CYAN WHITE light grey BRIGHT BLACK dark grey BRIGHT RED J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG BRIGHT_GREEN BRIGHT_YELLOW BRIGHT_BLUE BRIGHT_MAGENTA BRIGHT_CYAN BRIGHT_WHITE RTT CTRL BG Set the background color to one of the following colors J Link J Trace UM08001 BLACK RED GREEN YELLOW BLUE MAGENTA CYAN WHITE light grey BRIGHT BLACK dark grey BRIGHT RED BRIGHT GREEN BRIGHT YELLOW BRIGHT BLUE BRIGHT MAGENTA BRIGHT_CYAN BRIGHT_WHITE 2004 2015 SEGGER Microcontroller GmbH amp Co KG 352 CHAPTER 12 RTT 12 5 Example code REE KERR EEK ERE REE RK RRR ERE ERE REE ERR EKER ERE RRR kk kkk kkk kkk kk SEGGER MICROCONTROLLER GmbH amp Co KG d Solutions for real time microcontroller applications KKK ck ck ck ck ck ckck ck ckck ck ck ck ck ck ck k ck k kk k kk 2014 SEGGER Microcontroller GmbH amp Co KG WWW Segger com
462. ypes which are available please refer to Reset strategies on page 197 Please note that there different reset strategies for ARM 7 9 and Cortex M devices Syntax SetResetType value Example SetResetType 0 Selects reset strategy type 0 normal 5 12 1 53 SetRestartOnClose This command specifies whether the J Link restarts target execution on close The default is to restart target execution This can be disabled by using this command Syntax SetRestartOnClose 0 1 J Link J Trace UM08001 2004 2015 SEGGER Microcontroller GmbH amp Co KG 232 CHAPTER 5 Working with J Link and J Trace Example SetRestartOnClose 1 5 12 1 54 SetRTTAddr In some cases J Link cannot locate the RTT buffer in known RAM This command is used to set the exact address manually Syntax SetRTTAddr lt RangeStart gt Example SetRTTAddr 0x20000000 5 12 1 55SetRTTSearchRanges In some cases J Link cannot locate the RTT buffer in known RAM This command is used to set multiple ranges to be searched for the RTT buffer Syntax SetRTTSearchRanges lt RangeAddr gt lt RangeSize gt RangeAddr1 lt RangeSizel gt Example SetRTTSearchRanges 0x10000000 0x1000 0x20000000 0x1000 5 12 1 56SetRXIDCode This command is used to set the ID Code for Renesas RX devices to be used by the J Link DLL Syntax SetRXIDCode RXIDCode String Example Set 16 IDCode Bytes 32 Characters S
Download Pdf Manuals
Related Search
Related Contents
Artisan Technology Group is your source for quality new and JOFRA ATC-125 Copyright © All rights reserved.
Failed to retrieve file