If a JAWS MODE test produces cutouts, surging, heat, or unexpected response, stop and return to the last stable setup. Check the physical system and measurements before deciding that a setting is responsible.
Diagnose Before Adjusting
A symptom can have more than one cause. The adjustment table preserves the earlier tuning notes; it is not an instruction to raise current, change throttle thresholds, or weaken protection based on a symptom alone. Verify wiring, throttle measurements, motor identification, battery limits, and the actual fault first.
Use throttle diagnostics , battery cutout diagnosis , and regen cutout diagnosis for their specific checks. Record signals with assistance or a suitable logger rather than looking at a phone while riding.
Troubleshooting and Error Mapping
Use this section to quickly diagnose issues and map them to likely parameter causes.
Throttle Error During AutoLearn
Possible causes:
- incorrect voltage range
- mismatch between throttle type
Checks after confirming the cause:
- verify Throttle Low / High values
- confirm Domino vs Standard throttle settings
- re-run AutoLearn
Hard Cutoff at High Speed
Possible causes:
- LimitSpeed set too close to max RPM
Checks after confirming the cause:
- reduce LimitSpeed further below WO_MaxRPM
Surging at Steady Speed
Possible causes:
- PID imbalance or throttle sensitivity
Checks after confirming the cause:
- reduce SpeedKP
- adjust Throttle Acc Step
Excessive Heat
Possible causes:
- current limits too high
- inefficient field weakening
Checks after confirming the cause:
- reduce MaxLineCurr / MaxPhaseCurr
- adjust WeakCurrCoeff
Weak Acceleration
Possible causes:
- low phase current or conservative tuning
Checks after confirming the cause:
- increase MaxPhaseCurr
- increase StartKI / MidKI
Jerky Low-Speed Control
Possible causes:
- aggressive throttle or start parameters
Checks after confirming the cause:
- reduce StartKP
- reduce Throttle Acc Step
Unstable High-Speed Behavior
Possible causes:
- overly aggressive field weakening
Checks after confirming the cause:
- reduce WeakCurrCoeff
- smooth high-RPM map values
Noisy or Rough No-Load Behavior
Possible causes:
- phase angle mismatch
- invalid angle detect behavior
- aggressive weakening response
Checks after confirming the cause:
- verify PhaseOffset
- verify AngleDetect
- reduce WeakResponse
Throttle Does Little Until Mid Rotation
Possible causes:
- low-end scaling issue
Checks after confirming the cause:
- increase Throttle Low slightly
- verify throttle voltage range
Symptom to Parameter Adjustment Table
| Symptom | Likely Cause | Parameter | Recorded Adjustment Direction |
|---|---|---|---|
| Hesitation on launch | weak start tuning | StartKI | Increase |
| Jerky takeoff | aggressive start tuning | StartKP | Decrease |
| Throttle too sensitive | aggressive ramp | Throttle Acc Step | Decrease |
| Throttle feels dead | low input scaling | Throttle Low | Increase slightly |
| Weak acceleration | low torque output | MaxPhaseCurr | Increase |
| Early power drop | current limiting | MaxLineCurr | Increase within limits |
| Surging at steady speed | PID imbalance | SpeedKP | Decrease |
| Poor mid-range pull | weak mid tuning | MidKI | Increase |
| Overheating | excessive current | MaxLineCurr / MaxPhaseCurr | Decrease |
| Hard speed cutoff | limiter too high | LimitSpeed | Decrease |
| Low top speed | weak field weakening | WeakCurrCoeff | Increase slightly |
| High-speed instability | aggressive FW | WeakCurrCoeff | Decrease |
| Abrupt regen | too much regen current | MaxBackCurr | Decrease |
| Weak regen | low regen current | MaxBackCurr | Increase |
| Jerky low-speed regen | aggressive low RPM map | RPM Regen Table | Reduce low RPM percent |
| Bike slows too fast off throttle | high decel or regen | Throttle Dec Step | Decrease |
| Bike coasts too freely | weak regen | RPM Regen Table | Increase slightly |
| Gear modes feel identical | poor scaling | Gear Power percent | Increase spread |
| Reverse too fast | high reverse speed | BackSpeed | Decrease |
| Inconsistent throttle feel | thermal rollback | Current limits / thermal | Reduce load |
| Noisy no-load operation | angle or phase mismatch | PhaseOffset / AngleDetect | Verify and correct |
| Throttle inactive until mid input | low-end scaling issue | Throttle Low | Increase slightly |
Failure Escalation Ladder
If something goes wrong:
- stop the test
- revert to the last known stable setup
- verify wiring and signals
- validate AutoLearn
- reduce current limits
- re-test baseline
Do not tune deeper into a bad result.
Test Setup and Safety
Before performing AutoLearn, static testing, or LimitSpeed validation, the bike must be placed in a controlled and safe test condition.
These procedures involve spinning the motor at high speed without load and must be treated as active mechanical operations.
Required Setup
- rear wheel lifted completely off the ground
- bike stabilized on a secure stand
- clear space around the wheel and drivetrain
- no rider load
Chain / Drivetrain Considerations
For highest safety and cleanest results:
- removing the chain is recommended during AutoLearn and no-load testing
- this isolates the motor from drivetrain resistance
- prevents unintended torque transfer
- reduces risk of mechanical injury
If the chain is left installed:
- ensure full clearance
- do not stand near rotating components
- avoid loose clothing or contact points
Safety Notes
- never perform AutoLearn with the bike under load
- never apply throttle while the bike is unstable
- always verify rotation direction before full throttle
- always perform a brief low-throttle spin before high-RPM testing
- stop immediately if vibration, noise, or instability occurs
Data Monitoring During Calibration
During all calibration tests, monitor live data in the FarDriver app.
Minimum required metrics:
- Battery Voltage (V)
- Line Current (A)
- Phase Current (A)
- Motor RPM
- Motor Temperature
- Controller Temperature
- Throttle Input (%)
Where available, also watch:
- gear state
- brake state
- error status
- thermal rollback behavior
- battery voltage before the test and during peak load
Safe Operating Guidelines
- Motor temperature: keep below 120C
- Controller temperature: keep below 90C
- sustained Line Current should remain within battery capability
- Phase Current should not exceed motor thermal limits
Exceeding these values may result in:
- thermal rollback
- component damage
- reduced system lifespan