epicEFI Wiki - User contributions [en]

https://content.epicefi.com/wiki/api.php?action=feedcontributions&feedformat=atom&user=Joesphan epicEFI Wiki - User contributions [en] 2026-08-29T07:02:33Z User contributions MediaWiki 1.45.1 https://content.epicefi.com/wiki/index.php?title=Lua&diff=501 Lua 2026-08-18T04:08:53Z

<p>Joesphan: </p> <hr /> <div>= Lua Scripting =<br /> <br /> '''TL;DR:''' Connect with TunerStudio, open the '''Lua''' tab (or use epicEFI Console), and edit your script there. Lua runs on the ECU for live scripting. The most popular use case is CAN bus integration.<br /> <br /> == Introduction ==<br /> <br /> epicEFI gives you a lot of flexibility — enough to build user-defined control strategies for primary and auxiliary actuators. Boards with an '''F7''' or '''H7''' MCU (EpicECU, M144H7, M144F7RED, etc.) have the most headroom for Lua. F4 boards (MEGA100F4, UAEFI) also support Lua but with tighter memory limits.<br /> <br /> == Variable names and hashes ==<br /> <br /> Calibration names, output channel names, variable types (CONFIG GETTER/SETTER, OUTPC GETTER/SETTER), and their '''djb2 hashes''' depend on your exact firmware build. Do not guess — look them up here:<br /> <br /> '''[https://content.epicefi.com/docs/variable_status_selector.html Variables Lookup]'''<br /> <br /> Use this tool when calling <code>getCalibration()</code> / <code>setCalibration()</code>, <code>getOutput()</code>, configuring user-table axes, or reading/writing variables over EPIC CAN.<br /> <br /> == Basics ==<br /> <br /> epicEFI provides hooks to interface with the firmware, manipulate its state, and read/write configuration:<br /> <br /> * [[#CAN bus|Hooks for CAN bus communications]]<br /> * [[#Input|Inputs from sensors can be read directly]]. [[#Set sensor value|You can also produce sensor values]] with Lua.<br /> * [[#Output|ECU general purpose outputs]]<br /> * [[#Engine control|Aspects of the engine can be controlled directly]]<br /> * ECU configuration can be accessed (read/write) via [[#getCalibration(name)|<code>getCalibration()</code>]] and [[#setCalibration(name, value, needEvent)|<code>setCalibration()</code>]].<br /> ** Valid calibration names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * ECU internal state (logic outputs / Live Data values) can be read via [[#getOutput(name)|<code>getOutput()</code>]], and some can be changed via dedicated setters (e.g. [[#setClutchUpState(value)|<code>setClutchUpState()</code>]]). See [[#Output|Output]].<br /> ** Valid output names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * Hooks to read values from SENT sensors; see [[#SENT protocol|SENT protocol]].<br /> * Useful helper routines; see [[#Utility|Utility]].<br /> <br /> Some example uses are in [[#Examples|Examples]].<br /> <br /> == Conventions ==<br /> <br /> * The Lua interpreter reports errors when something is wrong; check epicEFI Console / TunerStudio Lua output for errors and <code>print()</code> output.<br /> * Unless otherwise noted, all <code>index</code> parameters are '''zero-based''' (first element is index <code>0</code>).<br /> <br /> == Writing Your Script ==<br /> <br /> The entire Lua script is loaded at startup. After that, a function named <code>onTick</code> is called periodically by epicEFI.<br /> <br /> Simple startup example:<br /> <br /> <pre><br /> print('Hello Lua startup!')<br /> <br /> function onTick()<br /> print('Hello onTick()')<br /> end<br /> </pre><br /> <br /> === Controlling the tick rate ===<br /> <br /> <code>setTickRate(hz)</code> sets how often epicEFI calls <code>onTick</code>. If your script does heavy work, it may run slower than the requested rate. The Lua VM runs at low priority relative to engine control, so you cannot starve critical ECU functions — set the rate to whatever your script needs. <code>onCanRx</code> runs at the same rate as <code>onTick</code>.<br /> <br /> <pre><br /> n = 0<br /> setTickRate(5) -- 5 Hz<br /> function onTick()<br /> print('Hello Lua: ' .. n)<br /> n = n + 1<br /> end<br /> </pre><br /> <br /> === Editing scripts ===<br /> <br /> An editor with [https://github.com/LuaLS/lua-language-server#install Lua Language Server] (LSP) support makes writing scripts much easier.<br /> <br /> == Hooks / function reference ==<br /> <br /> === User settings ===<br /> <br /> ==== <code>getOutput(name)</code> ====<br /> <br /> Example: <code>getOutput("clutchUpState")</code> or <code>getOutput("brakePedalState")</code>.<br /> <br /> Valid output names for your firmware: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setClutchUpState(value)</code> ====<br /> <br /> ==== <code>setBrakePedalState(value)</code> ====<br /> <br /> Use <code>setBrakePedalState</code> to report a CAN-based brake pedal to epicEFI.<br /> <br /> ==== <code>setAcRequestState(value)</code> ====<br /> <br /> Use <code>setAcRequestState</code> to report a CAN-based A/C request.<br /> <br /> ==== <code>setEtbDisabled(value)</code> ====<br /> <br /> ==== <code>setIgnDisabled(value)</code> ====<br /> <br /> Use <code>setIgnDisabled</code> for cranking safety and other ignition-cut strategies.<br /> <br /> ==== <code>setAcDisabled(value)</code> ====<br /> <br /> Disable/suppress A/C regardless of how it would otherwise be enabled.<br /> <br /> ==== <code>getTimeSinceAcToggleMs()</code> ====<br /> <br /> ==== <code>getCalibration(name)</code> ====<br /> <br /> Returns the current value of a scalar calibration setting. Example: <code>getCalibration("cranking.rpm")</code>.<br /> <br /> Full list of valid names: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setCalibration(name, value, needEvent)</code> ====<br /> <br /> Sets a calibration value. Optionally fires a calibration change event depending on <code>needEvent</code>.<br /> <br /> Example: <code>setCalibration("cranking.rpm", 900, false)</code><br /> <br /> ==== <code>burnconfig</code> ====<br /> <br /> Schedules a write of current calibration to flash once the engine is stopped.<br /> <br /> ==== <code>findSetting(name, defaultValue)</code> ====<br /> <br /> Finds a user setting by name and returns its numeric value. Useful when the script author and the tuner are different people, or when editing is done only through TunerStudio fields rather than the Lua editor.<br /> <br /> * '''Parameters'''<br /> ** <code>name</code>: Variable name (matches the configuration field name)<br /> ** <code>defaultValue</code>: Returned if the setting is not found<br /> <br /> === <code>isFirmwareError</code> ===<br /> <br /> Returns <code>true</code> if the ECU is in a critical/fatal error state.<br /> <br /> === Engine control ===<br /> <br /> ==== <code>startCrankingEngine()</code> ====<br /> <br /> Starts cranking as if the physical start button were pressed.<br /> <br /> ==== <code>stopEngine()</code> ====<br /> <br /> ==== <code>isEngineStopRequested()</code> ====<br /> <br /> Returns <code>true</code> if an engine stop was requested (by Lua or the start/stop button) within the last five seconds.<br /> <br /> ==== <code>setLaunchTrigger</code> ====<br /> <br /> ==== <code>setSparkSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkSkipRatio(0)</code> — skip 0% of ignition events (no skip)<br /> * <code>setSparkSkipRatio(0.5)</code> — skip half of ignition events (never two consecutive skips)<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setSparkHardSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkHardSkipRatio(0)</code> — no skip<br /> * <code>setSparkHardSkipRatio(0.75)</code> — skip 75% of ignition events<br /> <br /> ==== <code>setIdleAdd(percent)</code> ====<br /> <br /> Percent added to idle (including open loop).<br /> <br /> ==== <code>setFuelAdd(amount)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Fuel mass to add to injection, scaled by [[#setFuelMult(coeff)|<code>setFuelMult()</code>]]; starts at 0.<br /> <br /> ==== <code>setFuelMult(coeff)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Multiplier for added fuel mass; starts at 1.0.<br /> <br /> ==== <code>setBoostTargetAdd(amount)</code> ====<br /> <br /> Additive offset for closed-loop boost target.<br /> <br /> ==== <code>setBoostTargetMult(coeff)</code> ====<br /> <br /> Multiplier for closed-loop boost target.<br /> <br /> ==== <code>setBoostDutyAdd(amount)</code> ====<br /> <br /> Additive offset for open-loop boost duty.<br /> <br /> ==== <code>setTimingAdd(angle)</code> ====<br /> <br /> Use negative values to retard timing.<br /> <br /> ==== <code>setTimingMult(coeff)</code> ====<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setEtbAdd(percent)</code> ====<br /> <br /> ETB adder as a percent of wide-open: e.g. <code>10</code> adds +10%. Static offset on top of the computed position (TPS 5% + <code>10</code> → 15% ETB command).<br /> <br /> Useful for torque reduction.<br /> <br /> === Timer ===<br /> <br /> <code>yourTimer = Timer.new()</code> creates a timer object.<br /> <br /> ==== <code>reset</code> ====<br /> <br /> <code>yourTimer:reset()</code> resets the timer.<br /> <br /> ==== <code>getElapsedSeconds</code> ====<br /> <br /> <code>yourTimer:getElapsedSeconds()</code> returns seconds since last reset.<br /> <br /> ==== <code>getTsButtonCount</code> ====<br /> <br /> <code>getTsButtonCount(X)</code> returns how many times Lua button '''X''' was pressed in TunerStudio. See <code>ts-button-example.lua</code> in the firmware examples.<br /> <br /> === CAN bus ===<br /> <br /> ==== <code>enableCanTx(isEnabled)</code> ====<br /> <br /> Enabled by default. Use <code>enableCanTx(false)</code> to suppress CAN transmit from Lua.<br /> <br /> ==== <code>txCan(bus, ID, isExt, payload)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>bus</code>: Hardware CAN bus index — typically <code>1</code> on single-CAN boards; <code>1</code> or <code>2</code> on dual-CAN boards (EpicECU, M144H7, etc.)<br /> ** <code>isExt</code>: <code>0</code> for 11-bit standard ID<br /> <br /> ==== <code>canRxAdd(id)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id)</code> ====<br /> <br /> ==== <code>canRxAdd(id, callback)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask, callback)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>id</code>: CAN ID to listen for<br /> ** <code>mask</code>: Applied to the received ID before comparison. Example: id <code>3</code> and mask <code>0xFF</code> matches any frame whose low 8 bits are <code>3</code>. Omit the mask to match exactly one ID.<br /> ** <code>bus</code>: Hardware CAN bus index. If omitted, frames from any bus are received.<br /> ** <code>callback</code>: Function called when a matching frame arrives. If omitted, <code>onCanRx</code> is used.<br /> <br /> CAN RX callback shape:<br /> <br /> <pre><br /> function onCanRx(bus, id, dlc, data)<br /> -- handle frame<br /> end<br /> </pre><br /> <br /> For high-throughput RX, see <code>enableCanRxWorkaround()</code> in the firmware examples.<br /> <br /> === SENT protocol ===<br /> <br /> ==== <code>getSentValue(index)</code> ====<br /> <br /> ==== <code>getSentValues(index)</code> ====<br /> <br /> === PID ===<br /> <br /> <code>deltaTime</code> is measured automatically between successive <code>pid:get</code> calls.<br /> <br /> <pre><br /> -- p, i, d, min, max<br /> pid = Pid.new(2, 0, 0, -100, 100)<br /> pid:setOffset(0.3)<br /> pid:get(target, input)<br /> pid:reset()<br /> <br /> industrialPid = IndustrialPid.new(2, 0, 0, -100, 100)<br /> industrialPid:setOffset(0.3)<br /> industrialPid:setDerivativeFilterLoss(0.3)<br /> industrialPid:setAntiwindupFreq(0.3)<br /> industrialPid:get(target, input)<br /> industrialPid:reset()<br /> </pre><br /> <br /> === Utility ===<br /> <br /> ==== <code>print(msg)</code> ====<br /> <br /> Prints a line to the ECU log.<br /> <br /> * '''Parameters:''' <code>msg</code> — string or number<br /> * '''Returns:''' none<br /> <br /> ==== <code>vin(index)</code> ====<br /> <br /> Returns the VIN character at the given zero-based index.<br /> <br /> '''Example:'''<br /> <br /> <pre><br /> n = 5.5<br /> print('Hello Lua, number is: ' .. n)<br /> </pre><br /> <br /> Output: <code>Hello Lua, number is: 5.5</code><br /> <br /> ==== <code>setTickRate(hz)</code> ====<br /> <br /> Sets how often epicEFI calls <code>onTick</code> and <code>onCanRx</code>, in Hz. Default after reset is 10 Hz.<br /> <br /> * '''Parameters:''' <code>hz</code> — clamped to 1–200 Hz<br /> * '''Returns:''' none<br /> <br /> ==== <code>mcu_standby()</code> ====<br /> <br /> Puts the MCU into standby (low current). Use with care.<br /> <br /> ==== <code>interpolate(x1, y1, x2, y2, x)</code> ====<br /> <br /> Linear interpolation of <code>x</code> on the line through <code>(x1, y1)</code> and <code>(x2, y2)</code>.<br /> <br /> ==== <code>findTableIndex(name)</code> ====<br /> <br /> Returns the index of a script table by human-readable name.<br /> <br /> ==== <code>table3d(tableIdx, x, y)</code> ====<br /> <br /> Looks up a value from a script 3D table.<br /> <br /> * '''Parameters'''<br /> ** <code>tableIdx</code>: Table index (1–4)<br /> ** <code>x</code>: X-axis value (often RPM)<br /> ** <code>y</code>: Y-axis value (often load)<br /> * '''Returns:''' table output value<br /> <br /> ==== <code>findCurveIndex(name)</code> ====<br /> <br /> Returns the index of a script curve by name.<br /> <br /> ==== <code>curve(curveIdx, x)</code> ====<br /> <br /> Looks up a value from a script curve.<br /> <br /> * '''Parameters'''<br /> ** <code>curveIdx</code>: Curve index (1-based)<br /> ** <code>x</code>: Axis value<br /> <br /> ==== <code>setDebug(index, value)</code> ====<br /> <br /> Sets a debug channel when ECU debug mode is '''Lua'''.<br /> <br /> * '''Parameters:''' <code>index</code> 1–7, <code>value</code> — channel value<br /> * '''Returns:''' none<br /> <br /> === Input ===<br /> <br /> ==== <code>getSensor(name)</code> ====<br /> <br /> Reads a sensor by name, e.g. <code>getSensor("AcceleratorPedal")</code>.<br /> <br /> * '''Parameters:''' <code>name</code> — sensor name (same names as TunerStudio Live Data, e.g. <code>TPS</code>, <code>CLT</code>, <code>RPM</code>, <code>MAP</code>)<br /> * '''Returns:''' reading, or <code>nil</code> if the sensor is invalid or not configured<br /> <br /> ==== <code>getSensorByIndex(index)</code> ====<br /> <br /> Reads a sensor by enum index.<br /> <br /> * '''Returns:''' reading, or <code>nil</code> on failure<br /> <br /> ==== <code>getSensorRaw(index)</code> ====<br /> <br /> Raw sensor value (usually pin voltage before scaling).<br /> <br /> * '''Returns:''' raw value, or <code>0</code> if unsupported / not configured / failed<br /> <br /> ==== <code>getAuxAnalog(index)</code> ====<br /> <br /> Like <code>getSensorRaw</code> but for aux analog inputs — always voltage.<br /> <br /> * '''Parameters:''' <code>index</code> 0–3<br /> * '''Returns:''' voltage, or <code>nil</code> if not configured<br /> <br /> ==== <code>hasSensor(index)</code> ====<br /> <br /> Whether a sensor slot is configured (valid or not).<br /> <br /> * '''Returns:''' boolean<br /> <br /> ==== <code>getDigital(index)</code> ====<br /> <br /> Reads a built-in digital input.<br /> <br /> {| class="wikitable"<br /> |-<br /> ! Index !! Channel<br /> |-<br /> | 0 || Clutch down<br /> |-<br /> | 1 || Clutch up<br /> |-<br /> | 2 || Brake switch<br /> |-<br /> | 3 || AC switch<br /> |}<br /> <br /> ==== <code>getAuxDigital(index)</code> ====<br /> <br /> Reads a user-configured digital input (index 0–7). Configure pins under '''Lua Digital Aux Inputs''' in TunerStudio.<br /> <br /> ==== <code>readPin(pinName)</code> ====<br /> <br /> Reads an MCU pin directly (e.g. <code>"PD15"</code>). Emergency/debug only — prefer Lua aux inputs for real logic.<br /> <br /> === Output ===<br /> <br /> Not the same as Live Data “outputs” or GPPWM.<br /> <br /> ==== <code>selfStimulateRPM(rpm)</code> ====<br /> <br /> Positive RPM starts injector clicking at that speed; <code>0</code> stops self-stimulation.<br /> <br /> ==== <code>startPwm(index, frequency, duty)</code> ====<br /> <br /> Starts PWM on a Lua PWM output. Pin assignment: '''Lua PWM Outputs''' in TunerStudio.<br /> <br /> * '''Parameters'''<br /> ** <code>index</code>: 0–7<br /> ** <code>frequency</code>: 1–1000 Hz<br /> ** <code>duty</code>: 0.0 = off, 1.0 = full on<br /> <br /> ==== <code>setPwmDuty(index, duty)</code> ====<br /> <br /> ==== <code>setPwmFreq(index, frequency)</code> ====<br /> <br /> ==== <code>getGpPwm(index)</code> ====<br /> <br /> Current GPPWM output percent (index 0–3).<br /> <br /> ==== <code>setLuaGauge(index, value)</code> ====<br /> <br /> Writes a Lua gauge (indices 1–8) for Live Data / logging.<br /> <br /> ==== <code>setDacVoltage(index, value)</code> ====<br /> <br /> Only on boards with DAC hardware enabled.<br /> <br /> == Console commands ==<br /> <br /> * <code>luamemory</code> — Lua memory usage<br /> * <code>luareset</code> — reset Lua VM<br /> <br /> == Examples ==<br /> <br /> Example scripts ship with the firmware under <code>firmware/controllers/lua/examples/</code> ([https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples browse on GitHub]).<br /> <br /> Notable examples: <code>honda-bcm.txt</code> (VSS from CAN / gear detection), <code>ford-focus-ii-pps.txt</code>, <code>bmw-idrive.txt</code>.<br /> <br /> === Timer example ===<br /> <br /> <pre><br /> t = Timer.new()<br /> timingAdd = 0<br /> <br /> function onTick()<br /> auxV = getAuxAnalog(0)<br /> tps = getSensor("TPS")<br /> -- check for nil if aux input is not assigned<br /> if auxV > 2 then<br /> t:reset()<br /> end<br /> <br /> val = t:getElapsedSeconds()<br /> <br /> if t:getElapsedSeconds() < 3 then<br /> timingAdd = 10<br /> else<br /> timingAdd = 0<br /> end<br /> setTimingAdd(timingAdd)<br /> <br /> print('Hello analog ' .. auxV .. " " .. val)<br /> end<br /> </pre><br /> <br /> === PWM ===<br /> <br /> <pre><br /> startPwm(0, 100, 0)<br /> <br /> function onTick()<br /> enable_pump = getSensor("RPM") > 700 and getSensor("BatteryVoltage") > 13 and getSensor("VehicleSpeed") < 60<br /> setPwmDuty(0, enable_pump and 1 or 0)<br /> end<br /> </pre><br /> <br /> === CAN transmit ===<br /> <br /> <pre><br /> function onTick()<br /> clt = getSensor("CLT")<br /> print('CLT ' .. clt)<br /> voltage0 = getSensor("aux0")<br /> <br /> txPayload = {}<br /> txPayload[1] = math.floor(((voltage0/256) - math.floor(voltage0/256))*256)<br /> txPayload[2] = math.floor(voltage0 / 256)<br /> <br /> txCan(1, 0x600, 1, txPayload)<br /> end<br /> </pre><br /> <br /> === Set sensor value ===<br /> <br /> Use standard sensor names from TunerStudio Live Data.<br /> <br /> <pre><br /> -- do not configure the same physical input elsewhere<br /> vssSensor = Sensor.new("VehicleSpeed")<br /> vssSensor:setTimeout(3000)<br /> function onTick()<br /> injectedVssValue = 123.4<br /> vssSensor:set(injectedVssValue)<br /> valFromSensor = getSensor("VehicleSpeed")<br /> print("VSS " .. valFromSensor)<br /> end<br /> </pre><br /> <br /> === CAN receive ===<br /> <br /> <pre><br /> canRxAdd(0x500)<br /> canRxAdd(0x570)<br /> function onCanRx(bus, id, dlc, data)<br /> print('got CAN id=' .. id .. ' dlc=' .. dlc)<br /> if id == 0x500 then<br /> canState = data[1]<br /> end<br /> if id == 0x570 then<br /> mcu_standby()<br /> end<br /> end<br /> </pre><br /> <br /> === Table / curve ===<br /> <br /> <pre><br /> tableIndex = findTableIndex("duty")<br /> <br /> TurbochargerSpeed = getSensor("TurbochargerSpeed")<br /> tps = getSensor("Tps1")<br /> <br /> dutyCycle = table3d(tableIndex, TurbochargerSpeed, tps)<br /> <br /> sparkCutCurve = findCurveIndex("sparkcut")<br /> sparkCutByTorque = curve(sparkCutCurve, torquex)<br /> </pre><br /> <br /> == See also ==<br /> <br /> * [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector] — names, types, and hashes for your firmware<br /> * [https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples Lua examples] — vehicle-specific scripts<br /> * [http://lua-users.org/wiki/TernaryOperator Lua ternary operator] — Lua has no <code>?:</code>; use <code>and</code> / <code>or</code> patterns</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Lua&diff=500 Lua 2026-08-18T03:19:08Z

<p>Joesphan: /* Variable names and hashes */</p> <hr /> <div>= Lua Scripting =<br /> <br /> '''TL;DR:''' Connect with TunerStudio, open the '''Lua''' tab (or use epicEFI Console), and edit your script there. Lua runs on the ECU for live scripting. The most popular use case is CAN bus integration.<br /> <br /> == Introduction ==<br /> <br /> epicEFI gives you a lot of flexibility — enough to build user-defined control strategies for primary and auxiliary actuators. Boards with an '''F7''' or '''H7''' MCU (EpicECU, M144H7, M144F7RED, etc.) have the most headroom for Lua. F4 boards (MEGA100F4, UAEFI) also support Lua but with tighter memory limits.<br /> <br /> == Variable names and hashes ==<br /> <br /> Calibration names, output channel names, variable types (CONFIG GETTER/SETTER, OUTPC GETTER/SETTER), and their '''djb2 hashes''' depend on your exact firmware build. Do not guess — look them up here:<br /> <br /> '''[https://content.epicefi.com/docs/variable_status_selector.html Variables Lookup]'''<br /> <br /> Use this tool when calling <code>getCalibration()</code> / <code>setCalibration()</code>, <code>getOutput()</code>, configuring user-table axes, or reading/writing variables over EPIC CAN.<br /> <br /> == Basics ==<br /> <br /> epicEFI provides hooks to interface with the firmware, manipulate its state, and read/write configuration:<br /> <br /> * [[#CAN bus|Hooks for CAN bus communications]]<br /> * [[#Input|Inputs from sensors can be read directly]]. [[#Set sensor value|You can also produce sensor values]] with Lua.<br /> * [[#Output|ECU general purpose outputs]]<br /> * [[#Engine control|Aspects of the engine can be controlled directly]]<br /> * ECU configuration can be accessed (read/write) via [[#getCalibration(name)|<code>getCalibration()</code>]] and [[#setCalibration(name, value, needEvent)|<code>setCalibration()</code>]].<br /> ** Valid calibration names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * ECU internal state (logic outputs / Live Data values) can be read via [[#getOutput(name)|<code>getOutput()</code>]], and some can be changed via dedicated setters (e.g. [[#setClutchUpState(value)|<code>setClutchUpState()</code>]]). See [[#Output|Output]].<br /> ** Valid output names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * Hooks to read values from SENT sensors; see [[#SENT protocol|SENT protocol]].<br /> * Useful helper routines; see [[#Utility|Utility]].<br /> <br /> Some example uses are in [[#Examples|Examples]].<br /> <br /> == Conventions ==<br /> <br /> * The Lua interpreter reports errors when something is wrong; check epicEFI Console / TunerStudio Lua output for errors and <code>print()</code> output.<br /> * Unless otherwise noted, all <code>index</code> parameters are '''zero-based''' (first element is index <code>0</code>).<br /> <br /> == Writing Your Script ==<br /> <br /> The entire Lua script is loaded at startup. After that, a function named <code>onTick</code> is called periodically by epicEFI.<br /> <br /> Simple startup example:<br /> <br /> <syntaxhighlight lang="lua"><br /> print('Hello Lua startup!')<br /> <br /> function onTick()<br /> print('Hello onTick()')<br /> end<br /> </syntaxhighlight><br /> <br /> === Controlling the tick rate ===<br /> <br /> <code>setTickRate(hz)</code> sets how often epicEFI calls <code>onTick</code>. If your script does heavy work, it may run slower than the requested rate. The Lua VM runs at low priority relative to engine control, so you cannot starve critical ECU functions — set the rate to whatever your script needs. <code>onCanRx</code> runs at the same rate as <code>onTick</code>.<br /> <br /> <syntaxhighlight lang="lua"><br /> n = 0<br /> setTickRate(5) -- 5 Hz<br /> function onTick()<br /> print('Hello Lua: ' .. n)<br /> n = n + 1<br /> end<br /> </syntaxhighlight><br /> <br /> === Editing scripts ===<br /> <br /> An editor with [https://github.com/LuaLS/lua-language-server#install Lua Language Server] (LSP) support makes writing scripts much easier.<br /> <br /> == Hooks / function reference ==<br /> <br /> === User settings ===<br /> <br /> ==== <code>getOutput(name)</code> ====<br /> <br /> Example: <code>getOutput("clutchUpState")</code> or <code>getOutput("brakePedalState")</code>.<br /> <br /> Valid output names for your firmware: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setClutchUpState(value)</code> ====<br /> <br /> ==== <code>setBrakePedalState(value)</code> ====<br /> <br /> Use <code>setBrakePedalState</code> to report a CAN-based brake pedal to epicEFI.<br /> <br /> ==== <code>setAcRequestState(value)</code> ====<br /> <br /> Use <code>setAcRequestState</code> to report a CAN-based A/C request.<br /> <br /> ==== <code>setEtbDisabled(value)</code> ====<br /> <br /> ==== <code>setIgnDisabled(value)</code> ====<br /> <br /> Use <code>setIgnDisabled</code> for cranking safety and other ignition-cut strategies.<br /> <br /> ==== <code>setAcDisabled(value)</code> ====<br /> <br /> Disable/suppress A/C regardless of how it would otherwise be enabled.<br /> <br /> ==== <code>getTimeSinceAcToggleMs()</code> ====<br /> <br /> ==== <code>getCalibration(name)</code> ====<br /> <br /> Returns the current value of a scalar calibration setting. Example: <code>getCalibration("cranking.rpm")</code>.<br /> <br /> Full list of valid names: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setCalibration(name, value, needEvent)</code> ====<br /> <br /> Sets a calibration value. Optionally fires a calibration change event depending on <code>needEvent</code>.<br /> <br /> Example: <code>setCalibration("cranking.rpm", 900, false)</code><br /> <br /> ==== <code>burnconfig</code> ====<br /> <br /> Schedules a write of current calibration to flash once the engine is stopped.<br /> <br /> ==== <code>findSetting(name, defaultValue)</code> ====<br /> <br /> Finds a user setting by name and returns its numeric value. Useful when the script author and the tuner are different people, or when editing is done only through TunerStudio fields rather than the Lua editor.<br /> <br /> * '''Parameters'''<br /> ** <code>name</code>: Variable name (matches the configuration field name)<br /> ** <code>defaultValue</code>: Returned if the setting is not found<br /> <br /> === <code>isFirmwareError</code> ===<br /> <br /> Returns <code>true</code> if the ECU is in a critical/fatal error state.<br /> <br /> === Engine control ===<br /> <br /> ==== <code>startCrankingEngine()</code> ====<br /> <br /> Starts cranking as if the physical start button were pressed.<br /> <br /> ==== <code>stopEngine()</code> ====<br /> <br /> ==== <code>isEngineStopRequested()</code> ====<br /> <br /> Returns <code>true</code> if an engine stop was requested (by Lua or the start/stop button) within the last five seconds.<br /> <br /> ==== <code>setLaunchTrigger</code> ====<br /> <br /> ==== <code>setSparkSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkSkipRatio(0)</code> — skip 0% of ignition events (no skip)<br /> * <code>setSparkSkipRatio(0.5)</code> — skip half of ignition events (never two consecutive skips)<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setSparkHardSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkHardSkipRatio(0)</code> — no skip<br /> * <code>setSparkHardSkipRatio(0.75)</code> — skip 75% of ignition events<br /> <br /> ==== <code>setIdleAdd(percent)</code> ====<br /> <br /> Percent added to idle (including open loop).<br /> <br /> ==== <code>setFuelAdd(amount)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Fuel mass to add to injection, scaled by [[#setFuelMult(coeff)|<code>setFuelMult()</code>]]; starts at 0.<br /> <br /> ==== <code>setFuelMult(coeff)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Multiplier for added fuel mass; starts at 1.0.<br /> <br /> ==== <code>setBoostTargetAdd(amount)</code> ====<br /> <br /> Additive offset for closed-loop boost target.<br /> <br /> ==== <code>setBoostTargetMult(coeff)</code> ====<br /> <br /> Multiplier for closed-loop boost target.<br /> <br /> ==== <code>setBoostDutyAdd(amount)</code> ====<br /> <br /> Additive offset for open-loop boost duty.<br /> <br /> ==== <code>setTimingAdd(angle)</code> ====<br /> <br /> Use negative values to retard timing.<br /> <br /> ==== <code>setTimingMult(coeff)</code> ====<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setEtbAdd(percent)</code> ====<br /> <br /> ETB adder as a percent of wide-open: e.g. <code>10</code> adds +10%. Static offset on top of the computed position (TPS 5% + <code>10</code> → 15% ETB command).<br /> <br /> Useful for torque reduction.<br /> <br /> === Timer ===<br /> <br /> <code>yourTimer = Timer.new()</code> creates a timer object.<br /> <br /> ==== <code>reset</code> ====<br /> <br /> <code>yourTimer:reset()</code> resets the timer.<br /> <br /> ==== <code>getElapsedSeconds</code> ====<br /> <br /> <code>yourTimer:getElapsedSeconds()</code> returns seconds since last reset.<br /> <br /> ==== <code>getTsButtonCount</code> ====<br /> <br /> <code>getTsButtonCount(X)</code> returns how many times Lua button '''X''' was pressed in TunerStudio. See <code>ts-button-example.lua</code> in the firmware examples.<br /> <br /> === CAN bus ===<br /> <br /> ==== <code>enableCanTx(isEnabled)</code> ====<br /> <br /> Enabled by default. Use <code>enableCanTx(false)</code> to suppress CAN transmit from Lua.<br /> <br /> ==== <code>txCan(bus, ID, isExt, payload)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>bus</code>: Hardware CAN bus index — typically <code>1</code> on single-CAN boards; <code>1</code> or <code>2</code> on dual-CAN boards (EpicECU, M144H7, etc.)<br /> ** <code>isExt</code>: <code>0</code> for 11-bit standard ID<br /> <br /> ==== <code>canRxAdd(id)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id)</code> ====<br /> <br /> ==== <code>canRxAdd(id, callback)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask, callback)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>id</code>: CAN ID to listen for<br /> ** <code>mask</code>: Applied to the received ID before comparison. Example: id <code>3</code> and mask <code>0xFF</code> matches any frame whose low 8 bits are <code>3</code>. Omit the mask to match exactly one ID.<br /> ** <code>bus</code>: Hardware CAN bus index. If omitted, frames from any bus are received.<br /> ** <code>callback</code>: Function called when a matching frame arrives. If omitted, <code>onCanRx</code> is used.<br /> <br /> CAN RX callback shape:<br /> <br /> <syntaxhighlight lang="lua"><br /> function onCanRx(bus, id, dlc, data)<br /> -- handle frame<br /> end<br /> </syntaxhighlight><br /> <br /> For high-throughput RX, see <code>enableCanRxWorkaround()</code> in the firmware examples.<br /> <br /> === SENT protocol ===<br /> <br /> ==== <code>getSentValue(index)</code> ====<br /> <br /> ==== <code>getSentValues(index)</code> ====<br /> <br /> === PID ===<br /> <br /> <code>deltaTime</code> is measured automatically between successive <code>pid:get</code> calls.<br /> <br /> <syntaxhighlight lang="lua"><br /> -- p, i, d, min, max<br /> pid = Pid.new(2, 0, 0, -100, 100)<br /> pid:setOffset(0.3)<br /> pid:get(target, input)<br /> pid:reset()<br /> <br /> industrialPid = IndustrialPid.new(2, 0, 0, -100, 100)<br /> industrialPid:setOffset(0.3)<br /> industrialPid:setDerivativeFilterLoss(0.3)<br /> industrialPid:setAntiwindupFreq(0.3)<br /> industrialPid:get(target, input)<br /> industrialPid:reset()<br /> </syntaxhighlight><br /> <br /> === Utility ===<br /> <br /> ==== <code>print(msg)</code> ====<br /> <br /> Prints a line to the ECU log.<br /> <br /> * '''Parameters:''' <code>msg</code> — string or number<br /> * '''Returns:''' none<br /> <br /> ==== <code>vin(index)</code> ====<br /> <br /> Returns the VIN character at the given zero-based index.<br /> <br /> '''Example:'''<br /> <br /> <syntaxhighlight lang="lua"><br /> n = 5.5<br /> print('Hello Lua, number is: ' .. n)<br /> </syntaxhighlight><br /> <br /> Output: <code>Hello Lua, number is: 5.5</code><br /> <br /> ==== <code>setTickRate(hz)</code> ====<br /> <br /> Sets how often epicEFI calls <code>onTick</code> and <code>onCanRx</code>, in Hz. Default after reset is 10 Hz.<br /> <br /> * '''Parameters:''' <code>hz</code> — clamped to 1–200 Hz<br /> * '''Returns:''' none<br /> <br /> ==== <code>mcu_standby()</code> ====<br /> <br /> Puts the MCU into standby (low current). Use with care.<br /> <br /> ==== <code>interpolate(x1, y1, x2, y2, x)</code> ====<br /> <br /> Linear interpolation of <code>x</code> on the line through <code>(x1, y1)</code> and <code>(x2, y2)</code>.<br /> <br /> ==== <code>findTableIndex(name)</code> ====<br /> <br /> Returns the index of a script table by human-readable name.<br /> <br /> ==== <code>table3d(tableIdx, x, y)</code> ====<br /> <br /> Looks up a value from a script 3D table.<br /> <br /> * '''Parameters'''<br /> ** <code>tableIdx</code>: Table index (1–4)<br /> ** <code>x</code>: X-axis value (often RPM)<br /> ** <code>y</code>: Y-axis value (often load)<br /> * '''Returns:''' table output value<br /> <br /> ==== <code>findCurveIndex(name)</code> ====<br /> <br /> Returns the index of a script curve by name.<br /> <br /> ==== <code>curve(curveIdx, x)</code> ====<br /> <br /> Looks up a value from a script curve.<br /> <br /> * '''Parameters'''<br /> ** <code>curveIdx</code>: Curve index (1-based)<br /> ** <code>x</code>: Axis value<br /> <br /> ==== <code>setDebug(index, value)</code> ====<br /> <br /> Sets a debug channel when ECU debug mode is '''Lua'''.<br /> <br /> * '''Parameters:''' <code>index</code> 1–7, <code>value</code> — channel value<br /> * '''Returns:''' none<br /> <br /> === Input ===<br /> <br /> ==== <code>getSensor(name)</code> ====<br /> <br /> Reads a sensor by name, e.g. <code>getSensor("AcceleratorPedal")</code>.<br /> <br /> * '''Parameters:''' <code>name</code> — sensor name (same names as TunerStudio Live Data, e.g. <code>TPS</code>, <code>CLT</code>, <code>RPM</code>, <code>MAP</code>)<br /> * '''Returns:''' reading, or <code>nil</code> if the sensor is invalid or not configured<br /> <br /> ==== <code>getSensorByIndex(index)</code> ====<br /> <br /> Reads a sensor by enum index.<br /> <br /> * '''Returns:''' reading, or <code>nil</code> on failure<br /> <br /> ==== <code>getSensorRaw(index)</code> ====<br /> <br /> Raw sensor value (usually pin voltage before scaling).<br /> <br /> * '''Returns:''' raw value, or <code>0</code> if unsupported / not configured / failed<br /> <br /> ==== <code>getAuxAnalog(index)</code> ====<br /> <br /> Like <code>getSensorRaw</code> but for aux analog inputs — always voltage.<br /> <br /> * '''Parameters:''' <code>index</code> 0–3<br /> * '''Returns:''' voltage, or <code>nil</code> if not configured<br /> <br /> ==== <code>hasSensor(index)</code> ====<br /> <br /> Whether a sensor slot is configured (valid or not).<br /> <br /> * '''Returns:''' boolean<br /> <br /> ==== <code>getDigital(index)</code> ====<br /> <br /> Reads a built-in digital input.<br /> <br /> {| class="wikitable"<br /> |-<br /> ! Index !! Channel<br /> |-<br /> | 0 || Clutch down<br /> |-<br /> | 1 || Clutch up<br /> |-<br /> | 2 || Brake switch<br /> |-<br /> | 3 || AC switch<br /> |}<br /> <br /> ==== <code>getAuxDigital(index)</code> ====<br /> <br /> Reads a user-configured digital input (index 0–7). Configure pins under '''Lua Digital Aux Inputs''' in TunerStudio.<br /> <br /> ==== <code>readPin(pinName)</code> ====<br /> <br /> Reads an MCU pin directly (e.g. <code>"PD15"</code>). Emergency/debug only — prefer Lua aux inputs for real logic.<br /> <br /> === Output ===<br /> <br /> Not the same as Live Data “outputs” or GPPWM.<br /> <br /> ==== <code>selfStimulateRPM(rpm)</code> ====<br /> <br /> Positive RPM starts injector clicking at that speed; <code>0</code> stops self-stimulation.<br /> <br /> ==== <code>startPwm(index, frequency, duty)</code> ====<br /> <br /> Starts PWM on a Lua PWM output. Pin assignment: '''Lua PWM Outputs''' in TunerStudio.<br /> <br /> * '''Parameters'''<br /> ** <code>index</code>: 0–7<br /> ** <code>frequency</code>: 1–1000 Hz<br /> ** <code>duty</code>: 0.0 = off, 1.0 = full on<br /> <br /> ==== <code>setPwmDuty(index, duty)</code> ====<br /> <br /> ==== <code>setPwmFreq(index, frequency)</code> ====<br /> <br /> ==== <code>getGpPwm(index)</code> ====<br /> <br /> Current GPPWM output percent (index 0–3).<br /> <br /> ==== <code>setLuaGauge(index, value)</code> ====<br /> <br /> Writes a Lua gauge (indices 1–8) for Live Data / logging.<br /> <br /> ==== <code>setDacVoltage(index, value)</code> ====<br /> <br /> Only on boards with DAC hardware enabled.<br /> <br /> == Console commands ==<br /> <br /> * <code>luamemory</code> — Lua memory usage<br /> * <code>luareset</code> — reset Lua VM<br /> <br /> == Examples ==<br /> <br /> Example scripts ship with the firmware under <code>firmware/controllers/lua/examples/</code> ([https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples browse on GitHub]).<br /> <br /> Notable examples: <code>honda-bcm.txt</code> (VSS from CAN / gear detection), <code>ford-focus-ii-pps.txt</code>, <code>bmw-idrive.txt</code>.<br /> <br /> === Timer example ===<br /> <br /> <syntaxhighlight lang="lua"><br /> t = Timer.new()<br /> timingAdd = 0<br /> <br /> function onTick()<br /> auxV = getAuxAnalog(0)<br /> tps = getSensor("TPS")<br /> -- check for nil if aux input is not assigned<br /> if auxV > 2 then<br /> t:reset()<br /> end<br /> <br /> val = t:getElapsedSeconds()<br /> <br /> if t:getElapsedSeconds() < 3 then<br /> timingAdd = 10<br /> else<br /> timingAdd = 0<br /> end<br /> setTimingAdd(timingAdd)<br /> <br /> print('Hello analog ' .. auxV .. " " .. val)<br /> end<br /> </syntaxhighlight><br /> <br /> === PWM ===<br /> <br /> <syntaxhighlight lang="lua"><br /> startPwm(0, 100, 0)<br /> <br /> function onTick()<br /> enable_pump = getSensor("RPM") > 700 and getSensor("BatteryVoltage") > 13 and getSensor("VehicleSpeed") < 60<br /> setPwmDuty(0, enable_pump and 1 or 0)<br /> end<br /> </syntaxhighlight><br /> <br /> === CAN transmit ===<br /> <br /> <syntaxhighlight lang="lua"><br /> function onTick()<br /> clt = getSensor("CLT")<br /> print('CLT ' .. clt)<br /> voltage0 = getSensor("aux0")<br /> <br /> txPayload = {}<br /> txPayload[1] = math.floor(((voltage0/256) - math.floor(voltage0/256))*256)<br /> txPayload[2] = math.floor(voltage0 / 256)<br /> <br /> txCan(1, 0x600, 1, txPayload)<br /> end<br /> </syntaxhighlight><br /> <br /> === Set sensor value ===<br /> <br /> Use standard sensor names from TunerStudio Live Data.<br /> <br /> <syntaxhighlight lang="lua"><br /> -- do not configure the same physical input elsewhere<br /> vssSensor = Sensor.new("VehicleSpeed")<br /> vssSensor:setTimeout(3000)<br /> function onTick()<br /> injectedVssValue = 123.4<br /> vssSensor:set(injectedVssValue)<br /> valFromSensor = getSensor("VehicleSpeed")<br /> print("VSS " .. valFromSensor)<br /> end<br /> </syntaxhighlight><br /> <br /> === CAN receive ===<br /> <br /> <syntaxhighlight lang="lua"><br /> canRxAdd(0x500)<br /> canRxAdd(0x570)<br /> function onCanRx(bus, id, dlc, data)<br /> print('got CAN id=' .. id .. ' dlc=' .. dlc)<br /> if id == 0x500 then<br /> canState = data[1]<br /> end<br /> if id == 0x570 then<br /> mcu_standby()<br /> end<br /> end<br /> </syntaxhighlight><br /> <br /> === Table / curve ===<br /> <br /> <syntaxhighlight lang="lua"><br /> tableIndex = findTableIndex("duty")<br /> <br /> TurbochargerSpeed = getSensor("TurbochargerSpeed")<br /> tps = getSensor("Tps1")<br /> <br /> dutyCycle = table3d(tableIndex, TurbochargerSpeed, tps)<br /> <br /> sparkCutCurve = findCurveIndex("sparkcut")<br /> sparkCutByTorque = curve(sparkCutCurve, torquex)<br /> </syntaxhighlight><br /> <br /> == See also ==<br /> <br /> * [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector] — names, types, and hashes for your firmware<br /> * [https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples Lua examples] — vehicle-specific scripts<br /> * [http://lua-users.org/wiki/TernaryOperator Lua ternary operator] — Lua has no <code>?:</code>; use <code>and</code> / <code>or</code> patterns</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Lua&diff=499 Lua 2026-08-18T03:17:15Z

<p>Joesphan: </p> <hr /> <div>= Lua Scripting =<br /> <br /> '''TL;DR:''' Connect with TunerStudio, open the '''Lua''' tab (or use epicEFI Console), and edit your script there. Lua runs on the ECU for live scripting. The most popular use case is CAN bus integration.<br /> <br /> == Introduction ==<br /> <br /> epicEFI gives you a lot of flexibility — enough to build user-defined control strategies for primary and auxiliary actuators. Boards with an '''F7''' or '''H7''' MCU (EpicECU, M144H7, M144F7RED, etc.) have the most headroom for Lua. F4 boards (MEGA100F4, UAEFI) also support Lua but with tighter memory limits.<br /> <br /> == Variable names and hashes ==<br /> <br /> Calibration names, output channel names, variable types (CONFIG GETTER/SETTER, OUTPC GETTER/SETTER), and their '''djb2 hashes''' depend on your exact firmware build. Do not guess — look them up here:<br /> <br /> '''[https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector]'''<br /> <br /> Use this tool when calling <code>getCalibration()</code> / <code>setCalibration()</code>, <code>getOutput()</code>, configuring user-table axes, or reading/writing variables over EPIC CAN.<br /> <br /> == Basics ==<br /> <br /> epicEFI provides hooks to interface with the firmware, manipulate its state, and read/write configuration:<br /> <br /> * [[#CAN bus|Hooks for CAN bus communications]]<br /> * [[#Input|Inputs from sensors can be read directly]]. [[#Set sensor value|You can also produce sensor values]] with Lua.<br /> * [[#Output|ECU general purpose outputs]]<br /> * [[#Engine control|Aspects of the engine can be controlled directly]]<br /> * ECU configuration can be accessed (read/write) via [[#getCalibration(name)|<code>getCalibration()</code>]] and [[#setCalibration(name, value, needEvent)|<code>setCalibration()</code>]].<br /> ** Valid calibration names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * ECU internal state (logic outputs / Live Data values) can be read via [[#getOutput(name)|<code>getOutput()</code>]], and some can be changed via dedicated setters (e.g. [[#setClutchUpState(value)|<code>setClutchUpState()</code>]]). See [[#Output|Output]].<br /> ** Valid output names for your firmware are listed in the [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> * Hooks to read values from SENT sensors; see [[#SENT protocol|SENT protocol]].<br /> * Useful helper routines; see [[#Utility|Utility]].<br /> <br /> Some example uses are in [[#Examples|Examples]].<br /> <br /> == Conventions ==<br /> <br /> * The Lua interpreter reports errors when something is wrong; check epicEFI Console / TunerStudio Lua output for errors and <code>print()</code> output.<br /> * Unless otherwise noted, all <code>index</code> parameters are '''zero-based''' (first element is index <code>0</code>).<br /> <br /> == Writing Your Script ==<br /> <br /> The entire Lua script is loaded at startup. After that, a function named <code>onTick</code> is called periodically by epicEFI.<br /> <br /> Simple startup example:<br /> <br /> <syntaxhighlight lang="lua"><br /> print('Hello Lua startup!')<br /> <br /> function onTick()<br /> print('Hello onTick()')<br /> end<br /> </syntaxhighlight><br /> <br /> === Controlling the tick rate ===<br /> <br /> <code>setTickRate(hz)</code> sets how often epicEFI calls <code>onTick</code>. If your script does heavy work, it may run slower than the requested rate. The Lua VM runs at low priority relative to engine control, so you cannot starve critical ECU functions — set the rate to whatever your script needs. <code>onCanRx</code> runs at the same rate as <code>onTick</code>.<br /> <br /> <syntaxhighlight lang="lua"><br /> n = 0<br /> setTickRate(5) -- 5 Hz<br /> function onTick()<br /> print('Hello Lua: ' .. n)<br /> n = n + 1<br /> end<br /> </syntaxhighlight><br /> <br /> === Editing scripts ===<br /> <br /> An editor with [https://github.com/LuaLS/lua-language-server#install Lua Language Server] (LSP) support makes writing scripts much easier.<br /> <br /> == Hooks / function reference ==<br /> <br /> === User settings ===<br /> <br /> ==== <code>getOutput(name)</code> ====<br /> <br /> Example: <code>getOutput("clutchUpState")</code> or <code>getOutput("brakePedalState")</code>.<br /> <br /> Valid output names for your firmware: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setClutchUpState(value)</code> ====<br /> <br /> ==== <code>setBrakePedalState(value)</code> ====<br /> <br /> Use <code>setBrakePedalState</code> to report a CAN-based brake pedal to epicEFI.<br /> <br /> ==== <code>setAcRequestState(value)</code> ====<br /> <br /> Use <code>setAcRequestState</code> to report a CAN-based A/C request.<br /> <br /> ==== <code>setEtbDisabled(value)</code> ====<br /> <br /> ==== <code>setIgnDisabled(value)</code> ====<br /> <br /> Use <code>setIgnDisabled</code> for cranking safety and other ignition-cut strategies.<br /> <br /> ==== <code>setAcDisabled(value)</code> ====<br /> <br /> Disable/suppress A/C regardless of how it would otherwise be enabled.<br /> <br /> ==== <code>getTimeSinceAcToggleMs()</code> ====<br /> <br /> ==== <code>getCalibration(name)</code> ====<br /> <br /> Returns the current value of a scalar calibration setting. Example: <code>getCalibration("cranking.rpm")</code>.<br /> <br /> Full list of valid names: [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector].<br /> <br /> ==== <code>setCalibration(name, value, needEvent)</code> ====<br /> <br /> Sets a calibration value. Optionally fires a calibration change event depending on <code>needEvent</code>.<br /> <br /> Example: <code>setCalibration("cranking.rpm", 900, false)</code><br /> <br /> ==== <code>burnconfig</code> ====<br /> <br /> Schedules a write of current calibration to flash once the engine is stopped.<br /> <br /> ==== <code>findSetting(name, defaultValue)</code> ====<br /> <br /> Finds a user setting by name and returns its numeric value. Useful when the script author and the tuner are different people, or when editing is done only through TunerStudio fields rather than the Lua editor.<br /> <br /> * '''Parameters'''<br /> ** <code>name</code>: Variable name (matches the configuration field name)<br /> ** <code>defaultValue</code>: Returned if the setting is not found<br /> <br /> === <code>isFirmwareError</code> ===<br /> <br /> Returns <code>true</code> if the ECU is in a critical/fatal error state.<br /> <br /> === Engine control ===<br /> <br /> ==== <code>startCrankingEngine()</code> ====<br /> <br /> Starts cranking as if the physical start button were pressed.<br /> <br /> ==== <code>stopEngine()</code> ====<br /> <br /> ==== <code>isEngineStopRequested()</code> ====<br /> <br /> Returns <code>true</code> if an engine stop was requested (by Lua or the start/stop button) within the last five seconds.<br /> <br /> ==== <code>setLaunchTrigger</code> ====<br /> <br /> ==== <code>setSparkSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkSkipRatio(0)</code> — skip 0% of ignition events (no skip)<br /> * <code>setSparkSkipRatio(0.5)</code> — skip half of ignition events (never two consecutive skips)<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setSparkHardSkipRatio(ratio)</code> ====<br /> <br /> * <code>setSparkHardSkipRatio(0)</code> — no skip<br /> * <code>setSparkHardSkipRatio(0.75)</code> — skip 75% of ignition events<br /> <br /> ==== <code>setIdleAdd(percent)</code> ====<br /> <br /> Percent added to idle (including open loop).<br /> <br /> ==== <code>setFuelAdd(amount)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Fuel mass to add to injection, scaled by [[#setFuelMult(coeff)|<code>setFuelMult()</code>]]; starts at 0.<br /> <br /> ==== <code>setFuelMult(coeff)</code> ====<br /> <br /> ''Currently not functional.''<br /> <br /> Multiplier for added fuel mass; starts at 1.0.<br /> <br /> ==== <code>setBoostTargetAdd(amount)</code> ====<br /> <br /> Additive offset for closed-loop boost target.<br /> <br /> ==== <code>setBoostTargetMult(coeff)</code> ====<br /> <br /> Multiplier for closed-loop boost target.<br /> <br /> ==== <code>setBoostDutyAdd(amount)</code> ====<br /> <br /> Additive offset for open-loop boost duty.<br /> <br /> ==== <code>setTimingAdd(angle)</code> ====<br /> <br /> Use negative values to retard timing.<br /> <br /> ==== <code>setTimingMult(coeff)</code> ====<br /> <br /> Useful for torque reduction.<br /> <br /> ==== <code>setEtbAdd(percent)</code> ====<br /> <br /> ETB adder as a percent of wide-open: e.g. <code>10</code> adds +10%. Static offset on top of the computed position (TPS 5% + <code>10</code> → 15% ETB command).<br /> <br /> Useful for torque reduction.<br /> <br /> === Timer ===<br /> <br /> <code>yourTimer = Timer.new()</code> creates a timer object.<br /> <br /> ==== <code>reset</code> ====<br /> <br /> <code>yourTimer:reset()</code> resets the timer.<br /> <br /> ==== <code>getElapsedSeconds</code> ====<br /> <br /> <code>yourTimer:getElapsedSeconds()</code> returns seconds since last reset.<br /> <br /> ==== <code>getTsButtonCount</code> ====<br /> <br /> <code>getTsButtonCount(X)</code> returns how many times Lua button '''X''' was pressed in TunerStudio. See <code>ts-button-example.lua</code> in the firmware examples.<br /> <br /> === CAN bus ===<br /> <br /> ==== <code>enableCanTx(isEnabled)</code> ====<br /> <br /> Enabled by default. Use <code>enableCanTx(false)</code> to suppress CAN transmit from Lua.<br /> <br /> ==== <code>txCan(bus, ID, isExt, payload)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>bus</code>: Hardware CAN bus index — typically <code>1</code> on single-CAN boards; <code>1</code> or <code>2</code> on dual-CAN boards (EpicECU, M144H7, etc.)<br /> ** <code>isExt</code>: <code>0</code> for 11-bit standard ID<br /> <br /> ==== <code>canRxAdd(id)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id)</code> ====<br /> <br /> ==== <code>canRxAdd(id, callback)</code> ====<br /> <br /> ==== <code>canRxAdd(bus, id, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask)</code> ====<br /> <br /> ==== <code>canRxAddMask(id, mask, callback)</code> ====<br /> <br /> ==== <code>canRxAddMask(bus, id, mask, callback)</code> ====<br /> <br /> * '''Parameters'''<br /> ** <code>id</code>: CAN ID to listen for<br /> ** <code>mask</code>: Applied to the received ID before comparison. Example: id <code>3</code> and mask <code>0xFF</code> matches any frame whose low 8 bits are <code>3</code>. Omit the mask to match exactly one ID.<br /> ** <code>bus</code>: Hardware CAN bus index. If omitted, frames from any bus are received.<br /> ** <code>callback</code>: Function called when a matching frame arrives. If omitted, <code>onCanRx</code> is used.<br /> <br /> CAN RX callback shape:<br /> <br /> <syntaxhighlight lang="lua"><br /> function onCanRx(bus, id, dlc, data)<br /> -- handle frame<br /> end<br /> </syntaxhighlight><br /> <br /> For high-throughput RX, see <code>enableCanRxWorkaround()</code> in the firmware examples.<br /> <br /> === SENT protocol ===<br /> <br /> ==== <code>getSentValue(index)</code> ====<br /> <br /> ==== <code>getSentValues(index)</code> ====<br /> <br /> === PID ===<br /> <br /> <code>deltaTime</code> is measured automatically between successive <code>pid:get</code> calls.<br /> <br /> <syntaxhighlight lang="lua"><br /> -- p, i, d, min, max<br /> pid = Pid.new(2, 0, 0, -100, 100)<br /> pid:setOffset(0.3)<br /> pid:get(target, input)<br /> pid:reset()<br /> <br /> industrialPid = IndustrialPid.new(2, 0, 0, -100, 100)<br /> industrialPid:setOffset(0.3)<br /> industrialPid:setDerivativeFilterLoss(0.3)<br /> industrialPid:setAntiwindupFreq(0.3)<br /> industrialPid:get(target, input)<br /> industrialPid:reset()<br /> </syntaxhighlight><br /> <br /> === Utility ===<br /> <br /> ==== <code>print(msg)</code> ====<br /> <br /> Prints a line to the ECU log.<br /> <br /> * '''Parameters:''' <code>msg</code> — string or number<br /> * '''Returns:''' none<br /> <br /> ==== <code>vin(index)</code> ====<br /> <br /> Returns the VIN character at the given zero-based index.<br /> <br /> '''Example:'''<br /> <br /> <syntaxhighlight lang="lua"><br /> n = 5.5<br /> print('Hello Lua, number is: ' .. n)<br /> </syntaxhighlight><br /> <br /> Output: <code>Hello Lua, number is: 5.5</code><br /> <br /> ==== <code>setTickRate(hz)</code> ====<br /> <br /> Sets how often epicEFI calls <code>onTick</code> and <code>onCanRx</code>, in Hz. Default after reset is 10 Hz.<br /> <br /> * '''Parameters:''' <code>hz</code> — clamped to 1–200 Hz<br /> * '''Returns:''' none<br /> <br /> ==== <code>mcu_standby()</code> ====<br /> <br /> Puts the MCU into standby (low current). Use with care.<br /> <br /> ==== <code>interpolate(x1, y1, x2, y2, x)</code> ====<br /> <br /> Linear interpolation of <code>x</code> on the line through <code>(x1, y1)</code> and <code>(x2, y2)</code>.<br /> <br /> ==== <code>findTableIndex(name)</code> ====<br /> <br /> Returns the index of a script table by human-readable name.<br /> <br /> ==== <code>table3d(tableIdx, x, y)</code> ====<br /> <br /> Looks up a value from a script 3D table.<br /> <br /> * '''Parameters'''<br /> ** <code>tableIdx</code>: Table index (1–4)<br /> ** <code>x</code>: X-axis value (often RPM)<br /> ** <code>y</code>: Y-axis value (often load)<br /> * '''Returns:''' table output value<br /> <br /> ==== <code>findCurveIndex(name)</code> ====<br /> <br /> Returns the index of a script curve by name.<br /> <br /> ==== <code>curve(curveIdx, x)</code> ====<br /> <br /> Looks up a value from a script curve.<br /> <br /> * '''Parameters'''<br /> ** <code>curveIdx</code>: Curve index (1-based)<br /> ** <code>x</code>: Axis value<br /> <br /> ==== <code>setDebug(index, value)</code> ====<br /> <br /> Sets a debug channel when ECU debug mode is '''Lua'''.<br /> <br /> * '''Parameters:''' <code>index</code> 1–7, <code>value</code> — channel value<br /> * '''Returns:''' none<br /> <br /> === Input ===<br /> <br /> ==== <code>getSensor(name)</code> ====<br /> <br /> Reads a sensor by name, e.g. <code>getSensor("AcceleratorPedal")</code>.<br /> <br /> * '''Parameters:''' <code>name</code> — sensor name (same names as TunerStudio Live Data, e.g. <code>TPS</code>, <code>CLT</code>, <code>RPM</code>, <code>MAP</code>)<br /> * '''Returns:''' reading, or <code>nil</code> if the sensor is invalid or not configured<br /> <br /> ==== <code>getSensorByIndex(index)</code> ====<br /> <br /> Reads a sensor by enum index.<br /> <br /> * '''Returns:''' reading, or <code>nil</code> on failure<br /> <br /> ==== <code>getSensorRaw(index)</code> ====<br /> <br /> Raw sensor value (usually pin voltage before scaling).<br /> <br /> * '''Returns:''' raw value, or <code>0</code> if unsupported / not configured / failed<br /> <br /> ==== <code>getAuxAnalog(index)</code> ====<br /> <br /> Like <code>getSensorRaw</code> but for aux analog inputs — always voltage.<br /> <br /> * '''Parameters:''' <code>index</code> 0–3<br /> * '''Returns:''' voltage, or <code>nil</code> if not configured<br /> <br /> ==== <code>hasSensor(index)</code> ====<br /> <br /> Whether a sensor slot is configured (valid or not).<br /> <br /> * '''Returns:''' boolean<br /> <br /> ==== <code>getDigital(index)</code> ====<br /> <br /> Reads a built-in digital input.<br /> <br /> {| class="wikitable"<br /> |-<br /> ! Index !! Channel<br /> |-<br /> | 0 || Clutch down<br /> |-<br /> | 1 || Clutch up<br /> |-<br /> | 2 || Brake switch<br /> |-<br /> | 3 || AC switch<br /> |}<br /> <br /> ==== <code>getAuxDigital(index)</code> ====<br /> <br /> Reads a user-configured digital input (index 0–7). Configure pins under '''Lua Digital Aux Inputs''' in TunerStudio.<br /> <br /> ==== <code>readPin(pinName)</code> ====<br /> <br /> Reads an MCU pin directly (e.g. <code>"PD15"</code>). Emergency/debug only — prefer Lua aux inputs for real logic.<br /> <br /> === Output ===<br /> <br /> Not the same as Live Data “outputs” or GPPWM.<br /> <br /> ==== <code>selfStimulateRPM(rpm)</code> ====<br /> <br /> Positive RPM starts injector clicking at that speed; <code>0</code> stops self-stimulation.<br /> <br /> ==== <code>startPwm(index, frequency, duty)</code> ====<br /> <br /> Starts PWM on a Lua PWM output. Pin assignment: '''Lua PWM Outputs''' in TunerStudio.<br /> <br /> * '''Parameters'''<br /> ** <code>index</code>: 0–7<br /> ** <code>frequency</code>: 1–1000 Hz<br /> ** <code>duty</code>: 0.0 = off, 1.0 = full on<br /> <br /> ==== <code>setPwmDuty(index, duty)</code> ====<br /> <br /> ==== <code>setPwmFreq(index, frequency)</code> ====<br /> <br /> ==== <code>getGpPwm(index)</code> ====<br /> <br /> Current GPPWM output percent (index 0–3).<br /> <br /> ==== <code>setLuaGauge(index, value)</code> ====<br /> <br /> Writes a Lua gauge (indices 1–8) for Live Data / logging.<br /> <br /> ==== <code>setDacVoltage(index, value)</code> ====<br /> <br /> Only on boards with DAC hardware enabled.<br /> <br /> == Console commands ==<br /> <br /> * <code>luamemory</code> — Lua memory usage<br /> * <code>luareset</code> — reset Lua VM<br /> <br /> == Examples ==<br /> <br /> Example scripts ship with the firmware under <code>firmware/controllers/lua/examples/</code> ([https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples browse on GitHub]).<br /> <br /> Notable examples: <code>honda-bcm.txt</code> (VSS from CAN / gear detection), <code>ford-focus-ii-pps.txt</code>, <code>bmw-idrive.txt</code>.<br /> <br /> === Timer example ===<br /> <br /> <syntaxhighlight lang="lua"><br /> t = Timer.new()<br /> timingAdd = 0<br /> <br /> function onTick()<br /> auxV = getAuxAnalog(0)<br /> tps = getSensor("TPS")<br /> -- check for nil if aux input is not assigned<br /> if auxV > 2 then<br /> t:reset()<br /> end<br /> <br /> val = t:getElapsedSeconds()<br /> <br /> if t:getElapsedSeconds() < 3 then<br /> timingAdd = 10<br /> else<br /> timingAdd = 0<br /> end<br /> setTimingAdd(timingAdd)<br /> <br /> print('Hello analog ' .. auxV .. " " .. val)<br /> end<br /> </syntaxhighlight><br /> <br /> === PWM ===<br /> <br /> <syntaxhighlight lang="lua"><br /> startPwm(0, 100, 0)<br /> <br /> function onTick()<br /> enable_pump = getSensor("RPM") > 700 and getSensor("BatteryVoltage") > 13 and getSensor("VehicleSpeed") < 60<br /> setPwmDuty(0, enable_pump and 1 or 0)<br /> end<br /> </syntaxhighlight><br /> <br /> === CAN transmit ===<br /> <br /> <syntaxhighlight lang="lua"><br /> function onTick()<br /> clt = getSensor("CLT")<br /> print('CLT ' .. clt)<br /> voltage0 = getSensor("aux0")<br /> <br /> txPayload = {}<br /> txPayload[1] = math.floor(((voltage0/256) - math.floor(voltage0/256))*256)<br /> txPayload[2] = math.floor(voltage0 / 256)<br /> <br /> txCan(1, 0x600, 1, txPayload)<br /> end<br /> </syntaxhighlight><br /> <br /> === Set sensor value ===<br /> <br /> Use standard sensor names from TunerStudio Live Data.<br /> <br /> <syntaxhighlight lang="lua"><br /> -- do not configure the same physical input elsewhere<br /> vssSensor = Sensor.new("VehicleSpeed")<br /> vssSensor:setTimeout(3000)<br /> function onTick()<br /> injectedVssValue = 123.4<br /> vssSensor:set(injectedVssValue)<br /> valFromSensor = getSensor("VehicleSpeed")<br /> print("VSS " .. valFromSensor)<br /> end<br /> </syntaxhighlight><br /> <br /> === CAN receive ===<br /> <br /> <syntaxhighlight lang="lua"><br /> canRxAdd(0x500)<br /> canRxAdd(0x570)<br /> function onCanRx(bus, id, dlc, data)<br /> print('got CAN id=' .. id .. ' dlc=' .. dlc)<br /> if id == 0x500 then<br /> canState = data[1]<br /> end<br /> if id == 0x570 then<br /> mcu_standby()<br /> end<br /> end<br /> </syntaxhighlight><br /> <br /> === Table / curve ===<br /> <br /> <syntaxhighlight lang="lua"><br /> tableIndex = findTableIndex("duty")<br /> <br /> TurbochargerSpeed = getSensor("TurbochargerSpeed")<br /> tps = getSensor("Tps1")<br /> <br /> dutyCycle = table3d(tableIndex, TurbochargerSpeed, tps)<br /> <br /> sparkCutCurve = findCurveIndex("sparkcut")<br /> sparkCutByTorque = curve(sparkCutCurve, torquex)<br /> </syntaxhighlight><br /> <br /> == See also ==<br /> <br /> * [https://content.epicefi.com/docs/variable_status_selector.html Variable Status Selector] — names, types, and hashes for your firmware<br /> * [https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples Lua examples] — vehicle-specific scripts<br /> * [http://lua-users.org/wiki/TernaryOperator Lua ternary operator] — Lua has no <code>?:</code>; use <code>and</code> / <code>or</code> patterns</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Lua&diff=498 Lua 2026-08-18T03:15:51Z

<p>Joesphan: </p> <hr /> <div># Lua Scripting<br /> <br /> **TL;DR:** Connect with TunerStudio, open the **Lua** tab (or use epicEFI Console), and edit your script there. Lua runs on the ECU for live scripting. The most popular use case is CAN bus integration.<br /> <br /> ## Introduction<br /> <br /> epicEFI gives you a lot of flexibility — enough to build user-defined control strategies for primary and auxiliary actuators. Boards with an **F7** or **H7** MCU (EpicECU, M144H7, M144F7RED, etc.) have the most headroom for Lua. F4 boards (MEGA100F4, UAEFI) also support Lua but with tighter memory limits.<br /> <br /> ## Variable names and hashes<br /> <br /> Calibration names, output channel names, variable types (CONFIG GETTER/SETTER, OUTPC GETTER/SETTER), and their **djb2 hashes** depend on your exact firmware build. Do not guess — look them up here:<br /> <br /> **[Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html)**<br /> <br /> Use this tool when calling `getCalibration()` / `setCalibration()`, `getOutput()`, configuring user-table axes, or reading/writing variables over EPIC CAN.<br /> <br /> ## Basics<br /> <br /> epicEFI provides hooks to interface with the firmware, manipulate its state, and read/write configuration:<br /> <br /> - [Hooks for CAN bus communications](#can-bus)<br /> - [Inputs from sensors can be read directly](#input). [You can also produce sensor values](#set-sensor-value) with Lua.<br /> - [ECU general purpose outputs](#output)<br /> - [Aspects of the engine can be controlled directly](#engine-control)<br /> - ECU configuration can be accessed (read/write) via [`getCalibration()`](#getcalibrationname) and [`setCalibration()`](#setcalibrationname-value-needevent).<br /> - Valid calibration names for your firmware are listed in the [Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html).<br /> - ECU internal state (logic outputs / Live Data values) can be read via [`getOutput()`](#getoutputname), and some can be changed via dedicated setters (e.g. [`setClutchUpState()`](#setclutchupstatevalue)). See [Output](#output).<br /> - Valid output names for your firmware are listed in the [Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html).<br /> - Hooks to read values from SENT sensors; see [SENT protocol](#sent-protocol).<br /> - Useful helper routines; see [Utility](#utility).<br /> <br /> Some example uses are in [Examples](#examples).<br /> <br /> ## Conventions<br /> <br /> - The Lua interpreter reports errors when something is wrong; check epicEFI Console / TunerStudio Lua output for errors and `print()` output.<br /> - Unless otherwise noted, all `index` parameters are **zero-based** (first element is index `0`).<br /> <br /> ## Writing Your Script<br /> <br /> The entire Lua script is loaded at startup. After that, a function named `onTick` is called periodically by epicEFI.<br /> <br /> Simple startup example:<br /> <br /> ```lua<br /> print('Hello Lua startup!')<br /> <br /> function onTick()<br /> print('Hello onTick()')<br /> end<br /> ```<br /> <br /> ### Controlling the tick rate<br /> <br /> `setTickRate(hz)` sets how often epicEFI calls `onTick`. If your script does heavy work, it may run slower than the requested rate. The Lua VM runs at low priority relative to engine control, so you cannot starve critical ECU functions — set the rate to whatever your script needs. `onCanRx` runs at the same rate as `onTick`.<br /> <br /> ```lua<br /> n = 0<br /> setTickRate(5) -- 5 Hz<br /> function onTick()<br /> print('Hello Lua: ' .. n)<br /> n = n + 1<br /> end<br /> ```<br /> <br /> ### Editing scripts<br /> <br /> An editor with [Lua Language Server](https://github.com/LuaLS/lua-language-server#install) (LSP) support makes writing scripts much easier.<br /> <br /> ## Hooks / function reference<br /> <br /> ### User settings<br /> <br /> #### `getOutput(name)`<br /> <br /> Example: `getOutput("clutchUpState")` or `getOutput("brakePedalState")`.<br /> <br /> Valid output names for your firmware: [Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html).<br /> <br /> #### `setClutchUpState(value)`<br /> <br /> #### `setBrakePedalState(value)`<br /> <br /> Use `setBrakePedalState` to report a CAN-based brake pedal to epicEFI.<br /> <br /> #### `setAcRequestState(value)`<br /> <br /> Use `setAcRequestState` to report a CAN-based A/C request.<br /> <br /> #### `setEtbDisabled(value)`<br /> <br /> #### `setIgnDisabled(value)`<br /> <br /> Use `setIgnDisabled` for cranking safety and other ignition-cut strategies.<br /> <br /> #### `setAcDisabled(value)`<br /> <br /> Disable/suppress A/C regardless of how it would otherwise be enabled.<br /> <br /> #### `getTimeSinceAcToggleMs()`<br /> <br /> #### `getCalibration(name)`<br /> <br /> Returns the current value of a scalar calibration setting. Example: `getCalibration("cranking.rpm")`.<br /> <br /> Full list of valid names: [Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html).<br /> <br /> #### `setCalibration(name, value, needEvent)`<br /> <br /> Sets a calibration value. Optionally fires a calibration change event depending on `needEvent`.<br /> <br /> Example: `setCalibration("cranking.rpm", 900, false)`<br /> <br /> #### `burnconfig`<br /> <br /> Schedules a write of current calibration to flash once the engine is stopped.<br /> <br /> #### `findSetting(name, defaultValue)`<br /> <br /> Finds a user setting by name and returns its numeric value. Useful when the script author and the tuner are different people, or when editing is done only through TunerStudio fields rather than the Lua editor.<br /> <br /> - **Parameters**<br /> - `name`: Variable name (matches the configuration field name)<br /> - `defaultValue`: Returned if the setting is not found<br /> <br /> ### `isFirmwareError`<br /> <br /> Returns `true` if the ECU is in a critical/fatal error state.<br /> <br /> ### Engine control<br /> <br /> #### `startCrankingEngine()`<br /> <br /> Starts cranking as if the physical start button were pressed.<br /> <br /> #### `stopEngine()`<br /> <br /> #### `isEngineStopRequested()`<br /> <br /> Returns `true` if an engine stop was requested (by Lua or the start/stop button) within the last five seconds.<br /> <br /> #### `setLaunchTrigger`<br /> <br /> #### `setSparkSkipRatio(ratio)`<br /> <br /> - `setSparkSkipRatio(0)` — skip 0% of ignition events (no skip)<br /> - `setSparkSkipRatio(0.5)` — skip half of ignition events (never two consecutive skips)<br /> <br /> Useful for torque reduction.<br /> <br /> #### `setSparkHardSkipRatio(ratio)`<br /> <br /> - `setSparkHardSkipRatio(0)` — no skip<br /> - `setSparkHardSkipRatio(0.75)` — skip 75% of ignition events<br /> <br /> #### `setIdleAdd(percent)`<br /> <br /> Percent added to idle (including open loop).<br /> <br /> #### `setFuelAdd(amount)`<br /> <br /> *Currently not functional.*<br /> <br /> Fuel mass to add to injection, scaled by [`setFuelMult()`](#setfuelmultcoeff); starts at 0.<br /> <br /> #### `setFuelMult(coeff)`<br /> <br /> *Currently not functional.*<br /> <br /> Multiplier for added fuel mass; starts at 1.0.<br /> <br /> #### `setBoostTargetAdd(amount)`<br /> <br /> Additive offset for closed-loop boost target.<br /> <br /> #### `setBoostTargetMult(coeff)`<br /> <br /> Multiplier for closed-loop boost target.<br /> <br /> #### `setBoostDutyAdd(amount)`<br /> <br /> Additive offset for open-loop boost duty.<br /> <br /> #### `setTimingAdd(angle)`<br /> <br /> Use negative values to retard timing.<br /> <br /> #### `setTimingMult(coeff)`<br /> <br /> Useful for torque reduction.<br /> <br /> #### `setEtbAdd(percent)`<br /> <br /> ETB adder as a percent of wide-open: e.g. `10` adds +10%. Static offset on top of the computed position (TPS 5% + `10` → 15% ETB command).<br /> <br /> Useful for torque reduction.<br /> <br /> ### Timer<br /> <br /> `yourTimer = Timer.new()` creates a timer object.<br /> <br /> #### `reset`<br /> <br /> `yourTimer:reset()` resets the timer.<br /> <br /> #### `getElapsedSeconds`<br /> <br /> `yourTimer:getElapsedSeconds()` returns seconds since last reset.<br /> <br /> #### `getTsButtonCount`<br /> <br /> `getTsButtonCount(X)` returns how many times Lua button **X** was pressed in TunerStudio. See `ts-button-example.lua` in the firmware examples.<br /> <br /> ### CAN bus<br /> <br /> #### `enableCanTx(isEnabled)`<br /> <br /> Enabled by default. Use `enableCanTx(false)` to suppress CAN transmit from Lua.<br /> <br /> #### `txCan(bus, ID, isExt, payload)`<br /> <br /> - **Parameters**<br /> - `bus`: Hardware CAN bus index — typically `1` on single-CAN boards; `1` or `2` on dual-CAN boards (EpicECU, M144H7, etc.)<br /> - `isExt`: `0` for 11-bit standard ID<br /> <br /> #### `canRxAdd(id)`<br /> <br /> #### `canRxAdd(bus, id)`<br /> <br /> #### `canRxAdd(id, callback)`<br /> <br /> #### `canRxAdd(bus, id, callback)`<br /> <br /> #### `canRxAddMask(id, mask)`<br /> <br /> #### `canRxAddMask(bus, id, mask)`<br /> <br /> #### `canRxAddMask(id, mask, callback)`<br /> <br /> #### `canRxAddMask(bus, id, mask, callback)`<br /> <br /> - **Parameters**<br /> - `id`: CAN ID to listen for<br /> - `mask`: Applied to the received ID before comparison. Example: id `3` and mask `0xFF` matches any frame whose low 8 bits are `3`. Omit the mask to match exactly one ID.<br /> - `bus`: Hardware CAN bus index. If omitted, frames from any bus are received.<br /> - `callback`: Function called when a matching frame arrives. If omitted, `onCanRx` is used.<br /> <br /> CAN RX callback shape:<br /> <br /> ```lua<br /> function onCanRx(bus, id, dlc, data)<br /> -- handle frame<br /> end<br /> ```<br /> <br /> For high-throughput RX, see `enableCanRxWorkaround()` in the firmware examples.<br /> <br /> ### SENT protocol<br /> <br /> #### `getSentValue(index)`<br /> <br /> #### `getSentValues(index)`<br /> <br /> ### PID<br /> <br /> `deltaTime` is measured automatically between successive `pid:get` calls.<br /> <br /> ```lua<br /> -- p, i, d, min, max<br /> pid = Pid.new(2, 0, 0, -100, 100)<br /> pid:setOffset(0.3)<br /> pid:get(target, input)<br /> pid:reset()<br /> <br /> industrialPid = IndustrialPid.new(2, 0, 0, -100, 100)<br /> industrialPid:setOffset(0.3)<br /> industrialPid:setDerivativeFilterLoss(0.3)<br /> industrialPid:setAntiwindupFreq(0.3)<br /> industrialPid:get(target, input)<br /> industrialPid:reset()<br /> ```<br /> <br /> ### Utility<br /> <br /> #### `print(msg)`<br /> <br /> Prints a line to the ECU log.<br /> <br /> - **Parameters:** `msg` — string or number<br /> - **Returns:** none<br /> <br /> #### `vin(index)`<br /> <br /> Returns the VIN character at the given zero-based index.<br /> <br /> **Example:**<br /> <br /> ```lua<br /> n = 5.5<br /> print('Hello Lua, number is: ' .. n)<br /> ```<br /> <br /> Output: `Hello Lua, number is: 5.5`<br /> <br /> #### `setTickRate(hz)`<br /> <br /> Sets how often epicEFI calls `onTick` and `onCanRx`, in Hz. Default after reset is 10 Hz.<br /> <br /> - **Parameters:** `hz` — clamped to 1–200 Hz<br /> - **Returns:** none<br /> <br /> #### `mcu_standby()`<br /> <br /> Puts the MCU into standby (low current). Use with care.<br /> <br /> #### `interpolate(x1, y1, x2, y2, x)`<br /> <br /> Linear interpolation of `x` on the line through `(x1, y1)` and `(x2, y2)`.<br /> <br /> #### `findTableIndex(name)`<br /> <br /> Returns the index of a script table by human-readable name.<br /> <br /> #### `table3d(tableIdx, x, y)`<br /> <br /> Looks up a value from a script 3D table.<br /> <br /> - **Parameters**<br /> - `tableIdx`: Table index (1–4)<br /> - `x`: X-axis value (often RPM)<br /> - `y`: Y-axis value (often load)<br /> - **Returns:** table output value<br /> <br /> #### `findCurveIndex(name)`<br /> <br /> Returns the index of a script curve by name.<br /> <br /> #### `curve(curveIdx, x)`<br /> <br /> Looks up a value from a script curve.<br /> <br /> - **Parameters**<br /> - `curveIdx`: Curve index (1-based)<br /> - `x`: Axis value<br /> <br /> #### `setDebug(index, value)`<br /> <br /> Sets a debug channel when ECU debug mode is **Lua**.<br /> <br /> - **Parameters:** `index` 1–7, `value` — channel value<br /> - **Returns:** none<br /> <br /> ### Input<br /> <br /> #### `getSensor(name)`<br /> <br /> Reads a sensor by name, e.g. `getSensor("AcceleratorPedal")`.<br /> <br /> - **Parameters:** `name` — sensor name (same names as TunerStudio Live Data, e.g. `TPS`, `CLT`, `RPM`, `MAP`)<br /> - **Returns:** reading, or `nil` if the sensor is invalid or not configured<br /> <br /> #### `getSensorByIndex(index)`<br /> <br /> Reads a sensor by enum index.<br /> <br /> - **Returns:** reading, or `nil` on failure<br /> <br /> #### `getSensorRaw(index)`<br /> <br /> Raw sensor value (usually pin voltage before scaling).<br /> <br /> - **Returns:** raw value, or `0` if unsupported / not configured / failed<br /> <br /> #### `getAuxAnalog(index)`<br /> <br /> Like `getSensorRaw` but for aux analog inputs — always voltage.<br /> <br /> - **Parameters:** `index` 0–3<br /> - **Returns:** voltage, or `nil` if not configured<br /> <br /> #### `hasSensor(index)`<br /> <br /> Whether a sensor slot is configured (valid or not).<br /> <br /> - **Returns:** boolean<br /> <br /> #### `getDigital(index)`<br /> <br /> Reads a built-in digital input.<br /> <br /> | Index | Channel |<br /> |------:|----------------|<br /> | 0 | Clutch down |<br /> | 1 | Clutch up |<br /> | 2 | Brake switch |<br /> | 3 | AC switch |<br /> <br /> #### `getAuxDigital(index)`<br /> <br /> Reads a user-configured digital input (index 0–7). Configure pins under **Lua Digital Aux Inputs** in TunerStudio.<br /> <br /> #### `readPin(pinName)`<br /> <br /> Reads an MCU pin directly (e.g. `"PD15"`). Emergency/debug only — prefer Lua aux inputs for real logic.<br /> <br /> ### Output<br /> <br /> Not the same as Live Data “outputs” or GPPWM.<br /> <br /> #### `selfStimulateRPM(rpm)`<br /> <br /> Positive RPM starts injector clicking at that speed; `0` stops self-stimulation.<br /> <br /> #### `startPwm(index, frequency, duty)`<br /> <br /> Starts PWM on a Lua PWM output. Pin assignment: **Lua PWM Outputs** in TunerStudio.<br /> <br /> - **Parameters**<br /> - `index`: 0–7<br /> - `frequency`: 1–1000 Hz<br /> - `duty`: 0.0 = off, 1.0 = full on<br /> <br /> #### `setPwmDuty(index, duty)`<br /> <br /> #### `setPwmFreq(index, frequency)`<br /> <br /> #### `getGpPwm(index)`<br /> <br /> Current GPPWM output percent (index 0–3).<br /> <br /> #### `setLuaGauge(index, value)`<br /> <br /> Writes a Lua gauge (indices 1–8) for Live Data / logging.<br /> <br /> #### `setDacVoltage(index, value)`<br /> <br /> Only on boards with DAC hardware enabled.<br /> <br /> ## Console commands<br /> <br /> - `luamemory` — Lua memory usage<br /> - `luareset` — reset Lua VM<br /> <br /> ## Examples<br /> <br /> Example scripts ship with the firmware under `firmware/controllers/lua/examples/` ([browse on GitHub](https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples)).<br /> <br /> Notable examples: `honda-bcm.txt` (VSS from CAN / gear detection), `ford-focus-ii-pps.txt`, `bmw-idrive.txt`.<br /> <br /> ### Timer example<br /> <br /> ```lua<br /> t = Timer.new()<br /> timingAdd = 0<br /> <br /> function onTick()<br /> auxV = getAuxAnalog(0)<br /> tps = getSensor("TPS")<br /> -- check for nil if aux input is not assigned<br /> if auxV > 2 then<br /> t:reset()<br /> end<br /> <br /> val = t:getElapsedSeconds()<br /> <br /> if t:getElapsedSeconds() < 3 then<br /> timingAdd = 10<br /> else<br /> timingAdd = 0<br /> end<br /> setTimingAdd(timingAdd)<br /> <br /> print('Hello analog ' .. auxV .. " " .. val)<br /> end<br /> ```<br /> <br /> ### PWM<br /> <br /> ```lua<br /> startPwm(0, 100, 0)<br /> <br /> function onTick()<br /> enable_pump = getSensor("RPM") > 700 and getSensor("BatteryVoltage") > 13 and getSensor("VehicleSpeed") < 60<br /> setPwmDuty(0, enable_pump and 1 or 0)<br /> end<br /> ```<br /> <br /> ### CAN transmit<br /> <br /> ```lua<br /> function onTick()<br /> clt = getSensor("CLT")<br /> print('CLT ' .. clt)<br /> voltage0 = getSensor("aux0")<br /> <br /> txPayload = {}<br /> txPayload[1] = math.floor(((voltage0/256) - math.floor(voltage0/256))*256)<br /> txPayload[2] = math.floor(voltage0 / 256)<br /> <br /> txCan(1, 0x600, 1, txPayload)<br /> end<br /> ```<br /> <br /> ### Set sensor value<br /> <br /> Use standard sensor names from TunerStudio Live Data.<br /> <br /> ```lua<br /> -- do not configure the same physical input elsewhere<br /> vssSensor = Sensor.new("VehicleSpeed")<br /> vssSensor:setTimeout(3000)<br /> function onTick()<br /> injectedVssValue = 123.4<br /> vssSensor:set(injectedVssValue)<br /> valFromSensor = getSensor("VehicleSpeed")<br /> print("VSS " .. valFromSensor)<br /> end<br /> ```<br /> <br /> ### CAN receive<br /> <br /> ```lua<br /> canRxAdd(0x500)<br /> canRxAdd(0x570)<br /> function onCanRx(bus, id, dlc, data)<br /> print('got CAN id=' .. id .. ' dlc=' .. dlc)<br /> if id == 0x500 then<br /> canState = data[1]<br /> end<br /> if id == 0x570 then<br /> mcu_standby()<br /> end<br /> end<br /> ```<br /> <br /> ### Table / curve<br /> <br /> ```lua<br /> tableIndex = findTableIndex("duty")<br /> <br /> TurbochargerSpeed = getSensor("TurbochargerSpeed")<br /> tps = getSensor("Tps1")<br /> <br /> dutyCycle = table3d(tableIndex, TurbochargerSpeed, tps)<br /> <br /> sparkCutCurve = findCurveIndex("sparkcut")<br /> sparkCutByTorque = curve(sparkCutCurve, torquex)<br /> ```<br /> <br /> ## See also<br /> <br /> - [Variable Status Selector](https://content.epicefi.com/docs/variable_status_selector.html) — names, types, and hashes for your firmware<br /> - [Lua examples](https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples) — vehicle-specific scripts<br /> - [Lua ternary operator](http://lua-users.org/wiki/TernaryOperator) — Lua has no `?:`; use `and` / `or` patterns</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Lua&diff=497 Lua 2026-08-18T03:15:33Z

<p>Joesphan: </p> <hr /> <div><nowiki>#</nowiki> Lua Scripting<br /> <br /> <nowiki>**</nowiki>TL;DR:** Connect with TunerStudio, open the **Lua** tab (or use epicEFI Console), and edit your script there. Lua runs on the ECU for live scripting. The most popular use case is CAN bus integration.<br /> <br /> <nowiki>##</nowiki> Introduction<br /> <br /> epicEFI gives you a lot of flexibility — enough to build user-defined control strategies for primary and auxiliary actuators. Boards with an **F7** or **H7** MCU (EpicECU, M144H7, M144F7RED, etc.) have the most headroom for Lua. F4 boards (MEGA100F4, UAEFI) also support Lua but with tighter memory limits.<br /> <br /> <nowiki>##</nowiki> Variable names and hashes<br /> <br /> Calibration names, output channel names, variable types (CONFIG GETTER/SETTER, OUTPC GETTER/SETTER), and their **djb2 hashes** depend on your exact firmware build. Do not guess — look them up here:<br /> <br /> <nowiki>**</nowiki>[Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html)**</nowiki><br /> <br /> Use this tool when calling `getCalibration()` / `setCalibration()`, `getOutput()`, configuring user-table axes, or reading/writing variables over EPIC CAN.<br /> <br /> <nowiki>##</nowiki> Basics<br /> <br /> epicEFI provides hooks to interface with the firmware, manipulate its state, and read/write configuration:<br /> <br /> - [Hooks for CAN bus communications](#can-bus)<br /> <br /> - [Inputs from sensors can be read directly](#input). [You can also produce sensor values](#set-sensor-value) with Lua.<br /> <br /> - [ECU general purpose outputs](#output)<br /> <br /> - [Aspects of the engine can be controlled directly](#engine-control)<br /> <br /> - ECU configuration can be accessed (read/write) via [`getCalibration()`](#getcalibrationname) and [`setCalibration()`](#setcalibrationname-value-needevent).<br /> <br /> - Valid calibration names for your firmware are listed in the [Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html</nowiki>).<br /> <br /> - ECU internal state (logic outputs / Live Data values) can be read via [`getOutput()`](#getoutputname), and some can be changed via dedicated setters (e.g. [`setClutchUpState()`](#setclutchupstatevalue)). See [Output](#output).<br /> <br /> - Valid output names for your firmware are listed in the [Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html</nowiki>).<br /> <br /> - Hooks to read values from SENT sensors; see [SENT protocol](#sent-protocol).<br /> <br /> - Useful helper routines; see [Utility](#utility).<br /> <br /> Some example uses are in [Examples](#examples).<br /> <br /> <nowiki>##</nowiki> Conventions<br /> <br /> - The Lua interpreter reports errors when something is wrong; check epicEFI Console / TunerStudio Lua output for errors and `print()` output.<br /> <br /> - Unless otherwise noted, all `index` parameters are **zero-based** (first element is index `0`).<br /> <br /> <nowiki>##</nowiki> Writing Your Script<br /> <br /> The entire Lua script is loaded at startup. After that, a function named `onTick` is called periodically by epicEFI.<br /> <br /> Simple startup example:<br /> <br /> ```lua<br /> <br /> print('Hello Lua startup!')<br /> <br /> function onTick()<br /> <br /> print('Hello onTick()')<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> Controlling the tick rate<br /> <br /> `setTickRate(hz)` sets how often epicEFI calls `onTick`. If your script does heavy work, it may run slower than the requested rate. The Lua VM runs at low priority relative to engine control, so you cannot starve critical ECU functions — set the rate to whatever your script needs. `onCanRx` runs at the same rate as `onTick`.<br /> <br /> ```lua<br /> <br /> n = 0<br /> <br /> setTickRate(5) -- 5 Hz<br /> <br /> function onTick()<br /> <br /> print('Hello Lua: ' .. n)<br /> <br /> n = n + 1<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> Editing scripts<br /> <br /> An editor with [Lua Language Server](<nowiki>https://github.com/LuaLS/lua-language-server#install</nowiki>) (LSP) support makes writing scripts much easier.<br /> <br /> <nowiki>##</nowiki> Hooks / function reference<br /> <br /> <nowiki>###</nowiki> User settings<br /> <br /> <nowiki>####</nowiki> `getOutput(name)`<br /> <br /> Example: `getOutput("clutchUpState")` or `getOutput("brakePedalState")`.<br /> <br /> Valid output names for your firmware: [Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html</nowiki>).<br /> <br /> <nowiki>####</nowiki> `setClutchUpState(value)`<br /> <br /> <nowiki>####</nowiki> `setBrakePedalState(value)`<br /> <br /> Use `setBrakePedalState` to report a CAN-based brake pedal to epicEFI.<br /> <br /> <nowiki>####</nowiki> `setAcRequestState(value)`<br /> <br /> Use `setAcRequestState` to report a CAN-based A/C request.<br /> <br /> <nowiki>####</nowiki> `setEtbDisabled(value)`<br /> <br /> <nowiki>####</nowiki> `setIgnDisabled(value)`<br /> <br /> Use `setIgnDisabled` for cranking safety and other ignition-cut strategies.<br /> <br /> <nowiki>####</nowiki> `setAcDisabled(value)`<br /> <br /> Disable/suppress A/C regardless of how it would otherwise be enabled.<br /> <br /> <nowiki>####</nowiki> `getTimeSinceAcToggleMs()`<br /> <br /> <nowiki>####</nowiki> `getCalibration(name)`<br /> <br /> Returns the current value of a scalar calibration setting. Example: `getCalibration("cranking.rpm")`.<br /> <br /> Full list of valid names: [Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html</nowiki>).<br /> <br /> <nowiki>####</nowiki> `setCalibration(name, value, needEvent)`<br /> <br /> Sets a calibration value. Optionally fires a calibration change event depending on `needEvent`.<br /> <br /> Example: `setCalibration("cranking.rpm", 900, false)`<br /> <br /> <nowiki>####</nowiki> `burnconfig`<br /> <br /> Schedules a write of current calibration to flash once the engine is stopped.<br /> <br /> <nowiki>####</nowiki> `findSetting(name, defaultValue)`<br /> <br /> Finds a user setting by name and returns its numeric value. Useful when the script author and the tuner are different people, or when editing is done only through TunerStudio fields rather than the Lua editor.<br /> <br /> - **Parameters**<br /> <br /> - `name`: Variable name (matches the configuration field name)<br /> <br /> - `defaultValue`: Returned if the setting is not found<br /> <br /> <nowiki>###</nowiki> `isFirmwareError`<br /> <br /> Returns `true` if the ECU is in a critical/fatal error state.<br /> <br /> <nowiki>###</nowiki> Engine control<br /> <br /> <nowiki>####</nowiki> `startCrankingEngine()`<br /> <br /> Starts cranking as if the physical start button were pressed.<br /> <br /> <nowiki>####</nowiki> `stopEngine()`<br /> <br /> <nowiki>####</nowiki> `isEngineStopRequested()`<br /> <br /> Returns `true` if an engine stop was requested (by Lua or the start/stop button) within the last five seconds.<br /> <br /> <nowiki>####</nowiki> `setLaunchTrigger`<br /> <br /> <nowiki>####</nowiki> `setSparkSkipRatio(ratio)`<br /> <br /> - `setSparkSkipRatio(0)` — skip 0% of ignition events (no skip)<br /> <br /> - `setSparkSkipRatio(0.5)` — skip half of ignition events (never two consecutive skips)<br /> <br /> Useful for torque reduction.<br /> <br /> <nowiki>####</nowiki> `setSparkHardSkipRatio(ratio)`<br /> <br /> - `setSparkHardSkipRatio(0)` — no skip<br /> <br /> - `setSparkHardSkipRatio(0.75)` — skip 75% of ignition events<br /> <br /> <nowiki>####</nowiki> `setIdleAdd(percent)`<br /> <br /> Percent added to idle (including open loop).<br /> <br /> <nowiki>####</nowiki> `setFuelAdd(amount)`<br /> <br /> <nowiki>*</nowiki>Currently not functional.*<br /> <br /> Fuel mass to add to injection, scaled by [`setFuelMult()`](#setfuelmultcoeff); starts at 0.<br /> <br /> <nowiki>####</nowiki> `setFuelMult(coeff)`<br /> <br /> <nowiki>*</nowiki>Currently not functional.*<br /> <br /> Multiplier for added fuel mass; starts at 1.0.<br /> <br /> <nowiki>####</nowiki> `setBoostTargetAdd(amount)`<br /> <br /> Additive offset for closed-loop boost target.<br /> <br /> <nowiki>####</nowiki> `setBoostTargetMult(coeff)`<br /> <br /> Multiplier for closed-loop boost target.<br /> <br /> <nowiki>####</nowiki> `setBoostDutyAdd(amount)`<br /> <br /> Additive offset for open-loop boost duty.<br /> <br /> <nowiki>####</nowiki> `setTimingAdd(angle)`<br /> <br /> Use negative values to retard timing.<br /> <br /> <nowiki>####</nowiki> `setTimingMult(coeff)`<br /> <br /> Useful for torque reduction.<br /> <br /> <nowiki>####</nowiki> `setEtbAdd(percent)`<br /> <br /> ETB adder as a percent of wide-open: e.g. `10` adds +10%. Static offset on top of the computed position (TPS 5% + `10` → 15% ETB command).<br /> <br /> Useful for torque reduction.<br /> <br /> <nowiki>###</nowiki> Timer<br /> <br /> `yourTimer = Timer.new()` creates a timer object.<br /> <br /> <nowiki>####</nowiki> `reset`<br /> <br /> `yourTimer:reset()` resets the timer.<br /> <br /> <nowiki>####</nowiki> `getElapsedSeconds`<br /> <br /> `yourTimer:getElapsedSeconds()` returns seconds since last reset.<br /> <br /> <nowiki>####</nowiki> `getTsButtonCount`<br /> <br /> `getTsButtonCount(X)` returns how many times Lua button **X** was pressed in TunerStudio. See `ts-button-example.lua` in the firmware examples.<br /> <br /> <nowiki>###</nowiki> CAN bus<br /> <br /> <nowiki>####</nowiki> `enableCanTx(isEnabled)`<br /> <br /> Enabled by default. Use `enableCanTx(false)` to suppress CAN transmit from Lua.<br /> <br /> <nowiki>####</nowiki> `txCan(bus, ID, isExt, payload)`<br /> <br /> - **Parameters**<br /> <br /> - `bus`: Hardware CAN bus index — typically `1` on single-CAN boards; `1` or `2` on dual-CAN boards (EpicECU, M144H7, etc.)<br /> <br /> - `isExt`: `0` for 11-bit standard ID<br /> <br /> <nowiki>####</nowiki> `canRxAdd(id)`<br /> <br /> <nowiki>####</nowiki> `canRxAdd(bus, id)`<br /> <br /> <nowiki>####</nowiki> `canRxAdd(id, callback)`<br /> <br /> <nowiki>####</nowiki> `canRxAdd(bus, id, callback)`<br /> <br /> <nowiki>####</nowiki> `canRxAddMask(id, mask)`<br /> <br /> <nowiki>####</nowiki> `canRxAddMask(bus, id, mask)`<br /> <br /> <nowiki>####</nowiki> `canRxAddMask(id, mask, callback)`<br /> <br /> <nowiki>####</nowiki> `canRxAddMask(bus, id, mask, callback)`<br /> <br /> - **Parameters**<br /> <br /> - `id`: CAN ID to listen for<br /> <br /> - `mask`: Applied to the received ID before comparison. Example: id `3` and mask `0xFF` matches any frame whose low 8 bits are `3`. Omit the mask to match exactly one ID.<br /> <br /> - `bus`: Hardware CAN bus index. If omitted, frames from any bus are received.<br /> <br /> - `callback`: Function called when a matching frame arrives. If omitted, `onCanRx` is used.<br /> <br /> CAN RX callback shape:<br /> <br /> ```lua<br /> <br /> function onCanRx(bus, id, dlc, data)<br /> <br /> -- handle frame<br /> <br /> end<br /> <br /> ```<br /> <br /> For high-throughput RX, see `enableCanRxWorkaround()` in the firmware examples.<br /> <br /> <nowiki>###</nowiki> SENT protocol<br /> <br /> <nowiki>####</nowiki> `getSentValue(index)`<br /> <br /> <nowiki>####</nowiki> `getSentValues(index)`<br /> <br /> <nowiki>###</nowiki> PID<br /> <br /> `deltaTime` is measured automatically between successive `pid:get` calls.<br /> <br /> ```lua<br /> <br /> -- p, i, d, min, max<br /> <br /> pid = Pid.new(2, 0, 0, -100, 100)<br /> <br /> pid:setOffset(0.3)<br /> <br /> pid:get(target, input)<br /> <br /> pid:reset()<br /> <br /> industrialPid = IndustrialPid.new(2, 0, 0, -100, 100)<br /> <br /> industrialPid:setOffset(0.3)<br /> <br /> industrialPid:setDerivativeFilterLoss(0.3)<br /> <br /> industrialPid:setAntiwindupFreq(0.3)<br /> <br /> industrialPid:get(target, input)<br /> <br /> industrialPid:reset()<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> Utility<br /> <br /> <nowiki>####</nowiki> `print(msg)`<br /> <br /> Prints a line to the ECU log.<br /> <br /> - **Parameters:** `msg` — string or number<br /> <br /> - **Returns:** none<br /> <br /> <nowiki>####</nowiki> `vin(index)`<br /> <br /> Returns the VIN character at the given zero-based index.<br /> <br /> <nowiki>**</nowiki>Example:**<br /> <br /> ```lua<br /> <br /> n = 5.5<br /> <br /> print('Hello Lua, number is: ' .. n)<br /> <br /> ```<br /> <br /> Output: `Hello Lua, number is: 5.5`<br /> <br /> <nowiki>####</nowiki> `setTickRate(hz)`<br /> <br /> Sets how often epicEFI calls `onTick` and `onCanRx`, in Hz. Default after reset is 10 Hz.<br /> <br /> - **Parameters:** `hz` — clamped to 1–200 Hz<br /> <br /> - **Returns:** none<br /> <br /> <nowiki>####</nowiki> `mcu_standby()`<br /> <br /> Puts the MCU into standby (low current). Use with care.<br /> <br /> <nowiki>####</nowiki> `interpolate(x1, y1, x2, y2, x)`<br /> <br /> Linear interpolation of `x` on the line through `(x1, y1)` and `(x2, y2)`.<br /> <br /> <nowiki>####</nowiki> `findTableIndex(name)`<br /> <br /> Returns the index of a script table by human-readable name.<br /> <br /> <nowiki>####</nowiki> `table3d(tableIdx, x, y)`<br /> <br /> Looks up a value from a script 3D table.<br /> <br /> - **Parameters**<br /> <br /> - `tableIdx`: Table index (1–4)<br /> <br /> - `x`: X-axis value (often RPM)<br /> <br /> - `y`: Y-axis value (often load)<br /> <br /> - **Returns:** table output value<br /> <br /> <nowiki>####</nowiki> `findCurveIndex(name)`<br /> <br /> Returns the index of a script curve by name.<br /> <br /> <nowiki>####</nowiki> `curve(curveIdx, x)`<br /> <br /> Looks up a value from a script curve.<br /> <br /> - **Parameters**<br /> <br /> - `curveIdx`: Curve index (1-based)<br /> <br /> - `x`: Axis value<br /> <br /> <nowiki>####</nowiki> `setDebug(index, value)`<br /> <br /> Sets a debug channel when ECU debug mode is **Lua**.<br /> <br /> - **Parameters:** `index` 1–7, `value` — channel value<br /> <br /> - **Returns:** none<br /> <br /> <nowiki>###</nowiki> Input<br /> <br /> <nowiki>####</nowiki> `getSensor(name)`<br /> <br /> Reads a sensor by name, e.g. `getSensor("AcceleratorPedal")`.<br /> <br /> - **Parameters:** `name` — sensor name (same names as TunerStudio Live Data, e.g. `TPS`, `CLT`, `RPM`, `MAP`)<br /> <br /> - **Returns:** reading, or `nil` if the sensor is invalid or not configured<br /> <br /> <nowiki>####</nowiki> `getSensorByIndex(index)`<br /> <br /> Reads a sensor by enum index.<br /> <br /> - **Returns:** reading, or `nil` on failure<br /> <br /> <nowiki>####</nowiki> `getSensorRaw(index)`<br /> <br /> Raw sensor value (usually pin voltage before scaling).<br /> <br /> - **Returns:** raw value, or `0` if unsupported / not configured / failed<br /> <br /> <nowiki>####</nowiki> `getAuxAnalog(index)`<br /> <br /> Like `getSensorRaw` but for aux analog inputs — always voltage.<br /> <br /> - **Parameters:** `index` 0–3<br /> <br /> - **Returns:** voltage, or `nil` if not configured<br /> <br /> <nowiki>####</nowiki> `hasSensor(index)`<br /> <br /> Whether a sensor slot is configured (valid or not).<br /> <br /> - **Returns:** boolean<br /> <br /> <nowiki>####</nowiki> `getDigital(index)`<br /> <br /> Reads a built-in digital input.<br /> <br /> | Index | Channel |<br /> <br /> |------:|----------------|<br /> <br /> | 0 | Clutch down |<br /> <br /> | 1 | Clutch up |<br /> <br /> | 2 | Brake switch |<br /> <br /> | 3 | AC switch |<br /> <br /> <nowiki>####</nowiki> `getAuxDigital(index)`<br /> <br /> Reads a user-configured digital input (index 0–7). Configure pins under **Lua Digital Aux Inputs** in TunerStudio.<br /> <br /> <nowiki>####</nowiki> `readPin(pinName)`<br /> <br /> Reads an MCU pin directly (e.g. `"PD15"`). Emergency/debug only — prefer Lua aux inputs for real logic.<br /> <br /> <nowiki>###</nowiki> Output<br /> <br /> Not the same as Live Data “outputs” or GPPWM.<br /> <br /> <nowiki>####</nowiki> `selfStimulateRPM(rpm)`<br /> <br /> Positive RPM starts injector clicking at that speed; `0` stops self-stimulation.<br /> <br /> <nowiki>####</nowiki> `startPwm(index, frequency, duty)`<br /> <br /> Starts PWM on a Lua PWM output. Pin assignment: **Lua PWM Outputs** in TunerStudio.<br /> <br /> - **Parameters**<br /> <br /> - `index`: 0–7<br /> <br /> - `frequency`: 1–1000 Hz<br /> <br /> - `duty`: 0.0 = off, 1.0 = full on<br /> <br /> <nowiki>####</nowiki> `setPwmDuty(index, duty)`<br /> <br /> <nowiki>####</nowiki> `setPwmFreq(index, frequency)`<br /> <br /> <nowiki>####</nowiki> `getGpPwm(index)`<br /> <br /> Current GPPWM output percent (index 0–3).<br /> <br /> <nowiki>####</nowiki> `setLuaGauge(index, value)`<br /> <br /> Writes a Lua gauge (indices 1–8) for Live Data / logging.<br /> <br /> <nowiki>####</nowiki> `setDacVoltage(index, value)`<br /> <br /> Only on boards with DAC hardware enabled.<br /> <br /> <nowiki>##</nowiki> Console commands<br /> <br /> - `luamemory` — Lua memory usage<br /> <br /> - `luareset` — reset Lua VM<br /> <br /> <nowiki>##</nowiki> Examples<br /> <br /> Example scripts ship with the firmware under `firmware/controllers/lua/examples/` ([browse on GitHub](<nowiki>https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples</nowiki>)).<br /> <br /> Notable examples: `honda-bcm.txt` (VSS from CAN / gear detection), `ford-focus-ii-pps.txt`, `bmw-idrive.txt`.<br /> <br /> <nowiki>###</nowiki> Timer example<br /> <br /> ```lua<br /> <br /> t = Timer.new()<br /> <br /> timingAdd = 0<br /> <br /> function onTick()<br /> <br /> auxV = getAuxAnalog(0)<br /> <br /> tps = getSensor("TPS")<br /> <br /> -- check for nil if aux input is not assigned<br /> <br /> if auxV > 2 then<br /> <br /> t:reset()<br /> <br /> end<br /> <br /> val = t:getElapsedSeconds()<br /> <br /> if t:getElapsedSeconds() < 3 then<br /> <br /> timingAdd = 10<br /> <br /> else<br /> <br /> timingAdd = 0<br /> <br /> end<br /> <br /> setTimingAdd(timingAdd)<br /> <br /> print('Hello analog ' .. auxV .. " " .. val)<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> PWM<br /> <br /> ```lua<br /> <br /> startPwm(0, 100, 0)<br /> <br /> function onTick()<br /> <br /> enable_pump = getSensor("RPM") > 700 and getSensor("BatteryVoltage") > 13 and getSensor("VehicleSpeed") < 60<br /> <br /> setPwmDuty(0, enable_pump and 1 or 0)<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> CAN transmit<br /> <br /> ```lua<br /> <br /> function onTick()<br /> <br /> clt = getSensor("CLT")<br /> <br /> print('CLT ' .. clt)<br /> <br /> voltage0 = getSensor("aux0")<br /> <br /> txPayload = {}<br /> <br /> txPayload[1] = math.floor(((voltage0/256) - math.floor(voltage0/256))*256)<br /> <br /> txPayload[2] = math.floor(voltage0 / 256)<br /> <br /> txCan(1, 0x600, 1, txPayload)<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> Set sensor value<br /> <br /> Use standard sensor names from TunerStudio Live Data.<br /> <br /> ```lua<br /> <br /> -- do not configure the same physical input elsewhere<br /> <br /> vssSensor = Sensor.new("VehicleSpeed")<br /> <br /> vssSensor:setTimeout(3000)<br /> <br /> function onTick()<br /> <br /> injectedVssValue = 123.4<br /> <br /> vssSensor:set(injectedVssValue)<br /> <br /> valFromSensor = getSensor("VehicleSpeed")<br /> <br /> print("VSS " .. valFromSensor)<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> CAN receive<br /> <br /> ```lua<br /> <br /> canRxAdd(0x500)<br /> <br /> canRxAdd(0x570)<br /> <br /> function onCanRx(bus, id, dlc, data)<br /> <br /> print('got CAN id=' .. id .. ' dlc=' .. dlc)<br /> <br /> if id == 0x500 then<br /> <br /> canState = data[1]<br /> <br /> end<br /> <br /> if id == 0x570 then<br /> <br /> mcu_standby()<br /> <br /> end<br /> <br /> end<br /> <br /> ```<br /> <br /> <nowiki>###</nowiki> Table / curve<br /> <br /> ```lua<br /> <br /> tableIndex = findTableIndex("duty")<br /> <br /> TurbochargerSpeed = getSensor("TurbochargerSpeed")<br /> <br /> tps = getSensor("Tps1")<br /> <br /> dutyCycle = table3d(tableIndex, TurbochargerSpeed, tps)<br /> <br /> sparkCutCurve = findCurveIndex("sparkcut")<br /> <br /> sparkCutByTorque = curve(sparkCutCurve, torquex)<br /> <br /> ```<br /> <br /> <nowiki>##</nowiki> See also<br /> <br /> - [Variable Status Selector](<nowiki>https://content.epicefi.com/docs/variable_status_selector.html</nowiki>) — names, types, and hashes for your firmware<br /> <br /> - [Lua examples](<nowiki>https://github.com/epicEFI/epicefi_fw/tree/master/firmware/controllers/lua/examples</nowiki>) — vehicle-specific scripts<br /> <br /> - [Lua ternary operator](<nowiki>http://lua-users.org/wiki/TernaryOperator</nowiki>) — Lua has no `?:`; use `and` / `or` patterns</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Lua&diff=496 Lua 2026-08-18T02:49:32Z

<p>Joesphan: Created page with "safsefwefewfewfwef"</p> <hr /> <div>safsefwefewfewfwef</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Welcome&diff=495 Welcome 2026-08-18T02:49:24Z

<p>Joesphan: </p> <hr /> <div>[[File:Epicefi.png|center|320px|link=|alt=epicEFI logo]]<br /> <br /> = epicEFI Wiki =<br /> <br /> ''Firmware, tuning tools, docs, and community support for epicEFI.''<br /> <br /> {| class="wikitable" style="width:100%; text-align:left; margin-top:0.6em;"<br /> ! style="width:33%;" | Firmware<br /> ! style="width:33%;" | EpicTuner<br /> ! style="width:34%;" | Community<br /> |-<br /> | '''[https://content.epicefi.com/firmware/ Download firmware]'''<br /> <br/><span style="font-size:90%;">Stable builds and release files</span><br /> | '''[https://github.com/AKCore/epictuner_public/releases/latest Get EpicTuner]'''<br /> <br/><span style="font-size:90%;">Latest release on GitHub</span><br /> | '''[https://discord.gg/TwVxa2wRZS Join Discord]'''<br /> <br/><span style="font-size:90%;">Support + announcements + chat</span><br /> |}<br /> <br /> == Start here ==<br /> * '''[[Quickstart]]''' — fastest way to get your ECU running<br /> * '''[[Configuration]]''' — TunerStudio options and setup<br /> <br /> == Firmware ==<br /> * '''[[Firmware#Updating the Firmware|Update firmware]]''' — step-by-step update guide<br /> <br /> == Hardware and compatibility ==<br /> * '''[[Hardware]]''' — supported epicEFI hardware<br /> * '''[[Triggers]]''' — check trigger pattern support<br /> <br /> == Advanced ==<br /> * [[Lua]] — scripting documentation<br /> <br /> == Project ==<br /> * '''[[About]]''' — what epicEFI is and how it works<br /> * '''[[Contributing]]''' — how to help improve the project<br /> <br /> == AI Section ==<br /> * '''[[Claude Discord AI Docs|Claude Discord AI Docs]]''' — attempts by claude to parse chat history<br /> <br /> == Need help? ==<br /> If you’re stuck, join '''[https://discord.gg/TwVxa2wRZS Discord]''' for community support.</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Welcome&diff=494 Welcome 2026-08-18T02:37:46Z

<p>Joesphan: /* epicEFI Wiki */</p> <hr /> <div>[[File:Epicefi.png|center|320px|link=|alt=epicEFI logo]]<br /> <br /> = epicEFI Wiki =<br /> <br /> ''Firmware, tuning tools, docs, and community support for epicEFI.''<br /> <br /> {| class="wikitable" style="width:100%; text-align:left; margin-top:0.6em;"<br /> ! style="width:33%;" | Firmware<br /> ! style="width:33%;" | EpicTuner<br /> ! style="width:34%;" | Community<br /> |-<br /> | '''[https://content.epicefi.com/firmware/ Download firmware]'''<br /> <br/><span style="font-size:90%;">Stable builds and release files</span><br /> | '''[https://github.com/AKCore/epictuner_public/releases/latest Get EpicTuner]'''<br /> <br/><span style="font-size:90%;">Latest release on GitHub</span><br /> | '''[https://discord.gg/TwVxa2wRZS Join Discord]'''<br /> <br/><span style="font-size:90%;">Support + announcements + chat</span><br /> |}<br /> <br /> == Start here ==<br /> * '''[[Quickstart]]''' — fastest way to get your ECU running<br /> * '''[[Configuration]]''' — TunerStudio options and setup<br /> <br /> == Firmware ==<br /> * '''[[Firmware#Updating the Firmware|Update firmware]]''' — step-by-step update guide<br /> <br /> == Hardware and compatibility ==<br /> * '''[[Hardware]]''' — supported epicEFI hardware<br /> * '''[[Triggers]]''' — check trigger pattern support<br /> <br /> == Advanced ==<br /> * '''[https://www.google.com Lua]''' — scripting documentation<br /> <br /> == Project ==<br /> * '''[[About]]''' — what epicEFI is and how it works<br /> * '''[[Contributing]]''' — how to help improve the project<br /> <br /> == AI Section ==<br /> * '''[[Claude Discord AI Docs|Claude Discord AI Docs]]''' — attempts by claude to parse chat history<br /> <br /> == Need help? ==<br /> If you’re stuck, join '''[https://discord.gg/TwVxa2wRZS Discord]''' for community support.</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Welcome&diff=436 Welcome 2026-03-08T07:21:05Z

<p>Joesphan: /* AI Section */</p> <hr /> <div>[[File:Epicefi.png|center|320px|link=|alt=epicEFI logo]]<br /> <br /> = epicEFI Wiki =<br /> <br /> ''Firmware, tuning tools, docs, and community support for epicEFI.''<br /> <br /> {| class="wikitable" style="width:100%; text-align:left; margin-top:0.6em;"<br /> ! style="width:33%;" | Firmware<br /> ! style="width:33%;" | EpicTuner<br /> ! style="width:34%;" | Community<br /> |-<br /> | '''[https://content.epicefi.com/firmware/ Download firmware]'''<br /> <br/><span style="font-size:90%;">Stable builds and release files</span><br /> | '''[https://github.com/AKCore/epictuner_public/releases/latest Get EpicTuner]'''<br /> <br/><span style="font-size:90%;">Latest release on GitHub</span><br /> | '''[https://discord.gg/TwVxa2wRZS Join Discord]'''<br /> <br/><span style="font-size:90%;">Support + announcements + chat</span><br /> |}<br /> <br /> == Start here ==<br /> * '''[[Quickstart]]''' — fastest way to get your ECU running<br /> * '''[[Configuration]]''' — TunerStudio options and setup<br /> <br /> == Firmware ==<br /> * '''[[Firmware#Updating the Firmware|Update firmware]]''' — step-by-step update guide<br /> <br /> == Hardware and compatibility ==<br /> * '''[[Hardware]]''' — supported epicEFI hardware<br /> * '''[[Triggers]]''' — check trigger pattern support<br /> <br /> == Project ==<br /> * '''[[About|About]]''' — what epicEFI is and how it works<br /> * '''[[Contributing]]''' — how to help improve the project<br /> <br /> == AI Section ==<br /> * '''[[Claude Discord AI Docs|Claude Discord AI Docs]]''' — attempts by claude to parse chat history<br /> <br /> == Need help? ==<br /> If you’re stuck, join '''[https://discord.gg/TwVxa2wRZS Discord]''' for community support.</div>

Joesphan https://content.epicefi.com/wiki/index.php?title=Welcome&diff=435 Welcome 2026-03-08T07:20:42Z

<p>Joesphan: /* Start here */</p> <hr /> <div>[[File:Epicefi.png|center|320px|link=|alt=epicEFI logo]]<br /> <br /> = epicEFI Wiki =<br /> <br /> ''Firmware, tuning tools, docs, and community support for epicEFI.''<br /> <br /> {| class="wikitable" style="width:100%; text-align:left; margin-top:0.6em;"<br /> ! style="width:33%;" | Firmware<br /> ! style="width:33%;" | EpicTuner<br /> ! style="width:34%;" | Community<br /> |-<br /> | '''[https://content.epicefi.com/firmware/ Download firmware]'''<br /> <br/><span style="font-size:90%;">Stable builds and release files</span><br /> | '''[https://github.com/AKCore/epictuner_public/releases/latest Get EpicTuner]'''<br /> <br/><span style="font-size:90%;">Latest release on GitHub</span><br /> | '''[https://discord.gg/TwVxa2wRZS Join Discord]'''<br /> <br/><span style="font-size:90%;">Support + announcements + chat</span><br /> |}<br /> <br /> == Start here ==<br /> * '''[[Quickstart]]''' — fastest way to get your ECU running<br /> * '''[[Configuration]]''' — TunerStudio options and setup<br /> <br /> == Firmware ==<br /> * '''[[Firmware#Updating the Firmware|Update firmware]]''' — step-by-step update guide<br /> <br /> == Hardware and compatibility ==<br /> * '''[[Hardware]]''' — supported epicEFI hardware<br /> * '''[[Triggers]]''' — check trigger pattern support<br /> <br /> == Project ==<br /> * '''[[About|About]]''' — what epicEFI is and how it works<br /> * '''[[Contributing]]''' — how to help improve the project<br /> <br /> == AI Section ==<br /> * '''[[Claude Discord AI Docs|Claude Discord AI Docs]]''' — attempts by claude to parse chat history<br /> <br /> chicken<br /> <br /> == Need help? ==<br /> If you’re stuck, join '''[https://discord.gg/TwVxa2wRZS Discord]''' for community support.</div>

Joesphan