Home

FreeMASTER for Embedded Applications - User Guide

Contents

1. OH un a LI 12 12 14 15 16 deg Time sec control page algorithm block description oscilloscope Figure 4 10 Third Variable Added The Result Figure 4 11 shows the two Y blocks joined using the Join button Both Y blocks will be plotted overlapped causing multiple X axes to be drawn two in our case Scope Properties Main Setup Graph wars Assignment to r blocks BLOCK 0 v block Left Axis mir peoo y F auto max No f auto style Line 7 T block Right Axis Right axis vars D d mir Fo d f auto max 10 f auto style Line rv LILILILIL I Join Split varaz Ei Color Assign vars to block Left axis label Te UUO Right avis labet as Cancel Help Figure 4 11 Joining two Y blocks The resulting chart is displayed in Figure 4 12 Free MASTER for Embedded Applications Rev 2 0 14 Q CH CH JUSLUSJOU ZEJEA Freescale Semiconductor FreeMASTER USAGE ER a var16 var32 var32inc 2 25B 1000 2 008 30000 900 1756 25000 800 1 50B 700 lt CH 20000 ei CH qm iw TEASE 600 N gt 3 Sr 3 91 00B 815000 500 Wei fp D 0 758 400 10000 0 50B 209 5000 200 0 25B 100 0 00 0 175 18 0 18 5 19 0 19 5 20 0 aus Time sec control page algorithm block description oscilloscope Figure 4 12 Joining two Y blocks The Result 4 1 1 3 Recorder
2. One of predefined values Only one of the values defined in the Pre defined values fields can be supplied as an argument value e Pre defined values All numbers from min to max When this box is checked all numbers between Min and Max limits incremented by Step are considered to be valid for the argument value Other Check this box and specify the list of other values comma separated which are valid as argument value The Return codes page shown in Figure 4 27 is used for specifying the command return code messages To create a return code enter the return code value in hexadecimal 0x00 or decimal form in the code field at the lower left of the page enter the return code message in the next field and click the New button The return code item will appear in the list Repeat to create all desired return codes Message icon may be assigned to each return code message from the panel at the lower right of the page It will then appear in the message dialog together with the text of message FreeMASTER for Embedded Applications Rev 2 0 26 Freescale Semiconductor FreeMASTER USAGE Application Command E x Definition Arguments Return codes Named return codes T Show default message for unknown return codes Del Code 16 returned whateveritmeans Remove 032 Code FIFTY Uucd Code CO Make global bored Make local Message icon None Information Ce Exc
3. FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 57 L and SCRIPTING 6 5 FreeMASTER ActiveX Object Events 6 5 1 OnRecorderDone OnRecorderDone 6 5 1 1 Description This event is called when the active recorder finishes downloading of a new data 6 6 Examples FreeMASTER ActiveX control functions can be used within HTML script code JScript or VBScript The following example demonstrates the use in VBScript JScript users should also refer to Section 6 4 FreeMASTER ActiveX Properties lt script language VBScript gt Function GetSpeed succ pcm ReadVariable Speed vValue tValue bsRetMsg If succ Chen idSpeed InnerText tValue If vValue gt 100 then pem SendCommand SlowDown 1 End If Else idError InnerText bsRetMsg End If End Function lt soript gt lt object classid clsid 48A185F1 FFDB 11D3 80E3 00C04F176153 height 0 width 0 id pcm name pcm gt lt input TYPE button VALUE Get Speed onClick GetSpeed gt FreeMASTER for Embedded Applications Rev 2 0 58 Freescale Semiconductor References Appendix A References 1 The FreeMASTER Tool home page at htto www freescale com webapp sps site prod summary jsp code FREEMASTER 2 FreeMASTER Serial Communication Driver User Manual Installed with the FMASTERSCIDRV software from httos www freescale com webapp sps download license jsp colCode FMASTERSCIDRV 3 The DSP56800E Quick Start Initializati
4. Show Fast Access Pane switches the display of the Fast Access pane a small helper window located at the bottom left part of the application window It contains two pages the Commands Page which lists currently defined application commands and the Stimulators Page which lists all stimulator objects When the menu item Show all project commands is checked FreeMASTER is forced to show all application commands defined in the project The content of the commands page is then independent of which block is currently selected from the Project MENE Scope Item Project Help Pr Toolbar MALEN bar PI Status Line Adjust Leht Splitter Adjust Right Splitter Adjust Vertical Splitter Fe Show Fast Access Pane Fast Access Pane Commands Page Fa Show All Commands Stimulators Page Figure 4 32 View Menu Tree Otherwise only commands selected for displaying in the current tree context are displayed see Figure 4 5 and Section 4 1 1 1 Project Block and Sub block for more information 4 5 4 Explorer Menu The Explorer sub menu is available when an HTML page Control page Block Description page or Chart Variables Info is displayed in the Detail View When a Chart View page is displayed in the Detail View then the Explorer menu item is replaced by the Scope or Recorder Sub menu Items Back Forward and Refresh represent commands for the Internet Explorer window embedded in the FreeMASTER They are used to move through pre
5. T Always show numeric value Edit aaa default kukn Wan EI E number I Use Moving 4verages filter Reset histor om manual modify m History time 5000 Cancel Apply Help Figure 4 19 Variable Dialog Box Definition Tab On the Definition tab you specify a general variable properties Variable name Specify the variable name as the variable identifier in the project Sampling period The time period of reading the variable value from the board when the variable is displayed in the variable watch Shows as A format in which the variable value is printed in the watch window Select the proper format from the drop down list DEC HEX BIN ASCII or REAL Variable panel Information about the variable as it is defined in the embedded application Address The physical address of the variable in the target application memory Although you can type the direct hexadecimal value it is recommended that you select a symbol name of the application variable from the drop down list A symbol table can be loaded directly from the embedded application executable if it is in standard ELF Dwarf1 format or from the text based MAP file generated by the linker See Section 5 2 Symbol Files for more information about loading the symbol tables from selected files Type Select the variable type as it is defined in the target application unsigned fixed point signed fixed point float
6. scale Semiconductor FMSTERUG User s Guide Rev 2 0 9 2007 FreeMASTER for Embedded Applications User Guide sy EE TM 6 Freescale Semiconductor Inc 2007 Al rights reserved freescale semconaucior rtant Notice Important Notice Freescale provides the enclosed product s under the following conditions This evaluation kit is intended for use of ENGINEERING DEVELOPMENT OR EVALUATION PURPOSES ONLY It is provided as a sample IC pre soldered to a printed circuit board to make it easier to access inputs outputs and supply terminals This EVB may be used with any development system or other source of I O signals by simply connecting it to the host MCU or computer board via off the shelf cables This EVB is not a Reference Design and is not intended to represent a final design recommendation for any particular application Final device in an application will be heavily dependent on proper printed circuit board layout and heat sinking design as well as attention to supply filtering transient suppression and I O signal quality The goods provided may not be complete in terms of required design marketing and or manufacturing related protective considerations including product safety measures typically found in the end product incorporating the goods Due to the open construction of the product it is the user s responsibility to take any and all appropriate precautions with regard to electrostatic discharge In order to mini
7. Graph type Time graph Graph setup A variable Si axis min fo W auto MAX 100 W auto Figure 4 13 Recorder Properties Main Page The Main page contains the following user configuration items e Name The name of the Recorder item that will be displayed in the Project Tree e Description URL Specify the document s URL or local path to a file to be shown in the Detail View pane under the current item help tab This file may be created with any HTML editor such as MS Front Page Express or Netscape Composer and should explain the chart variables and settings to the user e Recorder global properties Common properties for all Recorder variables Board time base A sampling period preset by the board application In the SDK the time base value can be adjusted by setting PC_MASTER_RECORDER_TIME_BASE in the appconfig h file during the board application development Time base multiple Sets an integer multiple of the time base to extend the sampling period used for recorder operation Recorded samples The number of samples buffered for one recorded subset Onboard recorder memory Displays the amount of on board application memory allocated for recorder operation Based on the memory size recorded variables format and the number of recorded variables the maximum number of points which fit in the recorder s memory is calculated and displayed The Recorded samples value set
8. including Typicals must be validated for each customer application by customer s technical experts Freescale Semiconductor does not convey any license under its patent rights nor the rights of others Freescale Semiconductor products are not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support or sustain life or for any other application in which the failure of the Freescale Semiconductor product could create a situation where personal injury or death may occur Should Buyer purchase or use Freescale Semiconductor products for any such unintended or unauthorized application Buyer shall indemnify and hold Freescale Semiconductor and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges that Freescale Semiconductor was negligent regarding the design or manufacture of the part Freescale and the Freescale logo are trademarks of Freescale Semiconductor Inc All other product or service names are the property of their respective owners Freescale Semiconductor Inc 2006 All rights reserved z freescale semiconductor
9. E CO CR Fisteiik hdd There Figure 4 17 HTML Control Page Examples 4 1 2 2 Algorithm Block Description The Algorithm Block Description page in the Detail View pane is designated for placing an HTML page describing the selected block functionality The URL or local path to the source file is specified in block item properties dialog described in Section 4 1 1 1 Project Block and Sub block This page is displayed when it is defined and when the user selects the appropriate block item or any of its child scope or recorder items As the standard HTML page this page can also contain the scripts or other controls but it is not a common practice FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 19 MASTER USAGE 4 1 2 3 Current Item Help The Current item help tab is designated for placing an HTML page describing the selected Scope or Recorder This page should contain such information as definitions or use instructions and is specified as the Description URL 4 1 2 4 Oscilloscope Recorder The Oscilloscope page in the Detail View pane contains the real time chart representing tracked variables as already shown above in Section 4 1 1 2 Scope Similarly the Recorder page contains the chart created from the recorded data as described in Section 4 1 1 3 Recorder 4 1 3 Watch Grid The Watch Grid pane in the bottom of the application window contains the list of watch variables The selection of watc
10. The Recorder item in the Project Tree structure defines a real time recorder chart to be shown in the Detail View pane While the Scope periodically reads variable values and plots them in real time the Recorder is running on the target board reads application variables and sends them to the FreeMASTER tool in a burst mode fashion The recorder variables are continually sampled and stored into a circular buffer in the target board application When the trigger event is detected by the target data samples are counted until the number of Recorder samples is reached At this point data is sent to the FreeMASTER application This mechanism enables use of much shorter sampling period and enables sampling and plotting very quick actions FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 15 MASTER USAGE Recorder Properties De x Main Setup Trigger Name Demo Recorder Description URL Grid Jh Horizontal M Vertical Recorder global properties Board time base Not defined Time base multiple 1 ES V Recorded samples 40 plz Current on board recorder memory 15 Graph type Legend location fe Top Bottom C Left Right M Legend visible Ce Time graph se graph Graph setup Sais label Tine Aas Units seconds M Append units name to the label Cancel Help 256 bytes It means that up to 42 points can be recorded
11. been read without errors Boolean value False is returned if the specified address was invalid or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 48 Freescale Semiconductor HTML and SCRIPTING 6 3 8 WriteXxxArray To access array of 1 2 or 4 byte signed integers WritelntArray vAddr vSize vElemSize arrData bsRetMsg To access array of 1 2 or 4 byte unsigned integers WriteUIntArray vAddr vSize vElemSize arrData bsRetMsg To access array of 4 byte floating point numbers WriteFloatArray vAddr vSize arrData bsRetMsg To access array of 8 byte floating point numbers WriteDoubleArray vAddr vSize arrData bsRetMsg 6 3 8 1 Description These functions translate an array of numbers passed by the caller into a block of bytes suitable for the target CPU and write it into the target memory 6 3 8 2 Arguments The address of the memory block to be written This can be either an absolute numeric address a symbol name valid in the current FreeMASTER project or a Symbol name plus offset value The number of elements to be written to the target memory vElemSize The size of an array element in bytes The total number of bytes to be in written to the target can be calculated as vSize vElemSize w The array of the values to be written bsRetMsg When an error occurs this value contains an error message otherwise it out optinal is empty 6 3 8 3 Return
12. com Asia Pacific Freescale Semiconductor Hong Kong Ltd Technical Information Center 2 Dai King Street Tai Po Industrial Estate Tai Po N T Hong Kong 800 2666 8080 support asia freescale com For Literature Requests Only Freescale Semiconductor Literature Distribution Center P O Box 5405 Denver Colorado 80217 1 800 441 2447 or 303 675 2140 Fax 303 675 2150 LDCForFreescaleSemiconductor hibbertgroup com FMSTRUG Rev 2 0 9 2007 Information in this document is provided solely to enable system and software implementers to use Freescale Semiconductor products There are no express or implied copyright licenses granted hereunder to design or fabricate any integrated circuits or integrated circuits based on the information in this document Freescale Semiconductor reserves the right to make changes without further notice to any products herein Freescale Semiconductor makes no warranty representation or guarantee regarding the suitability of its products for any particular purpose nor does Freescale Semiconductor assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation consequential or incidental damages Typical parameters that may be provided in Freescale Semiconductor data sheets and or specifications can and do vary in different applications and actual performance may vary over time All operating parameters
13. error occurs this value contains an error message out optional otherwise it is empty 6 3 10 3 Return Value Boolean value rue is returned if the data has been retrieved successfully from the recorder item False is returned if there is no valid data in the recorder or if there is no recorder currently active FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 51 L and SCRIPTING 6 3 11 StartCurrentRecorder StartCurrentRecorder bsRetMsg 6 3 11 1 Description This function starts the recorder which is currently displayed in the FreeMASTER window 6 3 11 2 Argument bsRetMsg When an error occurs this value contains an error message otherwise out optional it is empty 6 3 11 3 Return value True is returned if the recorder has been started successfully False Boolean value is returned if there is no recorder currently active FreeMASTER for Embedded Applications Rev 2 0 52 Freescale Semiconductor HTML and SCRIPTING 6 3 12 StopCurrentRecorder StopCurrentRecorder bsRetMsg 6 3 12 1 Description This function manually stops the Recorder which is currently displayed in the Free MASTER window 6 3 12 2 Argument bsRetMsg When an error occurs this value contains an error message otherwise out optional it is empty 6 3 12 3 Return Value True is returned if the recorder has been successfully stopped False Boolean va
14. integer or floating point numbers For each call there are one or two optional functions which can be used in different scripting environments e ReadXxxArray returns data as a safearray of variants which can be used in both scripting languages like VBScript and in compiled languages like Visual Basic As VBScript engine does not handle variants encapsulating 2 and 4 byte unsigned integer types this method converts such a values to floating point format before returning e ReadXxxArray vis the same as ReadXxxArray except it does not perform the VBScript translation for 2 and 4 byte unsigned integer types e ReadXxxArray treturns data in the safearray of strictly typed values which can be used in compiled languages like Visual Basic Using typed arrays is significantly faster than using arrays of variants 6 3 7 2 Arguments The address of the memory block to be read This can be either an absolute numeric address a symbol name valid in the current FreeMASTER project or a symbol name plus offset value The number of elements to be read from the array vElemSize The size of an array element in bytes The total number of bytes read in from the target can be calculated as vSize vElemSize armata The return array of the values out optional bsRetMsg When an error occurs this value contains an error message otherwise it out optinal is empty 6 3 7 3 Return Value True is returned if the memory block has
15. pack which handle a communication with the FreeMASTER Remote Server application The difference between the two is a protocol used to connect to the server One uses Microsoft DCOM remote procedure call interface while the other uses standard HTTP text based protocol Free MASTER for Embedded Applications Rev 2 0 32 Freescale Semiconductor 5 2 PROJECT OPTIONS When using the DCOM based communication to remote server the security issues must be considered when connecting over the network Both sides of the communication must have the DCOM properly set up on the system level by running the DCOMCNFG utility Also the remote server must be properly installed on the remote side If there are problems connecting to the remote computer contact your local network administrator Communication state By selecting one of three options you can set whether the communication port will be opened or not when the application is started Open port at start up Do not open port at start up Store port status on exit apply it on start up Store status to project file apply it on its load If checked the state of the communication port will be saved to a project file during the next Save Project operation The state will be then restored the next time the project is loaded Symbol Files When defining project variables it is often useful to specify the physical address of the target memory location as the symbol name instead of direct he
16. platform before 2006 The drivers differed in a programming style other software drivers requirements and the way the drivers were configured In March 2006 Freescale released a SCI driver common for all supported platforms DSP56F800 MC56F800E HC08 HCS08 HC12 HCS12 HCS12X MPC500 MPC5500 and ColdFire V2 MCF52xx Although it still contains some platform specific functions the vast majority of the driver code the documentation and the way how the driver is configured is the same across all supported platforms Together with the PC side FreeMASTER version 1 3 released in 2006 the driver brought support for new features like target memory protection target side data addressing and others The new features are described in detail in the new SCI driver User Manual 1 2 1 Going Around SCI The original PC Master application already enabled implemention of custom communication plug in modules which could be used to replace the native SCI communication with a custom one The latest FreeMASTER version 1 3 contains two such plug in modules which proved to be very useful in application develooment and debugging The BDM Communication Plug in enables a basic memory access operations to be performed by the FreeMASTER on the HCS08 and HC12 HCS12 X targets without any target CPU intervention In other words no embedded side communication driver is needed and the FreeMASTER is still able to perform its basic tasks which are reading and writing the
17. prohibits such restriction In addition you must prohibit your sublicensees from doing the same If you violate any of the terms or restrictions of this Agreement Freescale may immediately terminate this Agreement and require that you stop using and delete all copies of the Software in your possession or control COPYRIGHT The Software is licensed to you not sold Freescale owns the Software and United States copyright laws and international treaty provisions protect the Software Therefore you must treat the Software like any other copyrighted material e g a book or musical recording You may not use or copy the Software for any other purpose than what is described in this Agreement Except as expressly provided herein Freescale does not grant to you any express or implied rights under any Freescale or third party patents copyrights trademarks or trade secrets Additionally you must reproduce and apply any copyright or other proprietary rights notices included on or embedded in the Software to any copies or derivative works made thereof in whole or in part if any SUPPORT Freescale is NOT obligated to provide any support upgrades or new releases of the Software If you wish you may contact Freescale and report problems and provide suggestions regarding the Software Freescale has no obligation whatsoever to respond in any way to such a problem report or suggestion Freescale may make changes to the Software at any time without any obli
18. target board Variable values are sampled into a memory buffer on the board then the sampled data is downloaded from board to FreeMASTER This mechanism allows a much shorter sampling period and enables sampling and plotting of very quick actions 2 3 Why is it such a great demonstration tool The embedded side algorithm can be demonstrated in one block or divided into several blocks depending on which possibility better reflects the algorithm structure Each block s input parameters may be explored to observe how they affect output parameters Each block has a description tab for explaining algorithm details using multimedia capable and scriptable HTML format 2 4 What could I do with it if I follow the instructions Using the demo project included with the embedded side implementation it is easy to learn how to use FreeMASTER by playing with the project s defined blocks and parameters The demo project allows you to understand how to control the application as well You can go into details of each item check its properties change parameters and determine how each can be used in your application For a detailed explanation of the parameters see Chapter 4 FreeMASTER USAGE 2 5 How is it connected to a target development board FreeMASTER requires a serial communication port on the target development hardware Connection is made using a standard RS 232 serial cable On one side the cable is plugged into the PC serial port COM1 COM2
19. 0 Freescale Semiconductor NP Figure Number Figure 4 1 Figure 4 2 Figure 4 3 Figure 4 4 Figure 4 5 Figure 4 6 Figure 4 7 Figure 4 8 Figure 4 9 Figure 4 10 Figure 4 11 Figure 4 12 Figure 4 13 Figure 4 14 Figure 4 15 Figure 4 16 Figure 4 17 Figure 4 18 Figure 4 19 Figure 4 20 Figure 4 21 Figure 4 22 Figure 4 23 Figure 4 24 Figure 4 25 Figure 4 26 Figure 4 27 Figure 4 28 Figure 4 29 Figure 4 30 Figure 4 31 Figure 4 32 Figure 4 33 Freescale Semiconductor List of Figures Page Number Initial Application Window sise 7 Application Window rarannnnrnnnnennnrnnnnnnnnnrnnnnennnnennnnennnennnnnnnnnennnnennnnennnsennsnnnsennnsen 8 Project Block Properties Main Page VV 9 Project Block Properties Watch Page EE 10 Project Block Properties App commands Page ccccseceeceseeeeeeeeeeeeeesaeeees 10 Scope properties Main Page rrrnnnnnnnnnnnrnnnnnnrnrnnnnrnnnnnnennnnnrnnnnnnsnnnnnnennnnnnennnnnnee 11 Scope Properties Set up Page LL 12 Basic Oscilloscope Chart rrrrnnnnnnnnnrannrrnnnnnrrrrnnnrnnnannrnnnnnnennnnnsrnnnnnnennnnsernnnnsssen 13 Tov EIN Se 13 Third Variable Added The Result 14 Joining TWO Y DIOCKS ee se 14 Joining two Y blocks The Result VU 15 Recorder Properties Main Page 16 Recorder Properties Setup Page RL 17 Recorder Properties Trigger Page rrnnrnnnrnnnnnnnnnnvnna
20. 30 FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor TOC 1 NP Of Contents 4 SA EXPO SP MSA a dan aa sa a ie ao 30 RSS SCO TEE 30 21506 EL 30 151 POMMES 31 AG TOODA EE ME 31 4 6 1 Toolbar iii 31 WV E TEE 31 Chapter 5 PROJECT OPTIONS tk NNN 32 OS er 33 5 2 1 Regular Expression based MAP File Harser 34 5 3 Packing Resource Files into Project File Rs 35 5 3 1 Resource Files Manager 37 SA AML E avenge Jamies 37 D Re 0 0 GC 38 Chapter 6 HTML and SCRIPTING 61 Special HTML e let le EE 40 6 2 FreeMASTER ActiveX Obert 41 6 3 FreeMASTER ActiveX Object Methods RL 42 631 FAN E 42 6392 SEND ne 43 SE E FANN its a ss E ees a eee eee ee 44 OSA VENN 45 CSS ENN 46 636 ANTONIO a aa a a et a te ed 47 6 3 7 Headavxvbhrtray reenn 48 H DEENEN 49 6 3 9 Gett urrentiecordertata ss 50 6 3 10 GetCurrentRecorderSeries seine 51 SE E EE SCOR ee T 52 6 3 12 StopCurrentRecorder sise 53 6 3 13 GetCurrentRecorderState diner sac sense eme 54 SE RES MN AN EE 55 6 3 15 StopStimulators iii 56 64 Free MASTER ActiveX d telen TE 57 6 5 FreeMASTER ActiveX Object Events rranrrnnnnnnnrnnnnnenrnnnrrnrnnnnennnnnennnnnnrnnnnnrennnnsnennnnnnee 58 ore dE 58 bt PETN 58 CAD a 58 Appendix References rrrrrnaneranenanrnnnrnnnnnnnnenanennnsnnnrnnannnanennnennnennnsnnnnennnennnennnennnnnnnsennsennn 59 FEE FONN NN erre 60 TOG 2 FreeMASTER for Embedded Applications Rev 2
21. 4 4 4 5 Important Notice Chapter 1 Introduction SEE JE EEE EE VE 1 Supported Platforms asrrrnnnnnrnnnnnnorrnnnnennnnnnennnnnsnnrnnnennrnnnrnnnassennnnnnennnnssnnnnnneennnnneennnsssen 1 et SONNE 1 Where to FING the Latest Version EE 1 EE EUREN a EE EE 1 ICS ee ik es cee ee es eee ee eee 2 Chapter 2 QUESTIONS and ANSWERS CO Re ee 4 SN EE EE 4 Why is it such a great demonstration tool 4 4 What could I do with it if I follow the instructions rrranrernnnnerranernnnnrrrnnnernnnrnrnnernnnnnennnn 4 How is it connected to a target development board rrrnnnrnrnnnnnnnnennnnnennnnnennnnrnnnnnennnnne 4 What are all of these dialog boxes for Rs 4 How does a project relate to my application 4 5 How do I set up remote control Why would I Want tO rerranerrrnnnevnnnnerrnnennnnnevnnnnennnnee 5 MASTEN Let e KE 5 VISTE RETT Lene 5 MAE STE a E 5 Chapter 3 INSTALLATION SPRETTEN 6 Enabling a FreeMASTER Connection on the Target Application rarrrrrnrrvrrnnrrrnnnennnnre 6 FOW TONS EEE EE EN 6 Chapter 4 FreeMASTER USAGE Application Window Description ss 7 al FO Tr 9 212 DEAN Eege 18 4 1 3 MWatch Gngd is siiiiiiiisreeseeeeeeeeeeseeenenns 20 VINN 20 4 2 1 Generating Variables 000nnn00nnnnannnnannnnennnnnnrnnrnnnrnnrnnnnrrrnnrrennnrrnnnrnsnrersnnernnni 23 COS a an un 23 MDO Orr OCC CS ea da dd a a a cn 27 Menu description eee sr 29 1 FN 29 22 FANT 29 25 WOW E cegeatenos E E E E
22. 6 3 2 1 Description This function invokes the FreeMASTER Send Application Command dialog 6 3 2 2 Arguments bsCmd String value with the command name and arguments which should be in displayed in the dialog The command must be defined in the currently open FreeMASTER project bsRetMsg Text returned after the command invocation When an error occurs this out optional value contains an error message 6 3 2 3 Return Value an wale True is returned if the command has been sent without errors False is returned if the command could not be found in FreeMASTER project FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 43 L and SCRIPTING 6 3 3 ReadVariable ReadVariable bsVar vValue tValue bsRetMsg 6 3 3 1 Description This function reads value from a FreeMASTER defined variable 6 3 3 2 Arguments bsVar String value with the name of the variable to be read The variable must in be defined in the FreeMASTER project which is currently opened tValue Returns string value which represents the variable format and units out optional necessary for displaying the variable value bsRetMsg When an error occurs this value contains an error message otherwise out optional it is empty 6 3 3 3 Return Value vValue Returns numeric representation of the variable bs Var out optional True is returned if the variable has been read without errors False is Boole
23. MASTER application The target development board is then connected to the computer running FreeMASTER Server Remote control operation is valuable for performing remote debugging or diagnostics An application may be diagnosed remotely by connecting the target development board to the remote PC and then running the FreeMASTER locally with a service project for this customer s application 2 9 What is the Watch grid The Watch grid is one of the panes in the FreeMASTER application window It shows selected application variables and their content in human readable format The application variables displayed are selected separately in the block property settings of each project block 2 10 What is the Recorder The Recorder is created in software on the target development board and stores changes of variables in real time You can define the list of variables which will be recorded by the embedded side timer periodic interrupt service routine After the requested number of variable samples are stored within the Recorder buffer on the target board it is downloaded from the board and displayed in FreeMASTER Recorder pane as a graph The main advantage of the Recorder is the ability to sample very fast actions 2 11 What is the Oscilloscope FreeMASTER Oscilloscope is similar to the classical hardware oscilloscope It shows graphically selected variables in real time The variable values are read from the board application in real time through the
24. MASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 25 MASTER USAGE e Dflt Enter the default value of the argument This value will be set in the argument list of the Send application command dialog If empty the user must type the value any time he sends the command e Modifiable Unless this box is checked the user is not allowed to change the default argument value in the argument list of Send application command dialog e Visible If this box is not checked the argument will not be displayed in the argument list and its default value will always be sent to the target application e Help Write any text information which will be shown in the Send application command dialog when the user will be prompted for an argument value Application Command E l x Definition Arguments Return codes new ang ntlb lt gt example argument Argument setup Enter validation Pre detined values f Any value within limits M All numbers from min to max One of pre detined values FT Other SS Sch F Cancel Apply Help Figure 4 26 Application Command Arguments Tab page 2 On the Enter validation sub page shown in Figure 4 26 you define the validation criteria for the argument value e Specify which values are allowed for the argument Any value Any numeric value is allowed as the argument value The value must be between Min and Max limits if these are set
25. MASTER tool FreeMASTER is fully backward compatible with PC Master 3 3 How to Install The FreeMASTER application is distributed either as a part of bigger development tool e g Freescale CodeWarrior or as a standalone single file self extracting executable file In the latter case run the executable file and follow the instructions on the screen This chapter contains a detailed description of the user interface for the Free MASTER application Free MASTER for Embedded Applications Rev 2 0 6 Freescale Semiconductor Chapter 4 FreeMASTER USAGE FreeMASTER USAGE 4 1 Application Window Description When the application is started the main window is displayed on the screen When there is no project loaded the welcome page is displayed in the main pane of the window The initial look of the main window is shown in lt st blue gt Figure 4 1 F Project FreeMASTER 10 x File Edit View Explorer Item Project Tools Help Dr z freescale semiconductor click to enlarge Welcome to GREEUZ I e What s New in Version 1 3 See description of the most important changes and improvernents implemented in this application version Version 1 3 also brings two communication plug ins for BDM and JTAG connection for HCSO8 HC12 and 56F8xxx targets e Visit FreeMASTER home page Visit the application home page at www freescale com Start Project e Continue with this Project Hide the welcome message and start by mo
26. MMERCIAL LOSS OR LOST PROFITS SAVINGS OR REVENUES TO THE FULL EXTENT SUCH MAY BE DISCLAIMED BY LAW COMPLIANCE WITH LAWS EXPORT RESTRICTIONS You must use the Software in accordance with all applicable U S laws regulations and statutes You agree that neither you nor your licensees if any intend to or will directly or indirectly export or transmit the Software to any country in violation of U S export restrictions GOVERNMENT USE Use of the Software and any corresponding documentation if any is provided with RESTRICTED RIGHTS Use duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph c 1 ii of The Rights in Technical Data and Computer Software clause at DFARS 252 227 7013 or subparagraphs cl and 2 of the Commercial Computer Software Restricted Rights at 48 CFR 52 227 19 as applicable Manufacturer is Freescale Semiconductor Inc 6501 William Cannon Drive West Austin TX 78735 HIGH RISK ACTIVITIES You acknowledge that the Software is not fault tolerant and is not designed manufactured or intended by Freescale for incorporation into products intended for use or resale in on line control equipment in hazardous dangerous to life or potentially life threatening environments requiring fail safe performance such as in the operation of nuclear facilities aircraft navigation or communication systems air traffic control direct life support machines or weapons systems in which the fail
27. Names parameter The return count does not include stimulators not found by name and stimulators which were already running FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 55 L and SCRIPTING 6 3 15 StopStimulators StopStimulators bsStimNames 6 3 15 1 Description This function halts one or more FreeMASTER variable stimulators 6 3 15 2 Arguments oh aa A semicolon delimited list of stimulators to be halted 6 3 15 3 Return Value Number of stimulators actually stopped This number may be equal or less than the number of semicolon delimited stimulator names passed Integer Value in bsStimNames parameter The return count does not include stimulators not found by name and stimulators which were not running FreeMASTER for Embedded Applications Rev 2 0 56 Freescale Semiconductor HTML and SCRIPTING 6 4 FreeMASTER ActiveX Properties Starting version 1 2 20 the Free MASTER also supports scripting languages which do not implement by reference passing of the function parameters e g JScript The output parameters in all ActiveX methods are now declared as optional and do not need to be specified by the caller at the time the Free MASTER method is called After the call is made all output values can be fetched using ActiveX properties as described in Table 6 1 For each property in the FreeMASTER ActiveX interface there is also a GetLast function available and
28. TER for Embedded Applications Rev 2 0 40 Freescale Semiconductor HTML and SCRIPTING 6 2 FreeMASTER ActiveX Object The Free MASTER object is registered in the system registry during each start of the Free MASTER application Its class ID CLSID is T0AIGSFI FRDB 11D3 S0B3S 00G TL 76153 The registry name is MCB PCM 1 version independent name is MCB PCM FreeMASTER functions can be called from any HTML code via the Free MASTER ActiveX control Insert the FreeMASTER ActiveX control into your HTML code by the Class ID number see the example below and set the dimensions height and width to zero to make the object invisible lt object name freemaster width 0 height 0 classid clsid 48A185F1 FFDB 11D3 80E3 00C04F176153 gt The FreeMASTER ActiveX control provides the following functions e SendCommand sends FreeMASTER defined command e SendCommanaDig opens command dialog and send a FreeMASTER defined command e ReadVariable reads value from a FreeMASTER defined variable e Write Variable writes value to a FreeMASTER defined variable e ReadMemory ReadMemoryHex reads a block of memory from a specified location e GetCurrentRecorderData retrieves data currently displayed in the recorder chart e GetCurrentRecorderSerie retrieves one data series from the currently displayed recorder chart e StartCurrentRecorder starts the currently displayed recorder e StooCurrentRecorder stops the currently displayed r
29. USAGE meg Edit View Explorer Item Project New Project Ctrl M EZ Open Project Cirl 0 Import Wizard je Save Project Cbril 5 Save As TOR Stop Communication ER Print Ctrl F Pritt Presley Print Setup 1 BLOC PreLaunch Demo pmp 2 BLOC PreLaunch Demos pmp 3 Dil vssykorkt crash pmp 4 BLOC Demo Drop Demo Mode Exit Figure 4 30 File Menu Copy Special is enabled when the Oscilloscope or Recorder graph is active The command enables saving the graph image to the clipboard or to a file in a different format or size The set up dialog is shown in Figure 4 31 Export graph image Ed Export destination Image size As onthe screen Specific Ce Clipboard E File Format eT E Height 100 Ce Bitmap M Wetatile JPEG Cancel Figure 4 31 Export graph image Dialog FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 29 MASTER USAGE 4 5 3 View Menu In the View menu you can select whether to show or hide the Toolbar the Watch Bar or the Status Line Another feature of the View menu is the ability to adjust the size of individual panes without using a mouse Use Adjust Left Splitter for changing the height of the Fast Access pane in the Tree pane Adjust Right Splitter can be used for changing the height of the Detail View pane HTML pages and charts Finally Adjust Vertical Splitter changes the width of the Project Tree pane
30. Value True is returned if the memory block has been Write without errors Boolean value False is returned if the specified address was invalid or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 49 L and SCRIPTING 6 3 9 GetCurrentRecorderData GetCurrentRecorderData arrData arrSerieNames timeBaseSec bsRetMsg GetCurrentRecorderData_t arrData arrSerieNames timeBaseSec bsRetMsg 6 3 9 1 Description These functions retrieve data currently displayed in the recorder chart They differ in how the data is returned to the caller e GetCurrentRecorderData returns data in the safearray of variants which can be used in both scripting languages like VBScript and in compiled languages like Visual Basic e GetCurrentRecorderData_t returns data in the safearray of type double floating point which can be used in compiled languages like Visual Basic Using typed arrays is faster than using arrays of variants 6 3 9 2 Arguments arrData Return two dimensional array of values the first dimension is out optinal series index the second dimension is value index arrSerieNames e Return array with names of series on appropriate indexes out optional bsRetMsg When an error occurs this value contains an error message out optional otherwise it is empty timeBaseSec Returned time between individual recorded samples in seconds out op
31. ages like VBScript and in compiled languages like Visual Basic e ReadMemory treturns data in the safearray of type unsigned 1 byte integer which can be used in compiled languages like Visual Basic Using typed arrays is faster than using arrays of variants e ReadMemoryHex returns data in the string value Each byte is represented in hexadecimal form by two characters 6 3 5 2 Arguments The address of the memory block to be read This can be either an absolute numeric address a symbol name valid in the current FreeMASTER project or a Symbol name plus offset value The size of memory block to be read ES The return array of the values out optional bsRetMsg When an error occurs this value contains an error message otherwise it out optinal is empty 6 3 5 3 Return Value True is returned if the memory block has been read without errors Boolean value False is returned if the specified address was invalid or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 46 Freescale Semiconductor HTML and SCRIPTING 6 3 6 WriteMemory WriteMemory vAddr vSize arrData bsRetMsgl 6 3 6 1 Description This function writes a block of bytes to the target application s memory 6 3 6 2 Arguments The address of the memory area to be written This can be either an absolute numeric address a symbol name valid in the current FreeMASTER project or a Symbol
32. al Communication Driver You can find more information about the FreeMASTER formerly PC Master in the User Manual or Communication Protocol Commands and Stimulators Panes Ures fe access to the target memory variables in the embedded application varse ELF application executable file and retrieve C variable addresses and type information isplay the variable values in real time graph oscilloscope 7170 record fast variable transitions to on board or on chip memory and display it in the e embedded application code for whatever control the this one can be used as a Graphical User Interface to Detail View Tabs Gains the same access to the embedded application as is FreeMASTER GUI for example reading the var16 variable var16 20613 itures also demonstrated in this example vi 00 cmd do Here 01 cmd 016 Name Vale Unt Period 02 cmd 026 var16 22943 0a cmd 100 __ var16inc 1 __ var32 1349345400 var32inc 100 var8 50 commands stimulators D S Variable Watch Grid purr UX378 rack 1 Scope Running 4 Done Figure 4 2 Application Window As shown in Figure 4 2 the application window consists of four panes Three panes are always displayed the Project Tree pane the Detail View pane and the Variable Watch pane The Commands Stimulators fast access pane may be shown or hidden as described later in Section 4 5 3 View Menu The Project Tree
33. alidated with the specified limits One of listed values only Once you have specified a list of values only those values will be accepted in the watch window to be written The acceptable values can be specified in the Pre defined values group All numbers from min to max All the numbers from min to max by step will be treated as predefined values Text enumeration Treat all values from the text enumeration look up table as predefined Other Specify any other predefined values comma or semicolon separated Edit style Select the look of the edit interface for a given variable which is displayed in the appropriate cell in the watch window grid Edit box with spin control The variable value edit interface will be displayed in the form of an edit box with two spin arrows for incrementing and decrementing the value Combo box with pre defined values The variable value edit interface will be displayed in the form of a drop down list box The predefined values will be available in the list Hide edit interface at inactive cells The variable edit interface will be hidden when the appropriate cell in the watch grid looses a keyboard focus FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor FreeMASTER USAGE e Write style Specify exactly when the new variable value is actually sent to the board application Write immediately after each value changes The modified variable value will be sen
34. alues and assign the text label to each of them which is then displayed in the variable watch together with or instead of the numeric value Use Edit Add and Del buttons to manage the look up table with value to text label assignment Default Specify the default text label which is displayed when no matching text is found in the look up table The Modifying page shown in Figure 4 20 contains settings and restrictions for variable value modifications 22 Definition Modifying Limit values Min optional Max optional Pre defined values Modifying mode C Dont allow any modifications One of listed pre defined values only Edit style Simple edit box Edit bos with spin control change by step Ce Combo box with pre defined values i Al numbers from min to mar by step Step Test enumeration see transformation setup Other A sep il l M Hide edit interface at inactive cells Write write immediately after value changes write after ENTER or cell loose focus MW Finish edit mode after ENTER Shadow write address Cancel Apply Help Figure 4 20 Variable Dialog Box Modifying Tab Modifying mode Don t allow any modifications The variable is read only all other settings on this page are disabled Any value within proper limits You can specify the Min and or Max value The value the user enters in the watch window is then v
35. an value returned if the specified variable was not found in FreeMASTER project or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 44 Freescale Semiconductor HTML and SCRIPTING 6 3 4 WriteVariable WriteVariable bsVar vValue bsRetMsg 6 3 4 1 Description This function writes a value to a FreeMASTER variable 6 3 4 2 Arguments bsVar string value with the name of the variable to be written The variable in must be defined in the currently open FreeMASTER project vValue in Value to write to the variable bsRetMsg When an error occurs this value contains an error message out optional otherwise it is empty 6 3 4 3 Return Value True is returned if the variable has been written without errors False is Boolean value returned if the specified variable was not found in FreeMASTER project if the value passed was invalid or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 45 L and SCRIPTING 6 3 5 ReadMemory ReadMemory vAddr vSize arrData bsRetMsg ReadMemory t vAddr vSize arrData bsRetMsg ReadMemoryHex vAddr vSize bsRet bsRetMsg 6 3 5 1 Description These functions read a block of memory from the target application They differ in how the data is returned to the caller e ReadMemory returns data in the safearray of variants which can be used in both scripting langu
36. application home page httos www freescale com webapp sps download license jsp colCode FMASTERSCIDRV 1 4 FreeMASTER Features e Graphical environment e Easy to understand navigation e Simple RS232 native connection and other options possible on selected platforms BDM JTAG e Real time access to embedded side C variables FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 1 duction e Visualization of real time data in the Scope window e Acquisition of fast data changes using the on target Recorder e Built in support for standard variable types integer floating point bit fields e Value interpretation using custom defined text messages e Several built in transformations for real type variables e Automatic C application variable extraction from compiler output files ELF DWARF 1 2 Text based map files e Demo mode with password protection support e HTML based description or navigation pages e ActiveX interface to enable VBScript or JScript control over embedded applications e Remote Communication Server enabling a connection to target board over a network including the Internet Features not available in the free distribution e Communication plug in modules available for other physical media and protocols CAN CCP Ethernet TCP IP e The Matlab interface to the Free MASTER ActiveX object 1 5 License FREESCALE SEMICONDUCTOR SOFTWARE LICENSE AGREEMENT This is a legal agreement bet
37. ation The drop down list contains all plug in modules known registered in the local system Connect string The plug in module configuration is saved in string form internally called a connect string You can directly specify this string or you can press the Build button to open the module specific configuration dialog Comm MAP Files Pack Dir HTML Pages Demo Mode Communication Plug in Module FreeMASTER S6F See DirectLPT JTAG Communication Plu Connect sting port 0x378 1ack 1 Configure Save settings to project file M Save settings to registry use it as default Communication state on startup and on project load Open port at startup e Donat open port at startup Store port state on exit apply it on startup Advanced M Store state to project file apply upon its load Cancel Apply Help Figure 5 1 Communication Options Save settings to project file If checked the communication parameters will be stored within the project file during the next Save Project operation When the project is next loaded the communication settings will be restored and used instead of the defaults Save settings to registry If checked the settings are stored in the local computer registry database These settings will be used as default when the application is started next time NOTE There are two communication plug in modules distributed within the FreeMASTER installation
38. block description oscilloscope Figure 4 8 Basic Oscilloscope Chart When more than one variable are displayed in a single Y block a separate Right axis may be shown For the selected Y block select the number of Right axis vars that will use the right axis within the Y block The value of Right axis vars specifies the number of variables counting from the bottom of the Chart vars list that are assigned to the right axis within the Y block As with Left axis specify min max style and axis label for the right axis in the selected Y block In Figure 4 9 we added one variable to the second Y block and set Right axis vars to one This means that the added variable var32inc will be assigned to the Right axis labeled var32 Increment Scope Properties E x Main Setup Graph vars t Assignment to Y blocks LILILILILILI style Line Join Spit Right axis wars 1 mir Fo a W auto var32 Color Assign vars to block BEN max 10 MW auto Left aus label scopeVar32 style me Right axis label var32 Increment Cancel Help Figure 4 9 Third Variable Added The var32inc variable value was changed manually from 100 to 1000 to achieve the waveform shown in Figure 4 10 FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 13 MASTER USAGE var32inc ar16 NO am Ke scope CH CH CH DER a E a E pen
39. ce of zero character For string values you can also select whether to display unprintable characters as HEX numbers or question marks and a few other string specific settings Real type transformation When the Show as format is set to REAL you can define further post processing numeric transformation which is applied to the variable value FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 21 MASTER USAGE Transformation type linear ax b Specify the a and b constants of the linear transformation y ax b The a and b parameters can be specified as a numeric values or by the name of the project variables whose immediate value last valid value is then used as the parameter linear two points If it is more convenient for you to specify the linear transformation by two points rather than by the parameters a and b fill in the two coordinate points x7 y1 and x2 y2 As the parameter values you can again specify the numeric values or variable names hyp d ax b c Specify the parameters a b cand d of a hyperbolic transformation function Unit The name of unit displayed in the variable watch Use Moving Averages filter When monitoring a noisy action you might want to display the average value instead of the immediate one History time The time interval from which the average value is computed Text enumeration This allows you to describe the meaning of certain variable v
40. ct the mode of oscilloscope operation e Time graph A variable values versus time will be displayed in the chart e X Y graph Inter variable dependencies value versus value will be displayed in the chart e Graph setup for Time graph FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 11 MASTER USAGE X axis label Specify the name displayed for the X axis X axis units Select the axis units X axis width Specify the range of the X axis Auto scale X axis until width is reached Scales the axis width after Scope start when the length of subset is shorter than the X axis width e Graph setup for X Y graph xX variable Selects the variable whose values will be used for X axis values X axis min Sets the X axis lower limit value checks the auto box to enable X axis auto scaling X axis max Sets the X axis upper limit value checks the auto box to enable X axis auto scaling The Setup page Figure 4 7 is used to assign variables to be displayed on the oscilloscope chart Up to eight Chart vars seven in X Y mode may be selected for display in the chart and assigned to a maximum of five Y blocks Select one of eight positions and browse for a variable in the drop down list below the list to set or change a variable at this position Select the first empty item in the drop down list to clear the selected position in the list Each chart variable is assigned to a Y bloc
41. difying this empty project In the Option Settings dialog here you can disable the welcome message for subsequent starts e Open an Existing Project Browse your disk folders and find the project file you want to open in the FreeMaster environment Period Not connected Figure 4 1 Initial Application Window The welcome page contains links to the documentation and to the application help There are also several other links corresponding to the standard menu commands for example the Open project command In the remaining part of this chapter an application usage is demonstrated on an example of a simple demo application which is a part of the SCI Driver installation FMASTERSCIDRV FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor MASTER USAGE F demo pmp FreeMASTER pe 10 x File Edit View Explorer Item Project Tools Help Detail View Area oc ROE rad lt a 21 l er zl sel Demo Project E Demo Scope 144 Demo Recorder freescale semiconductor Project Tree GREEW Ei Demo FreeMASTER is an application running on MS Windows operating systems and enables real time visualization demonstration and control of the embedded application Press the D button in the toolbar above to open or close the communication port Go to menu Project Options to change communication port settings This example application demonstrates the FreeMASTER Seri
42. e path or by a path relative to the directory where project is stored However the files will not automatically be stored in the project file and you will have to deploy them manually The third list contains references to nonexisting files e Pack directory setup Pressing this button opens the project Options dialog where you can redefine the pack directory location and other settings e Goto reference Opens the dialog in which the selected file is referenced This can be either a Properties dialog for a project tree item or a project Options dialog for shared HTML or symbol files 5 4 HTML Pages The project uses HTML pages to display the description and controls related to the selected item in the project tree The path or URL of the pages are specified in the property dialog for each tree item On the HTML Pages options tab shown in Figure 5 8 you can specify the paths to common HTML files displayed in the application main window FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 37 JECT OPTIONS Comm MAF Files Pack Dir HTML Pages Demo Mode Tree item Pages Frame Set page UAL Always load tems pages into following frame Control Page Control page URL welcome htm 8 M Display the Welcome Page each time the application is started Cancel Apply Help Figure 5 8 HTML Pages Options Specify the Frame Set page URL if you want to divide the pages display
43. e value of the variable being recorded that when crossed causes the trigger event Specify a threshold value and select whether the value is in raw format as in the board application or whether it must be translated back into raw format e g when a real type transformation is defined for the variable and you want to apply an inverse transformation on the trigger value before it is set as threshold in the embedded application Threshold crossing slope Selects the slope on which the threshold crossing is monitored FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 17 MASTER USAGE Pretrigger samples Specify the number of samples to save and display prior to the trigger event e Auto run Specifies conditions for reactivating the trigger for repeated recording Auto run mode Select to enable repeated recording After detecting the trigger event filling the buffer and downloading the buffer data to FreeMASTER the trigger is automatically reactivated and new data is downloaded immediately after the next trigger event occurs Hold triggered signal Check this box and specify how long to wait after one signal is displayed in the chart and before reactivating the trigger Automatic stopping Check this box and specify the maximum time period for detecting the trigger event If the event is not detected within the specified time the sampling is unconditionally stopped and actual buffer data is d
44. e zooming 4 5 6 Item Menu The content of this sub menu depends on the selected object within the Free MASTER application window The same menu is displayed when you click the right mouse button on this object The menu usually consists of the Delete item for deleting the selected object and the Properties item for opening an object properties dialog Free MASTER for Embedded Applications Rev 2 0 30 Freescale Semiconductor FreeMASTER USAGE 4 5 7 Project Menu Variables opens the Variables list dialog box where you can manage all project variables at once MCE Help Commands opens the Application commands dialog box where you can manage all project commands variables Commands The Reload Map File command updates the physical addresses of board application variables from the map file Reload Map File Options Options opens the multipage dialog box for all project option settings Figure 4 35 Project Menu 4 6 Toolbars 4 6 1 Toolbar The toolbar allows quick access to some of the menu commands sj on sel o 2 le gele lgl Properties Open Project P ege BEER Shift Down Save Project Forward Shift Up Stop Communication Stop Data Watch Grid Show Fast Access Pane Stop Scrolling Zoom All Copy Special Print Horizontal Zoom Only Zoom Out Export Picture Horz and Vert Zoom Figure 4 36 Toolbar 4 6 2 Watch Bar The Watch Baris available when the Watch Grid pane has the focus a
45. ecorder e GetCurrentRecorderState retrieves the current recorder status code and text One callback event is implemented OnRecorderDone called when the currently selected recorder finishes downloading new recorder data FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor A L and SCRIPTING 6 3 FreeMASTER ActiveX Object Methods 6 3 1 SendCommand SendCommand bsCmd bWait bsRetMsg 6 3 1 1 Description This function sends a Free MASTER defined application command to the target application 6 3 1 2 Arguments bsCmd String value with the command name and arguments to be sent The in command must be defined in the currently open FreeMASTER project bWait Boolean value which selects whether to wait for the result of the in command select True non zero to wait False zero not to wait String value returned after the command invocation When an error bsRetMsg occurs this value contains an error message otherwise it contains a out optional message defined in the FreeMASTER project as command return value 6 3 1 3 Return Value True is returned if the command has been sent without errors False is Boolean Value returned if the command could not be found in FreeMASTER project or if there was a communication error Free MASTER for Embedded Applications Rev 2 0 42 Freescale Semiconductor HTML and SCRIPTING 6 3 2 SendCommandDlg SendCommandDlg bsCmd bsRetMsg
46. ed for project tree items into the frames The page specified in this field must contain the lt FRAMSET gt declaration with one frame dedicated as a target for the description pages The name of the target frame must be specified exactly The HTML code can contain frames controls and scripts i e Visual Basic Script which can be used to access the attached target board through defined variables and commands A special HTML page dedicated to the control task can be defined and can be displayed in the separated tab in the detail view of the application main window 5 5 Demo Mode An important part of the FreeMASTER s capabilities is the demonstration and description of the target board application It is essential that the demonstration project once prepared is not accidentally modified To prevent modification the project s author can lock the project against changes by switching it into the Demo Mode See Figure 5 9 for details of the Demo Mode tab Comm MAP Files Pack Dir HTML Pages Demo Mode Project Demo Mode Protect the Demo Mode by password Password Venfy the password Cancel Apply Help Figure 5 9 Demo Mode Options When the Enter the Demo Mode box is checked the demo mode is activated automatically after the project is loaded The Demo Mode can be started manually by selecting Demo Mode from the File menu Exit from Demo Mode can be protected by a password FreeMASTER for Embedded Applicatio
47. edded Applications Rev 2 0 28 Freescale Semiconductor 4 5 Menu description 4 5 1 File Menu Selecting New Project creates a new empty project while Open Project opens an existing project file which has the extension pmp Import Wizard enables you to import selected objects Project Tree items variables commands stimulators from an existing project omp file into the current project Save Project saves the open project into the current file while Save As allows users to specify a new filename for the current project Stop Communication pauses the communication with the board and unlocks the communication port When the communication is released from the paused state the symbol file is automatically checked for changes If a difference is found the user can choose to reload the new version of the file Print prints the content of current window when possible Currently printing is supported only for HTML description and control pages Print Setup opens the standard Print Setup dialog The list of the most recently loaded projects Selecting one of these items loads the specified project just like using the Open Project command Demo Mode is a switch to enter or leave the application demonstration mode While in Demo Mode you cannot modify any important project settings Exit exits the application 4 5 2 Edit Menu Edit menu contains standard clipboard manipulation commands Cut Copy and Paste FreeMASTER
48. es The Watch page shown in Figure 4 4 selects which FreeMASTER project variables are to be watched in the context of this project block FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 9 MASTER USAGE Project Block Properties Eo x Main Watch App commands valable variables Watched variables Add gt gt x Remove Cancel Help Figure 4 4 Project Block Properties Watch Page The variables in the Watched variables list are the project variables which are currently selected for watching in the Watch grid The Available variables list contains the remaining available project variables not selected for watching with the current block item selected in the tree You can use the following buttons e Add Remove Moves variables into and out of the Watched variables window e New Creates a new variable see Section 4 2 Variables e Clone Creates a new variable based on a copy of the selected variable e Edit Changes the selected variable properties e Delete Deletes the selected variable from the project e Up Down arrows Sets the display order of the watched variables in the Watch grid FreeMASTER communicates with the board application by reading writing variables and or sending so called application commands see Section 4 3 Commands As the variable appearance in the Watch grid can be dependent on the block selected in the Project Tree pane the availabil
49. es Pack Dir HTML Pages Demo Mode Current location of resource files packed into the project file when saving D Profiles LO CALS TT emp pom8 trp By Speciy the directory with resource HTML files related to the project These files will be extracted into system temporary space when the project file is opened nest time Path to original directory for nest time the project is opened see conditions bellow source SH Ce Do not create and use the temporary directory if the original directory exists C Create temporary directory always even if the original directory exists MF Create temporary directory when stored files differ from the ones in original directory Ce It any stored file is missing in existing original directory If any stored file differs in length or date from the one in original directory I Delete temporary directory when the user closes the project Cancel Apply Help Figure 5 6 Pack Directory Options Example 2 Using the other Pack Directory options shown in Figure 5 6 you can set the conditions under which the temporary directory is created Free MASTER for Embedded Applications Rev 2 0 36 Freescale Semiconductor PROJECT OPTIONS 5 3 1 Resource Files Manager Before deploying a complex project which uses many external resources or symbol files it is worth verifying that all file paths are correct and in the proper relative format The path relative format must in turn be pr
50. f exists find by name Bind imported item to existing variable Always create new variable Figure 4 28 Import Project Tree Items Pressing the Next button opens the second part of the Import procedure where you can select additional objects to be imported The second dialog is shown in Figure 4 29 The three check box lists contain the objects found in the source project file e Variables Put a check mark by each variable you want to import You don t need to import variables which are referenced from the tree items selected in previous dialog from Figure 4 28 such variables are always unconditionally imported e App commands Put a check mark by each application command definitions you want to import As with variable objects you don t need to check commands which are referenced from the block tree items selected in previous dialog Global return messages If this box is checked the application commands return codes and messages are imported from the source document Overwrite existing The existing return codes are overwritten with those being imported e Stimulators Put a check mark by each variable stimulator you want to import Variables to import App commands Stimulators to import 00 cmd _ O0 1 01 cmd 01 1 02 cmd 02 1 Da cmd 100 Global return messages I Gverrite existing _Al None Al None met mm Figure 4 29 Import Project Objects Free MASTER for Emb
51. gation to notify or provide updated versions of the Software to you NO WARRANTY TO THE MAXIMUM EXTENT PERMITTED BY LAW FREESCALE EXPRESSLY DISCLAIMS ANY WARRANTY FOR THE SOFTWARE THE SOFTWARE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND EITHER EXPRESS OR IMPLIED INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE OR NON INFRINGEMENT YOU ASSUME THE ENTIRE RISK ARISING OUT OF THE USE OR PERFORMANCE OF THE SOFTWARE OR ANY SYSTEMS YOU DESIGN USING THE SOFTWARE IF ANY NOTHING IN THIS AGREEMENT MAY BE CONSTRUED AS A WARRANTY OR REPRESENTATION BY FREESCALE THAT THE SOFTWARE OR ANY DERIVATIVE WORK DEVELOPED WITH OR INCORPORATING THE SOFTWARE WILL BE FREE FROM INFRINGEMENT OF THE INTELLECTUAL PROPERTY RIGHTS OF THIRD PARTIES INDEMNITY You agree to fully defend and indemnify Freescale from any and all claims liabilities and costs including reasonable attorney s fees related to 1 your use including your sublicensee s use if permitted of the Software or 2 your violation of the terms and conditions of this Agreement FreeMASTER for Embedded Applications Rev 2 0 D Freescale Semiconductor Introduction LIMITATION OF LIABILITY IN NO EVENT WILL FREESCALE BE LIABLE WHETHER IN CONTRACT TORT OR OTHERWISE FOR ANY INCIDENTAL SPECIAL INDIRECT CONSEQUENTIAL OR PUNITIVE DAMAGES INCLUDING BUT NOT LIMITED TO DAMAGES FOR ANY LOSS OF USE LOSS OF TIME INCONVENIENGE CO
52. gging FreeMASTER allows users to debug applications in true real time through its ability to watch variables Moreover it allows debugging at the algorithm level which helps to shorten the development phase e Diagnostic tool FreeMASTER remote control capability allows it to be used as a diagnostic tool for debugging customer applications remotely across a network e Demonstrations FreeMASTER is an outstanding tool for demonstrating algorithm or application execution and variable outputs e Education FreeMASTER may be used for educational purposes Its application control features allow students to play with the application in demonstration mode learning how to control program execution 2 2 What does it do FreeMASTER communicates with the target system application via serial communication to read and write application internal variables FreeMASTER provides the following visualization features for displaying variable information in a friendly format e Oscilloscope provides monitoring visualization of application variables in the same manner as a classical oscilloscope with a CRT In this case monitoring rates are limited by the serial communication speed e Recorder provides monitoring visualization of application variables that are changing at a rate faster than the sampling rate of the oscilloscope While the Scope periodically reads FreeMASTER variable values and plots them in real time the Recorder is running on the
53. ghts nor the rights of others Freescale products are not designed intended or authorized for use as components in systems intended for surgical implant into the body or other applications intended to support or sustain life or for any other application in which the failure of the Freescale product could create a situation where personal injury or death may occur Should a Buyer purchase or use Freescale products for any such unintended or unauthorized application The Buyer shall indemnify and hold Freescale and its officers employees subsidiaries affiliates and distributors harmless against all claims costs damages and expenses and reasonable attorney fees arising out of directly or indirectly any claim of personal injury or death associated with such unintended or unauthorized use even if such claim alleges that Freescale was negligent regarding the design or manufacture of the part Freescale and the Freescale Logo are registered trademarks of Freescale Inc Freescale Inc is an Equal Opportunity Affirmative Action Employer Freescale and the Freescale Logo are registered in the US Patent and Trademark Office All other product or service names are the property of their respective owners FreeMASTER for Imbedded Applications Rev 2 0 D Freescale Semiconductor NP Table of Contents Paragraph Page Number Number 1 3 1 4 1 5 2 1 2 2 2 3 2 4 2 5 2 6 2 1 2 8 2 9 2 10 2 11 3 1 3 2 3 3 4 1 4 2 4 3
54. h variables and their graphical properties are defined separately for each project block As a result the Watch Grid pane changes its contents each time a different project block is selected During the definition of the variable the variable name units and number format are specified Moreover the Watch bar can be used to change the graphical look of the variable including font type and size foreground and background color and alignment Refer to Section 4 6 2 Watch Bar for details Read only variables can only be monitored Variables with changes allowed modifying enabled in the variable definition can be altered from the Watch Grid pane Details about variables can be found below in Section 4 2 Variables 4 2 Variables FreeMASTER communicates with the board application via a well defined communication protocol This protocol supports sending commands from the PC application to the target board application and reading or writing its variables All commands and variables used in the FreeMASTER project must be specified within the project The Variables list dialog box shown in Figure 4 18 can be opened by selecting the Variables item from the Project menu It can also be opened from other project development points where it could be used to manage variables e g Scope Setup variables list E SI Available variables Edit Delete Generate Figure 4 18 Variables list Dialog Box To define a new
55. he browse button to locate the file in the standard open file dialog File format Select the format of the file Standard binary ELF Choose this option for an ELF file Hiware MAP File 509 Choose this option for HiWare Smart Linker v5 0 9 Define new Regular Expression based parser Choose this to define a new text file parser based on regular expression pattern matching see Section 5 2 1 Regular Expression based MAP File Parser List of valid symbol files The list of symbol files defined in the project Use New and Del buttons to manage the list View View the symbol table parsed from the selected file FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 33 JECT OPTIONS NOTE The paths to symbol files may be specified in several forms It can be the absolute path on the local disk the path relative to the directory where the project file is stored or the path relative to the current pack directory The latter is the most suitable for project deployment to other computers see Section 5 3 Packing Resource Files into Project File for more information e OnLoad panel options control the actions performed with symbol files after the project is loaded Let the user select the symbol file When checked the user is prompted to select the initial symbol file when the project is loaded Synchronize variables each time the map file loads When checked the variables are aut
56. implements the same functionality as when reading the property value itself Such functions can be used in scripting environment where accessing ActiveX object properties is not possible or convenient Table 6 1 FreeMASTER ActiveX Object Properties LastResult The return value of the last ActiveX function called LastRetMs The error message returned by the last ActiveX function H called the value of bsRetMsg output parameter The value of the vValue output parameter returned by the ee vale last ReadVariable method called The value of the tValue output parameter returned by the EES last ReadVariable method called Pee En The value of the bsRet output parameter returned by the y last ReadMemoryHex method called The array of values returned in arrData output parameter LastMemory data by the last call to one of the ReadMemory or ReadXxxArray methods The array of values returned in arrData output parameter LastRecorder data by the last call to GetCurrentRecorderData or GetCurrentRecorderSeries methods The array of values returned in arrSerieNames output LastRecorder serieNames parameter by the last call to GetCurrentRecorderData method The value of the timeBaseSec output parameter returned LastRecorder timeBaseSec by the last call to GetCurrentRecorderData method The value of the nState output parameter returned by the LastRecorder state last call to GetCurrentRecorderState method
57. ing point IEEE fractional lt 1 1 unsigned fractional lt 0 2 or string Size Specify the size of the variable as it is defined in target application Bit fields The parameters for extracting the single bit or bit groups from a given variable Shift Specify the number of bits the received value is right shifted before it is masked Mask Select or specify the mask value which is AND ed with the shifted value Using the Shift and Mask fields you can extract any bit field from the received variable For example to extract the most significant bit from the 16 bit integer value you would specify 15 bit shifting and one bit mask 0x1 Show According to the value display format selected in the Show as field this set of parameters controls how the variable value is actually printed val min max Check the boxes if you want the variable watch to display the immediate variable value and or the detected peak values The peak values can be reset by right clicking the variable entry in the watch window and selecting the menu command Reset MIN MAX Fixed digits for Show as set to DEC HEX or BIN Prints numeric values left padded by zeroes or spaces to a given number of digits Fixed digits for Show as set to REAL Prints floating point numeric values with a constant number of digits after the decimal point Zero terminated for Show as set to string The string values are printed only to the first occurren
58. is displayed in this dialog when typing the argument value as shown in Figure 4 24 Send application command o x Command name cmd D Edit List of arguments Argument help h We for result dont close this dialog as Figure 4 23 Sending Application Command If you wish to wait for data to be returned from the board a command result without closing the dialog check the Wait for result box Before sending the command you can review or edit the command definition When defining or editing the command the Application command dialog box is opened The first of three pages of the dialog is shown in Figure 4 24 FreeMASTER for Embedded Applications Rev 2 0 24 Freescale Semiconductor FreeMASTER USAGE Application Command l E X Definition Arguments Return codes Command name md 00 Code jo Response timeout 1 O00 ME Timeout error message Command response timeout Cancel Apply Help Figure 4 24 Application Command Definition Tab On the Definition tab enter the Command name used in the project and specify the one byte command Code which identifies the command in the target board application The command codes and their purposes as well as the command return codes and their purposes come from the board application developer The Response time out is the maximum time interval in milliseconds that FreeMASTER waits for response from the board application If the embedded a
59. ity of application commands can also be dependent on the selected block The App commands page shown in Figure 4 5 sets which commands will be available in the Fast Access pane in the context of this project block and also enables the management of application commands Project Block Properties X Main watch App commands Avallable commands MEET 01 cmd 01 02 cmd UA Clone 0a emd_10 Edit Delete Displayed commands Add Remove un Cancel Help Figure 4 5 Project Block Properties App commands Page FreeMASTER for Embedded Applications Rev 2 0 10 Freescale Semiconductor FreeMASTER USAGE The commands are listed in the Available commands window Use the Add button to move a command into the Displayed commands window and to make it available in the Fast Access pane Use the Remove button for reverse operation You can use the following buttons e New Creates a new command see Section 4 3 Commands e Clone Creates a new command based on a copy of the selected command e Edit Changes the selected command properties e Delete Deletes the selected command e Up Down arrows Sets the display order of commands in the Fast Access pane 4 1 1 2 Scope The Scope item in the Project Tree structure defines a real time oscilloscope chart to be shown in the Detail View pane The Scope properties window shown in Figure 4 6 allows you to configure the appearance and characte
60. ize is printed in word units 16 bit in the xMap file but we need this value in bytes NOTE All created regular expression parsers will automatically be saved to the project file and to the local computer registry database for future use 5 3 Packing Resource Files into Project File The project often uses data from many different files For example each HTML page displayed for a project tree item or each image used on such a page is stored in a separate file This may cause problems when you want to deploy or distribute a project to different computers Using the Pack options shown in Figure 5 3 you can choose to pack the resource files into the project file when it is saved FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 35 JECT OPTIONS Comm MAP Files Pack Dir HTML Pages Demo Mode Current location of resource files packed into the project file when saving source Se Specify the directory with resource HTML files related to the project These files will be extracted into system temporary space when the project file is opened nest time Path to original directory for nest time the project is opened see conditions bellow source aes Ce Do not create and use the temporary directory if the original directory exists C Create temporary directory always even if the original directory exists Create temporary directory when stored files differ from the ones in original director
61. k Scope Properties oe RE X Mam Setup Graph vars Assignment to blacks T block Left Axis mir on MW auto mas No M auto style Line T block Right Axis Right asis wars fo min Fo d f auto max fio f auto style Line rv Join Split vart EH Color Assign vars to block Left sett scopare SOS Right axis label Wa Cancel Help Figure 4 7 Scope Properties Set up Page The Y block is a graph element represented by one left Y axis and optionally one right Y axis also The Y blocks can be drawn separately or overlapped in the graph e Assign vars to block button Assigns successive selected Chart vars to a Y block Select the chart variables you want to group into one Y block and press this button A simple assignment of two variables into two separate Y blocks is shown in Figure 4 7 e Inthe Y block Left axis frame set the axis range by specifying the min and max axis value or check auto box to enable automatic minimum and or maximum tracking Select a Style of drawing the data subsets from the drop down list box e Type the Left axis label which will be assigned to a selected Y block The resulting oscilloscope chart is displayed in Figure 4 8 FreeMASTER for Embedded Applications Rev 2 0 12 Freescale Semiconductor FreeMASTER USAGE E Li Li Li de L Di E Ch CL E Oo Time sec control page algorithm
62. lamation Stop C Question code 00 Code ZERO New the symbol will be replaced with the return code number in the message Cancel Apply Help Figure 4 27 Application Command Return Codes Tab Return codes can be local or global Local return codes apply to a single command while global return codes are valid for all commands of the project To switch between local and global validity use the Make local and Make global buttons Check the Show default messages for unknown return codes box at the top of the page to pop up a standard message box with return code when an unlisted code returns from the board application 4 4 Importing Project Files When preparing your project you may want to reuse the variables commands scope and recorder definitions or watch definitions you created in previous projects Selecting the File Import menu command opens a dialog in which you can select objects defined in different projects and import them to the current project The first dialog of the mport procedure is shown in Figure 4 28 After specifying the name of the original project file you select and check the project tree items you wish to have in your current project You can also select the target block item under which you want the imported items to be created Together with imported tree items all referenced objects such as variables or application commands are also automatically imported Using the switch radio b
63. lock properties dialog as shown in Figure 4 3 Project Block Properties EG x Name Demo Project Description URL Watch grid setup M Show grid M Allow column resizing M Allow column swapping M Allow row resizing M Allow cells format changes Formating Tools bar enabled M Allow in place variable values editing f Allow in place variable parameters edit name units Cancel Help Figure 4 3 Project Block Properties Main Page The Main page contains the following user configuration items e Name Name of Project block that will be displayed in the Project Tree e Description URL Select a description URL or a path to htm or html file to be shown in the Detail View pane under the algorithm block description tab This file may be created with any HTML editor such as MS Front Page Express or Netscape Composer In the demo application used as our example the description page is left empty causing the Algorithm Block Description tab to be hidden See Section 4 1 2 Detail View for more details e Watch grid setup You can select columns to display in the Watch grid Name Value Unit Period specify the column order using the Up and Down arrow buttons check the grid behavior options column resizing swapping row resizing allow format changes to grid cells with Toolbar see Section 4 6 2 Watch Bar and edit in place variable values by checking the next option box
64. lue is returned if there is no recorder currently active FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 53 L and SCRIPTING 6 3 13 GetCurrentRecorderState GetCurrentRecorderState nState bsRetMsg 6 3 13 1 Description This function retrieves current recorder status code and assigned status text 6 3 13 2 Arguments Return numeric value identifying current recorder state Valid states codes are O idle 1 starting nState 2 running out optional 3 downloading results 4 holding received signal 5 error 6 manually stopping 7 not initialized bsRetMsg When an error occurs this value contains an error message otherwise out optional it contains text description of current recorder state 6 3 13 3 Return Value True is returned if the recorder state has been read successfully Boolean value P i False is returned if there is no recorder currently active FreeMASTER for Embedded Applications Rev 2 0 54 Freescale Semiconductor HTML and SCRIPTING 6 3 14 RunStimulators RunStimulators bsStimNames 6 3 14 1 Description This function starts one or more Free MASTER variable stimulators 6 3 14 2 Arguments oh aa A semicolon delimited list of stimulators to be started 6 3 14 3 Return Value Number of stimulators actually started This number may be equal or less than the number of semicolon delimited stimulator names passed Integer Value in bsStim
65. min Di 4 f auto max fic F auto style Line rv Graph wars 3 Assignment to blocks LILILILILILI Join Split vart 6 v i Color Assign vars to block Left avis labe copa SS Right avislabet es Cancel Help Figure 4 14 Recorder Properties Setup Page The Trigger page shown in Figure 4 15 defines the Recorder start conditions The trigger starts the Recorder when the Trigger variable exceeds the specified Threshold value with the selected type of slope positive rising edge or negative falling edge Recorder Properties E x Mam Setup Trigger Threshold Isis variable Leet rl SH Threshald value 1000 Threshold value is in the raw format no shift masking and transformations Ce Back translate the threshold value into raw threshold value Threshold crossing slope Ze positive slope negative slope both Pretrigger samples 10 T Force trigger variable treated as bool en Auto run M Auto run mode reactivate trigger after signal download M Hold triggered signal sec e time to wait before reactivating trigger condition Automatic stopping 10 secs time out when trigger condition do not execute Cancel Help Figure 4 15 Recorder Properties Trigger Page e Threshold Specify conditions for the trigger event Trigger variable Selects a variable to be tracked for the trigger event Threshold value Th
66. mize risks associated with the customers applications adequate design and operating safeguards must be provided by the customer to minimize inherent or procedural hazards For any safety concerns contact Freescale sales and technical support services As a prototype this product does not fall within the scope of the European Union directive on electromagnetic compatibility and therefore may not meet the technical requirements of the directive Please be aware that the products received may not be regulatory compliant or agency certified FCC UL CE etc Should this evaluation kit not meet the specifications indicated in the kit it may be returned within 30 days from the date of delivery and will be replaced by a new kit Freescale reserves the right to make changes without further notice to any products herein Freescale makes no warranty representation or guarantee regarding the suitability of its products for any particular purpose nor does Freescale assume any liability arising out of the application or use of any product or circuit and specifically disclaims any and all liability including without limitation consequential or incidental damages Typical parameters can and do vary in different applications and actual performance may vary over time All operating parameters including Typical must be validated for each customer application by customer s technical experts Freescale does not convey any license under its patent ri
67. n below The applications shown here use some 3rd party Instrumentation components inserted into the HTML code as embedded ActiveX objects More screen shots are available on the FreeMASTER Home Page on the www freescale com see Section 1 3 Where to Find the Latest Version for more details FreeMASTER for Embedded Applications Rev 2 0 18 Freescale Semiconductor FreeMASTER USAGE EE FlexRay Brake by Wire Demo Frrosscale FF Waas bris C Vrea uedes FT mare sde regen f ID S EEN d 438 Mer LUE Bas Designed By a Lames h r by Advi Bonney C amp C Transportation A Standard Product Group Barnes pod Radhostem Czech Republ 4 freescale 3 ph BLDC Motor Control using Hall Sensors controlled by DC DC Inverter LUE d Leem app FlexRay Transmit Recelve Demo freescale MERS fie ag Transmission Var Ce FEU Freeman Data Gore Rose Bers Ter D Ee finner Pate fen tet Jaen Eretta Bd es 1176075 sei anses D Compare to Arbus CAH Care Virmiad CAM Tiare si CAM Burn En Fons E E EDA Fang CAM Bryter ant ra e i Aa i i T Ke k suc dee Bn LT vat L MFRS Flex Fay Reception FBR cae Enable 3 a Petey D n Rose fanges bw DORE ebay chore tue A Dar eae Hel ne eat E ste mme 1 sommes D mms He te nl p Pisia 1 jit made dh Il Bis F fie marin FV B Rede I nade Jj D Biosa d fie wde Jj 1 vesten pra
68. name plus offset value vAddr in Leg The size of memory block to be written a Safe array of bytes to be written It must contain at least vSize elements bsRetMsg When an error occurs this value contains an error message otherwise it out optinal is empty 6 3 6 3 Return Value True is returned if the memory block has been read without errors Boolean value False is returned if the specified address was invalid or if a communication error occurred FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 47 L and SCRIPTING 6 3 7 ReadXxxArray To access array of 1 2 or 4 byte signed integers ReadIntArray vAddr vSize vElemSize arrData bsRetMsg ReadIntArray t vAddr vSize vElemSize arrData bsRetMsg To access array of 1 2 or 4 byte unsigned integers ReadUIntArray vAddr vSize vElemSize arrData bsRetMsg ReadUIntArray_v vAddr vSize vElemSize arrData bsRetMsg ReadUlntArray t vAddr vSize vElemSize arrData bsRetMsg To access array of 4 byte floating point numbers ReadFloatArray vAddr vSize arrData bsRetMsg ReadFloatArray t vAddr vSize arrData bsRetMsg To access array of 8 byte floating point numbers ReadDoubleArray vAddr vSize arrData bsRetMsg ReadDoubleArray_t vAddr vSize arrData bsRetMsg 6 3 7 1 Description These functions read a block of memory from the target application and translate return it to the caller in the form of
69. nd Watch Pane is selected from the View menu It contains buttons with which you can change various graphical attributes of variables Tahoma EI sul 2jelF Bold Align Right Font Font Size Italic I Align Center Underlined Align Left Background Color Foreground Color Figure 4 37 Watch Bar FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 31 JECT OPTIONS Chapter 5 PROJECT OPTIONS To set application and project options use the Options dialog which can be activated by selecting Options from the Project menu The dialog consists of several pages each dedicated to a different group of settings 51 Communication To set up the parameters related to communication between FreeMASTER application and target board select the first tab as shown in Figure 5 1 e Communication Direct RS232 connection The standard serial interface 3 wire RS232 cable will be used to connect to the target application Port Select the serial port on which the board is accessed Speed Select or specify the communication baud rate This soeed must correspond with the embedded application settings Plug in Module Interface The communication with an embedded device will be handled by a separate custom plug in module The module must conform to the Microsoft COM specification and must be registered in the system registry database See protocol and communication library documentation for more inform
70. ng systems and enables real time visualization demonstration and control of the embedded application Press the E button in the toolbar above to open or close the communication port Go to menu Project Options to change communication port settings This example application demonstrates the FreeMASTER Serial Communication Driver You can find more information about the FreeMASTER formerly PC Master in the User Manual or Communication Protocol Specification FreeMASTER Features e Read Vrite access to the target memory variables in the embedded application Ability to parse ELF application executable file and retrieve C variable addresses and type information Ability to display the variable values in real time graph oscilloscope Ability to record fast variable transitions to on board or on chip memory and display it in the FreeMAaSTER graph recorder Ability to deliver Application Commands to the embedded application code for whatever control the application requires JScript or VBScript enabled HTML pages like this one can be used as Graphical User Interface to the embedded application The script code gains the same access to the embedded application as is available in the FreeM ASTER GUI for example reading the varde variable var16 5059 Mew FreeMASTER Features also demonstrated in this example control page Figure 4 16 Demo Application Control Page A few more sophisticated control page screen shots are show
71. nnnnnnnrnnannrnnnnnnnnnnennannrnnnnsen 17 Demo Application Control Page cccccceccccsseececeeeseeseeeseeeeeeceeseeeeesseaeeeesaeeeeeeas 18 HTML Control Page Examples 19 VEDEN E 20 Variable Dialog Box Definition Tab VV 21 Variable Dialog Box Modifying Tab rrrrrnnnnnnnnnnnnnnrnnnnnennnnnnnrnnnennnnrnnnnsennnssennnn 22 Generating Variables 2 4 0 een cerscs esse siens 23 Project Application Commands LR 24 Sending Application Commande 24 Application Command Definition Tab rarrrrnnnnrnrnrnnnrrnrnnnnerrnnnrnnrnnnrennnnnrnnnannnnn 25 Application Command Arguments Tab page 25 Application Command Arguments Tab page 2 26 Application Command Return Codes Tab 27 MAO Project Tree ICM ET 28 IMPOSER ge 10140 EC 28 ER TE EO 29 Export graph image Dialog VU 29 View Menu ee 30 Salle E EE 30 FreeMASTER for Embedded Applications Rev 2 0 LOF 1 of Figures Figure 4 34 Figure 4 35 Figure 4 36 Figure 4 37 Figure 5 1 Figure 5 2 Figure 5 3 Figure 5 4 Figure 5 5 Figure 5 6 Figure 5 7 Figure 5 8 Figure 5 9 Figure 5 10 LOF 2 SCDE MENU nee ce er ee an 30 FEE a a a ne ans ee nee 31 TON saeco ce gece sce een cao close eee eens eee eee ee 31 WV AIG A E E T 31 Communication Options rrrrnnrerrrnnnenrnnnrevnnnnnennnnnrnnnnensnnnnnnennnnsnennnnnsennnnsennnnsee 32 SJ 119100 SODIO EE 33 Regular Expression based xMap File Parser rrrnrrrrnrnenannnnnnnn
72. nnnrnnnnennnnennnnennnne 35 Testing Your Regular Expression c cccccecccececesecceeceeeeceeeceeecaueeeueeseesseeesaueeeas 35 FEN OPTIONS Jr 36 Pack Directory Options Example 72 36 Resource Files Manager Vs 37 REME PASS ODINS a a a ca Do a 38 DEMO MOJE OE en 38 Exit Demo Mode Confirmation Dialog VV 39 Free MASTER for Embedded Applications Rev 2 0 Freescale Semiconductor List of Tables Table Page Number Number Table 6 1 Free MASTER ActiveX Object Properties rrrrrrrnrrrrnnnrnrnnnennnnnrnnnnrennnnennnnnennnner 57 FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor LOT 1 f Tables Rev 2 0 9 2007 LOT 2 Freescale Semiconductor Introduction Chapter 1 Introduction 1 1 Overview This User Manual describes the FreeMASTER application formerly known as PC Master developed by Freescale engineers to allow control of an embedded application from a graphical environment running on a PG The application was initially created for developers of hard real time motor control applications but many users found it very useful for their custom development The FreeMASTER application is fully backward compatible with previous PC Master versions 1 2 Supported Platforms The PC side FreeMASTER application can be installed on any Microsoft Windows based systems starting Windows 98 For the embedded side there were several different serial communication SCI drivers for each supported
73. ns Rev 2 0 38 Freescale Semiconductor PROJECT OPTIONS In the Demo Mode the user cannot change the Project Tree item properties cannot add or remove the tree items and cannot change any project options except those on the communication page When the user asks to leave the Demo Mode the warning message shown in Figure 5 10 appears and the user is prompted for the password if the Demo Mode is password protected Freescale Semiconductor The application is in demo mode The application is in demo mode now You cannot modify selected project application settings You can leave the demo mode by pressing the Leave button If you do 20 vou vill be responsible for any changes which can make the current project invalid Help Continue Figure 5 10 Exit Demo Mode Confirmation Dialog FreeMASTER for Embedded Applications Rev 2 0 39 L and SCRIPTING Chapter 6 HTML and SCRIPTING All HTML pages used in FreeMASTER are rendered using the standard Microsoft Internet Explorer component The advantage of using the HTML and Internet Explorer component is that it fully Supports scripting languages and enables scripts to embed and access third party ActiveX controls The FreeMASTER application itself implements an non visual ActiveX component to let script based code to access and control the target board application The following text is recommended only for HTML page creators experienced with sc
74. of this Agreement will be unimpaired and unless a modification or replacement of the invalid or unenforceable provision is further held to deprive you or Freescale of a material benefit in which case the Agreement will inmediately terminate the invalid or unenforceable provision will be replaced with a provision that is valid and enforceable and that comes closest to the intention underlying the invalid or unenforceable provision NO WAIVER The waiver by Freescale of any breach of any provision of this Agreement will not operate or be construed as a waiver of any other or a subsequent breach of the same or a different provision FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 3 STIONS and ANSWERS Chapter 2 QUESTIONS and ANSWERS First question why place this topic immediately after an introduction The reason is really quite practical While writing this User Manual the following questions were raised Since the answers to these questions clarified terms and topics described further in the manual it was decided to put this topic before those that are more detailed and perhaps less easily understood 2 1 Why do I need it The primary goal of developing FreeMASTER software was to deliver a tool for debugging and demonstrating Motor Control algorithms and applications The result was a tool with the versatility to be used for multipurpose algorithms and applications Some real world uses include e Real time debu
75. omatically updated by new symbol addresses after the project is loaded List errors When this box is checked all the variables using the symbols missing in the loaded symbol table are listed in a special dialog box The user is able to edit the corrupted variables or select another symbol file 5 2 1 Regular Expression based MAP File Parser When your compiler or linker does not support ELF output format and the MAP file cannot be parsed by the built in HiWare 5 0 9 parser you must describe the internal MAP file structure by using the regular expression pattern It would be out of the scope of this document to describe the theory of regular expression pattern matching but a simple example might help to understand the strength of this technology In the example we will define the parser of xMap files generated by CodeWarrior Compiler and Linker for the Freescale DSP56800 processor family The example of the xMap line which describes the global symbol Length might look like the following 00002320 00000001 bss Flength bsp lib pcmasterdrv o 00002321 00000001 bss Fpos bsp lib pcmasterdrv o First we must describe the line format by the regular expression pattern The following pattern 0 9a fA F s 0 9a fA F s S stF wt could be read as follows e first there are one or more hexadecimal digits 0 9a fA F e _ followed by one or more spaces or another white characters s e followed again by one or more hexadecimal digi
76. on and Development Tool home page at http www freescale com webapp sps site prod summary jsp code DSP56800EQUICKSTART FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 59 sion History Appendix B Revision History The following revision history table summarizes changes contained in this document Revision Description In 2 2002 Published as 56F800 SDK document SDK111 D 6 2004 Updated for Free MASTER Application Made as separate document Updated for Free MASTER version 1 3 New application screen shots used New Freescale 2 0 9 2007 document template used FreeMASTER for Embedded Applications Rev 2 0 60 Freescale Semiconductor How to Reach Us Home Page www freescale com Web Support http www freescale com support USA Europe or Locations Not Listed Freescale Semiconductor Inc Technical Information Center EL516 2100 East Elliot Road Tempe Arizona 85284 1 800 521 6274 or 1 480 768 2130 www freescale com support Europe Middle East and Africa Freescale Halbleiter Deutschland GmbH Technical Information Center Schatzbogen 7 81829 Muenchen Germany 44 1296 380 456 English 46 8 52200080 English 49 89 92103 559 German 33 1 69 35 48 48 French www freescale com support Japan Freescale Semiconductor Japan Ltd Headquarters ARCO Tower 15F 1 8 1 Shimo Meguro Meguro ku Tokyo 153 0064 Japan 0120 191014 or 81 3 5437 9125 support japan freescale
77. operly evaluated when the files are extracted to a temporary directory on different hosts The Resource Files Manager can be activated in the menu Project Resource Files The typical look of the window is shown in Figure 5 7 Resource Files Resource files packed into the project file when it is being saved all paths here are relative to the current pack directory welcome bm control HTML file Other files used by the project MN varning these files must be deployed manual the paths here can be absolute or relative to the directory where project file is stored Errors references to non existing files output OM pFlash elf Map file 50 to reference Close Help Figure 5 7 Resource Files Manager The dialog displays all external files directly referenced by the project Note that there can also be other files e g images referenced indirectly from the HTML pages You should verify whether the files lie in the pack directory and whether the HTML pages point to them using a relative path The first list in the dialog contains the files located in the current pack directory These files will be properly stored in the project file when it is saved On other hosts the files will be extracted in a temporary space if needed The second list in dialog contains the files which are successfully used by the project but are located outside the pack directory Their file names are specified either by absolut
78. or other and on the opposite side into the target development board s serial connector In addition to RS232 link the custom communication plug in modules can be written and used by FreeMASTER There are communication plug ins available for CAN Calibration Protocol JTAG Real time Data Exchange port on 56F800E BDM interface on HCS08 12 devices etc 2 6 What are all of these dialog boxes for In Chapter 4 FreeMASTER USAGE you will see pictures with dialog boxes These dialog boxes are used as a questionnaire where you will enter parameters describing for example one algorithm block or application variable and its visualization FreeMASTER for Embedded Applications Rev 2 0 A Freescale Semiconductor QUESTIONS and ANSWERS 2 7 How does a project relate to my application There can be many Free MASTER projects related to a single target board application For example three specific Free MASTER projects can work with the same board application to provide three different purposes e to provide information used during debug process e to provide service maintenance capabilities e may be used for learning about your application during operator training phase 2 8 How do I set up remote control Why would I want to For remote control you need at least two computers connected via a network one running the standalone mini application called FreeMASTER Remote Communication Server and the second running the standard Free
79. ownloaded 4 1 2 Detail View The Detail View is a multipage pane Availability of various pages in the Detail View depends on the type of item selected in the Project Tree The control page when defined in project Options 5 4 HTML Pages is available for all Project Tree items to allow the user to control the board at any time The content of the algorithm block description page changes with the Project Tree item selected When a Scope or Recorder item is selected in the Project Tree the current item help and oscilloscope recorder chart pages are also available 4 1 2 1 Control Page The Control Page is an HTML page created for board application control It typically contains the scripts enhanced form or forms which enable user friendly control of the embedded application The URL of the page or the path to the HTML file with a page source code can be specified in project Options dialog described in Section 5 4 HTML Pages The control page for the demo application used as an example is shown in Figure 4 16 Despite of its name there are no control features utilized in this simple application Still it demonstrates a JScript scripting technique to display a variable value directly in the HTML coded page See more details on HTML and scripting in Section 6 2 FreeMASTER ActiveX Object ty Z freescale semiconductor click to enlarge GREEN Demo FreeMASTER is an application running on MS Windows operati
80. pane contains a logical tree structure of the application being monitored controlled Users can add project sub blocks Scope and Recorder definitions to the project block in a logical structure to form a Project Tree This pane provides point and click selection of defined Project Tree elements The Detail View pane dynamically changes its content depending on the item selected in the Project Tree Depending on the type of the item selected in the tree this pane also provides several tabs with sub pages of additional information associated to the item e control page An HTML page created for controlling the target system e algorithm block description An HTML page or another document whose URL is defined in the selected Project Tree item s properties e current item help Another HTML document whose URL is defined in the Scope or Recorder properties e oscilloscope A real time graph displaying application variables as defined in the Scope properties e recorder A graph displaying recorded application variables as defined in the Recorder properties e The control page when defined is available for all Project Tree items to allow the user to control the board at any time The content of the algorithm block description page changes with the Project Tree item selected When a Scope or Recorder is selected from the Project Tree the current item help and oscilloscope recorder chart pages are also available The Variable Watch pane con
81. per address type and size settings After creation you can push the Edit symbol variable button to see and change other settings in the Variable dialog box e Generate array for symbol Enables you to generate a set of variables encapsulating the selected symbol and its successive locations offsets 4 3 Commands The list of Application commands defined in the project can be opened by selecting the Project Commands menu and is shown in Figure 4 22 You can use the buttons New Clone Edit and Delete to manage the list It is very similar to variables management e New button Creates a new application command e Edit button Edits properties of the selected application command e Clone button Creates a new command as a copy of the selected command e Delete button Deletes the selected command e Send button Opens the interface which enables the command to be sent to the embedded application FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 23 MASTER USAGE Application commands S SC S x Available commands 00 cmd DOC 01 cmd Di 02 cmd 0201 Da cmd 106 Figure 4 22 Project Application Commands In the Send application command dialog box which follows after pressing the Send button specify the command parameters if any and you can send the command to the embedded application The dialog is shown in Figure 4 23 For each argument you can define the help message which
82. pplication does not acknowledge the command and respond to it before this time out occurs the text entered into the Timeout error message field appears in alert window Application Command a xX Definition Arguments Retum codes new arg TZ ntb lt gt example argument Argument setup Enter validation size 2 M Modifiable Ne visible Help example argument Cancel Apply Help Figure 4 25 Application Command Arguments Tab page 1 The Arguments tab shown in Figure 4 25 is used for definition of command arguments Commands which do not have arguments will have an empty argument list Commands can have arguments to pass a value to the target board application together with the command code Use the New button to create a new argument the Delete button to delete an argument selected in the list and the up and down arrows to change the arguments order On the Argument setup sub page you define the selected argument parameters e Name Specify the argument name as it should appear in the list and in the Send application command dialog when the user is prompted for argument values You can also select the existing argument name from the drop down list box e Type Specify the argument s numeric value integer or floating point e Size Specify the argument s value size in bytes e Unit Specify any text which will be displayed as argument units This text is not sent to the target application Free
83. ripting and interfacing of the ActiveX controls 6 1 Special HTML Hyperlinks When creating HTML pages which are to be displayed in the FreeMASTER environment the author can use special hyperlinks to let users navigate in the project tree or to invoke selected application commands see 4 3 Commands Application command invocation hyperlinks include HREF pcmaster cmd cmdname arguments sends an application command cmdname Command argument values can be specified in round brackets An argument with a defined default value may be omitted e HREF pcmaster cmdw cmaname arguments sends an application command cmdname and waits until the target application processes it e HREF pcmaster cmdalg cmaname arguments displays Send Application Command dialog for the application command cmdname Any specified argument values are filled into appropriate fields in the dialog e HREF pcmaster selittem itemname tabname selects a project tree item named itemname and displays detail view and watch view contents exactly as if the user had selected the item manually It then selects the specified tab in detail view Valid tabname identifiers are ctl ctltab control controltab Control Page tab bik biktab blkinfo blkinfotab Algorithm Block Description tab info infotab iteminfo iteminfotab Current Item Help tab SCOpe osc oscilloscope osctab scopetab Oscilloscope tab recorder rec rectab recordertab Recorder tab FreeMAS
84. ristics of the scope chart The Main page contains these user configuration items e Name The name of the Scope item that will be displayed in the Project Tree e Description URL Specify the URL of the document or local path to a file to be shown in the Detail View pane under the current item help tab This file may be created with any HTML editor such as MS Front Page Express or Netscape Composer and should explain the chart variables and settings to the user e Scope global properties Common properties for all scope variables e Period Oscilloscope sampling period e Buffer The number of samples in one data subset in the chart e Legend location Set the visibility and location of the chart legend Scope Properties 4 E Lo X Mam Setup Name Demo Scope Description URL D Scope global properties Grid M Horizontal M Vertical Legend location Ge Top Bottom C Left Right M Legend visible Period 20 ms 0 maximal speed Buffer 1 O00 points per subset Graph type Graph setup Ce Time graph M axis label Time 37 graph Aale unis seconds MW Append units name to the label Maxis width 10 M Auto scale when lower than width sat Graph setup x variable X axis min fo W auto Max 100 W auto Figure 4 6 Scope properties Main Page e Grid Choose the horizontal and or vertical grid lines to be displayed in the chart e Graph type Sele
85. s left Shift size 0 fetait In some map files the address and or size values are printed in units other than bytes Specity the 1 based indexes of sub patterns used to extract required field from text line In Unix or Perl you would normally used sub pattern identifiers like 11 i here it is just 1 2 units Test your regular expression Cancel Help Figure 5 3 Regular Expression based xMap File Parser ou must post process the symbol values to convert them into byte By pressing Test your regular expression button the dialog vertically expands and the test panel is displayed as shown in Figure 5 4 Cut and paste a single line from the xMap file to Input line field and press the button Execute reg expression Test Input line 00002320 00000001 bes FlengthO bepdlib pomasterdrv o 1 Symbol name length Symbol address 00002520 us OOOO Get Example Mote this tests the reg exp only no post process is applied to the parsed values Figure 5 4 Testing Your Regular Expression The Symbol name Symbol address and Symbol size output fields should be displayed as shown in Figure 5 4 If you have errors please be sure that you have Internet Explorer 5 5 or higher installed on your machine for the regular expression functionality To finish our example you must set a one bit shifting of the size value in the Symbol post processing parameters This is because the symbol s
86. serial communication line The oscilloscope GUI looks similar to the Recorder except that the sampling speed of variables is limited by the communication data link FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 5 ALLATION Chapter 3 INSTALLATION 3 1 System Requirements The FreeMASTER application can run on any computer with Microsoft Windows 98 or later operating system Before installing the Internet Explorer 4 0 or higher 5 5 is recommended should be installed The following requirements result from those for the Internet Explorer 4 0 application Computer 486DX 66 MHz or higher processor Operating system Microsoft Windows XP Windows 2000 Windows NT4 with SP6 Windows 98 Required software Internet Explorer 4 0 or higher installed For selected features e g regular expression based parsing Internet Explorer 5 5 or higher is required Hard drive space 10MB Other hardware requirements Mouse serial RS 232 port for local control network access for remote control 3 2 Enabling a FreeMASTER Connection on the Target Application To enable the Free MASTER connection to the target board application follow the instructions provided with the embedded side driver the FMASTERSCIDRV The recommended and fastest way to start using Free MASTER is by trying the sample application Note that the sample application name may still refer to the PC Master software which is the previous name of the Free
87. should be lower than this result e Legend location Sets the visibility and location of the chart legend e Grid Chooses the horizontal and or vertical grid lines to be displayed in the chart e Graph type Selects the mode of recorder operation Time graph A variable values versus time will be displayed in the chart xX Y graph Inter variable dependencies value versus value will be displayed in the chart e Graph setup for Time graph X axis label Specify the name displayed for X axis X axis units Selects the axis units e Graph setup for X Y graph FreeMASTER for Embedded Applications Rev 2 0 16 Freescale Semiconductor FreeMASTER USAGE xX variable Selects the variable whose values will be used for X axis values X axis min Sets the lower limit value of the X axis check the auto box to enable auto scaling of the X axis X axis max Sets the upper limit value of the X axis check the auto box to enable auto scaling of the X axis The Setup page of the Recorder properties dialog shown in Figure 4 14 looks exactly the same as the appropriate page of the Scope properties dialog For more information about how to add variables to the recorder chart and how to set up the chart itself see Section 4 1 1 2 Scope Recorder Properties x Main Setup Trigger T block Left Asis min Fo 4 M auto max ho SJ M auto style Line vi T block Right Asis Right axis vart fo
88. t to the embedded application each time the user presses the spin arrow button or selects a new value in the drop down list box Write after ENTER or kill focus only The modified variable value will not be sent to the embedded application until the user does not press the Enter key 4 2 1 Generating Variables The Generate button in the variable list dialog Figure 4 18 opens the Generate variable dialog box shown in Figure 4 21 In this dialog the user can automatically generate the variable objects for the symbols loaded from an embedded application executable ELF or a linker MAP file see Section 5 2 Symbol Files for more information about symbol tables Generate variables Select symbols for which you vant to generate variables Make new variables writeable Edit symbol variable Delete symbol variables Generate array for symbol 202 inB ee Generate single variables Figure 4 21 Generating Variables The list in the dialog shows all the symbols available in the project as they were read from the current symbol file The symbols for which the variables are already defined are marked with a check mark e Edit symbol variable Press this button to edit a variable bound to the selected symbol if any e Delete symbol variable Press to delete a variable bound to the selected symbol s e Generate single variables Generates a new variable with the same name as the symbol and with pro
89. tains the list of variables assigned to the watch The pane displays the immediate variable values and also enables you to change them if this is enabled in the variable definition All the information related to one application is stored in a single project file with the extension omp This information includes the project settings and options the Project Tree Detail View HTML pages real time chart definitions watch interface settings variables and commands stimulators and more FreeMASTER for Embedded Applications Rev 2 0 8 Freescale Semiconductor FreeMASTER USAGE 4 1 1 Project Tree When a new project is created the Project Tree window contains an empty structure with just one root project block called New Project You can then change properties of this block or add sub blocks Scopes or Recorders to the structure Property changes and Project Tree additions can be done in two ways e Select an item in the Project Tree and right mouse click to use the local menu e Select an item in the Project Tree and select main menu Item pull down 4 1 1 1 Project Block and Sub block The Project block typically covers an integral component of the application or algorithm being demonstrated with FreeMASTER Sub blocks may be added should the user care to break the algorithm into multiple blocks Each block has its own algorithm block description page watch variables and commands All of these can be defined in the Project b
90. target memory Currently only the P amp E Multilink BDM cables are supported both USB and LPT but there is a plan to extend this support to other kinds of interface cables The JTAG EOnCE Communication Plug in enables a fully featured communication with the 56F800E hybrid microcontrollers over the JTAG interface cable either using a direct LPT access or a universal connection of CodeWarrior Command Converter Server The embedded side driver is needed in this case The plug in uses the Real time Data Exchange feature of JTAG EOnCE which is very similar to the SCI communication The driver is included in the FAASTERSCIDRV as a configurable option for the 56F800E platform See more details about the communication plug in modules in the read me documents installed together with the latest FreeMASTER application 1 3 Where to Find the Latest Version There are two software setup packs available on the Freescale web pages One is for the PC side application and one is for the new SCI driver for the embedded side The home page of the FreeMASTER application can be found by looking under the FREEMASTER keyword on www freescale com The direct link to the home page as of the writing this document is http www freescale com webapp sps site prod summary jsp code FREEMASTER Similarly the embedded side SCI drivers can be found by the keyword FMASTERSCIDRV The direct download link is also referred in the downloads section of the FreeMASTER
91. tional this value can be 0 if the target does not supply such a value 6 3 9 3 Return Value True is returned if the data has been retrieved successfully from the Boolean value recorder item False is returned if there is no valid data in the recorder or there is no currently active recorder FreeMASTER for Embedded Applications Rev 2 0 50 Freescale Semiconductor HTML and SCRIPTING 6 3 10 GetCurrentRecorderSeries GetCurrentRecorderSeries bsSerieName arrData timeBaseSec bsRetMsg GetCurrentRecorderSeries_t bsSerieName arrData timeBaseSec bsRetMsg 6 3 10 1 Description These functions retrieve one data series from the currently displayed recorder chart They differ in how the data is returned to the caller e GetCurrentRecorderSeries returns data in the safearray of variants which can be used in both scripting languages like VBScript and in compiled languages like Visual Basic e GetCurrentRecorderSeries_t returns data in the safearray of type double floating point which can be used in compiled languages like Visual Basic Using typed arrays is faster than using arrays of variants 6 3 10 2 Arguments ss String with the name of the series whose data is to be retrieved sile Return array of the values out optional timeBaseSec Returned time between individual recorded samples in seconds out optional this value can be 0 if the target does not supply such a value bsRetMsg When an
92. ts 0 9a fA F e followed again by one or more white characters s e followed by a set of any non white characters S e followed by one or more white characters again s e followed by the character F e followed by one or more alphanumeric word characters w To identify the sub patterns which describe the symbol parameters we put them in the round parentheses 0 9a fA F st 0 9a fA F NSTNSTNSTE Awt Now we must identify the sub pattern indexes for individual symbol values e The first sub pattern corresponds with the symbol address index 1 e The next sub pattern corresponds with the symbol size index 2 e The next sub pattern corresponds with the symbol name index 3 Supply all the parameters prepared above in the regular expression dialog as shown in lt st blue gt Figure 5 3 FreeMASTER for Embedded Applications Rev 2 0 34 Freescale Semiconductor PROJECT OPTIONS Define the regular expression based symbol parser File type name M aa ai TES Pattern Reg expr 0 9a t2 F 118 0 9a f2 FJHNS 5 18 F hw Mote Use standard regular expression as is described e g in Perl language or Unix system documentation Mark all appropriate subpatterns weith parentheses and specity their meaning below Sub pattern indexes Symbol name 3 Address 1 H M scan as hex Size optional 2 MW scan as hex Symbol values post processing Shift addr fo hit
93. ure of products could lead directly to death personal injury or severe physical or environmental damage High Risk Activities You specifically represent and warrant that you will not use the Software or any derivative work of the Software for High Risk Activities CHOICE OF LAW VENUE LIMITATIONS You agree that the statutes and laws of the United States and the State of Texas USA without regard to conflicts of laws principles will apply to all matters relating to this Agreement or the Software and you agree that any litigation will be subject to the exclusive jurisdiction of the state or federal courts in Texas USA You agree that regardless of any statute or law to the contrary any claim or cause of action arising out of or related to this Agreement or the Software must be filed within one 1 year after such claim or cause of action arose or be forever barred PRODUCT LABELING You are not authorized to use any Freescale trademarks brand names or logos ENTIRE AGREEMENT This Agreement constitutes the entire agreement between you and Freescale regarding the subject matter of this Agreement and supersedes all prior communications negotiations understandings agreements or representations either written or oral if any This Agreement may only be amended in written form executed by you and Freescale SEVERABILITY If any provision of this Agreement is held for any reason to be invalid or unenforceable then the remaining provisions
94. uttons below the lists you can specify how the referenced objects are created e Overwrite existing When there is an object such as a variable imported with a tree item for example an oscilloscope the current project is searched for an object of the same type variable and with the same name If found it is overwritten with the one imported e Bind to existing lf an object with the same name is found it is not overwritten but the imported tree item binds to it e Always create new All referenced objects are created even if they already exist in the current document in such a case the name will be duplicated e Merge imported root item When importing the root item it is possible to merge its variable watch definition with the watch of the root item in the current project When this option is not checked the root item will be imported and inserted as a standard block item FreeMASTER for Embedded Applications Rev 2 0 Freescale Semiconductor 27 MASTER USAGE Import Project Tree Items D x Check the thems you want to import Select the destination block in current doc EY New Project El HET Project afte Demo Scope od Demo Recorder IT Merge imported root item into root item pp Commands used by imported tems Ce Overwrite if exists find by name Bind imported item to existing command Always create new command Variables used by imported tree items Ce Ovensrite i
95. variable use the button New This will open the Variable dialog box where you can set the variable properties described in Section Variable Settings When you need to create a copy of an existing variable select the original variable and press the Clone button The Edit button opens the same Variable dialog box for changing the selected variable properties After pressing the Delete button the user is asked for confirmation of deletion and the selected variable will be deleted Generate button opens the interface for mass creation of variable objects based on the symbols loaded from an embedded application executable file It is described in Section 4 2 1 Generating Variables loading of symbol files is described in Section 5 2 Symbol Files Variable Settings The Variable definition dialog has two tabs Definition shown in Figure 4 19 and Modifying shown in Figure 4 20 FreeMASTER for Embedded Applications Rev 2 0 20 Freescale Semiconductor FreeMASTER USAGE Sampling period 200 m Show as DEC Bit fields Show M oval I mint mag Fixed digi IT Fill left zeroes Varable name E Variable OxO3E 4 Address var H Type unsigned fired point Size E bytes Real type transformation Hane e Unit furit When the value is recerved shift it fo bits right and mask with no mask 1 Text enumeration after transform I Enumeration enabled
96. viously visited pages and to refresh the page contents Fonts sets the font size for the current Internet Explorer window 4 5 5 Scope Menu The Stop Scrolling and Stop Data commands cause the FreeMASTER to stop moving rolling the oscilloscope chart and to enter a mode in which the chart can be zoomed and the data series can be examined with the data cursor The difference between these two commands is that Stop Scrolling ee Item Proj ei Back gt Forward Refresh Largest SEG Large Medium PI Small Smallest Figure 4 33 Explorer Menu etset term Project Help ae Stop Strolling SI Stop Data Export Picture stops the picture but allows incoming data to be appended to the end Data Cursor No Cursor of the chart while Stoo Data also stops the incoming data Sec t Paint er Horizintal Zoom Only Crosshair Export Picture opens the Export graph image dialog where you can Horz and Vert Zoom Sucre specify the picture format and export the picture to the clipboard or to Floating ee econ alt a file a 43 Zoom All w Floating XY Data cursor enables you to select the style of data cursor for examining the chart values The Next Subset sub item selects the next chart line to be examined Next Subset Figure 4 34 Scope Menu The Zoom submenu consists of Zooming modes and commands The Horizontal Zoom Only mode allows x axis only zooming Horz and Vert Zoom allows free rectangl
97. ween you either as an individual or as an authorized representative of your employer and Freescale Semiconductor Inc Freescale It concerns your rights to use this file and any accompanying written materials the Software In consideration for Freescale allowing you to access the Software you are agreeing to be bound by the terms of this Agreement If you do not agree to all of the terms of this Agreement do not download the Software If you change your mind later stop using the Software and delete all copies of the Software in your possession or control Any copies of the Software that you have already distributed where permitted and do not destroy will continue to be governed by this Agreement Your prior use will also continue to be governed by this Agreement LICENSE GRANT Freescale grants to you free of charge the non exclusive non transferable right 1 to use the Software exclusively in conjunction with a development prototype or production platform utilizing at least one processor unit from Freescale Exclusive Use 2 to reproduce the Software 3 to distribute the Software and 4 to sublicense to others the right to use the distributed Software The Software is provided to you only in object machine readable form You may exercise the rights above only with respect to such object form You may not translate reverse engineer decompile or disassemble the Software except to the extent applicable law specifically
98. xadecimal value The symbol table can be loaded directly from the embedded application executable if it is the standard ELF or Dwarf1debugging format For other cases the text MAP file generated by the linker may be loaded and parsed for symbol information In the project you can specify multiple files which contain the symbol table Later you can switch between different symbol tables from different files by selecting the menu command Project Select Symbol File For example with the DSP embedded application tested on an EVM board you can have two symbol files specified in the project one for code running from RAM memory and the second for code running from Flash Figure 5 2 shows the MAP File tab in the project Options dialog Comm MAP Files Pack Dir HTML Pages Demo Mode Default symbol file Joutput SDM_pFlash elt Sg File format Binary ELF with DWARFT or DWARF2 dbg format Edit De List of all valid outoutsSOhM prlash elt symbol files Mote The file selected in the list will be used as default symbol file when the project i opened On Load f Let the user select starting symbol file M Synchronize variables each time the symbol file loads T List errors variables using undefined symbols e Always Except after project load Cancel Apply Help Figure 5 2 Symbol Files Options Default symbol file Specify the name of the symbol file which will be loaded by default You can press t
99. y f JF any stored file is missing in existing original directory ET IF any stored file differs in length or date from the one in original directory I Delete temporary directory when the user closes the project Cancel Apply Help Figure 5 5 Pack Directory Options To pack resource files into the project file put all these files into one directory or a directory structure and specify the path to that directory in both fields of the Pack Dir page By pressing the browse button you can find and select the directory in the standard open directory dialog The path to the directory can be specified by a path relative to the directory where the project file is saved When the project with the packed files is loaded next time by the application the original path entered in the second entry of the Pack Dirpage is checked If it is missing or if one of the files in it differs from the files originally packed in the project a temporary directory is created in the system temporary space and the packed files are extracted into that directory The temporary directory is then set as a default for the rest of resource files It is thus very important to specify the FreeMASTER paths to HTML files or to the symbol file relative to the directory specified in Pack Dir dialog The Pack Dir page displays the path to the temporary directory if it is currently in use but still remembers the path to the original resource directory Comm MAP Fil

Download Pdf Manuals

Related Search

Related Contents

取扱説明書 (2.99 MB/PDF)  DiViS CHSM48016  CLUB3D Radeon R7 260X royalQueen AMD Radeon R7 260X 2GB  USER'S MANUAL !  MELSEC-L CPU Module User`s Manual (Hardware Design  取扱説明書 ビュー ネクスト 1000  Universal Pest Solutions AllClear Mosquito Mister User's Manual  Electrolux 3531 WK-M Range User Manual  Philips HTS5550 User Guide Manual Pdf  1383812, PDF File, neues Fenster  

Copyright © All rights reserved. Failed to retrieve file