Plugin Update Site Installation
Contents
1. ZN WITTENSTEIN OPENRTOS APPLICATION NOTE 34 185 AN 001 INSTALLING AND USING THE WHIS STATEVIEWER KERNEL AWARE PLUG IN FOR ECLIPSE WITTENSTEIN high integrity systems is a trading name of WITTENSTEIN aerospace amp simulation Itd Proprietary to WITTENSTEIN aerospace amp simulation Itd THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY INFORMATION AND ALL INFORMATION TECHNICAL DATA DESIGNS INCLUDING BUT NOT LIMITED TO DATA DISCLOSED AND OR PROVIDED HEREIN IS AND REMAINS THE EXCLUSIVE PROPERTY OF WITTENSTEIN aerospace simulation ltd IT IS STRICTLY PROHIBITED TO DISCLOSE ANY INFORMATION TO THIRD PARTIES WITHOUT THE PRIOR WRITTEN CONSENT OF WITTENSTEIN aerospace amp simulation Itd THE RECIPIENT OF THIS DOCUMENT BY IT S RETENTION AND USE AGREES TO HOLD IN CONFIDENCE ALL PROPRIETARY INFORMATION PROVIDED WITHIN THIS DOCUMENT Copyright WITTENSTEIN aerospace simulation Itd date as document all rights reserved Issue 2 July 6 2011 i WITTENSTEIN CONTENTS CONTENTS 2 REFERENCED DOCUMENTS cooccocccccncccnnnnoconononcnnonononnnnnnnnononnnnonnnnonnnnnnnnnnnnnonnnnnnnnnnnnnonnnnnnnineneness 2 CHAPTER 1 INTRODUCTION sscreccatenssnentsanteeatasssreniacsteealseceseaiccusuenteesssoisenientaencuaniecstuantdexoueet 3 1 1 DESCRIPTION A 4 CHAPTER 2 INSTALLATION USAGE soe ccc cered seca tendienseezese EOE E E EEE AR 5 2 1 INS TALUNO THE P LUC IN Beemer nested er reg een eee 6 2 2 OPENING THE RTOS VIEWER2. 4 HS WITTENSTEIN Step6 When WHIS StateViewer plug in is installed correctly you will see OpenRTOS Viewer and SafeRTOS Viewer in Eclipse show View window as in Figure 2 8 E Show View Aala H General FH gt C F Ee CYS H gt Debug H Z gt Git H gt gt Help H gt Make HLS Myllyn H LS OpenRTOS viewer Z gt Remote Systems L Team Cancel Figure 2 8 Show View window 2 2 OPENING THE RTOS VIEWER TABLES When you are ready to start a debug session Step 1 Start a debug session as normal Step 2 Ensure Debug is the current Eclipse perspective Step 3 From the Eclipse Workbench Window menu select Show View Other Figure 2 9 Installing and using the Version 2 0 Page 11 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date HS WITTENSTEIN ource tasks c Eclipse Platform oject Run Window Help New Window p je Y New Editor Open Perspective d o Breakpoints Alt Shift Q B EJ Console Alt Shift Q C Customize Perspective Save Perspective As F Debug Reset Perspective Disassembly Close Perspective 6 Expressions Close All Perspectives 0 Memory Navigation Outline Alt Shift 0 O Problems Alt Shift Q X ilaya gt ro t 1919 Registers z Preferences w A Signal
3. 0x20005b80 0x20005c18 READY None 0x20003d7c Ox20003e0c READY None 0x200050fc 0x20005160 READY None 0x20005444 0x20005538 READY None Ox20005d7c 0x20005dd8 BLOCKED 0x20005cf0 0x20004364 0x200043e0 BLOCKED None 0x200040d4 0x20004140 READY None 0x2000421c 0x200042a0 BLOCKED None 0x2000572c 0x20005820 BLOCKED 0x20002444 0x200047b0 0x2000481c BLOCKED QPeek_ Test 0x200048f8 0x20004964 BLOCKED QPeek_ Test OLED PeekHi PeekH2 WnNwonouwhoaodnd0 WNON OW POO OAS Figure 1 1 1 The Eclipse Workbench IDE with the Task and Queue viewers visible Installing and using the Version 2 0 Page 4 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date i PAA WITTENSTEIN CHAPTER 2 INSTALLATION amp USAGE Installing and using the Version 2 0 Page 5 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date 4 IA WITTENSTEIN 2 1 INSTALLING THE PLUG IN Step 1 Within Eclipse from the Help menu select Install New Software item a ls Welcome Help Contents 27 Search Dynamic Help Key Assist Ctrl Shift L Tips and Tricks Report Bug or Enhancement Cheat Sheets Beh Check for Updates Install New Software About Ec
4. Figure 2 5 Review Licenses window Installing and using the Version 2 0 Page 9 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date WITTENSTEIN Step 4 Check for certificate details as in Figure 2 6 and tick the certificate WITTENSTEIN High Integrity Systems High Integrity Systems WITTENSTEIN aerospace amp simulation Ltd and then click OK Selection Needed Do you trust these certificates WITTENSTEIN High Integrity Systems High Integrity Systems WITTENSTEIN aerospace amp simulation Ltd E WITTENSTEIM High Integrity Systems High Integrity Systems WITTENSTEIN aerospace amp simulation Ltd WITTENSTEIN High Integrity Systems High Integrity Systems WITTENSTEIN aerospace amp simulation Ltd Figure 2 6 Certificate Selection Window Step 5 When the Installation has finished Eclipse prompts for restart Now restart the Eclipse by clicking Restart Now Software Updates You will need to restart Eclipse For the installation changes to take effect You SP may try to apply the changes without restarting but this may cause errors Figure 2 7 Restart Eclipse notice Installing and using the Version 2 0 Page 10 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date
5. m Name v Address Max Length Item Size Current Length Waiting Tx Waiting Rx Block_Time_Queue 0x20003104 5 Counting_Sem_1 0x2000341c Counting_Sem_2 0x2000372c Gen_Queue_Mutex 0x20004030 Gen_Queue_Test 0x20003e74 o oe pa a UT NormallyEmpty 0x20005654 NormallyFull 0x200055cc Poll_Test_Queue 0x20003a28 Bee oo oo pa o QPeek_Test_Queue 0x2000445c Recursive_Mutex 0x200049f0 O bnNbbbooo s O Lhe pa OOO 400000 mum H UJ OOMNO00000 H u O O Lu Figure 2 13 Example queue table screen shot The queue table displays data on all queues and semaphores that have been added to the queue registry by a call to vQueueAddToRegistry see the RTOS user manual for more information The following description refers only to queues but is equally applicable to binary semaphores counting semaphores mutex type semaphores and recursive semaphores Figure 2 13 provides an example queue table screen shot where each table row provides information on a single queue or semaphore If the row is black then the information it contains has not changed since the debugger was last suspended Conversely if the row is red then at least one of the columns in that row has changed since the debugger was last suspended Table 2 2 Queue Table Columns Current Length The number of items currently in the queue This can only be less than or equal to the Max Length Waiting Tx The number of tasks currently blocked waiting for space to be
6. TABLES ccccccccsececeeeeeceeeeeeeeeseeeeseeeeseeeeseueesseeeeseneessneeess 11 2 3 INTERPRETING TASK TABLE DATA asian cla 13 2 4 INTERPRETING QUEUE TABLE DATA ccccssececceececcoeeeeceeseeecceneecsaseeeeceeessauaeeseuseeesseeeeses 15 FIGURES Figure 1 1 1 The Eclipse Workbench IDE with the Task and Queue viewers visible 4 Figure 2 1 Install New Software Menu ItelM ccccocccccncncccccnccncnnonnnnonncnnnnnnnonnnnnonnnnonnnnnnnnnnonannnnnans 6 Figure 2 2 Add Repository Dialog occooccccocnoccncoconocncnnnonononnccnnnonanonnnnonnrnnnnnnnnrnnnnnnonnnenannnnons 6 Figure 2 3 Available Software WiNdOW occoocccoccconcconcconoconoconocononononononononononononononanonanenanenanenanes 7 Figure 2 4 Install Details WINKOW ccccceeccseeceeeeseeeeeeeeeeeeeeeeeeeeeeeeueeeeeeeeeeaeeeeueeeeesaeeeseeseeeseeesaeees 8 Figure 2 5 Review LICENSES WINKOW ccccsecceeeceeeceeeceeeeeeeeeeeeeeeeeeeeeeeeeeeeeueeeueeeueteuesseeeeeeseeetaeees 9 Figure 2 6 Certificate Selection WINGOW cccooccccocccccccnccccnncnncnnonnnnonnnnnnnnnnonnnnnonnnonnnnncnnnnnnnnnnnnos 10 Figure 2 7 Restart Eclipse NOICE rms io IEIS 10 Figure 2 8 Show View Window ooccccoccnccccccccccncnncncnnnnnonncnnnnnnnnnnrnnnnnnnnnnrnnnnnnnnnnrnnnnnnnnnnrnnnnnnnnnnninnos 11 Figure 2 9 Opening up the Other view dial0gue ccccocccccccnccccnnconcncnnnnnonncncnnnnnnnanoconnnenoncnonos 1
7. ded unsigned portBASE Tasks Variables Alt Shift 0Q V portTickType 0 Alt Shift Q Q Figure 2 9 Opening up the Other view dialogue Step 4 From the resultant dialogue box expand the required either OpenRTOS or SafeRTOS Viewer tree Figure 2 10 and select whichever table is required and click OK to add to the Eclipse perspective 2 General gt CIC gt CYS gt Debug gt Git gt Help gt Make E Milo E Open TOS viewer e Queue Table 4 Queue Table DSF Task Table Task Table DSF H gt Remote Systems 3 E SafeRTOS Viewer a gt h Queue Table dh Queue Table DSF j A Task Table e Task Table DSF gt Team F l E E E E E E Cancel Figure 2 10 StateViewer Tables in the Show View window Installing and using the Version 2 0 Page 12 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date 4 la WITTENSTEIN The tables will refresh themselves each time the debugger is manually suspended hits a break point or is single stepped The tabs that contain the tables can be docked in any position within the Eclipse Workbench IDE simply by dragging and dropping the tabs to your desired location 2 3 INTERPRETING TASK TABLE DATA J Tasks 2 Problems 4 Task Table 3 _ Memory Modules E Conso
8. state task State A text description of the task state as specified in the OPENRTOS user manual Event Object The name or address of the queue or semaphore on which the task is blocked if any The name is used if the queue or semaphore has been registered within the queue registry Min Free Stack The stack high water mark This is the minimum number of bytes there have been between the task stack pointer and the end of the stack assigned to the task The lower this value the closer the task has come to overflowing its stack A value of O indicates that the task has overflowed its stack at some time Calculating the stack high water mark takes a noticeable amount of time so it is sometimes desirable to disable the calculation altogether Right clicking on the task table displays a menu that allows the feature to be toggle on and off None Count None Count None Gen_C None Gen_C None Norma NormallyEmpty Norma Y NormallyFu 9 None Toggle Stack Checking ch Nal Recur None 148 None 156 None 88 Figure 2 12 Right clicking on the Task Table to reveal the Toggle Stack Checking pop up menu Installing and using the Version 2 0 Page 14 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date d r WITTENSTEIN 2 4 INTERPRETING QUEUE TABLE DATA Queue Table 52 N
9. 14 7 r pS ES 3 Debug HE C c aE TERCIO IE E El Thread 0 Suspended Breakpoint hit 3 vTaskincrementTickQ C E Dev FreeRTOS WorkingCopy2 Source tasks c 1294 0x0000b 19a A 2xPortSysTickHandler C E Dev FreeRTOS WorkingCopy2 Source portable GCC ARM_CM3 port c 259 0x000 a Makefile void vTaskIncrementTick void SA Tasks ta Problems AL Task Table 33 Memory Modules EJ Console AL Queue Table 53 H base Start of Stack Top of Stack State Event Obje Name x Address Max Length Item Size Current Length Waiting Tx Waiting Rx 3 0x200031c8 0x2000320c BLOCKED Block_Time_ Block_Time_Queue 0x20003104 5 4 5 1 0 2 0x20003310 0x20003384 BLOCKED None Counting_Sem_1 0x2000341c 1 0 0 0 0 1 0x200037e8 0x20003854 BLOCKED None Counting_Sem_2 0x2000372c i 0 1 0 0 BIkSEM2 1 0x20003930 0x2000399c BLOCKED None Gen_Queue_Mutex 0x20004030 1 0 1 0 0 CREATOR 3 0x20005948 Ox20005aac BLOCKED None Gen_Queue_Test 0x20003e74 5 0 0 GenQ 0 0x20003f38 0x20003f c READY None NormallyEmpty 0x20005654 10 0 0 2 HiOQRx 3 Ox20004e6c Ox20004ec8 BLOCKED NormallyEmpty NormallyFull 0x200055cc 10 4 10 1 0 H1QTx 3 0x2000538c Ox200053f0 BLOCKED NormallyFull Poll_Test_Queue 0x20003a28 10 2 3 0 0 H1QTx 3 0x20005244 0x200052b8 BLOCKED None QPeek_Test_Queue 0x2000445c 5 4 0 0 3 Recursive_Mutex 0x200049f0 1 0 0 0 1 IDLE IntMath LORx LORx MAC MuHigh MuLow MuMed
10. 2 Figure 2 10 StateViewer Tables in the Show View WiNdOW occccooccccoccnccccncccccnccncncnoncncnnnnnnnannnnos 12 Figure 2 11 Example task table screen shot c oocccoccccccnconcncoonocncnconnnnnnncnnnnnnnnnnnnnnnnnnnnnncnncnnnanonos 13 Figure 2 12 Right clicking on the Task Table to reveal the Toggle Stack Checking pop up menu 14 REFERENCED DOCUMENTS Ref Document Description None STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date ZN WITTENSTEIN CHAPTER 1 INTRODUCTION STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date WITTENSTEIN 1 1 DESCRIPTION The STATEVIEWER Kernel Aware Plug in for Eclipse provides a snapshot view of the FreeRTOS OPENRTOS SAFERTOS kernel data structures presented in a meaningful tabular format This allows the current state of tasks queues and the various forms of semaphore to be inspected directly from within the Eclipse Workbench IDE WITTENSTEIN high integrity systems have made the STATEVIEWER plug in available for use by the FreeRTOS org community as well Debug RTOSDemo FreeRTOS org Source tasks c Eclipse Platform i o x File Edit Refactor Navigate Search Project Run Window Help a PIEI 47 G 74 gt lise
11. LLING THE SOFTWARE THE INDIYIDUAL OR ENTITY INSTALLING THIS SOFTWARE THE USER AGREES TO BE BOUND BY THE TERMS GF THIS LICENSE IF YOU OO NOT AGREE TO THE TERMS OF THIS LICENSE DO NOT INSTALL QR USE THE SOFTWARE This License Agreement the Agreement is entered into at the date of installation of the Software the Effective Date by and between the USER and WITTENSTEIN aerospace amp simulation ltd a corporation registered under the laws of England and trading as WITTENSTEIN high integrity systems WHIS who are together referred to hereinafter as the Parties BACKGROUND WHEREAS WHIS desires to grant a single USER a license to use WIHIS Software WHEREAS the USER wishes to use the Software to assist with the development and debug of embedded application software Now THEREFORE in consideration of the foregoing and of the mutual promises contained in this Agreement the Parties hereby agree as Follows 1 Definitions The Following capitalized terms have the meanings set Forth below 1 1 Derivative Works means any port work improvement modification alteration enhancement translation adaptation of or documentation For the Software in any medium Format or Form whatsoever 1 2 Software means the WHIS STATEVIEWER Plug in Software Application and Files as Further specified in Appendix 4 I accept the terms of the license agreement 9 do not accept the terms of the license agreement Cancel
12. come available on the queue That is tasks that are blocked waiting to send to the queue Waiting Rx The number of tasks currently blocked waiting for data to become available from the queue That is tasks that are blocked waiting to receive from the queue Installing and using the Version 2 0 Page 15 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date 4 HA WITTENSTEIN CONTACT INFORMATION User feedback is essential to the continued maintenance and development of our products Please provide all software and documentation comments and suggestions to the most convenient contact point listed below Address WITTENSTEIN high integrity systems Brown s Court Long Ashton Business Park Yanley Lane Long Ashton Bristol BS41 9LB England Phone 44 0 1275 395 600 Fax 44 0 1275 393 630 Email support HighIntegritySystems com Website www HighIntegritySystems com All Trademarks acknowledged Installing and using the Version 2 0 Page 16 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date
13. le m Task Name v Task Number Priority actual Priority base Start of Stack Top of Stack j iBTest 7 3 3 0x200031c8 0x2000320c BLOCKED Block _Time_ 80 BTest2 8 2 2 0x20003310 0x20003384 BLOCKED None 128 BIkSEM1 11 1 1 0x200037e8 0x20003854 BLOCKED None 104 BIkKSEM2 12 1 1 0x20003930 0x2000399c BLOCKED None 80 CREATOR 34 3 3 0x20005948 0Ox20005aac BLOCKED None gt 256 GenQ 16 0 0 0x20003f38 0x20003f8c READY None 112 H1QRx 27 3 3 0x20004e6c 0x20004ec8 BLOCKED NormallyEmpty 64 H1QTx 31 3 3 0x2000538c 0x200053f0 BLOCKED NormallyFull 68 H1QTx 3 3 0x20005244 0x200052b8 BLOCKED None 72 Sane SESE Bases 6 IDLE 35 0 0 0x20005b80 0x20005c18 READY None 148 IntMath 15 0 0 0x20003d7c 0x20003e0c READY None 156 LORx 29 0 0 Ox200050fc 0x20005160 READY None 88 LQRx 32 0 0 0x200054d4 0x20005538 READY None 68 MAC 36 4 0x20005d7c 0x20005dd8 BLOCKED 0x20005cf0 104 MuHigh 19 3 0x20004364 0x200043e0 BLOCKED None 76 MuLow 17 0 0 0x200040d4 0x20004140 READY None 72 MuMed 18 2 2 0x200042ic 0x200042a0 BLOCKED None 144 OLED 33 0 0 0x2000572c 0x20005820 BLOCKED 0x20002444 gt 256 PeekH1 22 2 2 0x200047b0 0x200048ic BLOCKED QPeek_Test 76 PeekH2 23 3 3 0x200048f8 0x20004964 BLOCKED QPeek_Test 96 xi Figure 2 11 Example task table screen shot Figure 2 11 provides an example task table screen shot where each table row provides information on a single task If the row is black then the information it contains has n
14. lipse Figure 2 1 Install New Software menu item Step 2 In the Work with category click the Add button See Figure 2 3 Step 3 In the Add Repository dialog window specify plug in name as StateViewer and location path as hitp www highintegritysystems com StateViewer and click OK E Add Repository Mame Stateviewer Location https enn highintegritysystems com Stateviewer h Figure 2 2 Add Repository Dialog Installing and using the Version 2 0 Page 6 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date 4 Zw WITTENSTEIN Step 1 Tick the WHIS StateViewer Plugins category and click the Next gt button Install AE Available Software Check the items that you wish to install SE Work with StabeViewer http fut highintegritysystems com State viewer wt Find more software by working with the Available Software Sites preferences type fiter text _ O Name Version UUU WHIS Stateviewer Plugins Select All Deselect All 1 item selected Details Show only the latest versions of available software Hide items that are already installed Group items by category What is already installed Show only software applicable to target environment Contact all update sites during install to Find required soft
15. ot changed since the debugger was last suspended Conversely if the row is red then at least one of the columns in that row has changed since the debugger was last suspended The green highlight indicates the currently executing task the task that is in the Running state Installing and using the Version 2 0 Page 13 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date AA WITTENSTEIN Table 2 1 Task Table Columns Task Name The plain text name assigned to the task when the task was created Task Number A unique assuming no overflows number assigned to the task by the kernel The priority currently being used by the task The OPENRTOS priority inheritance mechanism means the actual priority can transiently be higher than the tasks base assigned priority Priority actual The priority assigned to the task A priority is assigned when the task is created and each time the task is the subject of a call to vTaskPrioritySet Priority base Start of Stack The address of the beginning of the stack assigned to the task The beginning of the stack is the extreme of the stack region that gets written into first Top of Stack The address of the current top of stack that is the position last written to when the context of the stack was last saved This value has little meaning for the current Running
16. ware Cancel Figure 2 3 Available Software window Installing and using the Version 2 0 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date Page 7 f Da WITTENSTEIN Step2 The Install Details window displays the items to be installed Click Next gt E Install Install Details Review the items to be installed Mame version Id Lape WHIS Stateviewer 2 0 1 20110705 WHIS Stateviewer feature group Size Unknown Details Cancel Figure 2 4 Install Details window Installing and using the Version 2 0 Page 8 STATEVIEWER Eclipse plug in THE INFORMATION CONTAINED IN THIS DOCUMENT IS PROPRIETARY AND SUBJECT TO THE RESTRICTIONS ON THE COVER PAGE Copyright date as document date ZN WITTENSTEIN Step 3 The Review Licenses window requires accepting the License to use the software to proceed Read the License Text for WHIS StateViewer If you agree with the terms and conditions select the I accept the terms of the license agreements pushbutton and click Finish to install the software E Install Review Licenses Licenses must be reviewed and accepted before the software can be installed License text For WHIS Stateviewer 2 0 1 201107051217 STATEVIEWER LICENSE AGREEMENT ATTENTION PLEASE READ THIS DOCUMENT CAREFULLY BEFORE INSTA
Download Pdf Manuals
Related Search