Hands-On: Tool-Based Calibration Project

import inca_com as inca, time

inca.Connect("ECU_Engine_v2.3.a2l", channel="ES592_CAN1")

# Add measurements to DAQ
inca.AddMeasurement("actual_idle_speed", event="event_10ms")
inca.AddMeasurement("idle_controller_integrator", event="event_10ms")
inca.AddMeasurement("coolant_temp_degC", event="event_100ms")

inca.StartRecording("idle_cal_session_001.mf4")
inca.StartMeasurement()

# Step 1: check baseline
baseline = inca.GetCharacteristic("idle_setpoint")
print(f"Baseline idle_setpoint = {baseline} rpm")  # 750

# Step 2: raise setpoint to 800 rpm
inca.SetCharacteristic("idle_setpoint", 800.0)
time.sleep(3.0)  # wait for PID settle

actual = inca.GetMeasurementAverage("actual_idle_speed", window_ms=1000)
print(f"After 800 rpm setpoint: actual = {actual:.0f} rpm")

# Step 3: raise to 850 rpm
inca.SetCharacteristic("idle_setpoint", 850.0)
time.sleep(3.0)
actual = inca.GetMeasurementAverage("actual_idle_speed", window_ms=1000)
print(f"After 850 rpm setpoint: actual = {actual:.0f} rpm")

# Step 4: test COPY_CAL_PAGE (persist 850 rpm)
inca.CopyCalPage(source=0, dest=1)  # working → reference
print("Changes saved to Flash reference page")

inca.StopMeasurement()
inca.StopRecording()
inca.Disconnect()

/* CANape exercise: observe active cells in throttle_torque_map during load sweep */

on start {
    Connect();
    StartMeasurement();

    /* Open 3D map window (done manually in GUI — cannot script window layout) */
    /* The map window shows throttle_torque_MAP with live active-cell highlight */

    /* Perform a slow throttle sweep to visit all map cells */
    Write("Performing throttle sweep — watch 3D map active cell tracking...");
    Wait(30000);  /* 30 second sweep controlled by dyno operator */

    /* After sweep: identify cells with zero visit count */
    /* These cells were never interpolated → may safely use estimated values */
    int visited = CountVisitedMapCells("throttle_torque_MAP");
    int total   = GetMapCellCount("throttle_torque_MAP");
    Write("Visited %d/%d map cells during sweep", visited, total);

    StopMeasurement();
    SaveMeasurement("throttle_map_sweep.mf4");
    Disconnect();
}

#!/bin/bash
# Post-session documentation export
inca_cli.exe export_changelog     --experiment "ECU_Engine_dev"     --from "2026-02-15 09:00"     --to   "2026-02-15 17:00"     --output "session_changelog_20260215.xlsx"

inca_cli.exe export_dataset     --dataset "idle_ramp_v2_validated"     --format DCM     --output "idle_ramp_v2_validated.dcm"

echo "Session documentation complete"