Note: The Guide can be downloaded in PDF format at the end of the article.


Disclaimer:


This quick startup guide is provided as a complementary resource to the official motor drive manual and datasheets. It is not intended to be the sole source of information for proper motor drive configuration and operation. Incorrect configuration or software bugs may cause unintended behavior, including uncontrolled motor operation or runaway. Users must always conduct tests cautiously and ensure they have a reliable method to safely stop the system in such scenarios. Roboteq, the author, and related parties are not liable for any hardware damage, personal injury, or other consequences arising from the use or misuse of the information in this guide.


Safety Symbols Explanation:



 Table of Contents                                          



1. How to Read this Guide

2. Theory  

3. Hardware Connections  

4. Required Parameters List  

5. Configuration Steps  

6. Troubleshooting

7. Configuration Example

 


 1. How to Read This Guide                            


  • This guide is part of a series of documents that must be followed sequentially to configure and test a BLDC motor. The process begins with the Open Loop configuration and continues through the sequence of documents until reaching the final target operating mode.
  • The Open Loop mode guides are organized based on the sensors used (e.g., Hall, Hall & Encoder, Sin/Cos, etc.).
  • For example, configuring a higher-level operating mode, such as Count Position with Hall sensors, requires completing the configuration and testing of lower-level modes, including Open Loop with Hall sensors, FOC Torque and FOC Speed.

      


 2. Theory                                                       


Field Oriented Control


Below are some key points concerning the commutation of a Brushless DC (BLDC) motor:


  • BLDC motors use permanent magnets in the rotor
  • A three-phase voltage applied to the stator windings creates a rotating magnetic field that pulls the rotor and produces motion
  • For SPM (Surface Permanent Magnet) motors, optimal torque is achieved when the stator’s magnetic field leads the rotor’s magnetic field by 90 electrical degrees. This is why BLDC motors typically require sensors to determine the rotor’s position and properly align the magnetic fields.
  • Motor commutation is handled by a control algorithm called Field Oriented Control (FOC).
  • The same sensor used to commute the motor can also be used for feedback
  • Although the same sensor may be used, commutation and control are distinct functions managed by the motor drive.



Field Oriented Control (FOC) transforms the angle difference between the rotor and stator magnetic fields into two current vectors by applying Clarke and Park equations: Id (Flux amps) and Iq (Torque amps). 


Field Oriented Control (FOC) transforms the angle difference between the rotor and stator magnetic fields into two current vectors by applying Clarke and Park equations: Id (Flux amps) and Iq (Torque amps).




  • These vectors allow direct control of the magnetic field angle by adjusting the Id and Iq currents
  • Iq current is the component providing torque while Id controls the rotor flux
  • In Open Loop mode (SPM motors), optimal torque is achieved by minimizing the Id current while Iq current results from the applied voltage command and the load. 



  • Id and Iq currents are regulated using two PI (Proportional-Integral) control loops 
  • The PI gains of these control loops are tuned based on the motor’s Resistance (R) and Inductance (L) parameters using the zero-pole cancellation method
  • The RL parameters can be obtained from the motor datasheet or by using the motor characterization tool of the drive
  • The user only needs to select the bandwidth of the FOC loop, which determines its responsiveness.



SSI


Most Roboteq BLDC Motor Controllers support SSI Single and Multiturn Sensors


  • SSI sensors are absolute position sensors that communicate using the RS422 standard. They use a clock signal to synchronize data transmission and a data signal to convey the sensor’s angle. 
  • Both signals use differential transmission, which provides high noise immunity and enables longer transmission distances.
  • SSI sensors can be either single-turn or multi-turn. Multi-turn sensors can store not only the current angle of the sensor but also the number of turns the sensor has performed. Roboteq supports both types of sensors. 
  • SSI sensors support various resolutions (determined by the number of bits), data rates, and data interpretations (e.g., Binary, Gray Code, and others).



  

   


The compatibility of SSI sensors depends on the total number of bits, the single-turn and multiturn data lengths, the maximum and minimum supported sensor frequencies, and the encoding type.


 3. Hardware Connections                              


  • Vmot is the connector for the voltage supplied to the motor and can operate within a range of 14 to 60 V.
  • The Pwr Ctrl supply is optional and can be used to keep the drive operational in case of main battery disconnection. However, Pwr Ctrl must be connected to the battery’s negative terminal to allow the drive to shut down properly.
  • The motor should be connected to the UVW power connectors.




