This post defines the ONYX FarDriver harness and how it integrates into the system, including both plug-and-play and full manual wiring approaches.
- Complete this after Setup
- Verify all wiring before running AutoLearn
- Do not proceed if any wiring is unstable
JAWS MODE Workflow
Performance Build → Wiring → AutoLearn → Tuning → AI Assistant → Parameters → Calibration
What This Post Covers
This post defines the ONYX FarDriver harness as both a system-level wiring layer and a physical integration process.
It includes:
- connector layout and function
- system-level wiring behavior
- plug-and-play harness installation
- full manual integration procedure
- validation before tuning
This is a hardware integration layer and execution reference, not tuning.
Installation Context
There are two wiring approaches:
Manual integration
- stock ONYX wiring harness is adapted to the FarDriver harness
- requires repinning, wire splicing, and signal matching
- includes throttle, ignition, regen, mode wiring, and speed signal
- longer installation time
Plug-and-play ONYX FarDriver harness
- direct connection to controller and bike
- labeled connectors
- no manual wiring integration required
- significantly reduced install time
Optional Plug-and-Play FarDriver ONYX Harness
The optional ONYX FarDriver harness is a plug-and-play replacement that eliminates the need to integrate the stock ONYX wiring harness with the FarDriver harness.
It includes:
- labeled connectors
- integrated 5V USB power
- dedicated wiring for simplified setup
FarDriver ONYX Harness Installation Video
System Overview
| System | Status |
|---|---|
| ONYX Harness | ONYX RCR V1.5 |
| FarDriver Harness | Gen 2 |
| Controller | FarDriver Gen 2 |
| Mode System | Rewired (no Kelly board) |
| Throttle | Repinned to FarDriver |
| Regen | Integrated |
| Speed Signal | Tapped from hall sensor |
Core Function
| System | Role | Under Load Behavior | Interaction | Real-World Behavior | Failure Mode |
|---|---|---|---|---|---|
| Wiring Harness | Connects all systems | Carries power and signals | All controller systems | Stable vs unstable operation | No function / erratic behavior |
Connector Systems
| Connector | Function | Interaction | Real-World Behavior | Failure Mode |
|---|---|---|---|---|
| Phase Wires | Motor power delivery | MaxPhaseCurr | Drives motor torque | No drive / misfire |
| Hall Sensor | Position feedback | AngleDetect / PhaseOffset | Smooth commutation | Stutter / no start |
| Throttle | Input signal | Throttle system | Controls acceleration | No response / error |
| Brake | Regen trigger | Regen system | Activates braking | No regen / constant brake |
| Power (Battery) | Main supply | MaxLineCurr | Provides energy | No power / cutout |
| Ignition | System enable | Control logic | Turns system on/off | No startup |
| Gear Switch | Mode selection | Gear system | Changes performance mode | Stuck gear |
| Reverse | Direction control | Motor Direction | Enables reverse | Unexpected behavior |
| Display | Data output | Display system | Shows speed/info | No display |
Interaction Layer
- Phase wires carry high current → directly affect torque
- Hall sensors define timing → affect efficiency and stability
- Throttle input controls current demand
- Brake input triggers regen behavior
- Battery wiring defines voltage stability
All wiring is directly tied to system behavior.
Real-World Behavior
Correct wiring:
- smooth operation
- accurate throttle response
- stable regen
- consistent performance
Incorrect wiring:
- no startup
- stuttering motor
- reversed behavior
- intermittent faults
Limits and Failure Modes
- Loose connections → intermittent faults
- Incorrect phase/hall mapping → unstable motor behavior
- Poor battery connections → voltage drop and cutouts
- Miswired inputs → unintended acceleration or braking
Harness Integration Tools
- U-Shaped 16-26 AWG SN-48B Wire Crimping Tool
- Self-Adjusting 10-24 AWG Wire Stripper
- Harness Terminal Pin Removal Tool
- Brass U-Shaped Crimp Terminals
- Electrical Wire Loom Tape
Integration Video
72V ONYX Harness to FarDriver Harness Integration Video
Starting Point
Begin with the stock ONYX RCR V1.5 wiring harness.
The goal is to reuse the factory harness and adapt it to the FarDriver controller without replacing the entire system.
Alarm and Power Switch Connections
Locate the 4-pin connector connected to the alarm module inside the frame.
Inside this connector is an orange wire.
- Remove the orange wire from the 4-pin connector
- Reuse the connector by installing a single-pin connector if possible
| Wire | Connection |
|---|---|
| Orange | One side of power switch |
| Pink #1 | Power button |
| Pink #2 | Alarm connection |
These wires route to the alarm system.
Throttle Connections
Locate the 9-pin throttle connector.
Looking at the back of the connector, the three wires on the left are the throttle wires.
| Wire Color | Function |
|---|---|
| Red | 5V supply |
| Black | Ground |
| Green/White | Throttle signal |
Steps:
- Cut the three throttle wires from the connector
- Repin them into the FarDriver harness connector
| ONYX Harness | FarDriver Harness |
|---|---|
| Red | Red |
| Black | Black |
| Green/White | White |
If the connectors do not seat correctly, check for slightly bent male pins and straighten carefully.
Disable USB Power Line
Locate the thin red wire feeding the USB port on the left handlebar controls.
- Cut the thin red wire
- Leave it disconnected
This prevents 5V leakage from the FarDriver supply, which can cause throttle or controller issues.
Optional:
- Use a dedicated DC-DC converter for USB power
Speed Signal (Hall Sensor)
Locate the speed signal wire running from the motor hall sensor to the display.
- Cut the wire mid-run
- Strip both ends
- Join using a single-pin tap connector
Tap into a FarDriver hall wire:
| Hall Wire Options |
|---|
| Green |
| Blue |
| Yellow |
Typical selection:
- Yellow
This preserves the hall circuit while providing speed signal to the display.
Remove the Mode Board
The stock harness includes a Kelly controller mode board.
The FarDriver does not use this.
- Remove the mode board completely
- Remove all associated wiring
| Wire | Function |
|---|---|
| Green | Eco mode |
| Yellow | Sport mode |
| Red | Common |
Connect Mode Switch to FarDriver
The FarDriver uses a 3-pin blue connector for mode input.
| ONYX Wire | Mode | FarDriver Connection |
|---|---|---|
| Red | Common | Black (middle pin) |
| Green | Eco | Blue/White |
| Yellow | Sport | Yellow/White |
Signal inversion detail:
| Harness Wire | Actual Mode |
|---|---|
| Blue/White | Sport |
| Green | Eco |
Final pairings:
| Pairing |
|---|
| Yellow ↔ Blue/White |
| Green ↔ Green |
| Red ↔ Common |
Connect to the FarDriver 3-pin mode connector.
Handle Extra Wires from Removed Mode Board
After removing the mode board, several wires remain.
| Wire | Action |
|---|---|
| Blue/Brown | Leave unused |
| Red | Leave unused |
| Thin Black | Tape off (not ground) |
| Thick Black | Connect to chassis ground |
| Thick Green | Connect to 12V supply |
Brake Switch Power (12V)
The thick green wire powers the brake switches.
- Locate the 12V converter output
- Cut the yellow wire from the converter
- Connect thick green wire to this 12V source
This supplies proper voltage to brake switches.
Battery Voltage Ignition Wire
Locate the thick red wire.
This wire carries full battery voltage (72V).
- Repin into a single-pin connector
- Connect to the FarDriver orange ignition wire
This ties ignition to the battery voltage rail.
Brake Regen Signal
Locate the thick white wire.
| Wire | Connection |
|---|---|
| White | Gray brake signal wire |
Result:
- Rear brake activates regen
Optional:
- Connect gray wire to blue tail-light wire to enable regen on both brakes
Ground Connections
Two thick black wires serve as ground.
- Repin into 2-pin connectors
- Connect to available ground ports
| Wire | Function |
|---|---|
| Black | Ground |
Final Wiring Summary
| System | Wire Colors |
|---|---|
| Throttle | Red / Black / Green-White |
| Mode Switch | Green / Yellow / Red |
| Battery Voltage | Thick Red |
| Brake Regen | White |
| Ground | Black |
| Brake Switch Power | Thick Green |
| Alarm Connections | Orange + Pink wires |
Optional Display Connection
For aftermarket displays:
| Wire | Purpose |
|---|---|
| Solid Brown | Display ON signal |
Important:
- Do not confuse with brown-white wires
Tuning Implications
- Wiring must be correct before any tuning
- Electrical noise or poor connections affect:
- throttle response
- sensor accuracy
- system stability
Tuning Guidance (ONYX-Specific)
Verify all connections before power-on
Confirm:
- phase wiring
- hall sensor connection
- throttle voltage range
- brake signal behavior
Do not attempt tuning with unstable wiring
Fix hardware issues before adjusting parameters
Final Insight
Wiring defines whether the system works.
Tuning defines how well it works.
