VESC Tool: A Beginner's Guide

VESC Tool is the primary software used to configure and monitor VESC controllers. VESC Tool is essential for setting up a VESC board for the first time and calibrating various components.

:warning: DISCLAIMER: The VESC Bible is currently being republished and rewritten to encompass all necessary beginner guides. All guides with a beta tag are still preliminary and need to be vetted and reviewed by VESC experts.

Setup Features of VESC Tool

VESC Tool offers several functions that allow users to fine-tune their VESC setup:

  • Motor Detection: This function helps VESC Tool identify the connected motor’s characteristics, such as resistance and inductance. This information is crucial for the controller to operate the motor efficiently and safely.
  • (Re)Float Package: Can be installed via VESC to operate and tune a self balancing onewheeled board
  • Parameter Adjustment: VESC Tool allows for adjusting various parameters that affect the board’s performance, including:
    • Voltage thresholds: Setting appropriate voltage cut-offs ensures the battery is not over-discharged, which can damage the cells. Users can also set a high voltage tilt-back point to indicate when the battery is nearing full charge.
    • Current limits: Setting limits on motor current prevents overloading the motor and controller.
    • Throttle curves: Users can adjust the relationship between throttle input and motor output to achieve desired acceleration and braking characteristics.

Calibration and First-Time Setup

During the initial setup of a VESC board, VESC Tool plays a critical role in calibrating the system:

  • Motor Wizard Setup: This guided process helps users calibrate their motor by detecting its parameters and setting the appropriate control settings.
  • IMU Calibration: The Inertial Measurement Unit (IMU) is responsible for sensing the board’s orientation and movement. Calibrating the IMU ensures accurate balance and control.
  • Accelerometer Calibration: tbc

Beyond the Basics

VESC Tool offers advanced features for experienced users who want further customisation. These include:

  • Real-time Data Monitoring: VESC Tool displays live data such as battery voltage, current, motor speed, and temperature, allowing users to monitor the system’s performance while riding.
  • Firmware Updates: VESC Tool can be used to update the firmware on the VESC controller, enabling users to access new features and improvements.
  • Data Logging: This feature records various parameters during a ride, allowing for analysis and further tuning.

Conclusion

VESC Tool is a powerful and versatile software that is essential for anyone building or using a VESC-based electric vehicle. By understanding its basic functions and how to use it for calibration and setup, beginners can unlock the full potential of their VESC builds.

Note: Remember to always refer to the documentation provided by your specific VESC controller and component manufacturers for detailed instructions and safety guidelines