Granity

From Granite Devices Knowledge Wiki
Jump to: navigation, search

Granity is the configuration software tool for Argon (servo drive). Granity is a successor of GDtool software.

Design[edit | edit source]

From GDtool times, Granity has been redesigned from ground up and aims to deliver effortless setup of servo drives while keeping functionality and reliability maxed out.

Granity3dhires.png

Download[edit | edit source]

Download the latest release from the link below. To run Granity, just extract the Zip file and launch Granity.exe. Installation is not needed.

Drivers[edit | edit source]

In most cases Windows detects the SimpleMotion V2 USB adapter as USB Serial port and is able to install drivers automatically. However, if not, download VCP (Virtual COM Port) drivers from this page. The recommended package is the setup executable (direct link).

Documentation[edit | edit source]

See main article Granity user guide

Version history[edit | edit source]

Version Release date Change log Remarks
1.0.0 1.9.2013 Initial release Requires Argon firmware 1.0.0
1.0.1 3.9.2013
  • Correct typos
  • Set Abs and Set Inc buttons to change setpoint manually
  • Display list of all parameters together with graphs - becomes useful when saving graphs as the list of parameters gets included in the file as well
  • Safe Torque Off status is now displayed
  • Fix the issue of not showing online version of Wiki
Requires Argon firmware 1.0.1
1.0.2 18.9.2013
  • Added Invert directionAXI parameter
Requires Argon firmware 1.0.2
1.1.0 6.11.2013
  • Added parameters Dynamic braking decelerationBDD, Mech brake engage delayBED and Mech brake assisted phasingBAP
  • Graphs are now saved as PNG image file instead of PDF
  • Added copy device state to clipboard button
  • Avoid getting (harmless) connection error message after FW upgrade
Requires Argon firmware 1.1.0
1.5.0 19.3.2015
  • Support for IONI Servo & Stepper Drive added
  • Various usability improvements and added parameters (IONI only, update for Argon coming later)
In this package version there are two executables (Granity-ARGON.exe and Granity-IONI.exe). Use the one intended for your drive model.
1.6.0 15.4.2015
1.7.0 4.5.2015
  • Support SinCos feedback device option for IONI
  • Added more guidance text to certain error messages
1.8.0 29.5.2015
  • Support for Argon with firmware 2.0
  • Added sanity checks and guidance for few parameterization errors
  • Saving graph raw data to .csv file possible
1.9.0 2.11.2015
  • Support for IONI Pro HC
  • Support for IONI firmware 1.3.0
  • Support for new torque cogging & uniformity functions of IONI Pro
  • Linux version introduced
  • Several small usability improvements
  • Requires IONI FW V1.3+ or Argon FW V2.0+
  • Package includes also executables for Granity 1.7.0 and 1.1.0 for older firmwares
1.9.1 5.1.2016
  • Fix app crashing (not completely yet, it seems)
  • Fix communication errors
  • Small GUI improvement on Testing tab
1.10.0 6.5.2016
  • Support IONI FW 1.5.0
  • GUI improvements
  • Added SimuCUBE in Electrical interfaceCEI
  • Added new IONI pro feature parameters
1.10.1 31.10.2016
  • Crashing bug fixed
  • Small Testing page usability improvements
1.10.2 19.12.2016
  • Added rescan button to Communication interface devices list
  • Support new parameter Limit switch polarityLSP
  • Added support for language translations (no translations made yet)
1.11.0 26.1.2017
  • Added parameters fir BiSS feedback device configuration (for IONI Pro drive with BiSS support firware)
  • Improve Measure resistance & inductance function

Bugs and TODO's[edit | edit source]

Known bugs[edit | edit source]

  • Halls enabled & Granity connected & drive restart -> starts spinning and follow error faults - fix attempt done
  • Serial numbers read -1 when loading .drc file

Suggested features[edit | edit source]

  • User settable temperature fault level
  • Add mm/min and inches/min speed units
  • Add zero offset function for Analog & PWM setpoints - can be done by making setpoint scope and calculating average and then the offset value

Open source licenses[edit | edit source]

Granity uses following open source libraries and components:

For full details and licenses, see Third-party licenses.


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.