Lauterbach STM8 Manuel utilisateur

STM8 Debugger 1

STM8 Debugger

TRACE32 Online Help

TRACE32 Directory

TRACE32 Index

TRACE32 Documents ...................................................................................................................... 

ICD In-Circuit Debugger ................................................................................................................ 

Processor Architecture Manuals .............................................................................................. 

STM8 ......................................................................................................................................... 

STM8 Debugger .................................................................................................................... 1

History ................................................................................................................................ 3

Introduction ....................................................................................................................... 4

Brief Overview of Documents for New Users 4

Demo and Start-up Script 4

Configuration ..................................................................................................................... 5

System Overview 5

Warning .............................................................................................................................. 6

Quick Start ......................................................................................................................... 7

Troubleshooting ................................................................................................................ 9

FAQ ..................................................................................................................................... 10

Debugger 10

STM8 specific SYStem Settings ....................................................................................... 12

SYStem.CPU Select the used CPU 12

SYStem.CpuAccess Run-time memory access (intrusive) 12

SYStem.MemAccess Real-time memory access (non-intrusive) 13

SYStem.Mode Establish the communication with the target 13

SYStem.LOCK Lock and tristate the debug port 13

SYStem.Option IMASKASM Disable interrupts while single stepping 14

SYStem.Option IMASKHLL Disable interrupts while HLL single stepping 14

STM8 specific TrOnchip Command .................................................................................15

TrOnchip.VarCONVert Adjust complex breakpoint in on-chip resource 15

Breakpoints ........................................................................................................................ 16

Software breakpoints 16

On-chip breakpoints for instructions 16

On-chip breakpoints for data 16

Memory Classes ................................................................................................................ 17

STM8 Debugger 2

Target Adaption ................................................................................................................. 18

Connector Type and Pinout 18

Support ............................................................................................................................... 18

Available Tools 19

Compilers 22

Products ............................................................................................................................. 23

Product Information 23

Order Information 23

STM8 Debugger 3

STM8 Debugger

Version 16-Apr-2019

History

14-Feb-18 New manual.

STM8 Debugger 4

Introduction

This document serves as a guideline for debugging STM8 MCUs and describes all MCU-specific

TRACE32 settings and features.

Please keep in mind that only the Processor Architecture Manual (the document you are reading at the

moment) is CPU specific, while all other parts of the online help are generic for all CPUs supported by

Lauterbach. So if there are questions related to the CPU, the Processor Architecture Manual should be your

first choice.

Brief Overview of Documents for New Users

Architecture-independent information:

•“Debugger Basics - Training” (training_debugger.pdf): Get familiar with the basic features of a

TRACE32 debugger.

•“T32Start” (app_t32start.pdf): T32Start assists you in starting TRACE32 PowerView instances

for different configurations of the debugger. T32Start is only available for Windows.

•“General Commands” (general_ref_<x>.pdf): Alphabetic list of debug commands.

Architecture-specific information:

•“Processor Architecture Manuals”: These manuals describe commands that are specific for the

processor architecture supported by your debug cable. To access the manual for your processor

architecture, proceed as follows:

- Choose Help menu > Processor Architecture Manual.

•“OS Awareness Manuals” (rtos_<os>.pdf): TRACE32 PowerView can be extended for operating

system-aware debugging. The appropriate OS Awareness manual informs you how to enable the

OS-aware debugging.

Demo and Start-up Script

The on-chip FLASH and the EEProm memory can be programmed via the stm8.cmm script:

Please be aware that you should check the Flash and EEProm size specified for your MCU in the stm8.cmm

before executing this script.

CD.DO ~~/demo/stm8/flash/stm8.cmm

STM8 Debugger 5

Configuration

System Overview

Example configuration for an STM8 debugger.

Target

DEBUG CABLE

LAUTERBACH

Debug Cable

POWER DEBUG INTERFACE / USB 3

AC/DC Adapter

USB

Cable

LAUTERBACH

POWER

SELECT

EMULATE

PODBUS OUT

USB

PODBUS IN

DEBUG CABLE

POWER

7-9V

TRIG

POWER DEBUG USB INTERFACE / USB 3

