Hands-On: Full ECU Reprogramming Sequence

#!/usr/bin/env python3
# Full ECU reprogramming sequence: SBL → App → Cal
import udsoncan, time
from udsoncan.client import Client

def full_reprogramming(client, sbl_path: str, app_path: str, cal_path: str):
    print("=== ECU Reprogramming Sequence ===")

    # Pre-conditions
    speed = read_did_uint16(client, 0xF40D)
    assert speed == 0, f"PRE-COND FAIL: vehicle moving at {speed} km/h"
    vbat  = read_did_uint16(client, 0xFD01) / 1000.0
    assert 11.5 <= vbat <= 14.5, f"PRE-COND FAIL: battery {vbat}V"
    print(f"Pre-conditions: speed=0 km/h, battery={vbat}V — OK")

    # Session transition
    client.change_session(udsoncan.services.DiagnosticSessionControl.Session.extendedDiagnosticSession)
    client.communication_control(0x03, 0x01)  # disable non-diag CAN TX
    security_access(client, level=1)
    client.change_session(udsoncan.services.DiagnosticSessionControl.Session.programmingSession)
    security_access(client, level=2)
    print("Session established, security unlocked")

    # Download and activate SBL
    download_sbl(client, sbl_path)
    print("SBL active")

    # Flash application block
    erase_and_program(client, 0x80080000, 0x780000, app_path)
    print("Application programmed")

    # Flash calibration block
    erase_and_program(client, 0x80800000, 0x800000, cal_path)
    print("Calibration programmed")

    # Check dependencies
    resp = client.routine_control(0x01, 0xFF01, b'')
    assert resp.positive, "Dependency check FAILED"
    print("Dependency check passed")

    # ECU reset
    client.ecu_reset(0x03)  # hard reset
    time.sleep(5)
    print("ECU reset complete")

    # Post-flash verification
    client.change_session(udsoncan.services.DiagnosticSessionControl.Session.extendedDiagnosticSession)
    sw_version = read_did_bytes(client, 0xF189)
    print(f"New SW version: {sw_version.hex()}")
    print("=== Reprogramming COMPLETE ===" )

#!/usr/bin/env python3
# Post-flash verification: confirm ECU is running new firmware correctly
import udsoncan
from udsoncan.client import Client

def verify_after_reprogramming(client, expected_sw_version: str):
    client.change_session(udsoncan.services.DiagnosticSessionControl.Session.extendedDiagnosticSession)

    checks = []

    # 1. SW version matches expected
    resp = client.read_data_by_identifier(0xF189)
    sw_ver = resp.service_data.values[0xF189].hex()
    checks.append(("PASS" if sw_ver == expected_sw_version else "FAIL",
                   f"SW version: {sw_ver} (expected {expected_sw_version})"))

    # 2. No programming-related DTCs
    resp = client.get_dtc_by_status_mask(0x08)  # confirmed
    prog_dtcs = [d for d in resp.service_data.dtcs
                 if (d.id >> 16) & 0xFF == 0x70]  # U-code network/prog DTCs
    checks.append(("PASS" if not prog_dtcs else "FAIL",
                   f"Programming DTCs: {len(prog_dtcs)} (expected 0)"))

    # 3. ECU responds to standard DID read (application running)
    resp = client.read_data_by_identifier(0xF190)  # VIN
    checks.append(("PASS" if resp.positive else "FAIL", "VIN readable (application active)"))

    for status, desc in checks:
        print(f"[{status}] {desc}")

    return all(c[0] == "PASS" for c in checks)