=============================================================================== ASAP2 Tool-Set 6.0 for Windows XP/Vista/7 (C) 1998-2011 Vector Informatik GmbH, Stuttgart =============================================================================== Contents of CD-ROM: ------------------- SETUP.EXE Setup program =============================================================================== Information: ------------ The documentation in pdf format on the CD contains the latest changes of the program which could not be integrated into the printed manuals. =============================================================================== ASAP2 Merger =============================================================================== Commandline parameters: ----------------------- The following command line parameters can be entered when calling the program: -M Name of the ASAP2 Master file -L Name of the log file for warnings and error messages. If no name is entered for this parameter, the messages are output to the screen -S Name of an ASAP2 Slave file number > Number of MODULES for this file which are to be merged into the master file ( )* MODULE allocations for the master file (name1 = MODULE name in the slave file, name2 = MODULE name in the master file) or simply -S Name of an ASAP2 Slave file (the first MODULE inside this file will be merged into the first MODULE of the master file) This parameter can be used multiple -O Name of the ASAP2 file to be generated -P File name of the initialization file (full path) -@ Name of a text file with all command line parameters. BE CAREFUL !!!! There must be NO space characters between @ and the file name. Call e.g.: Merger -@CMDLINE.TXT The text file may contain comment lines: lines starting with a ';' are ignored Initialization file: -------------------- The initialization file MERGER.INI is expected in current directory per default. Alternatively, a different name (also in different directory) can be set in the commandline. In the initialization file the behaviour of the merger can be controlled additionaly to the commandline parameters. The following settings are possible: [OPTIONS] DISABLE_SUFFIXES ; 1: Disables suffix generation AVOID_MULTIPLE_OBJECTS ; If there are objects with equal names, only the ; corresponding object of the first source file in command ; line is accepted for the result file CREATE_IF_DATA_FOR_SLAVES ; IF_DATA module information of ALL input files is used ; for the result file. Without this option only the ; IF_DATA module information of the master file is used CHECK_FOR_DUPLICATE_NAMES ; 0: No check for duplicate names (better performance) MERGE_GROUP_CONTENTS ; 0: No merge of group resp. function contents ; 1: For groups and functions with equal names and equal comments ; the contents (sub groups, sub functions and referenced ; objects) are merged. ; 2: additional the annotations are merged. ; Merge of group contents is only possible with disabled ; suffix generation CREATE_INVALID_CALIBRATION_HANDLES ; Ident values for CALIBRATION_HANDLE (which are ; not allowed in ASAP2 syntax) will be rewritten ; to output file RETURN_CODES_SIMPLE ; Creates only rudimental return codes: ; 0: everything OK ; 1: no errors, but warnings ; 2: errors occured ; The concrete error / warning messages can be found in ; logfile CREATE_IF_DATA_CANAPE ; Create AML CANAPE_EXT for the output file if not ; exist in master file GROUP_FOR_SLAVE_x ; Add all objects of slave x to master group with ; given name. Master group is created if it doesn't exist ; numbering of slaves start with 1 ASAP2_VERSION ; Optionally an output file corresponding to ASAP2 format ; 1.50 or 1.40 can be created (default is 1.60) PARENT_FOR_SLAVE_x ; The complete object hierarchy of slave file number x is ; inserted into the master group with given name. All measure and ; calibration objects of the slave without group assignment and ; all slave groups resp. functions without parent group in the slave ; file are assigned to the master parent group. ; The master group is created if it doesn't exist. Numbering of slaves ; start with 1 IGNORE_GROUP_COMMENTS ; If group contents are merged the group comments are ignored ; ( groups/functions with equal names can be merged although ; their comments are different) Exitcode: --------- How successful the merge process was can be determined by the exit code of the program. 0 no errors, no warnings 100 no errors, but warnings in the log file the possible warnings: - Syntax error in an A2L file (later leads to program termination, but the file is, if possible, still parsed at the end) - MODULE with the entered name not found - one MODULE from a slave file is not assigned to a Master MODULE (not present in the result file) - Hybrid of interface components from both ASAP2 V1.0 and ASAP2 V >= 1.20 501 Corrupt command line data. 502 The log file cannot be opened. 503 More than one master file was entered. 504 No master file was entered. 505 No slave file was entered. 506 Syntax error in one of the ASAP2 source files. 507 Result file cannot be written. 508 More than one result file was entered. 509 No result file was entered. 510 File with command line parameters cannot be read. 600 Not enough memory locations. =============================================================================== ASAP2 Updater =============================================================================== Latest information: ------------------- The following INI file option values are not documented in the printed manual but only in the pdf version of the manual and the readme file: - ELF_ADD_INHERITED_CLASSNAME_PREFIX: 3, 4 - ELF_DEMANGLE_SYMTAB_NAMES: 3 Commandline parameters: ----------------------- When the program is called the following commandline parameters can be specified: -I Name of the ASAP2 Input file -O Name of the ASAP2 Output file to be generated -A Name of the MAP file / address file -L Name of the log file for warnings and error messages. If no name is entered for this parameter, the messages are output to the screen. -G[R] Group filter mode R: recursive Name of group file with the names of groups / functions, which should enter the result file. This option can be used together with the "normal" filter mode. In this case all objects which are in one of the specified groups / functions (or in a subgroup or subfunction when using the recursive option) AND all objects of the filter mode option enter the result file. -T File name of the initialization file (full path) -@ Name of a text file with all command line parameters. PLEASE NOTE !!!! There must be NO space characters between @ and the file name. Initialization file: -------------------- The initialization file UPDATER.INI is expected in current directory per default. Alternatively, a different directory can be set in the commandline. In the initialization file the behaviour of the updater can be controlled additionaly to the commandline parameters. The following settings are possible: [OPTIONS] ; section for common settings FILTER_MODE ; This flag is used to specify which measure and calibration objects ; of the source file are stored in result file ; 0: all objects are saved to output file ; 1: Only those variables in the map file enter the result file. ; 2: Only those variables which are NOT in the map file enter the result file. ; 3: Only measure objects enter the result file. ; 4: Only calibration objects enter the result file. ; 5: Only virtual objects enter the result file. CREATE_ADDRESSES ; Missing addresses of MEASURMENTs are created using the ; keyword ECU_ADDRESS. DELETE_EMPTY_GROUPS ; Empty groups / functions are removed in result file CALCULATE_BASE_ADDRESS_FOR_MEASURE ; creation and usage of base addresses from object ; names with syntax "name[index] WARNING_LEVEL ; Level for output of logging messages (default: 2) ; level 1: no messages about not updated objects are given ; level 3: in filter mode additional messages for removed ; objects are given MAP_FORMAT ; specifies the format of the MAP file ; the following MAP formats are supported: ; 0 = Standard ; 1 = BorlandC ; 2 = BSO TaskingC 166 ; 3 = Watcom ; 4 = HiTech 68HC05 ; 6 = IEEE (Cosmic,Tasking,..) ; 7 = Cosmic ; 8 = SDS ; 9 = Fujitsu ; 10 = GNU ; 11 = Keil 16x ; 12 = BorlandC 32 Bit ; 13 = Keil 16x (including static symbols) ; 14 = Keil 8051 ; 15 = ISI MatrixX ; 16 = Hiware HC12 ; 17 = Texas Instruments TMS470 ; 18 = Archimedes HC11 ; 19 = COFF ; 20 = IAR ; 21 = VisualDSP ; 22 = Gnu16x ; 23 = GnuVxWorks ; 24 = Gnu68K ; 25 = DiabData ; 26 = VisualDSPDos ; 27 = SH7055 HEW ; 28 = Metrowerks ; 29 = Microsoft ; 30 = ELF16 ; 31 = ELF32 ; 32 = Fujitsu Softune 3..8(.mps) ; 33 = Microware Hawk ; 34 = TI C6711 ; 35 = Hitachi H8S ; 36 = IAR HC12 ; 37 = Greenhill Multi 2000 ; 38 = LN308(MITSUBISHI) für M16C/80 ; 39 = COFF settings auto detected ; 40 = NEC CC78K/0 v35 ; 41 = Microsoft extended ; 42 = ICCAVR ; 43 = Omf96 (.m96) ; 44 = COFF/DWARF ; 45 = OMF96 Binary (Tasking C196) ; 46 = OMF166 Binary (Keil C166) ; 47 = Microware Hawk Plug&Play ASCII ; 48 = UBROF Binary (IAR) ; 49 = Renesas M32R/M32192 ASCII ; 50 = OMF251 Binary (Keil C251) ; 51 = Microsoft standard VC8 ; 52 = Microsoft VC8 (MATLAB DLL) ; 53 = Microsoft VC8 C++ (MATLAB DLL) ; 54 = Microsoft VC8 Debug File (pdb) ; 55 = Microsoft VC++ (MATLAB DLL) UPDATE_VARIANT_ADDRESSES ; If this parameter is set, the variant ; addresses of variant coded calibration ; objects are updated, too. ; Attention! The updater expects fix address ; offset for the variants of one object. ; If this is not fulfilled, this setting ; should not be used DELETE_WRONG_REFERENCES ; If this parameter is set, the group and ; function references to objects removed by ; filter are removed in destination file. CREATE_INVALID_CALIBRATION_HANDLES ; If this parameter is set, ident values for ; CALIBRATION_HANDLE (which are ; not allowed in ASAP2 syntax) will be ; written to output file ; (otherwise they get lost) MAP_FILE_NAMES_SUFFIX ; The given suffix is added to the names ; created from linker MAP file WARNING_UNKNOWN_OBJECT ; In filter mode: display warnings for all ; names of filter file which are not found ; in ASAP2 file. CREATE_LINKER_MAP_REFERENCES ; Create the missing CANape linker map ; references (IF_DATA CANAPE_EXT) for ; updated objects RETURN_CODES_SIMPLE ; Creates only rudimental return codes: ; (0: everything OK, 1: no errors, but warnings, ; 2: errors occured) The concrete error / ; warning messages can be found in logfile CHECK_LOCAL_FUNCTION_LISTS ; Prevent checking local FUNCTION_LIST ; definitions for removing empty groups / ; functions IGNORE_MAP_REFERENCES ; The name of the linker map reference in ; IF_DATA CANAPE_EXT is ignored, instead only the ; object name is used EXPORT_ONLY_REFERENCED ; Exports only referenced conversion rules and ; record layouts into result file ADDRESS_RANGES ; Number of address ranges, for which an ; offset is defined CREATION_RANGES ; Number of address ranges, for which objects ; are to be created CREATE_ARRAYS ; During generation of objects, arrays in the ; ASAP2-file are generated for arrays of base- ; types in the MAP-file. Instead of one object ; for each entry in an array only one object ; for the whole array is generated (using ; MATRIX_DIM). Arrays can be generated for the ; following MAP-file formats: IEEE, COFF, ELF, ; UBROF, OMF, PDB. UPDATE_ADRESSES_TO_ZERO ; The addresses of objects, which could not be ; updated are set to zero. INCLUDE_SAVE_MODE ; Mode, in which the mapping of ASAP2 objects to ; included files (via include-statement) is ; preserved. The objects are stored in their ; original file after the update. This applies ; for the following types of objects: ; GROUP, FUNCTION, CHARACTERISTIC, MEASUREMENT, ; CONVERSION_METHOD, AXIS_POINTS, CONVERSION_TAB, ; CONVERSION_VTAB, CONVERSION_VTAB_RANGE, ; RECORD_LAYOUT CREATE_MAPCONV_TMP_FILE ; Forces the creation of the temporary file MAPCONV.TMP ; which is the ASCII representation of the Map file. ASAP2_VERSION ; Optionally an output file corresponding to ASAP2 format ; 1.50 or 1.40 can be created (default is 1.60) SUPPRESS_UPDATE_OF_VIRTUAL ; Verhindert das Aktualisieren der Adress- und Datentyp- ; Information von virtuellen Mess- und Verstellgrößen [ADDRESS_RANGE_x] ; Definition of address range x for offset (numbering starts with 1) START ; start address of range in linker map ; file LENGTH ; length of the range OFFSET ; offset for all addresses from the ; linker map file which are inside the ; defined range [CREATION_RANGE_x] ; Definition of address range x for creation (numbering starts with 1) START ; start address of range in linker map ; file LENGTH ; length of the range BYTE_ORDER ; Byte order for objects to be created ; Possible values: INTEL or MOTOROLA ; If no byte order is specified, the global byte order of the ; input file is used TYPE ; Object type to be created ; Possible values: MEASURE or PARAMETER [COFF] ; settings for COFF reader MAP_MAX_ARRAY ; Maximum array element count OLD_EXPAND_SYNTAX ; expand syntax compatible to CANape 2.0 ENABLE_POINTER ; enable pointers ENABLE_ENUM ; enable enums ENABLE_MULTIDIMARRAY ; enable multidimensional arrays CONVERT_DOUBLETOFLOAT ; convert DOUBLE objects to float SIMPLE_ARRAY_VIEW ; array representation without leading ; zeros COMPATIBLE_MODE ; array representation compatible to ; CANape 3.5 COFF_ADDRESS_MODE ; 8=byte addressing, 16=word addressing COFF_FORMAT_MODE ; 0=Intel, 1=Motorola [ELF] ; settings for ELF reader ELF_STDMAP_RAM_STORAGE ; Performance optimization (the whole ELF ; file is read to memory before processing) ELF_DEMANGLE_SYMTAB_NAMES ; Use this option to set demangling of the mangled ; variable names. ; Notice: ; Extended demangling is supported only by DWARF2. ; It must be used together with option USE_CPP_EXTENSION_DWARF2. ; 0 - Do not demangle symbol names. ; 1 - Simple demangling - demangle only symbol names ; from debug section. Variable names from symbol table ; are not demangled. ; Simple demangling is supported by DWARF1 and DWARF2/3. ; 2 - Extended demangling - demangle symbol from both ; debug section and symbol table. ; Demangling algorithm is optimized to reduce output ; changes when porting from one compiler to another. ; 3 - Tasking 3.2 Compiler Extension ; demangle symbols mangled by Tasking 3.2 Compiler for TriCore ELF_ERROR_ON_AMBIGUOUS ; Report errors when duplicated variables ; are found MAP_MAX_ARRAY ; Maximum number of variables to be expanded ; from arrays ELF_USE_OLD_VERSION ; Activate old behaviour: Read variables ; from DWARF and write them down immediately ELF_USE_CPP_EXTENSION_DWARF2 ; Extended handling of inherited classes, ; duplicated variables, demangling of symbol ; names ELF_IGNORE_B_MEMBERS_DWARF2 ; Special option for Tricore Toolset compiler: ; Ignore strange member variables with ; "__b_" string in front of variable name ; this option works only together with ; ELF_USE_CPP_EXTENSION_DWARF2 ELF_ARRAY_INDEX_FORM ; Specify form of variable indexes expanded ; from array ; 0: array._1_._22_._333_ ; 1: array[1] [22] [333] ; 2: array_1_22_333_ ; 3: array_001_022_333_ ; 4: array._001_._022_._333_ ; 5: array._01_._22_._333_ (COFF compatible) ; 6: array_1_22_333_ ; 7: array_1__22__333_ ; 8: array.1.22.333 ELF_DOUBLE_AS_FLOAT ; Interpretation of the double values as ; float ELF_ENUM_AS_INT ; Interpretation of ENUM variables as INT ELF_UNDERLINE_PREFIX ; Create '_' prefix for global variables ; names and data member names ELF_UNDERLINE_PREFIX_PREFIX ; Create '_' prefix for compile_unit prefix ; and subfunction prefix, too ELF_NO_DOT_AFTER_ARRAYITEM ; Remove '.' placed behind the array item ; index as separator between index and next ; name parts WRITE_PTR_AS_INT ; Interpretation of pointer variables as ELF_WRITE_PTR_AS_INT ; integer COMPUNIT_NAME_AS_PREFIX ; Create compile unit name (source file) ; prefix for STATIC variables, NOT GLOBAL) COMPUNIT_NAME_AS_PREFIX_ALL ; Create compile unit name (source file) ; prefix for STATIC and GLOBAL variables) FUNCTION_NAME_AS_PREFIX ; Create function name prefix for STATIC ; variables defined in function scope INVERTED_BIT_FIELDS ; The bit offset of variables inside bit ; field structure is inverted ; 0: No inversion ; 1: The bits offset is inverted. The flag ; is VALID ONLY IN MOTOROLA format. ; 2: OBSOLETE ; 3: OBSOLETE ; 4: Inverted bit fileds INVERTED_BIT_FIELDS_INTEL ; Invert the bit offset of variables inside ; bit field structures. This option is valid ; just for ELF files in INTEL format. ; If the elf file is in Motorola format ; the option is ignored INVERTED_BIT_FIELDS_MIRROR ; Invert the bit offsets by the size of ; complete structure class or union INCREMENT_BIT_FIELDS_ADDRESS ; For bit-field variables with bit offset ; greater than 7 the bit offset is devided ; by 8 and the byte address is incremented. ; This option is active only when used with ; any bit inversion flags ELF_FILE_READ_BUFFER_SIZE ; Size of the read buffer for elf file to ; optimize speed ELF_FORCE_SYMBOL_TABLE ; Read the information from symbol table ; 0: Read symbol table only when the DWARF ; section is not available ; 1: Ignore DWARF section and read the ; symbol table ; 2: Read both the symbol table and DWARF ; section ELF_MAP_VERSION_FLAG ; Use special version of elf reader ; compatible with older versions ELF_SCOPE_SEPARATOR ; string which is used in names of inherited ; member variables as separator between name ; of base class and base class member ELF_ADD_INHERITED_CLASSNAME_PREFIX ; Insert the inherited class name in front ; of all inherited data members. The member ; name and inherited class name will be ; separated with scope separator ; 0: Feature is deactivated ; 1: Insert only the name of the base class in ; which the member variable is declared ; 2: If the variable is inherited from multiple ; (seqence of) base classes, insert the names of ; all of them in front of variable name ; 3: Same as 1, but should be used for elf file missing ; DW_Tag_inheritance, where derived class are defined ; as "__b_" members of base class. ; (Tasking 3.2 compiler for TriCore) ; 4: Same as 2, but should be used for elf file missing ; DW_Tag_inheritance, where derived class are defined ; as "__b_" members of base class. ; (Tasking 3.2 compiler for TriCore) ELF_SKIP_UNEXPECTED_TAGS ; Ignore the tags, which are not expected ; in context of the previous parent tags ELF_ENABLE_ARRAY_DOT_DOT ; 0: remove two dots from array indexes ; created by some compilers ; 1: turns off automatic removing ELF_IGNORE_GLOBAL_PADDING ; Special option for Metrowerks compiler: ; compile unit tag is directly followed by ; padding tag, so the rest of the variables ; in compile unit is not processed. With ; this option the padding tags which are ; direct childs of the compile units are ; ignored ELF_NO_ARRAY_BASEADDR_DATATYPE ; Create base address of array elements ; without datatype ELF_ADD_BASE_CLASSNAME_PREFIX ; Add the name of the base class in front ; of derived members ELF_IGNORE_LEADING_UNDERSCORE ; Remove the leading underscore from all ; variable names ELF_LOG_FILE ; Create log file (dump) from the processed ; elf file. This option is aviable only for ; .vdebug section (NEC compiler) ELF_SKIP_NULL_RANGE_ARRAYS ; For ELF files with multiple definitions of arrays ; ==> ignore definitions with size 0 ELF_NO_BASE_ADDRESS ; Disable writing addresses of the classes, ; structures, unions and arrays ELF_REPLACE_CLASSNAME_SCOPESEPARATOR ; Replace occurence of the scope separator '::' ; also in the name of the class/union/structure type ; with scope separator defined by option ELF_SCOPE_SEPARATOR ELF_TRY_RESOLVE_MEMADDR_FROM_SYMBOLTABLE ; For static member variables without valid address ; information the ELF reader tries to find the symbol with an ; extended symbol name in symbol table. ; Notice: This option is supported only by DWARF2/DWARF3 ; and must be used together with ELF_USE_CPP_EXTENSION_DWARF2 ELF_REPLACE_ANGLEBRACKETS ; Use this option to turn on/off replacing of angle-brackets ; occurring within symbol names by '_' character [IEEE] ; settings for IEEE reader MAP_MAX_ARRAY ; Maximum array element count MAP_FIX_TASKING_TYPE_ERROR ; Fix Tasking IEEE output type error MAP_ARRAY_LEADING_ZERO ; Generate array element names with leading ; zeros MAP_IGNORE_LEADING_UNDERSCORE ; Ignore leading underscores of exported ; symbol names MAP_IGNORE_INSTRUCTION_ADDRESS ; Ignore exported symbols with type ; index 15 (instruction address) MAP_CASE_SENSITIVE_LINKER ; Case sensitive linker MAP_BIT_SIZE_OF_INTEGER ; Bit size of integer (0, 8, 16, 32) MAP_BYTE_SIZE_OF_ENUMERATION ; Byte size of enumeration MAP_DIRECT_BIT_BASE_ADDR ; Base address for direct addressable bits MAP_DIRECT_BIT_BYTE_OFFSET_MASK ; Byte mask for direct addressable bits MAP_DIRECT_BIT_BIT_OFFSET_MASK ; Bit mask for direct addressable bits [OMF] ; settings for OMF reader MAP_MAX_ARRAY = 16 ; Maximum array element count OMF_ARRAY_INDEX_FORM = 0 ; specify array index form ; 0: array._1_._22_._333_ ; 1: array[1][22][333] ; 2: array_1_22_333_ ; 3: array_001_022_333 ; 4: array._001_._022_._333_ ; 5: array._01_._22_._333_ OMF_LOG_FILE ; Create log file OMF_MCI_IN_ADDR ; Encode the memory class index in MSB of ; the variable address (only for ECU with ; 24bit addressing) [GREENHILL] ; settings for GREENHILL reader GHS_REMOVE_UNDERLINES = 0 ; If this parameter is set, leading under- ; lines in symbol names will be removed GHS_INCLUDE_RODATA ; If this parameter is set, the section „.rodata“ ; of MAP file is read, otherwise it is ignored [UBROF] ; settings for UBROF reader UBROF_POINTER_AS_VARIABLE ; Use pointers and references as variables ; (ADDRESS type) otherwise pointers and ; references will be ignored MAP_MAX_ARRAY ; Maximum number of variables to be expanded ; from arrays UBROF_WRITE_BUFFER_SIZE ; Buffer size for reader output (Minimal 2048) UBROF_SCOPE_SEPARATOR ; string which is used in names of inherited ; member variables as separator between name ; of base class and base class member UBROF_ARRAY_INDEX_FORM ; Specify form of variable indexes expanded ; from array ; 0: array._1_._22_._333_ ; 1: array[1][22][333] ; 2: array_1_22_333_ ; 3: array_001_022_333_ ; 4: array._001_._022_._333_ ; 5: array._01_._22_._333_ (COFF compatible) ELF_NO_DOT_AFTER_ARRAYITEM ; Remove '.' placed behind the array item ; index as separator between index and next ; name parts UBROF_SKIP_DUPLICATED_ADDRESSES ; If found more than one variable with same ; address in the UBROF file, only the first ; is used. The others are ignored. UBROF_MAKE_LOGFILE ; Generate Log file for with UBROF ; information UBROF_INVERTED_BIT_FIELDS ; Invert bit fields positions inside ; defining structure UBROF_INCREMENT_BIT_FIELDS_ADDRESS ; For bit-field variables with bit offset ; greater than 7, the bit offset is devided ; by 8 and the byte address is incremented. ; This option is active only when used with ; any bit inversion flags [PDB] ; Settings for PDB reader MAP_MAX_ARRAY ; Maximum number of variables to be expanded ; from arrays PDB_ARRAY_INDEX_FORM ; specify array index form (default -1) ; -1: array._1_._22_._333_ ; 0: array._1_._22_._333_ ; 1: array[1][22][333] ; 2: array_1_22_333_ ; 3: array_001_022_333_ ; 4: array._001_._022_._333_ PDB_UNDERLINE_PREFIX ; Create '_' prefix for global variables ; names and data member names PDB_REMOVE_LEADING_UNDERSCORE ; Remove the leading underscore from all ; variable names PDB_MAX_TYPE_IN_DETAIL ; Use this option to get a deeper resolution of ; sub structures [DATATYPES] ; settings for the update of data types ENABLE_UPDATE ; Enables the update of data types for ; measurement objects and scalar calibration ; objects (VALUEs) UPDATE_BASE_TYPES ; Updates the base data types if the data ; type update is enabled. UPDATE_BIT_OFFSETS ; Updates the bitmasks if the data type ; update is enabled. UPDATE_CURVES_AND_MAPS ; enable datatype update also for curves, maps ; and common axes instead of only scalar objects DELETE_ADDRESS_OFFSETS ; If this parameter is set, the address ; offsets in IF_DATA CANAPE_EXT will be ; deleted for those objects whose data ; type has changed. ; This could be used if objects with a big ; bit ; offset (larger than 7) are described ; in ; the source ASAP2 file by a combination ; of an address offset and a bit ; offset <= 7. DELETE_ALL_ADDRESS_OFFSETS ; If this parameter is set, the address ; offsets in IF_DATA CANAPE_EXT will be ; deleted for ALL objects, independent of ; changed data type or address. Exitcode: --------- How successful the update process was can be determined by the exit code of the program. 0 no errors, no warnings 100 no errors, but warnings in the log file the possible warnings: - Syntax error in an A2L file (later leads to program termination, but the file is still parsed at the end) - Hybrid of interface components from both ASAP2 V1.0 and ASAP2 V >= 1.20 - Syntax error in the address file (incorrect line is ignored) - Label from the address file not found 501 Incorrect command line. 502 Log file cannot be opened. 503 More than one source file was entered. 504 No source file was entered. 506 Syntax error in the ASAP2 source file. 507 Output file cannot be written. 508 More than one output file given 509 No Output file was entered. 510 File with command line parameters cannot be read 511 No address file was entered. 514 Parameters -X and -F cannot be combined. 515 Error in MAP reader DLL 516 More than one MAP file given 517 Path for INI file not unique 600 Not enough memory space. =============================================================================== ASAP2 Creator =============================================================================== Commandline parameters: ----------------------- When the program is called the following commandline parameters can be specified: -L Name of the log file for warnings and error messages. If no logfile is specified the messages are output to the screen. -I File name of the initialization file (full path,) Initialization file: -------------------- The initialization file ASAP2Creator.INI is expected in current directory per default. Alternatively, a different directory can be set in the commandline. In the initialization file the behaviour of the creator can be controlled. The following settings are possible: [FILES] ; Settings for files to be used SOURCE_FILES = n ; Number of source code files SOURCE_FILE_ = "..." ; Name of source code file ; (numbers start with 1) ; The file name may contain path information ; and wildcards USE_WILDCARDS = 1 ; Set this parameter to 0 to directly use the ; specified source filenames SEARCH_RECURSIVE = 0 ; Search sub directories for source files ASAP2_MASTER = "..." ; Name of the ASAP2 master file MACRO_DEFINITION = "..." ; Name of file with macro definitions OUTPUT = "..." ; Name of ASAP2 file to be created [OPTIONS] ; Common settings START_SYMBOL = "@@" ; Start symbol for Creator declaration ; in C code comment ; must always consist of 2 characters and must ; neither contain '/' nor '*' MAP_SYMBOL_PREFIX = "" ; Prefix for generation of linker map references MAP_FORMAT_SUPPORTS_STRUCTURES = 1 ; 1: Used map format supports structures (e.g. ELF) ; 0: Used map format doesn't support structures DISABLE_REFERENCE_CHECK = 0 ; 0: References to master objects (e.g. conbversion rules) ; are checked for existance ; 1: Check is diabled CREATE_WHOLE_FILE = 0 ; 0: The output file contains only the fragment with created ; measure and calibration objects ; 1: The output file is a complete ASAP2 file and contains ; additionally all objects of the master file ; !!! ATTENTION !!! ; This mode is NOT supported for master files with more ; than one module. CREATE_ROOT_GROUP = 1 ; 1: One root group is created for the destination file. All ; other generated groups are child gropus of this one. ; 0: No implicit root group is created. ; More than one user root groups are possible CREATE_FUNCTIONS = 0 ; Must be be set to 1 to force the ASAP2 Creator to create ; FUNCTION objects in ASAP2 file instead of GROUP objects ASAP2_VERSION ; Optionally an output file corresponding to ASAP2 format ; 1.50 or 1.40 can be created (default is 1.60) Exitcode: --------- How successful the update process was can be determined by the exit code of the program. 0 no errors, no warnings 1 no errors, but warnings in the log file 2 error messages in log file =============================================================================== ASAP2 Comparer =============================================================================== Commandline parameters: ----------------------- When the program is called the following commandline parameters can be specified: -A Name of the first ASAP2 input file to be compared -B Name of the second ASAP2 input file to be compared -L Name of the log file for warnings, error messages and informations. If no logfile is specified the messages are output to the screen. -I File name of the initialization file (full path,) -D Name and path for the result file which will contain all found differences. If this parameter is omitted, the console will be used. Initialization file: -------------------- The initialization file Comparer.INI is expected in current directory per default. Alternatively, a different directory can be set in the commandline. In the initialization file the behaviour of the creator can be controlled. The following settings are possible: [OPTIONS] ; Common settings for the comparison BITMASK_VS_DATATYPE = 1 ; Missing bitmasks, empty bitmasks (0) and full bitmasks ; (e.g. 0xFF for data type UBYTE) are considered as equal. IGNORE_ADDRESS_FOR_VIRTUAL = 0 ; Addresses of virtual measure objects are ignored for comparison USE_ALIGNMENT_DEFAULT = 1 ; Use the default alignment according to ASAP2 specification ; for comparison if no alignment is specified USE_ARRAY_SIZE_DEFAULT = 1 ; missing ARRAY_SIZE flag for a measure object is interpreted as ; ARRAY_SIZE 1 USE_BYTE_ORDER_DEFAULT = 1 ; Use the default byte order according to ASAP2 specification for ; comparison if no byte order is specified USE_DEPOSIT_DEFAULT = 1 ; Use the default deposit of the device for comparison if no ; DEPOSIT is specified for an axis. If no deposit is specified for ; the device, the default value ABSOLUTE is used for comparison. USE_EXTENDED_LIMITS_DEFAULT = 1 ; Use the default limits of an calibration object for comparison ; if EXTENDED_LIMITS is missing. USE_MATRIX_DIM_DEFAULT = 1 ; A missing MATRIX_DIM keyword is interpreted as MATRIX_DIM 1 1 1 MATRIX_DIM_VS_ARRAY_SIZE = 0 ; For comparison, the obsolete keyword ARRAY_SIZE is converted into ; MATRIX_DIM IGNORE_ADDRESS_CHANGE = 0 ; Measure and calibration objects are considered as equal, if only ; the address has changed. USE_FORMAT_DEFAULT = 1 ; Use the format settings of the referenced conversion method if no ; FORMAT is specified for a measure or calibration object USE_UNIT_DEFAULT = 1 ; Use the unit of the referenced conversion method if no PHYS_UNIT ; is specified for a measure or calibration object IGNORE_READONLY_FOR_FIX_AXIS = 1 ; READ_ONLY settings for fix axes are ignored for comparision DIFF_FILE_FORMAT = 1 ; Format of the result file which contains all found differences. ; This parameter is operative only if a distinct result file has been ; specified. ; Possible values are: ; 1 – Logfile: One line is written to the result file for each found ; difference. ; 2 – CSV: The differences are written as a ‘;’-separated table which ; can be opened with a spreadsheet application. ; 3 – XML: The differences are written using a simple XML-Syntax which ; is convenient for further processing. DIFF_FILE_XML_STYLESHEET ; In case of XML format of the result file, this parameter can be used ; to specify a path to a xsl-stylesheet. This is a textual option. ; Note: the Comparer Demo contains the stylesheet COMPARISON.XSL which ; can be used to format the XML file as HTML page. Just open the ; generated XML file with a web browser. DIFF_FILE_GROUPING = 1 ; This option specifies the grouping of entries in the result file. ; Possible values are: ; 0 – no grouping ; 1 – group by object type of the differences [FILTER] ; Settings to reduce the compare data COMPARE_IF_DATA = 1 ; If active, the IF_DATA section are compared, too. Otherwise they ; are ignored USE_REGULAR_EXPRESSIONS = 1 ; Defines whether the name filters shall be interpreted as regular ; expressions or as wildcard expressions MEASUREMENT_TO_COMPARE ; Name filter for measure objects. Only measure objects whose name matches ; this filter are compared. CHARACTERISTIC_TO_COMPARE ; Name filter for characteristic objects. Only characteristic objects ; whose name matches this filter are compared. AXIS_PTS_TO_COMPARE ; Name filter for axis objects. Only axis objects whose name matches ; this filter are compared. CONVERSION_METHOD_TO_COMPARE ; Name filter for conversion methods. Only conversions whose name ; matches this filter are compared. CONVERSION_TABLE_TO_COMPARE ; Name filter for conversion tables. Only tables whose name matches this ; filter are compared. GROUP_TABLE_TO_COMPARE ; Name filter for groups. Only groups whose name matches this filter ; are compared. FUNCTION_TO_COMPARE ; Name filter for functions. Only functions whose name matches this ; filter are compared. RECORD_LAYOUT_TO_COMPARE ; Name filter for record layouts. Only layouts whose name matches this ; filter are compared. FRAME_TO_COMPARE ; Name filter for frames. Only frames whose name matches this filter are ; compared. UNIT_TO_COMPARE ; Name filter for units. Only units whose name matches this filter are ; compared. Exitcode: --------- How successful the update process was can be determined by the exit code of the program. 0 no errors, no warnings 1 no errors, but warnings in the log file 2 error messages in log file