embOS C-SPY Plug-in - FTP Directory Listing
Contents
1. embOS C SPY Plug in embOS plug in for the IAR C SPY Debugger Version 2 00e Manual Rev 1 A SEGGER A product of SEGGER Microcontroller Systeme GmbH 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 SYSTEME GmbH 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 2007 SEGGER Microcontroller Systeme GmbH 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 tive holders Contact add2. 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 Users manual for embOS Plug in 1997 2007 SEGGER Microcontroller Systeme GmbH 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 0 or higher is required for the plug in V2 Users manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 6 CHAPTER 1 Introduction 1 3 Supported CPUs The embOS C Spy plug in works with 16 bit or 32 bit CPUs in little or big endian mode supported by embOS but due to limited testing support can only be granted for the CPUs listed below Any ARM7 ARM9 CPU Atmel AVR ATMega National CR16C Renesas H8 H8S Renesas M16C Renesas M16C80 Renesas M32C Renesas R32C Renesas R8C NEC V850 NEC 78 K0 TI MSP430 Users manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH Chapter 2 Installation This chapter describes the installation steps required t
3. 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 s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 3 2 Task list The Task List window lists all current embOS tasks It retrieves its information directly from the embOS task list Priority id Name Status sd Timeout Events Stack Info 100 0x20000504 0x20000540 Activations Round Robin 68 512 Y 0x20000104 3 0 2 68 512 020000304 3 0 2 HP Task Delay 50 150 0x0 LPTask Ready 0x0 Task List System Information The individual columns are described below Column Description A green arrow points at the currently active embOS 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 Timeout If a task is delayed this column shows the timeout value and in parentheses the point in time when the delay will be finished Events The event mask of a task 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 Activations The number of task activati
4. K OS Time 50 OS NumTasks 2 OS pCurrentTask 0x20000504 HP Task OS_pActive Task 0x20000504 HP Task embOS build Debug Profiling DP User s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 18 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 emb0 S Plugin Settings Max String length Max Number of Tasks Max Number of Semaphores Max Number of Mailboxes Max Number of Timers Max Waitlist length Stack check Max Stack check length 102 Cancel E zz Pa Pa Pa IE Vv as Pe 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 s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 3 8 About Finally the About dialog box contains the embOS C Spy plug in version number and the date of compilation erre SEGGER em
5. R Microcontroller Systeme GmbH 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 General Options C C Compiler Assembler Custom Build Build Actions Linker Simulator Angel IAR ROM monitor J Link Macraigor RDI Third Party Driver Start STR71x Code Coverage nn El MSEGGER embDS The embOS C Spy plug in is now available in debugging sessions and may be accessed from the main menu Users manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 10 CHAPTER 2 Installation Users manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH Chapter 3 Getting started This chapter describes the embOS C Spy plug in and its capabilities in greater detail User s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 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 ata Resource Semaphores System Information Settings About From the menu you may activate the individual windows that provide embOS
6. bOS Plugin for IAR embedded workbench Version 1 0 0 3 Compiled 15 50 39 on Sep 19 2005 c 2005 Segger Microcontroller Systeme GmbH WU segger com User s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 20 User s manual for embOS Plug in CHAPTER 3 Getting started O 1997 2007 SEGGER Microcontroller Systeme GmbH 21 Chapter 4 Support This chapter contains information about contacting support and what information to provide User s amp reference manual for embOS Plug in 1997 2007 SEGGER Microcontroller Systeme GmbH 22 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 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 s amp reference manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH
7. callback 4900 5000 5000 1 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 or not Table 3 3 Timers window items User s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 16 CHAPTER 3 Getting started 3 5 Resource semaphores Resource semaphores are used to manage resources by avoiding conflicts caused by simultaneous resources use of a resource This window provides information about available a Owe Use counter Wa tngtasks 0x20000590 0x0 0 Ox2000057C 0x20000504 HP Task 1 0x20000540 LP Task Resource Semaphores Resource Semaphores Timers Mailboxes Column Description Id The resource semaphore address Owner The address and name of the owner task Use counter Counts the number of semaphore uses Waiting tasks Lists the tasks address and name that are waiting at the sema phore Table 3 4 Resource Semaphores window items User s manual for embOS Plug in 1997 2007 SEGGER Microcontroller Systeme GmbH 17 3 6 System information A running embOS contains a number of system variables that are available for inspection This window lists the most important ones Name value OS Status O
8. o use the embOS C Spy plug in Users manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 2 1 CHAPTER 2 Installation Installation Procedure Normally there is no installation required because the IAR Embedded Workbench comes witrh 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 N C Too IAR ARM Y430a common plugins embos File Edit View Favorites Tools Help Back gt Search G4 Folders CHHistoy 5 GE X A Edy Address a C Tool ARARM V430a common plugins embos y Go Folders X embOSPlugin dll 5 aR al aa embOSPlugin ewplugin E ARM EC V430a E arm E common bin config doc E plugins CodeCoverage amm Orti Profiling sie 2 object s Disk free space 54 5 GB 376 KB B My Computer If not already delivered with the IAR Embedded Workbench IDE create a directory embos below the CPU specific plugin rtos folder and copy the files from the embOS folder which comes with the plugin into that folder in your IAR installation directory Then restart the IAR Embedded Workbench IDE Users manual for embOS Plug in O 1997 2007 SEGGE
9. ons Round Robin If round robin scheduling is available this column shows the number of remaining time slices and the number of time slice reloads Table 3 1 Task list window items User s manual for embOS Plug in 1997 2007 SEGGER Microcontroller Systeme GmbH 14 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 0x20000824 0 4 128 0x20000544 0x20000504 HP Task Column Description Id The mailbox address Messages The number of messages in a mailbox and the maximum number of messages as 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 s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 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 ld Hook Time Period Active 0x20000840 0x1341
10. or embOS Plug in 2004 2007 SEGGER Microcontroller Systeme GmbH Users manual for embOS Plug in O 2004 2007 SEGGER Microcontroller Systeme GmbH Chapter 1 Introduction This chapter gives a short overview about the embOS C Spy plug in for IAR Embed ded Workbench Users manual for embOS Plug in 1997 2007 SEGGER Microcontroller Systeme GmbH 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 and timers 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
11. ress SEGGER Microcontroller Systeme GmbH Heinrich Hertz Str 5 D 40721 Hilden Germany Tel 49 2103 2878 0 Fax 49 2103 2878 28 Email support segger com Internet http www segger com Manual versions Manual version Date By Explanation 1 0 070707 TW Initial version for plugin V2 Software versions fiwar E SE dE Date By Explanation version 2 00e 070707 AW Initial version for IAR Embedded Workbench V5 User s manual for embOS Plug in O 1997 2007 SEGGER Microcontroller Systeme GmbH 1 Table of Contents NFSU A AA A RUE A rene LS 3 1 OVERVIEW A ore nie Ovi EE en ae nt iva RAS 4 1 1 1 embOS C Spy Plug in for IAR Embedded Workbench ken e eee rer ken ker 4 1 1 2 SOS LE was A Soe DO eave he IE een EP atl Se fa 4 1 1 3 TAR Embedded Workbench ee EERE EERE EERE EE EEE 4 1 2 REGUIREIMGNTS ED cece Eee as 5 1 3 Supported CPUS seca asi ei in 6 SA a Lda ND ia OL Pe CS 7 2 1 Installation Procedure sin rr rr rr 8 2 2 Configuration urnes a nr dicas Ladra aa Da qua anne ne ia dalle eas ST ES a 9 Getting stated A O RD 11 3 1 MD e ae 12 3 2 Pask SE AAA EA AI E O 13 3 3 Malo dos 14 3 4 MAS A a A ce aA 15 3 5 Resource semaphores a dd as 16 3 6 System RO 17 3 7 RS TEA LOTS O EC D PR PR EE TT 18 3 8 ABOUT RE o en eco ar eq 19 UIP DOR pai oa Re ne de Saeed de ne D de ea tun EN LS 21 4 1 Contacting Support sisss sergent cay eeuagecav RA NET DER a bi 22 Users manual f
Download Pdf Manuals
Related Search