IONI parameterization

From Granite Devices Knowledge Wiki
Jump to: navigation, search

This article will describe how to set-up IONI parameters with Granity to make motor operational and ready for servo tuning.

Preparations and connection[edit | edit source]

As the goal is to parameterize and make motor operational, we should have:

  1. The drive and motor fully wired. However it's not required to have controller or braking resistor connected at this point.
  2. Be familiar with the operation and parameters of Granity. Make sure you have read Granity user guide.
  3. Granity connection working. See IONI & IONICUBE user guide/Making the first Granity connection


Minimum setup for drive & motor configuration stages

Walk-through of initial parametrization[edit | edit source]

In this chapter we walk-trough all Granity tabs and modify the parameter needed. This guide assumes that the drive is in factory defaults state (not configured before). Restore drive to factory state can be done by uploading a firmware file to the drive.

Connect tab[edit | edit source]

No other actions than connect to drive needed on this tab. Once connection successful, proceed to the next tab.

Goals tab[edit | edit source]

The factory defaults (torque control as control mode and serial only as setpoint) as well as the other defaults are the correct ones for beginning.

Machine tab[edit | edit source]

In this tab we configure the motor and its feedback device.

Axis mechanics[edit | edit source]

Parameters Axis type & unitsAXT and Axis scaleAXS affect only on the unit conversion of Granity parameters (such as acceleration/velocity limit unit conversions) and has no effect on drive operation.

Choose your axis type and scale, or leave them as defaults.

Motor[edit | edit source]

Find motor parameters from the motor data sheet/manufacturer specifications.

  1. Choose motor type from the drown down list Motor typeMT. If motor is linear type, see configuring linear servo motor. If setting up a stepping motor instead of servo motor, see Using stepping motor with IONI.
  2. Set motor Pole countMPC (non-brush DC motors only). If unsure, see Determining motor pole count.
  3. Set Maximum speedMMS of the motor, or alternatively the maximum allowed motor speed in the target application
  4. Set motor Peak current limitMMC and Peak current limitMMC current values. If non-brush DC motor type has been selected, then these are measured as the peak value of sine. See Motor peak and continuous current limits for description.
  5. Set Thermal time constantMTC. Motor thermal time constant value in seconds, used for thermal modeling of motor to avoid motor overheating with Peak current limitMMC. If not available, use formula 200*motor_weight (kg) as approximate, so a 2 kg motor would get a 400 second time constant. There is no guarantee of accuracy of this method.
  6. Setting motor Coil resistanceMR and Coil inductanceML values are required for proper drive operation. Do this by using the Granity's measurement function after drive is enabled and operating the first time. If this method fails, perform Tuning torque controller manually after initial parameters are set or find motor inductance & resistance values from your motor data sheet.

Feedback device[edit | edit source]

  1. Choose feedback device type from the drop down Feedback deviceFBD
  2. Set feedback device resolution. If Feedback deviceFBD is quadrature encoder, then manufacturers typically give resolution as pulses per revolution (PPR) or lines per revolution (LPR) which are the same thing and shall be entered directly into Feedback device resolutionFBR field. Some manufactures also call PPR as CPR.
  3. Configure the polarity of feedback device counting direction by Invert feedback directionFBI parameter. Motor and feedback device must have same electrical positive rotation direction to make a stable servo system. If your system shows no stability (instant following error after a motor "jump"), try changing this setting.
  4. Leave the Hall sensors Off from parameter Hall sensorsFBH during initial setup. Enable later if necessary (see when).

Tuning[edit | edit source]

Tuning tab contains feedback gain values for velocity and position control modes as well as torque bandwidth limit setting. Configuring these parameters are documented in Servo motor tuning guide. However, before proceeding into tuning, go through all other settings listed in this article.

Fault limits[edit | edit source]

Fault limits define the conditions in which drive is willing to operate. If condition is out of the set values, drive will enter into a fault state and stop motor control until errors are cleared.

Drive fault limits[edit | edit source]

These settings specify drive electrical condition such as supply voltage and over current tolerance.

  1. Leave Over current toleranceFOC value as default if no overcurrent faults occur. See Tuning torque controller if overcurrent faults occur.
  2. Set Over voltage fault thresholdFOV following way depending on your HV DC bus supply voltage. Set FOV value at least 10% higher than nominal HV DC bus voltage. For detailed guide of understanding FUV and FOV parameters, see page Configuring drive voltage limits FUV and FOV. Examples:
    1. 24 VDC regulated power supply, try value of 32 VDC
    2. 48 VDC regulated power supply, try value of 54 VDC
  3. Set Under voltage fault thresholdFUV so that drive will not trigger undervoltage fault during varying load of HV DC bus. Example:
    1. 24 VDC regulated power supply, try value of 19 VDC
    2. 48 VDC regulated power supply, try value of 35 VDC
  1. It is important to goal deviation faults (i.e. Goal faults filter timeFFT, Position tracking error thresholdFPT, Velocity tracking error thresholdFVT, Over speed faultFEV) as low as possible. Set them so that faults don't occur during normal operation but any anomaly or unexpected behavior will trigger them.

