Skip to main content
Firmware Stable

Parameters

This document provides an overview of configurable parameters and internal states for the IGNIS starter-generator firmware.

Parameters

Parameter NameUnitDescription
start_thresholdVPhase voltage threshold to determine if the engine has started. Voltage above this level is considered as engine started.
start_level-Driver command during engine start (mode 3). Corresponds to speed.
pullback_level-Driver command during engine pullback operation (mode 3). Corresponds to speed.
max_trials-Maximum number of engine start attempts. 0 for unlimited attempts.
hyst_timmsDuration for voltage hysteresis. If phase voltage exceeds battery voltage for this duration, the engine is stopped (useful for engine overspeed or battery undervoltage).
pullback_timmsDuration of pullback operation. Set to 0 to disable pullback.
start_timmsMaximum allowed duration for a single engine start attempt. After this period, a pause is initiated before retrying.
pause_timmsDuration of pause after an unsuccessful start attempt.
noload_timmsNo-load operation duration immediately after engine startup.
ramp_timmsDuration for ramping up from no load to full load after startup.
IN_gen-GDIN ID for generator start input:
0: Disable input, start engine directly with controller.
16: GDIN0
17: GDIN1
18: GDIN2
19: GDIN3
20: GDIN4
32: din1
...
39: din8
tip

To tune your generator currents and voltages, you need to check the driver settings:

  • Your motor phase starting current is the iref
  • Your motor phase running current is the irefr
  • For battery minimum and maximum voltage, use /driver/limiter/ubmin resp /driver/limiter/ubmax
  • For battery currents, use /driver/limiter/ibpos resp /driver/limiter/ibneg

States

State NameDescription
modeCurrent operating mode of the generator.

Debugging States (gen_debug Directory)

The following states are available under the gen_debug directory for debugging and diagnostic purposes:

State NameDescription
sstateCurrent state of the starting sequence:
0: Initialization or running
1: Pullback
2: Starting
3: Pause after unsuccessful start
4: Completed cycle (transition state).
stimDuration timer (ms) for pullback and pause operations.
loadedTimer (ms) tracking engine load duration.
startedEngine start indicator:
Positive value indicates the engine has started.
toohighOvervoltage condition timer (ms).
armedGenerator armed indicator:
0: Not armed
1: Armed.
trialCurrent number of engine start trials.