a2ltool User Manual

a2ltool is a command line utility that helps you work with a2l files.

A2L files describe measurement variables and tunable parameters of an embedded device (typically: an automotive ECU).

Features

You can:

• create A2L files from scratch
• merge multiple a2l files
• update the information in an a2l file based debug info of the software
• delete existing elements
• check the consistency of a file

Installation

a2ltool binaries are available on the github releases page. You can get pre-built binaries for Windows (x64) and Linux (x64) there.

For any other platforms you can clone the git repository and compile it as ususal, using cargo build --release.

Quick start

Every invocation of a2ltool requires either an input file name, or the parameter --create to start with an empty file. Whenever you want to write output to a file, you must use the --output parameter. A minimal call to a2ltool that does not perform any actions by itself looks like this:

a2ltool input.a2l --output output.a2l

or

a2ltool --create --output output.a2l

You can add any additional parameters you need to this basic command.

Note

By default, a2ltool is silent; only errors are printed to the console.

While getting started with a2ltool, you may find it useful to use the --verbose (or -v) option to enable additional output.

Basic examples

Merging

a2ltool input.a2l --merge other.a2l --output output.a2l

Updating

a2ltool input.a2l --elffile ecu_software.elf --update -v --output output.a2l

Support

If you encounter any bugs, you can report them in the issue tracker on Github.