KO Moto Setup Guides

Screenshot_2_copy1

Tuning Software

Always secure your bike on a stand before connecting or changing any tuning settings.


Please download the tuning software to start configuring your KO Moto system. Currently there are two options of tuning software: PC and Android. Both will allow you to configure your tune the way you would like. We’ve found Android devices are easier to connect since no dongle is needed – the app connects directly via Bluetooth. If you are using a PC, you will need to use either the hardwired dongle or Bluetooth wireless connector dongle, both of which are included with your purchase. 


IMPORTANT: Make sure no other devices within 20 feet have Bluetooth enabled as they can interfere with the connection.


BETA APPS NOW AVAILABLE!

KO has just released public beta versions of the existing Android app and the highly anticipated iOS app. We've been testing these apps extensively and helping KO to reach Version 7 ahead of public release. And let us tell you, these apps make setup and tuning a breeze!
This is the fastest way to get your KO-equipped bike up and running, but please remember these apps are in public beta, so you might encounter some bugs. If you run into any issues, send us an email along with screenshots or video captures and we’ll pass it along to KO.

Tuning Setup

Quick Start Guide

Controller Parameters

Controller Functions

Motor parameters

Misc Info
The setup for your controller shouldn't be to difficult but there will be a bit of learning. So this starting guide is to get you on the ground running with a increase of power with the minimum that needs to be adjusted. So if you want to spend as little time possible please read this to understand what should be adjusted at minimum. KO will be releasing a app which will make it much easier to do all of your tuning on, but for the time being please setup your tune on a windows PC it will be much easier this way.