Debug

Connector

Windows / Linux / Mac OS

STM8 Debugger 6

Warning

NOTE: To prevent debugger and target from damage it is recommended to connect or

disconnect the debug cable only while the target power is OFF.

Recommendation for the software start:

1. Disconnect the debug cable from the target while the target power is

off.

2. Connect the host system, the TRACE32 hardware and the debug

cable.

3. Power ON the TRACE32 hardware.

4. Start the TRACE32 software to load the debugger firmware.

5. Connect the debug cable to the target.

6. Switch the target power ON.

7. Configure your debugger e.g. via a start-up script.

Power down:

1. Switch off the target power.

2. Disconnect the debug cable from the target.

3. Close the TRACE32 software.

4. Power OFF the TRACE32 hardware.

STM8 Debugger 7

Quick Start

Starting up the debugger is done as follows:

1. Select the device prompt B (BDM debugger) and reset TRACE32.

The device prompt B:: is normally already selected in the TRACE32 command line. If this is not the

case enter B:: to set the correct device prompt. The RESet command is only necessary if you do not

start directly after booting the TRACE32 development tool.

2. Specify the CPU specific settings.

This command selects the CPU type.

3. Inform the debugger about cashable address range (FLASH/EEPROM)..

This is important to speed up the T32 GUI responsiveness. The specified address range will be

accesses only once after a break, thus avoiding unnecessary memory accesses.

4. Reset the target and enter debug mode.

This command resets the CPU on the target, enables On-Chip-Debug Mode and issues a breakpoint

right after the reset interrupt routine.The CPU stops executing any instruction, and the user is able to

download the code and test. After this command is executed, it is possible to access memory and

registers.

B::

RESet

SYStem.CPU STM8S005K6

MAP.UpdateOnce p:0x8000--0xffff

SYStem.Mode Up

STM8 Debugger 8

5. Load the program into the flash.

A typical start sequence of the STM8 is shown below. This sequence can be written to a PRACTICE script

file (*.cmm, ASCII file format) and executed with the command DO <filename>.

*) These commands open windows on the screen. The window position can be specified with the WinPOS

command.

DO ~~/demo/stm8/flash/stm8.cmm

B:: ; Select the ICD device prompt

RESet ; Reset the TRACE32 software

MAP.UpdateOnce p:0x8000--

0xffff

; Specify the address range for caching

WinCLEAR ; Clear all windows

SYStem.Up ; Reset the target and enter debug mode

~~/demo/stm8/flash/stm8.cmm

; Load the target application into the

Flash

PER.view ; Show clearly arranged peripherals

; in window *)

List.Mix ; Open source code window *)

Frame.view /Locals /Caller ; Open the stack frame with

; local variables *)

Var.Watch %SpotLight flags ast ; Open watch window for variables *)

Break.Set 0x1000 /Program ; Set software breakpoint to address

; 1000 (address 1000 is within RAM

; address range)

Break.Set 0x101000 /Program ; Set on-chip breakpoint

; to address 101000 (address 101000 is

; within Flash address range)

STM8 Debugger 9

Troubleshooting

Typically the SYStem.Up command is the first command of a debug session where communication with the

target is required. If you receive error messages like “debug port fail” or “debug port time out” while executing

this command, this may have the reasons below. “target processor in reset” is just a follow-up error

message.

• Open the AREA.view window to display all error messages.

• If the target has no power or the debug cable is not connected to the target, this results in the

error message “target power fail”.

• Did you select the correct core type SYStem.CPU <type>?

• There is an issue with the SWD interface. Maybe there is the need to set jumpers on the target to

connect the correct signals to the SWD connector.

• The target is in an unrecoverable state. Re-power your target and try again.

• The core is kept in reset.

• There is a watchdog which needs to be deactivated.

Error Message Event Reason

target power fail SYStem.Mode.Up See below.

target processor in reset SYStem.Down See below.

Target is not connected

or the SWD Interface is

returning an error.

SYStem.Mode.Up

SYStem.Mode.Go

The debugger expects to receive a

confirmation for each command sent to

the target. An error occurs in case the

confirmation is not received.

