Home

60 The Targeting Expert

1. For Use with the Cmicro SDL to C Compiler e Application applclenv Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HPaCC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Has to be implemented by the user Template files Taken from sdtdir cmicro template More info The target executable can be executed on a command line e Application including Target Tester and communication via sockets July 2003 Telelogic Tau 4 5 User s Manual 2909 Chapter 60 The Targeting Expert 2910 Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HP acC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Has to be implemented by the user Template files Taken from sdtdir cmicro template More info The target executable has to be started man ually after the Target Tester is started by the Targeting Expert e Host Simulation debcom Supported
2. n characters against r n sequences e Command line taexutil U2D lt inputfile gt lt outputfile gt lt inputfile gt and lt outputfile gt can be equal but both must be given Indent The indentation of the given ASCII file will be corrected This means e all the preprocessor directives staring with will be moved into the first column This is necessary to conform with K amp R compilers Telelogic Tau 4 5 User s Manual 2935 Chapter 60 The Targeting Expert 2936 all the other lines will be indented according to the given blocks in C i e it is controlled by the use of and characters all TAB characters t will be removed all the SPACE characters at the end of lines will be removed Caution The indent offered by here does not offer the same functionality as indent known from UNIX Command line taexutil INDENT lt inputfile gt lt outputfile gt lt inputfile gt and lt outputfile gt can be equal but both must be given Preprocessor Note The main intention of the preprocessor given here is not to get an easy to read source file Instead it is to get a preprocessed file that can be compiled by a target compiler e g Keil Tasking be cause long macros are not supported by some target compilers The preprocessor utility should only be used to preprocess generated C files The following tasks will be processed 1 Copy the SDL to C compilers main h
3. Chapter 60 The Targeting Expert 2854 Actions to perform e Select the Pre defined Integration Settings e Select an SDL to C Compiler if not already done in the pre defined integration settings e Select a C Compiler if not already done in the pre defined integra tion settings HostSimulation EE Cmicro Borland C possible 7 select integration select C compiler select SDL to C compiler Figure 520 Integration selection in the main window Select the Pre defined Integration Settings Delivered with every Telelogic Tau distribution there are several Pre defined Integration Settings which you can use to get a target executable in an easy manner To get an optimized target executable concerning size and speed these pre defined integration settings should only be seen as templates Please see Distributed Pre defined Integration Settings on page 2904 The pre defined integration settings can be selected in the integration tool bar in the main window see Figure 520 All the pre defined inte gration settings are sorted into the groups e Simulations e Validations e Target Tests e Bare Integrations e Light Integrations e Threaded Integrations e Tight Integrations Additionally the integration lt user defined gt which does not belong to an integration type and is not pre defined can be selected Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work
4. Microsoft C possible al HostSimulation_ tool bar Partitioning Diagram Model SDL to C compiler Communication Env header file Execution O calcul g node i WM Analyze generate code componen aE fae EC P art it i on in g Gu Compiler Linker Make r Code generation options 7 Target Library The basic options how to generate code have to be set here diagram T Target Tester I Allfiles B Host connection I Capitalization lower case model PDM ap 4 Simulation R W Full variable prefix 3u Compiler Linker Make T Instance information file Ry Target Library Work area Separation No do not separate fe Default Default File name prefix gt Environment Note The environment header file generation cannot be switched off if coder or environment functions are selected F Environment header file configuration or I Environment functions ther tab R Make R Full Make Calcul target calcul _O HostSimulation__CLEN _ component exe Beg Generating default lt sdtmt opt gt Event log Generating default lt Calcul target calcul Generating lt X calcul _O HostSimulation_ _ONHostSimulation_ CLENV_ ml_mct CLEN _ ml_mcf h gt OK Figure 505 The Targeting Expert main window 2830 Telelogic Tau 4 5 User s Manual July 2003 The Graphical User Interface The Menu Bar This section describes the menu bar of the Targeting Expert Ma
5. lt installationdir bin wini386 sdttaex par amp Figure 543 Search order for sdttaex par in Windows Compiler Error Descriptions The section COMPILER ERROR DESCRIPTION of sdttaex par is filled with regular expressions describing the construction of compiler error messages O DESCRIPTION 234567890 A Za z FLO 234567890 1234567890 CH f Pa a 1 1234567890 IE 1234567890 aee ooe 1234567890 0 a seria 1234567890 LINE 1234567890 OF line 1234567890 line 1234567890 line 1234567890 1234567890 ey 5 5 5 5 WOWRRPWRPOOHO ae ae ee ae ae ae PNNNBNWNERENDN TE Di EOE a I E Telelogic Tau 4 5 User s Manual 2 w 2 2927 ES CR I PTI ON _ _ Chapter 60 The Targeting Expert 2928 Each line gives the description for one compiler The eight entries have the meaning shown below explained on the gcc entry The name of the compiler executable The amount of lines the compiler error message takes The regular expression to determine the erroneous file The amount of characters thrown away at the beginning of the found file name 5 The amount of characters thrown away at the end of the found file name In this example the colon and the numeric character do not belong to the file name but both are nee
6. It should not be mod ified by hand Please see Generating Partitioning Diagram Data for the Targeting Expert on page 1723 in chapter 41 The Deployment Editor for more information If there is no deployment done for a system the Targeting Expert generates a default partitioning diagram model for its internal use This partitioning diagram model is not available as a file For a de fault partitioning diagram model there is no chance to specify inte gration models or threads Definitions The complete SDL system is mirrored in the partitioning diagram s ap plication which takes several nodes Each node can represent a run time physical object with memory and processing capability and is a collection of several components Each component is a collection of different objects with each object representing an SDL qualifier A component will result in one execut able or OS task File Syntax Example Estimated there is an SDL system like the one shown in Figure 537 Telelogic Tau 4 5 User s Manual July 2003 Internal System access Block LocalStation Block DoorControl Process DoorMonitor ___ Process DoorController Block Control __ Process Controller Block PanelControl Process PanelController _ Procedure KeyToNum L Block CentralUnit Process Central Procedure SuperCheck Procedure Validate Figure 537 An SDL
7. Micro controller compiler PC compiler Workstation compiler Communications Link Note This section is valid only if the Cmicro SDL to C Compiler is used The example below shows the structure of one entry Telelogic Tau 4 5 User s Manual July 2003 Internal July 2003 Example 474 Structure ofa cm_conf def entries BEGIN XMK_USE V24 V24 communication COMMLINK V24 interface AUTOSET XMK V24 BAUD XMK V24 DEVIC END END Ea COWODINHDUBPWNE H Lines 1 and 10 mark the start and the end of one entry Line 2 gives the name of the flag as it appears in the generated file ml_mcf h According to this example line 3 is the marker which ap pears in the Targeting Expert graphical user interface Line 4 specifies the main group this entry belongs to It has to be com MLINK in this case Line 5 gives the subgroup of the entry This subgroup can be anything you like In the delivered version there is only the subgroup v24 inter face However you can define your own communications link CAN Bus for example The lines 6 and 9 belong together and between these lines all flags are listed which have to be set when the flag on line 2 is set The amount of flags lines 7 and 8 in the example is free In the same way as AUTOSET in line 6 there can also be the entries RESET or DEPEND RESET means the following flags will be reset if this flag is defined and DEPEND means this flag can only be s
8. This section starts with DESCRIPTION and has got the only entry HelpLink The description is a link name to this manual The Settings The section of the its files which contains the settings starts with SETTINGS They must be ordered with the Global Settings A first followed by the Compiler specific Definitions e Global Settings A The global settings start with the lt keyword1 gt equal to Preferences and the delimiter i e an allowed line in this section looks like Preferences lt keyword2 gt parameter Example 475 Pre defined integration settings 2A Preference IntegrationSettings lt name gt The meaning of lt keyword2 gt can be found in the table below Keyword 2 Meaning of the parameter IntegrationSettings The name of this pre defined integration setting is en tered here July 2003 e Global Settings B The global settings part B start with the lt keyword1 gt equal to the name of the pre defined integration settings see Global Settings A and the delimiter i e an allowed line in this section looks like lt name gt lt keyword2 gt parameter Example 476 Pre defined integration settings 2B Simulation CompilersUsed Microsoft Simulation CodeGenerator Cadvanced Simulation GenerateMakefile YES Telelogic Tau 4 5 User s Manual 2913 Chapter 60 The Targeting Expert The meaning of lt keyword2 gt can be found in the table
9. are three different files A uis saved in the correspondent application node and component directories Figure 516 shows where the settings can be done and where they are taken from when the component is selected July 2003 Telelogic Tau 4 5 User s Manual 2847 Chapter 60 The Targeting Expert 2848 use application settings application s A uis component s A uis use parent node settings Export The settings of the currently selected integration will be exported as new Pre defined Integration Settings with the name given in the first di select other user settings Y components my_set uis use application settings select other user settings Figure 516 handling the user settings Telelogic Tau 4 5 User s Manual alog that pops up 8 use parent node settings fo node s lng A uis Pal select other user settings July 2003 Interactive Mode July 2003 Export a settings file x Select a filename to export settings Settings fom component node or application Exported pre defined integration as project settings C Exported pre defined integration as user settings ne Filename Cancel Help Figure 517 Note All the integrations must have unique names i e it is not possible to export settings with an already known name Export pre defined integration as project settings In this
10. entry can be used more than once LibrariesToLink Additional libraries to be linked e g the compiler s libraries This entry can be used more than once Make Tool The name of the make application This can be e Borland make using temporary re sponse file e Borland make e Microsoft nmake using temporary response file e Microsoft nmake e UNIX make MakefileName The name of the makefile to be generat ed or respectively to be used is entered here MakefileGenerator The Targeting Experts supports the use of external makefile generators which is to be entered here An intern means that the build in makefile generator is to be used ObjectDirectory The relative path seen from the target directory for the object directory can be entered here If not specified Targeting expert will generate the makefile in a way that the object files will be written into the target directory when make is executed 2918 Telelogic Tau 4 5 User s Manual July 2003 Internal Keyword 3 Keyword 4 Meaning of the parameter LibraryDirectory If this entry is specified the SDL to C compiler s library will be taken from the specified path If not specified it will be taken from S sdtdir SDTDIR Download Tool The full command line to invoke the download application PreMake Action to perform before the target ap plication will be made in the makefile PreCompil
11. tries to set the default compiler selected in the Telelogic Tau Pref erences Please see chapter 3 The Preference Manager However it is possible to set another compiler by selecting it in the combo box shown in Figure 520 Telelogic Tau 4 5 User s Manual 2855 Chapter 60 The Targeting Expert 2856 If the lt user defined gt integration has been chosen a new compiler can be added by selecting the entry Add new compiler description Actions to perform e Configure Compiler Linker and Make e Configure and Scale the Target Library e Configure the SDL Target Tester Cmicro only e Configure the Host Cmicro only To select the desired configuration dialog please select the correspon dent entry in the partitioning diagram oO access 6 node component a amp Compiler Linker Make B Target Library A HostSimulation amp Compiler Linker Make B Target Library B Tester B Host connection Figure 521 Tree structure in the partitioning diagram Configure Compiler Linker and Make This part of the configuration is divided into four sub steps which are taken from the selected pre defined integration settings as far as possi ble Compiler You enter the needed compiler configuration in a special input mask The compiler you specify here will be used to compile the generated code and the target library Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow Zp4 nologo ML
12. 8 character in front of and a 3 character exten sion To ensure that files are generated only which fit to the 8 3 require ment This section looks as follows Example 487 8 3 COMPILERS 8 3 COMPILERS ee icpp icc12 Editor Commands The Targeting Expert allows to use other text editor different to the build in one The information how to start these editors is given in the section EDITOR COMMANDS shown below Example 488 EDITOR COMMANDS EDITOR COMMANDS Windows TextPad textpad ca q 1 0 Windows UltraEdit UEdit32 f 1 0 Windows Codewright codewright f G 1 Windows MS DeveloperStudio msdev f UNIX Emacs emacs hni panad eae dase Sie sf UNIX nedit nedit line 1 f There are 2 placeholders used in the command will be replaced by the name of the file to open and 1 gives the line number which should be shown Additional Files The sections shown in Example 489 will used to find out which files be long to external parts of the distributed SDL to C compiler libraries Telelogic Tau 4 5 User s Manual 2931 Chapter 60 The Targeting Expert 2932 Example 489 Additional Files Sections CMICRO KERNEL FILES TU Ut UU UF Ut Ut UU Ui U Ur Ur UE UU UF UF FF e Ur UY UF UF UF UF UF e U UY UY UE UE UE UF UF U Ur U U N N N a CMIC m H sctkerneldir sctkerneldir sctkerneldir sctkerneldir sctkerneldir sctkerneldir sctkerneld
13. AW0 DNDEBUG DWIN32 D_CONSOLE c 41 Fo o s D SCMADEBCLENVCOM l 1 sdtdir cmicro include I sctCODERDIR I sctT CPIPDIR Figure 522 Compiler configuration Click Default if you want to restore the default values e Compiler Name Enter the name of the compiler application e Options July 2003 Telelogic Tau 4 5 User s Manual 2857 Chapter 60 The Targeting Expert Enter the options given to the compiler as command line arguments here Enter the placeholder s where the source file name of the file to be compiled has to be inserted used for the makefile genera tion Enterthe dummy parameter o where the object file s name has to be inserted used for the makefile generation Enter the dummy parameter I where the include path option has to be placed see below e Compile as C The compiler options to compile C files as C files will be add ed removed from the Options For a definition of the used compiler options see the Parameter File sdttaex par on page 2925 e Compile as debug The compiler options to generate the object files including debug in formation will be added removed from the Options For a definition of the used compiler options see the Parameter File sdttaex par on page 2925 e Library Flag The compiler option to define a flag plus the C macro used to select the desired library must be given here When using Cmicro this field is empty per
14. Flow Hint If there is no set of pre defined integration settings that fits your needs e g a not yet supported compiler it is recommended to se lect lt user defined gt and to do the further configurations by hand Select an SDL to C Compiler The SDL to C compiler to be used will automatically be set if you select one of the pre defined integration settings It is only necessary to select the SDL to C compiler if the lt user defined gt settings have been se lected All the available SDL to C compilers will be given in the combo box shown in Figure 520 Depending on the licenses found the following SDL to C compilers are supported Cadvanced Cmicro Note Directly after the SDL to C compiler is selected i e after pre de fined integration settings are selected the Targeting Expert checks if there is already an automatic configuration file sdl_cfg h done by the SDL to C compiler available If not the SDL to C compiler should be invoked to generate an au tomatic configuration For Cadvanced this is only done if the flag USER_CONFIG is set in the compiler options e g DUSER_CONFIG Select a C Compiler After a pre defined integration setting is selected the Targeting Expert tries to automatically set the compiler to be used i e if there is only one compiler supported with the selected pre defined integration settings than that one is set if there are more than one compiler supported the Targeting Expert
15. Set Setting String ObjectExtension Set Setting String TestTool Set Setting String Description of Batch Mode Commands In this section the batch mode commands are listed in alphabetical or der along with their parameters and a description Add PR Parameters lt pr filename gt Telelogic Tau 4 5 User s Manual Chapter 60 The Targeting Expert 2888 Further PR files can be specified here which should be considered by the SDL to C compiler The first PR file has to be given by using Open PR command Add Setting String Parameters lt class gt lt entry gt lt stringvalue gt The list lt entry gt will be extended for the item lt stringvalue gt Add UserSection String Parameters lt stringvalue gt The lt stringvalue gt will be added in the user section of ml_mcf h Cmicro or respectively sct_mcf h Cadvanced Analyze Parameters lt none gt The SDL system will be analyzed Append Setting String Parameters lt class gt lt entry gt lt stringvalue gt lt stringvalue gt will be appended to the current value of lt class gt lt entry gt Clear UserSection Parameters lt none gt The complete user section of ml_mcf h Cmicro or respectively sct_mcf h Cadvanced will be removed Default Setting Parameters lt class gt lt entry gt The default value of the given lt entry gt will be restored Exit Parameters lt none gt Telelogic Tau 4 5 User s
16. The compiler supports lt stdio h gt If selected this section will be generated ifdef XMK_ADD PRINTF include lt stdio h gt endif Otherwise nothing will be generated here Additional includes The contents of the edit box will simply be copied into the user_cc h file It should carry something like include lt file gt e User definitions Enter user definitions for the user_cc h file Remove The following is applicable only if using the Cmicro SDL to C compil er To remove a compiler from the private c _conf def file select Re move an Unused Compiler from the Edit Menu Telelogic Tau 4 5 User s Manual 2841 Chapter 60 The Targeting Expert 2842 Remove a C Compiler x Compiler name Compiler macro ANSI ce for HP 300 and HF ANSI ce for HP 700 PA RIS ANSI ce for SunOS 5 Borland and Microsoft C for SUN ce for HP 300 and HP 400 Cancel Help Figure 510 Remove compiler dialog Note The file user_cc h will not be affected by removing a compiler from the c _conf def file Communications Link Definition for Compilation The following is only applicable if using the Cmicro SDL to C compil er Note All the modifications that can be done here are only valid for the current system i e all the information will be stored into the sys tem s target directory Add To allow the selection of a new communications link in the Targeting Expert user interface the appr
17. as long as the command does not become ambiguous Hint Commands used in command files should not be abbreviated be cause future implementations may conflict with those abbreviations Parameters in Commands Parameters are separated by one or several spaces Parameters contain ing spaces have to be given in quotation marks Case Insensitivity in Commands In command names there is no distinction made between upper and low er case letters Telelogic Tau 4 5 User s Manual 2883 Chapter 60 The Targeting Expert Some more Detailed Description of Parameter Types 2884 lt flagname gt Allowed flag names depend on the SDL to C compiler in use For Cadvanced a description of allowed flags can be found in section Some Configuration Macros on page 3078 For Cmicro see Compilation Flags on page 3394 in chapter 67 The Cmicro Library for a more detailed description lt flagname gt parameters are case sensitive lt boolvalue gt Allowed boolean values can be true on and yes which all have the same meaning no matter if written lower case or not The same applies for the values false off and no lt stringvalue gt Any string value is allowed here There is no check at all if the value can be interpreted correctly E g if abc is entered although and in teger value is needed it will not be checked but probably cause a compilation error afterwards lt entry gt Allowed entries dep
18. associated makefile of the selected component Open PDM Parameters lt filename gt The partitioning diagram file lt filename gt will be loaded Open PR Parameters lt filename gt The PR file lt filename gt will be loaded and internally converted into a partitioning diagram model Open SDT Parameters lt filename gt The system file lt filename gt will be loaded and internally converted into a partitioning diagram model Prepend Setting String Parameters lt class gt lt entry gt lt stringvalue gt lt stringvalue gt will be prepended to the current value of lt class gt lt entry gt Qualifier Parameters lt SDL qualifier gt The given lt SDL qualifier gt will be used for building a part of the SDL system Telelogic Tau 4 5 User s Manual July 2003 July 2003 Batch Mode Quit Parameters lt none gt The Targeting Expert exits same as Exit Replace Setting String Parameters lt class gt lt entry gt lt old stringvalue gt lt new stringvalue gt The string lt old stringvalue gt of lt entry gt will be replaced with lt new stringvalue gt Save Settings Parameters lt none gt The modified settings of all the available applications nodes and com ponents will be saved Select Parameters lt application node component gt The entry specified by lt application node component gt in the parti tioning diagram will be selected This step has to be ex
19. before execution placeholder Will be replaced by oe s system directory oe o target directory the one given in the Organizer O ct sub target directory the one calculated depend ing on the selected component and integration ole oO executable name inclusive extension oe H intermediate directory Write Log Parameters lt filename gt All the output to stdout and stderr will also be written into the file lt filename gt Example of a Batch File The following batch file can be used to build a Simulator using the Tar geting Expert batch mode Example 471 Simple batch file Open SDT access sdt select access node component set integration Simulation Telelogic Tau 4 5 User s Manual July 2003 Batch Mode set Compiler Microsoft Generate Code Generate Makefile Make selected Exit Note The items application node and component depend on the par titioning diagram model used July 2003 Telelogic Tau 4 5 User s Manual 2895 Chapter 60 The Targeting Expert Internal 2896 Partitioning Diagram Model File The Targeting Expert needs to know how the SDL system which is used for targeting should be partitioned This is done by using a partitioning diagram model Note The partitioning diagram model will be generated by the Deploy ment Editor for deployed systems into a partitioning diagram model file lt partitioning diagram model gt pdnm
20. below Keyword 2 Meaning of the parameter CompilersUsed The name of a compiler which is used to build the target application must be entered here This line can appear more than once per file to allow the description of more than one compiler CodeGenerator The name of the SDL to C compiler this pre defined in tegration settings are designed for must be entered to the right of this keyword Currently the SDL to C com pilers Cadvanced Cmicro are possible here GenerateAllFiles All the files will be re generated even if the contents have not changed YES or not NO GenerateMakefile The makefile generation should be switched on YES but can of course be switched off by specifying No here GenerateLowerCase The SDL to C compiler should generate all SDL iden tifiers in lower case YES or as defined No GenerateEnvFunctions The SDL to C compiler should generate template envi ronment functions YES or not NO GenerateEnvHeader The SDL to C compiler should generate an environ ment header file YES or not No Generate Prefix All variables will be generated with full prefix Default is YES but can of course be switched off by specifying NO here GenerateSignalNumber The SDL to C compiler should generate a signal num ber file YES or not No GenerateSDLCoder The SDL to C compiler should generate an SDL coder functi
21. default Include Enter the compiler option needed to specify include paths and the include paths themselves here The complete contents of this entry will replace the entry 1 in the Options see above The include path can contain the following environment variables The environment variables will be expanded during the make exe cution Variable Path it points to sdtdir lt installationdir gt sdt sdtdir lt plat form gt as long as Library directory is not set 2858 Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow Variable Path it points to scttargetdir Absolute path to the current target directory de pends on the selected component sctobjdir scttargetdir the relative path selected in Object directory T sctuseinclude sdtdir INCLUDE Cadvanced only sctincludedir sdtdir cmicro include Cmicro only sctkerneldir sdtdir cmicro kernel Cmicro only scttesterdir sdtdir cmicro tester Cmicro only Comm Include The compiler option needed to specify include paths and the include paths to the coder library must be given here Only used if the ASN 1 and or SDL coder functions are generated and used e Obj extension Enter the object extension to be used for the compiler output If only the information up to here is specified in this dialog each C file is compiled in one single step as shown in Figure 5
22. duty Note The communications link source code has to be set up by the user Value List Add a Flag Taking a List of Values x Name Macro List of possible values separated by lt return gt Default value Cancel Help Figure 512 Add a flag taking a list of values e Name The name is used for identification purposes in the Targeting Expert user interface e Macro The macro will be used for scaling purposes in the target library It must fitto A Za z_ A Za z0 9_ e List of possible values Enter a list of all allowed values the macro can take Each entry has to be delimited by lt returns gt Default value Enter the default value which must be one of the possible values entered above Telelogic Tau 4 5 User s Manual July 2003 Interactive Mode July 2003 When you click Add this value list is added to the communications link you entered in the dialog in Figure 511 on page 2843 Text Value Flag S Add a Flag Taking Text Eg Name a Macro oe Lower limit int ict i Upper limit int CY Default value ee Cancel Help Figure 513 Add a flag taking text Name The name is used for identification purposes in the Targeting Expert user interface Macro The macro will be used for scaling purposes in the target library It must fit to A Za z_ A Za z0 9_ Lower limit Enter the lower limit if the value given with this macro is an integer v
23. entries function to set contents Tool Set Setting String Global allowed entries function to set contents AddObjectExtension Set Setting String CodeGenerator Set Setting String ExecutableExtension Set Setting String FileNamePrefix Set Setting String FullSeparation Set Setting Bool GenerateASNCoder Set Setting Bool GenerateEnvFunctions Set Setting Bool GenerateEnvHeader Set Setting Bool GenerateIfcChannels Set Setting Bool GeneratelfcLiterals Set Setting Bool GeneratelfcOperators Set Setting Bool GeneratelfcSignals Set Setting Bool GeneratelfcSynonyms Set Setting Bool GeneratelfcTypedefs Set Setting Bool Telelogic Tau 4 5 User s Manual July 2003 July 2003 Batch Mode allowed entries function to set contents GenerateInstanceInfo Set Setting Bool GenerateLowerCase Set Setting Bool GenerateMakefile Set Setting Bool GenerateSDLCoder Set Setting Bool GenerateSignalNumber Set Setting Bool IfcPrefixChannels Set Setting String IfcPrefixLiterals Set Setting String IfcPrefixSignals Set Setting String IfcPrefixSynonyms Set Setting String IfcPrefixTypes Set Setting String LibraryDirectory Set Setting String MakefileGenerator Set Setting String MakefileName Set Setting String PreCompile Set Setting String PreMake Set Setting String PostLink Set Setting String ObjectDirectory
24. input file s extension for the C parser e Assembler 2860 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow The third step to process is the execution of the assembler Enter the name of the assembler application here Options Assembler Enter the options given to the assembler as command line argu ments here Enter the placeholder s where the input file name of the file to be assemble has to be inserted used for the makefile genera tion Enterthe dummy parameter o where the output file s name has to be inserted used for the makefile generation Input Extension Assembler The input file s extension used by the assembler has to be specified in this edit line Source Files All the files except the coder and the generated files which will be compiled and linked to the target executable are listed here r Used kermel and library files List of files sctkemeldir mk_main c sctkermeldir mk_outp c sctkemeldir mk_queu c sctkerneldir mk_sche c lt sctkemeldir mk_tim1 c sA sctkemeldir sctpred c hodity a env c mk_cpu c xl Clear Used SDL Target Tester files e sctkemeldir ml_buf c scttesterdir mt_cmd c scttesterdir mt_cod c scttesterdir mt_deb c aero scttesterdir mt_opt c Bete scttesterdir mt_tsdl c Modify scttesterdir mt_tsys c mg_dl c Clear List of files Figure 5
25. not selected this section will be generated define xmk_OPT_INT integer The compiler supports variables stored in registers Ifselected this section will be generated undef X_REGISTER define X_REGISTER register If not selected this section will be generated undef X_REGISTER define X_REGISTER e The compiler is able to handle the C keyword lt const gt in the correct way Ifselected this section will be generated undef XCONST define XCONST const If not selected this section will be generated undef XCONST define XCONST e Target platform offers OS functions Ifselected this section will be generated define XMK_USE_OS ENVIRONMENT T If not selected this section will be generated undef XMK _USE_OS_ENVIRONMENT e Critical paths Enter the commands which are needed to have critical paths i e how to disable and enable interrupts 2840 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Interactive Mode Note All the commands you enter will be copied in to user_cc h If there is more than one line of source code each line must end with aV because the compiler s preprocessor depends on it e no more memory action Enter the action e g a function call to process if no more memory can be allocated Kernel exit Enter the function call to process if the kernel should be exited DE fault is exit Include paths
26. runtime Under normal circumstances this file does not need to be modified However there might be the need to ex tend the Targeting Expert functions Please see the following sub sections for more information what can be configured e Compiler Error Descriptions e Preprocessor Commands e Make Applications e C Options e Debug Options e Compiler Dependent Defaults e Restricted Compilers e Editor Commands e Additional Files e Host Configuration Options used for Cmicro only Search Order for sdttaex par The following shown search order applies when the Targeting Expert is started The distributed version of sdttaex par is always placed in lt installationdir gt bin lt platform gt bin July 2003 Telelogic Tau 4 5 User s Manual 2925 Chapter 60 The Targeting Expert procedure Search_order_on_UNIX E Yes Read mp HOME telelogic sdttaex pa Success N Yes Read telelogic bin splatform bin sdttaex par Q Figure 542 Search order for sdttaex par on UNIX 2926 Telelogic Tau 4 5 User s Manual July 2003 Example 481 COMPILER ERROR D COMPILER ERROR 1 1 i a 1234567890 cl bec32 cc166 gcc July 2003 mn 2 1 mt a Internal procedure Search_order_in_Windows HOME No Yes Read Read HOME telelogic sdttaex pal lt installationdir sdttaex par Success No Yes Read
27. system then the simplest possible partitioning diagram model looks like the one shown in Figure 538 Partitioning Diagram Model O application O node Figure 538 A possible partitioning diagram model The first few lines of the corresponding partitioning diagram model file is shown in Example 472 Example 472 Partitioning diagram model file TIMESTAMP 948787119 APPLICATION 0 access detail SystemFileName access sdt NODE 1 node COMPONENT 2 component July 2003 Telelogic Tau 4 5 User s Manual 2897 Chapter 60 The Targeting Expert 2898 OBJECT 3 object detail Qualifier access Explanations The TIMESTAMP entry is needed for future implementations The APPLICATION 0 access gives the name of the used SDL sys tem The 0 is used as an identifier for internal purposes detail SystemFileName is the name of the used lt system name gt sdt file detail PRFileName is the name of the used lt systemname gt pr file Subsequent entries of detail PRFileName can be used to in sert more than one PR file NODE 1 node specifies that the following components belong to the node The node is called node and the unique id 1 is used for internal purposes COMPONENT 2 component specifies that the following objects belong to this component The component is called component and the unique id 2 is used for internal purposes OBJECT 5 object gives one further object which will be assigned to th
28. vms vms_check c vms vms_export c vms vms_print c TCP IP FILES SctTCPIPDIR tcpipcomm c Note The TESTER FILES and TI TESTER FIL ES only apply for the Cmicro SDL to C compiler The TCP IP FILES only applies for the Ca compiler Host Configuration Options dvanced SDL to C The host configuration options are the default host configurations for different compilers when using the Target Tester only used for Cmicro applications An example c Example 490 HOST CONFIGURATION OPTIONS HOST CONFIGURATION OPTIONS bec32 UNIT NAME sec bec32 UNIT SCALE T OM bec32 LENGTH CHAR im bec32 LENGTH_SHOR 2 bec32 LENGTH _INT 4 bec32 LENGTH LONG 4 bec32 LENG H FLOA 4 bec32 LENGTH DOUBLE 8 bec32 LENG H POINTER 4 bec32 ALIGN CHAR 8 bec32 ALIGN SHORT 8 bec32 ALIGN INT 8 bec32 ALIGN LONG 8 bec32 ALIGN FLOAT 8 bec32 ALIGN DOUBLE 8 bec32 ALIGN POINTER 8 bec32 ENDIAN CHAR 1 bec32 ENDIAN SHORT 21 bec32 ENDIAN_ INT 41 bec32 ENDIAN LONG 41 bec32 ENDIAN FLOAT 41 bec32 ENDIAN DOUBLE 81 bec32 ENDIAN POINTER 41 Telelogic Tau 4 5 User s Manual i e these options are an be found below Borland compiler 2933 Chapter 60 The Targeting Expert External Makefile Generator General As itis probably necessary for you to modify the layout of the generated makefile the source code of the exter
29. which will be necessary to invoke the download application You can use the placeholder t which will automatically be replaced by the name of the target exe cutable s name including the full path Note The selected download application will automatically be started if make was successful The Targeting Expert does not try to invoke a download application if Use download application is un checked Test Application There are two kinds of test applications The applications that are part of the SDL suite i e The SDL Simulator on page 2061 The SDL Validator on page 2229 and The SDL Target Tester on page 3507 The applications from other vendors e g a debugger or emula tor If you select Other you have to enter also the complete command line for the desired test tool You can use the placeholder t which Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow will automatically be replaced by the target executable including the full path Make the Component The whole make process consists of several different tasks which will automatically be executed one after another These tasks are e Analyze and Generate Code e Generate a Makefile e Compile and link e Execute target application or the application in Download Applica tion and or Test Application The execution of the next task will be stopped if the current task returns with an error The Targe
30. 2 Supported compiler On Sun Sun GNU gcc Sun Workshop CC On HP HP GNU gcc HPaCC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Has to be implemented by the user Template files Taken from sdtdir cmicro template More help The target is executed as the SDL Target Tester s gateway After acomplete make The SDL Target Tester will be started and the tar get can be tested Syntax of the its Files There is a more or less complex syntax to be followed in its files which will be described here In principle each its file is divided into four sections e The Description about the Settings e The Settings which are once more split into the Global Settings A the Compiler specific Definitions e The Configuration Settings to Be Set e The Configuration Settings to Be Reset You can find further syntax information in Comments and empty Lines on page 2920 and Other Rules on page 2921 Telelogic Tau 4 5 User s Manual July 2003 Internal Description about the Settings The Targeting Expert will read in the description and display it in the user interface whenever a set of pre defined integration settings is se lected
31. 23 source C file lt lt extension is fixed c compiler execution object file lt ______ _ _ file extension is object extension Figure 523 Single step compilation model For some target compilers compilation is done in three steps using three different tools If that is the case the compilation of each C file is July 2003 Telelogic Tau 4 5 User s Manual 2859 Chapter 60 The Targeting Expert done like shown in Figure 524 In this case the following entries also need to be given source C file q extension is fixed c compiler execution input file for C parser file extension is C parser input extension C parser execution input file for assembler lt q file extension is assembler input extension assembler execution object file lt ____ _ file extension is object extension Figure 524 Three step compilation model e C parser name The name of the C parser application has to be given here e Options C parser Enter the options given to the C parser as command line arguments here Enter the placeholder s where the input file name of the file to be parsed has to be inserted used for the makefile generation Enterthe dummy parameter o where the output file s name has to be inserted used for the makefile generation e Input extension C parser Enter the
32. 25 Source files used Telelogic Tau 4 5 User s Manual 2861 Chapter 60 The Targeting Expert 2862 e Used kernel and library files and Used SDL Target Tester files Cmicro only Default Restores the default values Add A file selection dialog is opened where you can select the file which should be added to the list of kernel files Remove Removes the item you have selected in the list box Modify A dialog pops up and the selected entry can be modified Clear Deletes all the items in the list box Compiler Flag Note This section is only available if the Advanced Mode is selected and the SDL to C compiler Cmicro is used When compiling the generated code and or the SDL to C compiler s li brary you need to set a compiler flag to adjust the code The list of available compilers shown in Figure 526 belongs to the Cad vanced target library Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow Workstation Compiler C GnuC compiler for nearly all UNIX compilers ce compiler for HP UX r PC Compiler Microsoft C compiler C Borland C compiler r Microcontroller Compiler TMS320 compiler for MSP 58C80 icc12 for Motorola BSHC12 Archimedes IAR compiler for 8051 derivatives Archimedes lAR compiler for Melps 7700 Archimedes IAR compiler for Hitachi 6301 Franklin Keil compiler for 8051 derivatives Franklin Keil compiler for 80166 derivatives GNU c
33. Add Communications Link Remove Communications Link Edit Makefile A text editor is displayed where you can modify the generated makefile Edit Configuration Header File A text editor is displayed where you can modify the generated con figuration header file Edit Environment File A text editor is displayed where you can modify the generated envi ronment C file Make Menu The Make menu allows to control the make process of the Targeting Ex pert Analyze The selected integration will be analyzed Generate code C code will be generated for the selected integration Make all All the configured components will be made again Clean Telelogic Tau 4 5 User s Manual July 2003 July 2003 The Graphical User Interface All the object files in the object directory will be removed Tools Menu The Tools menu gives access to other Telelogic Tau tools Show Organizer The Organizer main window is displayed Load SDL System The partitioned SDL system that is currently worked on in the Tar geting Expert can be loaded into the Organizer Use this entry if the Targeting Expert main window is displayed after the execution in the batch mode has failed Utilities gt DOS to UNIX It is possible to specify a list of ASCII files All the files in this list will be converted from DOS to UNIX style See DOS to UNIX on page 2935 Utilities gt UNIX to DOS It is possible to specify a list of ASCII files All the f
34. CC On HP HP GNU gcc HPcc HPaCcC In Windows Borland C Microsoft VC Used kernel directory 2904 Telelogic Tau 4 5 User s Manual July 2003 Internal Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Will be handled in the Simulator UI More info See chapter 50 The SDL Simulator e Performance Simulation perfsim Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HPaCcC In Windows Borland C Microsoft VC Used kernel directory Timers Not handled Environment Not handled More info See chapter 64 The Performance Library e TTCN Link Supported compiler On Sun Sun GNU gcc Sun Workshop cc On HP HP GNU gcc cc In Windows Borland C Microsoft VC Used kernel directory sdtdir SCT TTCNLINK Telelogic Tau 4 5 User s Manual 2905 Chapter 60 The Targeting Expert More info See chapter 36 TTCN Test Suite Generation e Validation Supported compiler On Sun Sun GNU gcc Sun Workshop cc On HP HP GNU gcc HPcc In Windows Borland C Microsoft VC Used kernel directory sdtdir SCT VALIDATOR M
35. Chapter 60 July 2003 The Targeting Expert When doing targeting there is a lot of information to be provided for instance how to generate the C source code how to configure the SDL to C compiler which compiler to be used etc The Targeting Expert is a tool managing the complete process of targeting for the Cadvanced and the Cmicro SDL to C compilers only The easiest way to get an executable from an SDL specification just generate C code for a complete SDL system compile and link the executable is as well supported as more complex cases Therefore there are several Pre defined Integration Settings which are ready to use Furthermore the Targeting Expert is able to re use the deploy ments done in the Deployment Editor see The Deployment Edi tor on page 1705 in chapter 41 The Deployment Editor and to con figure any single option thinkable in the process of doing targeting with Telelogic Tau Those options can be the SDL to C compiler s options the compiler linker and make tool options for example After all this chapter is a description of the Targeting Expert Inter active Mode and a reference for the Batch Mode A list of FAQs frequently asked questions can be found at the end of this document Telelogic Tau 4 5 User s Manual 2827 Chapter 60 The Targeting Expert Introduction The Targeting Expert assists you in setting up and configuring a com plete target application A sub set of the Tar
36. Dependancies Default Figure 527 Additional compiler configuration Compiler Name Enter the name of the compiler application Options Enter the options given to the compiler as command line arguments here Enter the placeholder s where the source file name of the file to be compiled has to be inserted used for the makefile genera tion Enterthe dummy parameter o where the object file s name has to be inserted used for the makefile generation Enter the dummy parameter I where the include path option has to be placed see below Include Enter the compiler option needed to specify include paths and the include paths themselves here The complete contents of this entry will replace the entry 1 in the Options see above Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow e Obj extension Enter the object extension to be used for the compiler output e List of files Default Restores the default values Add A file selection dialog is opened where you can select the file which should be additionally compiled Remove Removes the item you have selected in the list box Modify A dialog is displayed and the selected entry can be modified Clear Deletes all the items in the list box e Dependencies List the dependencies for the makefile here Note that the name of the additional file itself is automatically generated as a dependency Linker To link all the compiled f
37. IONS Sun GNU gcc Sun Workshop cc Sun Workshop CC HP GNU gcc HP cc Microsoft Borland icc12 ie acc DEBUG mna aaan tot Q_ UNAaaaagaaga Pe ee as a a i Each line consist of the three entries 1 compiler name 2 compiler command line option 3 linker command line option Compiler Dependent Defaults The compiler dependent defaults ease the implementation of new pre defined integrations because the values given here do not need to appear again in the its file s Example 486 comPILER DEPENDENT DEFAULTS COMPILER DEPENDENT DEFAULTS bcc32 f Borland DIC86 o 0 s e e L 0 tlib obj exe lib l C E P256 0 I sctCODERDIR bcc_obj Borland make using temporary response file ae ae a rw Q_gaAangagaNga ee M eee ion Gc Q I c w DUSING DLL The different entries mean the following listed from left to right MDA R WN 2930 Compiler name Compiler tool name Linker tool name Library manager name Object file extension Executable file extension Library file extension Telelogic Tau 4 5 User s Manual July 2003 July 2003 Internal 8 Compiler options 9 Linker options 10 Library Manager Options 11 Coder include path 12 Relative path to intermediate directory 13 make application to use per default Restricted Compilers There are a few target compilers which do not support file names which are longer that 8 3
38. Manual July 2003
39. Manual July 2003 July 2003 Batch Mode The Targeting Expert exits same as Quit Generate Code Parameters lt none gt A code generation for the selected component is done using the SDL to C compiler selected in the associated settings Generate Code Full Parameters lt none gt A full code generation for the selected component is done using the SDL to C compiler selected in the associated settings Generate Makefile Parameters lt none gt A makefile will be generated for the selected component The make file s name is taken from the associated settings Get Setting Parameters lt class gt lt entry gt The current contents of lt entry gt will be printed on the screen Include Parameters lt batch filename gt All the commands listed in lt batch filename gt will be processed Help Parameters lt none gt A list of all commands with their needed parameters is printed Make All lt none gt For the application or all the nodes and components that are configured combined or separate configuration the steps of analysis code gener ation makefile generation and compilation linkage will be performed Telelogic Tau 4 5 User s Manual 2889 Chapter 60 The Targeting Expert 2890 Make Clean Parameters lt none gt All the object files will be removed Make Selected Parameters lt none gt The make tool will be executed using the associated make tool and the
40. alcul _O HostSimulation__CLEN _ ml_mcf Generating lt K calcul _O HostSimulation__CLENV_ ml_mcf h gt OK Figure 506 The event log Analyzer Compiler Errors You can access analyzer and compiler errors by double clicking the er ror message in the event log e Incase of an analyzer error the SDL Editor is displayed with the er roneous SDL symbol highlighted e Incase of a compiler error the selected editor is displayed with the erroneous line highlighted Note 1 the selected editor must be able to highlight the desired line It has to be selected in the Customization of the Targeting Expert Note 2 the compiler s error message syntax must be described in the Compiler Error Descriptions section in file sdttaex par for the compiler used July 2003 Telelogic Tau 4 5 User s Manual 2835 Chapter 60 The Targeting Expert Interactive Mode 2836 You can use the Targeting Expert interactive mode to achieve different targets to e Build an un configured or optimized target executable by following the steps described in Targeting Work Flow on page 2852 e Configure the distributed Telelogic Tau release and handle the al ready done settings Please see below Although most of the steps in targeting are supported in the Targeting Work Flow you sometimes need access to other functionality for exam ple e Compiler Definition for Compilation to the target library s known compilers e Communications L
41. alue Upper limit Enter the upper limit if the value given with this macro is an integer value Default value The default value of the macro in this edit line has to be between the lower and upper limit if it is an integer value Of course it is possi ble to enter an alphanumeric value here too Telelogic Tau 4 5 User s Manual 2845 Chapter 60 The Targeting Expert When you click Add this value list is added to the communications link you entered in the dialog shown in Figure 511 on page 2843 Remove To remove a communications link from the private c_conf def file select Remove a communications link from the Edit Menu Remove a communications link x CommLink name CommLink name m o Use Cmicro Postmaster commut Use Lauterbach Emulator comn Use 24 communication Cancel Help Figure 514 Remove a communications link Handling of Settings General The integration tool bar on the main window offers four buttons to han dle the settings i e the way settings are stored and where they are taken from can be influenced l HostSimulation uis y A Figure 515 Integration tool bar in the main window Note The settings addressed in this section are only compiler linker and make settings The configuration of the SDL to C compiler library is not touched After selecting pre defined integration settings the Targeting Expert au tomatically creates a file called lt integratio
42. ar with the Targeting Expert functionality In Batch Mode The command line mode is also called Batch Mode Please see the ap propriate sections for a more detailed description Possible command line options are taexbatch v h yes no Option Relevance V The version number is printed to stdout and the appli cation exits h Information about the usage is printed to stdout and the application exits yes All the questions that probably come up will be an swered with yes no All the questions that probably come up will be an swered with no For more information about the commands allowed in a batch file see Description of Batch Mode Commands on page 2887 July 2003 Telelogic Tau 4 5 User s Manual 2829 Chapter 60 The Targeting Expert The Graphical User Interface This section describes the appearance and functionality of the graphical user interface of the Targeting Expert sdttaex Some user interface de scriptions common to all tools in Telelogic Tau can be found in chapter 1 User Interface and Basic Operations The Main Window When you start the Targeting Expert in the interactive mode its main window is displayed ol x S SDL Targeting Expert X Calcul system calcul sdt Menu bar Fie Edt Make Tools Help A Mien AL BS al 7o Integration ___ p HostSimulation CLENY B Cmicro gt
43. arget Sub Directory Structure Where can I add my own macro definitions There is a manual configuration file written for each integration It is called sct_mcf h for Cadvanced and ml_mcf h for Cmicro This header file is included in the SDL to C compiler s library dur ing compilation and contains a section where you can insert your own macro definitions The section begins with BEGIN User Code and ends with the line END User Code All the text given between both lines will be saved if the manual configuration file is re generated Caution The manual configuration file sct_mcf h for Cadvanced is includ ed only if the flag USER_CONFIG is set This can be done in most cases by defining DUSER_CONFIG in the compiler options How can I modify the value of sdtdir in the generated make file Per default the value of sdtdir is set to lt installationdir gt sdt sdtdir lt platformsdtdir gt In some cases itis probably necessary to get the library files from another di rectory In this case you can modify the Library Directory in the Make dialog The sub directory structure must be the same as given under lt installationdir gt sdt sdtdir lt platformsdtdir gt How can I modify the configuration flags that are disabled in the Targeting Expert user interface Telelogic Tau 4 5 User s Manual July 2003 July 2003 FAQs The Targeting Expert can be customized in a way so that the config urat
44. arget executable is built for a micro controller In this case you can select a download application or any other test tool e g debugger which will be executed instead Please see Download Application on page 2880 and Test Application on page 2880 Hint For running test cases the target executable s output to stdout and stderr will be re directed automatically into the Targeting Expert event Log The target simply should be executed by entering st as the test application Please see Test Application on page 2880 Telelogic Tau 4 5 User s Manual July 2003 Batch Mode Batch Mode July 2003 Using the Targeting Expert in the batch mode means starting taex batch instead of sdttaex The commands have to be given one after another by hand or in a com mand file Please see an Example of a Batch File In this case the Tar geting Expert has to be started with taexbatch lt commandfile Note If the commands are given in a command file the Targeting Expert should be started with one of the options yes or no to answer all upcoming questions automatically Otherwise the application will probably hang up Syntax of Batch Mode Commands Command Names You may abbreviate a command name by giving sufficient characters to distinguish it from other command names A hyphen is used to sep arate command names into distinct parts Abbreviation of Commands You may abbreviate any part
45. brary configuration It is not guaranteed that it will work for all kinds of modifications Telelogic Tau 4 5 User s Manual 2851 Chapter 60 The Targeting Expert Targeting Work Flow 2852 Introduction You can start the Targeting Expert form the Organizer s Generate menu when having a deployment diagram the SDL system or a block process of the SDL system selected Estimated the SDL system is selected the Targeting Expert converts the system into a default partitioning diagram model deployment dia gram This is done because the Targeting Expert can only handle par titioning diagram models as an input The tree window shown in Figure 519 gives an idea how the default partitioning diagram model looks like m Partitioning Diagram Model O application Figure 519 Partitioning diagram in the Targeting Expert The different entries have got the following meaning application This is the collection of all the deployed SDL systems It is used as an object to allow configurations of several nodes only i e it is not possible to make an application node A node symbolizes an instance of the platform computa tional resource that components execute on i e it is not possible to make a node component A component is interpreted as an executable program Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow July 2003 I e an applica
46. c Tau 4 5 User s Manual July 2003 July 2003 Batch Mode e Threaded Integrations OSE Solaris VxWorks POSIX Linux Win32 e Tight Integrations OSE Solaris VxWorks Win32 Note To set a Realtime Simulation for example the lt integration gt has to be given in quotation marks i e Set Integration Realtime Simulation Caution In batch mode there is no check if the selected integration fits to the component settings Please have a look to Distributed Pre defined Integration Settings on page 2904 for more information The command Select has to be executed before Set Setting Bool Parameters lt class gt lt entry gt lt boolvalue gt The boolean lt entry gt will be set to its new value Set Setting String Parameters lt class gt lt entry gt lt stringvalue gt The non boolean lt entry gt will get the new content lt stringvalue gt Start Download Parameters lt none gt Telelogic Tau 4 5 User s Manual 2893 Chapter 60 The Targeting Expert 2894 The download application selected in Download Application will be in voked Start Testtool Parameters lt none gt The test application specified in Test Application will be invoked system Parameters lt systemcommand gt Executes the lt systemcommand gt on the underlying OS The following placeholders can be used in lt systemcommand gt and will be replaced
47. case the new its file is stored in the same directory as the lt systemname gt sdt file This has the advantage that all users working on the system can access the pre defined integration e Export pre defined integration as user settings The its file is stored in the lt installationdir gt in Windows or respectively the SHOME telelogic directory on UNIX This has the advantage that other users do not see all the new pre defined integration settings In the second dialog a list of template files which have to be copied into the target directory can be specified As default the list of files from the parent settings will be given Modify the list to your needs Directly after exporting the settings they can be used for further configurations Note The sections Configuration Settings to Be Set and Configuration Settings to Be Reset are not exported Telelogic Tau 4 5 User s Manual 2849 Chapter 60 The Targeting Expert 2850 Customization The Targeting Expert interactive mode can be customized After select ing the Customize entry in the Tools Menu the dialog shown in Figure 518 pops up r Text Editor Select the editor i e the editor command to use Z filename and I line Targeting Expert s editor Tau Text Editor TextPad UltraEdit Codewright MS DeveloperStudio ftextpad ca q F 1 0 r Advanced Mode I Work in advanced mode in Reset automatic saves ro modified dialog eeece
48. compiler On Sun Sun GNU gcc Sun Workshop CC On HP HP GNU gcc HPaCC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are not implemented i e a timer set in the SDL system will never expire Telelogic Tau 4 5 User s Manual July 2003 Internal Environment Will be handled in the SDL Target Tester UI Template files Taken from sdtdir cmicro template More info The target is executed as the SDL Target Tester s gateway After a complete make The SDL Target Testerwill be started and the tar get can be tested e Real time Host Simulation debclcom Supported compiler On Sun Sun GNU gcc Sun Workshop CC On HP HP GNU gcc HPaCcC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Will be handled in the SDL Target Tester UI Template files Taken from sdtdir cmicro template More help The target is executed as the SDL Target Tester s gateway After a complete make The SDL Target Tester will be started and the tar get can be tested e Real time Host Simulation with environment debclenvcom July 2003 Telelogic Tau 4 5 User s Manual 2911 Chapter 60 The Targeting Expert 291
49. ction into the env header file YES or not NO depends on GenerateEnvHeader GeneratelIfcChannels The SDL to C compiler should generate the CHANNELS section into the env header file YES or not NO depends on GenerateEnvHeader July 2003 Telelogic Tau 4 5 User s Manual 2915 Chapter 60 The Targeting Expert Keyword 2 Meaning of the parameter IfcPrefixSynonyms The SDL to C compiler will generate SYNONYMS us ing the specified rule Default is n IfcPrefixLiterals The SDL to C compiler will generate SYNONYMS us ing the specified rule Default is sn IfcPrefixTypes The SDL to C compiler will generate SYNONYMS us ing the specified rule Default is sn IfcPrefixSignals The SDL to C compiler will generate SYNONYMS us ing the specified rule Default is sn IfcPrefixChannels The SDL to C compiler will generate SYNONYMS us ing the specified rule Default is n SuppressText The Analyzer error or warning message to suppress can be given here e Compiler specific Definitions This segment has got all the definitions for an unlimited amount of com pilers All the keywords start with lt name of the setting gt lt compiler name gt followed by one or two further keywords If it is followed by two key words both are separated by Example 477 Pre defined integration settings 3 Simulation Microsoft Compiler Tool el Simulation Microsoft Compile
50. ded to find it The regular expression to determine the line number 7 The amount of characters thrown away at the beginning of the found line In this example the colon at the front of the regular expression does not belong to the line number but is needed to find it 8 The amount of characters thrown away at the end of the found line In this example the colon at the end of the regular expression does not belong to the line number but is needed to find it eae D Preprocessor Commands This section takes the preprocessor commands for all the default com pilers that can be set in the preferences It has got the following con tents Example 482 PREPROCESSOR COMMANDS PREPROCESSOR COMMANDS Sun GNU gcc gcc P E C Sun Workshop cc cc C P Sun Workshop CC CC E HP GNU gcc gcc P E C HP cc cc C P HP acc acc E Microsoft cl P EP C nologo Borland cpp32 P Make Applications The section MAKE APPLICATIONS of sdttaex par is used to spec ify the command line of the make application i e how it will be in voked Telelogic Tau 4 5 User s Manual July 2003 Internal Example 483 MAKE APPLICATIONS MAKE APPLICATIONS Borland make make f Borland make ignore exit codes make i a Borland make using temporary response file make as amp amp n t n Microsoft nmake nmake Microsoft nmake ignore exit codes nmake i Microsoft nmak
51. e Cancel Help Figure 518 Customize dialog Text Editor The text editor which should be opened to edit or view text files can be selected here The list of supported editors depends on the platform the Targeting Expert is running on Windows UNIX It can be modified or extended in the file sdttaex par Please see Parameter File sdt taex par on page 2925 Advanced Mode The advanced mode allows you to e do more configurations than possible in the non advanced mode See More Configurations on page 2851 for more information e switch between different dialogs without using the Cancel or Save button e start the code generation automatically when selecting a new inte gration Telelogic Tau 4 5 User s Manual July 2003 July 2003 Interactive Mode configure all compilers Even the ones that are not available on the used platform More Configurations Normally there is no need to modify the compiler flag if using a pre defined integration but in the advanced mode the Compiler Flag can be modified The standard pre defined integrations do not allow you to use all the configuration options in the Configure and Scale the Target Library dialog disabled If the advanced mode is switched on it is possible to switch on and off all the options supported by the SDL to C com piler library Caution The pre defined integrations distributed are tested only with the giv en li
52. e If the generated code should be modified before it is compiled an appropriate ap plication complete command line should be entered here PostLink If the linked target application needs to be modified e g conversion into HEX format the appropriate application complete command line should be en tered here AddCompiler Tool For the additional files see FilesToCompile the name of the com piler application must be entered here AddCompiler Options The command line options for the com piler in Addcompiler must be specified here AddCompiler Include The compiler s option for include paths and the include paths for the compiler entered in AddCompiler AddCompiler Depend The dependencies for the additional files used inside of the generated makefile AddoObjectExtension The object extension of the Addcompil er must be entered here AddFilesToCompile Kernel files to be compiled e g commu nications link This entry can be used more than once July 2003 Telelogic Tau 4 5 User s Manual 2919 Chapter 60 The Targeting Expert 2920 Default Configuration Settings For several pre defined integrations it is necessary to have some config uration flags defined as default In this section a simple list of all con figuration flags which should be set is given This section starts with CONFIGURATION DEFAULT Please see Configuratio
53. e Routing header file router h w Routing source file w Server configuration Server port number 5000 Default Cancel Help Figure 534 TCP IP communication wizard As described in the dialog there are settings done in different sections of the Targeting Expert the manual configuration file sct_mcf h the list of source files to compile i e the makefile Furthermore the generation of an Environment header file Environment functions and SDL coder functions will be switched on 2878 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow Caution If the TCP IP communication is switched on a routing source file has to be provided so that the signals destination can be calculated correctly Otherwise all the signals will be sent to the sending appli cation Caution If the TCP IP communication is switched off the routing source file needs to be removed from the list of source files to compile by hand Env Header File gt Environment header file generation options The rules to generate names in the environment header file can be specified here The placeholder n represents the name of the item and cannot be removed j esents the scope of the item en Default IV Generate section LITERALS fen Default IV Generate section TYPEDEFS n Default IV Generate section OPERATORS IV Generate secti
54. e using temporary response file nmake f lt lt n t n lt lt Tasking mk166 mk166 f Tornado make make f UNIX make make f July 2003 Each line is the description for one make application The four entries given between and have the following meaning 1 The text to identify it in the make configuration See Make tool on page 2869 2 The name of the make application and the option used to specify the makefile 3 This is the start sequence for the generation of temporary response files Empty for most make applications 4 This is the stop sequence for the generation of temporary response files Empty for most make applications C Options The C options specify what has to be added to the compiler s Options and the linker s Options to compile and link the SDL to C compiler s library as C code Example 484 Cc OPTIONS C OPTIONS Sun GNU gcc xc lstdc HP GNU gcc fer lstdc Microsoft Borland hae Each line consist of the three entries 1 compiler name 2 compiler command line option 3 linker command line option Telelogic Tau 4 5 User s Manual 2929 Chapter 60 The Targeting Expert Debug Options The debug options specify what has to be added to the compiler s Op tions and the linker s Options to compile and link the target application including debug information Example 485 D EBUG_OPTIONS DEBUG OPT
55. e WIND_BASE has to be set on your system Win32 OSE Softkernel Solaris Note OSE only The environment variable OSE_ROOT has to be set on your system Telelogic Tau 4 5 User s Manual 2907 Chapter 60 The Targeting Expert Supported compiler OSE Sun GNU gcc Microsoft VC Solaris Sun GNU gcc Sun Workshop cc Sun Workshop CC VxWorks Tornado ccsimpce Tornado ccsimso Win3 Microsoft VC Used kernel directory Timers OS timer More info See Threaded Integration on page 3225 in chapter 65 Integration with Operating Sys tems e Tight integrations for the platform OSE Softkernel Win32 Note OSE only The environment variable OSE_ROOT has to be set on your system Solaris VxWorks Softkernel Win32 Note VxWorks only The environment variable WIND_BASE has to be set on your system Win32 Supported compiler OSE Microsoft VC Solaris Sun GNU gcc VxWorks Tornado ccsimpc Win3 Microsoft VC 2908 Telelogic Tau 4 5 User s Manual July 2003 Internal Used kernel directory OSE sdt sdtdir RTOS OSEDelta Solaris sdt sdtdir RTOS Solaris VxWorks sdt sdtdir RTOS VxWorks Win32 sdt sdtdir RTOS Win32 Timers OS timer More info See Tight Integration on page 3249 in chapter 65 Integration with Operating Sys tems
56. e current component detail Qualifier access means that all the SDL entities that are sub entities of the qualifier access in this case the complete sys tem will be part of the object More Supported Keywords Details of COMPONENT detail Integration Light Threaded Tight specifies in which integration model the component should be build For back wards compatibility the keyword ThreadedLight is accepted as an alias for Threaded Telelogic Tau 4 5 User s Manual July 2003 July 2003 Internal Details of OBJECT e detail Type system block process tells which kind of SDL agent the qualifier is all about Details of THREAD e THREAD name isa sub entry of COMPONENT and specifies a thread e g for a threaded integration e detail ThreadPriority value specifies the OS priority of the particular thread e detail StackSize value specifies the stack size of the thread bytes e detail QueueSize value specifies the maximum number of signals that are allowed in the queue e detail MaxSignalSize value specifies the maximum size of an individual signal in the queue bytes e detail OneThreadPerInstance true false tells if each pro cess instance will become its own thread in a threaded integration if the value is true Configuration Files For each SDL to C compiler that will be used there is one configuration file ca_conf def Cadvanced and cm_conf def Cmicro The configuration files for all SDL to C c
57. e name of the library manager application Options Enter the options given to the library manager as command line ar guments here Fnter the dummy parameter o in the place of the list of all cod er object files to link used for the makefile generation Enter the dummy parameter 1 in the place where the library s name has to be inserted used for the makefile generation Library extension Enter the library extension here Make You can select the make tool to do all the compile and link actions here Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow m Make tool Make tool Microsoft nmake using temporary response file hd Default m Makefile generation IV Generate makefile Generator intem w Default Makefile eL hostsim m w Default m Makefile generation Parameters Object directory felobi w Default Library directory w Default The placeholder s will be replaced by the component s name c will be replaced by the converter tool file including path Pre make Eee D Default The placeholder s will be replaced by the source file s name including path Pre compile B Default To use the pre processor command as pre compile step press button Pre processor The placeholder s will be replaced by the executable s name including path Past link a ee B Default Figure 530 Make tool configuration Click Defa
58. eader file m1_typ h sct types h beside the output file Put all the lines of the main header file containing include lt gt statements into comments Preprocess the selected generated C file by using the default com piler see Telelogic Tau Preferences Remove all the empty lines in the preprocessed file Run Indent on the preprocessed file Remove all the comments surrounding include lt gt in the preprocessed file Remove the private copy of the main header file Telelogic Tau 4 5 User s Manual July 2003 Utilities Note All the files given with include will be included during the preprocessing e Command line taexutil PREPRO lt inputfile gt lt outputfile gt lt cmd gt lt compiler flag gt lt inputfile gt and lt outputfile gt can be equal but both must be given lt cmd gt is the command line needed to invoke the preprocessor of the default compiler lt compiler_flag gt is the define to select the target compiler Please see Compiler Flag on page 2862 July 2003 Telelogic Tau 4 5 User s Manual 2937 Chapter 60 The Targeting Expert FAQs 2938 How can I set the target directory in the Targeting Expert It is not possible to set the target directory in the Targeting Expert The one given in the Organizer will be used instead To make it pos sible to have different integrations in one target directory the Tar geting Expert creates a T
59. ecuted before you can generate One of the commands Open PDM Open PR or Open SDT has to be ex ecuted before Set Compiler Parameters lt compilername gt The given lt compilername gt will be set as the used compiler The lt compilername gt must be available in the default settings of the Set Integration The command Set Integration has to be executed before Set Flag Bool Parameters lt flagname gt lt boolvalue gt The SDL to C compiler s library flag lt flagname gt will be set reset due to the lt boolvalue gt Telelogic Tau 4 5 User s Manual 2891 Chapter 60 The Targeting Expert Caution There is no check for interdependencies to other flags Set Flag String Parameters lt flagname gt lt stringvalue gt The SDL to C compiler s library flag lt flagname gt will be set to the lt value gt Caution There is no check for upper and lower limits You must be aware to set a value that is in the allowed range Set Integration Parameters lt integration gt The pre defined integration settings lt integration gt will be set e Simulations Performance Simulation Realtime Simulation Simulation TTCN Link e Validations Validation e TargetTest Application DEBUG CA HostSimulation HostSimulation CL HostSimulation CLENV e Light Integrations Application CA Application CM Application TEST 2892 Telelogi
60. end on the class used in the command Please see lt class gt Parameters of type lt entry gt are case insensitive lt class gt Allowed classes and the depending entries are shown in the table be low Parameters of type lt class gt are case insensitive For all allowed combinations of classes and entries the commands Get Setting and Default Setting can be used Compiler Telelogic Tau 4 5 User s Manual July 2003 July 2003 Batch Mode allowed entries function to set contents AsCpp Set Setting String CodInclude Set Setting String FilesToCompile Add Setting String Include Set Setting String LibFlag Set Setting String Options Set Setting String Options2 Set Setting String Options3 Set Setting String TesterFilesToCompile Set Setting String Tool Set Setting String Tool2 Set Setting String Tool3 Set Setting String Linker allowed entries function to set contents LibrariesToLink Add Setting String ObjectsToLink Add Setting String Options Set Setting String Tool Set Setting String AddCompiler Telelogic Tau 4 5 User s Manual 2885 Chapter 60 The Targeting Expert 2886 allowed entries function to set contents AddFilesToCompile Add Setting String Depend Set Setting String Include Set Setting String Options Set Setting String Tool Set Setting String Make allowed
61. ent header file generation cannot be switched off if coder or environment functions are selected d Gnfguration on otter tat r Filter Analyzer output The warning or error message given here will be filtered from the Analyzer output Example WARNING 5 ERROR 300 FO Defauit_ Figure 532 Note Because the Advanced Mode is switched off there might be some controls disabled because it does not make sense to modify them for the selected integration Analyze generate code Switch the Analyzer and SDL to C compiler execution on off when starting the make process Analyzer options The Organizer s Analyzer Options dialog is displayed and the An alyzer options used for all the integrations can be modified Please see Analyze SDL on page 112 in chapter 2 The Organizer Save commands Telelogic Tau 4 5 User s Manual 2875 Chapter 60 The Targeting Expert 2876 A text file containing all the Analyzer commands configured for the selected integration can be saved It is possible to start the Analyzer directly using this command file with sdtsan lt commandfile All files If selected the SDL to C compiler will generate all files anew It does not matter whether the file s contents have changed or not Un selecting it can economize the build process Capitalization lower case When selected all identifiers are translated to lower case Otherwise capitalization is used in the declaration
62. et if the following flags lines 7 and 8 are already defined Not given in the example above is the section VALUE like AUTOSET finished by an END which assign a value to the flag This section can include three lines of information The first gives the default value And if the value is numeric the second line gives the lowest and the third one the highest value You are asked to have a look into c conf def Also not given in the example above is the section VALUE_LIST fin ished by an END which assign a value to the flag with a list of allowed values given The first value is the default value the following values Telelogic Tau 4 5 User s Manual 2901 Chapter 60 The Targeting Expert with no upper limit are giving the list of allowed values The default value must be given in the list again Pre defined Integration Settings Introduction Pre defined integration settings must be seen as a set of default values which can be used for targeting purposes There are several pre defined integration settings distributed with each Telelogic Tau installation e Each set of predefined integration settings is stored in an ASCII file with the extension its e The amount of pre defined integration settings that are to be han dled by the Targeting Expert can simply be enlarged by copying a new file lt name gt its or by exporting own settings See Export on page 2848 e The integration names have to be u
63. geting Expert functionality can be used in Batch Mode when it is only desired to re build the com plete system or just several components Starting the Targeting Expert In graphical Mode Starting the Targeting Expert in the graphical mode means that the user interface is visible and you can directly interact by selecting function and menu items You enter the graphical mode by selecting Targeting Expert in the Or ganizer s Generate menu or by using the following command line op tions sdttaex h v pdm lt partition_diagram gt pdm sdt lt system name gt sdt pr lt systemname gt pr t lt target gt hostsim re alsim sim val makeall Option Relevance V The version number is shown and the applica tion exits h Information about the usage is shown and the application exits pdm lt partition_diagram gt pdm The partitioning diagram file to be used sdt lt systemname gt sdt The system file to be used pr lt systemname gt pr The system s PR file to be used t lt target gt The qualifier of the SDL system s part to build makeint lt integration gt Make the given integration makeall Re make last configuration 2828 More information about the user interface can be found in The Main Window on page 2830 Telelogic Tau 4 5 User s Manual July 2003 Introduction See Interactive Mode on page 2836 to get famili
64. he Orga nizer s Make dialog does When using the Targeting Expert e there is no makefile syst emname m generated by the SDL to C compiler Instead it generates a sub makefile component_gen m which is automatically parsed and inserted into the Targeting Expert makefile i e the Targeting Expert still gets all the information from the SDL to C compiler but in a different way e there is not support of template makefiles by the Targeting Ex pert The makefiles generated by the Targeting Expert can be mod ified directly in the so called user sections Please see User Mod ifications on page 2924 e there are no makeoptions make opt files taken from the ker nel directories used at all Instead of this the Targeting Expert gets all the make information from the Pre defined Integration Settings and places them into its makefile e the comp opt files placed in the kernel directories are not used at all Again all the information is taken from the Pre defined Inte gration Settings e the sccd cannot be used for pre processing purposes as default because the Targeting Expert does not use sccd cfg files from the kernel directories It is recommended to use the Targeting Expert Preprocessor instead Telelogic Tau 4 5 User s Manual 2923 Chapter 60 The Targeting Expert 2924 Note The only exceptions in which the Targeting Expert uses some infor mation from the associated kernel directory are
65. her Rules e Only one set is allowed per its file e The amount of compilers supported for each set is unlimited 39 e Thecharacters and are forbidden in compiler names or the name of the pre defined integration settings itself User defined Integration Settings All the settings done by the user will be stored in separate files into the target directory 1 e e The complete set of settings will be stored not the difference to the defaults e There is one file for each integration configuration done for an ap plication node or component e If several nodes or components have to use the same settings it is possible to manually select one file for them Please see Handling of Settings on page 2846 Target Sub Directory Structure The Targeting Expert automatically sets up a sub directory structure for all the applications nodes and components Furthermore there is a sub directory for each kind of integration done Example 478 Sub directory structure r Partitioning Diagram Model O application Figure 541 Example of a partitioning diagram July 2003 Telelogic Tau 4 5 User s Manual 2921 Chapter 60 The Targeting Expert 2922 Estimated there is a partitioning diagram which looks like Figure 541 the Targeting Expert generates a sub directory structure like lt target_dir gt application 0 node 1 component 2 Note The suffixes _ give uniq
66. iles generated ones the ones building the li brary and additional ones you must configure a linker July 2003 Telelogic Tau 4 5 User s Manual 2865 Chapter 60 The Targeting Expert 2866 m Linker Description Linker name fink B Default The placeholders 0 list of object files L list of libraries and e executable file are allowed Options xo ZL nologo subsystem console OUT e Default Exe extension exe Default Additional object files List of objects Default Add Modify Clear m Additional libraries List of libraries Default Add sdtdir cmicro sdtmpm sdtmpmel lib user32 lib Modify gt Clear Figure 528 Linker configuration Click Default if you want to restore the default values Linker name Enter the name of the linker application Options Enter the options given to the compiler as command line arguments here Enter the dummy parameter o in the place of the list of all compiled files and the additional object files to link used for the makefile generation Enter the dummy parameter L in the place of the list of all the libraries if there are some which have to be linked Enter the dummy parameter e in the place where the execut able file s name has to be inserted used for the makefile gener ation Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow e Exe exte
67. iles in this list will be converted from UNIX to DOS style See UNIX to DOS on page 2935 Utilities gt Indent The indentation of all the ASCII files in the list of files specified by the user will be corrected See Indent on page 2935 Utilities gt Preprocess The list of generated C files that is specified by the user will be pre processes See Preprocessor on page 2936 Wizards gt TCP IP communication A wizard dialog pops up and allows you to configure the TCP IP communication between different components See TCP IP signal sending on page 2877 SDL gt Simulator UI Telelogic Tau 4 5 User s Manual 2833 Chapter 60 The Targeting Expert 2834 This menu choice starts a new empty Simulator UI Several Simu lator UIs may exist at the same time See Graphical User Inter face on page 2130 in chapter 50 The SDL Simulator e SDL gt Validator UI This menu choice starts a new empty Validator UI Several Valida tor UIs may exist at the same time See Graphical User Interface on page 2281 in chapter 53 The SDL Validator e SDL gt SDL Target Tester This menu choice starts a new empty SDL Target Tester UI See Graphical User Interface on page 3562 e Customize A dialog pops up and allows to customize the Targeting Expert See Customization on page 2850 for more details The Integration Tool Bar The integration tool bar should be
68. in win dow and all the available menu choices The menu bar contains the following menus e File Menu e Edit Menu Make Menu e Tools Menu Help Menu See Help Menu on page 15 in chapter 1 User Interface and Basic Operations Configurable Menus In Telelogic Tau some menu choices may be available through the con cept of user defined menus For more information see Defining Menus in the SDL Suite on page 18 in chapter 1 User Interface and Basic Operations The definition file for user defined menus searched for by the Targeting Expert is called taex menus ini There are several placeholders possible to be used with the Format tedCommand clause in taex menus ini placeholder Will be replaced by Ps system directory b target directory the one given in the Organizer t sub target directory the one calculated depend ing on the selected component and integration e executable name inclusive extension i intermediate directory File Menu The File menu contains the following menu choices e Open July 2003 Telelogic Tau 4 5 User s Manual 2831 Chapter 60 The Targeting Expert 2832 Save Exit See File Menu on page 8 in chapter 1 User Interface and Basic Op erations Edit Menu The Edit menu gives access to the enlargement of the Targeting Expert configuration files Add Compiler Edit Compiler Section Remove Compiler
69. ink Definition for Compilation for the inter communication with the SDL Target Tester s host application e Handling of Settings e Customization Compiler Definition for Compilation Note All the modifications that can be done here are only valid for the current system i e all the information will be stored into the sys tem s target directory Add The following is applicable only if using the Cmicro SDL to C compil er Select Add a new Compiler from the Edit menu The Add compiler di alog is displayed Telelogic Tau 4 5 User s Manual July 2003 July 2003 Interactive Mode Add User defined C Compiler Ea Compiler name My Compiler Compiler macro MYFLAG Cancel Help Figure 507 Add compiler dialog e Compiler Name The text you enter here will be used to identify the compiler in the Compiler Flag list e Compiler Macro The macro name you enter here will be used to identify the compiler in the target library The compiler macro must fit to A Za z_ A Za z0 9 When you click Add the compiler is added to the c _conf def file Please see Configuration Files on page 2899 for information about the file s syntax and duty Edit For each compiler that is supported by a target library there is a specific section in e scttypes h Cadvanced see Compiler Definition Section in sct types h on page 3069 e ml_typ h Cmicro see Adaptation to Compi
70. int as unsigned long define xint32 as flong T The compiler is able to handle function prototypes as defined in ANSI C T The micro controller processor is faster in accessing characters than integer values I The compiler supports variables stored in registers T The compiler is able to handle the C keyword lt const gt in the correct way T Target platform offers OS functions r Critical path Begin I End oOo O F i I no more memory action Kerel exit festo Include paths gt I The compiler supports lt stdio h gt Additional includes ifdef XMK_USE_SDL_MEM include ml_mem h tendif xl m User definitions Cancel Figure 509 Edit compiler section dialog Cmicro For Cmicro the following is requested define xptrint Enter the mapping for xptrint values usually unsigned long define xint32 Enter the mapping for xint32 values usually long The compiler is able to handle function prototypes as in ANSI C If selected this section will be generated undef XNOPROTO define XPP x x define PROTO x x If not selected this section will be generated Telelogic Tau 4 5 User s Manual 2839 Chapter 60 The Targeting Expert define XNOPROTO define XPP x define PROTO x e The micro controller processor is faster in accessing characters than integer values Ifselected this section will be generated define xmk_OPT_INT char If
71. ion flags listed under Configuration Settings to Be Set or Con figuration Settings to Be Reset are not disabled To achieve that open the Customize dialog via the menu choice Tools gt Customize and select the Advanced Mode Please see Customization on page 2850 for more details How can I create my own pre defined integration You can create your own pre defined integrations by selecting one of the distributed pre defined integrations the one that fits most to your needs configure it as you like maybe it is necessary to switch into the Advanced Mode to have access to all the dialogs export the settings like it is described in Export on page 2848 After you have done so the pre defined integration will be available I have exported an pre defined integration but my colleagues are not able to access it in my home directory in my PC instal lation What to do When exporting settings to pre defined integration settings it is pos sible to export as project settings or export as user settings You have probably exported as user settings i e the its file is not accessible for other users You can move the lt integration gt its file in the same directory where the lt systemname gt sdt file of your project is saved So it will be visible for all users working on this system Telelogic Tau 4 5 User s Manual 2939 Chapter 60 The Targeting Expert 2940 Telelogic Tau 4 5 User s
72. ir sctkerneldir TESTER FILES scttesterdir scttesterdir scttesterdir scttesterdir scttesterdir scttesterdir sctkerneldir TI TESTER FIL scttesterdir scttesterdir scttesterdir scttesterdir CODER FILES sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI sctCODERDI Telelogic Tau 4 5 User s Manual m scttesterdir m scttesterdir mt_cod m m m ES m RO TI KERNEL FILES ti_sche sctkerneldir ti_queu sctkerneldir ti_outp ti_timl ti_init sctpred t_tsdl t_cmd t opt mt_deb mt_rec t_play c ml_buf c mk_main sctkerneldir mk_sche sctkerneldir mk_queu mk_outp mk_timl sctpred gqaaqaaaa agaqaaqaaaa c aaaaa aaaaa cucf_er c cucf_er_sdt c bms bms c bms bms_small c ems ems c ems ems_eo_sdt c er ascii ascii c er ber ber_base c er ber ber content c t_tsys c t_tsdl c scttesterdir mt_tsys c mt_cod scttesterdir mt_cmd mt_opt mt_deb sctkerneldir ml_buf er ber ber decode c er ber ber_encode c er per per_ base c er per per_content c er per per decode c er per per_encode c er mms mms c July 2003 July 2003 Internal Sct CODERDIR Sct CODERDIR Sct CODERDIR Sct CODERDIR vms vms_base c
73. lers on page 3430 in chapter 67 The Cmicro Library Whenever there is a compiler flag defined not known by the library a file called user_cc h will be included which has to contain the compil er specific settings The dialogs shown below are input masks that request all the needed in formation to generate such a file Select Edit Compiler Section from the Edit Menu Telelogic Tau 4 5 User s Manual 2837 Chapter 60 The Targeting Expert Cadvanced Edit Compiler Section define xptrint as funsigned long Include paths I The compiler supports lt stdio h gt Additional include lt gt includes m User definitions Cancel Help Figure 508 Edit compiler section dialog Cadvanced For Cadvanced the following is requested e define xptrint Enter the mapping for xptrint values usually unsigned long e Include paths The compiler supports lt stdio h gt If selected this section will be generated ifdef XREADANDWRITEF include lt stdio h gt endif Otherwise nothing will be generated here Additional includes The contents of the edit box will simply be copied in to the user_cc h file It should carry something like include lt file gt e User definitions Enter user definitions for the user_cc h file 2838 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Interactive Mode Cmicro Edit Compiler Section xi define xptr
74. m Stop T Include functions to handle more system info T No automatic scaling from sdl_cfg h I Use Watch Dog Kernel limits I Use large transition tables T Allow more than 250 signals I Allow more than 256 instances T Allow large signal parameters m Signal structure I Sender Process Ids IV Receiver Process Id Size of signal parameters 4 Kii Signal handling T Simple signal output I Use of SENDER in start transition I Add signal parameter free functions r Signal queue C Combined static and dynamic queue Static signal queue only Size of sianal queue I am al Figure 531 Configuration flag dialog rl When all the configurations have been done the Targeting Expert gen erates e ml_mcf h aC header file for Cmicro which will be included in ml_typ h during the compilation of the corresponding files This is done for all the pre defined integrations using the SDL to C compiler Cmicro e sct_mcf h aC header file for Cadvanced which will be included in scttypes h if the flag USER_CONFIG is defined The flag USER_CONFIG is only defined for the pre defined integra tions Application applclenv and Application debug debclenv com using the SDL to C compiler Cadvanced Configure the SDL Target Tester Cmicro only The configuration of the SDL Target Tester is very similar to the con figuration of the target library Telelogic Tau 4 5 User s Manual 2873 Chapte
75. n Files on page 2899 for more information about configuration flags Configuration Settings to Be Set For several pre defined integrations it is necessary to have some config uration flags set without giving you the chance to un select them In this section a simple list of all configuration flags which have to be set is given This section starts with CONFIGURATION SET Please see Configuration Files on page 2899 for more information about configuration flags Configuration Settings to Be Reset In opposite to the configuration flags which have to be set it is of course necessary sometimes to prevent the selection of other flags This can be done in this section by simply listing all the flags that have to be reset This section starts with CONFIGURATION RESET Please see Configuration Files on page 2899 for more information about configuration flags SDL to C Compiler Settings to Be Disabled For some pre defined integrations it does not make sense to configure all the SDL to C compiler options available It is possible here to list all the options to be disabled in the user interface This section starts with SDL_TO_C_ COMPILER DISABLED Comments and empty Lines e Empty lines are allowed everywhere in the an its file Telelogic Tau 4 5 User s Manual July 2003 Internal e Comments are allowed everywhere inthe its file but have to start with an in the first column Ot
76. n_name gt uis in the ac cording component directory Please see Target Sub Directory Struc ture on page 2921 2846 Telelogic Tau 4 5 User s Manual July 2003 Interactive Mode For some reasons it is sometimes useful to modify this way of saving the user done settings E g e Tobe able to play with settings it can be useful to switch to an E5 other file while the default one is not touched After playing it is easy to switch back to the old settings by selecting the old file again e After doing an adaptation for a specific target the manually modi B fied settings can be exported as new pre defined integration set tings Please see Export on page 2848 e Estimated there are several components inside of a node and each of Pa them should be build the same way then it is probably useful to do the adaptation of settings once on node level and to import these set tings for each component This also means that the compiler linker and make settings can no longer be modified on component level e Estimated there are several components in different nodes that P should be build the same way then it is possible to import the set ting from the application This also means that the compiler linker and make settings can not be modified any longer on component level Estimated there is an integration A and there are modified settings on this integration on application node and component level Then there
77. nal makefile generator makegen is delivered with every Telelogic Tau distribution It can be found in lt installationdir gt sdt sdtdir util lt platform gt Source and Make Files The source files delivered are e makegen ch e ini _api h e pdm api h Furthermore there are makefiles and libraries e cc compiler on UNIX makegencc m makegenlib a e gcc 2 95 2 compiler on UNIX makegengcc m makegenlib a e Microsoft VC 6 0 compiler in Windows makegencl m makegencl lib e Borland C Builder 5 51 compiler in Windows makegenbcb m makegenbcb 1lib 2934 Telelogic Tau 4 5 User s Manual July 2003 Utilities Utilities July 2003 General Delivered in combination with the Targeting Expert there is an applica tion called taexutil This application can be used directly from the Targeting Expert Tools menu or on the command line e g in makefiles The following utility functions are supported e DOS to UNIX e UNIX to DOS e Indent e Preprocessor Note Each utility will create a backup file called lt inputfile gt bak DOS to UNIX This utility can be used to modify ASCII files It replaces all the found r n sequences against n e Command line taexutil D2U lt inputfile gt lt outputfile gt lt inputfile gt and lt outputfile gt can be equal but both must be given UNIX to DOS This utility can be used to modify ASCII files It replaces all the found
78. nique e The Targeting Expert searches for its files in the following direc tories 2902 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Internal procedure Search_order_on_UNIX Read Rtelelogic sdt sdtdir lt platform gt sdtdir its Read Relelogic sdt sdtdir its No Read HOME telelogic its Read lt systemdirectory gt its Figure 539 Search order on UNIX procedure Search_order_in_Windows Read lt installationdir gt sdt sdtdirwini336 its Read lt installationdir gt sdt sdtdir its YES h Read SHOME telelogic its Read lt systemdirectory gt its Read lt installationdir gt its Figure 540 Search order in Windows Telelogic Tau 4 5 User s Manual 2903 Chapter 60 The Targeting Expert Distributed Pre defined Integration Settings For Use with Cadvanced SDL to C Compiler Simulation debcom Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HP acC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are not implemented i e timers set in the SDL system will expire at once Environment Will be handled in the Simulator UI More info See chapter 50 The SDL Simulator Realtime Simulation debclcom Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop
79. nsion Enter the executable extension to be used for the linker output e Additional object files and Additional libraries Default Restores the default values Add A file selection dialog is opened where you can select the file which should be additionally linked to the executable Remove Removes the item you have selected in the list box Modify A dialog is displayed and the selected item in the list box can be modified Clear Deletes all the items in the list box Library Manager Note This section is available only if an SDL and or ASN 1 coder is se lected Please see Communication on page 2877 for details on how to select a coder The library manager offers the command that will be used to build a li brary from all the coder files The dialog is shown in Figure 529 July 2003 Telelogic Tau 4 5 User s Manual 2867 Chapter 60 The Targeting Expert 2868 Library Manager Description The library mamager is used only if coder function are to be included Lib manager fib E Default The placeholders 0 list of object files and I library name can be used Options nologo OUT 1 0 Default Library extension lib Default Figure 529 Library Manager Configuration Note If no library manager is given all the coder object files will be linked directly to the target application Click Default if you want to restore the default values Lib Manager Enter th
80. of the object Full variable prefix All the variables used in SDL will be generated with a full prefix to C to make them unique if this item is selected This comes with a disadvantage of long variable names Instance information file An instance information file will be generated Please see SDL In stance Information on page 2442 in chapter 55 The SDL Analyzer Separation It is possible to select between three alternatives do not separate use the user defined separation done in Organizer separate each SDL entity into one C file File name prefix All the generated files except those with fixed names like sdl_cfg h will be generated with the given file name prefix Environment header file The environment header file i fc which is used in the coder and environment functions will be generated if switched on Environment functions Environment functions will be generated or not Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow Note If the generation of environment functions is switched on it may be needed to add the environment source file to Source Files Please see Initializing the Environment Interface to the Environment on page 3439 in chapter 67 The Cmicro Library for Cmicro Building an Application on page 2695 for Cadvanced Signal number file Cadvanced only Generate a signal number file if selected Conversion st
81. ompiler for 80166 derivatives BSO Tasking compiler for 80166 derivatives BSO Tasking compiler for 80196 derivatives Microtec compiler for 68K models Hyperstone compiler for Hyperstone controllers Thumb compiler for ARM controllers eeevevuvc4eee Figure 526 Flag selection Caution You must select the correct compiler flag in order to avoid compila tion errors For more information concerning the compiler specific adjustment of the libraries see e scttypes h Cadvanced see Compiler Definition Section in sct types h on page 3069 e ml_typ h Cmicro see Adaptation to Compilers on page 3430 in chapter 67 The Cmicro Library Additional Compiler If there are other files than the generated ones or the SDL to C compil er s library to be compiled all the requested things in this section have to be entered Telelogic Tau 4 5 User s Manual Chapter 60 The Targeting Expert 2864 m Compiler Description These settings are to be used for additional files which should not be compiled with the standard compiler Maybe only the compiler options may differ Compiler name l b Defaut The placeholders s source file 0 object file and I include path must be used Options Default Include a Default Obj extension Default Additional files to compile List of files Default Add Remove Modify Clear
82. ompilers can be found in lt in stallationdir gt sdt sdtdir The c _conf def files are ASCII text files that can be should be ex tended by you to adapt a new compiler or to adapt a new communica tions link Cmicro only You can find all the known configuration flags in e Some Configuration Macros on page 3078 Cadvanced e Compilation Flags on page 3394 in chapter 67 The Cmicro Li brary for Cmicro Telelogic Tau 4 5 User s Manual 2899 Chapter 60 The Targeting Expert 2900 Structure of the Configuration File cm_conf def Note All the descriptions in this section are valid for the SDL to C com piler Cmicro only Compiler All the compilers currently supported by a SDL to C compiler library are listed in the c _conf def file like displayed in Example 473 Example 473 Structure of a compiler entry BEGIN IAR_C51 IAR systems compiler of 8051 COMPILER Microcontroller compiler END The first and the last line of the example simply marks the start and the end of one entry Line 2 is the flag which will be used to include the appropriate compiler section in the used library see ml_typ hfor Cmicro and scttypes h for Cadvanced Line 3 is the text which will be shown in the Targeting Experts user in terface Line 4 must be COMPILER in this case Line 5 is the compiler group this compiler should be associated with In the distributed files c _conf def there are three groups namely
83. on op tional Compiler Too13 Name of the assembler application op tional Compiler Options Compiler command line options Please see Compiler on page 2900 Compiler Options2 C parser command line options option al Compiler Options3 Assembler command line options op tional Compiler LibFlag The compiler s option to set defines plus the library flag e g SCTDEBCOM Compiler Include The compiler s option for include paths and the include paths Compiler CodInclude The compiler s option for include paths and the include paths to the coder files Compiler Flag Compiler flag Please see Compiler Flag on page 2862 Linker Tool Name of the linker application Linker Options Linker command line options Please see Linker on page 2865 ObjectExtension Extension of the object files ExecutableExtension Extension of the target executable FilesToCompile Kernel library and template files to be compiled This entry can be used more than once July 2003 Telelogic Tau 4 5 User s Manual 2917 Chapter 60 The Targeting Expert Keyword 3 Keyword 4 Meaning of the parameter TesterFilesToCompile Tester files to be compiled This entry can be used more than once Cmicro only FilesToCopy Template files which should be copied into the target directory Environment variable sdtdir can be used ObjectsToLink Additional object files to be linked This
84. on SIGNALS en Default Note if modifying this rule an existing env c file will be destroyed Figure 535 Env header file configuration The way the environment header file i c file is generated can be con figured here Please see System Interface Header File on page 2704 in chapter 58 Building an Application for more information Note The CHANNELS section cannot be configured for Cmicro because the SDL systems structure blocks and channels will be lost after code generation Telelogic Tau 4 5 User s Manual 2879 Chapter 60 The Targeting Expert 2880 Execution r Download application Specify a command line for the download application to use This download application will automatically be started after the make process is successfully completed The placeholder t will be replaced by the target executable s name including path a H Bl Decal m Test application Select one of the SDL Suite applications or specify the command line of another test application The test application will automatically be started after the download has been done successfully C None SDL Target Tester C Other The placeholder t will be replaced by the target executable s name including path DSSS ae ae ee al ee en el Sra Sea Bl Deran Figure 536 Download and test tool configuration Download Application Enter also the complete command line
85. ons file NO ASCII or lt user gt GenerateASNCoder The SDL to C compiler should generate an ASN 1 cod er functions file NO BER PER or lt user gt 2914 Telelogic Tau 4 5 User s Manual July 2003 Internal Keyword 2 Meaning of the parameter Separation The SDL to C compiler shall generate the C files sepa rated according to the given value NO USER FULL Analyze The Analyzer SDL to C compiler should be invoked during the make YES or not No TestTool The Test application to be used can be entered here i e the entries Simulator Validator or Tester but also a complete command line FileNamePrefix The SDL to C compiler will generate all files with the given filename prefix GenerateIfcSynonyms The SDL to C compiler should generate the SYNONYMS section into the env header file YES or not NO depends on GenerateEnvHeader GeneratelIfcLiterals The SDL to C compiler should generate the LITERALS section into the env header file YES or not NO depends on GenerateEnvHeader GeneratelfcTypedefs The SDL to C compiler should generate the TYPEDEFS section into the env header file YES or not NO depends on GenerateEnvHeader GenerateIfcOperators The SDL to C compiler should generate the OPERATORS section into the env header file YES or not NO depends on GenerateEnvHeader GeneratelfcSignals The SDL to C compiler should generate the SIGNALS se
86. opriate macros should be given in the Tar geting Expert Select Add a User Defined Communications Link from the Edit Menu Telelogic Tau 4 5 User s Manual July 2003 July 2003 Interactive Mode Add Communications Link CommLink name CommLink macro CommLink group Dependent flags Add list Add text Remove Figure 511 Add a user defined communications link CommLink Name The text will be shown in the Targeting Expert UI to identify it in the dialog described in Configure the SDL Target Tester Cmicro only on page 2873 CommLink Macro The macro name will be used to identify the communications link in the target library The communications link macro must fit to A Za z_ A Za z0 9_ CommLink Group The text will be used to build a group of the communications link description done here i e the CommLink macro and the dependent flags will be summarized as the group given here Dependent Flags Add List A dialog where you enter a Value List is displayed Add Text A dialog where you enter a Text Value Flag is displayed Remove The entry you have selected in the list box will be removed Telelogic Tau 4 5 User s Manual 2843 Chapter 60 The Targeting Expert 2844 When you click Add the communications link is added to the c _conf def file Please see Configuration Files on page 2899 for information about the file s syntax and
87. ore info See chapter 53 The SDL Validator e Application applclenv Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HPaCcC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Has to be implemented by the user More info See Compilation Switches on page 3041 in chapter 62 The Master Library 2906 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Internal e Application debug debclenvcom Supported compiler On Sun Sun GNU gcc Sun Workshop cc Sun Workshop CC On HP HP GNU gcc HPcc HPaCC In Windows Borland C Microsoft VC Used kernel directory Timers Timers are implemented in a way that one timer tick is equal to one second i e a timer set to 10 in the SDL system will expire after 10 seconds Environment Has to be implemented by the user More info See Compilation Switches on page 3041 in chapter 62 The Master Library e Threaded integrations for the platforms OSE Softkernel Solaris and Windows Solaris VxWorks Softkernel Solaris and Windows Note VxWorks only The environment variabl
88. process the generated C file with the default compiler before the compilation with the target compiler Hint It is probably useful to use the utility functions delivered in combi nation with the Targeting Expert Please see Utilities on page 2935 e Post link The post link of the linked files will be executed as the last step in the make task July 2003 Telelogic Tau 4 5 User s Manual 2871 Chapter 60 The Targeting Expert Enter the application which performs the post link here E g a con version from absolute to Intel HEX format The placeholder s can be used to represent the linker output file Configure and Scale the Target Library The configuration and the scaling of the used target library is done by setting resetting compiler macros define in C These macros will be called flags in the further description For more information concerning allowed flags see e sct_mcf h Cadvanced see Some Configuration Macros on page 3078 e ml_mcf h Cmicro see Compilation Flags on page 3394 in chapter 67 The Cmicro Library The Targeting Expert offers an easy way of setting resetting these flags All the allowed flags are divided into different groups e g SDL support and environment Figure 531 shows an example for Cmicro 2872 Telelogic Tau 4 5 User s Manual July 2003 July 2003 Targeting Work Flow r General IV Rapid process variable initialization I Syste
89. r 60 The Targeting Expert 2874 The settings done for the target will also be generated into the file ml_mcf h Please see Configure and Scale the Target Library on page 2872 Configure the Host Cmicro only The settings for the host will be generated into the file sdtmt opt which will be read by the SDL Target Tester during start up to get in formation about the gateway to be used and the target s memory layout Please see Communication Setup on the Host System on page 3521 in chapter 68 The SDL Target Tester for more information about how to configure the SDL Target Tester s host application Actions to perform e Configure how to Make the Component e Make the Component Configure how to Make the Component The possible options are divided into four pages Note All the Analyzer options entered in the Organizer will be re used by the Targeting Expert Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow July 2003 SDL to C Compiler SDL to C compiler Communication Env header file Execution MV Analyze generate code Analyzer options Save commands The basic options how to generate code have to be set here M All files I Capitalization lower case IV Full variable prefix T Instance information file Separation No do not separate 7 Default File name prefix Default r Environment r Code generation options Note The environm
90. r Options nologo I ML c D Windows DSCTDEBCOM Fo o S Simulation Microsoft Compiler Include I sctuseinclude Simulation Microsoft Compiler Flag IC86 Simulation Microsoft Linker Tool link Simulation Microsoft Linker Options nologo subsystem console 0 OUT e Simulation Microsoft ObjectExtension _smc obj Simulation Microsoft ExecutableExtension _smc exe Simulation Microsoft FileToCompile sdtdir INCLUDE sctsdl c Simulation Microsoft FileToCompile sdtdir INCLUDE sctpred c Simulation Microsoft FileToCompile sdtdir INCLUDE sctos c Simulation Microsoft FileToCompile sdtdir INCLUDE sctmon c Simulation Microsoft FileToCompile sdtdir INCLUDE sctutil c Simulation Microsoft FileToCompile sdtdir SCTADEBCOM sctpost c Simulation Microsoft LibrariesToLink sdtdir INCLUDE msvc50 libpost lib Simulation Microsoft LibrariesToLink user32 lib Simulation Microsoft Make Tool Microsoft nmake using temporary response file Simulation Microsoft MakefileName my _makefile m Simulation Microsoft MakefileGenerator 2916 Telelogic Tau 4 5 User s Manual July 2003 Internal Simulation Microsoft ObjectDirectory objects All the keywords and the allowed combinations can be found in the ta ble below Keyword 3 Keyword 4 Meaning of the parameter Compiler Tool Name of the compiler application Compiler Tool2 Name of the C parser applicati
91. the integrations Val idation and TTCN Link In both cases a library is taken from the ker nel directory User Modifications After all it is possible that there are a few adaptations to be done e g if there is an assembler file which needs to be assembled and linked Example 479 shows the section of a generated makefile where it is pos sible to add further object files Example 479 Generated makefile 1 H HHHHHHH UserObjectsStart Do not edit this line userOBJECTFILES1 userOBJECTFILES2 HHHHHHHH UserObjectsEnd Do not edit this line HHHHH HH The list userOBJECTFILES1 will be inserted at the front of all the ob ject files to link Accordingly userOBJECTFILES2 will be inserted at the end The rules and the dependencies for the files in Example 479 must be given in the section shown in Example 480 Example 480 Generated makefile 2 HHHHHHHH UserRulesStart Do not edit this line HHHHHHH HEEHHHHH UserRulesEnd Do not edit this line H HHHH H H F Caution Any modification that is done outside of the sections described in Example 479 and Example 480 will be overwritten when the make file is generated anew Telelogic Tau 4 5 User s Manual July 2003 Internal Parameter File sdttaex par General One of the delivered configuration files used by the Targeting Expert is called sdttaex par Several different sections give information that is statically used during
92. ting Expert event log will give information about the process state Analyze and Generate Code The selected SDL to C compiler will be invoked and code will be gen erated for the selected component There are two possibilities e make In that case only code for the modified parts of the SDL system will be generated e full make Code for the complete SDL system is generated Even if there are no modifications Generate a Makefile 6 The makefile to be used will be generated Please see Make on page 2868 for information on how to give the makefile s name and how to switch the makefile generation on or off Hint If the build in makefile generation does not fit your needs it is pos sible to customize the makefile generation Please see External Makefile Generator on page 2934 to get infor mation on how to build a makefile generator Telelogic Tau 4 5 User s Manual 2881 Chapter 60 The Targeting Expert 2882 Compile and link The external make tool will be invoked using the generated makefile Please see Make on page 2868 for information on how to select the make tool Hint To force a compilation of all the C source files the object files have to be deleted first Please use the Clean entry in the Make Menu Execute The target executable will be executed Note It is sometimes not possible to invoke the target executable from the Targeting Expert e g if the t
93. tion about how to build an external makefile gener ator e Makefile Enter the name of the makefile e Object directory The object directory is the relative path seen from the current target directory in which the compiler output files object files should be written Note If the directory lt target_directory gt lt object_directory gt does not exist it will be automatically created e Library directory 2870 Telelogic Tau 4 5 User s Manual July 2003 Targeting Work Flow The library directory is the absolute path to the target library to be used Under normal circumstances this field can be left empty as the Targeting Expert automatically uses the path in the Telelogic Tau installation lt installationdir gt sdt sdtdir lt platform_sdtdir gt Note The Cmicro target library will be expected in a sub directory called cmicro The Cadvanced library will be expected in a sub directory called INCLUDE e Pre make The pre make step will be executed before any other action speci fied in the makefile is performed The placeholder s will automatically be replaced by the com ponent s name e Pre compile The pre compile of the generated file s will be executed before they are compiled Enter the application which performs the pre compile here The placeholder s can be used to represent the source files name The preprocessor button inserts the complete command that is necessary to pre
94. tion or node can be configured but not build Only com ponents can end up in executable programs In the start up phase directly after the partitioning diagram model has been displayed the Targeting Expert generates a sub directory structure into which all the configuration settings object files and so on will be put Please see Target Sub Directory Structure on page 2921 for more information Now you can use the Targeting Expert to configure each component Hint If you switch the Targeting Assistant on in the Help menu there are tool tips displayed for each entry on the main window Operation Steps The following operation steps should be done at least once when doing targeting for a component the very first time When the Targeting Ex pert is used again later to optimize the target it is of course not necessary to do all the steps once more Actions to perform e Select the component which should be configured Note All the settings you define and the actions automatically performed by the Targeting Expert have an influence only on the component selected in the Targeting Expert tree window see Figure 519 on page 2852 If the configuration should be re used this is sometimes reasonable if several components should be built using exactly the same set tings you can modify the way your settings are handled Please see Handling of Settings on page 2846 Telelogic Tau 4 5 User s Manual 2853
95. ue identifiers which make it possible to rename the application nodes or components and to keep the done settings In this case the Targeting Expert automatically modifies the names of the subdirectories Later after you have built a Simulator and a Validator for the com ponent for example then the sub directory structure was extended to lt target_dir gt application 0 node 1 component 2 Simulator Validator Flat Directory Structure When using an sdt or pr file as input the directory structure will be flatten automatically I e it will look like lt target_dir gt application 0 Simulator Validator This is possible because there can only be one node with one component in both cases Generated Makefile Before the selected make tool is invoked the Targeting Expert generates a makefile with all of the necessary settings done Please see Config ure Compiler Linker and Make on page 2856 for information on how to set up the makefile generation Telelogic Tau 4 5 User s Manual July 2003 July 2003 Internal Caution The standard header files of the used SDL to C compiler library are not used as dependencies in the compilation rules i e after modify ing one of these files you have to select the Clean entry in the Make Menu Comparisons There are a few differences that need to be mentioned when comparing the way the Targeting Expert handles makefiles with the way t
96. ult if you want to restore the default values Make tool Select the make tool you wish to use Currently the following make tools are supported see Make Applications on page 2928 Borland make using temporary response file Borland make ignore exit codes Borland make Microsoft nmake using temporary response file Microsoft nmake ignore exit codes Microsoft nmake UNIX make Tasking mk166 Tornado make Telelogic Tau 4 5 User s Manual 2869 Chapter 60 The Targeting Expert Hint Using temporary response file means that the compiler s and the linker s command line options are passed to the compiler linker via a temporary file generated by the make tool This feature can only be used if the compiler in use supports this fa cility Note If the make tool you would like to use is not in the list Please add a new definition in sdttaex par For more information view Make Applications on page 2928 e Generate makefile Select this if a makefile should be generated before make is in voked The name of the generated makefile is the one in Makefile e Generator The Targeting Expert is designed to execute external makefile gen erators whenever the build in makefile generator intern is not sufficient Enter the name and the path of the external makefile generator here Please see External Makefile Generator on page 2934 for further informa
97. used to from left to right e Select the Pre defined Integration Settings e Get help about the selected integration e Select an SDL to C Compiler e Select a C Compiler to be used Furthermore it should also be used to handle pre defined and user de fined integration settings see Handling of Settings on page 2846 i e e to set a new user settings file name e to export user settings as pre defined settings e to import node or application settings The Work Area The work area of the Targeting Expert is used for giving input masks for the different configurations and scalings The different input masks are described in e Configure how to Make the Component on page 2874 e Configure Compiler Linker and Make on page 2856 e Configure and Scale the Target Library on page 2872 Telelogic Tau 4 5 User s Manual July 2003 The Graphical User Interface e Configure the SDL Target Tester Cmicro only on page 2873 e Configure the Host Cmicro only on page 2874 The Event Log The Targeting Expert has an event log containing information about found inconsistencies read write problems concerning file access out put etc Save log target executable name custom denned SiS Clear log Low size Show Analyzer errors amp Calcul target calcul _O HostSimulation__CLENV_ component exe per Generating default lt sdtmt opt gt a Generating default lt X Calcul target c
98. yle Cmicro only Select the rules how to generate the converter file here Filename Cmicro only Give a name to the converter file Communication SDL to C compiler Communication Env header file Execution Coders generate SDL coder functions I generate ASN 1 coder functions TCP IP i Signal sending Figure 533 Communication configuration Generate do not generate SDL coder functions Please see Type description nodes for SDL types on page 2718 in chapter 58 Building an Application Generate do not generate ASN 1 coder functions Please see ASN 1 Type Information Generated by ASN 1 Utili ties on page 2767 in chapter 59 ASN 1 Encoding and De coding in the SDL Suite TCP IP signal sending Telelogic Tau 4 5 User s Manual 2877 Chapter 60 The Targeting Expert Note The TCP IP communication is supported only for a threaded inte gration using the SDL to C compiler Cadvanced The signal sending to other components can be done via a communica tions link If it is switched on a wizard dialog to set up all the needed information pops up see Figure 534 TCP IP Communication Wizard _ x Input here goes to the Communication tab of the main section the Source Files tab of the Compiler section and the Environment tab of the Target Library section Please modify these sections if needed ri Routing T Include routing header fil

60 The Targeting Expert

Contents

Download Pdf Manuals

Related Search

Related Contents