Hands-On: A2L File Creation

#!/usr/bin/env python3
# Extract calibration section symbols from arm-none-eabi-ld MAP file
# Generates CSV for scripted A2L generation

import re, csv

def extract_calibration_symbols(mapfile, cal_section=".cal_data"):
    symbols = []
    in_cal_section = False

    with open(mapfile) as f:
        for line in f:
            # Detect entry into calibration section
            if cal_section in line:
                in_cal_section = True
            elif in_cal_section and re.match(r'^\.[a-z]', line):
                in_cal_section = False  # new section started

            if in_cal_section:
                # Match symbol lines: address size name
                m = re.match(r'\s+(0x[0-9a-f]+)\s+(0x[0-9a-f]+)\s+(\w+)', line)
                if m:
                    addr, size, name = m.group(1), m.group(2), m.group(3)
                    symbols.append({
                        "name": name,
                        "address": int(addr, 16),
                        "size": int(size, 16)
                    })
    return symbols

symbols = extract_calibration_symbols("ECU_Engine.map")
with open("cal_symbols.csv", "w", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=["name", "address", "size"])
    writer.writeheader()
    writer.writerows(symbols)
print(f"Extracted {len(symbols)} calibration symbols")

#!/usr/bin/env python3
# Generate A2L CHARACTERISTIC blocks from cal_symbols.csv
import csv

TYPE_MAP = {
    1: ("_UBYTE_Z", "UBYTE"),
    2: ("_UWORD_Z", "UWORD"),
    4: ("_ULONG_Z", "ULONG"),
}

with open("cal_symbols.csv") as f:
    symbols = list(csv.DictReader(f))

a2l_blocks = []
for sym in symbols:
    size = int(sym["size"])
    addr = int(sym["address"])
    layout, dtype = TYPE_MAP.get(size, ("_FLOAT32_IEEE_Z", "FLOAT32_IEEE"))

    block = f"""
/begin CHARACTERISTIC
  {sym['name']}
  "{sym['name']} — TODO: add description"
  VALUE
  0x{addr:08X}
  {layout}
  0.0
  NO_COMPU_METHOD
  -1e9
  1e9
  /* TODO: set correct COMPU_METHOD, LOWER_LIMIT, UPPER_LIMIT */
/end CHARACTERISTIC"""
    a2l_blocks.append(block)

print(f"Generated {len(a2l_blocks)} CHARACTERISTIC blocks")
with open("generated_chars.a2l", "w") as f:
    f.writelines(a2l_blocks)

import inca_com as inca

inca.Connect("ECU_Engine.a2l", channel="ES592_CAN1")

# Verification pairs: (characteristic_name, known_value_in_reference_page)
verification_pairs = [
    ("IDLE_RPM_TARGET",    800.0),
    ("LAMBDA_TARGET",      1.0),
    ("IGN_TIMING_OFFSET",  0.0),
]

all_ok = True
for name, expected in verification_pairs:
    actual = inca.GetCharacteristic(name)
    status = "OK" if abs(actual - expected) < 0.01 else "FAIL"
    print(f"{status}: {name} = {actual} (expected {expected})")
    if status == "FAIL":
        all_ok = False
        print(f"  → Check ECU_ADDRESS in A2L vs MAP file symbol address")
        print(f"  → Check BYTE_ORDER in MOD_COMMON matches compiler target")
        print(f"  → Check RECORD_LAYOUT data type matches C variable type")

inca.Disconnect()
print("Round-trip verification", "PASSED" if all_ok else "FAILED")