J-Link / J-Trace User Guide (UM08001) - Microcontrollers

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 performed
by J-Link, since some custom hardware needs some special handling which
can not 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 does support most statements (if-else, while,
declaration of variables, ...) which are allowed in C, but not all of them. Moverover,
there are some statements that are script file specific. The script file allows maximum
flexibility, 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. If
an generic-implemented action is replaced by an action defined in a scriptfile
depends on if the corresponding function is present in the scriptfile. In the following
all J-Link actions which can be customized using a script file, are listed and
explained.
5.10.1.1 ResetTarget()
Decsription
If present, it replaces the reset strategy performed by the DLL when issuing a reset.
Prototype
void ResetTarget(void);
5.10.1.2 InitEMU()
Decsription
If present, it allows configuration of the emulator prior to starting target communication.
Currently this function is only used to configure if the target which is connected
to J-Link has an ETB or not. For more information how to configure the existence of
an ETB, please refer to Global DLL variables on page 120.
Prototype
void InitEMU(void);
5.10.1.3 InitTarget()
Decsription
If present, it can replace the auto-detection capability of J-Link. Some targets can
not be auto-detected by J-Link since some special target initialization is necessary
before communication with the core is possible. Moreover, J-Link uses a TAP reset to
get the JTAG IDs of the devices in the JTAG chain. On some targets this disables
access to the core.
Prototype
void InitTarget(void);
5.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-2010 SEGGER Microcontroller GmbH & Co. KG
117