00001 # Fedora Linux {#fedora}
00002
00003 ##Tested versions
00004
00005 See the \link installation \endlink page for supported versions.
00006
00007
00008 ##Installation
00009 On Fedora, gclib is distributed in an RPM repository. The following steps can be performed to install gclib.
00010
00011 ### Download Galil's repository information
00012
00013 * Point a browser at http://www.galil.com/sw/pub/fedora/galilrpm-1-1.noarch.rpm and install the rpm.
00014 * This step installs Galil's RPM repositories and only needs to be done once.
00015
00016 <!--- sudo wget http:
00017
00018 ### Install Package
00019 Install gclib package, approve "Installed size" and "Importing GPG key", if prompted.
00020
00021 $ sudo yum install gclib
00022
00023 ### Uninstall Package
00024 To uninstall gclib.
00025
00026 $ sudo yum remove gclib
00027
00028 ##Installed files
00029 * The gclib shared object files
00030 * /usr/lib/libgclibo.so
00031 * /usr/lib/libgclib.so
00032 * The gclib header files
00033 * /usr/include/gclib_errors.h
00034 * /usr/include/gclibo.h
00035 * /usr/include/gclib.h
00036 * /usr/include/gclib_record.h
00037 * gclib documentation tarball
00038 * /usr/share/doc/gclib/gclib_129_doc.tar.gz
00039 * Example source tarball
00040 * /usr/share/doc/gclib/src/gclib_129_examples.tar.gz
00041 * Source files to modify/rebuild libgclibo.so
00042 * /usr/share/doc/gclib/src/gclibo_129_src.tar.gz
00043 * GalilTools Communication Library (gcl) wrapper
00044 * /usr/share/doc/gclib/src/gclib_129_gcl.tar.gz
00045 * PCI driver files
00046 * /usr/share/doc/gclib/src/gclib_129_pci.tar.gz
00047
00048
00049
00050 ##Serial Ports and USB
00051 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.
00052
00053 ###Determine group with access
00054
00055 $ ls -l /dev/ttyUSB* /dev/ttyS*
00056 crw-rw----. 1 root dialout 4, 64 Mar 3 16:39 /dev/ttyS0
00057 crw-rw----. 1 root dialout 4, 65 Mar 3 16:39 /dev/ttyS1
00058 crw-rw----. 1 root dialout 4, 66 Mar 3 16:39 /dev/ttyS2
00059 crw-rw----. 1 root dialout 4, 67 Mar 3 16:39 /dev/ttyS3
00060 crw-rw----. 1 root dialout 188, 0 Mar 6 11:08 /dev/ttyUSB0
00061
00062 In the above listing, **dialout** is the group that needs to be joined. **uucp** is another common group that may be listed.
00063
00064 ###Add the desired *username* to the group.
00065
00066 $ sudo gpasswd -a username dialout
00067 [sudo] password for username:
00068 Adding user username to group dialout
00069
00070 Log out and back in for change to take effect.
00071
00072 $ groups
00073 username wheel dialout
00074
00075 gclib can now connect to serial and usb devices from user *username*.
00076
00077 ##PCI Controllers
00078 If using a Galil PCI controller, the PCI driver must be installed.
00079
00080 ###Install prerequisites
00081
00082 $ sudo yum install kernel-devel-$(uname -r)
00083 $ sudo yum install kernel-headers-$(uname -r)
00084 $ sudo yum install gcc
00085
00086 ###Extract source and build driver
00087
00088 $ tar -xf /usr/share/doc/gclib/src/gclib_202_pci.tar.gz
00089 $ make
00090
00091 ###Copy module and add to kernel
00092
00093 $ sudo cp galilpci.ko /lib/modules/$(uname -r)
00094 $ sudo depmod
00095 $ sudo modprobe galilpci
00096
00097 ###Add galil group for access to PCI
00098
00099 $ sudo groupadd -f -K GID_MIN=100 -K GID_MAX=499 galil
00100 $ sudo cp 90-galilpci.rules /etc/udev/rules.d/
00101 $ sudo udevadm control --reload-rules
00102 $ sudo udevadm trigger
00103 $ sudo usermod -a -G galil username #exchange "username" with actual user's name
00104
00105 Logout and back in. The PCI hardware is now available for access.
00106
00107 $ ls -l /dev/galil*
00108 crw-rw---- 1 root galil 10, 56 Jun 9 11:07 /dev/galilpci0
00109 $ echo -e "\x12\x16\r" > /dev/galilpci0
00110 $ cat /dev/galilpci0
00111 DMC1846 Rev 1.1a
00112 :
00113
00114 ##Documentation
00115 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.
00116 * http://www.galil.com/sw/pub/all/doc/gclib/html/
00117
00118 ###Offline pdf
00119 The following allows viewing of the pdf docs from the installation.
00120
00121 $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz gclib_132.pdf
00122 $ evince gclib_132.pdf
00123
00124 ###Offline html
00125 The following allows viewing of the html docs from the installation.
00126
00127 $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz html
00128 $ firefox html/index.html
