Latest revision |
Your text |
Line 1: |
Line 1: |
− | [[File:Granity3dhires.png|600px|right]]Granity is the configuration software tool for Granite Devices motor drives, such as [[IONI]], [[ATOMI]] and [[ARGON]]. Granity has been designed from ground up aiming for effortless setup of servo drives while keeping functionality and reliability maxed out.
| + | Granity is the configuration software tool for [[Argon (servo drive)]]. Granity is a successor of [[GDtool]] software. |
| ==Design== | | ==Design== |
− | <gallery widths=400 heights=350>
| + | 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. |
− | File:granity windows 1.14.png|Granity on Windows
| + | |
− | File:granity linux scope.png|Granity on Linux Ubuntu
| + | [[File:Granity3dhires.png|800px]] |
− | File:granity macos.png|Granity on MacOS | + | |
− | </gallery>
| + | |
| | | |
| ==Download== | | ==Download== |
− | Download the latest release from the link below. | + | Download the latest release from the link below. To run Granity, just extract the Zip file and launch Granity.exe. Installation is not needed. |
− | *Windows & Linux
| + | *[[Media:GranitySoftware.zip|Download Granity for Windows (~18 MB)]] |
− | **{{dlfile|Granity 1.15.3 win64.zip|Download Granity 1.15.3 for Windows (This version fixes the software freezing bug) (91 MB)}}
| + | *[[:File:GranitySoftware.zip|Older versions]] |
− | **{{dlfile|GranitySoftware.zip|Download Granity and DeploymentTool bundle for Windows & Linux (64 bit) (41 MB)}}
| + | |
− | **[[:File:GranitySoftware.zip|Older versions]]
| + | |
− | | + | |
− | *MacOS (64 bit)
| + | |
− | **{{dlfile|Granity.dmg|Download Granity for MacOS (41 MB)}}
| + | |
− | **{{dlfile|DeploymentTool.dmg|Download DeploymentTool for MacOS (12 MB)}}
| + | |
− | | + | |
− | | + | |
− | Basic installation:
| + | |
− | *To run Granity on Windows, just extract the Zip file and launch Granity.exe. Installation is not needed.
| + | |
− | *To use Granity on Linux, see [[Granity for Linux]] | + | |
− | *To use Granity on MacOS, open the .dmg package file and drag & drop the file to your Applications folder | + | |
− | | + | |
− | | + | |
− | Utils:
| + | |
− | *GNU Octave script for loading Granity scope captures saved as CSV files {{dlfile|read_granity_csv.m|read_granity_csv.m}}
| + | |
− | | + | |
| ===Drivers=== | | ===Drivers=== |
| 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 [http://www.ftdichip.com/Drivers/VCP.htm this page]. The recommended package is the setup executable ([http://www.ftdichip.com/Drivers/CDM/CDM20830_Setup.exe direct link]). | | 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 [http://www.ftdichip.com/Drivers/VCP.htm this page]. The recommended package is the setup executable ([http://www.ftdichip.com/Drivers/CDM/CDM20830_Setup.exe direct link]). |
Line 34: |
Line 15: |
| See main article [[Granity user guide]] | | See main article [[Granity user guide]] |
| ==Version history== | | ==Version history== |
− | {| class="mw-collapsible mw-collapsed wikitable" | + | {| class="wikitable" |
| |- | | |- |
| ! Version !! Release date !! Change log !! Remarks | | ! Version !! Release date !! Change log !! Remarks |
Line 63: |
Line 44: |
| *Support for [[IONI Servo & Stepper Drive]] added | | *Support for [[IONI Servo & Stepper Drive]] added |
| *Various usability improvements and added parameters (IONI only, update for Argon coming later) | | *Various usability improvements and added parameters (IONI only, update for Argon coming later) |
− | | rowspan="2" |In this package version there are two executables (Granity-ARGON.exe and Granity-IONI.exe). Use the one intended for your drive model. | + | |rowspan=2|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.6.0 || 15.4.2015 || |
Line 86: |
Line 67: |
| *[[Granity for Linux|Linux version]] introduced | | *[[Granity for Linux|Linux version]] introduced |
| *Several small usability improvements | | *Several small usability improvements |
− | || | + | ||Requires IONI FW V1.3+ or Argon FW V2.0+ |
− | *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 {{param|CEI}}
| + | |
− | *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 {{Param|LSP}}
| + | |
− | * 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
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.13.0
| + | |
− | |3.7.2017
| + | |
− | |
| + | |
− | * Support for IONI FW 1.6.0 beta 2 new features
| + | |
− | ** Auto-setup hall sensors
| + | |
− | ** Serial encoder (BiSS/SSI) support upgraded
| + | |
− | ** New scope capture features
| + | |
− | ** Home switch signal source selection added
| + | |
− | * Improvements
| + | |
− | ** Homing configuration UI refreshed
| + | |
− | ** Scope refreshed, new features:
| + | |
− | *** Offline scope capture support, see [[Downloading offline scope capture in Granity]]
| + | |
− | *** Scope capture pre-trigger delay is adjustable
| + | |
− | *** New trigger choice (external trigger) added when drive FW supports it
| + | |
− | *** Preservation of scope settings, settings are now stored in drive flash memory and settings files
| + | |
− | ** Added a button to automatically set {{Param|CAO}} for Analog and PWM setpoint sources
| + | |
− | ** Added dedicated DeploymentTool to bach upload drive firmware & settings
| + | |
− | ** Compatibility between different Granity & drive versions improved when saving or loading settings files
| + | |
− | * Fixes
| + | |
− | ** Bug of Granity 1.11.0 causing connection error with message telling that parameter address 547 failed
| + | |
− | ** Fix an issue where "Searching devices" status may be stuck on until application is restarted
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.14.0
| + | |
− | |17.1.2018
| + | |
− | |
| + | |
− | * Added direct support for FTDI USB chipset (no dependence on virtual COM port)
| + | |
− | * Support for latest firmware features added
| + | |
− | ** Added absolute encoder support for IONI FW 1.7.0
| + | |
− | ** Add support for operation with just Hall sensors (no encoder)
| + | |
− | * Fixed few bugs / issues
| + | |
− | * Small user interface improvements
| + | |
− | * Released MacOS version
| + | |
− | * Released 64 bit Linux version
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.14.1
| + | |
− | |20.3.2018
| + | |
− | |
| + | |
− | * Fixed few bugs / issues
| + | |
− | ** Workaround crashing in Windows version when online help-page load fails (i.e. no internet connection)
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.14.2
| + | |
− | |16.10.2018
| + | |
− | |
| + | |
− | * Added hotkeys to control Quick stop feature of recent firwmares (Ctrl+Alt+Q sets quick stop, Ctrl+Alt+R resets quick stop)
| + | |
− | * Granity now remembers last used interface device
| + | |
− | * Small UI / UX improvements
| + | |
− | * Updated internal SimpleMotion library for proper TCP/IP support
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.15.0
| + | |
− | |18.9.2019
| + | |
− | |
| + | |
− | * Added support for newly introduced firmware features
| + | |
− | * Small UI / UX improvements
| + | |
− | * Saves new version of DRC file compatible with latest deployment functions of SimpleMotion V2 library
| + | |
− | * Improved TCP/IP support
| + | |
− | * Various internal improvements
| + | |
− | * Updated Drive Deployment Tool to support new file formats
| + | |
− | * CSV file export delimiter changed from ; to ,
| + | |
− | | + | |
− | |
| + | |
− | |-
| + | |
− | |1.15.1
| + | |
− | |20.11.2019
| + | |
− | |
| + | |
− | * Small UI / UX improvements
| + | |
− | ** Added drop down menu to allow connecting directly to given drive address without going through scan & select dialog
| + | |
− | |
| + | |
− | |-
| + | |
− | |1.15.2
| + | |
− | |7.8.2020
| + | |
− | |
| + | |
− | * Scope capture
| + | |
− | ** Added option of 25 Hz sample rate
| + | |
− | ** Added support for scope sample averaging on drives that support it
| + | |
− | ** Allow exporting graphs to both .csv and .png formats simultaneously
| + | |
− | * Added -longtimeout command line argument to tolerate higher latency connections (i.e. over TCP/IP)
| + | |
− | * Added support for various new target device types
| + | |
− | |
| + | |
| |} | | |} |
| | | |
| ==Bugs and TODO's== | | ==Bugs and TODO's== |
− | ===Known limitations=== | + | ===Known bugs=== |
| + | *Halls enabled & Granity connected & drive restart -> starts spinning and follow error faults - fix attempt done |
| *Serial numbers read -1 when loading .drc file | | *Serial numbers read -1 when loading .drc file |
| | | |
Line 216: |
Line 78: |
| *User settable temperature fault level | | *User settable temperature fault level |
| *Add mm/min and inches/min speed units | | *Add mm/min and inches/min speed units |
− | *Set fixed Y axis range for graphs | + | *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==
| + | |
− | Granity uses following open source libraries and components:
| + | |
− | *[http://www.flotcharts.org Flot]
| + | |
− | *[https://www.openssl.org OpenSSL]
| + | |
− | *[[SimpleMotion V2]]
| + | |
− | *[https://github.com/qextserialport/qextserialport QExtSerialPort]
| + | |
− | *[https://www.qt.io Qt]
| + | |
− | For full details and licenses, see [[Third-party licenses]].
| + | |
− | | + | |
− | [[Category:Downloads]]
| + | |
− | [[Category:Software]]
| + | |
− | [[Category:Granity]]
| + | |