Guide · ECU calibration files
A2L and HEX files
The A2L tells you what a calibration object means. The image holds its bytes. Both must describe the same ECU software before a map edit can be trusted.
In short
An A2L (ASAP2) file describes ECU measurement and calibration objects: their names, memory addresses, data types, record layouts, axes, conversion rules and units. A HEX, S-record or BIN file carries the programmed bytes and address ranges. To read a map in engineering units, a calibration tool uses the A2L to locate and decode the corresponding bytes in the image. The files must match the same ECU software and memory layout. A plausible-looking value is not proof of a match; verify identifiers, addresses, conversion and sample maps before changing anything. After an edit, validate changed bytes, checksums where applicable, and the exported image against the original.
01
What is an A2L file, and what does each file contain?
The A2L is a description, not a second copy of the calibration image. It names CHARACTERISTIC objects such as constants, curves and maps, and defines how their raw memory representation becomes a value an engineer can use. It can also describe measurement signals, conversions and the ECU interface used by a measurement and calibration tool.
The image contains bytes. Intel HEX and Motorola S-record encode addresses and data in text records; a raw BIN is just bytes and needs an agreed address base. An image can contain code as well as calibration data, so an address alone does not tell you which value is safe to edit.
- A2L / ASAP2Object name, ECU address, type, axes, record layout, conversion and units.
- HEX / S-recordAddressed data records from an ECU image.
- BINRaw bytes; the base address and segment mapping must be supplied separately.
- CDFXAn exchange format for calibration parameter values and metadata, rather than a flash image.
02
Intel HEX to A2L mapping: how do you match them?
Start with the ECU software identity and project variant. Then compare the A2L memory segments and addresses with the image ranges. Decode several known objects of different types, including at least one map with axes, and check that the values and units are credible against the released dataset or measured behaviour.
A shifted address range, changed record layout or different conversion method can still produce numbers that look reasonable. That is why a visual spot check of one cell is not enough. Treat a mismatch as a stop condition, find the correct A2L and image pair, and repeat the checks before writing.
- Confirm identityUse the programme, variant and software identifiers available from the release package.
- Check address coverageEvery object you intend to change must resolve inside the expected image segment.
- Check interpretationCompare dimensions, axes, conversions and units with a trusted reference.
- Keep originalsRecord the input files and hashes so the change can be reproduced and reviewed.
03
What is a safe map-edit workflow?
Open the matching A2L and image, select the named calibration object, inspect its axes and physical conversion, then change only the intended cells. Export a diff that identifies the object, the old and new engineering values, and the raw bytes affected. Validate bounds and dependencies before accepting the change.
Checksums are ECU- and image-specific. A tool may support the applicable checksum algorithm, but the result still needs verification against the target ECU or release procedure. Keep the original image, the edited image, the validation result and the test evidence together. The vehicle measurement that justified the edit is usually an MDF4 recording, which is a different file format from the calibration image.
04
How VehicleLab tools fit together
XHandbook connects a documented function to the A2L label and its address, layout and conversion. Hexx opens the image with that A2L so the engineer can inspect and edit named objects in engineering units. MDX reads the MDF4 measurement before and after the change, and HELIX keeps the proposed dataset, checks and approval history together for release.
These are different jobs. Documentation explains the intent, the A2L explains the memory representation, the image holds the bytes, and the measurement shows what the ECU actually did. Keeping those roles separate makes a calibration decision easier to verify.
The instruments
What does what.
- DOCUMENTATION & MODEL GRAPHXHandbookFind the documented function and resolve its label to the A2L object.→
- BYTE-TO-MAP MATRIXHexxInspect and edit the named map in the matching ECU image.→
- OSCILLOSCOPE LAB & MCPMDXCompare MDF4 measurements that motivated and validated the change.→
- RELEASE GOVERNANCE GATEWAYHELIXReview the dataset change and retain validation evidence through release.→
Standards & references
Check the source.
These primary sources define the formats and regulatory context discussed above. They do not certify or endorse VehicleLab products.
Questions
Frequently asked.
What is an A2L file, and is it the same as a HEX file?
No. The A2L describes calibration and measurement objects, including addresses and conversions. The HEX, S-record or BIN image contains the bytes programmed into the ECU. A tool uses both to show a named map in engineering units.
How to read ECU hex file contents without an A2L?
You can inspect its raw bytes and address records, but you cannot reliably identify named maps, axes, units or physical conversions from the image alone. A matching A2L or equivalent verified description is needed for meaningful calibration editing.
What is the A2L and HEX file relationship, and why must versions match?
A software update can move objects, change record layouts or alter conversion methods. A mismatched description can decode the wrong bytes or write a value to the wrong place even when the displayed number looks plausible.
Is an MF4 file a calibration image?
No. MF4 is an ASAM MDF measurement recording containing time-series data and metadata. It can show how a calibration behaved during a test; it is not the HEX or BIN image that carries the calibration values.
What should be checked after a map edit?
Check the changed object and raw-byte diff, bounds and dependent maps, the applicable checksum or integrity procedure, and the image on the target ECU through the normal validation process. Keep the original and edited files with the test evidence.
Next step
Open one of your own files with us.
Send a measurement, an A2L or an EHANDBOOK container. We will open it in the instruments on a call, with your engineers in the room.
