VESC Tool helper for VESC based onewheels

Version 0.1.12 - 2024-10-14

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

Compare all controllers (desktop screen recommended)
Controllers - Common VESC controllers
ADV500Cheap FOCerEnnoid MK8 30SFlipsky 75200Floatwheel ADVGTSVGTVGo-FOC G300Little FOCer 3.0Little FOCer 3.1Little FOCer 4PintSVPintVRaiden 7Raiden 7 HVThor300Tronic 250Tronic 250RTronic 400Ubox 100Ubox 85VESC6+X12 24SX12 30SXRVZeusF6
DescriptionThe wideley used Little FOCer (2024)Bring your own heat sink.ZESC Raiden 7ZESC Raiden 7 HVThe first Fungineers VESC. Virtually impossible to overheat when mounted in a Fungineers aluminum controller box.Bigger mosfets than 250, 2-layer PCB.RION and Tronicx cooperation22S hardware design, 85V is in warranty. Use 18S max.TrampaBetter buy without enclosure (bareboard edition), to make sure it fits in a controller box.Better buy without enclosure (bareboard edition), to make sure it fits in a controller box.
Introduced2023202220242024202220232024202520242023202320232022202320242024
VESC Expressnonononononononononoyesyesyesno
Max Amps150150250200100100150300250
Maximum Continuous Amps200150300250250100150400350160
Maximum Amp Duration310
Peak Phase Amps120250250250350300300
Minimum Voltage1815242424242433.633.62424
Maximum Voltage75.61508484848478948488.2100.892.292.2100.8126134
Max Batter Amps70751001001008080100120
Max Operating Temp (C)7575
Loop Frequency832832800800800800800832832800800832832832800800800832832832800
Hall ConnectorCombined with motor connector7mm Bullet
Dimensions130x67.7x40.172x8472x8472x8460x8097x90x3629x68x8321x102x57
PCB SocketsJST-PHJST-GHJST-PHJST-PHJST-PHJST-GHJST-PHJST-PH
PCB PortsUSB-CCAN, SWD, 2 x UART, HALL, ADC, SERVO, 12VUSB, CAN, UART, SPI, IICUSB-CUSB-CADC1, ADC2, UART, PPM, IIC, CANbus, USB-CADC1, ADC2, UART, PPM, IIC, CANbus, USB-CUART, ADC, Power, Hall Sensors, 3xLEDs, 2xUSB-CUSB-CPPM, UART(adc1/adc2/adc3), Canbus, Hall sensor, TypeC USB, SWD port, NRF port, Ignite Key port, Power button port/12V power port *2PPM, UART(adc1/adc2), Canbus, Hall sensor, TypeC USB, SWD port, NRF port, Ignite Key port, Power button port/12V power port *2
Power Outpute12V* 0.4A (~10V). 3.3V*1A. 5V*0.75A5V, 12V
Bluetoothyesyesyesyesyesyesyesyesyesnonoyesyesyesnonoyesyesyes
MountCheap FOCerFW ADVGTGTLittle FOCerLittle FOCerLittle FOCerPintPintLittle FOCer 3.0, 3,1, 4XRThor300
Link(s)makerspevennoidflipskytronicsystemsmakerx-techweb.archivemakerspevmakerspevfloatwheeldiscoverzescdiscoverzescfungineersalienridesspintendspintendtronicsystemstronicsystemstronicsystemsfloatwheelfacebook
Videoyoutube

Batterypacks

