Protection settings define when the controller limits or stops output and when it can recover. Diagnose the condition that triggered protection before changing a limit; the documented values below are examples, not a safe tune for every build.

PROTECT

ParameterValueSystem RoleUnder Load BehaviorInteractionReal-World BehaviorFailure Mode
OverVolProtect91.1VOver-voltage limitCuts power on high voltageRegen / BatteryPrevents overchargeSudden cutout
OverVolRestore89.6VRecovery thresholdRestores after voltage dropsRegenSmooth recoveryOscillation if close
LowVolProtect58VLow-voltage cutoffLimits dischargeBattery / LoadPrevents over-dischargePower loss
LowVolRestore60VRecovery thresholdRestores after voltage riseBatteryNormal operation resumesCycling
MotorTempProtect160°CMotor thermal limitReduces/halts outputPhase currentPrevents motor damageThermal shutdown
MotorTempRestore140°CRecovery tempRestores operationMotor tempSafe restartDelay
ControllerTempProtect100°CController limitReduces outputCurrent systemProtects controllerPower reduction
ControllerTempRestore80°CRecovery tempRestores outputController tempStable recoveryDelay
O BattCoeff896Battery scalingSOC/voltage modelingBattery systemAccurate estimationMisread
Full BattCoeff1250Full charge scalingSOC calibrationBattery systemAccurate full stateMisread
ThrottleLost0-InvalSafety logicDetects throttle faultThrottle systemPrevents runawayDisabled safety
ThrottleInsert256Input detectionValidates throttle signalThrottle systemStable inputMisread
BackP_Time18-240sReverse timingLimits reverse durationBackSpeedSafe reverse useLockout
ReleaseToSeat2sSafety delayRequires seat signalSeat inputPrevents unintended accelDelay
BlockTime50sFault blockLocks system after faultProtection logicPrevents repeated faultsDowntime
ParkTime10sPark delayEngages park after idlePark systemAnti-rollUnexpected lock
LmtSpdStartCap0Speed cap startLimits accelerationSpeed systemControlled startWeak launch
LmtSpdMinCap0Min capLower bound limitSpeed systemNeutralRestriction
LmtSpdMaxCoeff128Speed scalingCaps max speedLimitSpeedControlled top speedReduced performance
TurtleSpeedCurrCoeff53Limp mode currentReduces power in faultCurrent systemReduced performance modeVery weak output
BattSignal3-Lithium BatteryBattery typeDefines battery modelProtection systemCorrect behaviorMis-scaling
LowVol Way11-SOPLow voltage logicDefines cutoff behaviorVoltage systemStable cutoffErratic cutoff
IntRes32Internal resistanceModels voltage sagCurrent / VoltageAccurate sag responseMisbehavior
TempCoeff300Temp scalingAdjusts temp readingsThermal systemAccurate protectionMisread temps

Core behavior:

  • Protection system defines hard safety limits for voltage, temperature, current behavior, and system faults
  • These parameters override all performance settings when thresholds are exceeded
  • The system continuously monitors conditions and intervenes to prevent damage

Core principle:

If Limit Exceeded -> Reduce Power or Shutdown

Interaction layer:

  • Voltage protection interacts heavily with regen (OverVolProtect) and load (LowVolProtect)
  • Temperature protection interacts with MaxPhaseCurr and sustained load
  • IntRes influences voltage sag modeling, affecting low-voltage cutoffs under load
  • Throttle and safety inputs prevent unintended acceleration or faults
  • Turtle mode reduces current when faults or limits are approached

Real-world behavior:

  • High load -> voltage sag -> potential low-voltage cutoff

  • Strong regen -> voltage spike -> possible over-voltage cutout

  • Sustained acceleration -> heat buildup -> thermal limiting

  • Fault conditions -> system enters reduced power (turtle mode) or shuts down

  • Riders experience:

    • Sudden power loss under extreme load
    • Reduced performance when hot
    • Cutouts during aggressive regen on full battery

Limits and failure modes:

  • Overly aggressive limits -> frequent cutouts and poor usability
  • Too loose limits -> risk of motor, controller, or battery damage
  • Incorrect IntRes -> inaccurate sag prediction -> unexpected cutoffs
  • Disabled safety (ThrottleLost, etc.) -> unsafe operation

Tuning Guidance (ONYX-Specific)

  • Set voltage limits based on actual battery pack (72V nominal -> align cutoffs accordingly)
  • Ensure OverVolProtect accounts for regen spikes on full charge
  • Keep thermal limits conservative - QS motors generate high heat under load
  • Adjust IntRes to match real battery behavior for accurate sag modeling
  • Do not disable safety features unless fully understood
  • If experiencing cutouts:
    • Check voltage sag (LowVolProtect)
    • Check regen spikes (OverVolProtect)
    • Check thermal limits before increasing current