Scribd
Upload
31 views

059 Using Renesas CS+ Debugger

Uploaded by

dustyln
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
31 views

059 Using Renesas CS+ Debugger

Uploaded by

dustyln
Copyright
© © All Rights Reserved
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 7

TESSY Application Notes

Renesas CS+ Debugger

Abstract
This document describes the usage of the Renesas CS+ debugger as target system.
The minimum required version of CS+ is V3.01.00. TESSY supports the RL78
controller family.

Table of Contents
Abstract ...................................................................................................................... 1
1 Renesas CS+ Debugger ..................................................................................... 2
1.1 Setup of the CS+ IDE ................................................................................... 2
1.1.1 Loading the Script File Manually ........................................................... 2
1.1.2 Loading the Script File Automatically .................................................... 4
2 TESSY Environment Settings .............................................................................. 4
3 Test Run .............................................................................................................. 6
3.1 Interactive Debugging .................................................................................. 6

TESSY Application Note #059, 06 January 2022 Page 1 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

1 Renesas CS+ Debugger


The communication between TESSY and CS+ is based on an API which uses the
IronPython language. There is a script file contained in the TESSY installation
directory which has to be loaded into CS+ before TESSY can communicate with
CS+. The script automatically connects and disconnects the debugger appropriately
for the test run. If you copy the script into the root folder of the CS+ project you use
for TESSY and rename it to the CS+ project’s name keeping the .py extension, CS+
will automatically load the script when the project is being opened.

1.1 Setup of the CS+ IDE


Before running a test from TESSY, please make sure that the debug hardware and
the target controller on the target board are working correctly when operated from
within CS+ with the CS+ project you plan to use for TESSY’s test runs. You may
create a sample project or use your current development project and download and
run the built program on the debug hardware.
In order to let TESSY communicate with CS+, a special script file has to be loaded.
This file normally does not need to be altered unless you have chosen a different
TESSY test area. The default value is C:\tessy. So, if you have chosen a different
location for the test area during the TESSY installation process, you have to open the
script file using a text editor of your choice and alter the path appropriately.

Please, note that backslashes have to be escaped as shown above!


There are two options to load the script file finally. These options are explained in the
next two subchapters.
1.1.1 Loading the Script File Manually
If you prefer to load the script manually, you will have to do the following steps each
time you open the CS+ project. From the main menu select View->Python Console
to open the Python Console as shown below.

TESSY Application Note #059, 06 January 2022 Page 2 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

Within the Python Console open the context menu (try the right or left mouse
button) and choose Select Script File….

From the dialog navigate to the script file found for example in TESSY’s installation
directory.

TESSY Application Note #059, 06 January 2022 Page 3 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

The script will start running as soon as you have selected the correct file and
confirmed the dialog by clicking Open. If the script started successfully the following
message is displayed in the All Messages Output console.

The message indicates that the script is ready to receive commands from TESSY’s
master. Before you start the test run from within TESSY you have to setup the
TESSY environment using the TESSY environment editor (TEE). This is explained in
the next chapter.
1.1.2 Loading the Script File Automatically
If you copy the script file into the root folder of your CS+ project and rename it to the
name of the CS+ project while keeping the .py extension then the script file will be
opened by CS+ automatically as soon as the project is being opened. The message
in the All Message Output console will be the same as when loading the script file
manually. For instance, if your CS+ project is called TESSY-Test then the script file
should be named TESSY-Test.py and should be found in the same folder as where
TESSY-Test.mtpj is found.

2 TESSY Environment Settings


Copy the location of the device file from your CS+ project

TESSY Application Note #059, 06 January 2022 Page 4 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

and paste it into the TEE attribute Device File as shown below.

Also set the compiler installation directory (Compiler Install Path) and the source
(InitSrcDir) and object (InitObjDir) folder of the board files you will need to link to
your program appropriately. Finally set the attribute Use Board Files to true.

Please note: Only use those board files that are really needed! Create a separate
folder for each source and object board files. Also copy the header files needed by
the board files into the source folder. Keep in mind that you do need board files or
startup code, which can be found in your CS+ project’s source folder.

Finally set the TEE attribute Target Configuration depending on what type of
simulator respectively emulator you suppose to use. Supported values are

TESSY Application Note #059, 06 January 2022 Page 5 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

Simulator
Minicube
Minicube2
Minicube2Jtag
Iecube
Iecube2
E1Jtag
E1Serial
E1Lpd
E20Jtag
E20Serial
E20Lpd

3 Test Run
Since the CS+ IronPython API utilizes the CS+ IDE during a test run, interactive
debugging is also supported by this target adaption. Interactive debugging is
explained in the next section.

3.1 Interactive Debugging


For interactive debugging open TESSY’s Execute Test dialog

and select Define Breakpoint at Test Object as shown below. Clicking Execute will
start the test run and let the CS+ debugger halt at your test object containing your
corresponding test data. The global variables TS_CURRENT_TESTCASE and
TS_CURRENT_TESTSTEP contain the test case respectively the test step number.

TESSY Application Note #059, 06 January 2022 Page 6 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]
TESSY Application Notes

By default, the script jumps to the C source file of your test object. If you do not want
it to open the C source file but instead only watch the Disassemble view you may
set the TEE attribute Jump To Source to false.

TESSY Application Note #059, 06 January 2022 Page 7 of 7


Razorcat Development GmbH
Witzlebenplatz 4  14057 Berlin  Tel. +49 (0) 30 - 536 357 - 0  Fax +49 (0) 30 - 536 357 – 60
[email protected]

You might also like