Granity for Linux
Contents
Installation & usage
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
Debian 8.2 (64 bit Jessie release)
sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install libc6:i386 gambas3-gb-qt4-webkit:i386
Other distributions
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
This LinuxCNC section is outdated as 32 bit version of Granity is not included in latest versions. Use 64 bit Linux distributions instead. |
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
Finding correct port
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
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
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.
Sometimes kernel's FTDI driver is being loaded automatically and it prevents the usage of direct FTDI support in Granity. If device connection fails to open, try running command sudo rmmod ftdi_sio and try launching Granity again (if it works, consider blocking ftdi_sio driver automatic with these instructions). Also it may be necessary to run Granity with root privileges (sudo ./GrantyLinux) or adjust system USB device permissions. |
Scope graphs not displaying
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.