Some universal sine-wave controllers sold for hub-motor repairs have a self-learning function, usually started with a pair of learning wires. Instead of you matching the motor's phase and Hall wires by trial and error, the controller tries the combinations itself and keeps the one that drives the wheel forward smoothly. When it doesn't work, what the wheel does tells you where to look next.
What self-learning actually does
Self-learning sorts out wiring, nothing more. It works out how the three phase wires line up with the Hall signals and which way is forward. It does not repair a damaged wire or suit the controller to the wrong motor.
Not every controller has a learning wire. KT-type controllers usually handle phase alignment with a display setting called C2 instead, and at least one KT controller manual tells users to check that their controller has a self-learning function. Some controllers do the same job in software: Grin's Baserunner, for example, runs a Motor Autotune that detects the Hall pinout while the motor spins. Others have no learning function at all, and the wiring has to be matched by hand the way their manual describes. Check the manual for your exact controller first.
Run it the standard way first
- Wheel off the ground. The motor will spin by itself during learning.
- Connect +5 V and ground by function first. Confirm which Hall wire is the supply and which is ground on both the motor side and the controller side, with a meter or both wiring diagrams, and join each to its match; reversed, they can destroy the Hall sensors. A speed or temperature wire also goes only to its own matching input. Then join the three Hall signal wires and the three phase wires, whose order is what the learning run sorts out, and connect the display, brake levers and the ignition wire if there is one. A controller with its ignition wire unconnected can look completely dead (more on that here).
- Find the learning wires: typically two single wires, sometimes the same color, meant to be shorted together temporarily. White is common and green also turns up, but go by your manual, not by color.
- Power on and short the wires. Some controllers want the display on and an assist level selected first.
- Leave the throttle alone unless your manual says otherwise. One maker's demonstration leaves the throttle alone during learning; other guides say some units need a slight twist. Follow your controller's instructions.
- Watch the wheel. Brief stuttering or reversing while combinations are tested can be normal.
- Disconnect and insulate the learning wires once it settles into smooth forward rotation. Left connected, they can keep some controllers in a diagnostic state.
- Test with the throttle, wheel still off the ground. You want a smooth start with no shudder.
Reading the result
- Spins forward smoothly, and the throttle is smooth afterwards. Done. Tie off the learning wires and carry on.
- Settles into spinning backwards. On many learning controllers, running the learning again reverses the direction: disconnect the learning wires and connect them again, as your manual describes; it can take a few tries. Don't correct the direction by swapping two phase wires afterwards. With the Hall sensors connected, that breaks the combination the controller just learned.
- Runs, but shudders or knocks from a standstill. The stored combination is probably off. Learn again; if it persists, test the Hall sensors, since failed Hall sensors can also cause a rough start. If your controller has no learning wire, check its manual before you swap anything by hand, because some do the same job through a display setting or an autotune routine. For controllers whose manual has you match the wires yourself, the 36-combination guide explains a systematic order.
- Doesn't move at all with the wires shorted. The controller cannot learn this motor as it stands. Go to the hardware checks below.
- Runs only while the learning wires are connected. As one repair guide puts it, learning mode "is a setup and diagnostic tool—not a permanent operating state," and a motor that only runs in learning mode "signals a deeper electrical or component issue."
What learning cannot fix
Repeating the learning run will not fix any of these:
- Damaged Hall sensors. Heat, vibration, broken internal wiring and water in the motor can all damage them. Test them with a multimeter: how to test e-bike Hall sensors.
- Hall sensors in the wrong position. One builder's bench test found a self-adapting controller could correct swapped Hall sensors, but "changing the sensor timing from a good location will cause it to continue getting stuck in sensored mode." In that test, swapped wires were learned; a sensor moved out of position was not.
- Phase wire faults. Damaged insulation can short the wires and cause excessive current; a break in a winding or wire can stop the motor or make it run erratically.
- Controller damage. Overheating, overvoltage or static can damage the power switching components (MOSFETs).
- Connectors. Loose plugs, bent or pushed-in pins and corrosion can cause intermittent or total loss of function. If water has been near the motor plug, inspect it (see our 9-pin plug guide).
- Things that are not the motor. A brake cut-off switch stuck on, a throttle fault or a weak battery can all look like a motor problem. A stuck brake sensor is easy to overlook.
If the Hall sensors are the problem
A failed Hall sensor does not automatically mean a new motor. Many universal controllers are sold as running with or without Hall sensors. The trade-off is a rougher, weaker start from a standstill, and sometimes a little less top speed. Our sensorless controller guide covers whether that suits your riding.
Before you send a controller back
A controller that will not learn is not always faulty. Before returning one, confirm the battery voltage matches its rating, the ignition wire is connected, no brake lever is engaged, and you followed that controller's own learning procedure. Clear connector photos make a pin or plug mismatch easier to spot; this guide shows which help most.
Where this comes from
The learning-mode quotes and fault list come from a published e-bike repair guide, the Hall timing quote from a builder's bench test, the step order and throttle note from a controller maker's video, a DIY video and owner reports, the KT details from KT manuals, and the autotune and wiring notes from Grin Technologies' Grinfineon and Baserunner controller manuals. These are repair notes, not lab tests. Where your controller's manual disagrees, follow the manual.