Getting started with STM-STUDIO
Contents
1. VarViewer3 VarViewer 1 lower Value VarViewer2 upper Value a DoclD18216 Rev 6 17 42 Running STM STUDIO UM1025 2 3 3 Adding variables to a variable viewer There are two solutions e Drag item from a table of variables and drop it directly either on the variable viewer display or in the list of variables located in the Viewers settings pane e Use the Send To contextual menu in the Display Variables settings table You can use multiple selections in each of the three variable tables to add several variables at a time in a variable viewer Figure 14 Adding variables to a variable viewer ilil STM Studio New config File Run Views Options Help 5 DE uA sTuksw sE P Show workspace VarViewer1 Display Variables Write Variables Display Variables settings Address 0x0 0 Send To gt VarViewerl Import VarViewer2 P Expression Update Color AcqVar Function VarViewer2 Function Type Description Color Viewers settings General PointViewer settings X Axis lower Value Point Viewer VarViewer 1 VarViewer2 upper Value Y Axis lower Value upper Value Display Settings Draw Line 7 18 42 DoclD18216 Rev 6 UM1025 2 3 4 Synchronizing viewers Viewers can be synchronized together by selecting All viewers Synchronized scrolling horizontally in a viewer also affects t2. lt 7 UM1025 Yy life augmented User manual Getting started with STM STUDIO Introduction STM STUDIO is a graphical user interface that allows sampling and visualizing in real time of user s variables while the application is running It is designed to run on PCs with Microsoft Windows operating systems This tool works with STM8 microcontrollers through SWIM single wire interface module and with STM32 microcontrollers through JTAG or SWD serial wire debug interface October 2013 DoclD18216 Rev 6 1 42 www st com Contents UM1025 Contents 1 Installing STM STUDIO EE NE EER EE ER es 5 1 1 JRE installation 0 0 eee nee 5 1 2 STM STUDIO installation nana aa aaa 5 1 3 Hardware support SES SES ES ee eee es ese 5 2 Running STM STUDIO occcoccc RE N EE ER EE EE RE ke 6 2 1 8 ARE bee noe ek eb EO ER eee ON es 6 2 2 Creating variables SESSE SES ee eee eee 6 2 2 1 Adding absolute variables ESE aaaea 7 2 2 2 Adding expression variables SESSE SE SE SS eee 11 2 2 3 Adding statistical variables EES ES SS SE SE ee 12 2 2 4 Adding plugin variables SESSE SE SE SES Se SE es 12 2 3 Inspecting variables SES ES ES SS ee ee ene 13 2 3 1 Adding a variable viewer 0 ccc eee ees 13 2 3 2 Customizing variable viewers 0 0 00 ES SE SE SE eee 14 2 3 3 Adding variables to a variable viewer o oooooooooooo 18 2 3 4 Synchronizing VieWers 1 eee 19
3. hreshold_s8 acgTrigger c W g_threshold_u16 acqTrigger c WE lg threshold_u32 threshold_u8 i l dataAcg c W mce Ja ffe 0x200000 0 junsigned 32 bit dataAcg c W mc g_lastReadPointer 0x200009b0 unsial File Run Views Options Help dataAcg c W Wmc la readFunclD Ox200000b4 unsi a 7 WEE 1 S DR ug stiinkswim E gt dataAcg c W mc la recordSize Ox 200009ac si yla dataAca c W me jo overfiow 0x2000097c signed 32 bit D g nbRecords O 20000978 signed 32 bit DoclD18216 Rev 6 9 42 Running STM STUDIO UM1025 Acquisition mode Absolute variables may be acquired in 2 modes e Direct acquisition mode which is not application intrusive but does not give an instantaneous view of the application state e Snapshot acquisition mode which gives an accurate view of the application state but which requires application instrumentation Refer to the Section 2 5 Configuring the acquisition settings for configuring this mode Click on the icon on the left column in order to toggle the acquisition mode of a variable Figure 5 Direct acquisition mode ppjouttonstatus D Counter ee Re 16 Dit Variable acquired in direct mode Figure 6 Snapshot acquisition mode ES SuttonStatus unsigned 8 bit 5 Counter or 10 unsigned 16 bit Variable acquired in snapshot mode instrumented application 7 10 42 DoclD18216 Rev 6 UM1025 2 2 2 a
4. shift ctri click for range addition 2 Select the variables 3 Click the Import button The address size and name parameters are provided by the executable debug information 7 DoclD18216 Rev 6 UM1025 a Running STM STUDIO Figure 4 Importing absolute variables File Run Views Options F ao ZW Open New Project Save Project As Save ss Import variables I Recent Confia F Import variables from executable File selection Executable file C sers Jule Documents STMicroelectronics STMStudio softTrace stm32 ar Debug Exe softwareTrace out E W Store executable path relatively to the user settings file Expand table elements this may take several seconds more Variables ada variables to the display variables table Name Address Type bAutoRearmAfter 0x200009a8 signed 32 bit la binternaltanere 0x20000988 signed 32 bit jg nternalrigMode 0320000980 signed 3251 g intermalTrigstate Ox2000097c signed 32 bit g internalType _ 0x20000884 signed 32bit added 2 l Linear expression A variable B acgTrigger N Hie 00930 signed 32 bit fe Import with A and E as constants i Import with A and B as expressions acgTrigger a g_overfli 19a4 signed 32 bit acgTrigger c W 1 lg_pTriggerConf 020000978 unsigned 32 bit acqTrigger c W g_stopAfterRecords 02000099 g_threshold_double acaTrigger c Wi igger c W g threshold_s16 threshold_s32
5. Direct acquisition mode o o o oo ooo eee nas 10 Figure 6 Snapshot acquisition mode SES ES SE SE SES ee eee ee 10 Figure 7 Contextual menu to add expression variable o ooooooooooooo ooo 11 Figure 8 Adding statistical variables o ooooooononono or 12 Figure 9 SNR plugin configuration SE 0 0 ce eens 13 Figure 10 Creating a variable viewer 1 0 0 0 SE SE SS SS SS eee eens 14 Figure 11 Customizing variable viewers 1 0 0 00 cc eee eee 15 Figure 12 Viewers seltingS 0 0 ccc eee eee eens 16 rigure 13 Multiple viewers 6 s lt istecisweetdasooneaS Gotu on ia Be RE dro 17 Figure 14 Adding variables to a variable viewer EE SE SE SE es Se eee ee 18 Figure 15 Synchronizing viewers ss Es ss SE ss tee eee ees 19 Figure 16 Hiding viewers 0 0 SE SE SS SE ee es es es ee Ee ee se se se 19 Figure 17 Point VIeWer is iese de DEER RE ER EO RE DE RR he ws Shab SS n EE a ED ees 20 Fi g re 18 Pointsetlings moan she as ESRA ES Sew ie ER eet ol GO HE DE Ae BE ee e 20 Figure 19 Adding apol ss ska EERS sesh ie EE RR SE aa DE KERE RAS DE EE a 21 Figure 20 Customizing point settings EES SE SE SE SS eee ees 22 Figure 21 Acquisition settings dialog DOX ESE ESE SS ES ES eens 23 Figure 22 Trigger parameters 26 Figure 23 Workspace panel SESSE sarani ee eee es a es es a 28 Figure 24 Configuration operations in File menu SS
6. Running STM STUDIO Adding expression variables Expression variables are displayed in the second leftmost pane in the Variables settings pane Use the New contextual menu to add a new variable For details on the allowed expression syntax please refer to Appendix A Syntax for expression variables on page 38 Clicking on the Expression column will open the expression editor window which will assist you writing the expression providing the list of known symbols and functions Expressions can use application variables or statistic variables They can also be constant depending on no application or statistic variable In the general case the result of an expression cannot be re used in another expression only constant expressions can be reused in other expressions Figure 7 Contextual menu to add expression variable Expression Type Color Delete New Send To C newExpr 0 unsigned 8 bit ly Expression editor newExpr_0 1 Acquisition variables and Statistical variables myVar ButtonStatus Usage Function arg1 arg2 Description Function description DoclD18216 Rev 6 11 42 Running STM STUDIO UM1025 2 2 3 Adding statistical variables Statistical variables are displayed in the second lowest pane of the Variables settings pane Use the New contextual menu to add a new variable Then select the absolute variable and
7. T T T T Y T T T Y 151 600 151 700 151 800 151 900 152 000 152 100 152 200 152 300 152 400 152 500 hees Scroll bar w Slider Delta ChO Slider Delta Ch1 Slider Delta Ch2 e To provide a better Time axis reading on variable viewers sliders can be added to popup the time value select the VarViewers settings General tab and set Show Indexes Figure 35 Figure 35 Showing indexes checkbox VarViewers settings Display Viewers as Show Indexes 2 36 42 DoclD18216 Rev 6 UM1025 Running STM STUDIO e For Point Viewer in Point mode click Show Annotations to display coordinates Figure 36 Figure 36 Showing annotations Bl 900 850 on af 750 700 650 600 50 sg 450 4001 300 200 150 g i S 100 150 200 30 7 DoclD18216 Rev 6 37 42 Syntax for expression variables UM1025 Appendix A Syntax for expression variables 38 42 The parser supports basic mathematical expressions using acquisition variables Constants may be expressed in decimal or hexadecimal with 0x prefix Variables are promoted to doubles before computing The result of the expression evaluation is also a double that may be used in any VarViewer Supported operators are A Addition Subtraction Multiplication Division Power Integer division Equals Not equals Bitwise AND Bitwise OR Logical NOT Less than Greater than Less than or equals Greater than or equal
8. and mathematical operators for example Variable1 Variable2 Variable3 Note that expression variables are evaluated after statistical variables thus it is not possible to compute statistics on expressions e Plugin variables that contain user configurable information DoclD18216 Rev 6 ky UM1025 Running STM STUDIO 2 2 1 Adding absolute variables Absolute variables are displayed in the upper pane of the Variables Settings pane They can either be added directly or be imported from an executable elf file Directly Variables can be added directly from the table using the New contextual menu right click on the mouse The new variable is added with default parameters It is the user s responsibility to define the name the address the size or optionally the color of the variable by editing each of the table fields Figure 3 Adding absolute variable directly from table File Run Views Options Help SOU stainkswi ES Display Variables write Variables Display Variables settings Address Delete New Display Variables settings send To Name Address Import Update Display Variables settings Color ky DoclD18216 Rev 6 7 42 Running STM STUDIO UM1025 8 42 Imported Variables can be imported from an application executable using File gt Import variables 1 Select the file that contains the variables a select whether to Store executable path relatively to
9. the function to be computed The scope defines the temporal window of the computing on all records acquired since the acquisition start or only on the last ones number to be specified Figure 8 Adding statistical variables D new 0 0x0 unsigned 8 bit Bjrent ld unsigned Bit fyjren 3 Jo hnsgned Sbit Expression Type Scope Delete Mew Send To D new_0 Min new 0 Std Dev Name AcgVar Function Scope D new 0 Min new 0 Average all i 2 2 4 Adding plugin variables Plugin variables are defined in an external java plugin An example is provided with source and java documentation for Signal Noise Ratio computation Refer to the plugins SnrPlugin javadoc subdirectory of STMStudio application for details of how to implement your own plugin 12 42 DoclD18216 Rev 6 yy UM1025 2 3 2 3 1 a Running STM STUDIO Use the New contextual menu to add a new variable Then select in the list of available plugins Snr is the first one available A configuration window for the corresponding variable will open see example in Figure 9 for the SNR plugin In the case of the SNR plugin select the variable on which the computation should be made and select the touch and untouch thresholds Please refer to the plugin javadoc or java source files for details on the SNR computation Figure 9 SNR plugin configuration tl SNR Configuration SNR VAR Choose Acquisition Variable for SNR computation To
10. the user settings file Choose this to adapt the STMStudio user settings file to the directory tree policy which is preferable when copying the project from one PC to another one storing the path relatively allows the copied project to open without having to browse for the new application location If the application remains at a fixed location an absolute path is preferable Note that if the STMStudio settings file and application file are not stored on the same disk the path is necessarily stored in absolute Select whether to Import scaled variables in expression It is possible to import variables directly as scaled expressions instead of importing variables then creating expressions In this case the A and B coefficients of the linear expression must be specified before importing Several variables can be imported with the same coefficients If one or both coefficients may change during the project lifetime it is recommended to first create constant expressions before importing scaled variables and use these constant expressions as A and B coefficients This allows future changes to the A and B values without modifying the scaled expressions Select the Show symbols containing and Match case to filter the symbols displayed in the edit box Click on the column header to sort the list by column if desired Use multiple selection mode if desired shift click for range selection ctri click for single item addition
11. this case the trigger is rearmed after the stop condition and the start condition will be evaluated again e Restart timestamp from 0 Available only for trigger defined in snapshot acquisition and when auto restart trigger is enabled If enabled the display is refreshed each time a new trigger event is hit and the trigger event record will be assigned with timestamp 0 If disabled the timestamp continues to increment between consecutive trigger events and several trigger events may be displayed during the same acquisition session e Ignore trigger when buffer not empty Available only for trigger defined in Snapshot acquisition and when auto restart trigger is enabled If enabled the trigger is not immediately rearmed after the stop condition but only when the trace buffer allocated DoclD18216 Rev 6 27 42 Running STM STUDIO UM1025 Note 2 6 28 42 in the application is completely empty acquired records have been displayed This allows to avoid having a buffer overflow too soon after the start condition If disabled the trigger is immediately rearmed which means that the trace recording may start again because start condition met again before the trace buffer of the previous acquisition is flushed As a result a buffer overflow Suspending the recording may occur quickly after the trigger event reducing the acquisition interest Pre triggering The pre triggering allows to keep few records before the start
12. x y function implements the Java modulus operator The IF b case1 case2 function provides branching capability If b is not O then it returns case1 else it returns case2 If DO then case1 will not be evaluated and vice versa DoclD18216 Rev 6 39 42 Revision history UM1025 Revision history Table 1 Document revision history O ome een ewe 12 Nov 2010 Initial release Updated All screenshots Section 1 1 JRE installation Section 2 1 Overview Section 2 2 Creating variables 18 May 2011 2 Section 2 2 4 Adding plugin variables Section 2 4 Using the Point Viewer Section 2 6 Project and configurations Section 2 7 Running a visualization session Added Section 2 5 Configuring the acquisition settings Updated Screenshots updated Introduction Section 2 2 Creating variables Section 2 2 4 Adding plugin variables Section 2 4 Using the Point Viewer 12 Mar 2012 3 Section 2 5 Configuring the acquisition settings Section 2 6 Project and configurations Section 2 7 Running a visualization session Added Appendix A Syntax for expression variables Document reformatted as per new die description template Updated Section 1 1 JRE installation Section 2 2 2 Adding expression variables Section 2 2 4 Adding plugin variables Section 2 5 Configuring the acquisition settings Section 2 7 3 Writing variables on the fly Figure 3 Adding absolute variable directly from table 11 Jun 2012 4 Figure 4 Importing absol
13. 2 3 5 Hiding viewers o 19 2 4 Using the Point Viewer SESSE SE aaa ees 20 2 4 1 Customizing Point Viewer 0 0 00 ccc eee se ee 20 2 4 2 Adding anew point EE ESE SE EE es 21 2 4 3 Customizing a BOME econo css sas ME RE ies bbe eet e wee ede 22 2 5 Configuring the acquisition settings o oooooooooo 23 2 5 1 Replay from file mode SS aaa 23 2 5 2 Get data from target mode ESE ES SE SE ee 24 2 9 3 Trigger configuration ES SS SS SE SE eee 26 2 6 Project and configurations SS SES SS SE SE eee 28 2 1 Running a visualization SESSION o o ooo conocen 31 2 1 1 Starting A SESSION 1 0 EE EE Es SE ee SE es es es es 31 2 1 2 Variable visualization o oooooooooooooo eee 32 2 1 3 Writing variables on the fly 0 0 0 ccc ee 34 2 1 4 Post visualization analysis 0 0 0 0 cee eee 36 2 42 DoclD18216 Rev 6 yy UM1025 Contents Appendix A Syntax for expression variableS 0 oooooooooo 38 REVISION hiStOFV ss wi rara eee ei A DR eee n 40 y DoclD18216 Rev 6 3 42 List of figures UM1025 List of figures Figure 1 J va PIGUONT sisters sa be EE oe oa eater DEI URE RR N EE DE REDE BE RR HD DE EE 5 Figure 2 STM STUDIO initial screen annann anaa ee eee nes 6 Figure 3 Adding absolute variable directly from table SS SS SES SS SS SE SS ee 7 Figure 4 Importing absolute variableS o o ooooooooror e 9 Figure 5
14. M STUDIO selecting Display all data will make the acquisition process wait for the previous records to be consumed by the graphical interface before going further Acquire all variables in this mode all variables that are described in the Variable Settings control panel are acquired even if they are not displayed anywhere This mode may be useful for optimizing the acquisition to file with few variables displayed during the acquisition time all variables may be displayed afterwards in replay from file mode Acquire only variables used by viewers acquisition is limited to variables that are displayed in viewers or used by expressions or statistical variables that are displayed in viewers In this mode the acquisition frames will be limited to the strict minimum required for display but of course the log file won t contain data for variables not displayed during the acquisition Acquire only variables used by visible viewers only variables that are displayed in the visible viewers are acquired from the target The list of acquired variables is determined by the viewers visibility state at the start of the acquisition session so changing the viewer visibility during the acquisition session has no effect on the list of acquired variables The change will only be taken into account on the next start If you want to change the visibility of viewers during the acquisition session select the mode Acquire only variables used by view
15. P_TRC_TIMESTAMP_BASE_UNIT and SNP_TRC_TIMESTAMP_VALUE definition in dataAcq c Some parameters can be adjusted for data acquisition from target Graphical refresh rate number of milliseconds between two graphical refreshes The actual refresh rate depends on computer configuration system and execution environment the specified value is used for a system timer Note that the graphical refresh process runs both concurrently and independently from the acquisition process the acquisition is in general much faster than the graphical refresh rate Acquisition rate defines the rate at which the host PC reads the target data When set to the maximum the acquisition process is a sequential loop limited by the CPU resources given to him by the Operating System For long acquisition sessions spying slowly changing variables it might be better to reduce the acquisition rate thus freeing host CPU resources for other tasks and also decreasing the log file size if activated Under sample data for graphical display in this mode the acquisition process continues even if the records put at graphical s disposal are still not consumed displayed As a result when the graphical display is slower than the acquisition some acquired records won t be displayed but will however be logged to the file if the function is enabled thus may be displayed later in replay from file mode Conversely DoclD18216 Rev 6 yy UM1025 Note y Running ST
16. SE SE SE SE SES eee 29 Figure 25 Selecting hardware and protocol EES ESE SE eee ee ee 31 Figure 26 Start MENU ce sones ERA RS HERE HEER MARA ge MAER OO eee EE H RSA AE d 31 Figure 27 Variable visualization 0 0 0 00 ccc tee eee ees 32 Figure 28 Visualizing different viewers SS ES ES SE SE SE SS ee eee ees 32 Figure 29 Showing all viewers 0 0 SEE SS ES ES ee ee es es es es ee 33 Figure 30 Adding awrite variable SESSE SE SE SS SS SS SS Se Se ee ES Se ee ee ee 34 Figure 31 Writing onthe TY seris is ES SE SE Es SE eee eee ees 35 Figure 32 Editing a value from the Read Value column SS SS SES SS SS SE SE ee 35 FOUE 33 SIOP MENU EE SEE FEE EE OR N ER OR N EE N EE 36 Figure 34 Replaying variable viewer visualization SS ESE SS SS SS ee eee 36 Figure 35 Showing indexes checkbox 0 EE SE ss eee ee ee ee 36 Figure 36 Showing annotations SS SES e ee eee 37 UM1025 1 1 1 1 2 1 3 a Installing STM STUDIO Installing STM STUDIO JRE installation Ensure that the Java Run Time Environment JRE is installed on your machine JRE version 1 7 or more recent is recommended JRE 7 To check the installed JRE version check that Java bin path is already added to PATH environment variable then open a Windows command dialog and enter java version If you have a JRE version older than 1 7 please download the latest JRE version from http www oracle com tech
17. THE PURCHASER SHALL USE PRODUCTS AT PURCHASER S SOLE RISK EVEN IF ST HAS BEEN INFORMED IN WRITING OF SUCH USAGE UNLESS A PRODUCT IS EXPRESSLY DESIGNATED BY ST AS BEING INTENDED FOR AUTOMOTIVE AUTOMOTIVE SAFETY OR MEDICAL INDUSTRY DOMAINS ACCORDING TO ST PRODUCT DESIGN SPECIFICATIONS PRODUCTS FORMALLY ESCC QML OR JAN QUALIFIED ARE DEEMED SUITABLE FOR USE IN AEROSPACE BY THE CORRESPONDING GOVERNMENTAL AGENCY Resale of ST products with provisions different from the statements and or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever any liability of ST ST and the ST logo are trademarks or registered trademarks of ST in various countries Information in this document supersedes and replaces all information previously supplied The ST logo is a registered trademark of STMicroelectronics All other names are the property of their respective owners 2013 STMicroelectronics All rights reserved STMicroelectronics group of companies Australia Belgium Brazil Canada China Czech Republic Finland France Germany Hong Kong India Israel Italy Japan Malaysia Malta Morocco Philippines Singapore Spain Sweden Switzerland United Kingdom United States of America www st com
18. able s level Depending on the selected mode some other parameters may need to be configured The acquisition settings are configured through the Option gt Acquisition Settings menu Figure 21 Acquisition settings dialog box Acquisition Settings Graphical Settings Graphical refresh rate in ms 1 65535 20 Acquisition rate fe ENT data for graphical display Display all data may delay the acquisition Acquire all variables Acquire only variables used by viewers Acquire only variables used by visible viewers Acquisition Parameters Triggers i Replay from fle Get data from target Log file C Users Julie Documents STMicroelectronics STMStudio log txt Log file settings Log raw data Log at graphical rate e Append expression and statistic values to log file Append mode Log only variations Target application shared data For snapshot variables Address of snapshot trace header oxo Record each 1 calls to DumpTrace e Log to file For direct variables Synchronize with target application 0x0 Target communication F Init comm on each start Automatically stop the acquisition after 10 consecutive communication errors Detect STM low power modes Automatically stop the acquisition after 40 consecutive detections in low power mode 2 5 1 Replay from file mode In this mode data is read from the specified file and no communication with the target is required The display is not real time the Gra
19. art condition The acquisition behavior depends on the start condition e Manual The acquisition immediately starts after starting the recording session e Rising edge the acquisition starts when a sequence of two consecutive records is found where Inthe first record the trigger value is strictly below a specified threshold In the second record the trigger value is equal or greater than the specified threshold e Falling edge the acquisition starts when a sequence of two consecutive records is found where Inthe first record the trigger value is strictly greater than a specified threshold In the second record the trigger value is equal or lower than the specified threshold Because the tool sampling rate may be much slower than the application s variable variation rate it is possible for the tool to miss a condition Stop condition e Manual The acquisition stops on user s request stop recording session e When buffer full Available only for trigger defined in Snapshot acquisition In this case the recording stops once the trace buffer allocated in the application is full no buffer overwrite e N records after start Specify the number of records to acquire after the trigger condition was hit N 1 will display only the record where the trigger condition was met e Auto restart trigger Available only when start and stop conditions are different from manual and pre triggering is disabled In
20. condition is met e N pretrig records Available only when the start condition is different from manual The specified value is a maximum which means that it is possible for the start condition to be met before all pretrig records have been acquired In that case the start condition is not ignored but less pretrig records are displayed In snapshot acquisition mode N must not exceed the size of the embedded trace buffer in number of records minus 2 In Direct acquisition mode it must not exceed 200 Pre triggering is not compatible with auto restart function Specifying a value different from 0 pretrig records will disable the auto restart function even if selected in the graphical interface Level The trigger threshold may be defined by either of the following actions e Using a symbol from the application executable file or linear expression based on application variable e Specifying the address location and access type of the trigger variable to be used Project and configurations STM STUDIO enables you to save and reload configurations so that you do not have to reconfigure the entire environment each time STM STUDIO is launched Configurations may be grouped into project allowing to organize them and easily switch thanks to the workspace panel At any time you can save a configuration or load or create a new one Figure 23 Workspace panel ED stmaz Y demolarSvar 3 demokeilSvar EH sti a de
21. ddress click on the Write Value field enter the value press Return see Figure 31 Note that a shorter way is to put the mouse pointer on the Write Value field to enter the value and to press Return Figure 31 Writing on the fly Display Variables Write Variables Write Variables settings Written Value signed 8 bit The last written value remains displayed even if the value changes on the application side there is no read back from the write table For read write variables For read write variables it may be more simple to use a VarViewer in the Table display mode In this mode the Read Value column may be edited and a write command is sent when pressing lt Enter gt or when the edited cell loses the focus Press lt Esc gt in order to cancel the edition without initiating a write command Figure 32 Editing a value from the Read Value column Variable Name Address Expression Read Value g_pTriggerConf 0x20000958 1001 3 overfon 02000057 AS a rbRecords 0x20000878 OO Writing from the VarViewer table works for application variables as well as for linear expressions based on a single application variables In that case the STM STUDIO reverses the linear expressions before writing to the application variable It is not possible to write to expressions that are not linearly dependent on a single application variable DoclD18216 Rev 6 35 42 Running STM STUDIO UM1025 2 1 4 Post visualization analysis T
22. ed configuration is used with the Point Viewer and four variable viewers Slide Wheel Keys and several variables slide wheel K1 k2 and others 2 7 1 Starting a session 1 First use the toolbar combo box to select the hardware and the protocol to be used for the data acquisition Figure 25 Selecting hardware and protocol File Run Views Options Help ST Link SWD STA ink SWIM RLink SWIM STIce SWIM ST TSLink 2 Then start the visualization using the Run gt Start menu Figure 26 Start menu STM Studia New config he File Views Options Help b Start ky DoclD18216 Rev 6 31 42 Running STM STUDIO 2 1 2 UM1025 Variable visualization Figure 27 shows an example screen with a demo running Figure 27 Variable visualization ly STM Studio STMT_8L EV1_FW_v1 2 0_cosmic File Run Views Options Help Display Variables Write Variables Display Variables settings D sMCKeyInfo 0 Chann 0x160 D sMCKeyInfo 0 Chann 0x164 D sMCKeyInfo 0 Chann 0x166 D sMCKeyInfo 1 Chann 0x177 D sMCKeyInfo 1 Chann 0x179 D sMCKeyInfo 1 Chann 0x17d D sMCKeyInfo 1 Chann 0x17f unsigned unsigned unsigned unsigned unsigned unsigned unsigned 784 784 813 816 702 703 680 681 694 696 642 645 lssCKeyInfo 2 Channel Last doub SSCKeylnfol6 Channel Refe doub isSCKeyInfo 6 Channel Last doub CKeyInfo 1 Channel Refe do
23. er2 upper Value Y Axis lower Value upper Value Display Settings EC Draw Line Use the General tab in the Viewers settings pane to modify Point Viewer parameters For both axes the user can specify the attempted range of values If the value of the Variable is outside the range of values currently defined for the axis the point does not appear in the Point Viewer area The user can also control the Draw Line when checked this option draws a curve using all point positions By default Draw Line not checked the points are displayed as screen points DoclD18216 Rev 6 yy UM1025 Running STM STUDIO 2 4 2 Adding a new point To create a new point select the Point Viewer tab in the Viewers settings pane display the contextual menu in the List of Points table and click New A new point is added to the list and to the Point Viewer legend Figure 19 Adding a point ee EE O EE T SDR UA sus P Point Viewer dir ES The new point has a default name and color no variable on X and Y as shown by the red crossed icon visible on Figure 19 It can then be customized 7 DoclD18216 Rev 6 21 42 Running STM STUDIO UM1025 2 4 3 Customizing a point The point name and color can be modified directly in the list by clicking on the Name field and on the Color chooser button Annotations and variables on X and Y axes can be modified in the Update Point s pane combo boxes Click on a point in the li
24. ering the acquisition in Snapshot mode or the display in Direct acquisition mode on one application event when getting data from target It is also possible to define an end of acquisition condition Figure 22 Trigger parameters Acquisition Parameters Triggers Stop Evaluate trigger an Manual f Host direct Acquisition Target snapshot Acquisition Start 7 Manual Auto restart trigger Falling edge o i By symbol gt By address Variable name When buffer fu Apply trigger to all variables snapshot and direct ie Jo records after start Level lo pretrig records maximum 26 42 DoclD18216 Rev 6 yy UM1025 Note y Running STM STUDIO Trigger acquisition mode By default the trigger event start and or stop applies to the mode where it is evaluated In the case of mixed mode displays the other mode is managed manually start stop on user actions Selecting the option Apply trigger to all variables overrides this default behavior and synchronizes both modes to the trigger evaluation no data is displayed before the start event and no data is displayed after the stop event Note however that because acquisition modes are not synchronous there might be a delay between the records acquired in different modes It might also be possible for instance that no record is displayed in direct mode because the trigger set in snapshot mode started and stopped in the same acquisition loop St
25. ers If you also want to add variables to viewers during the acquisition session choose the mode Acquire all variables Log file name of the file in which data is recorded when the Log to file option is selected or read from when the Replay from file option is selected Log to file save the data read from the target into the specified log file Note that the log file may contain more records than displayed during the acquisition session all records may be displayed afterwards using the Replay from file option Log raw data store raw data as it is read from the target whole frames without type computation Append mode when unchecked the log file is cleared each time the visualization is started Log at graphical rate in general the acquisition rate is higher than the graphical refresh rate Check this control to record at the rate used to refresh the display This may be useful when launching relatively long acquisition sessions in order to avoid getting too big a file at the end Log only variations only logs records that differ from the previous one Append expression and statistic values to log file when enabled if any expression or statistic variable is defined in the project a post processing phase takes place each time the acquisition session is stopped During this phase the log file is completed with values of expression and statistic variables If disabled the log file contains only the data read from the app
26. fo 1 Chann Ox17f unsigned i Ke Ba ra Hi Man MI I I WH S S Ss S Sa S Lar TE TAS IE ME NE ect Q Q yo pd yay eee A q q ND AT e AGAS AI ay ND pd Pd hd T SSCKE e IE sSCKeyInfo 6 Channel Refe double Variables sSCKeylnfols Channel Last double sSCKeyInfo 1 Channel Refe double s5CKeyInfo 1 Channel Last double 22 700 22 800 22 900 23 000 23 100 23 200 23 300 23 400 23 500 Time Wheel Delta ChO Wheel Delta Ch1 4 Wheel Delta Ch2 Slider 22 700 22 800 22 900 23 000 23 100 23 200 23 300 23 400 23 500 Time 4 Siider Delta ChO Slider Delta Ch1 4 Slider Delta Ch2 Some settings can also be changed during the visualization e Variables color e Variable viewers Value range Bar graph curve display Maximizing e Point Viewer Add points Switch between draw mode and point mode Resize axes During visualization you may not e For variables Create a new variable Change the address of a variable Change the type of a variable Change the name of a variable e Fora point Change variables on X and Y DoclD18216 Rev 6 33 42 a Running STM STUDIO UM1025 2 7 3 34 42 Writing variables on the fly During the visualization session you may write data on the fly STM STUDIO provides two ways of doing this depending if the variable to be written into is also read in acquisition or not Fo
27. he other viewers Figure 15 Synchronizing viewers General Display Var Viewer 2 as Varview Rename Visible Delete Viewer New Var Viewer All viewers Synchronized 2 3 5 Hiding viewers Running STM STUDIO By default all viewers are visible after creation It is possible to temporarily hide a viewer in order to optimize the displayed area without loosing its configuration use the contextual menu from the corresponding viewer tab Figure 16 Hiding viewers Display VarViewer 1 as VarWiewg Rename Visible Delete Viewer Mew Var Viewer All viewers Synchronized DoclD18216 Rev 6 a 19 42 Running STM STUDIO UM1025 2 4 2 4 1 Caution 20 42 Using the Point Viewer The Point Viewer is created by default in addition to the default variable viewer The Point Viewer is unique and displays points not variables A point is an association of two variables resulting in a screen coordinate a variable on the X axis and a variable on the Y axis By default the Point Viewer is not displayed To display it proceed as for the variable viewers check the Point Viewer item in the Views menu or the Visible contextual menu in the Viewers settings pane Figure 17 Point Viewer 750 200 Customizing Point Viewer Figure 18 Point settings Viewers settings Foin Wiewer settings Point Viewer X Axis mr lower Value VarViewer1 VarView
28. header required only if at least one variable is acquired in snapshot mode Specify the start address of g_traceHeader variable in the application address of g_traceHeader startMark 0 You can find the address fin the application map file or obtain it by parsing the application elf file menu File gt Import variables e Synchronize with target application synchronizes the acquisition from the host with the target application This acquisition mode requires an instrumented code in the target application examples for STM8 are in lt My Documents gt ST Microelectronics STMStudio synchrAcq The user must Add enterLock and exitLock functions in the application Specify the address of the stm studio ilagl 0 variable in the Acquisition settings window Compared with the snapshot acquisition mode the synchronized acquisition mode uses less RAM and Flash resources but is much more time intrusive on the application side possible waiting loops Note Snapshot mode is preferable for targets that have enough RAM and Flash resources e Record each N calls to DumpTrace allows to sub sample the acquisition in Snapshot mode N 1 by default means that a record is stored each time dumpTrace is called Other positive values allow to reduce the acquisition rate in order to avoid buffer overflows for instance without rebuilding the application 2 0 3 Trigger configuration The STM STUDIO provides the possibility of trigg
29. ion name to signify that the configuration has been modified and that the user will be asked later to save the changes From the Workspace panel it is possible to organize configurations into virtual folders fully independent from physical directories on disk Available actions from folders are e Add new folder add a new sub folder to the currently selected one e Add new configuration add a new empty configuration item to the currently selected folder This configuration will have to be selected before being modified and saved e Remove from project remove the selected folder all its sub folders and configurations Note that configuration files are not deleted from the disk only their DoclD18216 Rev 6 29 42 Running STM STUDIO UM1025 30 42 references are removed from the project file lt is not possible to remove the project root folder Import existing configuration add a configuration item in the currently selected folder making reference to an already existing configuration file tsc Import configurations from the recent list import in the currently selected folder all configurations listed in the recent list Note that this does not import projects tsp files Available actions from inactive grey LED configuration are Remove from project remove from the current folder the reference to this configuration The file tsc if existing is not deleted from the disk Select set this configuration as ac
30. ist and click Delete e clear the list of variables press the Delete All button e change the vertical axis range of values set lower Value and upper Value Each viewer is associated to a specific range of values If a variable is outside that range of values the variable is not displayed In this situation it is useful to modify the vertical range to make the variable appear Note At least one variable viewer must be defined Therefore the Delete Viewer menu is displayed only if there are at least two variable viewers 7 16 42 DoclD18216 Rev 6 UM1025 Running STM STUDIO The viewers can placed either on the right side of the STMStudio main window or in a second display If several viewers are displayed in one area e their size can be adjusted by a drag and drop action on the horizontal boundary e their position can be changed by a drag and drop action initiated out of the display area of the viewer where such action is associated with the zoom It s only possible to drag from an area with several viewers It is possible to drop to any area main window or second screen irrespective of the drag area Figure 13 Multiple viewers ill STM Studio New config File Run Views Options Help SOY ui stiinkswm P Show workspace Point Viewer Display Variables Write Variables Display Variables settings Address il Second screen STM Studio VarViewer2 100 150 200 250 VarViewer1
31. lication Init comm on each start initialize the communication each time the visualization is started If selected the target communication is also closed at the end of each acquisition session allowing another tool to connect without exiting STM STUDIO On STM8 this means that after each stop event the application restarts with SWIM disabled If the checkbox is disabled the SWIM remains active on the STM8 target after the end of the STM STUDIO session Detect STM8 low power modes select this mode in case of STM8 applications spending lot of time several hundreds of milliseconds in low power mode HALT WEE WFI without waking up This allows the acquisition process not to try to access DoclD18216 Rev 6 25 42 Running STM STUDIO UM1025 resources RAM data that are not available in this mode and avoid communication errors In case of applications often switching several times in 100 milliseconds in low power modes it is preferable to disable this option and increase the number of allowed consecutive communication errors As soon as one frame of a record fails the whole record is skipped with such kind of applications it is recommended to regroup all variables to be acduired in the minimal address range thus increasing the probability to get a full record when the core is awake Note that it will be all the more difficult to get records as the core is more rarely awake e Address in user application of snapshot trace
32. moStmn larSyvar T demoCosmicSyar demoRaisonanceSyar 7 DoclD18216 Rev 6 UM1025 y Running STM STUDIO A configuration includes e the hardware that was in use the last time the configuration was saved e he logging settings e he list of variables with their settings e he list of variable viewers with their settings and the list of variables they are in charge of displaying e he settings for the Point Viewer and the list of points the viewer declares with their settings All configuration operations are located in the File menu Figure 24 Configuration operations in File menu ly STM Studio New config Run Views mm Open L New Project WN Save Project As A SAVE 5 Recent Config Exrt e Open open a project tsp or configuration tsc file e New Project close the current project and open a default project with an empty configuration e Save Project As save the current project under a new name new tsp file e Save save the current project tsp file along with its active configuration tsc e Recent load a recently used project or configuration The STM STUDIO caption displays the active configuration When STM STUDIO is run the configuration is called New config by default After saving or loading the configuration the caption title is updated to display the new active configuration As soon as a setting is modified a is added to the active configurat
33. network java javase downloads index html STM STUDIO requires the 32 bit version of the JRE to be installed even on 64 bit versions of Windows Figure 1 Java Platform Java Platform Standard Edition JDK JRE Oracle strongly recommends that all Java SE 7 users upgrade to this release JavaFX 2 2 3 is now bundled with the JDK on Windows Mac and Linux x86 x64 ila ARE T oc Java SE 7u9 This releases address security concems Learn more What Java Do Need You must have a copy of the JRE Java Runtime Environment on your system to run Java applications and applets To develop Java applications and applets you need the JDK Java Development Kit which includes the JRE Installation Instructions Reade ReleaseNotes Oracle License Java SE Products Installation Instructions ReadMe ReleaseNotes Oracle License Java SE Products Third Party Third Party Licenses Licenses Certified System Configurations Certified System Configurations STM STUDIO installation Once the JRE is installed or updated run STMStudio_ setup exe Hardware support STM STUDIO supports ST LINK hardware with JTAG SWD and SWIM protocols STM STUDIO also supports RLink in circuit debugger and programmer from Raisonance which supports JTAG ICC and SWIM interfaces STice advanced emulation system and ST TSLink as additional hardware targets DoclD18216 Rev 6 5 42 Ru
34. nning STM STUDIO 2 2 1 2 2 6 42 Running STM Overview STUDIO UM1025 Run STMStudio exe through the Desktop icon or the Program Folder shortcut that are created during the installation setup The screen shown in Figure 2 appears e The configuration panes display current settings which change according to the type of display selected e The display area provides a visualization of the various settings currently selected iil STM Studio New config File Run Views Options Help Figure 2 STM STUDIO initial screen STiinkSWIM D Show workspace lt lt Display Variables Write Variables Display Variables settings Name Address Expression Type Name AcqVar Function Scope Color Description Color Viewers settings General Display Point Viewer VarViewer1 as VarViewer 1 Hexadecimal List of Variables INo Variable VarViewer Creating variables It is necessary to create a list of variables to be inspected during the recording session STM STUDIO manages e Absolute variables that are identified by their physical storage address four kinds of variables e Statistical variables that can compute values like min max average and standard deviation of absolute variables e Expression variables that are the result of a mathematical expression evaluation An expression is the combination of absolute or statistical variables
35. o stop the visualization click on the Run Stop menu Figure 33 Figure 33 Stop menu Ji STM studio New config e Horizontal scroll bars are added to enable the user to replay the whole visualization on both variable viewers Figure 34 and Point Viewer APE 34 Replaying variable viewer visualization show workspace _ Point Viewer Display Variables Write Variables Display Variables settings D sMCKeyInfo 0 Chann 0x160 unsigned D sMCKeyInfo 0 Chann 0x164 unsigned D sMCKeyInfo 0 Chann 0x166 unsigned D sMCKeyInfo 1 Chann 0x177 unsigned S D sMCKeyInfo 1 Chann 0x179 unsigned Y 74 i eas D sMCKeyInfo 1 Chann 0x17d unsigned f D sMCKeyInfo 1 Chann 0x17f unsigned A _ Expression Tin 680 j 703 i i es pa P SSCKeylinfof2 Channel Last double B yo Ro Ra Ra AK AD KAAR Ka Re Ke ReRe Ha Re Here Ko SSCKeylnfol6 Channel Refe double Variables SSCKeylnfol6 Channel Last double sSCKeyInfo 1 Channel Refe double s5CKeyInfo 1 Channel Last double i g 00 A uN is Lo ka Lo Go a al al al A wo AcqVar Function 50 E A A z 151 600 151 700 151 800 151 900 152 000 152 100 152 200 152 300 152 400 152 500 Time m Wheel Delta ChO Wheel Delta Ch1 Wheel Delta Ch2 Slider 250 200 150 100 50 o 9 50 T
36. oice selection and use of the ST products and services described herein and ST assumes no liability whatsoever relating to the choice selection or use of the ST products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein UNLESS OTHERWISE SET FORTH IN ST S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION OR INFRINGEMENT OF ANY PATENT COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT ST PRODUCTS ARE NOT DESIGNED OR AUTHORIZED FOR USE IN A SAFETY CRITICAL APPLICATIONS SUCH AS LIFE SUPPORTING ACTIVE IMPLANTED DEVICES OR SYSTEMS WITH PRODUCT FUNCTIONAL SAFETY REQUIREMENTS B AERONAUTIC APPLICATIONS C AUTOMOTIVE APPLICATIONS OR ENVIRONMENTS AND OR D AEROSPACE APPLICATIONS OR ENVIRONMENTS WHERE ST PRODUCTS ARE NOT DESIGNED FOR SUCH USE
37. phical refresh rate defines the time lapse between records read from the file independently from their timestamp saved during the acquisition Specify the minimum value for the fastest possible replay or a greater value for a slower replay For a correct behavior it is recommended to replay a file in the same configuration as the one used during the acquisition of the data into that file The mandatory conditions are e Log raw data parameter must not be changed between the acquisition and the replay e All absolute variables required by the graphical interface during the replay must be present in the log file e Append mode option must be disabled when saving acquired data into the file DoclD18216 Rev 6 23 42 a Running STM STUDIO UM1025 2 9 2 24 42 Get data from target mode Variable monitoring may be achieved in two different ways according to the variable configuration Direct acquisition mode The PC continuously reads data from the connected target The maximum record size is six frames of 255 bytes The acquisition is not intrusive for the application except that the SWIM JTAG or SWD pins must be reserved for the tool moreover on STM8 STM STUDIO activates the SWIM which impacts the STM8 behavior after a reset it remains stalled by the debug module However time elapses between the reading of the first variable of a record and the reading of the last one This can sometimes give a wrong image of the application
38. r write only variables For write only variables prefer using the Write Variables tab Proceed as follows First create a write variable in the Write Variables tab in the configuration pane Either one of three methods can be used e Drag an absolute variable from the Display variable tab to the Write Variables tab e Use the Write Variable tab contextual menus New or Import in the same way as for adding absolute variables Figure 30 e Select Import variables from executable then the Add variables to the write variables table mode It is also possible to define as a Write Variable a linear expression based on an absolute variable from the application In this case the STM STUDIO reverses the expression before affecting the absolute variable in the application The drag and drop from Display Variables tab to Write Variables tab is the only way to add an expression to the Write variable table Figure 30 Adding a write variable Display Variables Write Variables Write Variables settings Name Address Written Value Delete Display Variables Write Variables New Write Variables settings Import Address Type Written Value Update ua 0x0 unsigned 3 bit Show workspace lt lt Display Variables Write Variables Write Variables settings Name Address Type Written Value signed 8 bit 7 DoclD18216 Rev 6 UM1025 a Running STM STUDIO Then write a value at the variable a
39. s Right shift Left shift In addition to the basic operators the parser supports few mathematical functions SQR SIN COS TAN ATAN SINH COSH COTAN EXP Square function Sinus of an angle expressed in radians Cosinus of an angle expressed in radians Tangent of an angle expressed in radians Arc Tangent Sinus Hyperbolic Cosinus Hyperbolic Cotangent Exponent 7 DoclD18216 Rev 6 UM1025 LN LOG SQRT ABS SIGN TRUNC CEIL FLOOR RANDOM X RND INTPOW POW LOGN MIN MAX MOD Syntax for expression variables Natural log 10 based log Square root Absolute value SIGN X returns 1 if X lt 0 1 if X gt 0 0 if X 0 Discards the fractional part of a number e g TRUNC 3 2 is 3 TRUNC 3 2 is 3 CEIL 3 2 3 CEIL 3 2 4 FLOOR 3 2 4 FLOOR 3 2 3 Generates a random floating point number such that O lt Result lt X If X is negative then result is X lt Result lt 0 RND X generates a random INTEGER number such that 0 lt Result lt int X If X is negative then result is int X lt Result lt 0 The INTPOW function raises Base to an integral power INTPOW 2 3 8 Note that result of INTPOW 2 3 4 8 as well The Power function raises Base to any power For fractional exponents or exponents greater than Maxint Base must be greater than 0 The LogN function returns the log base N of X Example LOGN 10 100 2 MIN 2 3 is 2 MAX 2 3 is 3 MOD
40. st to display the settings for that point any modification is then registered for the point Note The Point Viewer can display only variables that are acquired in the same mode Select Show Annotations to display the annotations for the specific point Point customizing is mandatory for points newly created but can be done at any time for existing points either directly in the list for the name and the color or by selecting the point in the list and modifying the combo boxes or the check box Note When a point has no variable defined on X or on Y a red crossed icon is added to the list see Figure 20 This is the case after creating a new point but also after deleting a variable that was referenced by the point When you select an invalid point the icon also appears in the Update Point s pane near the combo box that should be filled You must then update the point otherwise it is not displayed during the next visualization session Figure 20 Customizing point settings Viewers settings Viewers settings List of Points List of Points Point Viewer Point Name Col Point Viewer Point Name Update Point s Update Point s Var on X se Var on X Var on Y Annotations Annotations 7 22 42 DoclD18216 Rev 6 UM1025 Running STM STUDIO 2 9 Configuring the acquisition settings STM STUDIO can run in two different modes e Replay from file e Get data from target Direct or Snapshot acquisition as defined at the vari
41. state For word variables it can even lead to unexpected values because MSB and LSB are not read exactly at the same time Snapshot acquisition mode The application must be instrumented so that variables are sampled on particular application events user defined C source code and project templates are provided in the softTrace subdirectory Simply add DataAca h and DataAca c files into your project and call the DumpTrace function where you expect to sample your application state You may then customize as needed The maximum number of variables in one record SNP TRGC NB MAX WORD VAR in dataAca h include a safety margin to avoid having to rebuild your application each time you want to trace one more variable STM STUDIO computes the actual record size when the acquisition session starts That number only affects the size of the trace header STM STUDIO displays an error message if you try to trace more variables than the application allows The size of the trace buffer SNP TRC BUFFER SIZE this size does not have to be a multiple of SNP TRGC NB MAX WORD VAR but it must be able to contain at least two records A wide buffer is preferred in order to avoid buffer overflow all the more if your application calls DumpTrace frequently For correct synchronization with records acquired in direct mode a timebase must be defined reflecting the exact time period between 2 consecutive calls to DumpTrace this is the aim of SN
42. tive Eduivalent to a double click Before acting STM STUDIO will ask for saving the previous active configuration if it has been modified Available actions from active green LED configuration are 1 As long as no file from the disk is associated with this configuration item Save As create a configuration tsc file on disk and save the configuration settings The first time the filename is used as the name for the configuration item The configuration item may be renamed without affecting the associated filename with the F2 key Remove from project remove the configuration item from the folder Import existing config associate an existing tsc file on disk to this configuration item This will affect the configuration item name that may be renamed afterwards with the F2 key 2 Once this configuration item has been saved on disk Save save all settings in the configuration file on disk will ask for overwrite confirmation Save As save all settings in another configuration file on disk create if not existing otherwise ask for overwrite confirmation Note that the previous configuration file on disk will remain in its last saved state You can use the mouse to move folders and configuration items drag and drop and to change the active configuration double click 7 DoclD18216 Rev 6 UM1025 Running STM STUDIO 2 Running a visualization session To illustrate a visualization session a predefin
43. uble sSCKeyInfo 1 Channel Last double Value Range lower Value upper Value wRorada ra iaa aa aro RG Roo 24 A Re he Ro a m Variables During the visualization you may Visualize another viewer from the Views menu see Figure 28 Show all viewers using the All visible menu from the viewer settings General tab see Figure 29 Change the display of a given viewer select the Keys tab and changing the Display Mode in the combo box Add an existing variable to a viewer for example by dragging the k3 variable from the table and dropping it over the wheel viewer in the display area Add new variable viewers and fill them with variables that are already in acquisition or based on variables already in acquisition which is restrictive when in acquisition mode Only used variables in acquisition Figure 28 Visualizing different viewers Options Help Point Viewer Wheel Slider 32 42 2 DoclD18216 Rev 6 UM1025 Running STM STUDIO Figure 29 Showing all viewers Il STM Studio STMT_8L EV1_FW_v1 2 0 cosmic File Run Views Options Help Point Viewer D sMCKeyInfo 0 Chann 0x160 unsigned D sMCKeyInfo 0 Chann 0x164 unsigned D sMCKeyInfo 0 Chann 0x166 unsigned D sMCKeyInfo 1 Chann 0x177 unsigned D sMCKeyInfo 1 Chann 0x179 unsigned j do D sMCKeyInfo 1 Chann 0x17d unsigned eos sos 82 669 ys 74 D sMCKeyIn
44. uch threshold value MyChannels Datal0 Delta MyChannels Datal 1 Delta MyChannels Datalz Delta Untouch threshold value 100 0 Inspecting variables Once variables are created they can be inserted in appropriate windows called variable viewers so that they can be visualized during a session When creating a new configuration one default variable viewer is created but the user can add as many variable viewers as necessary Adding a variable viewer In the Viewers settings pane select the General tab and click on the Add Viewer button or use the contextual menu within the Viewers settings pane and select the New Var Viewer item A new tab VarViewer2 is added to the Viewers settings pane and a VarViewer2 window is displayed in the display area DoclD18216 Rev 6 13 42 Running STM STUDIO UM1025 Figure 10 Creating a variable viewer i il STM Studio New config File Run Views Options Help S OQ GG sikswm EP Show workspace VarViewer1 T Display Variables Write Variables Display Variables settings Type igned 8 bit e i 8 bit i 8 bit VarViewer2 Display area Settings pane Each time a new viewer is created a new tab is added to the Viewers settings control pane 2 3 2 Customizing variable viewers The General tab in the Viewers settings pane contains settings that apply to all variable viewers 14 42 DoclD18216 Re
45. ute variables Figure 8 Adding statistical variables Figure 21 Acquisition settings dialog box Added Section 2 5 3 Trigger configuration Figure 5 Direct acquisition mode Figure 6 Snapshot acquisition mode Figure 22 Trigger parameters 40 42 DoclD18216 Rev 6 7 UM1025 Revision history Table 1 Document revision history continued oe es omes Updated Section 1 1 JRE installation Section 1 3 Hardware support Section 2 2 2 Adding expression variables 15 Jan 2013 5 Section 2 3 3 Adding variables to a variable viewer Section 2 3 4 Synchronizing viewers Section 2 5 2 Get data from target mode Section 2 7 3 Writing variables on the fly All the figures Updated Section 2 2 Creating variables Section 2 2 1 Adding absolute variables 26 Oct 2013 Section 2 2 4 Adding plugin variables Section 2 3 2 Customizing variable viewers Section 2 5 Configuring the acquisition settings Section 2 5 3 Trigger configuration DoclD18216 Rev 6 41 42 y UM1025 Please Read Carefully Information in this document is provided solely in connection with ST products STMicroelectronics NV and its subsidiaries ST reserve the right to make changes corrections modifications or improvements to this document and the products and services described herein at any time without notice All ST products are sold pursuant to ST s terms and conditions of sale Purchasers are solely responsible for the ch
46. v 6 ky UM1025 Running STM STUDIO Figure 11 Customizing variable viewers Viewers settings General PointViewer settings Point Viewer Axis a upper Value Y Axis lower Value upper Value Display Settings E Draw Line VarViewers settings Display Viewers as Curve y Show Indexes Table e The format of all viewers Curve Bar Graph or Table can be changed here in a single action This will override the local setting of each viewer that may be changed afterwards e Show Indexes show a slider for all variable viewers to display the time in ms e Add Viewer create a new variable viewer Each viewer supports custom settings that can be modified select the corresponding tab and change the settings q DoclD18216 Rev 6 15 42 Running STM STUDIO UM1025 Figure 12 Viewers settings General Display Point Viewer VarViewer2 as curve h VarViewer 1 War Viewer Rename w Visible Display in second frame Delete Viewer New Var Viewer All viewers Synchronized Delete Delete All Value Range lower Value fo 0 upper Value 255 o Hexadecimal E From the Viewers settings pane you can add a New Var Viewer Rename the viewer make the viewer Visible or Delete the selected viewer use the contextual menu e select the viewer display format Curve Bar Graph or Table e select the variable display format decimal or hexadecimal remove a variable from the viewer select the variable in the l
Download Pdf Manuals
Related Search