| gclib 354 Communications API for Galil controllers and PLCs |

All Data Structures Files Functions Variables Typedefs Macros Pages
Raspberry Pi

## Tested versions

See the installation page for supported versions.

## Installation

### Create a temporary variable for Raspbian version

    uver=$(lsb_release -r | cut -f 2); echo $uver
    8.0

### Install Galil's public certificate

    $ wget http://www.galil.com/sw/pub/raspbian/$uver/GALIL-PUB-KEY
    $ sudo apt-key add GALIL-PUB-KEY

### Get Galil's apt sources list

    $sudo wget http://www.galil.com/sw/pub/raspbian/$uver/galil.list -O /etc/apt/sources.list.d/galil.list
    $sudo apt-get update

### Install Package

     $sudo apt-get install gclib

### Uninstall Package

To uninstall gclib.

    $sudo apt-get remove gclib

## Serial Ports and USB

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.

### Determine group with access

    $ ls -l /dev/ttyUSB* /dev/ttyS*
    crw-rw----. 1 root dialout   4, 64 Mar  3 16:39 /dev/ttyS0
    crw-rw----. 1 root dialout   4, 65 Mar  3 16:39 /dev/ttyS1
    crw-rw----. 1 root dialout   4, 66 Mar  3 16:39 /dev/ttyS2
    crw-rw----. 1 root dialout   4, 67 Mar  3 16:39 /dev/ttyS3
    crw-rw----. 1 root dialout 188,  0 Mar  6 11:08 /dev/ttyUSB0

In the above listing, dialout is the group that needs to be joined. uucp is another common group that may be listed.

### Check the user's group

The default pi username is already a member of dialout.

    $ groups
    pi adm dialout cdrom sudo audio video plugdev games users input netdev gpio i2c spi

### If needed, add the desired username to the group.

    $ sudo gpasswd -a username dialout
    [sudo] password for username:
    Adding user username to group dialout

Log out and back in for change to take effect.

    $ groups
    username wheel dialout

gclib can now connect to serial and usb devices from user username.

## Documentation

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.

- http://www.galil.com/sw/pub/all/doc/gclib/html/

### Offline html

The following allows viewing of the html docs from the installation, in the GUI mode.

    $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz html
    $ epiphany html/index.html

### Offline pdf

There may be a pdf shipped in the package. The following allows viewing of the pdf docs from the installation.

    $ sudo apt-get update
    $ sudo apt-get install evince
    $ tar -xzf /usr/share/doc/gclib/gclib_132_doc.tar.gz gclib_132.pdf
    $ evince gclib_132.pdf