In most motor drives the SSI sensors are connected to the dedicated Molex connector 


  • Refer to each motor drive’s datasheet for specific pinout information.
  • The SSI sensor requires six wires: two for the Clock (+/-) signals, two for the Data (+/-) signals, and two for Vcc and GND.
  • The sensor is powered by the 5V output and GND from the dedicated sensor connector.
  • For improved noise immunity, use twisted-pair cables.

      



 4. Required Parameters List                           


To complete the configuration sequence, ensure you have the following specifications readily available:

   




 5. Configuration Steps                                   


 1. Configure Molex Input to "SSI Sensors"


SSI sensors and Hall sensors share the same Molex connector, so the sensor being used must be declared.



 2. Configure the number of "Pole Pairs" 


Pole pairs parameter is essential for the sinusoidal commutation and for the speed calculation. Pole pairs is the number of motor poles divided by 2.




 3. Configure the switching mode to "Sinusoidal" 


Both trapezoidal and sinusoidal commutation modes are supported by Roboteq drives. Sinusoidal mode results in quieter motor operation with reduced harmonics and current ripple, making it the preferred choice.




 4. Set the Reference Seek Power to the rated current of the motor 


The reference seek power is the current that will be provided to the motor during the motor/sensor calibration process. If the reference current is too low or too high the motor/sensor setup will not be performed correctly.





 5. Configure the Sinusoidal angle sensor to SSI Sensor


This is the sensor that will be used for the commutation of the motor



 6. Configure the SSI sensor resolution


a) In case of single turn sensors, the following parameters need to be set: 


  • SSI number of bits: The total number of bits of the sensor’s frame
  • Counter start bit position: The bit when the angle data start
  • Counter number of bits: Then number of bits that the angle data cover inside the SSI data frame


Typically, the single turn data will start at first bit and will have a length equal to the number of sensor bits. Therefore, "Number of bits" and "Counter number of bits" parameters should have the same value

 


b) In the case of multi-turn sensors, both the single-turn and multi-turn counters must be configured. The starting bit for each of the single-turn and multi-turn angles must be identified within the sensor’s frame, and the data length must be defined. To illustrate this, consider the following example:


In this example, the single-turn data ranges from Bit 1 to Bit 17, the multi-turn data ranges from Bit 18 to Bit 33, and Bits 34 to 41 are special bits, such as status bits, error flags, etc.  


The SSI sensor settings are set based on the example data frame:




 7. Configure the FOC Flux and Torque gains


These are the gain values for the two PI controllers in the FOC loop, which regulate the torque and flux currents. The FOC gains can be set using the Motor Characterization tool. 


The Motor Characterization tool offers two options: 


1) Calculate the gains using the datasheet Parameters:


The datasheet parameters should list the phase-to-phase or the phase Resistance and Inductance values. If these parameters are given as phase-to-phase values, they should be divided by 2. Pay attention to the units, as the Tool accepts mOhm and uH. 


The motor Resistance (R) and Inductance (I) values should be manually entered to the respective fields. The same inductance value should be entered to Ld and Lq parameters, if the motor is an SPM type.



2) Calculate the gains by characterizing the motor:


If the datasheet values are not available, the Roborun+ Utility offers the option to characterize the motor. The motor's resistance and inductance values are estimated by supplying a variable voltage to the motor. Be aware that the rotor will move during the characterization process, so it should not be blocked or loaded.




After setting the gains manually or through Motor Characterizations, you will be prompted to select a bandwidth for the FOC controllers.


 

The motor drive will calculate the FOC gains based on the following formulas:



Prefer a moderate bandwidth value, as high values may cause vibrations, while low values will result in a slower current response.


After closing the tool, the FOC parameters are updated. To view the changes in the utility, click Load from Controller.




 8. Configure the Amps Limit parameter


The drive regulates the motor current based on three configurations: the Amps Limits Parameter, the I²T Protection setting, and the Maximum Motor Output Power. Each of these defines a maximum allowed current, and the drive will restrict the current to the lowest of the three values.