The number of

<number> accessed

bytes in memory is not a

multiple of the access

<size> bytes.

No special event Internal error, please consult your

Lauterbach representative.

Memory <address> is

not aligned to access

<size>.

No special event Internal error, please consult your

Lauterbach representative.

Invalid memory access

size: <size> bytes (@

<address>)

No special event Internal error, please consult your

Lauterbach representative.

Memory access timeout:

Reading from

No special event Corrupted JTAG connection. Check

JTAG hardware and settings.

STM8 Debugger 1 0

FAQ

Debugger

Debugging via

VPN

Ref: 0307

The debugger is accessed via Internet/VPN and the performance is very

slow. What can be done to improve debug performance?

The main cause for bad debug performance via Internet or VPN are low data

throughput and high latency. The ways to improve performance by the debugger

are limited:

In PRACTICE scripts, use "SCREEN.OFF" at the beginning of the script

and "SCREEN.ON" at the end. "SCREEN.OFF" will turn off screen

updates. Please note that if your program stops (e.g. on error) without exe-

cuting "SCREEN.OFF", some windows will not be updated.

"SYStem.POLLING SLOW" will set a lower frequency for target state

checks (e.g. power, reset, jtag state). It will take longer for the debugger to

recognize that the core stopped on a breakpoint.

"SETUP.URATE 1.s" will set the default update frequency of

Data.List/Data.dump/Variable windows to 1 second (the slowest possible

setting).

prevent unneeded memory accesses using "MAP.UPDATEONCE

[address-range]" for RAM and "MAP.CONST [address--range]" for

ROM/FLASH. Address ranged with "MAP.UPDATEONCE" will read the

specified address range only once after the core stopped at a breakpoint or

manual break. "MAP.CONST" will read the specified address range only

once per SYStem.Mode command (e.g. SYStem.Up).

Autres manuels pour STM8

Table des matières

Autres manuels Lauterbach Accessoires informatiques

Lauterbach

Lauterbach TRACE32-ICD Manuel utilisateur

Lauterbach

Lauterbach TRACE32 Manuel utilisateur

Lauterbach

Lauterbach XC800 Manuel utilisateur

Lauterbach

Lauterbach C6000 Manuel utilisateur

Lauterbach

Lauterbach TRACE32-ICD Manuel utilisateur

Lauterbach

Lauterbach dsPIC33 Manuel utilisateur

Lauterbach

Lauterbach TRACE 32 Instructions d'utilisation d'origine

Lauterbach

Lauterbach MMDSP Manuel utilisateur

Lauterbach

Lauterbach MicroBlaze Debugger Manuel utilisateur

Lauterbach

Lauterbach AVR8 Manuel utilisateur

Lauterbach

Lauterbach PowerTrace Serial Manuel utilisateur

Lauterbach

Lauterbach TRACE32 Manuel utilisateur

Manuels Accessoires informatiques populaires d'autres marques

Motorola

Motorola ATRIX Manuel utilisateur

HP USB Media Docking Station Manuel utilisateur

Cherry

Cherry B.UNLIMITED 3.0 Manuel utilisateur

Logitech

Logitech IO2 Manuel utilisateur

ARM

ARM DSTREAM-ST Manuel utilisateur

Bartec

Bartec TC 7 Series Manuel utilisateur

Philips

Philips SPC3540 Manuel utilisateur

Logitech

Logitech mk220 Manuel utilisateur

SilverStone

SilverStone LC02 Manuel utilisateur

Flexispot

Flexispot ML2B Manuel utilisateur

Hamlet

Hamlet UNIVERSAL COVER 101 KBT2 Manuel utilisateur

Adam Equipment

Adam Equipment RS-485 Manuel utilisateur

Vivo

Vivo MOUNT-KB05-4DW Manuel utilisateur

Kvaser

Kvaser Memorator Professional Manuel utilisateur

DRC

DRC D-Imaging Manuel utilisateur

Sven

Sven Base 305 сombo Manuel utilisateur

Hama

Hama 108310 Manuel utilisateur

SpeechWare

SpeechWare FlexyMike FMK03 Manuel utilisateur