Granity for Linux

From Granite Devices Knowledge Wiki
Jump to: navigation, search
Granity running on LinuxCNC distribution
Starting from version 1.9.0, Granity includes also Linux version of the software. This page lists useful information of installing and using it on different distributions.

Installation & usage[edit | edit source]

To install the Granity for Linux, extract the zip file in any folder (for example your home folder) and make GranityLinux64 file executable. Following commands should be run under the folder where GranityLinux files is located:

chmod +x GranityLinux

Then start it by:

./GranityLinux64

To use 64 bit version (starting from Granity 1.14.0), just use GraniteLinux64 instead of GranityLinux as stated above.

This works in an ideal case where all necessary system libraries are installed. However, in typical cases few additional libraries (like 32 bit Qt4) are needed. For distribution specific instructions and library dependencies, please see guides below.

Distribution specific guides[edit | edit source]

Debian 8.2 (64 bit Jessie release)[edit | edit source]

sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get install libc6:i386 gambas3-gb-qt4-webkit:i386

Other distributions[edit | edit source]

No data of other distributions are at the moment available. You may get hint of missing libraries by commanding

ldd GranityLinux64

It will list library dependencies and give hints of "not found" libraries. Feel free to add a chapter in this wiki page to help out others with the similar problem!

LinuxCNC[edit | edit source]

Granity has been compiled on LinuxCNC 2.6 distribution. List of needed commands to install the needed libraries:

sudo apt-get update
sudo apt-get install libqt4-webkit

Troubleshooting[edit | edit source]

Finding correct port[edit | edit source]

In Linux, Granity can't tell the difference between SMV2USB adapter and other serial ports. However, typically the USM2USB adapter is /dev/ttyUSB0 if no other USB serial ports are present. You can verify this by unplugging SMV2USB and starting Granity again, if the port disappears, then it is the correct one.

Port permissions[edit | edit source]

Some distributions don't give enough permissions to access the port. To overcome this, try starting Granity with root permissions (command sudo ./GranityLinux) or change port permissions (command sudo chmod a+rw /dev/ttyUSB0).

Using direct FTDI USB chipset support[edit | edit source]

Granity from version 1.14.0 supports connecting with the direct support of FTDI USB chip found on Granite Devices products. This is alternative to the virtual serial port and if Granity finds the compatible FTDI device, it is automatically listed in the communication interface list.

Scope graphs not displaying[edit | edit source]

This happens if the executable is launched in the other folder than it's location (because program doesn't find then "flot" folder). To workaround, start program in the same folder where the GranityLinux file is. I.e. in command prompt run ./GranityLinux. The fix for this is coming after V1.9.1.


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.