AN1369
APPLICATION NOTE
GETTING STARTED WITH RAISONANCE IDE
FOR THE ST6 MICROCONTROLLER
by Microcontroller Division Applications
INTRODUCTION
Ride is the development toolchain for ST62 developed by Raisonance. This fully Integrated
Development Environment supports all the ST62 microcontroller family and features a pow-
erful macro-assembler, a linker, a C compiler and a state-of-the-art simulator and debugger. It
can drive the ST6-HDS2, CEIBO EB-ST62 and SOFTEC DS6225A & DS6265A emulators.
You can install the evaluation version from either the “MCU ON CD” CD-ROM or directly from
the Raisonance website:
http://www.raisonance.com.
This tutorial has been extracted from the User Manual of the ST6 Evaluation Board, ST6-Eval,
available on either the “MCU ON CD” CD-ROM or on the ST MCU website
http://mcu.st.com.
For more information about Raisonance IDE, please contact Raisonance at
http://www.rai-
sonance.com
and to get other program examples, please refer to the ST6 Evaluation Board
Manual.
Note:
The corresponding source files are provided in a downloadable .ZIP file along with this
note on the ST MCU website
http://mcu.st.com
The goal of this application note is to help you get started with the Raisonance IDE environ-
ment using an example program
tutorial.st6
located in the directory
.\Exercises\Tutorial.
The exercise will make you familiar with the project management, the assembler syntax and
debugging using the Raisonance IDE.
The aim of the
tutorial.st6
program is to make two LEDs blink at a frequency of 1Hz, simply
using the I/O Ports. It assumes that the LEDs are connected to port
PA0
and
PA1
of the
ST6265C device and are active low.
AN1369/0901
1/23
1
Table of Contents
1 PROJECT SETUP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
2 EDITING THE CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
3 COMPILING THE CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
4 STARTING A DEBUG SESSION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
4.1 STEPPING THROUGH THE CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.2 RUNNING THE CODE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
4.3 SETTING A BREAKPOINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.4 WATCHING A VARIABLE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
4.5 VIEWING THE PERIPHERALS OR THE ST6 REGISTERS . . . . . . . . . . 12
4.6 TIME FEATURE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
4.7 ADVANCED FEATURES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4.7.1
4.7.2
4.7.3
4.7.4
4.7.5
Trace window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Refresh feature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Animate Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Disassembly code window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
External interrupt window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
14
16
18
19
20
5 ENABLING AST6/LST6 RIDE COMPATIBILITY . . . . . . . . . . . . . . . . . . . . . . . 21
23
2/23
2
GETTING STARTED WITH RAISONANCE IDE FOR THE ST6 MICROCONTROLLER
1 PROJECT SETUP
1. Start the Raisonance IDE: from the Windows Start menu, select
Start > Programs > Rai-
sonance Kit 6.1> Ride IDE.
2. Now you need to create a new project environment. The project file stores all the parame-
ters of the project: settings, options, and all the files that have to be included to the project.
To create a new project, go to the Project menu and click on
New.
The dialog box shown in
Figure 1 will appear.
Figure 1. New project dialog box
3. Click on
Browse
to find the path where you want to create your project and name it (e.g.
tutorial.prj). Click on the OK button to validate the creation of the project.
4. Now you have a new window (Project
>Debugger)
with the name of your new project.
Click on it with the right mouse button. A menu shown in Figure 2 will be displayed.
3/23
GETTING STARTED WITH RAISONANCE IDE FOR THE ST6 MICROCONTROLLER
Figure 2. New Project Menu
5. Click on
Add node Source/Application
(or find it in the
Project
menu) to add the file you
want to work on. Choose the
tutorial.st6
assembly file located int the
.\Exercises\Tutorial.
When you select this file, it will display the file code and you will also be able to see it in the
project window as shown below.
Figure 3. Project tree
6. You
HAVE TO
specify the target option before compiling any program. This defines the
microcontroller used to run the program. Click on the
Options > Target
menu and choose
the microcontroler you are working with (the ST6265C in this case). Click OK to validate the
selection.
4/23
GETTING STARTED WITH RAISONANCE IDE FOR THE ST6 MICROCONTROLLER
Figure 4. Type of project dialog box
Now the project environment is set up and you can start playing with the code.
2 EDITING THE CODE
You can now start correcting the file! You will have to fill in the blanks next to the question
marks.
Before you start work, here is a brief explanation of the toolbar.
Figure 5. Editing toolbar
This is a list of the actions invoked by each toolbar icon from left to right:
–
Open
a file in the editor
Note:
Be aware that this only opens a file. It doesn’t open a project (to do that you have to se-
lect
Project > Open)
and it doesn’t add the file to the project automatically (to do that you have
to select
Project > Add node Source/application).
–
Save
the changes you made to your file
–
Tile
the windows vertically
– Enter
Debug
mode
– Compile (Translate) the single file that is activated or the one that is selected in the Project
View window.
– Compile (Make
all)
all the files of the project (recommended)
5/23