µC/Probe User`s Manual - Doc
Contents
1. eee EEN rennen 33 HuC Probe ne E did 35 Associating Symbols to Virtual Controls and Indicators 37 RUN MME MOOC M TETTE 41 Run Time Checklist oras 41 Running yu C Probe and your Debugging Software at the same time 43 Configuring Virtual Controls and Indicators 45 MVirt al Indie tO S ad did 46 IRA ON 50 A A ETA N EA 57 Kernel Awareness Screen NEEN 63 License and ACtIVALIOM EE 67 OT STA NRI 67 ACHIV UNO iia 68 BIDIOGF Ap cainii a i n 69 MOO eraan A E A 71 Chapter Introduction uC Probe is a Windows application designed to read and write the memory of any embedded target processor during run time Memory locations are mapped to a set of virtual controls and indicators placed on a dashboard Figure 1 1 shows an overview of the system and data flow Windows PC ELF File Running pu C Probe Symbol names Data Server and Client and addresses ELF Header Program Header Table rodata Section Header Table JTAG 2 N o C uC Probe Workspace gt Dashboard made out of O virtual controls mapped T to the target s symbols 3 Embedded System Running uC Probe Target Figure 1 1 uC Probe Data Flow Diagram o Chapter 1 F1 1C1 F1 102 F1 103 F1 1 4 F1 165 You have to provide uC Probe with an ELF file with DWARF 2 debugging information The ELF file is generated by your toolchain s linker nC Probe parses2. FA 14 4 Here you specify the labels you want to display during the On and Off states FA 145 You can specify the border colors you want to display during the On and Off states and whether or not you want to show the Repeat label on the corner 56 A 3 CHARTS Figure A 15 shows the three types of charts supported by uC Probe A App ECG Waveform 0 0 550 1100 165 0 2200 2750 3300 3850 440 0 495 550 0 27 5 825 1375 1925 2475 3025 3575 4125 4675 45 5 170 4 700 App ECG Waveform 4 230 3 760 3 290 2 820 2 350 1 880 1410 0 0 550 1100 165 0 2200 2750 3300 3850 440 0 495 550 0 27 5 825 1375 1925 2475 3025 3575 4125 467 5 5 4 700 vn App ECG Waveform 0 0 55 0 110 0 1650 2200 2750 3300 3850 440 0 495 550 0 275 825 1375 1925 2475 3025 3575 4125 4675 S5 Figure A 15 Marker Line and Area Charts of Appendix A A 3 1 CHART PROPERTIES EDITOR All three chart types share the same properties editor as shown in Figure A 16 4 700 1 3 760 Her sco waveform pu C Probe Properties Editor M i Primary Y Axis 1 1 880 J Min 800 940 d CET ECT ETA ET ET CHEN II 0 0 1100 2200 3300 4400 za Max 5500 Tick Marks Step 470 X Axis 2 Offset 0 Max Samples 550 Update Style 3 Strip Scope Erase Trace e Burst General 4 Legend Position InsideTopRight E Formatting 5 Scaling Factor 1 Scaling Offset 0 Figure A 16 Charts Properties Editor FA 16 1 In order to change t
3. attached to and select the baud rate from the drop downs shown in Figure 4 7 Interfaces Gei Segger J Link Settings Ze TCP IP l COM Port COM1 Y Baud Rate 38400 gt Figure 4 7 uC Probe Communication Settings RS 232 22 Chapter uC Probe Workspace Explorer The uC Probe Workspace Explorer is located on the right side of the application window and it is shown in Figure 5 1 Lo y al 3 X Add Project Add Data Node Add Data Screen l DataScreen1 Add Kernel Awareness Delete DataS 2 k Ti DataScreen Outdent Node 4 4 Project2 Indent Node 4 Ze DataNodel F1 DataScreen3 ls DataScreen4 4 Ze DataNode2 B 0 8 DataScreen5 MD dH l 053 X uo y un 1 Q G9 mm em Figure 5 1 uC Probe Workspace Explorer F5 1C1 uC Probe allows you to create a dashboard or user interface in a matter of minutes The data screen is where you drag and drop the virtual controls and indicators Your data screen s appearance and layout are very important You can use Projects as a means to separate complex dashboards into multiple regions Each project can contain multiple data screens and the workspace explorer allows you to navigate through this hierarchy F5 1 2 Similar to Projects Data Nodes are just another level of hierarchy that allows you to group sets of virtual controls and indicators together into categories you define 23 Chapter 5 F5 1 3 F5 1 4 F5 1 5 F5 1 6 F5 1 7 Data
4. Figure A 17 Charts Series Editor FA 17 1 Select the data series you want to work with By default the name of the data series is the same of the symbol as declared in your embedded target C files 60 FA 17 2 FA 17 3 FA 17 4 FA 17 5 uC Probe supports three types of charts marker line and area charts You can mix and match chart types in one single chart by selecting the corresponding check box If the Show Line check box is selected this section allows you to configure the color and thickness of the line If the Show Area check box is selected this section allows you to configure the color of the area If the Show Points check box is selected this section allows you to configure the color thickness and shape of the points 61 Appendix A 62 Appendix Kernel Awareness Screen uC Probe allows you to add pre configured data screens that display some of the most popular Micrium s software modules Figure B 1 and Figure B 2 show examples of the Kernel Awareness Screens for uC OS III The Screens display nC OS III s internal data structures in a convenient series of windows This provides you with information about each of the active tasks in the embedded target application among other kernel objects such as semaphores event flags mutexes etc 63 Appendix B pC OS MKA DataScreenl CPU Usage 1 42 us d Miscellaneous CPU Usage 1 42 OS Running Yes Idle Task Counter 22 740 203 Sta
5. 3 1 F2 3 2 F2 3 3 F2 3 4 F2 36 F2 3 6 12 Figure 2 3 uC Probe Windows Application Chapter 3 uC Probe Symbol Browser on page 13 Chapter 4 uC Probe Settings on page 17 Chapter 5 uC Probe Workspace Explorer on page 23 Chapter 6 uC Probe Toolbox on page 25 Chapter 7 uC Probe Layout Design Tools on page 33 Chapter 8 Associating Symbols to Virtual Controls and Indicators on page 37 Chapter uC Probe Symbol Browser The pn C Probe s Symbol Browser is a list of your embedded target s symbols that helps you quickly find the symbol you want to use in your data screen The symbol browser is available during design mode and it is located at the bottom of the application window 3 1 LOADING AN ELF FILE In order to provide n C Probe with the path of the embedded targets output file CELF file locate and click the button indicated in Figure 3 1 Le Search for symbol gt Name Display Name Figure 3 1 uC Probe Symbol Browser Loading an ELF file uC Probe will prompt for the ELF file path by using a standard open file dialog Locate the output file in your PC The path is usually configured from your toolchain s linker configuration The ELF file needs to have symbolic information for debugging purposes in the DWARF 2 format Refer to the document uC Probe Target Manual for more information on building and configuring your toolchain to generate an ELF f
6. 366 4 8 0 0 32 68 100 32 00 4 LCD Task 5 Pending Timeout Task Message Queue Task Q 986 0 09 4 038 8 4 0 0 38 62 100 ge 00 96 H Startup 3 Delayed 100 0 03 96 2 367 4 8 0 0 44 106 150 KEE 96 6 uC OS III Timer Task 14 Pending Task Semaphore Task Sem 0 0 03 96 2 368 4 3 71 36 64 100 Se 00 926 7 uC OS III Stat Task 14 Delayed 100 0 31 96 2 369 5 3 0 0 38 62 100 EEs 00 8 uC OS IM Tick Task 12 Pending Task Semaphore Task Sem 0 2 85 237 152 16 2 0 0 28 72 100 Bed 28 00 96 9 uC OS IIl Idle Task 15 Ready o BEEN 239 578 44 0 0 18 82 100 B 18 00 4 m gt Task s Semaphore s Mutex es Event Flag s Miscellaneous Figure B 2 Kernel Awareness Screen Task List 65 Appendix B 66 Appendix License and Activation uC Probe is distributed as shareware you can download a trial version that allows you to create data screens with up to 10 symbols You can use the n C Probe trial version for an unlimited period of time to find out if it suits your needs The full version of pC Probe allows an unlimited number of symbols and unlocks other more sophisticated features such as spreadsheets that allow you to associate each cell with a symbol and use all the calculation features a regular spreadsheet has to offer C 1 ORDERING If you decide to obtain the full version of pC Probe you will have to purchase a license The license key will unlock the trial version and entitle you to e mail support and free minor software updates for an
7. expertise hardware and software environments into which wC Probe may be subjected the user assumes all risk of using uC Probe The maximum liability of Micrium will be limited exclusively to the purchase price Micrium 600 uC Probe 002 Chapter 1 Chapter 2 2 1 Chapter 3 3 1 3 2 Chapter 4 4 1 4 2 4 2 1 4 2 2 4 2 3 Chapter 5 Chapter 6 6 1 6 2 6 3 6 4 6 5 6 6 6 7 6 8 6 9 Table of Contents INTOAUCUON Meet MT 5 UC Probe System Overview c eceeeceeeeeeeee eene nene n nnne nana 7 iG Probe Data Client 10 UC Probe Symbol Browser 1 eee ecce cesses ERR nenne nnn n nnn nnn 13 Sagna an EEF EE 13 Browsing the ELF TIO cuisine 14 HIG Ee ele dr e eds 17 General Seling CN 18 Gormimunicatlon Eu due EE 19 lie leie UNI cd eee eee 20 Re TEE 21 ee 22 UC Probe Workspace Explorer eeeeseee eene 23 UG Probe TOOIDOX EE 25 Linear Gauges as 26 Horizontal Einear Gauges cuisine 27 QuadrantGaudes ansia 27 Semicircio GAUGES cup oie 28 Circular GAUGES sssrini a uu deco Uu eee uae ua 28 nal Bro icc 29 Be 29 A NE NM TH UC E RE I ER 30 Klee EE 30 Table of Contents 6 10 6 11 Chapter 7 7 1 Chapter 8 Chapter 9 9 1 9 2 Appendix A A 1 A 2 A 3 Appendix B Appendix C 9 3 9 4 Appendix D Val ere e EE 31 Writable Controls NETT T 31 UC Probe Layout Design Tools
8. pC Probe User s Manual output file CELF file that the embedded target Chapter 3 on page 13 is actually running uC Probe has been configured with the proper uC Probe User s Manual communication interface and settings Chapter 4 on page 17 uC Probe contains at least one virtual control or pC Probe User s Manual indicator on the data screen Chapter 7 on page 33 uC Probe has been configured to associate the pC Probe User s Manual virtual control or indicator with one of the Chapter 8 on page 37 embedded targets variables displayed in the symbol browser Table 9 1 Run Time Mode Checklist 41 Chapter 9 In order to set uC Probe in Run Time mode click on the run button indicated in Figure 9 1 Run Time Mode as 2m OM pl Micrium uC Probe File Home a Y k Bring Forward ii Group TH Show Hide Grid MIL Eh a Send Backward Align E Show Hide Rulers my Paste Full Settings A AR d olia iiy Units Ago Zoom Factor Screen Clipboard Arrange fa Layout Application Figure 9 1 Setting pnC Probe in Run Time mode uC Probe should start updating your data screens immediately and the application displays all kinds of status information in the status bar at the bottom of the pC Probe window as shown in Figure 9 2 Data server configured and processing requests Segger J Link SWD 500 kHz Connection to target established Symbols Configured 80 Rx 6637 bytes sec Tx 663
9. the ELF file and reads the addresses of each of the embedded targets symbols i e global variables and creates a catalog known as symbol browser which will be used by you during design time to select the symbols you want to display on your dashboard Refer to the document uC Probe Target Manual for more information on installing the uC Probe Target C files and building the ELF file During design time you create a pC Probe workspace using a Windows PC and uC Probe You design your own dashboard by dragging and dropping virtual controls and indicators onto a data screen Each virtual control and indicator needs to be mapped to an embedded targets symbol by selecting it from the symbol browser This document aims at providing more information on creating your own dashboard with n C Probe Before proceeding to the run time stage uC Probe needs to be configured to use one of the three communication interfaces JTAG RS232 or TCP IP In order to start the run time stage you click the Play button and wC Probe starts making requests to read the value of all the memory locations associated with each virtual control and indicator G e buttons and gauges respectively At the same time uC Probe sends commands to write the memory locations associated with each virtual control G e buttons on a click event In the case of a reading request the embedded target responds with the latest value In the case of a write command the embedded
10. the memory location of the variable in the embedded targets memory You can select the update mode in a per object basis m Fast Mode The uC Probe Data Server will update this symbol as fast as it can E Slow Mode The uC Probe Data Server will update the symbol at 5096 of the fastest speed possible Use this update mode when trying to free up CPU resources E Periodic Mode The uC Probe Data Server will try to update the symbol at a specific update rate The update rate applies to the Periodic Mode Enter the desired update rate in milliseconds and the nu C Probe Data Server will try to keep the symbol up to date at this rate The variable path displays the full variable name in those cases where the variable you selected is a member of a data structure In case the variable is an array you can enable indexing of just a certain amount of data 39 Chapter 8 40 Chapter Run Time Mode 9 1 RUN TIME CHECKLIST Before setting pC Probe in Run Time mode you should verify each of the following items Item Description Reference The embedded target has been programmed pC Probe Target Manual with an output file ELF file with debug Chapter 5 on page 16 information in the DWARF 2 format The embedded target is running and connected pC Probe Target Manual to the Windows PC through the communication Chapter 3 on page 10 interface of your choice uC Probe has been configured with the latest
11. 5 push button properties editor eee 54 Q quadrant gauges 6 E FRE EEn poa dE sunsets 27 R range and colors editor oooccooonocccconnnncnonnaninccnnnnnnos 47 repeat button properties e Te E 56 EE 22 run time mode eeeseseseeeeeeeeee nenne nennen nnn nnne 42 run time mode checklist eeeseeeessessss 41 S Segger J Link ae a th caees eee tee 20 semicircle gauges eee 28 slider control properties editor eee 50 Stalus Dar cec a aeris ee eee coa d 42 symbol browser loading art ZB en UE 13 symbols grouped by C nie 14 peor e 37 symbols manager sseseeseeeeeeereeeee nnne 38 T e EE 21 toggle button properties de E 55 toolbar settings E 17 tOOIDOX ieee cscs en area o A M N 25 E a EE 30 circular gauges cn a 28 CAMAS a od 29 q E ee add es 29 horizontal linear gauges sues 27 linear gauges aiii ia 26 miscellaneous ca tias 31 o EE 30 quadrant gauges REENEN rnern EEN 27 semicircle gauges ue 28 writable controls AE 31 12 V virtual controls Sar ome ded edu os a at 37 45 50 virtual indicators ccooccccocccconcnnconcncnncnnonnononncncnncnnnnn 45 46 W Windows application 12 workspace explorer eeeeseeseeeneenn 23 24 writable controls EE 31 Z uC Probe data client occooonccccccccnncccnnnccnnnncnnccnnaconnnns 10 ee ln LE 10
12. 7 bytes sec Figure 9 2 uC Probe Status Bar You can also look at the uC Probe output window during run time as shown in Figure 9 3 to learn more about the system status Sending configuration waiting for acknowledgement Data server configured and processing requests Figure 9 3 pC Probe Output Window 42 Running uC Probe and your Debugging Software at the same time 9 2 RUNNING pu C PROBE AND YOUR DEBUGGING SOFTWARE AT THE SAME TIME Your debugging software for embedded applications usually comes integrated with your IDE and at a minimum allows you to step through the code set breakpoints display register and memory windows display call stack information and monitor variables and expressions Examples of debugging software include IAR s C SPY and GNU s GDB You can also use uC Probe to extend the capabilities of your debugging software by running both at the same time uC Probe allows you to have instant control over your global variables in a real time and non intrusive way From you debugger software you can set breakpoints at locations of particular interest in the application being debugged and uC Probe will stop updating the virtual controls and indicators at the same time This feature is accomplished by sharing the connection between the Windows PC and the Embedded Target being debugged Whether the debugger of your choice is IAR s C SPY GNU s GDB or any other debugging software that supports J Link Figure 9 4 illustrate
13. HC Probe Run Time Monitoring User s Manual V1 00 Micrium LL Press Weston FL 33326 Micrium 1290 Weston Road Suite 306 Weston FL 33326 USA www micrium com Designations used by companies to distinguish their products are often claimed as trademarks In all instances where Micrium Press is aware of a trademark claim the product name appears in initial capital letters in all capital letters or in accordance with the vendor s capitalization preference Readers should contact the appropriate companies for more complete information on trademarks and trademark registrations All trademarks and registered trademarks in this manual are the property of their respective holders Copyright 2012 by Micrium except where noted otherwise All rights reserved Printed in the United States of America No part of this publication may be reproduced or distributed in any form or by any means or stored in a database or retrieval system without the prior written permission of the publisher uC Probe and the accompanying files are sold as is Micrium makes and customer receives from Micrium no express or implied warranties of any kind with respect to the software product documentation maintenance services third party software or other services Micrium specifically disclaims and excludes any and all implied warranties of merchantability fitness for a particular purpose and non infringement Due to the variety of user
14. INDERS Use the cylinder or tank level indicator shown in Figure 6 8 to display numeric data in a solid or gradient color For more information configuring the properties of cylinders see Appendix A Virtual Indicators on page 46 Figure 6 8 pC Probe Toolbox Cylinders 29 Chapter 6 6 8 CHARTS Use the charts shown in Figure 6 9 to display numeric data including arrays in a marker line or area chart For more information configuring the properties of charts see Appendix A Charts on page 57 Figure 6 9 uC Probe Toolbox Charts 6 9 NUMERICS Use the numeric indicators shown in Figure 6 10 to display numeric data in text For more information configuring the properties of numeric indicators see Appendix A Formatting Properties Editor on page 46 and Appendix A Numeric Indicator Properties Editor on El 25 25 Figure 6 10 pC Probe Toolbox Numerics page 48 30 Miscellaneous 6 10 MISCELLANEOUS Other miscellaneous indicators include a text box thermometer and an image container capable of displaying an indexed array of images For more information configuring the properties of these miscellaneous indicators see Appendix A Virtual Indicators on page 46 i Figure 6 11 pC Probe Toolbox Miscellaneous 6 11 WRITABLE CONTROLS The writable controls shown in Figure 6 12 include buttons check boxes and sliders Use these controls to modify the value of symbols from the embedded target For m
15. Screens are the screens where you drag and drop the virtual controls and indicators You can add as many data screens as you want The Kernel Awareness Screen is a pre configured Data Screen with all the symbols related to uC OS III See Appendix B Kernel Awareness Screen on page 63 for more information about this Use the Delete button to delete an item from the workspace explorer including Projects Data Nodes Data Screens and Kernel Awareness Screens Use the indent button to push in an item in the Workspace Explorer tree The items you can adjust the level of indentation include Projects Data Nodes Data Screens and Kernel Awareness Screens Use the outdent button to push out an item in the Workspace Explorer tree The items you can outdent include Projects Data Nodes Data Screens and Kernel Awareness Screens In order to organize your workspace tree you can also use your mouse to drag and drop items and rename items by invoking the context menu with a right click Figure 5 2 shows an example of using projects and data nodes to better present a control panel for a liquid level control system 24 Ta cg WS o5 A md I 4 e Liquid Level Controller 4 Ze User Interface ls Control Diagram ICH Schematic Diagram 4 Ze Debugging Interface Ili Task Model wa uC OS III KA Figure 5 2 Workspace Explorer for a Liquid Level Control System Chapter uC Probe Toolbox The uC Probe Toolbox is located on the left si
16. ale For more information configuring the properties of horizontal linear gauges see Appendix A Virtual Indicators on page 46 0 100 Meee e Figure 6 3 uC Probe Toolbox Horizontal Linear Gauges 6 3 QUADRANT GAUGES Use the quadrant gauges shown in Figure 6 4 to display numeric data in a tri color quadrant scale For more information configuring the properties of quadrant gauges see Appendix A Virtual Indicators on page 46 100 Figure 6 4 pC Probe Toolbox Quadrant Gauges et Chapter 6 6 4 SEMICIRCLE GAUGES Use the semicircle gauges shown in Figure 6 5 to display numeric data in a tri color semicircular scale For more information configuring the properties of semicircle gauges see Appendix A Virtual Indicators on page 46 Figure 6 5 uC Probe Toolbox Semicircle Gauges 6 5 CIRCULAR GAUGES Use the circular gauges shown in Figure 6 6 to display numeric data in a tri color circular scale For more information configuring the properties of circular gauges see Appendix A Virtual Indicators on page 46 Figure 6 6 uC Probe Toolbox Circular Gauges 28 Half Donuts 6 6 HALF DONUTS Use the half donut indicators shown in Figure 6 7 to display numeric data in a bi color semicircular scale For more information configuring the properties of half donuts see Appendix A Virtual Indicators on page 46 25 25 25 100 25 100 Figure 6 7 uC Probe Toolbox Half Donuts 6 7 CYL
17. as shown in Figure A 10 d y OFF uC Probe Properties Editor Settings Switch On Value 1 Switch Off Value 0 Figure A 10 Custom Switch Properties Editor 92 A 2 4 CHECKBOX PROPERTIES EDITOR The checkbox control is similar to the custom switch but it also allows you to specify a label to display when the checkbox is selected and not selected In the example shown in Figure A 11 such labels are set to Enabled during the On state and Disabled during the Off state F Enabled uC Probe Properties Editor Checkbox Font Family Segoe UI Font Size 12 Font Color ENN Black Settings Check On Value Check Off Value Label On Label Off 1 0 Enabled Disabled Figure A 11 Checkbox Properties Editor 93 Appendix A A 2 5 PUSH BUTTON PROPERTIES EDITOR The push button control is a momentary switch that switches between the states On while held down and Off when released The properties window is shown in Figure A 12 d y EN pu C Probe Properties Editor Closed Push Button 1 Font Family Segoe UI e Font Size 12 Font Color Wm Black 5 Settings Push On Value l 2 Push Off Value 0 3 Label On Open 4 Label Off Closed Appearance 5 Show Type FJ ON State Color LightGreen z OFF State Color mw LightCoral Figure A 12 Push Button Properties Editor FA 12 1 You can specify the labels to display during the On and Off states These properties affect the label s font family font size and font co
18. atures with the exception that your dashboard can only contain 10 symbols Trial versions do not require internet access to activate the software application The full version of uC Probe requires internet access to validate the license key provided by your Micripm s sales representative wC Probe s licensing infrastructure is based on the Nalpeiron Licensing Service For more information on uC Probe Licensing see Appendix C License and Activation on page 67 Both versions of uC Probe are self updating and every time you start the application if internet access is available the uC Probe AULS module checks for newer versions of uC Probe from the Micrium website and as they become available the uC Probe AULS module automatically replaces any updated files uC Probe is based on a client server model design where both client and server reside in the same PC The uC Probe Data Client is the part of the application that allows you to design your dashboard design time mode and run it run time mode The next section in this document provides more information in regards to using the uC Probe Data Client during design time and run time The uC Probe Data Server is the part of the application that runs in the background You do not get to see it but it is the part of the application that connects directly with the Embedded Target and responds to the requests from the Data Client F2 1 6 F2 1 7 When the pC Prob
19. ccccconcccococoncnncnanoconcnnnnanoconcnnns 60 checkbox properties editor n noennnnnneenensrnnnnnrenrerrennne 53 circular gauges eas io 28 communication settings oooooonccccnnncccccnnncncnnnncnncnnnnnnnnnnns 19 dB deme 20 nip EE 22 TG PHP acacia 21 custom slider example eege 51 properties editor occccoccccconcccococoncnnononoconcncnnanncnnnnnos 51 custom switch properties editor seeeesseeeeeeee nennen 52 MOS taras 29 D data TOW a sos ratios 5 desig time tota 10 E zB AI dee 13 ROW SING e 14 SO EE 35 F formatting properties editor vestir 46 G e EE e le E 18 H ers ufo eiui cc M A A 29 horizontal linear gauges oocccccoocccccnocccnccnnncncnnnncnnnonancnnnnns 27 Take etsita gw LM n EE 37 J SEN E EEeEEEE E eEEe 20 K kernel awareness screen miscellaneous EE 64 RAS MESO tae nre cc O 65 L layout design toolS EE 33 A DD 57 linear gauges cunde 26 M marker charts ui os 57 miscellaneous tools eeeeeeeeeeeeeee 31 N numeric indicator properties editor EE 48 N ME ICS TOOS E 30 O Ordering ME 67 Leif ele lee EE 42 ee EE 7 vd Index D properties editor animation Pt TEE 48 49 tace o QE UE 53 CUSTOM Sliders cs doo ol 51 formatting RE 46 numeric indicator 5 s icta skeksseeedeeeE SSES AA egge 48 PUSH DUO eS 54 repeat button NEE 56 ll COnNtrol eee S 50 toggle DUTTON Pest 5
20. choice The check box on the left corner at the bottom of the window allows you to override the DLL path with the one from the settings window as discussed in Chapter 4 Segger J Link on page 20 44 Appendix Configuring Virtual Controls and Indicators Once you drag and drop one of the virtual controls or indicators onto the data screen and associate it with one of the embedded target s symbols from the symbol browser you can access the properties tool bar by moving the mouse over the virtual control or indicator The tool bar shown in Figure A 1 appears for you to select between one of the three configuration categories Symbols Manager 1 Properties Editor 2 Range amp Colors Editor 3 Figure A 1 Virtual Controls and Indicators Toolbar FA 1 1 The Symbols Manager is common for all virtual controls and indicators see Chapter 8 Associating Symbols to Virtual Controls and Indicators on page 37 for more information on the Symbols Manager FA 1 2 The Properties Editor is similar among most of the virtual controls and indicators and the next sections will describe how to use the Properties Editor for just a few of the most representative virtual controls and indicators FA 1 3 The Range and Colors Editor is only available to those virtual indicators that feature a multi color scale The next sections will describe how to use the Range and Colors Editor for a few of the most representative virtual indica
21. de of the application window and it is shown in Figure 6 1 Linear Gauges H Linear 1 i Linear 2 Linear 3 Linear Gauges Horizontal Linear Gauges Quadrant Gauges Semicircle Gauges Circular Gauges Half Donuts 2ODDI Kl e x MFD Cylinders Graphs Numerics Miscellaneous i E Writable Controls Figure 6 1 pC Probe Toolbox 25 Chapter 6 The items in the toolbox are contained in an accordion type of panel You click on each button to display the items that belong to a category If you are running the full version of uC Probe and have the automatic updates enabled each category in this toolbox will expand with more virtual controls and indicators as software updates become available The following sections present a brief introduction to each of the toolbox categories For more information on configuring each type of virtual control or indicator see Appendix A Configuring Virtual Controls and Indicators on page 45 6 1 LINEAR GAUGES Use the linear gauges shown in Figure 6 2 to display numeric data in a tri color vertical scale For more information configuring the properties of linear gauges see Appendix A Virtual Indicators on page 46 0 80 60 60 40 40 Figure 6 2 uC Probe Toolbox Linear Gauges 26 Horizontal Linear Gauges 6 2 HORIZONTAL LINEAR GAUGES Use the horizontal linear gauges shown in Figure 6 3 to display numeric data in a tri color horizontal sc
22. e run time mode gets started the Data Client sends a message to the Data Server through a Windows Communication Foundation WCF channel The message contains not only the embedded target communication settings but also all the symbol s memory address required by your dashboard design The pC Probe Data Server takes the message from the pC Probe Data Client and initiates a communication with the embedded target through the configured communication interface The uC Probe Data Client establishes a connection with the uC Probe Data Server through a Microsoft Message Queuing MSMQ port and exchanges requests to read and write the memory locations required by the current view of your dashboard s design Chapter 2 2 1 n C PROBE DATA CLIENT The uC Probe Data Client is illustrated in more detail in Figure 2 2 uC Probe Data Client Design Time ER mir _ Settings _ Workspace Explorer ELF File Symbol names and addresses ELF Header t Program Header 4 EP rodata Symbol Browser N AppSpeed float 0x0034F4C2 AppTemp LN 0x0034F75D Section Header Table Figure 2 2 pC Probe Data Client Design Time F2 2 1 The uC Probe Data Client is the part of the application that during design time takes the ELF file with DWARF 2 debugging information As previously discussed the ELF file is generated by your toolchain s linker The uC Probe Data Client parse
23. eady to go into Run Mode unless you want to further configure other optional settings In order to configure other optional settings you can use the symbols manager by hovering your mouse pointer over the virtual control or indicator and making click on the icon shown in Figure 8 2 Lt d Yd Figure 8 3 shows the Symbols Manager Symbols Manager Properties Editor Hange amp Colors Figure 8 2 Invoking the Symbols Manager pu C Probe Symbols Manager Symbols Symbol Information 2 3 4 5 e 6 7 8 9 10 38 Name Display Name Type Size bytes Memory Address Update Mode Update Rate ms Path Is An Array Array Length Array Elems To Retrieve AppLevelActual Actual Liquid Level unsigned short 2 0x200060EE O Fast gt Periodic Slow Logging 0 AppLevelActual Figure 8 3 Symbols Manager F8 3 1 F8 3 2 F8 3 3 F8 3 4 F8 3 5 F8 3 6 F8 3 7 F8 3 8 F8 3 9 F8 3 10 Click the red X to remove the symbol s association from the virtual control or indicator Displays the name of the variable as declared in your C file By default displays the name of the variable as declared in your C file but this text box allows you to create an alias for display purposes Displays the data type of the variable as declared in your C file Displays the size of the variable in number of bytes Displays
24. friendly You can control the zoom level of your uC Probe Data Screen during both design time and run time Click the buttons with the magnifier glass to zoom in and out or use the keyboard shortcuts Ctrl to zoom in and Ctrl to zoom out 33 Chapter 7 F7 1 4 F7 1 5 F7 1 6 F7 1 7 F7 1 8 F7 1 9 F7 1C10 34 The panning tool in pC Probe makes it easy to move a data screen around while your are zoomed in The Pan button is a toggle button clicking the button toggles the panning mode on and off When you drag and drop a virtual control or indicator onto the data screen the next thing you usually do is resize or move the object around the data screen Turn the Snap to Grid mode on in order to align the virtual control or indicator to the nearest intersection of grid lines The Snap to Grid button is a toggle button clicking the button toggles the snap to grid mode on and off You can combine multiple virtual controls and indicators so you can work with them as though they were a single object You can resize move copy and paste all virtual controls and indicators in a group as a single unit After you have grouped virtual controls and indicators you can still select any single object within the group without un grouping by first selecting the group and then clicking on the object you want to select uC Probe allows you to easily align virtual controls and indicators by first selecting the group of objects you wa
25. ful virtual indicators because you have the freedom to customize it however you want by providing your own images Imagine you want to display the state of a valve to be either open or closed in a graphical way by using the bitmap images shown in Figure A 5 and an embedded target s application variable named AppValveOutPct that stores the state of the outflow valve 096 0pen and 100 closed Valve Valve Open Closed Figure A 5 Bitmaps to Animate 48 Figure A 6 shows the properties editor for the bitmap animation FA 6 1 FA 6 2 FA 6 3 FA 6 4 uC Probe Properties Editor Images Valve Open c Image 1 1 Gy image 2 2 X Transition effect L1 3 Settings Path Graphics Bitmap Animations Valve Open png 4 Symbol Symbol Name AppValveOutPct Is equal to Is less than or equal to Is not equal to Is greater than or equal tc e Is less than Is greater than Value 100 Figure A 6 Bitmap Animation Properties Editor The list of images is initialized with two images Start by selecting the image you want to work with A preview of the image is shown on the right side You can add or delete more images into the list by making click on the red or x buttons respectively Select the transition effect check box if you want to add a fade in and fade out effect between image transitions Specify the bitmap file path or browse to it Specify the rules In this case if AppValveOutPct 100 then t
26. gram Files x86 SEGGER JLinkARM_V420h J m Figure 4 5 uC Probe Communication Settings J Link Communication Settings 4 2 2 TCP IP uC Probe supports a TCP IP interface over the UDP protocol This TCP IP interface as opposed to J Link requires uC Probe Target code resident in your embedded system and because of the nature of TCP IP it also requires a kernel Micrium supports many cores and most likely this code is available from Micrium Contact Micrium to find out if resident code for your particular setup is available Assuming your embedded system is running pn C Probe Target as described in the document uC Probe Target Manual enter the IP address and port number of your embedded system in the text boxes shown in Figure 4 6 Interfaces jor Segger J Link Settings A TCP IP Remote Host 192 168 1 149 iy RS 232 Remote Port 9930 Figure 4 6 uC Probe Communication Settings TCP IP 21 Chapter 4 4 2 3 RS 232 uC Probe supports a Serial RS 232 interface This serial interface as opposed to J Link requires uC Probe Target code resident in your embedded system Micrium supports many UARTS and most likely this code is available from Micrium Contact Micrium to find out if resident code for your particular setup is available Assuming your embedded system is running nC Probe Target as described in the document uC Probe Target Manual enter the serial COM port number that your embedded target is
27. he number at which the vertical axis value starts or ends enter a different number in the Min box or the Max box In order to change the interval of tick marks and chart grid lines enter a different number in the Tick Marks Step box FA 16Q In order to change the number at which the horizontal axis value starts or ends enter a different number in the Offset box or the Max Samples box o8 FA 16 3 FA 16 4 FA 16 5 uC Probe updates charts in one of three modes E Strip Mode similar to a chart recorder device that prints over a paper strip uC Probe first plots points from the left to the right side of the chart From there any new points are plotted at the rightmost side of the chart by shifting old points to the left E Scope Mode similar to an oscilloscope uC Probe first plots points from the left to the right side of the chart Once the plot reaches the right side of the chart it erases the plot and begins plotting again from the left side of the chart E Burst Mode this update mode was made for high performance applications where you want to plot array data quickly by plotting the entire array in one sweep pnC Probe will not shift any points over the plotting area Instead it will erase the plot and will plot the same array again assuming that the array is being updated by the embedded target uC Probe supports charts with multiple data series That means that you can associate multiple symbols f
28. he valve is open and if AppValveOutPct 100 then the valve is all the way closed 49 Appendix A A 2 VIRTUAL CONTROLS A 2 1 SLIDER CONTROL PROPERTIES EDITOR The slider control is one of the few writable controls It allows you to gradually modify an adjustable embedded target symbol s value The user gets to select from a range of values by moving a value indicator up and down a track For example you typically create a volume control by using a slider control Figure A 7 shows the slider control properties editor pu C Probe Properties Editor Range 1 Min 0 I y Max 100 AE Tick Frequency 10 General 2 Show Slider Label wi Slider Font Family Arial X Slider Font Color ENN Gray Slider Font Size 10 Decimal Places 2 Use Discrete Values Figure A 7 Slider Control Properties Editor FA 7 1 The slider control has a minimum a maximum and an increment value The Tick Frequency not only determines the increment value but also the number of tick marks along the track FA 7 2 The General category includes the formatting properties that affect the slider s tick labels Select the check box Use Discrete Values if you want the slider to adjust the associated symbol by making discrete increments 50 A 2 2 CUSTOM SLIDER PROPERTIES EDITOR The custom slider is similar to the one from section A 2 1 except that it also allows you to include two images to the left and right side of the slider s track as sho
29. ile 13 Chapter 3 3 2 BROWSING THE ELF FILE uC Probe parses the ELF file and creates a catalog that you can browse to search for the symbol you need The symbol browser is a five column tree list of symbols grouped by the C file name where the variable was declared as shown in Figure 3 2 m 2 3 4 5 6 7 Name Display Name i Type Size Memory Address gt 4 X LiquidLevelController out sf N A N A 0 N A 4 app c N A 0 N A Appinflow Liquid Inflow unsigned char 1 0x20006110 AppLevelActual Actual Liquid Level unsigned short 2 Ox200060EE AppLevelDesired AppLevelDesired unsigned short 2 Ox200060EC AppLevelMax AppLevelMax unsigned short 2 Ox200060E8 AppLevelMin AppLevelMin unsigned short 2 Ox200060EA AppLevelUnits AppLevelUnits unsigned char 1 0x2000610F AppOutflow AppOutflow unsigned char 1 0x20006111 AppValvelnPct AppValvelnPct unsigned char J 0x20006112 AppValveOutPct AppValveOutPct unsigned char 1 0x20006113 Symbol Browser Output F3 2 1 F3 2 2 F3 2 3 F3 2 4 F3 2 5 14 Figure 3 2 uC Probe Symbol Browser Symbols grouped by C file The symbol browser allows you to quickly find the symbol you want Click on the symbol browser headers row to sort the list by the column you want You can also expand and collapse tree nodes to focus on a particular C file or you can use the search box The Name column shows the name of the symbol as declared in your C file The Display Name column by default displays the
30. ingle time to the embedded target When the user clicks and releases the button again nC Probe writes the Toggle Off Value one single time to the embedded target Here you specify the labels you want to display during the On and Off states You can specify the border colors you want to display during the On and Off states and whether or not you want to show the Toggle label on the corner OD Appendix A A 2 7 REPEAT BUTTON PROPERTIES EDITOR The repeat button control is a button that switches between the states On while held down and Off when released The properties window is shown in Figure A 14 e Y LL uC Probe Properties Editor Push to Increase Repeat Button 1 Font Family Segoe UI Y Font Size 12 Font Color Mmm Black X Settings Value 1 2 Interval ms 500 3 Label On Increasing 4 Label Off Push to Increase Appearance 5 Show Type F ON State Color LightGreen M OFF State Color mw LightCoral Figure A 14 Repeat Button Properties Editor FA 14 1 You can specify the labels to display during the On and Off states These properties affect the label s font family font size and font color properties FA 14 2 During run time when the user holds down the repeat button uC Probe writes the Value multiple times to the embedded target until the button is released FA 14 3 The value gets written to the embedded target multiple times at the specified interval in milliseconds
31. l s value in a graphical format along a multi color scale Figure A 3 shows the Range and Colors Editor for a linear gauge d Yd uC Probe Range amp Colors Editor Range Configuration Max 100 R ammo 90 9 G 255 Dp gt 0 70 KJ FFOOFFOO Min 0 cadem MS pl 1 2 Figure A 3 Range and Colors Editor FA 3 1 Start by setting the Min and Max limits then click on the text boxes next to the percentage signs and enter the thresholds in terms of percentage FA 3 2 Each time you click on one of the text boxes to set the percentages the color picker allows you to choose the color for that gauge band You can enter the color you want in hex format or by selecting a color from the vertical slider and then fine tuning with the palette dr Appendix A A 1 3 NUMERIC INDICATOR PROPERTIES EDITOR The Numeric Indicator category from the Properties Editor only applies to numeric indicators Figure A 4 shows the numeric indicator s properties Font styles alignment and the thousand separator they all apply to the number 0 shown in white s y p C Probe Properties Editor Numeric Indicator Font Family Arial Black v Font Size 80 Font Color White v Alignment Right M Thousand Separator Figure A 4 Numeric Indicator Properties Editor A 1 4 BITMAP ANIMATION PROPERTIES EDITOR The bitmap animations are part of the toolbox s miscellaneous family They are one of the most power
32. lor properties FA 12 2 During run time when the user holds down the push button uC Probe writes the Push On Value one single time to the embedded target FA 12 3 When the user releases the button uC Probe writes the Push Off Value one single time to the embedded target FA 12 4 Here you specify the labels you want to display during the On and Off states FA 12 5 You can also specify the border colors you want to display during the On and Off states and whether or not you want to show the Push label on the corner 94 A 2 6 TOGGLE BUTTON PROPERTIES EDITOR The toggle button control is a button that switches between the states On and Off when clicked The properties window for a relay s toggle button is shown in Figure A 13 FA 13C1 FA 13 2 FA 13 3 FA 13 4 FA 13 5 s pu C Probe Properties Editor De Energized Toggle Button 1 Font Family Segoe UI b Font Size 12 Font Color Wm Black ha Settings Toggle On Value 1 2 Toggle Off Value 0 3 Label On Energized 4 Label Off De Energized Appearance 5 Show Type F ON State Color EE LightGreen OFF State Color mw LightCoral Figure A 13 Toggle Button Properties Editor You can specify the labels to display during the On and Off states These properties affect the label s font family font size and font color properties During run time when the user clicks and releases the button uC Probe writes the Toggle On Value one s
33. n page 33 The last step during design time is to map each virtual control and indicator in your Data Screen with an Embedded Targets memory location The symbol browser allows you to quickly find the variable you want to display and then all you have to do is drag the variable from the symbol browser and drop it onto the virtual control or indicator of your choice See Chapter 8 Associating Symbols to Virtual Controls and Indicators on page 37 for more information on using the symbol browser to map virtual controls and indicators to the embedded targets memory locations 11 Chapter 2 The actual unC Probe windows application is shown in Figure 2 3 File Home Clipboard Toolbox H Linear 1 Linear 2 e 7 e D Le 5 Micrium uC Probe D E m Bring Forward ij Group FH show Hide Grid Ge 2 P Send Backward Align E Show Hide Rulers izte Xx Ae ola t Units Ag Zoom Factor S esesn Linear Gauges Full Settings Arrange T Layout RF Application T d be 033 X ie vi 4 4 U Project T3 DataScreeni i UEFDONODV I Half Donuts Cylinders Graphs Numerics Linear Gauges Horizontal Linear Gauges Quadrant Gauges Semicircle Gauges Circular Gauges Miscellaneous Writable Controls Symbol Browser s Search for symbol gt Name Display Name i y Type Size Memory Address 1 Symbol Browser Output F2
34. n that corresponds to your embedded target s endianness type F4 3 2 uC Probe supports J Link TCP IP and RS 232 Select the interface that your embedded target supports and configure the settings corresponding to the interface The following sections describe how to configure each communication interface Refer to the document pC Probe Target Manual for more information on the communication interface supported by the embedded target 19 Chapter 4 4 2 1 SEGGER J LINK J Link is a USB powered JTAG emulator designed by Segger In order to install the windows drivers for J Link J Link DLL go to Segger s website at www segger com and download the drivers from the appropriate download section J Link is the most popular emulator for ARM cores and it does not require any special code resident in the embedded target to connect with n C Probe If using J Link you can interface unC Probe even with a bare metal application running no kernel at all as shown in Figure 4 4 IDE and Toolchain of your choice Application Code l Compiler Assembler Figure 4 4 uC Probe via J Link uC Probe supports three J link interface modes Select the interface mode from the radio buttons and the path to the J Link driver as shown in Figure 4 5 20 Interfaces amp Segger J Link Settings de ES TCP IP Speed PU a ia kHz Rs 232 Interface Mode JTAG JTAG DCC 9 SWD DLL filepath C Pro
35. name of the symbol as declared in your C file but also allows you to create an alias for the symbol Double click over the Display Name cell to create an alias The Type column displays the symbol s C data type The Size column displays the size in bytes of the symbol Browsing the ELF file F3 2 6 The Memory Address column displays the symbol s location in the embedded target s memory F3 2 7 Click on the red X next to the name of the ELF file to remove a symbol file from the symbol browser 15 Chapter 3 Chapter UC Probe Settings The uC Probe application s tool bar is located at the top of the application window The uC Probe Settings window is opened by making click on the Settings button in the application s tool bar as indicated in Figure 4 1 Home ck Bring Forward Ex Group Show Hide Grid La MO Ly Send Backward Align E Show Hide Rulers LIM Full Settings E Paste x 2 Ae ola Kin Units A Zoom Factor An Clipboard Arrange lf Layout Application Figure 4 1 pC Probe Toolbar Settings The settings window is divided in the following categories E General Settings The general settings include the application debug logging automatic updates and data server settings E Communication Settings The communication settings includes the endianness type and the communication interface settings 17 Chapter 4 4 1 GENERAL SETTINGS Figure 4 2 sh
36. nt to align and then clicking on one of the following alignment options E Left or Right Edges B Top or Bottom Edges B Horizontal or Vertical Centers All the objects are aligned with respect to the first selected item Use the Units button to select the grid and rulers metric system Use the Show Hide Grid button to show and hide the grid lines on the data screen The snap to grid mode still works even if the grid is not visible Use the Show Hide Rulers button to show or hide the ruler The Show Hide Rulers button is a toggle button clicking the button turns the rulers on and off uC Probe Example F7 111 Every time you click the magnifier glass buttons to zoom in and out uC Probe zooms in and out by certain zooming factor Click the Zoom Factor button to select a different zooming factor F7 1 12 Click the Full Screen mode button to hide all the tools except the data screen The Full Screen button is a toggle button clicking the button turns the full screen mode on and off 7 1 pC PROBE EXAMPLE In order to demonstrate the previous layout design tools Figure 7 2 shows an example of a power plant s diagram used as a background to create a control panel with pC Probe RPM RPM POWER EN x1000 x1000 TEMP F TURBINE GENERATOR PRESSURE m ie CITE ot e Jl PSI AIR AND WATER VAPOR Ea em AA EL me PRODUCTION WELL INJECTION WELL Figure 7 2 uC Probe Example of a Powe
37. ore information configuring the properties of writable controls see Appendix A Virtual Controls on page 50 gt d uA i OFF ES ES 25 0 0 cx uu Figure 6 12 uC Probe Toolbox Writable Controls 31 Chapter 6 32 Chapter uC Probe Layout Design Tools The Layout Design Tools are located on the Main Toolbar at the top of the application s window They include tools to arrange the virtual controls and indicators on your data screen as shown in Figure 7 1 F7 1 1 F7 1 2 F7 103 2 6 7 9 10 X Lo Bring Forward Ly Group i Show Hide La Y Send Backward Align Y Show Hide Ruler Dare RE o MEC ju 12 X ALO vin Units a Zoom Factor Screen Clipboard rrange I Layout 3 4 9 8 11 Figure 7 1 uC Probe Layout Design Tools uC Probe allows you to copy cut and paste a single or multiple virtual controls or indicators Everything you select will be stored temporarily into nC Probe s clipboard during your session uC Probe allows you to drag and drop virtual controls and indicators onto the data screen and have them overlap one another In some cases may be necessary to move some of them to the front of the data screen Select the virtual control and indicator you want to move and click the Bring Forward or Send Backward button to move it to the front or to the back respectively uC Probe includes accessibility features that make the software more user
38. ows the uC Probe General Settings window pu C Probe Settings General Logging Y Enable jj Communication Debug Logging Type d Message Error T General Updatcs 2 v Automatically install updates at startup Verbose Warning Fatal Cancel Figure 4 2 uC Probe General Settings F4 2 1 uC Probe can be configured to log a specific level of verbosity for technical support purposes If you ever have to contact Micrium s technical support for any issues with your uC Probe application you can select a logging type that better describes your failure scenario F4 2 2 uC Probe can be configured to automatically check and install updates as they become available from the Micrium website uC Probe will check for software updates at startup if internet access is available 18 Communication Settings 4 2 COMMUNICATION SETTINGS Figure 4 3 shows the uC Probe communication settings window uC Probe Settings Communication Endianness o Little Endian amp Communication Big Endian Interfaces CS Segger J Link Ze TCP IP jj Rs 232 EL General 2 Settings Speed Interface Mode C JTAG JTAG DCC O SWD DLL filepath C Program Files x86 SEGGER JLinkKARM_V420h J oe Cancel Figure 4 3 uC Probe Communication Settings F4 3 1 uC Probe can be configured to interpret the byte order in either little endian or big endian select the radio butto
39. r Plant 35 Chapter 7 36 Chapter Associating Symbols to Virtual Controls and Indicators During design time use the pC Probe symbol browser discussed in Chapter 3 uC Probe Symbol Browser on page 13 to search and select the embedded target variables you want to associate to each of the virtual controls and indicators you placed on your data screen Once you find the symbol you want to associate drag and drop the symbol over the virtual control or indicator you want as shown in Figure 8 1 uC OS II KA Task Model Schematic Diagram Control Diagram x Workspace Explorer 1 so ho Aso 00 2 0 ae bso wu Za La WS 553 X ie ois Ta Liquid Level Controller 4 Ze User Interface Control Diagram 4 Ze Debugging Interface Task Model oss uC OS III KA Add the selected symbol to the node de level e Name Display Name i Type Size Memory Address 4 YX LiquidLevelController out 4 N A N A 0 N A 4 app c N A 0 N A AppLevelActual Actual Liquid Level unsigned short 2 0x200060EE AppLevelDesired AppLevelDesired unsigned short 2 0x200060EC AppLevelMax AppLevelMax unsigned short 2 0x200060E8 AppLevelMin AppLevelMin unsigned short 2 0x200060EA AppLevelUnits AppLevelUnits unsigned char 1 0x2000610F Figure 8 1 Associating Symbols to Virtual Controls and Indicators 37 Chapter 8 Repeat the same process for each of the virtual controls and indicators placed on your data screen and uC Probe will be r
40. rom your embedded target into one single chart In order to tell which trace represents a symbol in your chart a color coded legend with the name of the symbol is displayed over the chart Select the legend position that better suits your needs In case you need to convert the value points to Engineering Units EU before plotting in the chart you can use the scaling factor and offset to specify the parameters of a linear conversion function For example if the embedded target s symbol you need to display is a 4 20mA value you can implement the standard linear equation y 2 mx b where m is the scaling factor x is the 4 20mA value b is the offset and y is the resulting Engineering Units EU value to be plotted 59 Appendix A A 3 2 CHART SERIES EDITOR The charts series editor allows you to configure each trace in the plotting area The series editor is shared by all three types of charts as shown in Figure A 17 o YA 4 700 i arn 3 760 yo tc wavetorm uC Probe Graph Series Editor See i Series Configuration 1 880 EAN 940 _ App_ECG_Waveform eee oe NS D 1 00 110 0 2200 330 0 440 55 Settings Show Line C Show Area Z Show Points 2 Linear Series 3 Line Stroke Wm Red Line Stroke Thickness Is Highlighting Enabled Area Series 4 Area Fill Rm Red Marker Series 5 Point Stroke Mm SlateGray M Point Stroke Thickness 1 Point Fill EN SlateGray z Point Size 3 zZ Point Shape Ellipse v
41. s and example of running n C Probe and the debugger of your choice at the same time IDE and Toolchain of choice Application Compiler Code Assembler firmware Linker Embedded System JTAG In circuit Figure 9 4 Running pu C Probe and your debugging software at the same time Notice how uC Probe and the Debugger Software not only share the same ELF file but also the same logic and physical interface through the Segger s J Link DLL and JTAG in circuit debugger respectively It is very important to make sure that both uC Probe and IAR s C SPY are loading the same J Link DLL as indicated in Figure 9 4 43 Chapter 9 In order to make sure that the same DLL is being loaded by both applications whenever you set pu C Probe into Run Time mode through a J Link interface uC Probe will check for any active connection and will prompt you to select which of the active J Link connections you want to use as shown in Figure 9 5 By JLink Connection Found Sy gt uC Probe has detected an active JLink connection please select one from the following IDE Name Process Process ID J Link DLL Path m Name of your IDE Application Yourlde exe 7378 CAProgram Files YourlIDE Segger JLink dll 4 E Use path configured under settings window Figure 9 5 Active J Link connections selecting one of the active connections you are specifying the path to the same J Link DLL currently loaded by the IDE of your
42. s the ELF file and reads the addresses of each of the embedded target s symbols i e global variables and creates a catalog known as symbol browser which will be used by you during design time to select the 10 F2 2 2 F2 2 3 F2 2 4 F2 2 5 F2 2 6 uC Probe Data Client symbols you want to display on your dashboard Refer to the document uC Probe Target Manual for more information on installing the nC Probe Target C files and building the ELF file For more information see Chapter 3 uC Probe Symbol Browser on page 13 During design time it is necessary to adjust the communication and other general settings See Chapter 4 uC Probe Settings on page 17 for more information on configuring uC Probe The Workspace Explorer in the pn C Probe Data Client allows you to add or delete Projects and Data Screens For more information see Chapter 5 uC Probe Workspace Explorer on page 23 The uC Probe Toolbox displays icons for the virtual controls and indicators that you can add to your Data Screens Each toolbox icon can be dragged and dropped onto the Data Screen to build your own dashboard For more information see Chapter 6 uC Probe Toolbox on page 25 The uC Probe Layout Design Tools help you arrange the virtual controls and indicators on your data screen by speeding up the creation of your dashboard and making it look great For more information see Chapter 7 uC Probe Layout Design Tools o
43. target responds with an acknowledgement Refer to the document uC Probe Target Manual for more information on all you need in regards to the firmware that implements the communication interface that runs on the embedded target uC Probe parses the responses from the embedded target and updates the virtual controls and indicators Refer to the document uC Probe Target Manual for more information about the firmware that resides on the Embedded System This document only provides information about the Windows PC side of the system Chapter uC Probe System Overview This section provides an overview of the pC Probe Windows Application Whenever you start uC Probe in your Windows PC three different modules are started uC Probe Automatic Updates and Licensing System pC Probe Data Client and n C Probe Data Server as illustrated in Figure 2 1 Windows PC Licensing Server nalpeiron com MC Probe ELF File Symbol names and addresses ELF Header M Program Header E Table Software Updates Server micrium com Embedded System Running 4C Probe Target Figure 2 1 pC Probe System Overview Chapter 2 F2 1C1 F2 1 2 F2 103 F2 1 4 F2 165 The Automatic Updates and Licensing System AULS is the part of the application that allows you to install and keep your uC Probe application up to date The trial version of uC Probe is deployed with all the full version s fe
44. tistic Task Counter 20 382 Tick Task Counter 100 010 Timer Task Counter 1 000 Context Switches 222 956 Message Queue Pool Free Messages 99 Used Messages 1 Used Messages Max Feature Not Enabled uC OS III Task Execution Times Tick Task 1 144 155 Timer Task 108 1 5 Statistics Task 35 270 489 9 Interrupt Handler Task Feature Not Enabled Interrupts Nesting Counter 0 Maximum Interrupt Disable Time 1 186 16 5 Interrupt Queue Entries Feature Not Enabled Entries Max Feature Not Enabled Overflows Feature Not Enabled Scheduler Round Robin Enabled No Lock Nesting Counter 0 Maximum Lock Time 508 Ta Figure B 1 Kernel Awareness Screen Miscellaneous 64 Figure B 2 shows the information displayed for each task The columns can be sorted and the tri color bar graphs highlight those tasks reaching their maximum stack space which is a typical bug when developing embedded systems puC OS II KA DataScreenl vx 9 CPU Usage 0 98 4 Task s Performance Task Stack Pending Interrupt Scheduler Item Name Priority State On Pending Tis EM CtxSwCtr Dobis beck Used HFree Size Stack Usage Object On Remaining Usage Time Time Max Max 0 Liquid Level Controller Task 8 Pending Task Message Queue Task Q 0 0 06 96 4 334 6 1 0 0 51 99 150 MB 4 00 1 Flow Meters Task 8 Delayed 50 0 06 6 700 6 0 0 0 55 45 100 Deem o 2 Float Sensor Task 7 Delayed 10 0 24 23 652 4 8 0 0 34 66 100 WE 4 00 3 Buttons Task 6 Delayed 85 0 02 96 2
45. tors 45 Appendix A A 1 VIRTUAL INDICATORS A 1 1 FORMATTING PROPERTIES EDITOR The virtual indicators formatting category applies to linear gauges half donuts cylinders numeric indicators thermometers graphs and any virtual indicator capable of showing the symbol s value in a graphical or text format Figure A 2 shows the formatting category of a linear gauge pu C Probe Properties Editor Formatting Scaling Factor 1 1 Scaling Offset 0 Decimal Places 0 2 Leading Zeroes 0 Figure A 2 Formatting Properties Editor FA 2 1 In case you need to convert the value to Engineering Units EU before displaying in the virtual indicator you can use the scaling factor and offset to specify the parameters of a linear conversion function For example if the embedded targets symbol you need to display is a 4 20mA value you can implement the standard linear equation y 2 mx b where m is the scaling factor x is the 4 20mA value b is the offset and y is the resulting Engineering Units EU value to display FA 2 2 During run time mode whenever you move the mouse pointer over a virtual indicator such as a linear gauge a small yellow box will appear with the symbol s value formatted with the number of decimal places and leading zeros of your choice 46 A 1 2 RANGE AND COLORS EDITOR The Range and Colors Editor applies to linear gauges half donuts cylinders and any virtual indicator capable of displaying the symbo
46. unlimited period of time Please contact us for further information about pricing and ordering options at Micrium 1290 Weston Road Suite 306 Weston FL 33326 1 954 217 2036 1 954 217 2037 FAX E Mail sales micrium com Website www micrium com 67 Appendix C C 2 ACTIVATING After you order a pC Probe license you will receive an e mail containing your registration data and license code From your trial version of uC Probe click File gt Register and enter the license code in the activation dialog shown in Figure C 1 dp New Workspace Activate uC Probe EF Open pG Probe Activation A Save Licensing Options LA Save As License Code OH Close License Type Unlicensed zn Settings A Check Updates Figure C 1 Activating the full version of uC Probe 68 Appendix Bibliography Labrosse Jean 4 C OS II The Real Time Kernel R amp D Technical Books ISBN 1 57820 103 9 2002 Labrosse Jean 4 C OS III The Real Time Kernel Micrium Press ISBN 978 0 98223375 3 0 2009 L gar Christian uC ICP IP The Embedded Protocol Stack Micrium Press 2011 69 Appendix D TO A AC IM AO roiv 68 o A A 48 animation properties editor cccoccccccccccoccnccncononnos 48 49 area charts cU 57 C chart properties editor ccoocccccoccconcococccncnncnnonnnncnncononnonos 58 chart series editor EE 60 A EE 30 57 charts properties editor AA 58 charts series editor cooocccco
47. wn in Figure A 8 v Outflow Valve OI a Open Closed Figure A 8 Custom Slider Example Imagine you want to control the state of a valve to be either open or closed by moditying an embedded target s application variable named AppValveOutPct that stores the state of the outflow valve 096 0pen and 100 closed Figure A 9 shows the custom slider properties editor for such example d y O aide en 4C Probe Properties Editor Len gt Y Label Background Transparent Font Family Segoe UI Font Size 14 Font Color Mmm Black Alignment Center Range Min 0 Max 100 Images Show Images v Image on the left side Path map Animations Valve Open png 1 2 3 4 an eX C Image on the right side Path iap Animations Valve Closed png Q oe os Em X Figure A 9 Custom Slider Properties Editor 51 Appendix A FA 9 1 The label in this example is Outflow Valve The label properties include the background color font styles and alignment FA 9 2 The custom slider control has a minimum and maximum range FA 9 3 You can turn on and off the images FA 9 4 Specify the path or browse to the bitmap you want to be placed on the left and right sides of the track A 2 3 CUSTOM SWITCH PROPERTIES EDITOR The custom switch control is a two state button You can modify the value of an embedded targets symbol by specifying the values you want to write when the button is switched between the On and Off states
Download Pdf Manuals
Related Search