Difference between revisions of "A2lPrep"
Line 5: | Line 5: | ||
[[File:A2lPrep_Overview.png]] | [[File:A2lPrep_Overview.png]] | ||
− | A2lPrep can be used to convert manually written C-source files | + | A2lPrep can be used to convert manually written C-source files containing special comments together with the corresponding .map file (produced by compilation) into an ASAP2 (.a2l) file. The special comments specify meta information such as data type, conversion rules, min-max conditions, structures, arrays, etc. |
− | + | A2lPrep combines this meta information together with the addresses from the .map file to produce an ASAP2 file. | |
+ | HANtune uses ASAP2 files to tune/calibrate your target system. | ||
No extra code-generation tools are needed to perform this operation. When you have your project prepared for communication with HANtune, you only need to compile your source code. Then the output .map file from the compiler, together with your C sources will be input for A2lPrep. | No extra code-generation tools are needed to perform this operation. When you have your project prepared for communication with HANtune, you only need to compile your source code. Then the output .map file from the compiler, together with your C sources will be input for A2lPrep. | ||
+ | A2lPrep can be integrated in your target build process. | ||
+ | |||
== Basic Operation == | == Basic Operation == | ||
Line 20: | Line 23: | ||
- Output ASAP2 file (*.a2l). Existing file with the same name will be overwritten. | - Output ASAP2 file (*.a2l). Existing file with the same name will be overwritten. | ||
The extension is leading. Only the above extensions (upper- or lower-case) are allowed. | The extension is leading. Only the above extensions (upper- or lower-case) are allowed. | ||
+ | |||
+ | As a prerequisite the source code needs to compile without an error. |
Revision as of 12:35, 23 March 2018
Introduction
A2lPrep is a commandline tool for preparing ASAP2 .a2l files from a C++ language target project. The .a2l file created by A2lPrep can then be loaded into HANtune for calibration. ASAP2 is a data definition standard to use for data measurement, calibration, and diagnostic systems. HANtune uses ASAP2 files for displaying parameters and signals.
A2lPrep can be used to convert manually written C-source files containing special comments together with the corresponding .map file (produced by compilation) into an ASAP2 (.a2l) file. The special comments specify meta information such as data type, conversion rules, min-max conditions, structures, arrays, etc. A2lPrep combines this meta information together with the addresses from the .map file to produce an ASAP2 file. HANtune uses ASAP2 files to tune/calibrate your target system.
No extra code-generation tools are needed to perform this operation. When you have your project prepared for communication with HANtune, you only need to compile your source code. Then the output .map file from the compiler, together with your C sources will be input for A2lPrep. A2lPrep can be integrated in your target build process.
Basic Operation
A2lPrep is a command line tool. You need to provide the input files and output file on the command line.
Enter on commandline any combination of:
- Desired source files (*.c or *.h). Multiple files are allowed. - Corresponding address file (*.sym or *.map) - Output ASAP2 file (*.a2l). Existing file with the same name will be overwritten.
The extension is leading. Only the above extensions (upper- or lower-case) are allowed.
As a prerequisite the source code needs to compile without an error.