IONI parameterization

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

Preparations and connection

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

Walk-through of initial parametrization

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

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

Goals tab

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

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

Axis mechanics

Axis type, units and scale parameters AXT and AXS 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

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

1. Choose motor type from the drowndown list MT. If motor is linear type, see configuring linear servo motor.
2. Set motor pole count MPC (non-brush DC motors only). If unsure, see Determining motor pole count.
3. Set maximum rated speed MMS of the motor, or alternatively the maximum allowed motor speed in the target application
4. Set motor continuous MMC and peak MMC 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 coil resistance MR and inductance ML, these values are measured Phase-to-phase. If unavailable, perform Tuning torque controller manually after initial parameters are set.
6. Set thermal time constant MTC. Motor thermal time constant value in seconds, used for thermal modeling of motor to avoid motor overheating with peak current MMC. 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.

Feedback device

1. Choose feedback device type from the dropdown FBD
2. Set feedback device resolution. If FBD 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 FBR field. Some manufactures also call PPR as CPR.
3. Configure the polarity of feedback device counting direction by FBI 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 FBH during initial setup. Enable later if necessary (see when).

Tuning

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

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

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

1. Leave FOC value as default if no overcurrent faults occur. See Tuning torque controller if overcurrent faults occur.
2. Set FOV following way depending on your HV DC bus supply voltage. Set FOV value at least 10% higher than nominal HV DC bus voltage. 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 FUV 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. FFT, FPT, FVT, FEV) 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

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 fault filter time FFT sets the time how fast FPT, FVT, FEV and FMO 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 threshold FPT according how much mechanical axis is allowed to deviate from the setpoint position in position control mode.
3. Set Velocity tracking error threshold FVT 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 fault FEV 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 threshold FMO as 0 (0 = disabled) for the beginning. Using nonzero value enables motion fault.
6. Choose Limit switch function LFS 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

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

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 type MT is configured
5. If Requires software enable CEN is enabled, then also click Soft enable drive from Connect tab

Servo motor tuning

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

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

1. Choose setpoint input CRI 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 CAL 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 MUL and DIV.
4. If setpoint signal is noisy or jittering, try enabling CIS to smoothen it inside drive. However, leave CIS 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.