ST UM0501 User manual

June 2009 Doc ID 14320 Rev 3 5/23
UM0501
User manual
STM8/128-EVAL demonstration firmware
Introduction
This document describes the demonstration firmware running on the STM8/128-EVAL
evaluation board. You can use it to evaluate the capabilities of the microcontroller and the
on-board peripherals.
The evaluation board is delivered with the demonstration firmware stored in the Flash
program memory of the microcontroller.
The firmware is based on the STM8S firmware library, and provides an example of how to
use this library. It is divided into various smaller demonstration applications (demos).
In case the STM8/128-EVAL evaluation board is not factory-programmed or the
demonstration application has been erased, you can reprogram the demonstration firmware
into the STM8S2xx Flash memory by following the instructions provided in Section 3.
For more information about the evaluation board itself, please read the evaluation board
user manual.
Note: To run some of the demonstration applications, the option byte must be configured
accordingly. Refer to Section 2.10: BEEPER demo.
www.st.com

Contents UM0501
6/23 Doc ID 14320 Rev 3
Contents
1 User interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.1 Menu structure . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.2 Documentation conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.3 Navigating menus and sub-menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
2 Demonstration applications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.1 Menu overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.2 Welcome screen and main menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2.3 Help mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.4 ADC demo 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
2.5 ADC demo 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.6 ADC demo 3 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.7 TIMER demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
2.8 PWM demo 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
2.9 PWM demo 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.10 BEEPER demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
2.11 MICROSD demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.12 GAME demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.13 SYSTEM demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2.14 About menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3 Upgrading the demonstration firmware . . . . . . . . . . . . . . . . . . . . . . . . 19
4 STM8S peripherals used . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5 Demo firmware architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
6 Revision history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

UM0501 User interface
Doc ID 14320 Rev 3 7/23
1 User interface
1.1 Menu structure
The demonstration firmware user interface is based on a circular navigation menu, with
submenus, item selection and back capability.
Figure 1 shows the menu system of the demonstration. The top row of items represents the
main menu.
Figure 1. Menu structure and navigation
1.2 Documentation conventions
In this document, the keywords in bold indicate user actions on the joystick (5-way switch).
The KEY button (1-way switch) and the RV1 potentiometer follow the conventions shown in
Ta bl e 1 .
...
...
...
Up Up Up
Up Up Up
... ...
...
Left / Right Left / Right Left/Right
WELCOME
MESSAGE
ITEM 1 ITEM 2 ITEM 3 ITEM n
ITEM
1.1
ITEM
1.2
ITEM
1.n
ITEM
2.1
ITEM
2.2
ITEM
2.n
SEL
SEL
SEL
SEL
... ... ... ... ...
SEL
SEL SEL SEL SEL SEL SEL
Table 1. Documentation conventions
Keyword User action
LEFT Press joystick to the left
RIGHT Press joystick to the right
UP Press joystick up
DOWN Press joystick down
SEL Press joystick center
KEY Press KEY button
RV1 Rotate RV1 potentiometer

User interface UM0501
8/23 Doc ID 14320 Rev 3
1.3 Navigating menus and sub-menus
To navigate the menus and sub-menus, perform the following actions as required.
RIGHT: Navigates to the next menu or sub-menu items on the right.
LEFT: Navigates to the next menu or sub-menu items on the left.
SEL: Enters sub-menu.
UP: Exits from a sub-menu.

UM0501 Demonstration applications
Doc ID 14320 Rev 3 9/23
2 Demonstration applications
2.1 Menu overview
The Figure 2 shows all the menu and submenus of the demonstration applications.
Figure 2. Menu overview
The following sections provides a detailed description of each part of the demonstration
firmware.
2.2 Welcome screen and main menu
After a board RESET, a welcome message is displayed on the first line, the ST logo is
displayed moving on the second line and a melody is played (see Figure 3). The introduction
melody can be changed by using either PWM demo 1 or PWM demo 2 (see Section 2.8 and
Section 2.9).
Figure 3. Welcome message
Once the melody is played, the main menu is activated and the message shown in Figure 4
is displayed.
Figure 4. Main menu
Note: Pressing the joystick in any direction (for around 1 second) ends the melody.
ABOUT
WELCOME MESSAGE
ADC DEMO1
HELP ADC
MAIN MENU
TIMER MICROSD
ADC DEMO2 ADC DEMO3
GAME
PWM1 PWM2
SYSTEM
PWM BEEPER
STM8-128K Demo
ST
** MENU **
HELP - push SEL

Demonstration applications UM0501
10/23 Doc ID 14320 Rev 3
2.3 Help mode
Pressing SEL from the main menu enters the Help mode. The following messages are
displayed sequentially on the LCD screen with a few second delay.
Figure 5. Help mode submenus
To exit this demo, press the joystick UP.
2.4 ADC demo 1
This mode demonstrates the ADC operation that are performed using the RV1
potentiometer on the evaluation board.
The converted value is displayed in different ways (see Figure 6).
●On the LCD first line: in percentage of the ADC range, in hexadecimal and decimal
format
●On the LCD second line: in a bar graph from 0% to 100% of the ADC range.
●On the 4 LEDs: each LED represents approximately 25% of the ADC range.
If KEY is pressed, the converted value is output also on USART1 and/or USART2 interfaces
and/or a sound is played on the buzzer using the timer PWM.
Figure 6. ADC demo 1 message
LEFT or RIGHT
to scroll menu
Press SEL to
enter sub-menu
Move UP to
exit sub-menu
065% 29Eh 0670d