Goal deviation faults[edit | edit source]

These faults adjust motor monitoring during operation. Drive will enter into fault state if motor condition deviates more than allowed from the desired condition. See Granity unit conversion before adjusting.

  1. Goal Goal faults filter timeFFT sets the time how fast Position tracking error thresholdFPT, Velocity tracking error thresholdFVT, Over speed faultFEV and Motion fault thresholdFMO faults react. Setting higher time value allows drive to continue operation over short deviations thus avoid false triggering. Set this from 0.0 to 0.2 seconds in the beginning.
  2. Set Position tracking error thresholdFPT according how much mechanical axis is allowed to deviate from the setpoint position in position control mode.
  3. Set Velocity tracking error thresholdFVT according how much motor or axis speed may may deviate from the velocity setpoint. This affects also in position mode as velocity controller is the intermediate step between torque and position controllers.
  4. Set Over speed faultFEV according to the maximum speed allowed for the motor or axis. Helps to stop motor if system goes totally out of control and speeds up spuriously.
  5. Leave Motion fault thresholdFMO as 0 (0 = disabled) for the beginning. Using nonzero value enables motion fault.
  6. Choose Limit switch functionLFS according to your preference. If other than Do nothing option requires that limit switches are installed and connected to J5 port. Note: at the moment Servo stop option is active in the drive firmware and will do nothing until FW upgrade enables it.

Testing tab[edit | edit source]

These settings does not affect drive operation, so nothing to be changed here at this point. These controls will be used for servo tuning purposes and fault analysis.

Enabling drive[edit | edit source]

In order to test any configuration you make, you need to set drive in enabled state. This involves that:

  1. Drive is powered on (logic & HV DC bus)
  2. Enable signal is powered.
    1. If no physical enable signal is wired, you may click Force enable drive from Connect tab to temporarily enable without physical signal. Note that Force enable will release (inactivate) if any of following physical inputs change state: Enable, Limit switches or Home switch.
  3. STO2 input is powered
  4. Motor typeMT is configured
  5. If Require software enableCEN is enabled, then also click Soft enable drive from Connect tab

Servo motor tuning[edit | edit source]

Tuning a servo motor is a compulsory task to make motor behave as desired and perform well during operation. Follow the Servo motor tuning guide.

Finishing touches[edit | edit source]

The last step of parameterization is to adapt settings to match the motion controller. Steps:

  1. Choose setpoint input Setpoint inputCRI to match your motion controller.
  2. If external motion controller with acceleration limit (such as CNC controller) is being used, then it is advised to set Acceleration limitCAL value to maximum of 32767 (unlimited acceleration) after motor tuning to enable motion tracking without delay. Use a limited acceleration value if drive is being used with pulse burst positioning or SimpleMotion V2 controller.
  3. If setpoint is too sensitive or not sensitive enough (such as limiting speed), then adjust setpoint scaling factory by adjusting Setpoint multiplierMUL and Setpoint dividerDIV.
  4. If setpoint signal is noisy or jittering, try enabling Setpoint smoothingCIS to smoothen it inside drive. However, leave Setpoint smoothingCIS disabled if setpoint tracking without any delay is desired.
  5. Set-up homing if required by application




In no event the Product Information or parts hereof shall be regarded as guarantee of conditions or characteristics. The Product Information or any part thereof may also not be regarded as a warranty of any kind. No liability of any kind shall be assumed by Author with respect to Product Information or any use made by you thereof, nor shall Author indemnify you against or be liable for any third party claims with respect to such information or any use thereof.

As content of this Wiki may be edited by user community, Granite Devices Oy or it's affiliates do not take any responsibility of the contents of this Wiki. Use information at your own risk. However, Granite Devices staff attempts to review all changes made to this Wiki and keep information trustworthy.

Without written consent, Granite Devices' Products or Intellectual Property shall not be used in situations or installations where living beings, material property, or immaterial property could be harmed by the operation, features or failures of Product. Products may only be used in a way where hazards like moving parts, electric shock, laser radiation, or fire can't be realized even if the content of this Wiki would suggest otherwise.