embOS C-SPY Plug-in
Contents
1. embOS C SPY Plug in embOS plug in for the IAR C SPY Debugger Version 3 82 6 0 5 6 0 6 NA SEGGER A product of SEGGER Microcontroller GmbH amp Co KG 2 CHAPTER Disclaimer Specifications written in this document are believed to be accurate but are not guar anteed 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 amp Co KG the manufacturer assumes no responsibility for any errors or omissions The manufacturer makes and you receive no warranties or conditions express implied statutory or in any communica tion with you The manufacturer specifically disclaims any implied warranty of mer chantability 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 the manufacturer The software described in this doc ument is furnished under a license and may only be used or copied in accordance with the terms of such a license O 2008 2011 SEGGER Microcontroller GmbH amp Co KG Hilden 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 respec tive2. 4 1 1 1 embOS C Spy Plug in for IAR Embedded Workbench sseereeeees ken e enkes kr enken 4 1 1 2 EM DOS a A e sai A aa E O PP EET 4 1 1 3 TAR Embedded Workbench sssesssesse ske kt ERE EEE REE EEE EE EE Ea 4 1 2 REQUIFemMEntS asso ee ceca Rede cab State a 5 1 3 Supported CPUS sa ae ae aba ea ds ee bal ele Bees Ea Sa less 6 installation rss ra e 7 2 1 Installation Procedure 0c cocccconononcconnoncconcn nro nn nn narra 8 2 2 CONTIGUA Mic di 9 ca O 11 3 1 OVERVIEW essas DI ada T ABE ESTE E SEE ESSEN eh ad SEE EJERE ESS EDEN a ee Ra 12 3 2 Fask SE ass ren ERITREA E kong 13 3 2 1 TA SENSICIVIEY E E sn a ais 13 3 3 MaIIDOXES O cent art add Gh O oes alt San ce tit baa 16 3 4 MII CES La ar id A O vitiata st aa a 17 3 5 Resource semaphoRes da ateste na ven ed SD Cd OEA EO na 18 3 6 System information it astra ts der deg E e ls a ai ES O pe Ra 19 3 7 SENG Sa a ay Sia RR LR A eel TA ED a SER CT a 20 3 8 AOU te essi A a 21 E EEE RASA HENTET a cay a eo 23 MUD 9 6 5 an Mad USA RE het as ela NA UR ON RR abies o O SIDA Cae RN LER 23 5 1 Contacting SUpport ua cassiane A ssa aaa 24 User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG Chapter 1 Introduction This chapter gives a short overview about the embOS C Spy plug in for IAR Embed ded Workbench User manual for embOS Plug in 2008 2011 SEGGER Microcontroller
3. GmbH amp Co KG CHAPTER 1 Introduction 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 debugging sessions This enables you to inspect the state of sev eral embOS primitives such as the task list resource semaphores mailboxes embOS software timers 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 situa tions 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 inte grated development environment that includes a project manager editor build tools and the C SPY debugger IAR Embedded Workbench supports a wide range of micro controllers 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 User manual for embOS Plug in 2008 2011 SEGGER Microcontroller
4. MSP430 MSP430x The task sensitive source window call stack and register window is supported for the following CPUs Any ARM7 ARM9 CPU Any ARM Cortex MO CPU Any ARM Cortex M3 CPU Any ARM Cortex R4F CPU Renesas M16C Renesas R32C Renesas RX Renesas SH2A Others will follow User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG Chapter 2 Installation This chapter describes the installation steps required to use the embOS C Spy plug in User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 8 CHAPTER 2 Installation 2 1 Installation Procedure Normally there is no installation required because the IAR Embedded Workbench comes with the plug in already installed If for some reason you want to uptade the plug in you have to replace two files The installation procedure is very straightforward because it only requires you to copy the contents of the embOS C Spy plug in package into the IAR CPU specific plug in folder for rtos plug ins The directory structure may look like this BY C Tool C IARSARM_ 520 ARM plugins rtos emb0S gt ala Gy Folders KS BE E nm EE CO C Tool CMARARM_V520 4RM pluginstitostembOS ED ARM 520 e ui 388KB Application Extension a i 1KB EWPLUGIN File If not already delivered with the IAR Embedded Workbench IDE create a directory embos below the CPU specific plugin rtos folder and copy the fil
5. 00208700 R12 EEE IP WEBS Process 0x0000992D 0x00009945 0x00204E R13 SP 0x002085E0 _WebServerChildTask 0x00204E64 R14 LR 0x00007F03 OS ReturnFromTask 0 CPSR 0x0000003F SPSR OXFFFFFFFF PC 0x00007F02 R8 fiq 0x00000000 R9_fiq 0x00000000 w Tasks waiting for first activation These basically fall into the same category as blocked tasks the call stack and regis ters look similar to the following screenshots Similarly temporary registers are unknown The Call Stack shows a single entry OS_StartTask Run count is 0 mt lero fia Name ________ ststws Timeout Stack Info Run count Time slice Events 113 0x209FF8 IP_RxTask Waiting event object 240 512 O 0x2096F0 q 0 2 0x0 112 0x209FB4 IP Task 11 16 240 768 O 0x2093F0 1 0 2 0x0 gt 100 0x209F70 MainTask Ready 288 8192 O 0x206130 3 0 2 0x0 Idle ster CPU Registers E RO R1 R2 R3 R4 R5 R6 R7 R8 R9 R10 OS StartTask 0 OXCCCC0O004 oxccccooos oxccccoo06 oxccccoo07 oxcccco008 oxcccco009 oxccccoooA oxccccoooB R11 R12 R13 SP R14 LR CPSR SPSR PG R8 fiq R9 fiq 0x00209DA4 0x00010824 0x0000001F OXFFFFFFFF 0x00010824 0x00000000 0x00000000 User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG Interrupted tasks 15 Tasks which have been interrupted and preempted typically by a task with higher priority becoming ready In this case t
6. 03 AW Previous versions did not show the task sensitive call stack cor rectly 6 0 6 2 110227 AW RENESAS RL78 supported Plugin initialization modified to fix a problem that inhibited the 3 82 4 101228 AW start of the plugin Under some circumstances the OS_TASK structure could not be found Display errors under Windows 7 corrected Debug and trace library mode now shown in the system infor 6 0 5 3 82 3 100708 AW mation window Several new error messages OS_Status in system information window added 6 0 4 100528 AW Big endian support for Renesas RX addded 6 0 3 100527 AW Support for Renesas RX added for new IAR EW6 6 0 2 100413 AW Support for SH2A added 6 0 1 100408 AW New plugin for IAR EW 6 Task awareness for Renesas RX added oe 031030 AN Task awareness for Renesas R32C added 3 82 1 091026 AW Ene dd S embOS version 3 82 0 091007 AW RS embOS version 3 80 3 090911 AW Task awareness for M16C added 3 80 2 090606 AW Task state display corrected 3 80 1 090505 AW Task awareness for Cortex M3 added 3 60 e 081208 AW Version number modified to corresponding embOS version 2 00e 070707 AW Initial version for IAR Embedded Workbench V5 User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 4 CHAPTER User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 1 Table of Contents lagos a AA O DR al SE DEDE A on he EDER 3 1 1 IO RN NN
7. 22 User manual for embOS Plug in CHAPTER 3 Getting started 2008 2011 SEGGER Microcontroller GmbH amp Co KG 23 Chapter 4 Support This chapter contains information about contacting support and what information to provide User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 24 CHAPTER 4 Support 4 1 Contacting Support We work hard to avoid as much software defects as possible However if you encoun ter an error in our software you may contact our support at support segger com We will try to correct any malfunction as soon as possible To do this we need all rel evant information Please try to provide us with at least the following information IAR Embedded Workbench IDE amp C SPY debugger versions Information about the target CPU embOS C Spy plug in version number A detailled description of the problem and how to reproduce it If possible send us a project that triggers the problem User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG
8. GmbH amp Co KG 1 2 Requirements To use the embOS C Spy plug in you need a version of IAR Embedded Workbench installed and a debug target which uses embOS Specifically e An embOS version 3 28 or higher is required for complete compatibility Older embOS versions use different internal structures and the C Spy plug in is there fore of limited use with version prior to 3 28 e An IAR Embedded Workbench IDE with a C SPY debugger version 5 is required for the plug in V2 and the plug in V3 e An IAR Embedded Workbench IDE with a C Spy debugger version V6 or higher is required for the plug in V6 The version 6 0 6 is required for EWARM V6 10 or above EW430 V5 20 or above EWRX V2 20 or above EWRL78 The version V6 0 5 of the plug in is for all other IAR embedded Worbenches V6 User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 6 CHAPTER 1 Introduction 1 3 Supported CPUs The embOS C Spy plug in works with 8 bit 16 bit or 32 bit CPUs in little or big endian mode supported by embOS Due to limited testing support can only be granted for the CPUs listed below Any ARM7 ARM9 CPU Any ARM Cortex MO CPU Any ARM Cortex M3 CPU Any ARM Cortex R4F CPU Atmel AVR ATMega National CR16C Renesas H8 H8S Renesas M16C Renesas M16C80 Renesas M32C Renesas R32C Renesas R8C Renesas RL78 Renesas RX Renesas SH2A Renesas NEC V850 V850E V850ES V850E2 Renesas NEC 78 KO 78 KOR TI
9. e the complete detailed call stack 50 val 0x20000558 Al gt Idle Call stack with DP library OS DelayUntil 0x75 HPTask 3 OS StartTask 0x7 User manual for embOS Plug in ml Prio id Name status Timeout Stack Info Run count Time slice Events LP Task Waiting semaphore zero 144 512 O 0x2000023C 147 Call stack with DPL library ep OS Deactivated 0x15 OS DelayUntil 0x51 OS Delay Oxb HPTask OS StartTask 0x7 O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 16 CHAPTER 3 Getting started 3 3 Mailboxes A mailbox is a buffer that is managed by the real time operating system The buffer behaves like a normal buffer you can put something called a message in and retrieve it later This window shows the mailboxes and provides information about the number of messages waiting tasks etc Waiting tasks Ux20000824 0 4 128 Ox20000544 0x20000504 HP Task Column Description Id The mailbox address Messages The number of messages in a mailbox and the maximum number of messages the mailbox can hold Message size The size of an individual message in bytes pBuffer The message buffer address Waiting tasks The list of tasks that are waiting for a mailbox that is their address and name Table 3 2 Mailboxes window items User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp C
10. es from the embOS folder which comes with the plugin into that folder in your IAR installation directory Then restart the IAR Embedded Workbench IDE User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 2 2 Configuration By default the embOS C Spy plug in is not loaded during debugging For each project configuration you have to explicitly enable the plug in in the debugger section of the project options Options for node Start STR71x General Options C C Compiler Assembler Custom Build Build Actions Debugger Third Party Driver The embOS C Spy plug in is now available in debugging sessions and may be accessed from the main menu User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 10 CHAPTER 2 Installation User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG Chapter 3 Getting started This chapter describes the embOS C Spy plug in and its capabilities in greater detail User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 12 CHAPTER 3 Getting started 3 1 Overview During your debugging session the embOS C Spy plug in is accessible from the IAR Embedded Workbench IDE main menu Note that if you are not running a debugging session there is no embOS menu item available tor embOS Tools Window Help Task List Mailboxes Timers Resource Semaphores System Informatio
11. he OS saved all registers including the scratch registers in case of ARM RO R3 R12 The Register window shows the val ues of all registers including the scratch registers Ox209FF8 IP_RxTask 0x209FB4 IP Task 0x209F70 IP_WebServer 0x209C20 IP_WebserverChild Register x cru Registers RO 0x00700001 R1 0x00000000 R2 0x00000013 R3 0x00000000 R4 0x00000000 R5 0xCCCC0005 R6 0xCCCC0006 R7 0xCCCC0007 R8 0xCCCC0008 R9 0xCCCC0009 R10 oxccccoo0A R11 0XCCCC000B R12 0x000135E0 R13 SP 0x00209090 R14 LR 0x00009FC9 CPSR 0x6000003F SPSR OXFFFFFFFF PC 0x0001134E R8 fiq 0x00000000 R9_fiq 0x00000000 H status Timeout Stack Info Rumcount Time slice Events Waiting event object 240 512 O 0x2096F0 48 D 2 0x0 11 14190 492 768 O 0x2093F0 1339 0 2 0x0 Ready 288 8192 0x206130 1102 0 2 0x0 Waiting event object 1848 2400 amp 0x208130 45 0 2 0x0 BSP_CIrLED int Eb BSP_ToggleLED 0 _ToggleLED _BlinkTask OS ReturnFromTask 0 3 2 1 2 Call stack with embOS libraries All embOS libraries are built with full optimization Therefore it may happen that not all function calls are shown in the call stack in detail The additional embOS library dpl a is built with low optimization It may be used for application development instead of the Debug and Profiling library Using a library built with low optimization level gives the ability to se
12. holders Contact address SEGGER Microcontroller GmbH amp Co KG In den Weiden 11 D 40721 Hilden Germany Tel 49 2103 2878 0 Fax 49 2103 2878 28 Email support segger com Internet http www segger com User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG Manual versions Manual version Date By Explanation 11 0 110408 AW New software version 6 0 6 4 Cortex R4F support 10 0 110323 TS New emboOS library mode DPL added 9 0 110303 AW New software version 6 0 6 listed 8 0 101228 AW New software version 3 82 4 listed 7 0 100708 AW New software version 3 82 3 and 6 0 5 listed 6 0 100528 AW add version 6 0 4 listed Description of task sensitiv 5 0 100408 AW New software version 6 0 1 listed 4 0 091030 AW Software version list updated 3 0 091007 AW Software version list updated 2 0 081208 AW Screenshot of installation folder updated 1 0 070707 TW Initial version for plugin V2 Software versions Sottwate Date By Explanation version New corrected plugin version for EWARM V6 6 0 6 4 110408 AW Previous versions did not show the task sensitive call stack for ARM big endian targets New corrected plugin version for EWARM V6 6 0 6 3 110303 AW Previous versions did not show the task sensitive call stack cor rectly New corrected plugin version for EWARM V5 3 82 5 1103
13. n l Il w Settings About From the menu you may activate the individual windows that provide embOS related information The sections below describe these individual windows The amount of information available depends on the embOS build used during debugging If a cer tain part is not available the respective menu item is either greyed out or the win dow column shows a N A User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 3 2 Task list The Task List window lists all current embOS tasks It retrieves its information directly from the emboOS task list Timeout Stack Info Run count Time slice Events 113 Ox209FF8 IP_RxTask Waiting event object 240 512 O 0x2096F0 30 0 2 0x0 112 0x209FB4 IP Task 5 4478 464 768 O 0x2093F0 435 0 2 0x0 107 0x209F70 IP_WebServer Waiting event object 288 8192 0x206130 354 0 2 0x0 106 0x209C20 IP webserverChild Waiting event object 1836 2400 0x208130 27 0 2 0x0 25 0x20403C BlinkTask Ready 96 128 O 0x209D28 434 0 2 0x0 The individual columns are described below Column Description A green arrow points at the currently active embOS task Prio The priority of the task Id The task control block address that uniquely identifies a task Name If available the task name is shown here Status The task status as a short text Ti If a task is delayed this column shows the timeout value and in imeout parentheses
14. o KG 3 4 Timers A software timer is an object that calls a user specified routine after a specified delay This window provides information about active software timers 5000 1 0x20000840 0x1341 callback 4900 5000 Column Description Id The timer s address Hook The function address and name that is called after the timeout Time The time delay and the point in time when the timer finishes wait ing Period The time period the timer runs Active Shows whether the timer is active running or not Table 3 3 Timers window items User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 18 CHAPTER 3 Getting started 3 5 Resource semaphores Resource semaphores are used to manage resources by avoiding conflicts caused by simultaneous use of a resource This window provides information about available resources Owner Ox20000590 0x0 0 Al Ox2000057C 0x20000504 HP Task 0x20000540 LP Task Column Description Id The resource semaphore address Owner The address and name of the owner task Use counter Counts the number of semaphore uses o Lists the tasks address and name that are waiting at the sema Waiting tasks phore Table 3 4 Resource Semaphores window items User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 19 3 6 System information A running embOS contains a number of sy
15. stem variables that are available for inspection This window lists the most important ones Value OS Status OK OS Time 50 OS NumTasks 2 OS pCurrentTask 0x20000504 HP Task E OS_pActiveTask 0x20000504 HP Task fy embOS build Debug Profiling DP S Name User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 20 CHAPTER 3 Getting started 3 7 Settings To be safe the embOS C Spy plug in imposes certain limits on the amount of infor mation retrieved from the target to avoid endless requests in case of false values in the target memory This dialog box allows you to tweak these limits in a certain range for example if your task names are no longer than 32 characters you may set the Maximum string length to 32 or if they are longer than the default you may increase that value emb0S Plugin Settings After changing settings and clicking the OK button your changes are applied imme diately and should become noticeable after the next window update for example when hitting the next breakpoint However the settings are restored to their default values on plug in reload User manual for embOS Plug in 2008 2011 SEGGER Microcontroller GmbH amp Co KG 21 3 8 About Finally the About dialog box contains the embOS C Spy plug in version number and the date of compilation About EEE User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG
16. the point in time when the delay will be finished If available this column shows the amount of used stack space and Stack Info the available stack space as well as the value of the current stack bottom pointer Run count The number of task activations If round robin scheduling is available this column shows the number of remaining time slices and the number of time slice reloads Events The event mask of a task Table 3 1 Task list window items Time slice 3 2 1 Task sensitivity The Source Code window the Disassembly window the Register window and the Call Stack window of the C Spy debugger are task sensitive since version 3 62 of the embOS C Spy plug in for several CPUs This means that they show the position in the code the general purpose registers and the call stack of the selected task By default the selected task is always the running task which is the normal behavior of a debugger that the user expects You can examine a particular thread by double clicking on the corresponding row in the window The selected task will be underlayed in yellow The C Spy Debugger rebuilds the call stack and the preserved general purpose registers of a suspended task Refer to State of suspended tasks on page 14 for detailed information about which information are available for the different task states Every time the CPU is started or when the Idle row of the task window is double clicked the selected task is s
17. witched back to this default User manual for embOS Plug in O 2008 2011 SEGGER Microcontroller GmbH amp Co KG 14 CHAPTER 3 Getting started 3 2 1 1 State of suspended tasks Blocked tasks suspended by cooperative task switch Tasks which have given up execution voluntarily by calling a blocking function such as OS Delay Oros Wait In this case there was no need for the OS to save the scratch registers in case of ARM RO R3 R12 The Register window will show for the content of these registers wel prio id Name Status Timeout Stack info Run count Time slice Events 113 0x209FF8 IP_RxTask Waiting event object 240 512 O 0x2096F0 48 0 2 0x0 112 0x209FB4 IP_Task 11 14190 492 768 O 0x2093F0 1339 0 2 0x0 gt 107 0x209F70 IP WebServer Ready 288 8192 O 0x206130 1102 0 2 0x0 25 0x20A03C BlinkTask Ready 96 128 0x209D28 1365 0 2 0x0 Idle EEE cru Registers OS Deactivated Ro OS_DeactivateP 0x0020861C H 0x48 E OS EVENT Wait 0x0020861C R3 IP OS WaitItemTimed 0x00204E90 0 R4 0x00000000 sbwait 0x00204E90 0 R5 0x0020861C soreceive 0x00204E64 _LocaleC_isalpha int 0x0 Ox R6 0x00000000 t recv 2117220 0x208860 GET favicon ico HTTP 1 10 Rz as _Recv 0x208860 GET favicon ico HTTP 1 100Host 14 RS OxCECEGOOS Read 0x00208718 R10 OxCCCCOO0A _ReadLine 0x00208718 R11 oxccccoooB Process 0x
Download Pdf Manuals
Related Search