STEP 1: FIRMWARE 
To start best practice is to update your firmware to your configuration (OEM motor with KO controller, Or RS/Factory motor with KO controller, and 60V/72V battery type). You can learn how to update your firmware and also download the firmware files in the section below (please read the firmware guide so you don't have to guess what to do this is very easy).
STEP 2: THROTTLE CALIBRATION
After you update your firmware you will likely have a throttle alarm that will go off. This is just telling you to calibrate your throttle. There are two ways to do this. You can do a auto throttle calibration (Video is linked in the section below) or you can set your throttle voltages yourself. Its always easiest to do the auto calibration shown in the video below. but if you wanted to adjust how much dead band you have you can manually set your voltages yourself. Your resting throttle voltage should always be lower than your "Threshold Low" voltage. usually on OEM throttles resting voltage is roughly 0.86V this is the voltage displaying when no throttle is applied on the bottom left side of the PC tuning program. Your Throttle "Threshold Low" voltage should be set higher to your resting voltage because this is telling the controller when to start applying power to your drive system, usually this number should be 0.10V more than your resting voltage so in this example it would be set to 0.96V. Throttles could be tricky which is why we ALWAYS recommend doing the auto calibration! Domino, Magura, and OEM throttles all have different low and high inputs.
STEP 3: LINE/PHASE CURRENT
(Controller Parameters) This is very important and works along side with the (Motor Parameters) tab which we will get to in later steps. For right now we are still under (Controller Parameters) tab, you will need to set a base  "Max Line Current & Max Phase Current" DO NOT start at the highest power settings you will have issues unless you are experienced with this. You will set your max Line and max phase based upon your battery configuration, if you are using a stock bypassed batter you will want to start at 90 max line current and 520 max phase current. If you are using any other aftermarket batteries start at 180 max line current and 600 max phase current. Do not worry you can adjust this after you get a few other settings changed.
STEP 4: LOW VOLTAGE PROTECTION
(Controller Parameters) You will need to just verify your low volt protect is set. This will save you from draining your battery past its limits. This is set by default based on the firmware you installed. We usually use these values for our bikes 60V battery low volt protect set to 48.5V and 72V battery low volt protect set to 58.5V. These cut off limits are just above the recommended limits, however this might vary depending on the brand battery used. 
STEP 5: THROTTLE CURVE
(Controller Function) Throttle RESP will allow you to change your throttle curve. This by default is set to "Line" and i would recomemend leaving it set to "Line" if you want more aggressive response use "Sport" if you want less agressive use "Eco". Line is a great happy medium so try this before changing anything. If you end up using "Eco" throttle mode just keep in mind that you will be limited to 150 Max Line current.
STEP 6: ECO MODE
(Controller Function) Mid Speed Paras is what will adjust power and RPM limit for your ECO/EP mode switch. You will have three values here that you can adjust (Line Curr Ratio, Phase Curr Ratio, And Mid Speed) Think of these three settings devaluing your over all tune settings. So if you apply line curr ratio at 50, its like only applying 50% of your max line current, same goes for phase current. Mid Speed will be your RPM limiter for ECO/EP mode, so if you set this to 100rpm you will limit your motor to only turn 100 RPM. The settings here are totally us to you for how you ride your bike. We usually use ECO/EP mode as a trail mode so these values are usually set to the following for us. Line Curr 60, Phase Curr 78, Mid Speed 5000.
STEP 7: SPEED PULSE
(Controller Function) Speed pulse is a setting you will need to remember to adjust later after you are done test riding the bike. This will allow you to calibrate your OEM speedo meter to be accurate. Increasing this number will increase MPH decreasing this number will decrease MPH. there is no set number for this because wheel size and gearing configuration is what determines the end number
STEP 8: AUTO LEARN
(Motor Parameters) you will see on the right side of the adjustment menu a button that says (Auto Learn), we recomend doing this no matter the motor that you have. This will basically calibrate the motor to the controller. To do this you will need your bike on a stand so the rear wheel can spin up. Once your bike is secured on a stand click the auto learn button. Your controller will beep twice and a message will appear on the top of your PC gauges. At this point you will need to twist the throttle all the way and hold it until the motor stops on its own. You will do this twice or until auto learn is complete.
STEP 9: AN & LM
(Motor Parameters) AN & LM are what adjust the motor wave type. You shouldn't ever need to adjust LM based on my experience with a RS motor or OEM motor. However you will need to adjust AN depending on the motor you are using. If you are using a OEM motor set AN to 6. And if you are using a KO RS motor set AN to 14. As you increase your line current and phase current this value may need to be decreased if your motor is jittering or not pulling through power range smoothly.  
STEP 10: CURRENT COEFFICIENT
This is the setting that was mentioned above that works along side of max line and max phase current. Changing these parameters values all to 100 will result in your motor jittering, so please don't do that and expect to have max power across the board. These settings could be drastically different depending on the voltage you are using (60V, 72V, or 84V), and the max line/max phase current you have setup, and other factors at play are gearing and rider weight. If you have very low gearing for high speed runs your controller will have more load, and high gearing for trails etc you will have less load. If you are running relatively low power 150 line curr/500 phase curr you will have more room to push these numbers higher. 
So lets dig into some RPM ranges to adjust, from 500-2000, you can usually bump all the way up to 100. this is usually not ideal in higher power applications. because you will have to much power to soon making the bike to sensitive. This is a range you will have to adjust a few times until you get it right for how you like it. So typically starting at 500 RPM set power to 70, and increase this value +10 until you get to 2000 rpm. At 2000 RPM you should be at a 100 value. Now from 2500-5000 RPM range you will start at a value of 100 and decrease value -5 until you get to 5000 RPM. At 5000 RPM you should be at a value of 75. Now from the Range of 5000-7500 RPM set all values to 75. Starting at 8000 RPM with a value of 70, decrease the value -15 all the way to 9000 RPM, at 9000 RPM you should end at a value of 40.
Now that all of that is done please take note you will need to test ride the bike see how it feels. If the motor is nice and smooth all the way through its RPM range you can turn the max line and phase current up if your battery can support it. You should never jump from 180 line curr/600 phase curr to 340 line and 800 phase. You need to take this slow. As you adjust max line and phase current up you may need to revisit current coefficient parameters to decrease the value within the range that your motor is getting jitters or doesnt feel smooth. If your motor doesnt feel smooth or is jittering you are not going to feel the bike to be fast, a smaller value could actually make the bike feel a lot faster.
NOTE: Higher voltage battery's tend to allow higher values. Use these settings as a base. Save your tune file before you go off to the deep end adjusting everything, this way you can always reupload this tune file and start over again.

Rated Voltage

Displays the intended battery voltage e.g. 60V. 72V, 84V. This will depend on the update you have chosen 60V, 72V or 84V. 

Rated Power

Shows the rated power - indication - changing this number does not affect the motor and controllers power output. 

Phase Offset

Not in use - cannot be changed automatically calibrated.

MaxLineCurr (Maximum DC current in)

Maximum current into the controller from the battery - Stock battery should be set to 95A maximum third party batteries should be set to manufacturers specifications. Maximum DC current is 370A. Please adjust accordingly and if your battery struggles to provide the power required reduce this number. This may show as a sudden slow down, or a loss in power as the battery BMS either throttles, or shuts the power to the bike off completely. If this occurs you should give the battery time to cool down and adjust your settings downwards to account for this. 

MaxPhaseCurr  Maximum phase current

This is the maximum phase current available to the motor and can be set up to 800A.

Speed Coeff

Not in use automatically calibrated.

ThreshholdLow (Minimum Throttle Input)

The lowest point at which the throttle will engage (measured in volts). Use this to calibrate where the throttle comes on for your bike.  Measured in voltage we recommend making small changes and test the effect with the back wheel lifted. You can adjust this value to add dead banding on your throttle. **Warning adding too much deadland may make the throttle unpredictable when accelerating - Please adjust with care**

ThresholdHigh (Maximum Throttle Input)

The highest point of throttle output (measured in volts) The maximum voltage that can be supplied by your throttle. 

we recommend making small changes and test effect with the back wheel lifted. You can adjust this value to add dead banding on your throttle. **Warning adding too much deadland may make the throttle unpredictable when accelerating - Please adjust with care**

AccSensitivity (Throttle acceleration sensitivity) 

Throttle acceleration sensitivity setting from 5-224. A low number will mean a less aggressive feel on acceleration (lower number = lower sensitivity). This value is set to 224 by default and should be left as this. 

BackThrottle (Advanced Users Only)  Negative throttle adjustment

This works by slowing the throttle deceleration values of 0-7 - zero is normal while raising the number will increase the time it takes for throttle deceleration to come into effect after dropping the throttle. 

WeakRSP - Magnetic field weakening  

Reducing this number will effectively reduce the maximum motor RPM. The lower the number the higher level of magnet weakening is used. Set to zero by default values available 0-6 plus disable.  We would suggest using 0 as a preferred setting. 

SKP - (Advanced Users Only) PID controller response time 

We would suggest not changing this too much. Values available are 0-128. Standard Sur-Ron set up is 5. This changes PIDs to improve response time on the PID controller 0= very fast while 128 is slowest response time. 

Start/Mid/MAX KI - (Advanced Users Only) Motor Vibration Control

This is primarily used for other motors leave at default but if you are using a lower horse power motor, such as the standard Sur-Ron motor you can adjust this value upwards to control motor vibration.

 

Over Voltage Protection

This value is set via the firmware version you are using and depend on the voltage of your battery. Cannot be changed. 

 

Low Voltage Protection - (Low Voltage Cut-Off)

Dependant on user requirements set in volts. You should refer to the manufacturers specification on your battery. If you are using multiple different voltages please ensure to upload the correct hex file to your controller. There is a different software for 60 and 72v batteries and the low voltage for each should be set accordingly. 

Temperature protection 

Thermal protection for the ESC. When the ESC reaches 80 Degrees Celsius it begins to throttle performance until the unit cools. At 90 Degrees ESC will cut power until the temperature reaches 80 degrees and then operation can continue. These are hard limits and will not be adjustable.

Brake - (Brake Sensor Control) 

This allows you to turn the brake sensors on and off 

Float Run - Will keep the motor going when the brakes are pulled and the throttle is engaged.

Float stop - The motor will cut when the brakes are pulled (this requires the brake sensors to be present).

Invalid - This option takes you strictly to mechanical braking and ignores the sensor completely ( No digital input). 

Bike Sensors

Set to option 5 to disable all sensors and set to option 1 to enable them.

 

Gear  

Use option D - other options are not used on the Sur-Ron

Parking - (Parking Speed)

This enables a limiter for parking speed - leave on disabled 

Follow (Regen Braking Type)

When using regen braking use the settings Stop Back Curr and Max Back Curr in the controller functions menu to dictate the strength of regen braking use, The maximum value for regen braking is 20A.

Enable - Turns on regen braking

Disable - This option turns off regen braking completely. 

Brake - When you brake the you enable regen braking. 

EABS  - This option is the same function as the Sur-Ron - when you turn off the throttle you get regen braking. 

Throttle RESP - (Drive Mode Style)

Line - This is a fairly flat mode with a fairly tame acceleration profile - good for beginner riders.

Sport  - This mode has a more aggressive profile and is ideal for riders that need fast acceleration and response

ECO - This is a slow but efficient mode for battery saving and for people that want to plod.

ACCA PARA (Acceleration Control) 

This setting adjusts the aggressiveness of the acceleration control 1 is slowest 8 is fastest. 

Reverse Charging (Regenerative Braking)

This setting is linked with follow - depending on bike will change in line with follow setting.

CAN protocol 

not used in Sur-Ron

LowSpeedParas

not used on sur-ron controller

 

MidSpeedParas (EP Mode speed and power adjustment)

LineCurrRatio (EP Mode Power) - This is set as a percentage of Max Line Curr in controller parameters. This limits the total current available in EP mode. You can adjust this value from 0-100% which will take the equivalent percentage for the maximum DC in. 

PhaseCurrRatio (EP Phase Current Limiter) This is also input as a percentage from 0-100% of Max Phase Curr (Phase current) in Controller Parameters. Adjusting this value will make the equivalent percentage you have set of maximum phase current. 

MidSpeed (RPM limiter) - This function will limit the maximum rpm of the motor you can set a value from 1000-1000RPM. This will limit the top speed of the bike in line with the RPM chosen. This is a good option if you need to stick to a legal road limit. 

StopBackCurr - (Regen Braking Strength)

For EABS or Brake - This is how strong  the effect of Regen braking is when the options are enabled. A standard Sur-Ron is  set to 15 Max back current 20. However you may find this is too much if you have the KO Moto motor and this should be set lower to feel comfortable. We do not suggest using any higher than 15 as this may cause a harsh feel when braking. 

MaxBackCurr - (Maximum Regen Braking level)

The maximum level of regen braking in amps (A).

 

Backspeed

not used in retail version

 

Speedometer - signal pulse speed for speedometer - you can change the pulse number to dial in accuracy of the speedometer this should be set to pulse and the SpeedPulse should be set accordingly. 

Rated voltage

This option will be dictated by the firmware version you are using. 60v, 72v or 84V nominal. This setting cannot be changed and is for information purposes only. 

Rated power

not used - This does not in any way change the power of the set up. It is for information purposes and generally used for batch processing. This is not an indication of the power of the set up you are using and should not be considered so. 

 

Pole Pairs

This can be changed to reflect the number of pole pairs your motor is using. This should be  auto detected via the controller and should not be changed. The KO Moto Motor is 4 Sur-Ron standard motor is 5, Talaria stock motor is 5.

Direction (Motor direction)

This option changes the motor Direction between CW (clock wise) or CCW (counter clock wise) 1 is the default position.

Motor Temp (Motor Temperature Sensor Type) 

What kind of temp sensor the motor uses - Sur-Ron is KTY84 - The KO Moto Motor is  KTY84. 

TempProtect - (Motor Temperature Protection)

Set to 140 degrees at this point power is throttled - Customers cannot change this and this number is set at the factory. 

AN (Wave Type - Magnetic field weakening(Advanced Users Only) 

This function is used to control motor vibration and change the wave type used for magnetic field weakening. You can change this number from 0-16 for best results. We have found that it is best to use a low number if you are using a high power system. An example of this is one of the test bikes we have using 300amps dc in and 800 phase we use AN set to 2 to limit motor vibration across the whole RPM range. Where as a stock Sur-Ron bike would use a value of around 4. This setting should generally not be changed from the stock setting for a particular firmware but they can be adjusted in certain circumstances. 

LM (Wave interval - Magnetic field weakening)(Advanced users only) - This setting works in conjunction with AM and changes the interval of the waves being sent. This can also be used to prevent motor vibration in your set up but should be used after AM has been adjusted and has not had the desired effect. This setting should generally not be changed from the stock setting for a particular firmware but they can be adjusted in certain circumstances. 

Position - is not open it shows magnet position - Encoder or hall sensor reading.

Current Coefficient (RPM Power Adjustment) 

Adjust the torque delivered through an RPM range by limiting the amount of phase current available as a percentage. This will allow you to adjust the feeling of torque for the bike during initial acceleration and while the motor accelerates to its maximum RPM. The value used should be between 0-100. We would suggest for best results having a sensible smooth transition for road use and something a little more aggressive for dirt. An important note to make is that every drive train in every bike is slightly different you may find at a certain speed the bike will slightly shake or shudder at a high phase rating. If you find this occurs then the best way is to adjust the phase current limiter downwards by a factor of about 5-10%. you will also find this setting very useful to give you the level of torque at the start RPM range 500 +1000 so as to not make the bike feel too jerky. 

SOC (State of Charge) 

The state of charge option is for reflecting the correct state of charge for batteries. If you have a custom battery it is possible to change these settings adjust for this. This may require some custom software from us to detail this. For more information please contact us on support@gritshift.com 

Auto Learn (Set Encoder Position) 
The controller will auto detect both motors with a hall sensor and encoder. If you are using a Talaria the controller will auto detect the position of the encoder once you have update the Talaria firmware.  If you want to use a 3rd party motor you can use this function to set the position of the encoder. We would recommend getting in touch with us prior to doing this at support@gritshift.com

Factory Calibration
The Factory Calibration menu is designed for bench testing and development work and as such is not really for direct customer use. 


Firmware Updates

The firmware files for Nano, Pro-Series, and Factory Spec controllers are all the same. The only difference will be the voltage change.


After updating your firmware, you will need to do an Auto Learn and calibrate your throttle as explained in the Tuning Setup Guide below. Please review the guide to understand what settings should and shouldn’t be changed before jumping in.


Select the firmware for your bike and voltage, then follow the setup instructions below.

Connecting to Controler

Updating Firmware

Firmware Change Logs

Connecting PC via Bluetooth (BT) dongle to KO Controller
Please make sure there are no other Bluetooth devices turned on within 20 feet as they could make it harder to connect to your controller. You should never need to do the pairing process again, so DO NOT press the pairing button again once you confirm you are paired, or try using a hard connection.

To pair your BT dongle to your controller:
  1. Plug BT dongle into PC.
  2. Turn the bike on, then press the pairing button on the end of the dongle.
  3. Blue indicator light on the dongle should turn solid, indicating it is paired.
  4. Open the KO Tuning Software on PC. In the Communication tab, set ComPort to COM3, set Baudrate to 19200, then set On/Off to “On.”
  5. Battery voltage and data count should be live (below RPM gauge). If so, you are successfully connected. If not, you are likely paired to a different nearby device – try to pair again.

Connecting PC via hardwire dongle to KO Controller

To pair to your controller via hard connection:
  1. Locate the small black 5-pin connector on the KO controller harness. It should be easy to find as it won’t be connected to any plug.
  2. Plug the hardwire dongle into this connector.
  3. Turn on the bike.
  4. Plug the USB side of the hardwire dongle into your PC.
  5. Open the KO Tuning Software on PC. In the Communication tab, set ComPort to COM3, set Baudrate to 9600, then set On/Off to “On.”
  6. Battery voltage and data count should be live (below RPM gauge). If so, you are successfully connected.

Connecting Android and iOS apps via Bluetooth
We’ll have a walkthrough for the apps once they are out of beta testing. Until then, please contact us if you have any trouble using the app.
ko app showing upgrade and recovery options
Note: To update your controller firmware, you will first need to download the KO Tuning Software for PC and connect to your controller via BT or hardwire dongle.

Updating via PC
Once your PC and controller are connected, navigate to the Controller Parameters section of the KO Tuning Software. At the far right side of the menu, you will find two methods for updating your software: Upgrade and Recovery.
  • Use Recovery if this is your first time updating this bike’s firmware. This will fully upgrade the firmware and install a baseline tune developed by KO which we will refine later in the setup process.
  • Use Upgrade if you have already developed a tune for this bike. This will update the firmware but leave the existing tune intact. You should only use this option after you’ve refined the bike’s tune and have it running with no issues, so that you don’t lose that tune during the firmware update process.
You will hear a beep letting you know the update is complete.

Updating via App

Coming soon


This is a running log of firmware changes, unedited, straight from KO.

9/12/2022 – 60V & 72V RS MOTOR UPDATES
Updated throttle response which improves delay on throttle at low dc and gives a better level of control for stunt riding (Work in progress - more updates to come).
  • Set Follow to EABS and adjust StopBackCurr and MaxBackCurr to adjust the level of braking. MaxBackCurr should always be higher. We would suggest setting this to 20 and 25 respectively initially just to test and adjusting from there.
  • Pole Pairs should be set to 4
  • Set Phase and MaxLineCurr according to your battery specifications
Stock Battery Recommended
  • MaxLineCurr - 90A or lower
  • MaxPhaseCurr - 520 or lower
ByPass Battery Recommended
  • MaxLineCurr - 140A or lower
  • MaxPhaseCurr - 520 or lower
3RD Partry Battery
  • As per battery specs - email us or contact us on discord if you aren't sure.

RPM Adjustments
For stunt riding we have found a parabolic curve gives the best results. Start at around 75 on 500RPM and build up to 100 at around 2000RPM. Keep at 100 until 4500 RPM then slowly drop off. This is just an indication and should be used as such. Feel free to tweak these adjustments to however you like them. If you need tuning support please email us for the discord link, or hop on discord any message any KO-Moto staff.

As with any firmware update please allow yourself time to get used to the changes and ride safely.

Video Guides

Our founder unboxing and installing a KO Motor and Controller on a Sur Ron
How to connect to a PC
How to update/recover your firmware
How to auto-calibrate your throttle
KO Tuning Software Walkthrough