Segger J-Link User Manual page 162

162
Notes / Limitations
• If target interface JTAG is used: JTAG chain has to be specified manually before leaving
this function (meaning all devices and their TAP IDs have to be specified by the user).
Also appropriate JTAG TAP number to communicate with during the debug session has
to be manually specified in this function.
• MUST NOT use any MEM_ API functions
• Global DLL variable "CPU" MUST be set when implementing this function, so the DLL
knows which CPU module to use internally.
5.12.1.3 SetupTarget()
If present, called after InitTarget() and after general debug connect sequence has been
performed by J-Link. Usually used for more high-level CPU debug setup like writing certain
memory locations, initializing PLL for faster download etc.
Prototype
int SetupTarget(void);
Notes / Limitations
• Does not replace any DLL functionality but extends it.
• May use MEM_ API functions
5.12.1.4 ResetTarget()
Replaces reset strategies of DLL. No matter what reset type is selected in the DLL, if this
function is present, it will be called instead of the DLL internal reset.
Prototype
int ResetTarget(void);
Notes / Limitations
• DLL expects target CPU to be halted / in debug mode, when leaving this function
• May use MEM_ API functions
5.12.1.5 InitEMU()
If present, it allows configuration of the emulator prior to starting target communication.
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 .
Prototype
int InitEMU(void);
5.12.1.6 OnTraceStop()
Called right before capturing of trace data is stopped on the J-Link / J-Trace. On some
target, an explicit flush of the trace FIFOs is necessary to get the latest trace data. If such
a flush is not performed, the latest trace data may not be output by the target
Prototype
int OnTraceStop(void);
Notes / Limitations
• May use MEM_ functions
J-Link / J-Trace (UM08001)
CHAPTER 5
© 2004-2017 SEGGER Microcontroller GmbH & Co. KG
J-Link script files