Home

Datasheet - Mouser Electronics

1. 3FOFOFOF 01 05 07 3FOFOFOF gt JTAGSpeed 06 1 00 4000 OD 0c 01 40 00 10 OF 00 00 00 05 00 01 FF 00 00 RDI Testing speed 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOF 3FOFOFOFAuto JTAG gt 2EF gt oc 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 0 4 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 4 00 00 00 00 13 27 24 00 00 48 24 Writing 0x54 bytes 0 00000178 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 0 4 bytes 2004 2014 SEGGER Microcontroller GmbH amp Co KG 283 9 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 9 5 1 Overview Semihosting Semihosting is a mechanism f
2. oe veh ahh 23 1 1 s esee xe nate ge Iu SEA 24 1 2 Supported OS s oes xu ad nea ERE dah a 25 1 3 J Link 7 J2Trace models rene tee ve e C E E PU lC eva P ED lo 26 1 3 1 Model COMPALISON si sies expe e v 27 1 3 2 SPIRI dee E E 28 1 3 3 JzEinkc ULTRA uetus ohh Mare Re versare sre ux nU NUS 31 1 3 4 SEE did ccc 32 1 3 5 REED 33 1 3 6 JzLink Lbite CortexM scio ERI EA 34 1 3 7 RAGS ARM ost ene uu Ed Edi Ed Ml 35 1 3 8 J Trace for Cortex M Liu oro vete eui ex 38 1 3 9 Flasher ARMs ERR ERer ERU RPARDERQERR M KOCH ERA NETS 40 1 3 10 Jebink oldFire 2 e 41 1 4 Common features of the J Link product 40 42 1 5 Supported CPU Conese oo oe eM exea dea xe odd nh ro ee od e e 43 1 6 Built in intelligence for supported CPU cores 2 1 44 1 6 1 Intelligence in the J Link firmware eee menn 44 1 6 2 Intelligence on the PC side 41 1 44 1 6 3 Firmware intelligence per model 46 1 7 SUPPOrted E 48 2 Reo
3. 49 010 a e OA RUE E RR P CAR UR e e RR OPES Components requiring a license50 2 2 Lic nse tyPES SEPTEM 51 2 2 1 Built in Cen SE nair ana p a aw i awe 51 2 2 2 Key based 1 1 3 66 E mena sea se a sua sena sea nnn 51 2 3 Legal use of SEGGER J Link 52 2 3 1 Use of the software with 3rd party 16 1 66 52 2 4 Original SEGGER prod cts 5 eoo Rx eaten peice rahe 53 2 4 1 Je LIN Ke 53 2 4 2 J LINK PLUS icone cx xa e v ert i e X nev e ER e o veers 53 2 4 3 WET RAF cr 54 2 4 4 SEL 54 2 4 5 2 e tert RR devs ARRA DE 55 2 4 6 J Trace for ke e e TR Fe TE vane EY RUE S i a 55 2 4 7 dec 56 2 4 8 aire et EM 56 2 4 9 Ethic R 57 2 5 J Link OEM versions ec ee ex ee xa e i e T e a eee KE 58 2 5 1 Analog Devices MIDASLINK 58 2 5 2 Atmel SAMICE eevee ey tee pasen Fe Tag dv Sw Vara Mio D YE ewes 58 2 5 3 Digt JTAG EINK TEUER 59 2 5 4 IAR J Link J LINK KS x t x ver e xen Ce E EE ER E Rn 59 2 5 5 TAR J GNK
4. mm memes 329 l1 1154 JE PCASSO ee tee testet erste uta MPO DEAN R 329 11 12 oder 330 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 20 11 13 IE YR IS ERI 331 11 14 SAMSUNG 332 332 11 15 Silicon 333 11 15 1 EFM32 series devices eoo iier onde keit EX 333 11 16 ST Microelectrornics ecce epo entre pr oe pt An Pe ecu 334 11 16 STRO9TX coe t aret brute ER ETE OED ot alow LER dae Her Ere pex na 335 11 16 27 SSTM32FET0960 incre rr xt e xn x EE 335 11 16 3 STM32E2 00 4 sei disci ee tear ax eek nada RR HER roD po YS RARE nagar prea neater E kr pe 337 11 16 4 STM32E4DOO0 deren caer aci a EE TUNE 338 11 17 Texas Instruments 339 1151751 lt 339 11 17 2 7 casts bes 340 11 17 89 OMAPS 430 aid ieee e D vuv eee eee er ead 340 l11 17 4 QMAPELT38 0004 a et ex een FREI Ren ORE EO FAEERE QUA e EX REDE X RENE RE E 340 11 17 55 TMSA470M ice er bre baee tin ue e
5. weaornenn No Pos J Link _1 Stat STR ZIxaxf 7 For Help press F1 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 263 9 3 3 ARM RVDS RealView developer suite 9 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 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 264 CHAPTER 9 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 Ma Jonnect ARM 0ak ARM Vehicle SRMOT WIGGLER Macraigor Wiggler EAS IRE DIR RM Ltd Direct Connection 3 S VPB926EJ S U Versatile Platform for ARMS26EJ S USB
6. 59 2 5 6 2 A 60 2 5 7 NXP J Eink Lite EPC gt device rtr rati eene yr e sivas 60 2 5 8 SEGGER J Link Lite ARM eoi exe een en e e he m boxes e 60 2 6 VERE 61 2 7 rige 62 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 16 J Link software and documentation 63 3 1 Software 2 nennen a neas asa a reae area sean nnn nnn 64 3 2 J Link Commander Command line 1 6 65 3 2 1 Commialds dus io sedes EE EK i Gann TE NE e rM RR CEDERE 66 3 2 2 Command lire Options tere IRE eoru te E EMEN A e Uo PEN Rr e ENTE 80 3 2 3 Using command files e e oxi ere e Rx dx ever ree t da 82 3 3 J Link GDB Serve c ne tie b P ie 83 3 3 1 J Link GDB Server CL Windows Lunux 6 83 3 3 2 Debugging with J Link GDB Server mene 84 3 3 3 Supported remote monitor 6 89 3 3 4 SEGGER specific GDB protocol extensions nennen 101 3 3 5 Comm
7. 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 Uses 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 Executes a gdb file on every connection cpu Selects the CPU core Deprecated use device instead Table 3 8 General command line options J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 106 J Link software and documentation package 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 ARM9 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 FAM
8. 146 4 3 2 Configuring J Link using the 146 4 4 FAQS M Y 148 4 5 J LINK CONFIGURATOR ss sive 149 4 5 1 Configure J Links using the J Link Configurator 11 149 4 6 J Link USB 151 4 6 1 Connecting to different J Links connected to the same host PC via USB 151 4 7 Using the J Einke DEL echoes inan ta ter ERE Rhe XR e ee RR 153 4 7 1 What is the JLink DLL ce cere xr x Dk ker n x E Ph a 153 4 7 2 Updating the DLL in third party 2 44 4 0 44 153 4 7 3 Determining the version of JLink DLL sssssessem me 154 4 7 4 Determining which DLL is used by 154 4 8 Getting started with J Link and ARM DS 5 0500002 155 4 8 1 Replacing the RDDI DLL 1 6 nnns 155 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 4 8 2 Using J Link DS 5 Development Studio 155 5 Working with J Link and Je T1268 eee veces tees EE ol ns 157
9. 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 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 x Manual Configuration Device Name Auto Ok 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 IP Address Port Auto 0 Autodetect JLink In
10. 372 13 5 2 Invalidating the firmware re ERR xe Rr rea e 372 14 Designing the target board for trace 375 14 1 Overview of high speed board 376 14 1 1 Avoiding StUDS it ete eere inion eae 376 14 1 2 Minimizing Signal Skew Balancing PCB Track Lengths 376 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 14 1 3 Minimizirg Crosstalk eee Re ERE EX Ve ER FEE EA DERI 376 14 1 4 Using impedance matching and termination 376 14 2 Terminating the trace 0 050 emen 377 14 2 1 Rules for series terminators 2 11111 mnes 377 14 3 Signal requirements e FOE 378 15 SUPPOM ANG BAGS tiende de CO 379 15 1 Measuring download Speed 380 15 1 1 Test environmieht lecce sens 380 15 2 Troubleshooting er ao en ob er i ere tween te Re D p e Ri 381 15 2 1 General a A RO Ra neuen EET RE CE 381 15 2 2 Typical problem scenarios cee ee nemen meme menn nnn nnn nnn 381 15 3 Contacting Support REM EE EU A ere N
11. Cancel Apply Use software 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 2014 SEGGER Microcontroller GmbH amp Co KG 281 9 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 m 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
12. E 359 13 361 13 1 lc 362 13 1 1 Test access port TAP seda tu geen 362 13 1 2 Data registers rore E e eee i pese ere re E EE PN EET ds 362 13 1 3 Instruction regis teisine eee pe dnx eade curd Kalte Me etd Re Na 362 13 1 4 The 525 560 Gan o eR Er Ra a E Re CANE EENAA aiaia 363 13 2 Embedded Trace Macrocell 1 nnn nnn 365 13 2 1 Trigger conditiomz sie 365 13 2 2 Code tracing and data tracing eren Hnc XR PX Ha fna 365 13 2 3 J Trace integration example Embedded Workbench for ARM 365 13 3 Embedded Trace Buffer 4 41 1 44422 415 6 nnn 369 13 4 Flash programming x zd eee 370 13 4 1 How does flash programming via J Link J Trace work 370 13 4 2 Data download to een 370 13 4 3 Data download via DCC ive te erae eee Rr CI MEC IRR 370 13 4 4 Available options for flash 2 2 01 370 13 5 J Link 7 JeTrace fIEm Ware ic eere soe v eo de C n e 372 13 5 1 Firmware update esie eet Tee e vx
13. a register WriteJTAG IR Cmd Writes the JTAG instruction register WriteJTAG DR nBits Data Writes the JTAG data register Table 9 2 Macro file commands Example of macro file f kk e ck ke ke ke cec se e she ke he e he e e ke ke ke KR ke ke ck he he ke EERE ERE 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 2014 SEGGER Microcontroller GmbH amp Co KG 278 CHAPTER 9 RDI 9 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 166 JTAG scan ch
14. een eee aoe nadie 243 8 5 3 Bat h processing eee 245 8 5 4 Programming multiple targets in parallel 245 8 6 Create a new J Flash SPI 10000 247 8 6 1 Creating new J Flash SPI project 247 8 6 2 Serial number A 248 8 7 Device specifice uu cutee reece dawn e ee rec ee wine ee Y ned ecce d ERE rien suede 249 8 7 1 SPI flashes with multiple erase 1 249 8 8 Target SYSTEMS sito eaters Ais epa e DP XR RP RM 250 8 8 1 Which flash devices be 250 8 9 Petformatce s eee EE d RR TER 251 8 9 1 Performance Valles seid Wins ees teet eau rede gr REA RETE ERE RERTRNENEE 251 8 10 Background information xe emer esten tad e 252 8 10 1 SPI interface nennen nea nna seas sea nnn 252 8 11 SU pDDOLFt A re dee vv 253 8 11 1 Tro bleshoOting geet staavang RIR TRAINS 253 8 11 2 Contacting ii nec e es Pec ERU ex AE ed Ebert EU ERES 253 S CDI
15. 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 following commands will not be processed J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 247 8 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 8 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 CusBsN 0 cot 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 9 es General Interface Flash Interface speed 4000 v kHz 4 Open the Flash and either select Automatically detect SP
16. STM32F1N7RC 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 r Configure Flash Menu Command Use Target Driver for Flash Programming Cortex M R J LINK J Trace Settings Update Target before Debugging RET C Use Extemal Tool for Flash Programming Omed Mamets _ Run Independent oats Lose J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 217 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 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 BI Edit Bj Edit Restore Debug Session Settings Restore Debug Session Settings
17. 0 08000746 0 0800 0 0 0800077 0x0800BEFE 0x0800B2AC 0XxX0800BEFC 0x0800BFB8 0x0800088C 0 0800 2 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 us Clk_Init 66 GetFlagstatus _ 66 RCC_GetFlagstatus us Clk_iInit 66 RCC_GetFlagStatus us _ 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 _ 84 RCC_PCLK2Confi g u32 _ 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 3
18. Process Explorer is at the time of writing a free utility which can be downloaded from www sysinternals com J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 155 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
19. 215 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 6 4 2 KeiliMD CER 215 6 4 3 Mentor Sourcery CodeBench 218 6 4 4 5 m 218 6 4 5 rere e xh E Y cued evade Rx 219 6 4 6 SEMI rU 220 6 5 Setup for various debuggers CFI flash 221 6 5 1 Embedded Workbench 221 6 5 2 J Link GDB Server oer rex xen DA TX LC X EX E C EV 222 6 5 3 JeLink commahdGr diis in t tete edv aeu e err RESO TE REY wes 222 6 6 Using the DLL flash loaders in custom 224 T RlasybreakpolHilss a porco 225 7 1 226 7 2 LICENSING EE 227 7 2 1 Free for evaluation and non commercial 6 227 7 3 Supported devices Set dct etre e dee uere UN TRA Fea CERE CR 228 7 4 Setup amp compatibility with various debuggers 1 1 nnn 229 7 4 1 Setup ixi dere ne ree eels Ie rds EE MES d ENG er RE RR RUE ee ieee 229 7 4 2 Compatibility with
20. 5 10 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 5 10 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 10 5 3 Supported type qualifiers The following type qualifiers are supported by the J Link script file language e const e signed e unsigned 5 10 5 4 Supported declarators The following type qualifiers are supported by the J Link script file language e Array declarators 5 10 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 10 5 6 Supported iteration statements The following iteration statements are supported by the J Link script file language e while e do while 5 10 5 7 Jump statements The following jump statements are supported by the J Link script file language return 5 10 5 8 Sample script files The J Link software and documentation package comes with sample script files for different devices The sample script file
21. Example gt monitor speed auto Select auto target interface speed 8000 kHz gt monitor speed 4000 Target interface speed set to 4000 kHz gt monitor speed adaptive Select adaptive clocking instead of fixed JTAG speed 3 3 3 27 step Syntax step lt NumSteps gt or si lt NumSteps gt Description Performs one or more single instruction steps where lt NumSteps gt is the number of instruction steps to perform If lt NumSteps gt is not specified only one instruction step will be performed Example gt monitor step 3 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 99 3 3 3 28 SWO DisableTarget Syntax SWO DisableTarget lt PortMask 0x01 OxFFFFFFFF gt 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 gt monitor SWO DisableTarget 3 lt SWO disabled succesfully 3 3 3 29 SWO EnableTarget Syntax SWO EnableTarget CPUFreq Hz lt SWOFreq Hz gt 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 CP
22. LOW level output voltage with a load of 10 kOhm Max 20 of Vir HIGH level output voltage Voy with a load of 10 kOhm Power supply Min 80 of Vir SWD Interface Electrical USB powered Max 50mA Target Supply current Target interface voltage Vir 1 2V 5V SWD interface is 5V tolerant but can output a maximum of 3 3V SWD signals Target supply voltage 4 5V 5V if powered with 5V on USB Table 1 9 Flasher ARM specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 41 Target supply current Max 300 LOW level input voltage Vii Max 0 8V HIGH level input voltage Min 2 0V LOW level output voltage with a load of 10 kOhm Meise HIGH level output voltage Voy with a load of 10 kOhm xd Table 1 9 Flasher ARM specifications 1 3 10 J Link ColdFire J Link ColdFire is a BDM emulator designed for ColdFire cores It connects via USB to a PC running Microsoft Windows 2000 Windows XP Windows 2003 or Windows Vista J Link ColdFire has a built in 26 pin BDM connector which is compatible to the standard 26 pin connector defined by Freescale For more infor mation about J Link ColdFire BDM 26 please refer to UM08009 J Link ColdFire BDM26 User s Guide J Link J Trace UM08001 3 ColdFire 26 2004 2014 SEGGER Microcontroller GmbH amp Co KG
23. 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 66 090327 AG Chapter Background information Section Embedded Trace Macrocell ETM updated Chapter J Link and J Trace related software Section Dedicated flash programming utilities for J Link updated 65 090320 AG Several changes in the manual structure 64 090313 AG Chapter Working with J Link Section Indicators added 63 090212 AG Chapter Hardware Several corrections Section Hardware Versions Version 8 0 added 62 090211 AG 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 Command line tool updated Chapter Device specifics Section ST Microelectronics updated Chapter Hardware updated 61 090120 TQ Chapter Working with J Link Section Cortex M3 specific reset strategies 60 090114 AG Chapter Working with J Link Section Cortex M3 specific reset strategies 59 090108 KN Chapter Hardware Section Target board design for JTAG updated Section Target board design for SWD added 58 090105 AG Chapter Working wit
24. Command short form Explanation fsize fsz Display size of file on emulator Write file to emulator fwrite fwr ection ip Connect to J Link Pro via TCP IP usb Connect to J Link via USB J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 68 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 selectio
25. 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 purchased 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 05080002
26. for ARM cores It is page 19 J Link Pro ndication TCP IP configuration Download speed up to 3 MByte second Unlimited number of breakpoints in flash FlashBP J Link GDBServer J Link RDI J Link RDDI and J Flash production programming softwa e Embedded Trace Buffer ETB support J Link J Trace UM08001 re 2004 2014 SEGGER Microcontroller GmbH amp Co KG 33 e Galvanic isolation from host via Ethernet 1 3 4 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 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 1 3 5 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 widely acknowledged JTAG emulator which allows him to start right away with his development 1 3 5 1 Additional features e Very small form factor e Fully software compatible to J Link e Supports any ARM7 9 11 Cortex A5 A8 A9 Cortex M0 M0 M1 M3 M4 Cortex R4 R5 core JTAG clock up to 4 MHz SWD SWO supported f
27. 2004 2014 SEGGER Microcontroller GmbH amp Co KG 146 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 149 4 3 2 Configuring J Link using the webinterface 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 LJ i D
28. 42 1 4 CHAPTER 1 Introduction Common features of the J Link product family USB 2 0 interface Full Speed Hi Speed depends 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 F 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 JTA
29. A macro file can be specified to load custom 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 2014 SEGGER Microcontroller GmbH amp Co KG Comands in the macro file 277 Command Description SetJTAGSpeed Sets the JTAG speed x speed in kHz O 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
30. J Flash SPI and company information Table 8 8 Help menu elements J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 239 8 4 Settings The following chapter provides an overview of the program settings Both general and per project settings are considered 8 4 4 Project Settings Project settings are available from the Options menu in the main window or by using the ALT F7 keyboard shortcut 8 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 8 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 8 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
31. J Link J Trace UM08001 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 2014 SEGGER Microcontroller GmbH amp Co KG 167 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 26 5 4 2 SWO Serial Wire Output SWO
32. 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 Output Debug JLinkSTR91x exe e of the primary flash manually Syntax ze 01 11213 where sele 256 Kbytes device 1 a 512 Kbytes device 2 a 1024 KBy vice and 3 2648 Kbytes device Show configuration register content and security status Read memory Syntax mem lt 44 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 L available gt blank secure Set the ects device from read or debu d by a ful unsecure tion regist protect 8 4 of bank 1 unprotect Unprotect fla Syntax unpro S 1 orMask 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 Wordi gt lt Wor
33. 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 Section 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 68 090428 AG
34. 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 register 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 2014 SEGGER Microcontroller GmbH amp Co KG 365 13 2 Embedded Trace Macrocell ETM Embedded Trace Macrocell ETM provides comprehensive debug and trace facilities for ARM processors ETM allows to capture in
35. Reset the target 3 8 6 2 Statusbar Start 0 ms X Resolution 1s div SEGGER J Scope started succesfully Sampling Off Samples in Buffer 0 D IV V I Start Timestamp of the 1st value currently shown in the graph II X Resolution Displayed time per division III Status Shows the lastest status message IV Sampling Indicates whether HSS is currently running or not V Samples in Buffer Shows the current amount of datapoints stored in buffer J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 131 3 9 SWO Analyzer SWO Analyzer SWwOAnalyzer exe is tool that analyzes SWO output Status and summary of the analysis are output to standard out the details of 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 2014 SEGGER Microcontroller GmbH amp Co KG 132 J Link software and documentation package 3 10 JTAGLoad Command line tool JTAGLoad is a tool that can be used to open and execute an svf Serial vector format file for JTAG bounda
36. 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 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 165 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 2014 SEGG
37. The screenshot below is an example for www emide org a device selection inside emIDE http 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 340 CHAPTER 11 Device specifics 11 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 11 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 11 17 1 4Known values for lt DeviceName gt For a list of all supp
38. 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 218 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 configuration 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 2014 SEGGER Microcontroller GmbH amp Co KG 219 lt DeviceName gt is the name of the device for which download into internal flash mem ory shall be enabled Fo
39. 0 141219 JL Chapter RTT added Chapter Related Software Section GDB Server Command line option strict added Command line option timeout added V4 90d Rev 0 141112 NG Chapter Related Software Section J Link Remote Server updated Section J Scope updated V4 90c Rev 0 140924 JL Chapter Related Software Section JTAGLoad updated V4 90b Rev 1 140813 EL Chapter Working with J Link and J Trace Section Connecting multiple J Links J Traces to your PC updated Chapter J Link software Section J Link Configurator updated V4 90b Rev 0 140813 NG Chapter Related Software Section J Scope added V4 86 Rev 2 140606 AG Chapter Device specifics Section Silicon Labs EFM32 series devices added V4 86 Rev 1 140527 JL Chapter Related Software Section GDB Server Command line options halt nohalt added Description for GDB Server CL version added V4 86 Rev 0 140519 AG Chapter Flash download Section Mentor Sourcery CodeBench added V4 84 Rev 0 140321 EL Chapter Working with J Link Section Virtual COM Port VCOM improved Chapter Target interfaces and adapters Section Pinout for SWD Virtual COM Port VCOM added V4 82 Rev 1 140228 EL Chapter Related Software Section Command line options Extended command line option speed Chapter
40. 1 BL SysTick c oun TE PB2PeriphRese h A I Rew ETE 5108 DISABLE O800BFDC 2100 Movs 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 RS RO 003067 003385 0X0800D8AE Bcc NVIC_SetvectorTable_4 08008 6 2101 Movs R1 0 1 08008 8 F44F7082 MOV RO 0x104 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 Prio
41. 1 RCC_APB2Periph_GPIOG DISABLE RCC_APB2PeriphClockCmd RCC_APB2Periph_GPIOA RCC_APB2Periph_GPIOG ENABLE GPIO InitStructure GPIO Pin 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 GPIO InitCB2 PORT amp GPIO InitStructure EXT CRT SECTIONO 7 port and ADC init 7 Enable ADC1 and 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 0 0 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 NAI i 0800BFD0 2001 IOVS RO 0 1 CED BL 4 Eres 1 2001 MOVS RO xi 08008 08
42. 100 to Ox1FF Reserved for applications 9 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 9 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 If the SWI is not recognized as a semihosting SWI J Link RDI halts the processor and reports an error See Unexpected unhandled SWIs on page 285 9 5 3 1 DCC semihosting J Link RDI does not support using the debug communications channel for semihost ing 9 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
43. 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 2014 SEGGER Microcontroller GmbH amp Co KG 147 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 n Subnet mask 255 255 1 About Gateway 168 Emulator status J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 148 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 2014 SEGGER Microcontroller GmbH amp Co KG 4 5 J Link Configurator Normally no configuration is required
44. J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 220 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 2014 SEGGER Microcontroller GmbH amp Co KG 221 6 5 Setup for various debuggers CFI flash The setup for download into CFI compliant memory 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 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 Target Power Swv Em 4 ry A ew Chee E verte Swel Close the debug session and open the settings file with a text editor Add the follow ing lines to the file CFI CFISize F
45. Lunux Mac 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 sub chapters apply to the command line version too J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 84 J Link software and documentation package 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 Connection to J Link Serial No C m Target device STM32F4171G E Little endian 7 m Target interface SwD Speed Auto selection Adaptive clocking e 4000 kHz Command line option select USB device STM32F4171G if SWD speed 4000 Cancel All confi
46. STM32F417IG 3 3 3 4 DisableChecks Syntax DisableChecks J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 92 CHAPTER 3 J Link software and documentation package Description Disables 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 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 3t Disable Flash Breakpoints monitor flash breakpoints 0 Flash breakpoints disabled V Enable Flash Breakpoins gt monitor flash breakpoints 1 Flash breakpoints enabled 3 3 3 7 getargs Syntax getargs Description Get the currently set argument list which will be given to the application whe
47. 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 become 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 u
48. define FCCOB2 volatile unsigned char 0x40020000 0x05 define FCCOB3 volatile 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 2014 SEGGER Microcontroller GmbH amp Co KG 321 Check current data flash amp EEPROM config Kd v FCCOB6 IFR offset OxFD if v OxFF E
49. eRDI RDDI eJ Flash Note In order to use ETM trace on ARM7 9 targets a J Trace is needed J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 56 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 Win dows XP Windows 2003 or Windows Vista Flasher ARM has a built in 20 pin JTAG connector which is compatible with the Licensing standard 20 pin connector defined by ARM Flasher Licenses Comes with built in licenses for flash download and J Flash 2 4 8 Flasher RX J Link J Trace UM08001 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 Windows XP Windows 2003 Windows Vista or Windows 7 Flasher RX itself has a built in 20 pin JTAG connector but is shipped with an 14 pin adapter for Renes
50. erase Erase internal flash of selected device exit ec 4 Closes J 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 Leg 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 x Resets and halts the target regs Shows all current register values rnh Resets without halting the target rreg Shows a specific register value x 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 fshow Read and display file from emulator J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 67
51. for TCP IP the IP or hostname of the J Link has to be entered Select 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 10 3 1 3 The Terminal Tabs RTT Viewer allows displaying the output of Channel 0 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 2014 SEGGER Microcontroller GmbH amp Co KG 294 CHAPTER 10 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 s
52. 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 2014 SEGGER Microcontroller GmbH amp Co KG 208 CHAPTER 5 Working with J Link and J Trace 5 13 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 ARM9 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 13 1 Cache coherency When debugging or
53. 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 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 209 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 l input VCOM functionality of J Link is enabled For further informa tion please refer to Virtual COM Port VCO
54. 104 CHAPTER 3 J Link software and documentation package 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 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 Select the target communication speed Table 3 5 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 6 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 al
55. 11 61 58 lt c 2009 2015 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 20 seconds gt 0 K Press any key to exit 3 12 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 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
56. 2 39 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 187 for more information about J Link script files When using J Link com 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 2014 SEGGER Microcontroller GmbH amp Co KG 83 3 3 J Link GDB Server The GNU Project Debugger GDB is a freely available and open source debugger It can be used 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 communica
57. 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 prs 0 00001 70 29 31 main 6 0 00000000 000000000 000000000 000000000 0 00002780 RRRARAARARARARERE EEE REAARAREREREREREER ERA RARERERERERERE ERS 35 int main void 1 36 05 IncDI Initially disable interrupts 37 08 InitKern initialize 08 lt x 0x00000000 38 05 InitHV initialize Hardware for 08 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 0 00000450 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 wei 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 00000040 EAFFFFFE EAFFFFFE EAFFFFFE iIennnnnnsn wannnnnn
58. 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 379 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 2014 SEGGER Microcontroller GmbH amp Co KG 145 jlink USB and click the Change Remove button Ea Add Remove Programs 3 Confirm the uninstallation process Uninstall Driver Package Q J Link J Trace 0 08001
59. 5 1 Connecting the target 0 158 5 1 1 Power on sequerce i eer rx rena re eran RE dese EKE aE AT TNS 158 5 1 2 Verifying target device connection 158 5 1 3 x roa ARRIERE OTI D LLIL ILLOD 158 5 2 lare lTor o ge 159 5 2 1 ER 159 5 2 2 TNPUt indicator ecce eren nr mer c eec E o ee C e C EE LE ERE BARS 161 5 2 3 Outp t indicator oec reduc esie peer terrre e e e o ARD 161 5 3 JTAG Interface sor oe e decr Duce a xw Ld a Doy e ee EN Y eR 162 5 3 1 Multiple devices in the scan chain 6 66 162 5 3 2 Sample configuration dialog 10 meme 162 5 3 3 Determining values for scan chain 165 5 3 4 JTAG Speed 166 5 4 SWD interfaces sis cereo de 167 5 4 1 SWD speed oec en daa avi as tant ER iene 167 5 4 2 yo 167 5 5 Multi core debugging Peele cu plu 169 5 5 1 How multi core debugging 169 5 5 2 Using multi core debugging in detail
60. 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 100617 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 Se
61. DLL s fou can always perform this operation at a later time via start menu taa J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 154 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 i 7 10 3077 0000 Multiple Provider Router DLL i i 5 00 2185 6611 CPU Usage 1 Commit Charge 12 24 Processes 34
62. E d LX PE XR D E dees Fs 340 11 17 6 OMAP3590 c ie pee ei re e a eek dk HR ER ED XR EVER 341 11 17 7 OMAP3550 rtr re Ee epe E pl E BOAT AE Er di E DEAE 341 11 18 TOSHIDA DUE AME 342 12 Target interfaces and adapters rta Rank rica 343 12 1 20 pin J Link nennen nua hear seen na nnn 344 12 1 1 Pinout for JTAG RU 344 12 1 2 Pinout for SWD maiie inaina a E A 347 12 1 3 Pinout for SWD Virtual COM Port 1 1 4 2 349 12 1 4 Piniout for CERE RUD Re RIRs ra D d CER KR ede E Rd 350 12 2 38 Mictor JTAG and Trace 1 4 6 351 12 2 1 Connecting the target board eerie eter rera 351 12 2 2 PINOUT 352 12 2 3 Assignment of trace information pins between ETM architecture versions 354 12 2 4 Trace signals 354 12 3 19 JTAG SWD and Trace connector 356 12 3 1 Target power doa 357 12 4 9 pin JTAG SWD 1 1 0 4 4 1 n nnn 358 12 5 cf
63. Following remote commands are available Remote command Explanation elrbp Removes an instruction breakpoint eos Reads or writes from to cp15 register device Select the specified target device s Do not check if an abort occurred after memory read DisableChecks ARM7 9 only Check if an abort occurred after memory read ARM7 9 only 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 memU3 2 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 0 sid E 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 GDB semihosting ARMSWI Sets the SWI number used for semihosting in ARM mode _ Sets the SWI number used for semihosting thumb semihosting ThumbSWI mode setargs Set the arguments for the application setbp Sets an instruction breakpoint at a given address
64. GetU32 Description Gets 32 bits JTAG data starting at given bit position Prototype api int JTAG GetU32 int BitPos 5 10 2 14JTAG WriteClocks Description Writes a given number of clocks Prototype api int JTAG WriteClocks int NumClocks 5 10 2 15JTAG StoreClocks Description Stores a given number of clocks in the DLL JTAG buffer Prototype api int JTAG StoreClocks int NumClocks 5 10 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 determine 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 193 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 191 Prototype 1___ int SYS Sleep int Delayms 5 10 2 18 JLINK_CORESIGHT_AddAP 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 no
65. Halts the CPU Core If successful shows the current CPU registers Syntax halt 3 2 1 16 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 3 2 1 17 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 72 J Link software and documentation package Syntax ip lt Addr gt Parameter Meaning Valid values add IP Address Connects the J Link with the specified IP Address T Host Name Resolves the host name and connects to it Invokes the Emulator selection dialog Example ip 192 168 6 3 3 2 1 18 is This command returns information about the length of the scan chain select register Syntax 3 2 1 19 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 Destination address Required for bin files Example loadfile C Work test bin 0x20000000 3 2 1 20 log Set path to logfile allowing the DLL to output logging informatio
66. J Link 5 eee reete n d nen nen no een Ra 199 5 11 Command strings cerise 200 5 11 1 List of available 5 200 5 11 2 Using command 65 1 eee aa 205 5 12 Switching off CPU clock during 0 mm 207 5 13 Cache handling ent in x utu eh 208 5 13 1 Cache COnerency Y EU YD d MORI 208 5 13 2 Cache clean area de VATER ERR X ER Y VERE LI Ra 208 5 13 3 Cache handling of 7 5 menm 208 5 13 4 Cache handling of ARMO9 208 5 14 Virtual COM Port VCOM 209 5 14 1 Configuring Virtual COM 005 209 b He lA FCW MIO AGIs esis esc cote ce E 211 6 1 TMtrOGUCtON anes hoe ete a dede Sa adi maU e EE 212 6 2 wie 213 6 3 Supported devices 214 6 4 Setup for various debuggers internal 215 6 4 1 TAR Embedded
67. J Link Soft ware Developer Kit SDK on page 138 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 support 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
68. 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 2014 SEGGER Microcontroller GmbH amp Co KG 385 Chapter 16 Glossary This chapter describes important terms used throughout this manual J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 386 CHAPTER 16 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 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 writt
69. KG 310 11 1 Analog Devices J Link has been tested with the following 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 11 1 1 ADuC7xxx 11 1 1 1 Software reset CHAPTER 11 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 ADuC70
70. LMI FTDI Macraigor RDI Third Party Driver With these additional commands the values 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 200 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 329 11 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 51 11 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 11 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 t
71. Leave open on target side Not con nected NC Leave open on target side Data input of target SPI Output of J Link used to transmit ax QUIDUE data to the target SPI 7 5 Output Chip 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 346 Table 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 12 2 38 pin Mictor JTAG and Trace connector 1 provides a JTAG Trace connector This connector is 38 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 densi
72. Link can not identify it anymore there is a spe cial unlock sequence which erases the flash memory 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 2014 SEGGER Microcontroller GmbH amp Co KG 327 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 328 CHAPTER 11 Device specifics 11 11 1 LPC ARM7 based devices 11 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 r
73. Loa J Link 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 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 About Location of contig ma e E 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 2014 SEGGER Microcontroller GmbH amp Co KG 276 CHAPTER 9 ing the OK button Add license 3 The J Link RDI license is now added J Link RDI License management LAO 9 4 4 2 Init tab Macro file RDI
74. NOT be lifted if you would like to use J Link with Keil MDK you need to buy a separate J Link IAR J Link does not sup port kickstart power Licenses No licenses are included 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 60 CHAPTER 2 Licensing 2 5 6 J Trace J Trace is OEM version of J Trace sold by 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 y
75. Parameter Meaning BufferIndex Index of the up channel to sent the string to sFormat Pointer to format string followed by arguments for conversion Table 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 2 Supported flags e Left justify within the field width e Always print sign extension for signed conversions e 0 Pad with 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 10 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 Buff
76. 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 W JTAG Speed Example JTAG Speed 2000 2MHz JTAG speed Pulls reset pin low Releases nRST pin Used to issue a reset of the CPU Value 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 HIG
77. 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 35 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 36 setPC Sets the PC to the specified value J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 77 Syntax setpc lt Addr gt Parameter Meaning Addr Address the PC should be set to Example setpc 0x59C 3 2 1 37 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 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
78. Section Flash download In this section settings for the use of the J Link FlashDL feature and related 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 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
79. Software Sections reordered and updated Chapter Setup Section Using JLinkARM dll moved here V4 71b Rev O 130507 JL Chapter Related Software Section SWO Viewer Added new command line options V4 66 Rev 0 130221 JL Chapter Introduction Section Supported OS Added Linux and Mac OSX V4 62b Rev 0 130219 EL Chapter Introduction Section J Link J Trace models Clock rise and fall times updated V4 62 Rev 0 130129 JL Chapter Introduction Section J Link J Trace models Sub section J link ULTRA updated V4 62 Rev 0 130124 EL Chapter Target interfaces and adapters Section 9 pin JTAG SWD connector Pinout description corrected V4 58 Rev 1 121206 AG Chapter Intoduction Section J Link J Trace models updated V4 58 Rev 0 121126 JL Chapter Working with J Link Section J Link script files Sub section Executing J Link script files updated V4 56b Rev 0 121112 JL Chapter Related Software Section J Link SWO Viewer Added sub section Configure SWO output after device reset V4 56a Rev 0 121106 JL Chapter Related Software Section J Link Commander Renamed Commander script files to Commander files and script mode to batch mode J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By E
80. Windows 7 J Link 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 2 4 2 J Link PLUS J Link PLUS is a USB powered JTAG emulator 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 Licenses Comes with liicenses for Unlimited breakpoints in flash mem ory Unlimited Flash Breakpoints RDI and J Flash J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 54 CHAPTER 2 Licensing 2 4 3 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 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 It connects via USB to a PC running Microsoft Windows 2000 Windows XP Windows 2003 Windows Vista or Windows 7 an J link ULTRA has a built in 20 pin JTAG SW
81. 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 2014 SEGGER Microcontroller GmbH amp Co KG 388 CHAPTER 16 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 memory 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 RD
82. and its state The maximum number of available 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 10 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 10 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 c
83. by the channel BufferSize Size of the buffer in Bytes Flags Flags of the channel blocking or non blocking Table 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 299 10 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 10 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 ConfigUpC
84. 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 2014 SEGGER Microcontroller GmbH amp Co KG 370 CHAPTER 13 Background information 13 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 13 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 system 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 13 4 2 Data download to R
85. 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 2014 SEGGER Microcontroller GmbH amp Co KG 74 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 25 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 26 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 27 ms Measures the number of bits in the specified scan chain Syntax ms lt ScanChain gt Parameter Meaning ScanChain Scan chain to be measured Example ms 1 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 75 3 2 1 28 power This command sets the status of the power su
86. 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 184 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
87. 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 149 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 V3 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 173001008
88. exchanged between different users 3 8 3 Exporting Sampled Data 3 8 3 1 Export to CSV The sampled data which is currently in the buffer can be exported into CSV format to be opened and analyzed by other tools for example spreadsheet programs like MS Excel Apple Numbers or Libre Office Calc by pressing File gt Export Data J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 130 J Link software and documentation package 3 8 4 Symbol Configuration The symbol context menu can be accessed by right clicking the corresponding row in the watch below the graph From the context menu the Y resolution visibility and color of the graph as well as the display as hexadecimal or decimal can be configured When sampling is stopped symbols can be removed or added via the context menu 3 8 5 Short Cuts The Y Resolution of a symbol can be changed be selecting the respective row in the watch and using the and keys The visibility of a symbol can be changed by pressing enter Scrolling through the Graph Window can be done with the mouse wheel Holding control while using the mouse wheel will zoom in and out the time base 3 8 6 GUI Meters and Controls 3 8 6 1 Toolbar e IV I Show Hide the Graph Show Hide Watch Window II Start sampling Stop sampling Pause Resume sampling III Zoom in Zoom out IV Start the target Halt the target
89. exe cuting instructions of the user program It is the recommended reset sequence for Analog Devices ADuC7xxx MCUs and works with these chips only J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 182 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 a
90. file to be programmed is in non bin format hex mot srec the file needs to be converted into binary first There are various free soft J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 223 ware utilities available which allow data file conversion Another possibility is to use J Flash which is part of the J Link software and documentation package For convert ing data files no J Flash license is needed In order to convert a hex mot file into a bin file using J Flash the following needs to be done 1 Start J Flash 2 Click File Open data file to open the data file to be converted in J Flash 3 Click File Save data file as 4 Select Binary file bin as file type so J Flash knows that the file shall be saved as binary bin file 5 Click Save J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 224 6 Flash download 6 6 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 2014 SEGGER Microcontroller GmbH amp Co KG 225 Chapter 7 Flas
91. flash on page 215 Whether flash breakpoints are available can be verified using the J Link control panel x SEGGER J Link 4 35g beta Control panel Using fastest method E Programmed sectors fastest methoc far J verride memory map 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 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 230 CHAPTER 7 Flash breakpoints 7 5 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 choice to use its flash breakpoints J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 231 Chapter 8 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 doc
92. for all debuggers using the J Link RDI configuration dialog 9 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 9 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 d1l 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 9 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 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 275 9 4 4 1 General tab J Link RDI Configuration 24 x General init JTAG Flash Breakpoints CPU
93. 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 186 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
94. in the following figure the TCK and TMS lines of all JTAG device are connected while the TDI and TDO lines form a bus to Device 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 162 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 2014 SEGGER Microcontroller GmbH amp Co KG 163 SEGGER J Flash configuration dialog This dialog box can be found at Options Project settings J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 164 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 at91
95. 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 193 Prototype api int JTAG SetDeviceId int DeviceIndex unsigned int Id 5 10 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 index 0 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 189 Prototype 1___ int JTAG GetDeviceId int DeviceIndex 5 10 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 193 Prototype api int JTAG WriteIR unsigned int Cmd 5 10 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 v
96. is not blocked by any firewall 3 Contact network admin tunnel server J Link Commander cannot connect to 1 Make sure Remote server 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 12 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 51439 gt j link Seq 1 1 192 168 11 31 88 84 155 118 TCP 51439 gt j link PSH ACK Seq 1 192 168 11 31 88 84 155 118 TCP 51439 gt j link PSH ACK Seq 5 88 84 155 118 192 168 11 31 TCP j link gt 51439 Seq 1 Ack 5 88 84 155 118 192 168 11 31 TCP j link gt 51439 ACK Seq 1 Ack 9 88 84 155 118 192 168 11 31 TCP j link gt 51439 PSH ACK Seq 1 A 192 168 11 31 88 84 155 118 TCP 51439 gt j link PSH ACK Seq 9 192 168 11 31 88 84 155 118 TCP 51439 gt j link PSH ACK Seq 13 88 84 155 118 192 168 11 31 j link gt 51439 ACK Seq 5 80 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 120 CHAPTER 3 J Link software and documentation package 3 5 Memory Viewer J Mem displays memory contents of target systems and allows modifications of RAM and SFRs Special Function Reg
97. 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 LED s the EB55 we must apply a i 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_PI0_Set0utput 91 BASE PIOA led_mask i tlhe 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 2014 SEGGER Microcontroller GmbH amp Co KG 259 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 configure the J Link For more information about the generic setup of J Link RDI please refer to Conf
98. 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 does not affect device operation J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 378 14 Designing the target board for trace 14 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 14 1 Signal requirements J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 379 Chapter 15 Support and FAQs This chapter contains troubles
99. no Tracing Cortex M3 M4 ARM7 9 11 No tracing Cortex A5 A8 A9 R4 ARM7 9 11 SUPPRUSE cores COR OMe MOS MSIE Sce 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 Stink Link J Trace 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 license 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 225 2 Most IDEs come with its own flashloaders so in most cases this feature is not essential for debugging applications in f
100. of the CPU is not connected to the reset pin of the JTAG connector Reset strategy 0 is always the recommended one because it 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 hal
101. 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 10 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 listed and explained 5 10 1 1 ResetTarget Description If present it replaces the reset strategy performed by the DLL when issuing a reset Prototype void ResetTarget void 5 10 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 193 Prototype void InitEMU void 5 10 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
102. 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 13 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 13 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 13 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 caches 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
103. rdiserv Connections for a complete list of pos sible arguments Connection Editor EN Comeet K nen J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG CHAPTER 9 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 274 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 E 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 wait O0x18 0 200296 wait Oxla unsigned int waiting time b500 b084 f7rrttas for waiting time 0 waiting time lt LedSpeed waiting_time 2000 e000 30
104. 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 Configure 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 2 GDB remote commands J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 90 J Link software and documentation package 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 z 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 3 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 4 amp are comments and not used in GDB GDB Server Lines
105. 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 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 12 4 Command List J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 349 12 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 not Notused 11 e 12 GND essential for JTAG SWD in general swo 13 14 GND RESET 159 16 GND The following table lists the J Link J Trace SWD j LinkRx 17 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
106. support means support for a 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 167 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 36MH
107. the CPU costs typically multiple millisec onds For this reason most debuggers do not even allow memory access if the CPU is 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
108. 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 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 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 insid
109. the devices in the JTAG chain On some targets this disables access to the core Prototype void InitTarget void 5 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 188 CHAPTER 5 Working with J Link and J Trace 5 10 2 1 MessageBox Description Outputs a string in a message box Prototype 1___ int MessageBox const char sMsg 5 10 2 2 MessageBox1 Description Outputs a constant character string 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 10 2 3 Report Description Outputs a constant character string on stdio Prototype 1___ int Report const char sMsg 5 10 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 Reporti const char sMsg int v 5 10 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 has
110. 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 automatically 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 2014 SEGGER Microcontroller GmbH amp Co KG 111 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
111. to address 0 by writing the MEMMAP register of the LPC This reset strategy is the recommended one for all ARM 7 LPC devices J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 183 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 i
112. 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 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 348 Table 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 348 12 Target interfaces and adapters 12 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 347 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 12 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 12 1 2 3 Target power supply Pin 19 of the connector can be used to
113. used J Link have simply open the J Link commander JLink exe The 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 2613 M 1 FlashDL JFlash with ID x2BA61477 M4 r8pi Little endian BP slots and 2 literal slots Total IRLen 4 ied Target interface speed 100 kHz J Link gt m 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 227 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 2014 SEGGER Microcontroller GmbH amp Co KG 52 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 rights title and interest in the software are and sh
114. used to sent instrumentalized event tracing data The data log file contains 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 2014 SEGGER Microcontroller GmbH amp Co KG 10 3 1 6 Menus and Shortcuts 295 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 Alt 0O 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 vicc ci 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 o
115. where no specific 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 2014 SEGGER Microcontroller GmbH amp Co KG 174 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 149 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 p
116. 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 65 3 CAWorkULinkARM Output ReleaseULink exe 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 J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 210 CHAPTER 5 Working with J Link and J Trace J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 211 Chapter 6 Flash download This chapter describes how the flash download feature of the DLL can be used in dif ferent debugger environments J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 212 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 f
117. width Tsh 2 5ns E Data setup high Table 12 9 Clock frequency J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 355 Parameter Min Max Explanation Thh 1 5ns Data hold high Tsl 2 5ns Data setup low Thl 1 5ns x Data hold low Table 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 356 12 Target interfaces and adapters 12 3 19 JTAG SWD and Trace connector J Irace provides JTAG SWD Trace connector This connector is a 19 pin connector It connects to the target via an 1 1 cable VTref 1 2 SWDIO TMS GND 3 4 SWCLK TCK GND 5 6 SWO TDO 7 8 TDI NC 9 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
118. 00 Type Implementation Hard 2 Addr 0208000206 Type Any Implementation Hard 3 Addr 0208000220 Type Implementation Hard 4 Addr 0 0800023 Any Implementation Hard 5 Addr 008000286 Implementation Hard 6 Addr 008000266 Implementation Hard J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 228 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 2014 SEGGER Microcontroller GmbH amp Co KG 229 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 CFI flash For more information about how to setup various debuggers for flash download please refer to Setup for various debuggers internal
119. 000000 R13 00200000 R14 00000000 SPSR 00000010 SVC R13 002004E8 R14 0010025C SPSR 00000010 ABT R13 00200100 R14 00000000 SPSR 00000010 IRQ R13 00200100 R14 00000000 SPSR 00000010 UND R13 00200100 R14 00000000 SPSR 00000010 3 3 3 17 reset Syntax reset Description 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 lt Resetting target 3 3 3 18 semihosting breakOnError Syntax semihosting breakOnerror lt Value gt J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 96 CHAPTER 3 J Link software and documentation package 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 VectorAddr Description Enabl
120. 004 2014 SEGGER Microcontroller GmbH amp Co KG CHAPTER 13 Background information 13 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 13 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 V498elLink 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 0 9 20 00096 s GDB RDI FlashBP 1 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 13 5 2 Invalidating the firmware Downdating J Link J Trace is not performed automatically through an old JLinkARM dll J Link J Trace wi
121. 01 4922 680b 4298 d3fa b004 beos 4718 PUSH SUB BL MOV ADD LR SP SP 16 xffffffaB 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 2014 SEGGER Microcontroller GmbH amp Co KG 271 9 3 5 KEIL pVision IDE 9 3 5 1 Software version J Link has been tested with KEIL 3 34 There should be no problems with other versions of KEIL uVision All screenshots are taken from MDK 3 34 9 3 5 2 Configuring to use J Link RDI Start KEIL uVision and open the project Blinky p ision3 C Keil3030 ARMARY30 B oards Keil MCB 2300 Blinky Abstract txt es Hi LPC2378 Flash A The Blinky project is a simple program for the LPC2378 using Keil MCB2300 Evaluation Board and demonstrating interrupt functionality Example functionality 9 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 conversion every 1 and displa
122. 014 SEGGER Microcontroller GmbH amp Co KG WWW Segger com 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 CNE 0 Delay 100 Cnt while 1 return 0 fORCKCKCKk kc kckck c kckckckckckckckckckckck ck ckckckck EK End of file XCKCkckckckck kck ck ck ck ckckckck ck KKK KEK KK KKK J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 10 6 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 SEG
123. 02942 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 003154 0 0800 5 4 003189 003193 0 080083 8 003201 0 0800 amp 003203 003224 0 0800 00 003226 0 0800837 003241 0 0800 06 003243 0 08008334 003260 0 0800 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 Ox080082AC 003371 003372 8 003375 0800088 GetFlagstatus _ 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_GetFla
124. 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 344 CHAPTER 12 Target interfaces and adapters 12 1 20 pin J Link connector 12 1 1 Pinout 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 2 NC nTRST 3e 4 GND TDI 5e 6 GND TMS 7e es 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 nTRS
125. 1 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 2014 SEGGER Microcontroller GmbH amp Co KG 152 CHAPTER 4 The following screenshot shows the connectio
126. 1 51 via DLL Mode Little Endian J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 268 CHAPTER 9 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 05 Delay 200 00000150 00001F60 0000B63C 00001 50 00000000 00000000 00000000 00000000 00002890 00000000 00000515 0000 5 0 00001 85 00000514 CPSR 000000 3 05_ Initially disable interrupts 05 InitKern initialize 08 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 z ace eet ee main_led c 00000000 0xESSFF018 0 59 018 0 59 018 0 59 018 Instr MAIN LED 35 0 00000010 0 59 018 OxE1A00000 0 59 014 0 59 014 00000020 0 00002584 0 0000003 0 00000040 0 00000044 00000030 0 00000048 0 00002300 0 0000004 OXEAFFFFFE 00000040 OxEAFFFFFE OxEAFFFFFE OxEAFFFFFE 00000050 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 a
127. 130 0004 Data 060 234 0001 ARM ReadMem 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 8 0 00000000 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
128. 170 5 5 3 Things you should be aware nemen 171 5 6 Connecting multiple J Links J Traces to your PC 173 5 6 1 HOW dOESSIE rera 173 5 7 J Link control nana ne 175 5 7 1 TADS 175 5 8 Reset strategies 181 5 8 1 Strategies for ARM 7 9 nnn nnn 181 5 8 2 Strategies for Cortex M 050 183 5 9 Using DCC for memory 186 5 9 1 What is required esce dv eve cerva ex e vc kA EY a c dc wo ye 186 5 9 2 Target DEC handler tot reco t i tr ert tee ox deed T RR DR Eel eens 186 5 9 3 Target DCC abort Handler enne Fa x xn en n RA da 186 5 10 JFLIN KE SCRIPETICS erm 187 5 10 1 Actions that be customized 080 187 5 10 2 Script file APL fUNCtIONS 187 5 10 3 Global DLL variables eer ae de eee uo et dee eee XR a eee 193 5 10 4 Global DEL CONSTANTS derindir aiina a a Co ie Ad pex 196 5 10 5 Script file language rere esti iy dua eoe vd eom er lave RE pra Er es 198 5 10 6 Script file writing example 12 666 nnn nnn 199 5 10 7 Executing
129. 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 7 02 04 19 2011 16 37 2011 Sep 6 16 37 2011 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 16 37 2011 Sep 6 16 37 2011 Jul 26 17 24 Old 2004 2014 SEGGER Microcontroller GmbH amp Co KG 150 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 2014 SEGGER Microcontroller GmbH amp Co KG 15
130. 2 5 46 80 R4 0 400 08000866 0002 NVIC PriorityGroupconfig o 08000868 R4 0 300 vIC PriorityGroupconfig 1 NVIC PriorityGroupconfig 2 N 5 46 boos F5B46FC0 0008 08000850 08000854 08000856 0800085 0800085 FSB46FAO 0005 5 1 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 002832 002836 002871 002875 002883 002885 002906 002908 002923 002925 002942 002944 002959 002961 002985 002987 002009 003011 003031 003033 003053 003054 003057 003075 0 0800 5 4 0 0800 080085 4 0 0800 0 080085 4 008008544 0x0800BEBE 080085 4 0 0800 0 080085 4 00800854 008008544 0 0800 0 080085 4 008008544 0 0800 0 080085 4 0 0800 0 080085 4 0 080085 4 0 0800 oxosooBecs OxOB00B3EC 0x0800BED0 0x0800837C 0 0800 06 0 08008334 Ox0800BEDE 0 080082 4 0x0800BEE4 0 0800070 0 0800
131. 25x32 Analog ADuC7025x62 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 311 Analog ADuC7026x62 Analog ADuC7027x62 Analog ADuC7030 Analog ADuC7031 Analog ADuC7032 Analog ADuC7033 Analog ADuC7128 Analog ADuC7129 Analog ADuC7229x126 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 312 11 2 ATMEL CHAPTER 11 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 915 1 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 2014 SEGGER Microcontroller GmbH amp Co KG 313 e AT91SAM7XC512 e 915 9 128 e 1915 9 256 11 2 1 AT91SAM7 11 2 1 1 Reset s
132. 3 11 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 target device is actually an LPC 2xxx and have a device based license 3 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 134 CHAPTER 3 J Link software and documentation package 3 12 Processor specific tools The J Link software and documentation package includes some tools which support processor specific functionalities like unlocking a device 3 12 1 J Link STR91x Commander Command line tool
133. 32F1032G Select CPU frequency kHz 72016 Measure f 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 to listen to 1 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 13 Available command line options 3 7 2 4 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 dev
134. 4 J Link J Trace UM08001 FLASH Ha fCycleAccesscmd u32 FLASH PrefetchBufferCmd u32 NVIC setVectorTable u32 u32 2004 2014 SEGGER Microcontroller GmbH amp Co KG 369 13 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 been reached 2 J Link ARM SEGGER J Link Commander U3 72c for help gt Compiled Jul 4 2007 26 17 14 DLL P 2 compiled Jul 4 2007 20 17 09 Firmware J Link compiled Jun 14 2007 14 36 33 ARM Rev 5 Hardware U5 38 S N 1 Features gt RDI FlashBP FlashDL JFlash GDB U kHz 0 0 41069264 ARM x1D192192 1 lt 9 8 data comp MM CETBL x 61 gt 1 9 01 1 88888800 lt x82 1 gt agp 211512121215 66800680 668006080 J 32 gt DCache 32kB 4 256 32 gt 4 counters sequencer The result of the limited buffer size is that not more data
135. 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 2014 SEGGER Microcontroller GmbH amp Co KG 215 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 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 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 loade
136. 79 Parameter Meaning Port Valid values 0 3 Example usb 3 2 1 44 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 45 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 46 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 2014 SEGGER Microcontroller GmbH amp Co KG 80 J Link software and documentation package 3 2 1 47 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 Name of memory zone to access Addr Start address Data 32 bits of data to write Example w4 0x0 OxAABBCCFF 3 2 1 48 wreg Writes into a reg
137. 8 o o I zio o 11 sm to Address 0 000000 xi 12 0x0 9 0x00000000 04 0 1f eS Bc 00 10 00 60 00 9f 5 Of 0 a0 el xi e5 e0 1 a sp 0x2004 0 2098416 CAT A arm Example Vend 0 00000010 10 ff 2f 1 58 10 Sf eS SB 20 9f e5 58 30 SF eS Code C Tool C emIDE V21 arm Example Vend 0x00000020 00 52 ei 04 00 91 34 04 00 82 34 fb ff ff 0x00000030 48 10 9f e5 48 20 9f e5 00 30 a0 e3 02 00 51 H i 0 00000040 04 30 81 14 fc ff ff 1a 00 00 OF el cO 00 c0 0 a a cpsr 0x60000013 SVC mode ARM 1610612755 0x00000050 00 0 29 1 00 00 a0 00 10 a0 24 20 9 5 0x00000060 Of eO a0 el 12 ff 2f el fe ff ff ea le ff 2f 1 0 00000070 00 10 00 60 02 10 00 00 00 20 00 00 00 20 00 0 00000080 00 00 20 00 00 00 20 00 28 02 10 00 db 0 21 5 Variable Value 0x00000090 2c 40 9f eS 47 0 21 e3 28 40 9f e5 41 0 21 Bi enc 0x00000000 0x000000a0 24 40 9f e5 d2 0 21 e3 20 40 9f e5 d3 0 21 0x000000b0 1 dO Sf e5 1 00 9f 5 Of 0 a0 el 10 ff 2f 1 D 0x000000c0 fe ff ea 00 01 20 00 00 01 20 00 00 00 20 00 p i 0x000000d0 00 01 20 00 00 05 20 00 08 00 10 00 10 30 9f eS 0 000000 0 02 29 a0 00 20 83 5 01 30 a0 03 00 a0 1 0 000000 0 1e ff 2f 1 44 fd ff f
138. 83 9 5 3 Implementation of semihosting in J Link RDI seem 284 9 5 4 Semihosting With AXD ner eed eel e Ra E e Fe d o eR ia 284 9 5 5 Unexpected Unhandled 5 16 50 0 0 2 2 285 UE LIMIT 287 10 1 288 10 2 HOW RIET WOEKS PUE kr Een RA EE Ea 289 10 2 1 Target implementation iiec de traer des nene d rn n ed x E eae a PA E 289 10 2 2 Locating the Control rie ee Xetra ex Re ER e EP ERE ERR RE CRI pe 289 10 2 3 Internal structures or docere rogo EY esca WEAR ETE AXE RUN CR OU 289 10 2 4 Requitrements iste exu sie dew eet ea ne ew eins rx a Ex xr ceases bre eer EAR Y ER ER EE un 290 10 2 5 Performartice ucc ec a n oO RUE X Ra ex XR e VC o e ER GR ECKE Ex 291 10 2 6 Memory footpriht 2 eese apr e Er BERN ERR TER an xa prs 291 10 3 RT ComMuUR Caton xia duca wer li le 292 10 3 1 REIR MT 292 10 3 2 BET ee 297 10 3 3 RTT Logger ertet 297 10 3 4 RTT in other host applications nnnm emen nnn 297 10 4 IMplemMentatiOn teet 298 10 4 1 APL f nctions aan daa x ne xo ero x ER D NR ee ROC e RE 298 10 4 2 Configuration defin s a cei seid eei ee n torn i EX ERR e e Len
139. AA R9 Ri6 66666606 Rii R12 0020208080 R14 88080808888 10000036 66000600 R14 800188708 2000007 66600806 Ri4 80080080 gt R FQGGGGF9 00202840 Ri4 gt R 888080887F A 4 m 256 KB flash 64 KB RAM Loading binary tile pin 1 Writing bin data into target mem Info J Link Flash download F1 programming performed for 1 range 16384 byt AM Info J Link Flash download 1 time needed 0 8445 Prepare 0 1165 Compar e 8 0205 Program 654s Verify 8 815s Restore 8 837s5 J Link 6 4 5 2 Converting non bin files As previously mentioned J Link Commander supports programming of bin files into flash memory If the data file to be programmed is in non bin format hex mot srec the file needs to be converted into binary first There are various free soft ware utilities available which allow data file conversion Another possibility is to use J Flash which is part of the J Link software and documentation package For convert ing data files no J Flash license is needed In order to convert a hex mot file into a bin file using J Flash the following needs to be done 1 Start J Flash 2 Click File Open data file to open the data file to be converted in J Flash 3 Click File Save data file as 4 Select Binary file bin as file type so J Flash knows that the file shall be saved as binary bin file 5 Click Save J Link
140. AC7122 MAC7126 MAC7131 MAC7136 MAC7141 MAC7142 MK10DN512 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 11 6 1 Kinetis family 11 6 1 1 Unlocking 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 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 320 11 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 40 and K60 devices which is pre configured for the TWR 40 and TWR 60 eval boards a
141. AM 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 13 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 Link 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 13 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 13 4 4 1 J Flash Complete flash programming solution J Flash is a stand alone Windows application which can read write data f
142. C Delay 200 Write32 OxFFFFFC30 Write32 OxFFFFFF60 SetJTAGSpeed 12000 0xA5000004 0x00008000 0x00000601 0x00191C05 0x00000007 0x00320300 11 2 2 AT91SAM9 11 2 2 1 JTAG settings We recommend using adaptive clocking 315 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 2014 SEGGER Microcontroller GmbH amp Co KG 316 11 Device specifics 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 317 11 4 Ember For more information please refer to Silicon Labs on page 333 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 318 11 Device specifics 11 5 Energy Micro For more information please refer to Silicon Labs on page 333 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 319 11 6 Freescale J Link has been tested with the following Freescale devices MAC7101 MAC7106 MAC7111 MAC7112 MAC7116 MAC7121 M
143. CNUIC PriorityGroup priorit 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 RIRCR 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 amp Output Return E NUIC_Init lt NUIC_InitTypeDef NUIC_InitStruct gt 318 u32 tmppriority 0 00 tmpreg 0x00 tmpmask 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 2_ 1 _ 1 I2 Channel3 IRQHandler 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 0 700 NVIC PriorityGroupconfig o R4 0 600 NVIC PriorityGroupconfig 0 R4 0x500 08000860 EQ 2 NVIC PriorityGroupconfig o 0800086
144. Channel DCC semihosting The S bit in vector_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 9 5 4 1 Using SWls 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 2014 SEGGER Microcontroller GmbH amp Co KG 285 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 286 CHAPTER 9 RDI J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 287 Chapter 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 288 CHAPTER 10 RTT 10 1 Introduction Wi
145. Client will ignore them 10 3 1 8 Using Text Control Codes RTT allows 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 2014 SEGGER Microcontroller GmbH amp Co KG 297 10 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 Docume
146. D connector f Licenses um Unlimited breakpoints in flash memory Unlimited Flash Break points RDI and J Flash 2 4 4 J Link PRO J Link PRO is a JTAG emulator designed for ARM cores It con nects via USB or Ethernet to a PC running Microsoft Windows 2000 Windows XP Windows 2003 Windows Vista or Windows 7 J Link has a built in 20 pin JTAG connector which is compat ible with the standard 20 pin connector defined by ARM Licenses Comes with built in licenses for all J Link related software prod ucts J Link FlashDL FlashBP RDI J Link GDB Server and J Flash J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 55 2 4 5 J Trace J Trace 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 Windows XP Windows 2003 Windows Vista or Windows 7 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 connector and 38 pin con nector defined by ARM Licenses Comes with built in licenses for flash download 2 4 6 J Trace for Cortex M J Trace for Cortex M is 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 Licenses Comes with built in licenses for all J Link related software products eUnlimited flash breakpoints
147. D 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 161 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 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 indica
148. DCC abort handler a simple assembly file can be included in the appli cation The DCC abort handler allows data aborts caused 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 187 5 10 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
149. DbgPowerDownOnClose Used to power down the debug unit of the target CPU when the debug session is closed SetSysPowerDownOnIl dle Used to power down the target CPU when there are no transmissions between J Link and target CPU for a specified timeframe 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 Table 5 12 Available command line options J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 201 5 11 1 1 device This command selects the target device 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 214 Example device AT91SAM7S256 5 11 1 2 DisableFlashBPs This command disables the FlashBP feature Syntax DisableFlashBPs 5 11 1 3 EnableFlashBPs This command enables the FlashBP feature Syntax EnableFlashBPs 5 11 1 4 map 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 report
150. EPROM data set size already configured return v FCCOB7 IFR offset OxFC if v OxFF FlexNVM partition code already configured return Configure EEPROM size 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 2014 SEGGER Microcontroller GmbH amp Co KG 322 11 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 11 Device specifics 2004 2014 SEGGER Microcontroller GmbH amp Co KG 323 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 324 11 9 Infineon CHAPTER 11 Device specifics J L
151. ER En Exe HER EE ax 383 15 4 Frequently Asked nnn 384 16 GOSS ET 385 17 Eterature and references uianso odd edo CE Yd EUR QUO Doa eb Rd 391 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 22 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 23 Chapter 1 Introduction This chapter gives a short overview about J Link and J Trace J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 24 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 25 Target System A target system with a supported CPU is 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 27 J Link J Trace UM08001 2004 2014 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 Windo
152. ER Microcontroller GmbH amp Co KG 108 CHAPTER 3 J Link software and documentation package 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 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 nologtof
153. 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 which 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 2014 SEGGER Microcontroller GmbH amp Co KG 227 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 49 7 2 1 Free for evaluation and non commercial use
154. For new Firmnwar ion 04 98 5 2615 11 08 52 J Link U9 compiled fipr 2 J Link U compiled Apr 21 2615 18 18 48 J ink U9 compiled APR 21 2615 18 16 46 In the screenshot J Link J Trace UM08001 The red box identifies the new firmware The green box identifies the old firmware which has been replaced 2004 2014 SEGGER Microcontroller GmbH amp Co KG 373 374 CHAPTER 13 Background information J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 375 Chapter 14 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 2014 SEGGER Microcontroller GmbH amp Co KG 376 14 Designing the target board for trace 14 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 14 1 1 Avoiding stubs Stubs are short p
155. G 78 J Link software and documentation package 3 2 1 39 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 40 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 41 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 42 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 43 usb Closes any existing connection to J Link and opens a new one via USB It is possible to select a specific J Link by port number J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Syntax usb lt Port gt
156. G SWD interface available Target power supply via pin 19 of the JTAG SWD interface up to 300 mA to tar get with overload protection alternatively on pins 11 and 13 of the Cortex M 19 pin trace connector J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 43 1 5 Supported CPU cores J Link J Trace has been tested with the following cores but should work with any 7 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 2014 SEGGER Microcontroller GmbH amp Co KG 44 CHAPTER 1 Introduction 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
157. GER RTT aware is used then J Link searches for the ID in the known target 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 and 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 doe
158. GHT AddAP Example JLINK CORESIGHT AddAP 0 CORESIGHT AHB AP JLINK CORESIGHT AddAP 1 CORESIGHT APB AP JLINK CORESIGHT AddAP 2 CORESIGHT APB AP Use third AP as APB AP for target communication CORESIGHT IndexAPBAPTOUse 2 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 MAIN ResetType R Example if MAIN ResetType 2 Laced else seed Used to check 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 MAIN_IsFirstIdentify if MAIN IsFirstIdentify 1 R else Table 5 11 Global DLL variables 5 10 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 10 4 1 Constants for global variable CPU The following constants can be used to set the global DLL variable cpu ARM7TDMI ARM7TDMIR3 ARM7TDMIR4 ARM7TDMIS ARM7TDMISR3 ARM7TDMISR4 ARM9 ARM9TDMIS ARM920T ARM922T ARM926EJS ARM946EJS J Link J Trace UM08001 2004 2014 SEGGER Microcontroller Gm
159. GmbH amp Co KG 114 CHAPTER 3 J Link software and documentation package 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 115 3 3 5 33 xc Descripti
160. GmbH amp Co KG 70 J Link software and documentation package 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 11 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 FileName a Offset NumBytes 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 12 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 FileName Parameter Meaning FileName Source file name to read from the Flasher Example fsize Flasher dat 3 2 1 13 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 a
161. H R W Table 5 11 Global DLL variables J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 195 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 nitEmu does not have any effect Example void InitEmu void EMU ETB IsPresent 1 EMU ETB IsPresent J Uses ETB instead of RAWTRACE capability of the emulator Setting this variable in another func EMU ETB UseETB tion as InitEmu does not have 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 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
162. I flash or manually enter the flash parameters 5 Save the project File gt Save Project and test it J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 248 CHAPTER 8 J Flash SPI 8 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 249 8 7 Device specifics This chapter gives some additional information about specific devices 8 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
163. I 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 device 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 2014 SEGGER Microcontroller GmbH amp Co KG 389 TDO The electronic signal output from a TAP controller to the data sink downstream Usually this is seen co
164. ILY RX600 Pre select Renesas RX600 as CPU core Table 3 9 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 option 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 2014 SEGGER Microcontroller GmbH amp Co KG 107
165. J Link J Trace User Guide TUA Software Version V5 00 Manual Rev 0 Date June 8 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 tradem
166. 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 File Localhost only GDB waiting for connection Initial SWD speed 4000 kHz Stay on top Show log window J Link Connected j Current SWD speed 4000 kHz Generate logfile Cache reads CPU 5 32 41 3 30 i Little endian Verify download Init regs on start 0 Bytes downloaded 1 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 1og 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 window Generate logfile If checked a log file with the GDB GDB Server 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 d
167. 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 0x40012004 0x444B4BB4 GPIOG high config NE2 gt output w4 0xA0000008 0x00001059 CS control reg 2 16 bit write enable Type NOR flash w4 0 000000 0x10000505 CS2 timing reg read access w4 0 000010 0x10000505 CS2 timing reg write access speed 4000 mem 0x64000000 100 loadbin C STMB672_STM32F103ZE_TestBlinky bin 0x64000000 mem 0x64000000 100 6 5 3 1 Converting non bin files As previously mentioned J Link Commander supports programming of bin files into flash memory If the data
168. 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 refer to J Link script files on page 187 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 2014 SEGGER Microcontroller GmbH amp Co KG 112 CHAPTER 3 J Link software and documentation package 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 t
169. 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 V4 82 Rev 0 140218 JL Chapter Related Software Section GDB Server Command line option notimout added J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation V4 80f Rev 0 140204 JL Chapter Related Software Section GDB Server Command line options and remote commands added V4 80 Rev 1 131219 JL NG Chapter Related Software Section GDB Server Remote commands and command line options description improved Several corrections V4 80 Rev 0 131105 JL Chapter Related Software Section GDB Server SEGGER specific GDB protocol extensions added V4 76 Rev 3 130823 JL Chapter Flash Download Replaced references to GDB Server manual Chapter Working withc J Link Replaced references to GDB Server manual V4 76 Rev 2 130821 JL Chapter Related Software Section GDB Server Remote commands added V4 76 Rev 1 130819 JL Chapter Related Software Section SWO Viewer Sample code updated V4 76 Rev 0 130809 JL Chapter Related
170. M on page 209 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 348 Table 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 350 12 Target interfaces and adapters 12 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 221 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 GND The following table lists the pinout for the SPI inter 5y 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
171. Open Debug Configurations 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 2014 SEGGER Microcontroller GmbH amp Co KG 156 STM32F103ZG 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 Iron Python Run eV Tron Python unittest Java Applet 3 Java Application CHAPTER 4 Setup MCBSTRS Evaluation Board E d Jython unittest B Launch Group 0 PyDev Django 43 PyDev Google App Run Python Run Pytho
172. P 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 tmsz1 tms 0 ime Exit2 DR tms 0 Exit2 IR tms 1 tms 1 Update IR tms 1 tms 0 Update DR M 13 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 controller 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 2014 SEGGER Microcontroller GmbH amp Co KG 364 CHAPTER 13 Background information Exit1 DR Temporary controller state
173. Post parameters describe which device inside the JTAG chain is currently selected for communication For SWD The JTAG 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 Simple setup where we have TDI 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 LINK CORESIGHT Configure C J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 192 CHAPTER 5 Working with J Link and J Trace 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 REG CTRL STAT Report1 DAP CtrlStat v Known setup parameters Parameter Type Expl
174. Prototype int SEGGER RTT WaitKey void Return value gt 0 Character which has been read 0 255 Example int c 0 do c SEGGER RTT WaitKey while c c 10 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 304 CHAPTER 10 RTT 10 4 2 Configuration defines 10 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 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 RT
175. RPre gt DRPost DRPost IRPre IRPre 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 3 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 136 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 V498eULinkSTM32 exe 15 SEGGER J Link Unlock tool for STM32 devices Compiled May 5 2615
176. S RO 0800 8 FOOIFAEB BL SytTick countercmd APB2Peri PIOA RCCCAPB2Periph GPIOG DISABLE 0800 0 2100 wovs R1 0x0 OSODBFDE F44F7082 MOV RO 0 104 0800 2 F7FFFASO BL RCC_APB2PeriphResetcmd APB2Periphclockcmd RCC_APB2Periph GPIOA RCC APB2Periph GPIOG ENABLE 0800 6 2101 wovs 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 GPIO Speed 50MHz 367 2004 2014 SEGGER Microcontroller GmbH amp Co KG 368 CHAPTER 13 Background information Embedded Workbench IDE SCB gt HFSR xFFFFFFFF3 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 GROUP
177. STRAGE RE aed 102 SUuppOFt iier 379 385 Supported flash devices 214 215 221 228 SWI nx Rer YR IY 388 Syntax conventions used 13 T TADS xir re X EVI END 175 TAP Controller 2 4 2 22 388 Takget r EE PATRES ERE ee 388 TK GER 344 388 TEP LIB oci ceo tr RD e Uode RR EXE 239 TDI serve tester E 344 388 zio 344 389 Test Access Port TAP 389 Transistor transistor logic TTL 389 U USB rendir P 239 Watchpoint RID DR ES 389 WOT Er EE 389 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Mouser Electronics Authorized Distributor Click to View Pricing Inventory Delivery amp Lifecycle Information Segger Microcontroller J Link PRO J Trace for Cortex M J Link ULTRA
178. T IN RAM Indicate the whole application is in RAM to prevent falsly identifying the RTT Control Block in the init segment by defining as 1 10 4 2 2 Channel buffer configuration SEGGER RTT MODE BLOCK IF FIFO FULL SEGGER RTT NO BLOCK SKIP SEGGER RTT NO BLOCK TRIM 10 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 2014 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 305 2004 2014 SEGGER Microcontroller GmbH amp Co KG 306 10 RTT 10 5 Example code ER ke he KERR EEE ERE KEKE RE 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 2
179. T of the target CPU This pin is normally pulled HIGH on the target to avoid unintentional resets when there is no connection 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 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 12 1 J Link J Trace pinout J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 345 PIN SIGNAL TYPE Description Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is typi
180. 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 signal 5 Assignment of trace information pins between ETM archi 31 Trace signal 16 tecture versions on page 354 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 12 7 JTAG Trace connector pinout J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 354 CHAPTER 12 Target interfaces and adapters 12 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 0 Trace signal 5 TRACEPKT 0 TRACEPKT 0 Logic 0 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 Trac
181. UFreq 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 fail SWOFreq has to be a quotient of the CPU and SWO speeds and their prescalers To get available speed use SWO GetSpeedInfo 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 0 1 0 lt 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 lt SWO enabled succesfully Configure SWO for stimulus ports 0 255 fixed CPU and SWO frequency gt monitor SWO EnableTarget 72000000 6000000 OxFF 0 lt SWO enabled succesfully 3 3 3 30 SWO GetMaxSpeed Syntax SWO GetMaxSpeed lt CPUFrequency Hz gt 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 lt Maximum supported SWO speed is 6000000 Hz J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 100 CHAPTER 3 J Link software and documentation package 3 3 3 31 SWO GetSpeedinfo Syntax SWO GetSpeedInfo Description Prin
182. V3 58c on your 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 installation path C Program Files SEG GER JLinkARM_V lt VersionNumber gt or choose an alternative location Confirm your choice with the Next gt button A Choose Destination Location Setup will install J Link ARM V3 58c in the following folder To install into a different folder click Browse and select another folder You can choose not to install J Link ARM V3 58c by clicking Cancel to exit Setup Destination Folder CN ASEGGERMLink amp RM 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 x Choose options for creating shortcuts Create e
183. 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 HCLK 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 GPIO InitStructure GPIO Mode GPIO Mode IN FLORTING GPIO InitStructure GPIO Speed GPIO Speed 5UMHz GPIO Init Bi PORT amp GPIO_InitStructure gt 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 gt 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 0
184. a multi core environment does 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 2014 SEGGER Microcontroller GmbH amp Co KG 170 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 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
185. able oon ReadData 0 WritePage oon p ReadFast on 0 EraseSector oon lo ReadStatus o0 EraseBulk oon WiiteStatus poo Instruction Address bytes Global Settings 241 Global settings are available from the Options menu in the main window 8 4 2 mmm Operation Auto mode affects EES Es 2 211 Disconnect after each operation Automatically unlock sectors if necessary Perform blank check before program Skip blank areas on read Logging General log level Level 2 5 4 Enable J Link logfile E Program Files x86 SEGGER JLink_V49 E Enable J Flash logfile E3Proaram Files x86 SEGGER JLink_V 49 Projects Save Project file on close Cancel 1 Operation You may define the behavior of some operations such as Auto or Program amp Ver ify 8 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 peration J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 242 CHAPTER 8 J Flash SPI 8 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 8 4 2 1 3 Perform blank check If this option is checked a blank check is performed before any program operation to
186. ad of 10 kOhm VoH gt 90 of For 3 6 lt Vie lt 5V LOW level output voltage with a load of 10 kOhm VoL lt 20 of VIF HIGH level output voltage with a load of 10 kOhm VoH gt 80 of VIF JTAG SWD Interface Timing SWO sampling frequency Max 100 MHz Data input rise time T qi lt 20ns Data input fall time T qj lt 20ns Data output rise time Trao Trdo lt 10ns Data output fall time lt 10ns Clock rise time Trc lt 3ns Clock fall time lt 3ns Analog power mea surement interface Sampling frequency 50 kHz Resolution 1 mA Table 1 2 J link ULTRA specifications 1 3 4 J Link PRO J Link PRO is a JTAG emulator designed 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 comes with licenses for all J Link related SEGGER software 1 3 4 1 Additional features 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 i Comes with web interface for easy built in web server Serial Wire Debug supported Serial Wire Viewer supported Comes with built in licenses for
187. ain with multiple devices The JTAG scan chain 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 2014 SEGGER Microcontroller GmbH amp Co KG 279 9 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 fo
188. all remain with SEGGER For details please refer to the license agreement which 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 2014 SEGGER Microcontroller GmbH amp Co KG 53 2 4 Original SEGGER products The following products are original SEGGER products for which the use of the J Link software is allowed 2 4 1 J Link J Link is a JTAG emulator designed for ARM cores It connects via USB to a PC running Microsoft Windows 2000 Windows XP Windows 2003 Windows Vista or
189. ally Simply enable the checkbox left to the IAR installation which has been found Click Ok in order to update the JrinkARM dll 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 C T 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
190. anation 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 switching sequence etc once JLINK CORESIGHT Configure completes 5 10 2 20JLINK_CORESIGHT_ReadAP 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 JLINK CORESIGHT ReadAP JLINK CORESIGHT AP REG DATA Report1 DATA v 5 10 2 21JLINK_CORESIGHT_ReadDP 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
191. and documentation package 3 7 J Link 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 0 e m x 16 15 if guy 0 Stop Clear 31 24 23 Data from stimulus HEREEERBR 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 E Loops sec 4485 IE 4 r Device STM32F103ZG CPUFreq 72016 kHz SWOFreq 6000 kHz 2984 bytes 3 7 0 4 J Link SWO Viewer CL Command line only version of SWO Viewer 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 CAProgram Files 686 SEGGERULinkARM V478jULinkSWOViewerCL exe 2 a SEGGER J Link SWO Viewer Compi
192. and line options 6 66 104 3 3 6 Programi termination einer pei dien ed RT 115 3 4 J LINK Remote Server us E exe EE rur Rees 116 3 4 1 List of available 5 1 1 1 4 116 3 4 2 TUNNELING MOE ep PARERE fave deg IE 117 3 5 J Mem M motry MVI amp WOFLc eter i E Uer Mie ee see 120 3 6 JsElasI set ee ed o cae ts Ua hts Wha usus EE 121 3 7 J Link SWO VIeWGF inrer exe Erde m xx Ee x end mi a e DER OR n I uda ee v 122 3 7 1 Lodge couette ent err RID E 123 3 7 2 List of available command line options mmm 123 3 7 3 Configure SWO output after device 125 3 7 4 Target example code for terminal output sess mnn 125 3 8 2 5 eae 128 3 8 1 Getting Started sped sou tore RU oed e ante Saad af oe cu Me ase 128 3 8 2 Maei semul M PUER 129 3 8 3 Exporting Sampled Data ec oe rex prete Dodo oe e de a e V ue e i 129 3 8 4 Symbol Configuration 7 1 1 nen 130 3 8 5 M FR 130 3 8 6 GUI M
193. and the value of the CPU registers are shown 13 J Link ARM 0 00100 8 0 00000000 5 7 1 6 Target Power In this section currently just the power consumption of the target hardware is shown 13 J Link ARM J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 180 CHAPTER 5 Working with J Link and J Trace 5 7 1 7 SWV In this section SWV information are shown 15 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 2014 SEGGER Microcontroller GmbH amp Co KG 181 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
194. are taken from ARM s AXD version 1 2 0 9 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 Sy JLinkRDI JLinkArm dll J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 262 CHAPTER 9 RDI 3 Now J Link RDI is available in the Target Environments list Choose Target Target Environments Target ARM TP 1 551 CMTooNCA SRVT DLL 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 274 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 magaalaga al E ARM 1 Registers p
195. ariables please refer to Global DLL variables on page 193 Prototype api int JTAG StoreIR unsigned int Cmd 5 10 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 193 Prototype api int JTAG WriteDR unsigned __int64 tdi int NumBits 5 10 2 10JTAG StoreDR Description Stores JTAG data 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 193 Prototype api int JTAG StoreDR unsigned __int64 tdi int NumBits 5 10 2 11 Write Description Writes a JTAG sequence max 64 bits per pin J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 190 CHAPTER 5 Working with J Link and J Trace Prototype __ 1__ int JTAG Write unsigned _ int64 tms unsigned _ int64 tdi int NumBits 5 10 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 10 2 13JTAG
196. arks 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 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 AG Chapter 20 pin 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 V5 00 Rev 0 150520 V4 98b Rev 0 150410 J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation V4 98 Rev 0 150320 NG Chapter Related Software Section J Link Commander Sub Section Commands added Chapter Working with J Link and J Trace Section J Link script files updated V4 96f Rev 0 150204 JL Chapter Related Software Section GDB Server Exit code description added V4 96 Rev
197. arted 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 SEGGER 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 10 7 2 In debugger IDE environment To execute a script file out of your debugger IDE simply select the script file to exe cute 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 10 7 3 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 83 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 200 CHAPTER 5 Working with J Link and J Trace 5 11 Command strings The behavior of the J Link can be customized via command strings p
198. as RX devices Licenses Comes with built in licenses for flash download and J Flash 2004 2014 SEGGER Microcontroller GmbH amp Co KG 57 2 4 9 Flasher PPC 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 Win dows XP Windows 2003 or Windows Vista 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 mi J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 58 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 b
199. ash SPI for batch processing purposes All important options accessible from the menus are available in command line mode as well If you provide command 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 ii openprj Opens an existing project Syntax openprj FILENAME saveprjas Saves current project in a different file Syntax saveprjas lt FILENAME gt 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 SADDR EADDR 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 a
200. assed 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 11 1 List of available commands The table below lists and describes the available command strings Command Description device Selects the target device DisableFlashBPs Disables the FlashPB feature EnableFlashBPs Enables the Flashps feature map exclude Ignores all memory accesses to specified area map indirectread Specifies an area which should be read indirect map ram Specifies location of target RAM map reset Restores the default mapping which means all mem accesses are permitted SetAllowSimulation Enables Disables instruction set simulation SetCheckModeAfterR ead Enables Disables CPSR check after read operations SetResetPulseLen Defines the length of the RESET pulse in milliseconds SetResetType Selects the reset strategy SetRestartOnClose Specifies restart behavior on close Set
201. bH amp Co KG 197 966 5 968 5 ARM11 ARM1136 ARM1136J ARM1136JS ARM1136JF ARM1136JFS ARM1156 ARM1176 ARM1176J ARM1176JS ARM1176IF ARM1176JFS CORTEX MO CORTEX M1 CORTEX M3 CORTEX M3R1PO CORTEX_M3R1P1 CORTEX_M3R2P0 CORTEX_M4 CORTEX_M7 CORTEX_A5 CORTEX_A7 CORTEX 8 CORTEX A9 CORTEX A12 CORTEX A15 CORTEX A17 CORTEX R4 CORTEX R5 5 10 4 2 Constants for JLINK CORESIGHT functions APs CORESIGHT AHB AP CORESIGHT AP JTAG AP CORESIGHT CUSTOM AP DP AP register indexes JLINK CORESIGHT DP REG IDCODE JLINK CORESIGHT DP REG ABORT JLINK CORESIGHT DP REG CTRL STAT JLINK CORESIGHT DP REG SELECT JLINK CORESIGHT DP REG RDBUF JLINK CORESIGHT AP REG CTRL JLINK CORESIGHT AP REG ADDR JLINK CORESIGHT 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 10 4 3 Constants for global variable MAIN ActiveTIF e JLINK_TIF_JTAG e JLINK TIF SWD J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 198 CHAPTER 5 Working with J Link and J Trace 5 10 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
202. 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 bit If no mask is given an ARM instruction breakpoint will be set Example Set a breakpoint implicit for ARM instructions monitor setbp 0x00000000 Set a breakpoint on a THUMB instruction monitor setbp 0x00000100 0x01 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 98 J Link software and documentation package 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 166 The speed has to be set after selecting the interface to change it from its default value
203. be disabled by using this command Syntax SetRestartOnClose 0 1 Example SetRestartOnClose 1 5 11 1 13 SetDbgPowerDownOnClose 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 value Example SetDbgPowerDownOnClose SetDbgPowerDownOnClose 1 Enables debug power down on close 0 Disables debug power down on close 5 11 1 14 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 value Note A for lt value gt disables the power down on idle functionality J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 205 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 11 1 15 SupplyPower This command activates power supply over pin 19 of the JTAG connect
204. be opened For more information about the generic setup of J Link RDI please refer to Configuration on page 274 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 273 After finishing configuration the project be built Project Build Target and the debugger can be started Debug Start Stop debug session Blinky p ision3 Disassembly R10 BH R12 7 13 5 R14 LR R15 PC J Link J Trace UM08001 358 341 342 353 355 355 356 347 348 E59FF 818 E59FF 818 E59FF 818 ESOFF 818 E59FF 818 B9286E58 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 110x0018 PC SWI fddr PC PC 0 0618 PC PAbt_Addr 0 0018 DAbt_Addr PC PC 0 0618 Reserved Vector PC IRQ_Addr RO 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 2014 SEGGER Microcontroller GmbH amp Co KG 274 CHAPTER 9 RDI 9 4 Configuration This section describes the generic setup of J Link RDI same
205. before bootloader Basically the same as reset type 8 Performs a reset of core amp peripherals and halts the CPU immediately 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 t
206. blished by ARM are the best source of add information 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 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 284 CHAPTER 9 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
207. cally 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 debug 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 346 Table 12 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 12 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 344 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 2014 SEGGER Microcontroller GmbH amp Co KG 346 12 Target interfaces and adapters Typical target connection for JTAG JTAG connector Target board supply Volta
208. cation 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 Opening 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 8 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 8 3 Edit menu elements View menu elements Command Description Opens and or brings the log window to the active win Log dow Project Opens and or brings the project window to the active window Table 8 4 View menu elements J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Tar
209. controller GmbH amp Co KG 235 Connection USB Device 0 Interface speed 4000 kHz Flash memory Auto detection 8 3 3 Menu structure The main window of 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 2014 SEGGER Microcontroller GmbH amp Co KG 236 File menu elements CHAPTER 8 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 lo
210. core Start another debugger for example another instance of IAR Embedded Work bench for ARM J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 171 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 Factory Settings General Options C C Compiler Setup Connection Assembler m Communication Custom Build Build Actions 6 USB Linker C aaabbb ccc ddd Debugger Simulator JTAG scan chain JTAG hain with multiple target IAR ROM monilor J scan chain with multiple targets number fi Scan chain contains non amp RM devices Third Party Driver Preceedina bis Log communication TOOLKIT DIR cspycomm log 7 Start debugging your second core Example number number 1 2 3 debugger 1 debugger 2 ARM7TDMI ARM7TDMI S ARM7TDMI 0 1 ARM7TDMI ARM7TDMI ARM7TDMI 0 2 ARM7TDM 1 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 5 5 3 1 JTAG spe
211. ction 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 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 78 091023 AG Chapter Licensing Section J Link OEM versions updated 77 090910 AG Chapter Introduction Section J Link J Trace models updated 76 090828 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
212. ctive 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 139 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 382 15 Support and FAQs J Link J Trace does not get any connection to the target Most likely reasons a The JTAG cable is defective b The target hardware is defective Remedy Follow the steps described in Genera procedure on page 381 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 383 15 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 381 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 probl
213. d is calculated automatically based on the CPU frequency and the capabilities of the connected J Link J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 125 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 int OxEO000E80 ITM Trace Control Reg define ITM LSR volatile unsigned int OxEOO000FBO 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 SPPR volatile unsigned int 0xE00400F0 Selected Pin Protocol Register define DWT CTRL volatile unsigned int 0xE0001000 DWT Control Regist
214. d 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 3 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 2014 SEGGER Microcontroller GmbH amp Co KG 143 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 is too low if no targ
215. d2 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 12 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 135 Syntax CommanderScript lt CommandFilePath gt Example See Using command files on page 82 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 D
216. 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 JLINK CORESIGHT ReadDP JLINK CORESIGHT DP REG IDCODE Reportl DAP IDCODE v J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 193 5 10 2 22JLINK CORESIGHT WriteAP Description Writes a specific AP register For JTAG makes sure that AP is selected automatically Prototype int JLINK CORESIGHT WriteAP unsigned int RegIndex unsigned int Data Example JLINK CORESIGHT WriteDP JLINK CORESIGHT AP REG BD1 Ox1E 5 10 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 WriteAP JLINK CORESIGHT DP REG ABORT 0 1 5 10 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 va
217. ded 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 alge J Link J Trace J LinkAJ Trace LMI FTDI Macraigor RDI Third Party Driver On the Extra Options page select Use command line options Enter jlink exec command CommandLineOption in the textfield as shown in the screenshot below If more than one command should be used separate the com mands with semicolon ptions for node Project General Options C C Compiler Assembler Custom Build Build Actions J Link J Trace LMI FTDI Macraigor RDI Third Party Driver J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 207 5 12 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 synthesizable 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
218. different for different cores However the cache is handled correctly for all supported ARM9 cores J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 209 5 14 Virtual COM Port 5 14 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 14 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 more information about the J Link Configurator please refer to J Link Configurator on page 149 Configure J Link General Product SEGGER J Link ARM 9 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 14 1 2 Via J Link Commander Simply start J Link Commander
219. dware ver sion of J Trace for Cortex M General Supported OS For a complete list of all operating 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 Storage temperature 209 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 T qi Max 20ns Data input fall time Trai Max 20ns Data output rise time Trao Max 10ns Data output fall time Max 10ns Table 1 7 J Trace for Cortex M3 specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 39 Clock rise time Max 3ns Clock fall time Max 3ns Trace Interface El
220. e 132 L Little endian 387 Memory coherency 387 Memory management unit MMU 387 Memory Protection Unit MPU 387 Menu structure 2 2 2 235 MUItIFICE 387 N MERSI Latein atu REDEEM ea 344 387 Open collector 4 387 P Processor Core isi ex rrr 388 Program Status Register PSR 388 R RDI Support 5o e ex x ces 133 Remapping nne ener anna 388 Remote Debug Interface RDI 388 RESET Learn x 387 ARS uM IEEE 388 2004 2014 SEGGER Microcontroller GmbH amp Co KG 394 Index e 388 S Scan Chaim iue ex eoir exe 388 Semihosting 2222 388 Server command ro dejo E 91 91 DisableChecks 91 EnableChecks 92 flash breakpoints 92 oT MEE 92 93 JUAQCONE 93 E rs 94 memg 1 5 tons RE BLA RED sa EV ial f 93 SAES 94 95 95 97 Iro 98 chr DLE 98 E 98 100 100 SetDbgPowerDownOncClose 204 SetSysPowerDownOnldle 204
221. e 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 2014 SEGGER Microcontroller GmbH amp Co KG 256 CHAPTER 9 RDI 9 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 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 257 9 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 The normal J Link however comes without any licenses For more information about licensing itsel
222. e where there is 1 device in front with IRLen 4 monitor jtagconf 4 1 3 3 3 12 memU8 Syntax MemU8 address value Description Reads or writes a byte 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 94 CHAPTER 3 J Link software and documentation package 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 address 0x50000000 3 3 3 14 memU32 Syntax MemU32 lt address gt lt value gt Description Reads or writes a word 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 This command is similar to the long command Example Read gt m
223. e 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 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 357 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 357 14 TRACE DATA 0 Input Input Trace data pin O Table 12 10 19 pin JTAG SWD and Trace pinout J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG PIN SIGNAL TYPE Description 16 Input Input Trace data 0 18 Input Input Trace data 0 20 Input Input Trace data Table 12 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 12 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 outpu
224. e following the meaning of 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 2014 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 LE
225. e 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 tunneling 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 SerialNo can be established and the debugger is connected to the J Link TCP IP Server USBStat ide Connected to tunnel server Status 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 He then gives the serial number of the J Link 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 his desk J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 118 J Link software and documentation package Start J Link Remote Server in tunneling mode J Link ARM V4 80 EJ J Flash E J Link Commander E J Link Configurator EJ Link DLL Updater Link GDB Server Link SWO Viewer E J Mem License Ag
226. e received by the test logic at test data input TDI TMS The signal received at test mode select TMS is decoded by the TAP controller to control test operations Test data output TDO is the serial output for test TOS 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 13 1 Test access port 13 1 2 Data registers JTAG requires at least two data registers to be present 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 13 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 2014 SEGGER Microcontroller GmbH amp Co KG 363 13 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 TA
227. e 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 signal 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 12 8 Assignment of trace information pins between ETM architecture versions 12 2 4 Trace signals Data transfer is synchronized by TRACECLK 12 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 12 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
228. e table below lists the firmware CPU support for older J Link amp J Trace models which are not sold anymore ARM ARM Cortex Renesas J Link J Trace 1 9 11 AIR Cortex M RX600 model S JTAG JTAG JTAG JTAG SWD JTAG not sup J Link o e ported not sup J Link 4 o eo ported t 2 J Link 5 e J Link 6 e o e J Link 7 3 eo J Link Pro 1 2 for Cortex M 1 e B x Table 1 11 Built in intelligence of older J Link models J Link J Trace UM08001 47 2004 2014 SEGGER Microcontroller GmbH amp Co KG 48 CHAPTER 1 Introduction 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 4 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 support download breakpoints sup
229. eading means that a small code snippet will be written into RAM of the target device which reads and 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 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
230. eady 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 14 CHAPTER SEGGER Microcontroller GmbH amp Co KG develops
231. ect 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 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 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 0 08001 2004 2014 SEGGER Microcontroller
232. ectrical USB powered Power supply Max 50mA Target Supply current Target 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 Min 2ns TRACECLK high pulse width Twp Min 2ns Data rise time 4 Max 3ns Data fall time Tra Max 3ns Clock rise time Max 3ns Clock fall time Max 3ns Data setup time Min 3ns Data hold time Ty Min 2ns Table 1 7 J Trace for Cortex M3 specifications 1 3 8 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 8 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 8 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 2014 SEGGER Microcontroller GmbH amp Co KG 40 CHAPTER 1 1 3 9 Flasher ARM Flasher ARM is a programmin
233. ed Each core has its own maximum 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 2MHz maximum JTAG speed e Core 2 4MHz maximum JTAG speed e Scan chain 2MHz maximum JTAG speed J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 172 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 2014 SEGGER Microcontroller GmbH amp Co KG 173 5 6 Connecting multiple J Links J Traces to your 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
234. ed 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 jlinkgdbserver nologtofile log C pathto file log Will generate a log file jlinkgdbserver log C pathto file log nologtofile Will not generate a log file J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 110 CHAPTER 3 J Link software and documentation package 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
235. ee of charge software to analyze and visualize data on a microcontrol ler in real time while the target is running 3 8 1 Getting Started J Scope is part of the J Link Software and Documentation Package JScope exe Preparation Before starting J Scope make sure you have an elf file of your target application and the target is running the application The application can either be flashed with J Flash or directly ran from an IDE Start J Scope by double clicking on the executable The Project Configuration Dialog will open 3 8 1 1 Set up Connection Attach to a running instance J Scope Configuration Connection to J Link C USB C TCP IP Existing Session Elf File C Temp Start_STM32F40G_Eval_v elf OK Cancel J Scope can be used alongside other applications e g a debugger which are con nected to J Link and share the connection to the J Link If J Scope is used in this mode select Existing Session as connection type All Target options will be disabled as they are already determined by the running session Note In attach mode J Scope will connect to J Link indirectly via another appli cation connected to J Link J Scope can only be used while the connection is active e g a debug session is running It is the applications responsibility to set up the tar get and J Link connection and to manage target execution J Link J Trace UM08001 2004 2014 SEGGER Microcontrol
236. efer to http www segger com jlink adapters html J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 360 12 Target interfaces and adapters J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 361 Chapter 13 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 greatly simplified com pared with microprogrammed Complex Instruction Set Computer CISC J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 362 CHAPTER 13 Background information 13 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 13 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 ar
237. em 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 2014 SEGGER Microcontroller GmbH amp Co KG 384 15 Support and FAQs 15 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 of supported cores see section Supported CPU cores on page 43 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
238. ement Option byte 6 Table 11 1 Option bytes sector description Note Writing a value of OxFF inside option byte 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 5 5 0x06000004 0x44 OxBB 0x55 OxAA 0x06000008 0x00 OxFF 0x00 OxFF 0x0600000C 0x00 OxFF 0x00 OxFF Table 11 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 11 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
239. ementation code uses 500 Bytes of ROM and 24 Bytes ID 24 Bytes 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 2014 SEGGER Microcontroller GmbH amp Co KG 292 CHAPTER 10 RTT 10 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 10 3 1 J Link RTT Viewer Vl J Link RTT Viewer v4 96 F e Terminals input Data BG CYAN RTT CTRL 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 virt
240. en 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 aid 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 2014 SEGGER Microcontroller GmbH amp Co KG 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 l
241. er define FFCR volatile unsigned int 0xE0040304 Formatter and flush N Control Register U32 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 Enable access to SWO registers DEMCR 1 lt lt 24 LSR OxC5ACCE55 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 ec Disable ITM Initialize SWO prescaler etc TPIU_SPPR 0x00000002 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 ITMPort Enable ITM stimulus port 3 7 4 Target example code for terminal output BRR kk kc kk KERR ERE RRR kc kc k EEE ERR EKER kkk kkk kk kk kkk kk kk kk kkk kk SEGGER MICROCONTROLLER GmbH amp Co KG Solutions for real time microcontroller applications i ACKCKCkCk ck ck ck kck KkCk ckCk KKK KKK ck ck ck ck ck ck ck ok ok ok ok o
242. er 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 17 1 Literature and References J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 393 Index A Adaptive clocking Application Program Interface B Big endian Cache cleaning Coprocessor D Dirty data Dynamic Linked Library DLL Embedded Trace Buffer ETB 369 Embedded Trace Macrocell ETM 365 EmbeddedICE General Query Packets H Halfword Host I ICache ICE Extension Unit PP IEEE 1149 1 Image erit re dede ex nnde In Circuit Emulator Instruction Register IR eee Ex ee eer ao da nes Er OD inane J J Flash ARM J Link J Trace UM08001 386 386 386 J Link Adapters s RR E e xe 359 Developer Pack DLL 138 Supported chips 212 213 226 227 J Link Commander 65 J Link GDB Server 83 J LinK RDI iiie Rie n ER 133 J Link STR9 Commander 134 J Link TCP IP Server 116 J Mem Memory Viewer 120 Joint Test Action Group JTAG 387 CHEST RENTE 240 362 TAP controller nei 363 LOAM eee e pc
243. erIndex char pBuffer unsigned BufferSize Parameters Parameter 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 10 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 302 CHAPTER 10 RTT Parameters Parameter Meaning Terminalld Id of the virtual terminal 0 9 Table 10 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 10 4 1 9 SEGGER RTT TerminalOut Description Send one string to a specific virtual t
244. eral 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 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 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 I O ARM recommends 100 kOhms Clock signal to target CPU It is recommended that this pin is pulled to a defined state 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 T ewe Input SWD communication Target CPU reset signal Typically connected to the RESET 15 RESET I O pin of the target CPU which is
245. 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 2014 SEGGER Microcontroller GmbH amp Co KG 250 CHAPTER 8 J Flash SPI 8 8 Target systems 8 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 2014 SEGGER Microcontroller GmbH amp Co KG 251 8 9 Performance The following chapter lists programming performance for various SPI flash devices 8 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 of gt 50 KB s can be achieved J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 252 CHAPTER 8 J Flash SPI 8 10 Background information This chapter p
246. erminal Prototype int SEGGER RTT TerminalOut char TerminalID const char s Parameters Parameter Meaning Terminalld Id of the virtual terminal 0 9 S Pointer to O terminated string to be sent Table 10 7 SEGGER RTT TerminalOut parameter list Return value gt 0 Number of bytes sent 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 303 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 10 8 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 10 4 1 115 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
247. erved Ox7FFFDO0OO0 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 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 11 1 5 map 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 328 for an example Syntax map indirectread lt StartAddressOfArea gt lt EndAddress gt Example map indirectread Ox3fffc000 Ox3fffcfff 5 11 1 6 map 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 wh
248. es 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 IDEs 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 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 monitor semihosting ioclient 2 Semihosting I O set to GDB Client Select TELNET port and GDB as output source gt monitor semihosting ioclient 3 lt Se
249. et 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 gt Compiled Jun 27 2608 19 DLL version 03 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 ER 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 2014 SEGGER Microcontroller GmbH amp Co KG 144 CHAPTER
250. eters Following SEGGER specific general query packets are available Query Packet Explanation qSeggerSTRACE config Configure STRACE for usage qSeggerSTRACE start Start STRACE qSeggerSTRACE stop Stop STRACE qSeggerSTRACE read Read STRACE data Table 3 4 General Queries J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 102 CHAPTER 3 J Link software and documentation package 3 3 4 1 qSeggerSTRACE config Syntax qSeggerSTRACE config lt ConfigString gt 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 e
251. eters and Controls 4 rna nnn 130 3 9 SWO AhalyZGla once va one Vn e o Vd ret d 131 3 10 JTAGLoad Command line tool 441 4 6 6 6 132 3 11 J Link RDI Remote Debug 133 3 11 1 Flash download and flash breakpoints 133 3 12 Processor specific 0016520 aces coven dx Een ede ea n e nde Ond Y ce e i 134 3 12 1 J Link STR91x Commander Command line tool 2 134 3 12 2 J Link STM32 Unlock Command line 1 0 6 2 135 3 13 J Link Software Developer Kit 5 mnn nnns 138 DE v CH 139 4 1 Installing the J Link software and documentation 140 4 1 1 Setup procedure 140 4 2 Setting up the USB interface nen xta cided eer n n ia en ER REC RE Rcs 143 4 2 1 Verifying correct driver installation 002 143 4 2 2 Uninstalling the J Link USB driver sese mmm 144 4 3 1 een see 146 4 3 1 Configuring J Link using J Link
252. evel output voltage Voy with a load of 10 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 Trdo Trdo lt 10ns Data output fall time 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 MHz 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 c
253. ew 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 found 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 8 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 8 6 Options menu elements J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 238 Window menu elements CHAPTER 8 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 8 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
254. examine if the affected flash sectors are completely empty The user will be asked to erase the affected sectors if they are not empty 8 4 2 1 4 Skip blank areas 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 8 4 2 2 Logging You may set some logging options to customize the log output of J Flash SPI 8 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 8 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 2014 SEGGER Microcontroller GmbH amp Co KG 243 8 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 8 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 Fl
255. f 30 9f 5 38 20 9f eS wr 1 am ent 0 volatile 3 L DE X GyBuldleg X Build messages X Q Searchresults Gy Debugger X fat C Tool C EMIDEV 1 1 arm Example Vendor ATMEL 1 SrcMMain c 28 C Tool C EMIDEV 1 1 arm Example Vendor ATMEL 1 Sre Main c 29 MOJE WINDOWS 1252 Line 29 Column 7 Insert Read Write default SS 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 2014 SEGGER Microcontroller GmbH amp Co KG 88 CHAPTER 3 J Link software and documentation package 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 lma 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
256. f and which devices have a device based license please refer to Licensing on page 49 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 258 CHAPTER 9 RDI 9 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 9 3 1 IAR Embedded Workbench IDE J Link RDI can be used with IAR Embedded Workbench for ARM 9 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 9 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 EN nj sd st enable the clock of the PIO PMC EnablePeriphClock 91 BASE PMC 1 lt
257. face 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 JTAG e SWD 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 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 Commander shall run and each connects to another J Link Syntax SelectEmuBySN lt SerialNo gt Example JLink exe SelectEmuBySN 580011111 Speed Starts J Link Commander with a given initial speed Available parameters are adap tive auto or a 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 Default inter face speed is 100kHz Syntax Speed lt Speed_kHz gt J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 82 CHAPTER 3 J Link software and documentation package Example JLink exe Speed 4000 3
258. 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 199 11 17 7 OMAP3550 Needs a J Link script file to guarantee proper functionality J Link script file 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 199 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 342 11 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 11 Device specifics Currently there are no specifics for these devices J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 343 Chapter 12 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 UM
259. fo Scan 27 1 0 1 EIE 9 Ping State ready J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 218 6 4 3 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 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 x WP Board stmazr4discovery Change Matches project settings Debugger Options J Link Startup 1 Memory Map Advanced Settings File
260. formation 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 program 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 13 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 13 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 acce
261. fter reset release 5 8 1 7 Type 6 Software This reset strategy is only a software reset Software reset means basically no reset just changing the CPU registers such as PC and CPSR This reset strategy sets the CPU registers to their after Reset values 0 0xD3 Supervisor mode ARM IRQ FIQ disabled All SPSR registers 0x10 All other registers which are unpredictable after reset are set to 0 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 0 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
262. g tool for microcontrollers with on chip or external Flash memory and ARM 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 1 3 9 1 The following table gives an overview about the specifications general mechanical electrical for Flasher ARM Specifications Introduction core Flasher ARM is Flasher SEGGER www segger com General Supported OS For a complete list of all operating sys 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 Power supply USB powered Max 50mA Target Supply current Target interface voltage Vir 1 2V Target supply voltage 4 5V 5V if powered with 5V on USB Target supply current Max 300 For the whole target voltage range 1 8V lt Vip lt 5V LOW level input voltage Max 40 of Vir HIGH level input voltage Vy Min 60 of Vir For 1 8V lt Vir lt 3 6V LOW level output voltage with a load of 10 kOhm Max 10 of HIGH level output voltage with a load of 10 kOhm Min 90 of VIF For 3 6 lt Vir lt 5
263. ge NTRST and RTCK may not be available on some CPUs Optional to supply the target board from J Link 12 1 1 2 Pull up pull down resistors Unless otherwise specified by developer s manual pull ups pull downs are recom mended to 100 kOhms 12 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 12 2 Command List J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 347 12 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 are reserved for firmware extension pur 9e e10 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 gen
264. get menu elements 237 Command Description Connect Creates a connection through the J Link using the config uration options set in the Project settings of 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 n
265. gstatus u8 Clk_Init 66 RCC_GetFlagstatus u8 Clk_Init 66 RCC GetFagstatus u8 _ 66 RCC_GetFlagstatus u8 ClkInit 66 RCC_GetFlagstatus Clk_Init 66 RCC_GetFlagstatus u8 CIkK_Init 66 RCC_USBCLKConfi g 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 Clkrnit 116 FLASH PrefetchBuffercmd u32 Clk Init 122 RCC sYSCLKConfi g u32 _ 128 main 16 NVIC_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 0800 BOSS 50 SP SP 0 20 debugt OSO0BFAC FODIFSAS BL debug ENTR SECTION IK Init i OSODBFB4 F7FFFF 2 BL Clk Init NVIC SetvectorTable NVIC VectTab FLASH 0x0 08006 2100 R1 0800 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 sysTick_rrconti g 0800 06 2001 MOV
266. gurations 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 2014 SEGGER Microcontroller GmbH amp Co KG 85 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 CommandLineOptions 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 104 3 3 2 3 GDB Server user interface The
267. h 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 8 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 241 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 Fax 49 2103 2878 28 Email support segger com Internet http www segger com J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 254 CHAPTER 8 J Flash SPI J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 255 Chapter 9 RDI RDI Remote Debug Interface is a standard defined by ARM trying to standardize a debugger debug probe interface It is defined only for cores that have the sam
268. h J Link Pro Section Connecting J Link Pro the first time updated 57 081222 AG Chapter Working with J Link Pro Section Introduction updated Section Configuring J Link Pro via web interface updated Chapter Introduction Section J Link Pro overview updated 56 081219 AG Chapter Working with J Link Pro Section FAQs added Chapter Support and FAQs Section Frequently Asked Questions updated 55 081218 AG Chapter Hardware updated 54 081217 AG Chapter Working with J Link and J Trace Section Command strings updated 53 081216 AG Chapter Working with J Link Pro updated 52 081212 AG Chapter Working with J Link Pro added Chapter Licensing Section Original SEGGER products updated 51 081202 KN Several corrections J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 50 081030 AG Chapter Flash download and flash breakpoints Section Supported devices corrected 49 081029 AG Several corrections 48 080916 AG Chapter Working with J Link and J Trace Section Connecting multiple J Links J Traces to your PC updated 47 080910 AG Chapter Licensing updated 46 080904 AG Chapter Licensing added Chapter Hardware Section J Link OEM ve
269. h 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 0x100000 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 8 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 No
270. h 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 2014 SEGGER Microcontroller GmbH amp Co KG 226 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 s
271. hannel 1 DataOut amp abDataOut 0 sizeof abDataOut SEGGER RTT MODE BLOCK IF FIFO FULL Additional information Once a channel is configured only the flags of the channel should be changed 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 300 CHAPTER 10 RTT 10 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 10 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 10 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
272. he 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 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 Available parameters are adaptive auto or a 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 2014 SEGGER Microcontroller GmbH amp Co KG 113 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 eff
273. he memory mapped flash breakpoint registers and in general simple write accesses for software breakpoints if the program 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 2014 SEGGER Microcontroller GmbH amp Co KG 179 Available function calls to log Register read write Memory read write set clear breakpoint step go halt is halted m 5 7 1 5 CPU Regs In this section the name
274. he original flash addr 0x10400000 Otherwise it is user s responsibility to ensure that flash is re mapped to 0x0 in order to debug the application from addr 0x0 11 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 199 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 330 11 Device specifics 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 332 CHAPTER 11 Device specifics 11 14 Samsung J Link has been tested with the following Sa
275. he vc CORERESET in the DEMCR 2 Reset the core and peripherals by setting the SYSRESETREQ bit in the AIRCR 3 Wait for the s RESET ST bit in the pHCSR 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 2014 SEGGER Microcontroller GmbH amp Co KG 185 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
276. hooting 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 2014 SEGGER Microcontroller GmbH amp Co KG 380 15 Support and FAQs 15 1 Measuring download speed 15 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 been performed EGGER J Link Commander 03 86 Compiled Jun 27 2008 19 42 43 asion U3 86 compiled Jun 27 2008 19 42 28 J Link ARM U6 compiled Jun 27 2008 18 35 51 JTAG speed Info TotalIRLen 4 IRPrint x 1 Found JTAG device Total IRLen 4 Id of device H8 x3JF F F F Found ARM with core Id 8x3FB8FBFBF J Link gt speed 12000 JTAG speed 126606 kHz J Link gt testwspeed Speed test Writing 8 128kb into memory address 6x66666000 128 kByte written 185ms 706 6 kb sec J Link gt J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 15 2 Troubleshooting 15 2 1 General procedure If you e
277. hown in red output on Terminals 2 15 in grey Terminal 0 15 Each 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 10 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 10 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
278. ice Select the target device to enable the 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 2014 SEGGER Microcontroller GmbH amp Co KG 124 CHAPTER 3 J Link software and documentation package For a list of all supported device names please refer to lt Ref gt Syntax device DeviceID Example deivce STM32F207IG 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 spee
279. ich 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 328 for an example Syntax map ram lt StartAddressOfArea gt lt EndAddressOfArea gt Example map ram 0x40000000 0x40003fff J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 203 5 11 1 7 map 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 11 1 8 SetAllowSimulation This command can be used to enable or disable the instruction set simulation By default the instruction set simulation is enabled Syntax SetAllowSimulation 0 1 Example SetAllowSimulation 1 Enables instruction set simulation 5 11 1 9 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 an
280. ieces 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 14 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 14 1 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 14 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 377 for further ref e
281. ifferent 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 2014 SEGGER Microcontroller GmbH amp Co KG 86 CHAPTER 3 J Link software and documentation package 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 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 typically 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 ve
282. iguration on page 274 Embedded Workbench IDE E J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 260 CHAPTER 9 RDI 9 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 ire A Assigned register 0 RO 1 R1 2 R2 3 R3 4 RA 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 9 1 Cortex M register mapping for IAR J Link RDI J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 261 9 3 2 ARM AXD ARM Developer Suite ADS 9 3 2 1 Software version The JLinkRDI d11 has been tested with ARM s AXD version 1 2 0 1 2 1 There should be no problems with other versions of ARM s AXD All screenshots
283. ile 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 mandatory since they rely on the target to be halted after connecting to GDB Server J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 109 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 generat
284. iles and program the flash in almost any ARM system J Flash requires an extra license from SEGGER 13 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 2014 SEGGER Microcontroller GmbH amp Co KG 371 13 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 13 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 2
285. in 0 05 Samtec FTSH connector 9 pin 0 05 Samtec FTSH connector JTAG SWD Interface Electrical Table 1 4 J Link Lite Cortex M specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 35 Power supply 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 Vig JTAG SWD Interface Timing Data input rise time T qj Max 20ns Data input fall 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 Tg Max 10ns Table 1 4 J Link Lite Cortex M specifications 1 3 7 J Trace ARM J Trace 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 19 J Trace has a built in 20 pin JTAG con nector and a built in 38 pin JTAG Trace connector which are compatible to the standard 20 pin connector and 38 pin con nector defined by ARM 1 3 7 1 Additional features JTAG speed up to 12 MHz Supports tracing on ARM7 9 targets Download speed up
286. in the DBGMCU CR 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 0xE0042004 1 lt lt 8 1 lt lt 9 11 16 3 STM32F2xxx These devices are Cortex M3 based All devices of this family are supported by J Link 11 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 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 v 11 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 co
287. 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 for target communication CORESIGHT IndexAHBAPTOUse 1 EMU ETM Usel eal 5 EMU_JTAG _ DisableHWTransmissions Table 5 11 Global DLL variables J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 196 CHAPTER 5 Working with J Link and J Trace 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 CORESI
288. ink has been tested with the following Infineon devices UMF1110 UMF1120 UMF5110 UMF5120 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 2014 SEGGER Microcontroller GmbH amp Co KG 325 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 326 11 Device specifics 11 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
289. inue IAR Sample f kk kk kk kk kc kkk he he e kkk kkk kk ke he ke he ehe heck k kkk kk kkk k k k kkk kkk kkk k kk kkk _Init __emulatorSpeed 30000 Set JTAG speed to 30 kHz writeMemory32 0xA5000004 0xFFFFFDO00 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 HO OHO RRR RRR RK RR KKK Sk RK KR KKK RR KR KK KKK ck ckckckckckckckckchckckckc k kckchckckckckckck kk kkk kkk kck ck kk execUserReset execUserReset message execUserReset _Init RK kk k KK RK RE KK KERR ck ckckckckckckckckckckckckckckckckckckchckckckckckckckckckckckckck kk kkk kkk kkk k k execUserPreload execUserPreload message execUserPreload _Init J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG RDI Sample SetJTAGSpeed 30 Reset 0 0 Write32 0xFFFFFDO0O Write32 OxFFFFFD44 Write32 OxFFFFFC20 Delay 200 Write32 OxFFFFFC2
290. ion is applicable to the following devices AT91SAM7S all devices AT91SAM7SE all devices AT91SAM7X all devices AT91SAM7XC all devices AT91SAM7A all devices 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 314 CHAPTER 11 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 cont
291. ister 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 CommandFile Selects a command file and starts J Link Commander 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 82 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 81 Example JLink exe Device STM32F103ZE 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 inter
292. isters 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 SFRs especially because it writes the SFR only after the complete value has been entered J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 121 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 lt don t care gt Endian Little Device no device selected no device selected Flash Id device selected J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 122 J Link software
293. k J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 234 CHAPTER 8 J Flash SPI 8 3 Getting Started This chapter presents an introduction to J Flash SPI It provides an overview of the included sample projects and describes the menu structure of J Flash SPI in detail 8 3 1 Setup For J Link setup procedure required in order to work with J Flash SPI please refer to chapter Setup on page 139 8 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 8 1 J Flash SPI directory structure 8 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 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 NDoc The Project window contains an overview of the current project settings initially a default project is opened J Link J Trace 0 08001 2004 2014 SEGGER Micro
294. kely 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 25 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 C Storage temperature 20 65 C Relative humidity non condensing Max 90 rH Mechanical Size without cables 100mm x 53mm x 27mm Weight without cables 730 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 2 J link ULTRA specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 32 CHAPTER 1 Introduction Target supply current Max 300 Reset Type Open drain Can be pulled low or tristated Reset low level output voltage VoL VoL lt 10 of VIF For the whole target voltage range 1 8V lt Vip lt 5V LOW level input voltage ViL lt 40 of Vig HIGH level input voltage gt 60 of Vig For 1 8V lt Vir lt 3 6V LOW level output voltage with a load of 10 kOhm VoL lt 10 of HIGH level output voltage with a lo
295. kok ok ck ok ok ok ck ok ok ok ok ok ck ck ck ck ck ck ck ck ck ok ck ck ck ok ck ck ck ck k ck kk kk kk c 2012 2013 SEGGER Microcontroller GmbH amp Co KG www segger com Support support segger com J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 126 CHAPTER 3 J Link software and documentation package ck ck ckck ck ckckck ckck ck ck ck KKK ckck ck ck ck ck ck ck ck ck ck k ck k 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 ERE KERR REE kkk e ke ke kkhk kkk kk kk kkk kkk kkk kkk kkk k kkk kk k kk k k Prototypes to be placed in a header file such as SWO h E void SWO_PrintChar char c void SWO_PrintString const char s I kkkkkkkkkkkkkkkkkkkkkk kkkkkkkkkkkkkkkkkkkkkkkkkkkk kkk kkhk kkk kkk kkk k Defines for Cortex M debug unit define ITM STIM 032 volatile unsigned int 0xE0000000 STIM word access define STIM 08 volatile char 0xE0000000 STIM Byte access define ITM ENA volatile unsigned 0 0000 00 ITM Enable Reg define ITM TCR volatile u
296. l featured J Link PLUS PRO ULTRA or an additional license for J Link base model required J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 65 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 U3 86 Compiled Jun 27 2008 19 42 4 DLL version 03 86 compiled Jun 27 2008 19 42 28 Firmware J Link ARM 06 compiled Jun 27 2008 18 35 51 06 00 for help gt J Link gt J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 66 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
297. lash 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 211 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 28 CHAPTER 1 Introduction 1 3 2 J Link J Link is a JTAG emulator designed for ARM cores It connects via USB to a PC running Microsoft Windows 2000 or later For a complete list of all operating systems which are supported please refer to Supported OS on page 25 J Link 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 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 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 General For a complete list of all operating sys Supported OS tems which are
298. lash 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 no 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 2014 SEGGER Microcontroller GmbH amp Co KG 213 6 2 Licensing No extra license required The flash download feature can be used free of charge J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 214
299. lashSize 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 Ej Default ini Notepad BREAKPOINTS Showrnfowin skipProgoncrcmatch 1 verifyDownload 1 AllowCaching 1 EnableFlashDL 2 override Device ADUC7020x62 OrkRAMSize 0 4000 AMACC Qx20Q0QQQ J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 222 6 Flash download Save the settings file and restart the debug session Open the J Link Control Panel and verify that the MemMap tab shows the new settings for CFI flash and work RAM area Log NET CPU Ress Target Power 59 Device Emulator MemMap Perfomance gt CFI Flash Work RAM Contig 0 10000000 0 103 Config 0 00200000 0 00203 Info Memory 0 00000000 OxFFFFFFFF 4GB Normal Ready JLINK_ETM_IsPresent Done 0 603 sec in 37 calls 4 6 5 2 J Link GDB Server The configuration for the J Link 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 monitor WorkRAM lt SAddr gt lt EAddr gt monitor flash CFI lt SAddr gt lt EAddr gt For more information about the GDB monitor commands please refer to J Link GDB Server on page 83 6 5 3
300. le c NJLinkARM log Default path of the J Link RDI log file c NJLinkRDI log J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 282 CHAPTER 9 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 OxFFFFFC20 gt 1D7 gt 060 194 0014 ARM WriteMem FFFFFC2C 0004 Data 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 OxFFFFF124 gt 195 gt 060 232 0001 ARM_ReadMem FFFFF130 0004 Data 060 233 0001 ARM_ReadMem FFFFF
301. lectronics 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 24 070323 SK Chapter Setup Uninstalling the J Link driver updated Supported ARM cores updated 23 070320 SK Chapter Hardware Using the JTAG connecto
302. led Nov 22 2613 20 09 16 lt c 2012 SEGGER Microcontroller GmbH amp Co KG www segger com Solutions for real time microcontroller applications Please enter the target CPU frequency or press lt enter gt to select device for automatic CPU frequency detection gt 72000000 ng debug initializ sfully Target CPU is running 72000 kHz Receiving SVO data 6000 kHz imulus 3 8 Using the syntax given below List of available command line options you can directly start J Link SWO Viewer CI with parameters E Command Prompt C Program Files 86 SEGGERULInkARM V478jULinkSWOViewerCL exe device stm32f103zg boa C gt C Program Files x86 gt SEGGER JLinkARM_U478 j JLinkSWOUiewerCL exe device stm32f1 3zg SEGGER J Link SWO Viewer i Nov 22 2013 20 09 16 SEGGER Microcontroller GmbH amp Co KG www segger com Solutions for real time microcontroller applications Fully CPU is running 72615 kHz SWO data 6088 kHz stimulus port lt s J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 123 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 STM
303. ler GmbH amp Co KG 129 Connecting to J Link J Scope Configuration ux Connection to J Link USB M Serial No 0000 C C Existing Session Target Device unspecified Target Interface amp Speed swp 4000 kHz Elf File C Temp Start_STM32F40G_Eval_v elf OK Cancel If J Scope is used in standalone mode opening a dedicated connection to J Link choose USB or TCP IP as connection type and optionally enter the serial number or the IP of the J Link to connect to a specific J Link For most targets the target configuration does not have to be specified If there are any problems select your target device and configure the interface accordingly 3 8 1 2 Select application file and symbols In the configuration dialog select your elf file and click OK The Symbol Selection Dialog will open Select the symbols of your application you want to watch and analyze Click OK to finalize the setup 3 8 1 3 Start sampling Data sampling can be started via the record button red dot in the toolbar On start of sampling the connection to J Link or running session will be established 3 8 2 Project Files The project configuration which are the J Link connection settings the elf applica tion file and the configuration of the selected symbols can be saved to a J Scope project file jscope J Scope projects can be used for further sessions and
304. line utility For more information about J Flash please refer to UM08003 J Flash User Guide For more information about the J Link STM32 Commander please refer to J Link STM32 Unlock Command line tool on page 135 Note memory Unsecuring a secured device will cause a mass erase of the internal flash 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 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 135 11 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
305. linx 8 0 0 Xilinx 8 ARM 4 1 8 Xilinx 8 Xilinx 8 ARM 4 2 16 Table 5 5 Example scan chain configurations J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 166 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
306. ll 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 04 98 compiled 5 2015 11 00 52 J Link 09 compiled Apr 21 2615 18 10 40 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 21 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 2014 SEGGER Microcontroller GmbH amp Co KG Compiled May c Program Files 686 SEGGERULink V498elLink exe SEGGER J Link Commander U4 98e for help i 5 2015 11 81 31
307. loper 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 respective 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 2014 SEGGER Microcontroller GmbH amp Co KG 139 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 2014 SEGGER Microcontroller GmbH amp Co KG 140 CHAPTER 4 Setup 4 1 Installing the J Link software and documentation pack J Link is shipped with a bundle of applications corres
308. luded 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 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 243 8 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 8 1 4 Requirements 8 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 8 1 4 2 Target The flash device must be an SPI flash that supports standard SPI protocols J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 233 8 2 Licensing The following chapter provides an overview of J Flash SPI related licensing options 8 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 Lin
309. lues 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 p 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 196 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 ber 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 2014 SEGGER Microcontroller GmbH amp Co KG 194 CHAPTER 5 Working with J Link and J Trace 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 IRLen nicate with
310. me 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 19 2 J link ULTRA has a built in 20 pin JTAG SWD connector 1 3 31 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 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 an 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 li
311. mihosting 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 2014 SEGGER Microcontroller GmbH amp Co KG 97 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 Semihosting Thumb SWI number set to OxAB 3 3 3 23 setargs Syntax setargs lt ArgumentString gt 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 0 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
312. mmediately after reset before it can execute any instruction of the user application by setting the vc CORERESET the DEMCR 2 Reset the core and peripherals by setting the SYSRESETREQ bit in the AIRCR 3 Wait for the s RESET ST bit in the pHCSR 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
313. mory RAM Hardware ARM7 via JTAG ARM9 via JTAG 420 0 Kbytes s 280 0 Kbytes s 12MHz JTAG 12MHz JTAG Table 1 6 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 380 The actual speed depends on various factors such as JTAG clock speed host CPU core etc 1 3 7 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 2014 SEGGER Microcontroller GmbH amp Co KG 38 1 1 3 8 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 7 9 cores Tracing ARM7 9 targets is not supported 1 3 8 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 8 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 har
314. mple is a memory read write operation which needs to be followed by status read operations or repeated until the memory operation is completed 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 UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 45 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 i
315. msung devices S3FN60D 11 14 1 SSFN60D On the S3FN60D the watchdog may be running after reset 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 2014 SEGGER Microcontroller GmbH amp Co KG 11 15 Silicon Labs 333 J Link has been tested with the following Silicon Labs devices 11 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 11 15 1 1SWO Usually the SWO output frequency of a device is directly dependent on the CPU speed SWO speed is calculated a
316. n If the logfile already exist the contents of the current logfile will be overwritten Syntax log lt Filename gt Parameter Meaning Filename Log filename Example log C Work log txt J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 73 3 2 1 21 mem The command reads memory from the target system If necessary the target CPU is halted in order to read memory Syntax mem 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 0x100000 Example mem 0 100 3 2 1 22 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 NumBytes 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 23 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 Parameter 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 24 mem32 The
317. n Enter None Input gt Echo input Cte idee wend asso ndis If checked sent input will be dis played the All Terminals 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 10 1 RTT Viewer Menus and Shortcuts J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 296 CHAPTER 10 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 10 1 RTT Viewer Menus and Shortcuts Clear Terminal 10 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
318. n calling semihosting command SYS GET CMDLINE 0x15 The argument list is given as one string Example No arguments set via setargs gt monitor getargs No arguments Arguments set via setargs gt monitor getargs Arguments test 0 1 2 arg0 4 3 3 3 8 go Syntax go J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 93 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 if instead Syntax interface lt InterfaceIdentifier gt Description Selects the target interface used by J Link J Trace 3 3 3 11 jtagconf Syntax jtagconf IRPre lt DRPre gt Description Configures a JTAG scan chain with multiple devices on it IRPre 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 165 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 devic
319. n dialog Example device stm32f407ig 3 2 1 4 erase Erases all flash sectors of the current device A device has to be specified previously Syntax erase 3 2 1 5 exit qc q This command closes the target connection the connection to the J Link and exits J Link Commander J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 69 Syntax 3 2 1 6 exitonerror This command toggles whether J Link Commander exits on error or not Syntax ExitOnError lt 1 0 gt 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 7 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 8 fdelete fdel On emulators which support file I O this command deletes a specific file Syntax fdelete lt FileName gt Parameter Meaning FileName File to delete from the Flasher Example fdelete Flasher dat 3 2 1 9 flist On emulators which support file I O this command shows the directory tree of the Flasher Syntax flist 3 2 1 10 fread frd On emulators which support file I O this command reads a specific file Offset applies to both destination and source file J Link J Trace UM08001 2004 2014 SEGGER Microcontroller
320. n dialog of 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 XDS100 Setup 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 he wants to connect to 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 2014 SEGGER Microcontroller GmbH amp Co KG 153 4 7 Using the J Link DLL 4 7 1 What is the JLink DLL The J LinkARM d1l 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 b
321. n the firmware even if the number of transactions over the host interface is limited to a minimum fast mode 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 2014 SEGGER Microcontroller GmbH amp Co KG 46 CHAPTER 1 Introduction 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 ARM ARM Cortex Cortex M Renesas J Link J Trace 7 9 11 RX600 model UOISJ9A JTAG JTAG JTAG JTAG J Link s o z JTAG J Link Pro 3 J link ULTRA 1 J Link Lite ARM 8 J Link Lite Cortex M 8 99 9 O OOOO o000 0900 9 00000 Oo 000 9 9 000 9 J Link Lite RX 8 J Trace ARM 1 J Trace for Cortex M 3 e e Table 1 10 Built in intelligence of current J Links J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 1 6 3 2 Older models Th
322. n unittest Remote Java Application 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 2014 SEGGER Microcontroller GmbH amp Co KG 157 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 2014 SEGGER Microcontroller GmbH amp Co KG 158 CHAPTER 5 Working with J Link and J Trace 5 11 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 re
323. nabled 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_APB1_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 lt lt 12 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 11 17 Texas Instruments 339 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 11 17 1 AM335x The 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 310 For J Link Commander amp J Link GDBServer this needs to be done manually 11 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
324. ncoded 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 chapter STRACE J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 103 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 2014 SEGGER Microcontroller GmbH amp Co KG
325. nd ETM ETB Trace This sample project can be found at Sam ples JLink Projects 11 6 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
326. ne option which requires this It is recommended to always use open lt FILENAME gt lt SADDR gt to make sure the right data file 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 FILENAME 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 readchi
327. neral information about target hardware and J Link which 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 2014 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 can only the changed by the user himself 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
328. nfigured in the DBGMCU_APB1_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 2014 SEGGER Microcontroller GmbH amp Co KG 338 CHAPTER 11 Device specifics 11 16 4 STM32F4xxx These devices are Cortex M4 based All devices of this family are supported by J Link 11 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 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 0 0042004 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 11 16 4 2Debugging with software watchdog enabled If the device shall be debugged with one of the software watchdogs independed watchdog window watchdog e
329. nnecting 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 2014 SEGGER Microcontroller GmbH amp Co KG 390 16 Glossary J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 391 Chapter 17 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 2014 SEGGER Microcontroller GmbH amp Co KG 392 CHAPTER 17 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 Us
330. nsigned int 0O0xEOO000E80 ITM Trace Control Reg f 5k kk kk sk kc tec ke he ke e ek ke ck kk EERE hee ke e kkk kkk kkk RE RRR EKER EER KR k kk kkk k k kk k k k k k KK SWO PrintChar Function description Checks if SWO is set up If it is not return to avoid program hangs if no debugger is connected If it is set up print character to the ITM_STIM register in order to provide data for SWO Parameters Chacracter to printed Notes Additional checks for device specific registers can be added Af 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 7 while ITM 5 U8 amp 1 0 ITM 5 U8 c J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 127 kc e ke e ke e heck ke kk ck kk e ke ke ck he ke kk SWO PrintString Function description Print a string via SWO void SWO_PrintString const char s Print out character per character while s SWO_PrintChar 5 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 128 J Link software and documentation package 3 8 J Scope J Scope is a fr
331. ntation Pack for Win dows Linux and OS X and can be used for simple RTT use cases 10 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 298 CHAPTER 10 RTT 10 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 s
332. ntry in start menu IV Add shortcuts to desktop Cancel J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 142 CHAPTER 4 Setup 5 The installation process will start Installing 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 153 The following 3rd party applications using JLink amp RM dll have been found CIAR Embedded Workbench for ARM 6 40 DLL 4 68 in NTooNCMARNARM VB40BSARM bin C IAR Embedded Workbench for ARM DLL V4 72 in C Tool CMAR ARM_V6505 4RM bin Embedded Workbench for ARM 6 40 DLL V4 63a in C Tool C IAR ARM_V6405 4RM bin CIAR Embedded Workbench for ARM DLL V4 72a in CNTooNCVARNARM V6BDTNARMNbin Embedded Workbench for ARM 5 50 DLL v4 68 in CATooNCXARNARM V5S0GNARMNbin CIAR Embedded Workbench for ARM 6 10 DLL V4 68 in C Tool C ARARM_V6104 4RM bin CIAR Embedded Workbench for ARM 6 21 DLL V4 68 in VB21CXARMbin Embedded Workbench for ARM 6 30 DLL V4 68 in CATooNCNARNARM VB30 amp ARMbin 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 version will be renamed an
333. o KG 335 11 16 1 STR91x 11 16 1 1JTAG settings These device are ARM966E S based We recommend to use adaptive clocking for these devices 11 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 134 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 11 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 134 11 16 2 STM32F10xxx These devices are Cortex M3 based All devices of this family are suppor
334. o use J Link J Trace remotely via TCP IP J Mem Memory Viewer Target memory viewer Shows 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 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 149 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 Ful
335. oaded 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 multiple 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
336. olation of US European and other international laws and is prohibited If you are in doubt 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 2014 SEGGER Microcontroller GmbH amp Co KG 63 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 2014 SEGGER Microcontroller GmbH amp Co KG 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 t
337. omputer Peak current lt 10 ms limit is 1A operating current limit is 300mA J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 30 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 for 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 31 1 3 3 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 sa
338. on 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 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 79 command line parameter 6 Unknown or no device name set 7 Failed to connect to J Link Table 3 10 GDB Server exit codes J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 116 J Link software and documenta
339. on figured individually The gray areas in 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 2014 SEGGER Microcontroller GmbH amp Co KG 290 CHAPTER 10 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 291 10 2 5 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 10 2 6 Memory footprint The RTT impl
340. onitor 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 lt RegName gt lt address gt Description Reads or writes from to given register If lt value gt is specified this command writes the value into the given register If address 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 2014 SEGGER Microcontroller GmbH amp Co KG Example Write value to register gt monitor reg pc 0x00100230 lt Writing register PC 0x00100230 Write value from address to register gt monitor reg 0 0x00000040 lt Writing register RO 0x14813004 Read register value gt monitor reg PC lt Reading register PC 0x00100230 3 3 3 16 regs Syntax regs Description Reads all CPU registers Example gt monitor regs 95 lt PC 00100230 CPSR 20000013 SVC mode ARM RO 14813004 R1 00000001 R2 00000001 R3 000003B5 R4 00000000 R5 00000000 R6 00000000 R7 00000000 USR R8 200000000 R9 200000000 R10 00000000 R11 200000000 R12 200000000 R13 00000000 R14 00000000 R8 00000000 R9 00000000 R10 00000000 R11 00000000 R12 00
341. or 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 11 1 16 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 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 11 2 Using command strings 5 11 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 U AE er Compiled Jan 12 2007 12 version 58 compiled Jan 12 2007 12 54 35 J Link compiled Feb 89 28087 19 59 46 ARM Rev 5 05 30 UTarget 3 313U JTAG speed 3 kHz 1 JTAG devic AFGF x4F1F F F lt ARM gt may t J Link gt exec map exclude 0x10800808 0x3FFFFFFF J Link J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 206 CHAPTER 5 Working with J Link and J Trace Example exec SupplyPower 1 exec map reset exec map exclude 0x10000000 0x3FFFFFFF 5 11 2 2 IAR Embed
342. or ARM targets to communicate input output requests 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 pu
343. or Cortex M devices Flash download into supported MCUs Standard 20 pin 0 1 inch JTAG connector compatible to J Link 1 3 5 2 Specifications 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 For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 25 Electromagnetic compatibility EMC EN 55022 EN 55024 Operating temperature 5 C 60 Storage temperature 209C 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 JTAG 20 pin Target interface 14 pin available JTAG SWD Interface Electrical Table 1 3 J Link Lite specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 34 CHAPTER 1 Introduction Powersupply 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 300mA LOW level input voltage Max 40 of Vir HIGH level input voltage Min 60 of Vig JTAG SWD Interface Timing Data input rise time T qi Max 20ns Data input fall time T qj Max 20ns Data outp
344. or 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 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 HS 26 5 U Versatile Platform for 926 0 5 USB port J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 267 9 Now the RealView Debugger is connected to J Link 2 RVDEBUG Start STR71x 0 ARM A RR Mo source for context _ENTRY_ lt entry point Click to Load C temp emb0S Start STR71x RAM Start STR7lx axf 00000000 SS DESDE 00000000 00000000 00000000 00000000 00000000 00000000 00000000 CPSR 00000003 0 0000000 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 stack heap or top of memory defined using defaults Connected Target is ARM Vehicle ARM MultiP RDI 9
345. orted devices please refer to http www segger com jlink_supported_devices html 11 17 1 5Required J Link hardware version The special 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 11 17 2 AM35xx AM37xx Script is not needed Refer to AM335x special handling Same needs to be done for AM35xx AM37xx 11 17 3 OMAP4430 Script is not needed Refer to AM335x special handling Same needs to be done for AM35xx AM37xx 11 17 4 OMAP L138 Needs a J Link script file to guarantee proper functionality J Link script file 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 199 11 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 199 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 341 11 17 6 530 Needs J Link script file to guarantee proper functionality J Link script
346. ou need to buy a separate J Link Licenses No licenses are included 2 5 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 him to start right away with his 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 2014 SEGGER Microcontroller GmbH amp Co KG 61 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 2014 SEGGER Microcontroller GmbH amp Co KG 62 CHAPTER 2 Licensing 2 7 Illegal 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 vi
347. p Read entire flash chip readrange lt SADDR gt lt EADDR gt Read specified range of target memory save SADDR EADDR 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 lt gt 2 ip lt HostName gt Overrides connection settings to IP Table 8 9 J Flash SPI command line options J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 245 8 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 Flas
348. pecial 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 debuggers 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 delete of 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 mem ory this requires re programming of the flash which takes much more time than sim ply 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 debug ging in RAM What performance can 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
349. ponding 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 63 for an over view of the J Link software and documentation pack 4 1 4 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 into 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 2014 SEGGER Microcontroller GmbH amp Co KG 141 2 The Welcome dialog box is opened Click Next gt to open the Choose Destina tion Location dialog box a Welcome xi Welcome to J Link ARM V 3 58c Setup program This program will install J Link ARM
350. port RealViewICE fRealView ICE ARM JT G debug interface TCP IP J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 265 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 274 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 266 CHAPTER 9 RDI RDI Target List Name Version Description JLinkADI J Link ARM RDI Interface Remote v1 2 Angel debug protocol serial port Ex Multi ICE v2 25 ARM JTAG debug interface parallel port ARMulat
351. port 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 with IAR 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 1 Requires J Link RDI license for download of more than 32KBytes Coming soon 3 Requires emulator with trace support 4 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 49 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 2014 SEGGER Microcontroller GmbH amp Co KG 50 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 e J Flash e J Link RDI e Flash breakpoints FlashBP J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 51 2 2 License types For each of the sof
352. port that it found a JTAG target 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 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 379 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 379 as well J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 159 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 th
353. pply 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 29 r Resets and halts the target Syntax E 3 2 1 30 regs Shows all current register values Syntax regs 3 2 1 31 rnh This command performs a reset but without halting the device Syntax rnh 3 2 1 32 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 33 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 2014 SEGGER Microcontroller GmbH amp Co KG 76 J Link software and documentation package Syntax rx lt DelayAfterReset gt Parameter Meaning DelayAfter Delay in ms Reset Example rx 10 3 2 1 34 savebin
354. r 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation Chapter Working with J Link Connecting multiple J Links to your PC added 6 051118 Chapter Working with J Link Multi core debug ging added Chapter Background information J Link firm ware added 5 051103 Chapter Setup JTAG Speed added Chapter Background information Flash program ming added 4 091025 799 Setup Scan chain configuration added Some smaller changes 3 051021 TQ Performance values updated 2 051011 TQ Chapter Working with J Link added 1 050818 TW Initial version J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG About this document Assumptions This document assumes that you alr
355. r a list of supported devices please refer to Supported devices on page 214 For more information about the GDB monitor commands please refer to J Link GDB Server on page 83 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 214 In order to start downloading the binary data file into flash please type in the following command loadbin filename lt addr gt Filename is the path of the binary data file which should be downloaded into the flash lt Addr gt is the start address the data file should be written to 15 J Link Commander JTAG speed gt J Lin eed 40 4000 kHz 5 1 79 CPSR 20000007F lt S mode THUMB FIQ dis gt 66262D66 aug R3 66600000 R6 hy 6616198F 2 2 0 2 2 aat R 8880888088 R10 i AOA Rii 86608006 R12 B8BBBBB5F 3 662G1FD8 R14 080102495 AAAAOH
356. r some chips to enter the correct CPU clock frequence 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 2014 SEGGER Microcontroller GmbH amp Co KG 280 CHAPTER 9 RDI 9 4 4 5 Breakpoints tab J Link RDI Configuration 2 x General Init JTAG Flash Breakpoints cPU Loa 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
357. r to configure the use of some J Link features such 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 of x 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 JTAG 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 ge
358. r 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 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 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 Subchapte
359. re select the J Link which should be used for a debug 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 149 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 175 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 use
360. reement 8 Remove J Link ARM V4 80 d Manuals n Processor Specific Utilities J Release Notes 4 Back Connect to the J Link J Trace via J Link commander J Link Commander can be used to 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 2 J Link ARM V4 54 4 SEGGER J Link Commander U4 54 for help Compiled Sep 11 2012 18 33 18 Can not connect to J Link via USB J Link gt ip tunnel 59888808 Connecting to tunnel 5900000A DLL version 04 54 compiled Sep 11 2012 18 32 59 Firmware J Link 09 compiled Oct 2 2012 09 11 43 Hardware 9 0 S N 59000000 UTarget 3 3120 Info 11 9 IRPrint 0 0011 Info Found Cortex M4 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 x4BA80477 IRLen 04 IRPrint Axi CoreSight JTAG DP CARM 1 Id 6x66413641 IRLen 05 IRPrint STM32 Boundary Scan Cortex M4 identified JTAG speed 100 kHz J Link J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 119 Troubleshooting Solution 1 Make sure the Remote server is not blocked by any firewall Problem Remote server cannot connect to tunnel server 2 Make sure port 19020
361. remote system running the J Link TCP IP Server J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 240 CHAPTER 8 J Flash SPI 8 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 8 4 1 2 1 Interface Speed Specifies the SPI communication speed J Link uses to communicate with the SPI flash 8 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 2014 SEGGER Microcontroller GmbH amp Co KG 8 4 2 a Detect SPI flash Flash ID 0x00 0500 0 00 0x00 0 00 0 00 0 00 0 00 0 00 000 ID Len 0 PageSize 0 01 NumPages SectorSize 0x01 SPI Instructions Instruction Address bytes WiiteEnable 0x00 Read 0x00 WiiteDis
362. rence J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 377 14 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 single 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 14 2 1 Rules for series terminators Series source termination is the
363. 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 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 181 9 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 fi
364. rityGroupconfig 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 008000854 003081 003399 008000856 R4 0 600 003082 003400 0x0800D85A 003083 003401 Ox0800D85C R4 0 500 003084 003402 008000860 003085 003403 008000862 0 400 003086 003404 0 08000866 003087 003405 0 08000868 R4 0x300 003088 003406 0x0800D86C EN OU On Di 003089 003407 0 0800086 NVIC PriorityGroupconfig 2 executed executed executed executed executed SCB AIRCR AIRCR VECTKEY MASK NVIC_PriorityGroup NVIC PriorityGroupconfig 2 003090 003408 0x0800D87A LDR W RO PC 58 003091 003409 0 0800087 LOR 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 0 0800088 R4 PC SysTick setReload 900000 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 13 2 3 2 Code coverage Source code tracing 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
365. roject configuration e g Debug RAM Debug Flash If no settings file is given this button is not visible 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 2014 SEGGER Microcontroller GmbH amp Co KG 178 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 Ot x General Se
366. rom 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 JTAG 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 354 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 354 19 Test data input from run control to the JTAG port Trace signal For more information please refer to 20 signal 10 Assignment of trace information pins between ETM archi tecture versions on page 354 21 nTRST Active low JTAG reset Table 12 7 JTAG Trace connector pinout J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 353 PIN SIGNAL Description 22 Trace signal 9 23
367. rovides some background information about specific parts of the J Flash SPI software 8 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 UM08001 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 2014 SEGGER Microcontroller GmbH amp Co KG 253 8 11 Support The following chapter provides advises on troubleshooting for possible typical problems and information about how to contact our support 8 11 1 Troubleshooting 8 11 1 1 Typical 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 Meaning 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 Flas
368. rs 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 2014 SEGGER Microcontroller GmbH amp Co KG 216 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 Utiities Database Generic CPU Data Base 71 Vendor STMicroelectronics Device STM32F103ZE Toolset ARM 3 STM32F103VF 3 STM32F103VG 3 STM32F103ZC 3 STM32F1037D ARM 32bit Cortex M3 Microcontroller 72MHz 512kB Flash 64 SRAM 2 0B Active 3 12 bit 16 ch A D Converter 2 1254 D A Converter d 034 3 sTM32F1032G SDIO Fast 0 Pots 3 STM32F105R8 3 STM32F105RB STM32F105RC 3 STM32F105V8 STM32F105VB STM32F105VC 3 STM32F107RB
369. rsion of GDB Server starts in emIDE click on JLink gt Run the JLink plugin configuration J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 87 The screenshot below shows a debug session in IDE For download more infor mation about emIDE please refer to http emide org File Edit View Search sues Function 10 include BSP h Frame start 00200500 1i 0x00100228 push 1r str 12 BBB III IIIS III SII IS GGG 0x0010022C sub sp sp 12 13 A as 0x00100230 mov r3 0 EU 0x00100234 str r3 sp 41 14 et 0x00100238 bl 0x1000 8 BSP Init 15 static void _Delay void 16 volatile int i 0x00100240 bl 0 10014 lt BSP_SetLED gt 17 0x00100244 mov ro 1 0 00100248 bl 0 10019 BSP ToggleLED 22 Ha 0x0010024C ldr r3 sp 4 19 while 1 0x00100250 add r3 r3 1 20 0 00100254 atr r3 sp 4 21 0x00100258 bl 0 1001 lt Delay 22 DOI III III III III III III III III III 0 0010025 0x100244 lt 28 gt I 23 main OIOIODDJAADA 24 25 lint main void Rs Hex Flags Decimal 26 volatile int cnt E oxo 27 ent 0 e 4 28 Init Initiali 290 BSP_SetLED 0 ee m ses pt 31 BSP_ToggleLED 1 320 centes xe m n Delay D ze som i erm r
370. rsions 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 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 strategies 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 be
371. ry 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 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 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 2014 SEGGER Microcontroller GmbH amp Co KG 133
372. s lt CPUFreq gt n On the EFM32 series this is not the case The SWO related units ITM TPIU 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 2014 SEGGER Microcontroller GmbH amp Co KG 334 CHAPTER 11 Device specifics 11 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 2014 SEGGER Microcontroller GmbH amp C
373. s can be found at JLINK_INST_DIR Sam ples JLink Scripts J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 199 5 10 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 Can not find xxx device return 1 JTAG DRPre 0 Cortex A8 is closest to 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 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 0 80030000 5 10 7 Executing J Link script files 5 10 7 1 In J Link commander When J Link commander is st
374. s not halt program execution if no debugger is present and J Link is not 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 2014 SEGGER Microcontroller GmbH amp Co KG 308 CHAPTER 10 RTT J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 309 Chapter 11 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 2014 SEGGER Microcontroller GmbH amp Co
375. s 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 NXP LPC2148 MCU Memory map 0x00000000 0x0007FFFF On chip flash memory 0x00080000 0x3FFFFFFF Reserved 0x40000000 0x40007FFF On chip SRAM J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 202 CHAPTER 5 Working with J Link and J Trace 0x40008000 0x7FCFFFFF Reserved Ox7FD00000 0x7FDO1FFF On chip USB DMA RAM Ox7FD02000 0x7FD02000 Res
376. sam7s ek General Options C C Compiler Assembler Output Converter Custom Build Build Actions Linker Debugger Simulator J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 165 5 3 3 Determining values for scan chain configuration When do 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 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 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 Xi
377. ser 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 supporting 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 2014 SEGGER Microcontroller GmbH amp Co KG Table of Contents
378. set simulati Gyeride memory map Modify breakpoints during execution allow x Ready JLINKARM GetSpeed Done 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 p
379. 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 open 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 2014 SEGGER Microcontroller GmbH amp Co KG 89 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
380. ss 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 13 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 2004 2014 SEGGER Microcontroller GmbH amp Co KG 366 CHAPTER 13 Background information 13 2 3 1 Code coverage Disassembly tracing IAR Embedded Workbench IDE 195 ttendif 196 19 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 NUIC_Priorit yGroupConf ig lt NUIC_Priorit _4 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 4 GPIO enable clock and release Reset RCC_APB2PeriphResetCmd RCC_APB2Periph_GPIOA
381. 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 2014 SEGGER Microcontroller GmbH amp Co KG 91 3 3 3 1 clrbp Syntax CIrBP lt BPHandle gt or ci BPHandle Description Removes an instruction breakpoint where BPHandle is the handle of breakpoint to be removed If no handle is specified this command removes all pending breakpoints Example 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 cpi5 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 STM32F417IG lt Selecting device
382. supported please refer to Supported OS on page 25 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 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 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 5V LOW level input voltage Vip lt 40 of Table 1 1 J Link specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 29 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 HIGH level output voltage Voy with 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 l
383. t 0 00000514 MAIN _LED main Line 35 9 3 4 GHS MULTI 9 3 4 4 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 9 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 2014 SEGGER Microcontroller GmbH amp Co KG 269 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
384. t 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 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 12 11 Command List J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 358 12 Target interfaces and adapters 12 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 VTref 1ee2 SWDIO TMS GND 4 SWCLK GND 5 6 SWO 7 8 TDI NC 9 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 T
385. t 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 71 Syntax fwrite lt EmuFile gt lt HostFile gt lt Offset gt 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 14 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 instruction which cannot be simulated emulated is hit or when Num Steps is reached Zu 0 Do not start the CPU if a BP is in range of NumSteps ce 1 Overstep BPs Example go Simply starts the CPU go 20 1 3 2 1 15 halt h
386. t 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 196 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 10 2 19JLINK CORESIGHT Configure Description 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 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 DR
387. t the CPU This can be useful if a bootloader which resides in flash or ROM needs to be started after reset This reset strategy 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 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
388. tandard printf functions to be used with RTT Using RTT reduces the time 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 10 4 1 API functions The following API functions are available in the RTT Implementation To use them SEGGER_RTT h has to be included in the calling sources 10 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
389. ted by J Link 11 16 2 1ETM init The following sequence can be used to prepare STM32F10xxx devices for 4 bit ETM tracing int v DBGMCU_CR enable trace I O and configure pins for 4 bit trace volatile int 0xE0042004 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 11 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 2014 SEGGER Microcontroller GmbH amp Co KG 336 CHAPTER 11 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 compl
390. terfaces and adapters V4 36 Rev 1 110927 Section 20 pin JTAG SWD connector updated Chapter RDI added Chapter Setup updated Chapter Device specifics updated Chapter Working with J Link Section J Link script files updated Chapter Introduction M26 Revel 129523 KN Section J Link J Trace models corrected V4 26 Rev O 110427 Several corrections Chapter Introduction Section J Link J Trace models corrected Chapter Device specifics Section ST Microelectronics updated V4 56 Rev 0 121022 AG V4 53c Rev 0 120904 V4 51h Rev 0 120717 V4 51e Rev 0 120704 V4 51b Rev 0 120611 V4 51a Rev 0 120606 EL V4 36 Rev O 110909 V4 24 Rev 1 110228 AG J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation V4 24 Rev 0 110216 AG Chapter Device specifics Section Samsung added Chapter Working with J Link Section Reset strategies updated Chapter Target interfaces and adapters Section 9 pin JTAG SWD connector added 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
391. testium etc ve e io 255 9 1 Introduction Pn 256 9 1 1 EE 256 9 2 Peewee 257 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 9 3 Setup for various debuggers 2 2 2 2 ene naked ea RR RAE RR AR teed RR PERRA ERR Ea 258 9 3 1 Embedded Workbench 66 258 9 3 2 ARM AXD ARM Developer Suite 5 2 261 9 3 3 ARM RVDS RealView developer 1 4 41 263 9 3 4 eic per 268 9 3 5 UVISION 1 6 6 nnn nnn 271 9 4 Configurations 274 9 4 1 Configuration file 108 274 9 4 2 Using different 274 9 4 3 Using mutliple J Links 274 9 4 4 Configuration dialogue mii auie 274 9 5 SemihOStinG 283 9 5 1 EP 283 9 5 2 The SWI interface iore evecare ev wide yw y Valves 2
392. th RTT it is possible to output information from 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 2014 SEGGER Microcontroller GmbH amp Co KG 289 10 2 How RTT works 10 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
393. that does not have intelligence in the firmware and only PC side intelligence is available for the connected CPU a warning message is 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 exa
394. tion 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 3 File Help Localhost only GDB Connected to 127 0 0 1 B Initial SWD speed 4000 kHz Stay on top Show log window J Link Connected i Current SWD speed 4000 kHz Generate logfile CPU 5 3254175 Executing p Gases Init regs on start Log output _Llear log J Link is connected Firmware J Link Pro V4 compiled Jul 16 2013 21 45 Hardware V4 00 S N 174200001 Feature s RDI FlashBP FlashDL JFlash GDB 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 Reading all registers Read 4 bytes address 0 00000000 Data 0x20001850 Starting target CPU 4 0 Bytes downloaded 1 JTAG device The GNU Project Debugger GDB is a 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
395. tion package 3 4 J Link Remote Server J Link R emote 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 USB connection ui q IPStat Connected to 127 0 0 1 wW WR NES of USBStat About 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 4 List of available commands The table below lists the commands accepted by the J Link Remote Server Command Description i Selects the IP port on which the J Link Remote Server is ii listening SelectEmuBySN Selects the J Link to connect to by its Serial Number Table 3 11 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 19 021 3 4 1 2 SelectEmuBySN Syntax SelectEmuBySN S N Example To selec follows Selectl t the emulator with Serial Number 268000000 the command should look as EmuBySN 268000000 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 117 3 4 2 Tunneling mode The Remote server provides a tunneling mode which allows remote connection to a J Link J Trac
396. to 420 Kbytes second DCC speed up to 600 Kbytes second Comes with built in licenses for breakpoints in flash FlashBP J Link GDBServer J Link Unlimited number of RDI J Link RDDI and J Flash production programming software Measured with J Trace ARM7 50 MHz 12MHz JTAG speed 1 3 7 2 Specifications for J Trace General Supported OS For a complete list of all operating sys tems which are supported please refer to Supported OS on page 25 Electromagnetic Compatibility EMC EN 55022 EN 55024 Operating Temperature 5 C 40 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 Table 1 5 J Trace specifications J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 36 CHAPTER 1 Introduction JTAG 20 pin 14 pin adapter available Tongs Tntertaee JTAG Trace Mictor 38 pin JTAG SWD Interface Electrical USB powered lt 300mA Supported Target interface voltage 3 0 3 6 V 5V adapter available Table 1 5 J Trace specifications Power Supply J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 37 1 3 7 3 Download speed The following table lists performance values Kbytes s for writing to me
397. to the FlashBP usage settings E Flash breakpoints Auto License found C n 7 Show info window during C Off program E nabled Auto This is the default setting of FlashBP usage If a license has been found the FlashBP feature will be enabled Otherwise rFlashBP 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 2014 SEGGER Microcontroller GmbH amp Co KG 177 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 r 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
398. tors The output indicator is 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 2014 SEGGER Microcontroller GmbH amp Co KG 162 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
399. trategy The reset pin of the device is per default disabled This means that 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 OxfffffdOO This information is applicable to the following devices AT91SAM7S all devices AT91SAM7SE all devices AT91SAM7X all devices AT91SAM7XC all devices AT91SAM7A all devices 11 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 informat
400. ts 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 GetSpeedInfo 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 rmib 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 2014 SEGGER Microcontroller GmbH amp Co KG 101 3 3 4 SEGGER specific GDB protocol extensions J Link GDB Server implements some functionality which are 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 4 SEGGER specific general queries are followed by the identifier Segger plus the command group the actual command and its param
401. ttings Break watch Log CPU Reas Target Power Sw Device Emulator alej Breakpoints Handie Address 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 t
402. tware components which require an additional license there are different 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 227 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
403. tween 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG Revision Date By Explanation 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 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 updated 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 Microe
404. ty 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 each rising edge of each TRACECLK or on each alternate rising or falling edge 12 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 91989 E o o J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 352 12 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 12 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 PRGACK state i 9 RESET Open collector output f
405. ual Terminals on Channel 0 Sending text input to Channel 0 Interpreting text control codes for colored text and controling the Terminal Logging data on Channel 1 10 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 10 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 2014 SEGGER Microcontroller GmbH amp Co KG 293 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 swp 12000 kHz RTT 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
406. umentation 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 2014 SEGGER Microcontroller GmbH amp Co KG 232 CHAPTER 8 J Flash SPI 8 1 Introduction The following chapter introduces J Flash SPI highlights some of its features and lists its requirements on host and target systems 8 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 8 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 inc
407. ut rise time Trgo Max 10ns Data output fall time Max 10ns Clock rise time Max 10ns Clock fall time Tec Max 10ns Table 1 3 J Link Lite specifications 1 36 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 pensive emulator solution for you Your customer receives a widely acknowledged JTAG SWD emulator which allows him to start right away with his development Very small form factor Fully software compatible to J Link Any Cortex M0 M0 M1i M3 M4 core supported JTAG clock up to 4 MHz SWD SWO supported Flash download into supported MCUs Standard 9 or 19 pin 0 05 Samtec FTSH connector 3 3V target interface voltage 1 3 6 1 Specifications The following table gives an overview about the specifications general mechanical electrical for J Link Lite Cortex M General For a complete list of all operating sys Supported OS tems which are supported please refer to Supported OS on page 25 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 41mm x 34mm x 8mm Weight without cables 6g Mechanical USB interface USB 2 0 full speed Target interface 19 p
408. uto Erases programs and verifies target verify Verifies target program readchip Reads the entire flash chip readrange Reads specified range of 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 lt 5 gt ip Overrides connection settings to IP Syntax ip lt 200 200 20020K gt or ip lt HostName gt 8 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 JFlash exe openprjC Projects Default jflash J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 244 CHAPTER 8 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 li
409. various 1 229 7 5 FAQ ipsuin c Ur dec pur qua 230 Mapa eo im 231 8 1 TREROGUCHION ae tae 232 8 1 1 What is J FlashsSPl ext exte e dates SAA aha HE 232 8 1 2 J Flash SPI CL Windows Linux 1 1 6 6 232 8 1 3 Feat les verse ede 232 8 1 4 ON Le Ut 232 8 2 Boing op E LLLI 233 8 2 1 Introductio MarTre ENa iet Ac 233 8 3 Getting Started ee e e eun ERE ER XR ah tetas KEEPER PNE 234 8 3 1 Setup eot 234 8 3 2 Using J Flash SPI for the first 0 50 00 234 8 3 3 Men SEr ct le s socero unten eee seine an 235 8 4 Irae 239 8 4 1 Project Settiligs oot ma eb e UP spend 239 8 4 2 Global Settings is dre to der er Ed en ee ee Ab ase d ta ee MEER 241 8 5 Command Line Interface 446 66 243 8 5 1 OVERVIEW 243 8 5 2 Command Jirie options os
410. w 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 below Find below a small sample which shows how to program multiple targets in parallel J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 246 CHAPTER 8 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
411. 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 38 sleep Waits the given time in milliseconds Syntax Sleep Delay Parameter Meaning Delay Amount of time to sleep in ms Example sleep 200 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co K
412. ways 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 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 7 Persistent command line options J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 105 Following additional command line options are available These options are tempo rary for each start of GDB Server Command line option Explanation
413. will power the target via pin 19 of the debug connector Syntax J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 137 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 STM32F3Xxxx 5 STM32F4xxxx 6 STM32L1xxxx Table 3 14 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 2014 SEGGER Microcontroller GmbH amp Co KG 138 CHAPTER 3 J Link software and documentation package 3 13 J Link Software Deve
414. ws 8 x64 Linux Mac OSX 10 5 and higher 25 2004 2014 SEGGER Microcontroller GmbH amp Co KG 26 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 J Link PLUS J Link PRO J Link ULTRA 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 exe As part of the initial message the hardware version is displayed Link J C Program Files SEGGER JLinkARM_ 402d JLink exe arget 0 0000 JTAG speed 5 kHz J Link J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 1 3 1 27 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 Plus ULTRA Pro for Cortex M USB yes yes yes yes yes yes Ethernet no no no yes no
415. x EXE Na ee 304 10 5 Example code eee is eye var Vn av Te AEN I PARE XE 306 10 6 jio E EE 307 11 coe tette d LM D Mur eee 309 11 1 Analog Devices oe exper m RI RM ERR 310 11 1 1 A DUCT RK I oci Roe b 310 11 2 Dudum 312 11 2 1 ie ce mtu lom lara aa EL Mem 313 11 2 2 ATOLSAMS terc ELE 315 11 3 DSPGrO p ze to eret eee e d e e ab RR e a E ete t e e d xcu 316 11 4 EP ERU me eRDEr ERA DN Pr caine EK UR ERIT ets 317 11 5 Energy MICKO edu MIA INI 318 11 6 Freescale E nv desse aie feu hati vea reme ERR PE ewes 319 11 6 1 KIN GUIS family ws teres treet nies ee d atn eee ded Que o edt eed dtu ed vocatus 319 11 7 osos reir PII RR ERR E RERE D A 322 11 8 ID EM 323 11 9 IMFINEOM ak A e E uat n 324 11 10 Luminary 325 11 10 1 Unlocking LM3Sxxx 0050 326 11 11 INK Pai RD x ML RM M M MM 327 11 11 1 devices eee nex xr ex 328 11 11 2 Reset Cortex M3 based 7 4 4 1 4 44440 nn 329 11 11 3 1 288 flash
416. xperience 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 serial number and 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 383 15 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 defe
417. xplanation Renamed J Link TCP IP Server to J Link Remote Server Chapter Related Software V4 54 Rev 1 121009 Section TCP IP Server subsection Tunneling Mode added Chapter Flash Breakpoints Section Licensing updated V4 54 Rev 0 120913 Chapter Device specifics Section Freescale subsection Data flash support added Chapter Licensing Section Device based license updated Chapter Flash download Section J Link commander updated Chapter Support and FAQs 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 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 Section Texas Instruments updated Chapter Target interfaces and adapters Section Pinout for SWD updated Chapter Device specifics 22040573 his Section Texas Instruments updated V4 46 Rev 0 120416 EL Chapter Support updated Chapter Working with J Link NIAE RENED Section J Link script files updated Chapter Flash download added Chapter Flash breakpoints added Chapter Target in
418. y any debugger that is 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 154 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 manu
419. y the respective OEM 2 5 1 Analog Devices mIDASLink mIDASLink is an OEM 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 2014 SEGGER Microcontroller GmbH amp Co KG 59 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
420. 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 El E 1 2 E Bic E Lco 4c B B Load C Keil3030 ARM RV30 Boards Keil MCB2300 Blinky Flash Blinky AXF J Link J Trace 0 08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 272 CHAPTER 9 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 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
421. ymore 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 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 Syntax SetCheckModeAfterRead 0 1 Example SetCheckModeAfterRead 0 5 11 1 10 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 J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 204 CHAPTER 5 Working with J Link and J Trace 5 11 1 11 SetResetType This command selects the reset startegy 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 types which are available please refer to Reset strategies on page 181 Please note that there different reset strategies for ARM 7 9 and Cortex M devices Syntax SetResetType lt value gt Example SetResetType 0 Selects reset strategy type 0 normal 5 11 1 12 SetRestartOnClose This command specifies whether the J Link restarts target execution on close The default is to restart target execution This can
422. ypically 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 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 NC Not connected inside J Link Leave open on target hard ware Table 12 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 2014 SEGGER Microcontroller GmbH amp Co KG 359 12 5 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 r
423. z 24MHz J Link V9 Supported SWO input speeds are 60MHz gt 8 7 5MHz 6 66MHz 6MHz J Link J Trace UM08001 2004 2014 SEGGER Microcontroller GmbH amp Co KG 168 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 2014 SEGGER Microcontroller GmbH amp Co KG 169 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

Datasheet - Mouser Electronics

Contents

Download Pdf Manuals

Related Search

Related Contents