Segger J-Link - Script File API Functions

208 CHAPTER 5 Working with J-Link and J-Trace
J-Link / J-Trace (UM08001) ©
2004-2017 SEGGER Microcontroller GmbH & Co. KG
Used to initialize MCU specific trace related things like configuring the trace pins for
alternate function.
Prototype
int OnTraceStart(void);
Return value
>= 0: O.K.
< 0: Error
Notes / Limitations
• May use high-level API functions like JLINK_MEM_ etc.
• Should not call JLINK_TARGET_Halt(). Can rely on target being halted when
entering this function
5.11.2 Script file API functions
In the following, the API functions which can be used in a script file to communicate
with the DLL are explained.
5.11.2.1 MessageBox()
Description
Outputs a string in a message box.
Prototype
__api__ int MessageBox(const char * sMsg);
5.11.2.2 MessageBox1()
Description
Outputs a constant character 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
__api__ int MessageBox1(const char * sMsg, int v);
5.11.2.3 Report()
Description
Outputs a constant character string on stdio.
Prototype
__api__ int Report(const char * sMsg);
5.11.2.4 Report1()
Description
Outputs a constant character string on stdio. In addition to that, a given value (can
be a constant value, the return value of a function or a variable) is added, right
behind the string.
Prototype
__api__ int Report1(const char * sMsg, int v);