VESC Tool helper for VESC based onewheels

Version 0.1.15 - 2024-11-09

This tool will help you find the key values to configure your board in VESC Tool, depending on your controller, batteries, tire and motor. To get started, select the components used in your board.

Controllers

Batterypacks

Batteries

Tires

Motors

VESC Tool Config

Next, run Motor Detection, calibrate the IMU, install the Refloat package (or Float Package if you care more about haptic buzz than LEDs), and configure your board using the following menus and values in VESC Tool.

If you are wondering what all these parameters are for, check my parameter tool, which aggregates all help texts from VESC Tool and some common packages.

Scan…	Scan BLE until you can connect to your controller (top right button)	CONNECT
CAN scan	Your controller connects through a VESC Express module, so now you have to scan the CAN bus to connect to your actual VESC (on mobile, the button is on the bottom right)	Scan CAN Bus
Wizards/Setup Motors	Load Default Parameters
Setup Motor/Usage	Usage	EUC or Balance
	Override (Advanced)
Setup Motor/Motor	Motor	Large Outrunner
	Override (Advanced)
	Max Power Loss	500
	Open Loop ERPM
	Sensorless ERPM
	Motor Poles	30
	Motor Selection
Setup Motor/Battery	Battery Type	BATTERY_TYPE_LIION_3_0__4_2BATTERY_TYPE_LIIRON_2_6__3_6BATTERY_TYPE_LEAD_ACID
	Battery Cells Series
	Battery Capacity	5.6
	Advanced
	Battery Current Max
	Battery Current Max regen
Setup Motor/Setup	Direct Drive
	Gear Ratio	1
	Wheel Diameter	279
	Motor Poles	30
	Detect all motors over CAN Bus
Setup Motor/Detection Result	VESC ID
	Motor current
	Motor R
	Motor L
	Motor Lq-Ld
	Motor Flux Linkage (λ)
	Time Constant
	bw
	kp
	ki
	Observer gain calculated by VESC Tool
	Temp Comp
	Sensors
Motor Settings/General/Temperature	Acceleration Temperature Decrease	0
	MOSFET Temp Cutoff Satrt	75
	MOSFET Temp Cutoff End	85
	Motor Temp Cutoff Satrt	75
	Motor Temp Cutoff End	85
Motor Settings/General/Current	Motor Current Max
	Motor Current Max Brake
	Absolute Motor Current Max
	Battery Current Max
	Battery Current Max Regen
Motor Settings/General/Voltage	Battery Voltage Cutoff Start	0
	Battery Voltage Cutoff End	0
Motor Settings/FOC/General	Observer Gain	Typically you'll want to correct the value calculated by VESC Tool. Cut it in half.
	Observer Gain
Motor Settings/FOC/Hall Sensors	Sensorless ERPM
	Hall Interpolation ERPM	250
Motor Settings/FOC/Offsets	Run calibration at boot
Motor Settings/FOC/Field Weakening	Field Weakening Current Max
	Field Weakening Duty Start	65
	Ramp Time	300
	Q Axis	2
Motor Settings/FOC/Advanced	Speed Tracker Position Source	Corrected PositionObserver
Motor Settings/Additional Info/Setup	Battery Cells Series
	Battery Capacity
App Settings/IMU	Sample Rate	832
	Accel lowpass filter Z	1
	Accelerometer Confidence Decay	0.01
Refloat Cfg/Specs	Loop Hertz	832
	High Voltage Tiltback
	Low Voltage Tiltback
	ADC1 Switch Voltage	2
	ADC2 Switch Voltage	2

Finally, you can play with the LED setup in Refloat, install Floaty or Float Control, and apply your favorite tunings for ATR etc.

Corrections and additions

This is work in progress. Getting all the info to make this tool function is quite a lot of work. If you look at the compare tables, you'll still see quite a lot of gaps. If you know details that I don't have in my tables yet, be it individual parameter values, corrections, or complete components, please download one of the component files below, edit it, and mail it back to me. Please indicate the fields you corrected with a light red background color, and stuff you added with a light green background color - that would save me a lot of time. Thanks if advance for your help!

• controllers.xlsx
• batterypacks.xlsx
• batteries.xlsx
• tires.xlsx
• motors.xlsx

Open Source

The VESC Tool Config Helper is an open source project, published under the MIT license, with some minor additions. It is meant to benefit the Onewheel Vesc Builders for free, and I invite everyone to contribute, either in our Facebook group, or per e-mail (see above), or soon also on github. I already set up the project on github, where I will upload most files asap. Exceptions are the PHP file that generates the HTML for this page, and the project database that generates most of the JSON used here. The contents of that database are not secret, (add ?pretty=1 to the url to get better readable json code), but at the moment, I'd like to keep control of those 2 files. As soon as the software is a bit more stable, I'll probably add that to the repository as well.

Warning

If you look at the compare tables, you'll see that we still have many data gaps. I don't want to guess values, so for those gaps, we mostly use the defaults from VESC Tool. VESC Tool however is not specifically made for balance boards, so those defaults may not always make sense in our community. For some parameters, I overrule the VESC Tool defaults with our own. But the only thing that really helps is if we have complete information directly from the manufacturers. If you have connections to them, please send them to this page, and let them fill in the Excel sheets for their products (see above).

Links

Cell Phone Tools

• Float Control - Handy interface for iOS.
• Floaty - Handy interface for Android.
• pev.de - Huge forums and content.
• pev.de Crunch Guide.
• surfdado - Author of Float Control and more. Also good to follow on Facebook and Discord.
• surfdado video - In this long video, surfdado discusses almost all settings. It was also used as input for the calculations in this tool.
• The Board Garage - Good content by Mario. Also good to follow on Facebook and Discord.
• VESC Project - Main VESC site.
• VESC Tool Parameters. Another SUPzero tool with a searchable reference of all parameters used in VESC Tool and its packages.

Actions

PS. Most battery info comes from NKON for consistency. NKON is also the place where I personally buy my batteries. Huge choice, good prices. I'm not affiliated to them in any way.