8.1 Set the motor Amps Limit Parameter: The drive will prevent the motor current from exceeding this value by reducing the motor voltage. The amp limit value should be set equal to the peak current of the motor.



8.2 Optionally set the Amps Trigger Action and Amps Trigger Delay parameters: Since the peak current of a motor is typically only allowed for a short duration, Roboteq drives offer the option to trigger an action if the motor current exceeds a specified value for a specific amount of time. This can be configured using the Amps Trigger Action and Amps Trigger Delay parameter.



8.3 Enable the I2T protection: I2T protection is a method that measures the energy supplied to the motor in order to protect it from overheating. It works by integrating the excessive current supplied to the motor and comparing it with a threshold value. If the accumulator exceeds the I2T threshold, the drive will start limiting the current at 80% of the nominal current, allowing the motor to cool down and causing the I²T accumulator to decrease accordingly.


To enable the protection, configure the I2T Time, which is the time that the motor can handle its maximum current, and Nominal Current, which is the nominal current of the motor. 



8.4 Set the Maximum Motor Output Power parameter: Similar to the Amps Limits parameter, the Maximum Motor Output Power parameter restricts current to prevent the motor's power from exceeding the configured value. Set this parameter according to the motor datasheet by calculating the product of the motor's maximum rotational speed (in rad/s) and peak torque.





 9. Configure the operating mode to "Open Loop"


Even if the intention is to use Torque, Speed or Position modes, the configuration and test of Open Loop mode is a mandatory step.




 10. Disable the Sensor Error Detection on the unused channels


The Sensor Error Detection feature monitors for sensor-related faults. In dual-channel drives, if one sensor is not connected, this feature will trigger a Sensor Error. Therefore, this detection must be disabled for unused channels.



 11. Go to Diagnostics Tab and run Motor/Sensor Setup


The Motor/Sensor Setup is an initialization procedure during which the drive aligns the rotor to the zero point of the commutation sequence and stores the value of the SSI counter. This process is required to run only once during drive configuration.




On the chart, enable the Sin, Sensor Angle and Motor Amps parameters and ensure the following:

  • Motor Amps equals the value of the Reference Seek Power parameter.
  • The Sin parameter reflects the SSI angle, which should increase linearly without any “steps.”
  • The Sensor Angle is also linear.




 12. Go to the Run Tab and Evaluate the Open Loop response without load


On the Chart enable the below parameters.



15. Give a motor command using the slider and verify the following:


  • Run the motor in both directions. Verify that the Motor Amps value is below the “no load current” of the motor, when the given command is constant. The motor current can increase during acceleration/deceleration but at constant power, the motor amps should be low. 
  • Give full command in both directions. Verify that the Motor Amps in both CW and CCW direction is symmetrical. If the current is very different (more than 1 A) then something in the configuration might not be correct.
  • Verify that the Motor Flux Amps parameter is has a small fluctuation and is stabilizes quickly to zero when the motor accelerates/decelerates.
  • Verify that the FOC angle correction parameter is stable or that it stabilizes quickly by changing the motor speed
  • Verify that the SSI Sensor Speed RPM is stable when giving a constant command 
  • Verify that the SSI Sensor Speed RPM is symmetrical when giving full command in both directions. Depending on the motor, an error up to 5% can be acceptable, but higher variation might denote a tuning or motor issue. 
  • Verify that the SSI Sensor Speed RPM is positive by giving a positive motor command. If not, invert the pole pairs sign, to fix that.

     

It is crucial having the encoder speed reported with the correct sign otherwise the motor can go into a runaway condition when configuring the Closed Loop modes.



If all the steps have been passed, then the Open Loop configuration is effective, and the motor is ready to be configured in any of the supported Closed Loop operating modes!



 6. Troubleshooting                                         


A troubleshooting table with some common Problems and solutions follows: 





If the motor still cannot rotate in Open Loop, the SSI angle data might not be configured correctly.

  • To verify if the sensor angle is correct, navigate to the Diagnostics tab and perform the motor sensor setup again.
  • Monitor the Sin and Cos values. These parameters should display the single-turn and multi-turn sensor data.
  • The single-turn data should increase linearly. Any steps in the counter value may indicate a misconfiguration.
  • For more detailed troubleshooting, the SSI raw frame can be logged using the ?SFR  query.


     


 7. Configuration Example