Compare all batterypacks (desktop screen recommended)
Battery Packs - Typical battery packs, either included in boards, or available as after market options.
ADVADV 2ADV ProCBGT 50SCBGT P42ACBSPCBXRFungineersGTGT-SGeneric 15S2PGeneric 16S2PGeneric 18S2PGeneric 19S2PGeneric 20S2PGeneric 24S2PGeneric 27S1PGeneric 30S1PPint XQuartQuart S EditionXR
DescriptionFloatwheel ADV battery pack. This pack was originally said to be built with DG40 batteries, but I'm not sure if those even exist. They are now advertised to contain LR2170LA batteriesFloatwheel ADV 2 battery pack.Floatwheel ADV Pro battery pack.Onewheel GT upgrade 50S editionOnewheel GT upgradeChi Batteries - XR Stunt Pack.Chi Batteries - more power to fit in original FM box.Fungineers complete battery pack 2024.Original FM battery pack for the GT.Extra high voltage pack by FM.DIYDIYDIYDIYDIYDIY pack typically usimg a split packDIYDIYOriginal Pint X battery pack.Onewheel Pint upgradeOnewheel Pint upgrade with 50S batteriesOriginal Onewheel XR battery pack.
Reverse XT60 Polarityyesyesyesyesyesyesyesyesyesyes
Battery TypeLR2170LA50SP42A50SP42AP42AM35A50SP42AP45BVTC6P42A50SMJ1
Serial20202018181515201827151618192024273015151515
Parallel2222212221222222112112
Linkfloatwheelsfloatwheelsfloatwheelschibatterysystemschibatterysystemschibatterysystemschibatterysystemsfungineerstheboardgarageonewheeltheboardgaragechibatterysystemschibatterysystemsweb.archive

Batteries

Compare all batteries (desktop screen recommended)
Batteries - Often used battery types
30Q50SA123DG40LR2170LAM35AMJ1P28AP42AP45BP50BVTC6
DescriptionSamsungSamsungOriginal XR batteriesUsed in the Floatwheel ADVLishenOriginal GT batteries. Also used in CBCSO packs.Thin enough for normal battery boxesHigh TorqueEven higher torqueA bit smaller than the P45B, yet more energySony
Form Factor1865021700266502170018650186501865021700217002170018650
TypeLIIONLIIONLIIRONLIIONLIIONLIIONLIIONLIIONLIIONLIIONLIIONLIION
Full V4.24.23.64.24.24.24.24.24.24.24.24.2
Nominal V3.63.63.33.63.73.63.63.63.63.63.63.6
Empty V332333333333
Drained V2.52.522.52.52.52.52.52.52.52.52.5
Diameter (mm)18.321.2525.9621.118.318.218.621.221.721.418.2
Length (mm)64.970.6265.1570.565.056565.27070.270.1565
Weight (g)45.972766548474666.5686848
Max A153550403510103545455030
Min mAh295048002500450040003350345028004000435048503000
Typical mAh300050002600450040003500350027004200450050003120
Wh9.73515.846.62514.8513.411.05511.3859.2413.214.35516.0059.9
Linknkonfloatwheelsnkonimrbatteriesnkonnkonnkonnkonnkonnkonnkon

Tires

Compare all tires (desktop screen recommended)
Tires - Common tire sizes
10.5x….11.0x…11.5x…
DescriptionSmall tire, often used for Pint/PintXMost common tire size for XR platformsBTG (Big Tire Gang)
Diameter (inch)10.51111.5
Diameter (mm)266.7279.4292.1

Motors

Compare all motors (desktop screen recommended)
Motors - Different motors that can be used in a VESC build
CannonCore V1CannonCore V2HypercoreSuperflux MK1Superflux MK2 HSSuperflux MK2 HTTrotterphub-188 800W 60V
DescriptionFloatWheel ADV MotorOriginal Onewheel MotorThe original Fungineers SuperfluxFungineers High SpeedFungineers High TorqueThe Magwheel Trotter is a cheap Onewheel copycat that can be VESC'dAn exoitic cheap AliExpress motor. We are showing the most poerfull version here, which is still not very powerful. I include it here only because it is listed in Float Control.
Motor Poles30303030303030
Max Power Loss700700400700700700700
Open Loop RPM15001500700150015001500700
Sensorless ERPM1500150020001500150015002000
Field Weakening Max Current40
Max Motor Current180180120180180180120
Max Motor Voltage60
Min Torque48535080
Max Torque
More infofloatwheelfungineersfungineersredditaliexpress
Videoyoutubeyoutube
Independent statspev

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 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
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!

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

Actions

Are you sure you want to reset all forms?

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.