UM1014 - STMicroelectronics

UM1014
User manual
Getting started with STM8L-DISCOVERY
Introduction
The STM8L-DISCOVERY, based on the STM8L152C6T6, is a quick-start evaluation board
for 8-bit ultralow-power MCUs. It is the cheapest and quickest way to discover the STM8L, to
program and use the device, and to build and debug applications. It includes the embedded
debugger ST-LINK and an IDD measurement feature which helps you to discover the
ultralow power efficiency.
Connect the STM8L-DISCOVERY to a PC through a standard USB cable, and run the preprogrammed example. Once the debugger is open, you can follow the real-time execution of
the code. A large number of application examples are provided to allow you to learn, reuse
and modify the application source code. This can be used for a quick proof-of-concept
evaluation or demonstration prototype. The STM8L-DISCOVERY is ideal for hobbyists,
developers, students and support teams.
By using this document as a guide and trying out the application examples, you can quickly
get familiar with the STM8L-DISCOVERY and all its possibilities.
Visit www.st.com/stm8l-discovery to access all the user manuals and application notes
related to the STM8L-DISCOVERY.
Reference documents
January 2011
●
STM8L-DISCOVERY evaluation board user manual (UM0970)
●
STM8L-DISCOVERY software user manual Developing and debugging your STMLDISCOVERY application code (UM0991)
●
ST Visual Develop (STVD) user manual (UM0036)
●
Introduction to STM8L15x power saving modes using the STM8L-DISCOVERY IDD
measurement feature (AN3269)
●
Building a wave generator using STM8L-DISCOVERY (AN3252)
●
STM8L15x reference manual (RM0031)
●
STM8L15xx datasheet
Doc ID 18120 Rev 2
1/7
www.st.com
Getting started
UM1014
1
Getting started
1.1
System requirements
Before using the STM8L-DISCOVERY, the following material is required:
1.2
●
A Windows PC (2000, XP, Vista)
●
A USB type A to mini-B cable
Quick start tutorial (less than 20 min)
Start running one of the many STM8L-DISCOVERY application examples from scratch in
less than 20 min.
1.2.1
Software environment
1.
Download your free software environment (IDE). Choose between:
–
ST’s MCU toolset composed of ST Visual Develop (STVD) and ST Visual
Programmer (STVP) available on http://www.st.com
–
IAR Embedded Workbench for STM8 Kickstart edition (8K-limited) available on
www.iar.com, Downloads tab
While IAR Embedded Workbench for STM8 includes its own compiler, STVD must be used
together with either Cosmic or Raisonance compilers.
2.
Note:
Download your free compilers:
–
Cosmic 16 K available on www.cosmicsoftware.com/download_stm8_16k.php
–
Cosmic 32 K one-year limited available on
www.cosmicsoftware.com/download_stm8_32k.php
–
Raisonance 32 K available on www.mcu-raisonance.com
Please note that the Cosmic 32 K version does not include direct support from Cosmic.
To get details on how to install your IDE and/or compilers, read Chapter 2 of UM0991
available on www.st.com/stm8l-discovery.
1.2.2
Connect the STM8L-DISCOVERY to the host PC
The STM8L-DISCOVERY comes pre-programmed with the Discover demo. This demo
consists in discovering the STM8L15x power-saving modes taking advantage of the STM8LDISCOVERY built-in IDD measurement feature.
Connect the STM8L-DISCOVERY to your PC using a USB cable.
The application starts immediately and is displayed dynamically on the LCD. The user can
select the STM8L real-time power consumption in each mode using the User push-button
interface. Download application note AN3269 from www.st.com/stm8l-discovery to get more
details about this demo.
2/7
Doc ID 18120 Rev 2
UM1014
Getting started
Table 1.
Bars
1.2.3
Bars and LCD display linked to functions
LED3/LED4
Displayed on the LCD
Blink
STM8L VDD voltage measured
OFF
STM8L power consumption in Run mode
OFF
STM8L power consumption in Low power run mode with LCD on
OFF
STM8L power consumption in Low power run mode with LCD off
OFF
STM8L power consumption in Halt mode
Running the STM8L-DISCOVERY application examples
STM8L-DISCOVERY is provided with numerous application examples available on
www.st.com/stm8l-discovery.
Make sure your free software environment (STVD in this case) is correctly installed.
1.
Download one of the application examples as well as its associated application note,
available on www.st.com/stm8l-discovery and extract directory STM8LDISCOVERY_Example on your PC.
– Cosmic: STM8L-Discovery_Example/Project/Example/STVD/Cosmic/Example.stw
– Raisonance:
STM8L-Discovery_Example/Project/Example/STVD/Raisonance/Example.stw
2.
Configure STVD to use ST-LINK as a debug instrument:
– Click Debug Instrument -> Target Settings.
– Select target Swim ST-LINK in the target list.
3.
Select the appropriate MCU:
– Go to Projects>Settings>MCU and select STM8L152C6 from the MCU list.
Doc ID 18120 Rev 2
3/7
Getting started
UM1014
– Make sure that the MCU selected is displayed in the selected MCU field before
clicking OK.
4.
Click Build -> Rebuild All to build your application.
5.
Click Debug -> Start Debugging to download your application to the STM8L program
memory and start the debug session.
6.
Run the application code in Debug or Stand-alone mode:
a)
Click Debug -> Run to run your application in debug mode.
b)
Click Debug -> Stop Debugging to disconnect the debugger; then, the
application starts running immediately in stand-alone mode.
Once the selected application is running, check whether it operates as described in the
application note associated to the example.
Note:
Some of the available examples require additional components to work properly. Please
refer to the application note associated to the example selected to find out more about it.
1.2.4
Developing your own application
1.
2.
Install the free software environment (IDE and/or compilers) of your choice. Please
refer to Section 1.2.1.
Install the STM8L-DISCOVERY development package.
– Download STM8L-Discovery_dev.zip from www.st.com/stm8l-discovery (zip file
available together with UM0991) and extract the directory structure on your PC.
– Duplicate the project_template directory and rename it (My_own_project).
3.
Run the Integrated Development Environment of your choice.
4.
Select File -> Open Workspace.
5.
Browse for the project file .stw of My_own_project you intend to run according to the
IDE and/or compiler you have selected:
– STVD with Cosmic: STM8LDiscovery_My_own_project/Project/My_own_project/STVD/Cosmic/STVD_workspac
e.stw
– STVD with Raisonance: STM8LDiscovery_My_own_project/Project/My_own_project/STVD/Raisonance/STVD_work
space.stw
– IAR Embedded Workbench (EWSTM8): STM8LDiscovery_My_own_project/Project/My_own_project/STVD/EWSTM8/workspace.stw
This procedure provides for a prestructured project workspace and simplifies your project
design.
Detailed instructions on the project creation are provided in user manual UM0991
Developping and debugging your STM8L-Discovery application code, available for
download from www.st.com/stm8l-discovery.
4/7
Doc ID 18120 Rev 2
UM1014
2
Support
Support
Visit our STM8L-DISCOVERY forum on www.st.com/stm8l-discovery.
Contact our technical support on www.st.com.
Doc ID 18120 Rev 2
5/7
Revision history
3
UM1014
Revision history
Table 2.
6/7
Document revision history
Date
Revision
Changes
09-Dec-2010
1
Initial release.
06-Jan-2011
2
Updated ST’s MCU toolset URL under Section 1.2.1.
Doc ID 18120 Rev 2
UM1014
Please Read Carefully:
Information in this document is provided solely in connection with ST products. STMicroelectronics NV and its subsidiaries (“ST”) reserve the
right to make changes, corrections, modifications or improvements, to this document, and the products and services described herein at any
time, without notice.
All ST products are sold pursuant to ST’s terms and conditions of sale.
Purchasers are solely responsible for the choice, selection and use of the ST products and services described herein, and ST assumes no
liability whatsoever relating to the choice, selection or use of the ST products and services described herein.
No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted under this document. If any part of this
document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products
or services, or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such
third party products or services or any intellectual property contained therein.
UNLESS OTHERWISE SET FORTH IN ST’S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED
WARRANTY WITH RESPECT TO THE USE AND/OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED
WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE (AND THEIR EQUIVALENTS UNDER THE LAWS
OF ANY JURISDICTION), OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED ST REPRESENTATIVE, ST PRODUCTS ARE NOT
RECOMMENDED, AUTHORIZED OR WARRANTED FOR USE IN MILITARY, AIR CRAFT, SPACE, LIFE SAVING, OR LIFE SUSTAINING
APPLICATIONS, NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY,
DEATH, OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE. ST PRODUCTS WHICH ARE NOT SPECIFIED AS "AUTOMOTIVE
GRADE" MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER’S OWN RISK.
Resale of ST products with provisions different from the statements and/or technical features set forth in this document shall immediately void
any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever, any
liability of ST.
ST and the ST logo are trademarks or registered trademarks of ST in various countries.
Information in this document supersedes and replaces all information previously supplied.
The ST logo is a registered trademark of STMicroelectronics. All other names are the property of their respective owners.
© 2011 STMicroelectronics - All rights reserved
STMicroelectronics group of companies
Australia - Belgium - Brazil - Canada - China - Czech Republic - Finland - France - Germany - Hong Kong - India - Israel - Italy - Japan Malaysia - Malta - Morocco - Philippines - Singapore - Spain - Sweden - Switzerland - United Kingdom - United States of America
www.st.com
Doc ID 18120 Rev 2
7/7
Download PDF