SEGGER embOS Operating Instruction
embOS
Real-Time Operating System
embOS plug-in for IAR C-Spy Debugger
Document: UM01025
Software Version: 3.6
Revision: 0
Date: February 11, 2021
A product of SEGGER Microcontroller GmbH
www.segger.com
2
Disclaimer
Specifications written in this document are believed to be accurate, but are not guaranteed to
be entirely free of error. The information in this manual is subject to change for functional or
performance improvements without notice. Please make sure your manual is the latest edition.
While the information herein is assumed to be accurate, SEGGER Microcontroller GmbH (SEGGER) assumes no responsibility for any errors or omissions. SEGGER makes and you receive no
warranties or conditions, express, implied, statutory or in any communication with you. SEGGER
specifically disclaims any implied warranty of merchantability or fitness for a particular purpose.
Copyright notice
You may not extract portions of this manual or modify the PDF file in any way without the prior
written permission of SEGGER. The software described in this document is furnished under a
license and may only be used or copied in accordance with the terms of such a license.
© 2005-2021 SEGGER Microcontroller GmbH, Monheim am Rhein / Germany
Trademarks
Names mentioned in this manual may be trademarks of their respective companies.
Brand and product names are trademarks or registered trademarks of their respective holders.
Contact address
SEGGER Microcontroller GmbH
Ecolab-Allee 5
D-40789 Monheim am Rhein
Germany
Tel. +49 2173-99312-0
Fax. +49 2173-99312-28
E-mail:
Internet: www.segger.com
support@segger.com
*
*
By sending us an email your (personal) data will automatically be processed. For further information please refer to our
privacy policy which is available at https://www.segger.com/legal/privacy-policy/.
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
3
Manual versions
This manual describes the current software version. If you find an error in the manual or a
problem in the software, please inform us and we will try to assist you as soon as possible.
Contact us for further information on topics or functions that are not yet documented.
Print date: February 11, 2021
Software Revision Date By Description
3.6 1 210211 MC
3.6 0 201030 MC
3.5 0 200603 MC
3.4 0 200325 MM
3.3 0 191205 MC
3.2 0 191106 MC
3.1 1 180924 MC
3.1 0 180503 MC
3.0 0 170915 MM
New plug-in versions 6.10.3.7, 7.10.3.7, 7.50.3.7, 8.10.3.7, 8.30.3.7, and
9.10.3.7.
New plug-in versions 6.10.3.6, 7.10.3.6, 7.50.3.6, 8.10.3.6, and 8.30.3.6.
New plug-in versions 6.10.3.5, 7.10.3.5, 7.50.3.5, 8.10.3.5, and 8.30.3.5.
New plug-in versions 6.10.3.4, 7.10.3.4, 7.50.3.4, 8.10.3.4, and 8.30.3.4.
New plug-in version 8.30.3.3.
New plug-in versions 6.10.3.2, 7.10.3.2, 7.50.3.2, 8.10.3.2, and 8.30.3.2.
Updated to include most recent versions of IAR embedded workbench and
their compatible plug-ins.
New plug-in versions 6.10.3.1, 7.10.3.1, 7.50.3.1, 8.10.3.1, and 8.30.3.1.
New plug-in versions 6.10.3.0, 7.10.3.0, 7.50.3.0, and 8.10.3.0.
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
4
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
5
About this document
Assumptions
This document assumes that you already have a solid knowledge of the following:
• The software tools used for building your application (assembler, linker, C compiler).
• The C programming language.
• The target processor.
• DOS command line.
If you feel that your knowledge of C is not sufficient, we recommend The C Programming Lan-
guage by Kernighan and Richie (ISBN 0--13--1103628), which describes the standard in C programming and, in newer editions, also covers the ANSI C standard.
How to use this manual
This manual explains all the functions and macros that the product offers. It assumes you have
a working knowledge of the C language. Knowledge of assembly programming is not required.
Typographic conventions for syntax
This manual uses the following typographic conventions:
Style Used for
Body Body text.
Keyword
Parameter Parameters in API functions.
Sample Sample code in program examples.
Sample comment Comments in program examples.
Reference
GUIElement Buttons, dialog boxes, menu names, menu commands.
Emphasis Very important sections.
Text that you enter at the command prompt or that appears on
the display (that is system functions, file- or pathnames).
Reference to chapters, sections, tables and figures or other documents.
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
6
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
7
Table of contents
1 Introduction ....................................................................................................................8
1.1 Overview ...................................................................................................... 9
1.2 Supported Embedded Workbench variants .......................................................10
2 Installation ...................................................................................................................11
2.1 Installation Procedure ................................................................................... 12
2.2 Configuration ............................................................................................... 13
3 Getting Started ............................................................................................................14
3.1 Overview .....................................................................................................15
3.2 Task List ..................................................................................................... 16
3.3 Timers ........................................................................................................ 19
3.4 Mailboxes .................................................................................................... 20
3.5 Queues ....................................................................................................... 21
3.6 Mutexes ...................................................................................................... 22
3.7 Semaphores ................................................................................................ 23
3.8 Memory Pools .............................................................................................. 24
3.9 Event Objects .............................................................................................. 25
3.10 Watchdogs .................................................................................................26
3.11 System Information .................................................................................... 27
3.12 Settings .................................................................................................... 28
3.13 About ........................................................................................................30
4 Support ........................................................................................................................31
4.1 Contacting support ....................................................................................... 32
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
Chapter 1
Introduction
This chapter gives a short overview about the embOS C-Spy plug-in for IAR Embedded
Workbench.
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
9 CHAPTER 1 Overview
1.1 Overview
1.1.1 embOS C-Spy Plug-in for IAR Embedded Workbench
SEGGER’s embOS C-Spy plug-in for IAR Embedded Workbench provides embOS-awareness
during debug sessions. This enables you to inspect the state of several embOS primitives
such as the task list, queues, mutexes, semaphores, mailboxes, software timers, memory
pools, event objects, watchdogs, and major system variables.
1.1.2 embOS
embOS is a real-time operating system for embedded applications designed to offer the
benefits of a fully-fledged multitasking system at minimum cost. The kernel is fully interruptible and so efficient that embOS can be used in very time critical situations. The memory footprint in both RAM and ROM is so small that embOS can be used in single-chip applications, leaving maximum room for the user-program.
1.1.3 IAR Embedded Workbench
IAR Embedded Workbench is a set of development tools for building and debugging embedded applications using assembler, C and C++. It provides a completely integrated development environment that includes a project manager, editor, build tools and the C-SPY
debugger. IAR Embedded Workbench supports a wide range of microcontrollers and cores
from different chip manufacturers. It offers the same intuitive user interface regardless
of which microcontroller you have chosen to work with -- coupled with general and target-specific support for each chip.
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
10 CHAPTER 1 Supported Embedded Workbench variants
1.2 Supported Embedded Workbench variants
The following plug-ins are available and may be used with the listed versions of IAR’s
Embedded Workbench:
embOS Port IAR Embedded Workbench Version
78K0
8051
ARM7 / ARM9 /
Cortex-A/R/M
AVR
AVR32
Coldfire Any 3.82.3.0
CR16C
H8 Any 6.0.1.0
M16C
M32C Any 6.0.1.0
MSP430
R32C Any 6.10.3.7
RH850
RL78
RX
SH Any 6.10.3.7
STM8
V850
≤ 4.80
≥ 4.81
≤ 8.30
≥ 9.10 and ≤ 9.30
≥ 10.10
≤ 6.70
≥ 7.10 and ≤ 7.40
≥ 7.50 and ≤ 7.80
≥ 8.10 and ≤ 8.22
≥ 8.30 and ≤ 8.50
≥ 9.10
≤ 6.40
≥ 6.50 and ≤ 6.80
≥ 7.10
≤ 4.21
≥ 4.30
≤ 3.20
≥ 3.30
≤ 3.60
≥ 3.70
≤ 5.60
≥ 6.10 and ≤ 6.50
≥ 7.10 and ≤ 7.12
≥ 7.20
≤ 1.30
= 1.40
= 2.10
≥ 2.20
≤ 1.30
≥ 1.40 and ≤ 2.21
= 3.10
≥ 4.10
≤ 2.50
≥ 2.60 and ≤ 2.90
= 3.10
≥ 4.10
≤ 1.42
≥ 2.10 and ≤ 2.20
= 3.10
≥ 3.11
≤ 4.10
≥ 4.20
Compatible
Plug-In version
6.10.3.7
7.10.3.7
6.10.3.7
7.10.3.7
8.10.3.7
6.10.3.7
7.10.3.7
7.50.3.7
8.10.3.7
8.30.3.7
9.10.3.7
6.10.3.7
7.10.3.7
8.10.3.7
6.10.3.7
7.10.3.7
6.10.3.7
7.10.3.7
6.10.3.7
7.10.3.7
6.10.3.7
7.10.3.7
8.10.3.7
8.30.3.7
7.10.3.7
7.50.3.7
8.10.3.7
8.30.3.7
6.10.3.7
7.10.3.7
8.10.3.7
8.30.3.7
6.10.3.7
7.10.3.7
8.10.3.7
8.30.3.7
6.10.3.7
7.10.3.7
8.10.3.7
8.30.3.7
6.10.3.7
7.10.3.7
embOS plug-in for IAR C-Spy Debugger © 2005-2021 SEGGER Microcontroller GmbH
Loading...