Configuring IONI drive in SimuCUBE

From Granite Devices Knowledge Wiki
Jump to: navigation, search
This page helps setting correct parameters to IONI drive.

Preparations[edit | edit source]

  1. Download Granity software
  2. Connect SimuCUBE X4 to PC with USB cable
  3. Connect motor to connector X1 and motor feedback device to X16 as instructed earlier
  4. Have E-stop switch unconnected or open until configuration is complete
  5. Power on SimuCUBE
  6. Wait until windows has recognized the device and installed driver
  7. Start Granity software
  8. Important If you are using SimuCUBE firmware, please remember to click "Enable IONI USB Configuration" in the Advanced tab of the SimuCUBE Configuration Tool.
  9. Connect to IONI by clicking Connect to drive button
    Granityconnect.png
  10. Once list of found devices pop-up, select the IONI drive and click Open
Connections needed in this step are: AC, X1 (motor power and E-stop), X16 (encoder) and X4 (Granity USB). All others may be left unconnected.
Each SimuCUBE system consists one IONI Servo & Stepper Drive that is controls the motor of Force feedback system (FFB)If everything went fine, we are now connected to IONI and change it's settings. If not, see SimuCUBE troubleshooting and Device connection troubleshooting.

Upgrading IONI firmware[edit | edit source]

First it is recommended to upgrade to the latest IONI firmware:

  1. Download latest IONI firmware from IONI firmware releases
  2. Follow instructions of Granity user guide/Uploading a firmware
  3. Connect again into drive by choosing Connect to drive just like we did first time
  4. Proceed to Loading motor configuration file or Configuring motor manually chapter

Loading motor configuration file[edit | edit source]

If you have pre-made configuration file made to your motor and SimuCUBE, you may follow this chapter to load it in the IONI and skip the next chapter Configuring motor.

  1. Click Load settings from file
  2. Select the file and open it
  3. Click Save settings to drive non-volatile memory and answer yes to questions of applying settings and restarting drive afterwards
  4. All done, proceed to Testing settings chapter

See also List of motors for SimuCUBE for pre-made configuration files.

Configuring motor manually[edit | edit source]

All settings except the one mentioned here should be kept at their factory defaults. If unsure which settings are factory defaults, then repeat firmware upgrade procedure and tick the Reset device to factory state checkbox before uploading the firmware.


Following settings are constant and always required with SimuCUBE:

Granity tab Parameter Value Notes
Goals Control modeCM Torque control
Goals Electrical interfaceCEI SimuCUBE
Goals Setpoint inputCRI Pulse Width Modulation Note: Leave this to Serial only if you're configuring for the first time (and set this to Pulse Width Modulation after testing (later chapter on this page) if testing was successful)
Goals Enable direction inputCED On (ticked)
Fault limits Over voltage fault thresholdFOV 49.5V Assuming 48 VDC regulated power supply
Fault limits Under voltage fault thresholdFUV 30V Assuming 48 VDC regulated power supply
Fault limits Over current toleranceFOC High or Maximum Change this to Maximum if over current fault problems occur with the motor
Machine Maximum peak powerMPP Your power supply rating in watts Granite Devices SimuCUBE systems are have one of these ratings: 320W, 480W or 720W. Use value from your model. If under voltage faults occur, try reducing this value little bit (like 10-30W).

Motor parameters depend on the attached motor type and specifications. Refer your motor manufacturer's data sheet to get the correct values in the following fields:

Granity tab Parameter Value Notes
Machine Motor typeMT 3 phase AC or BLDC
Machine Pole countMPC 8 8 is a typical value, however 4, 6 are common as well
Machine Continuous current limitMCC Maximum motor continuous current Most AC motors specify current as RMS value. Value in this field is entered as Peak value of sine. To covert RMS current to peak value of sine, multiply it by 1.41.
Machine Peak current limitMMC Motor peak current rating Most AC motors specify current as RMS value. Value in this field is entered as Peak value of sine. To covert RMS current to peak value of sine, multiply it by 1.41.

This defines the maximum torque that system will produce. For safety reasons, it is recommended to set this value to 20% of motor specified value until system operation has been verified.

Machine Coil resistanceMR Motor phase-to-phase resistance (from motor data sheet)
Machine Coil inductanceML Motor phase-to-phase inductance (from motor data sheet)
Machine Feedback deviceFBD Motor feedback device type If unsure, choose Quadrature encoder 1
Machine Feedback device resolutionFBR Encoder resolution in pulses per revolution Typical motors have 2500 PPR or 5000 PPR encoder
Machine Invert feedback directionFBI Disabled/Enabled Try first without enabling this, and later with inverting this setting if motor testing section shows problems
Tuning Torque bandwidth limitTBW 680 Hz Sets maximum torque bandiwdth of motor. Values between 220 to 680 Hz recommended for FFB systems.

After all parameters have been set, click Apply settings and go to Connect tab and click Save settings on drive non-volatile memory. Many parameter changes need restarting of the drive to activate new settings. If unsure, just click Restart drive and connect again.

Testing settings[edit | edit source]

To test settings first time, it is advised to change Setpoint inputCRI temporarily to Serial only to avoid unexpected motion. After changing any parameter (including CRI),click Apply settings button to activate the change.

Testing procedure:

  1. Have Granity connected to drive and go to Testing tab
  2. Make sure that nothing is blocking motor rotation and motor is rigidly mounted (unexpected and strong rotation or vibration might occur)
  3. Release E-stop switch to activate the drive
  4. Motor should start initializing by swinging back and forth with decreasing amplitude and then become in rest without any torque or shaft holding force
  5. Manually change torque setpoint by clicking Increment by TSP1 several times. This will increase torque command setpoint on each click. Typically motor should definitely rotate when setpoint is increased above value 5000. Observe motor:
    1. Motor should start rotating after produced torque exceeds static friction. If motor spins, test has passed! Set setpoint to zero and proceed to finalizing settings.
    2. If motor does not start rotating, check device status and fault registers in the Testing tab and check SimuCUBE troubleshooting
    3. If motor starts holding position (becomes stiff to turn) and has "bumps" if forced to turn anyways, then one of following settings need attention:
      1. FBI - try inverting this checkbox value and try again
      2. If FBI didn't help, ensure that MPC and FBR are exactly correct values. See Determining motor pole count if not sure about pole count.

Finalizing settings[edit | edit source]

To finalize setup, change Setpoint inputCRI to Pulse Width Modulation, Apply and save settings to drive. For additional settings and tuning of force feedback effects feeling, you may adjust additional Granity parameters such as Torque mode effects in Tuning tab (click Show advanced settings).


After SimuCUBE all settings have been configured and verified to work, you might want to become back to the settings and adjust motor current limits (MMC and MCC) to increase or adjust maximum torque of motor.



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.