UM0501 Demonstration applications
Doc ID 14320 Rev 3 11/23
UP:Press the joystick UP to exit this demo.
KEY: Press KEY repeatedly to enable the output of each converted value option in turn.
LCD only
LCD+Buzzer
LCD+USART1
LCD+USART2
LCD+USART1+USART2
LCD+USART1+USART2+Buzzer
LCD only
etc...
2.5 ADC demo 2
This is the same as ADC demo 1, except that the CN3 connector on the evaluation board is
used to enter the analog voltage to be converted.
UP: Press the joystick UP to exit this demo.
KEY: Press KEY to enable/disable output values on USART1, USART2 and buzzer as
described in the previous section.
2.6 ADC demo 3
This is the same as ADC demo 1 and ADC demo 2, except that the microphone (U8) is
used.
Note: The JP5 jumper must be installed for this demo to work.
A first message is displayed with a few seconds delay with all LEDs OFF (see Figure 7).
Figure 7. ADC demo 3 message
After 3 “noises” are heard, the demo starts and the LCD displays the same messages as in
ADC demo 1 and demo 2.
UP: Press the joystick UP to exit this demo.
KEY: Press KEY to enable/disable output values on USART1, USART2 and buzzer.
Note: If no sound is detected, you can adjust the microphone level using the RV3 potentiometer.
You can also make a sound by touching the microphone.
Clap 3 times
to wake me up

Demonstration applications UM0501
12/23 Doc ID 14320 Rev 3
2.7 TIMER demo
This mode demonstrates the Timer peripheral operation.
1. To run the TIMER demo, enter the timer start value (from 1 to 18 minutes) using the
RV1 potentiometer (see Figure 8).
Figure 8. Entering the timer start value
2. Once the requested value is set, press SEL on the joystick to start the timer. The
remaining time is displayed on the LCD screen (see Figure 9).
Figure 9. Remaining time message
3. When the value reaches 00:10, a sound is heard for each second elapsed.
When the value reaches 00:00 the four LEDs flash and the message shown in
Figure 10 is displayed.
Figure 10. TIMER demo termination message
UP: Press the joystick UP to exit this demo.
KEY: Press KEY repeatedly to divide counter pulse duration by 2 (1 second, 0.5 second,
0.25 second, ... 31.25 ms, 1 second,...).
TIMER DEMO
03:00
Remaining...
01:45
Terminated!!!
00:00

UM0501 Demonstration applications
Doc ID 14320 Rev 3 13/23
2.8 PWM demo 1
This mode demonstrates the Timer peripheral operating in PWM mode. Make sure that the
JP14 jumper is installed in the bottom position (closer to the LCD).
1. Entering the melody (see Figure 11):
The first LCD line shows the position of the note to enter.
o= Edit mode, the note is selected by using the RV1 potentiometer.
x= Protect mode, the note cannot be changed.
The second LCD line shows the notes to be played with the following convention:
a/A = LA
b/B = SI
c/C = DO
d/D = RE
e/E = MI
f/F = FA
g/G = SOL
s/S = silence or pause
A lowercase letter represent a brief note, and an uppercase letter a long note.
To modify a note, press the joystick LEFT or RIGHT to navigate the notes, and use the
RV1 potentiometer. Then press SEL to confirm.
Once all the notes have been defined, enter an end mark to play the melody.
*= End of notes, the melody is played only once.
8= End of melody, the melody is played in a loop with varying octaves and note
durations.
Figure 11. Defining the melody to be played
2. Playing and saving the melody
●Press SEL on the joystick to play the tune indefinitely.
●Press the joystick UP to stop the melody.
Note: Keep the joystick pressed UP for a short time to allow the action to be taken into account.
●The second time UP is pressed, a message is displayed asking you whether you want
to save the melody or not (see Figure 12).
a) If you press the KEY button, the melody is saved in the external EEPROM.
b) If you press UP on the joystick, you exit from the demo without saving the melody.
o
aaaBBBccdEE*

Demonstration applications UM0501
14/23 Doc ID 14320 Rev 3
Figure 12. Saving the melody
LEFT/RIGHT: Press the joystick LEFT or RIGHT to navigate the notes.
SEL: Press SEL to confirm a note and go to the next one.
KEY: Press KEY to switch between edit and protected modes.
RV1: Use RV1 potentiometer to define the notes.
2.9 PWM demo 2
This demo also demonstrates the Timer peripheral operating in PWM mode. Make sure that
the JP14 jumper is installed in the bottom position (closer to LCD).
This demo allows to select and play one melody among a selection stored in the Flash
memory (see Figure 13).
1. Navigate between the melodies by pressing the joystick LEFT or RIGHT, and press
SEL to select and play the melody (see Figure 13)
Figure 13. Selecting a melody
2. The first time UP is pressed, the melody is stopped.
Note: Keep the joystick pressed UP for a short time to allow the action to be taken into account.
3. The second time UP is pressed, a message is displayed asking you to save the melody
or not.
a) If you press the KEY button, the melody is saved in the external EEPROM.
a) If you press UP, you exit from the demo without saving the melody.
LEFT/RIGHT: Press the joystick LEFT or RIGHT to navigate the melodies.
SEL: Press SEL to select a melody and play it.
Save melody ?
KEY=YES UP=NO
Select Melody
Bon Tabac