1 # Ubuntu Linux {#ubuntu}
6 This version of Linux has **x64/AMD64 Support Only**. Contact Galil if another version
7 is required for an application.
9 See the \link installation \endlink page for supported versions.
13 ###Create a temporary variable for Ubuntu version
15 uver=$(lsb_release -r | cut -f 2); echo $uver
18 ###Install Galil's public certificate
20 $ wget http://www.galil.com/sw/pub/ubuntu/$uver/GALIL-PUB-KEY
21 $ sudo apt-key add GALIL-PUB-KEY
23 ###Get Galil's apt sources list
25 $sudo wget http://www.galil.com/sw/pub/ubuntu/$uver/galil.list -O /etc/apt/sources.list.d/galil.list
30 $sudo apt-get install gclib
36 $sudo apt-get remove gclib
39 * The gclib shared object files
40 * /usr/lib/libgclibo.so
41 * /usr/lib/libgclib.so
42 * The gclib header files
43 * /usr/include/gclib_errors.h
44 * /usr/include/gclibo.h
45 * /usr/include/gclib.h
46 * /usr/include/gclib_record.h
47 * gclib documentation tarball
48 * /usr/share/doc/gclib/gclib_129_doc.tar.gz
49 * Example source tarball
50 * /usr/share/doc/gclib/src/gclib_129_examples.tar.gz
51 * Source files to modify/rebuild libgclibo.so
52 * /usr/share/doc/gclib/src/gclibo_129_src.tar.gz
53 * GalilTools Communication Library (gcl) wrapper
54 * /usr/share/doc/gclib/src/gclib_129_gcl.tar.gz
56 * /usr/share/doc/gclib/src/gclib_129_pci.tar.gz
59 ##Serial Ports and USB
60 If access to the serial ports or USB (e.g. DMC-4103) is desired through gclib, the following will provide steps to join the correct access group. If using USB, be sure the controller is powered and the usb is plugged in before beginning.
62 ###Determine group with access
64 $ ls -l /dev/ttyUSB* /dev/ttyS*
65 crw-rw----. 1 root dialout 4, 64 Mar 3 16:39 /dev/ttyS0
66 crw-rw----. 1 root dialout 4, 65 Mar 3 16:39 /dev/ttyS1
67 crw-rw----. 1 root dialout 4, 66 Mar 3 16:39 /dev/ttyS2
68 crw-rw----. 1 root dialout 4, 67 Mar 3 16:39 /dev/ttyS3
69 crw-rw----. 1 root dialout 188, 0 Mar 6 11:08 /dev/ttyUSB0
71 In the above listing, **dialout** is the group that needs to be joined. **uucp** is another common group that may be listed.
73 ###Add the desired *username* to the group.
75 $ sudo gpasswd -a username dialout
76 [sudo] password for username:
77 Adding user username to group dialout
79 Log out and back in for change to take effect.
82 username wheel dialout
84 gclib can now connect to serial and usb devices from user *username*.
87 If using a Galil PCI controller, the PCI driver must be installed.
89 ###Extract source and build driver
91 $ tar -xf /usr/share/doc/gclib/src/gclib_202_pci.tar.gz
94 ###Copy module and add to kernel
96 $ sudo cp galilpci.ko /lib/modules/$(uname -r)
98 $ sudo modprobe galilpci
100 ###Add galil group for access to PCI
102 $ sudo groupadd -f -K GID_MIN=100 -K GID_MAX=499 galil
103 $ sudo cp 90-galilpci.rules /etc/udev/rules.d/
104 $ sudo udevadm control --reload-rules
105 $ sudo udevadm trigger
106 $ sudo usermod -a -G galil username #exchange "username" with actual user's name
108 Logout and back in. The PCI hardware is now available for access.
111 crw-rw---- 1 root galil 10, 56 Jun 9 11:07 /dev/galilpci0
112 $ echo -e "\x12\x16\r" > /dev/galilpci0
118 The documentation is left as a tarball to minimize disk usage. The latest release version of the user manual is available at the following link.
119 * http://www.galil.com/sw/pub/all/doc/gclib/html/
122 The following allows viewing of the html docs from the installation.
124 $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz html
125 $ firefox html/index.html
128 There may be a pdf shipped in the package. The following allows viewing of the pdf docs from the installation.
130 $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz gclib_132.pdf
131 $ evince gclib_132.pdf