Calibrate ESC

Automated ESC (Electronic Stability Control) calibration tool that iterates through vehicle configs and runs measurement tests.

Overview

util_calibrateESC automates ESC calibration by loading each vehicle configuration on a test level, spawning the vehicle, and running the vehicle-side escMeasurement extension. Uses the job system for async operation with watchdog timeouts.

Extension path: lua/ge/extensions/util/calibrateESC.lua

Exports (M)

Internals

Test Pipeline

1. work(pcFile, vehicle) is called with optional filters.
2. If the test level (/levels/smallgrid/info.json) is not loaded, it loads it.
3. A job system coroutine iterates through all vehicle configs:
   • Filters by vehicleToTest and pcFileToTest if specified.
   • Skips configs in vehicleBlacklist.
   • Skips configs that already have a .touched info file.
4. For each config:
   • Replaces the current vehicle with core_vehicles.replaceVehicle().
   • Waits for the new vehicle to appear.
   • Positions it at origin (0, 0, 0.5).
   • Loads and runs escMeasurement.performTests() on the vehicle.
   • Waits until moveNext is set, watchdog triggers (20s no heartbeat), or max runtime (10M ms) exceeded.

Blacklist

Loaded from blacklist.json or blacklistDefault.json at extension load. Vehicles in the blacklist are skipped entirely.

Watchdog

The vehicle-side code must call heartbeat() periodically. If no heartbeat arrives within 20 seconds, the test is aborted and moves to the next config.

How It Works

1. Load the extension and call work() with optional filters.
2. The system loads the smallgrid test level.
3. Each config is tested sequentially via the job system.
4. The vehicle-side escMeasurement extension performs the actual tests.
5. Results are written as .touched files to prevent re-testing.
6. After all configs, the game shuts down with shutdown(0).

Lua Examples

-- Run calibration on all vehicles
extensions.util_calibrateESC.work()

-- Run calibration for a specific vehicle
extensions.util_calibrateESC.work(nil, "pickup")

-- Run calibration for a specific config
extensions.util_calibrateESC.work("sport_config", "pickup")

-- Vehicle-side heartbeat (called from escMeasurement)
extensions.util_calibrateESC.heartbeat()
extensions.util_calibrateESC.vehicleDone()

Additional Exports

• M.heartbeat - (undocumented)
• M.onClientStartMission - (undocumented)
• M.onExtensionLoaded - (undocumented)
• M.onExtensionUnloaded - (undocumented)
• M.onInit - (undocumented)
• M.vehicleDone - (undocumented)
• M.work - (undocumented)