gclib  370
Communications API for Galil controllers and PLCs
 All Data Structures Files Functions Variables Typedefs Macros Pages
Microsoft Windows

Tested versions

See the installation page for supported versions.

Installation

On Windows, gclib is distributed in the following formats.

  • An executable installer which will install the library in the proper location to work with the included examples and documentation. PCI users can optionally install the PCI driver from within this installer.
  • A zip file containing the same set of files as the executable but in a zip archive. PCI users can use the stand-alone PCI driver installer.
    • A stand-alone PCI driver installer for PCI users (DMC-1806, 1800, 1802, 1417).
Note
The PCI driver is compatible with GalilTools but is enhanced for gclib communications.

Download Installer

Recommended. All instructions and examples depend on the installation paths.

Download Download from the release notes page

Download Zip

For custom deployment or non-default file locations. Downloads are available on the release notes page.

Required third-party DLLs

gclib is built using MSVC2013 and requires run-time components available in the Visual C++ Redistributable Packages for Visual Studio 2013. Be sure to install the appropriate architecture (x86 or x64).

  • Installing GDK includes the x64 version.
    • The x64 bit version can also be found here.
  • The x86 bit version can be found here.

Silent Installation

For developers wishing to bundle gclib within their own installers, execute the gclib installer with the /S switch to run silently with defaults. If the Galil security certificate is not already trusted on the deployment target, a digital signature dialog may be presented.

Uninstall gclib

  • Run uninstall.exe in "C:\Program Files (x86)\Galil\gclib"

Installed Files

Installation from the executable installer looks like the following.

C:\Program Files (x86)\Galil\gclib>tree /a
Folder PATH listing for volume OS
Volume serial number is AE3F-6836
C:.
+---dll
|   +---x64
|   \---x86
+---doc
|   \---html
|       \---search
+---examples
|   +---cpp
|   +---cs
|   |   \---2013_12.0
|   |       \---gclib_example
|   |           \---gclib_example
|   |               \---Properties
|   +---gcc
|   +---mingw
|   +---msvc
|   |   \---2013_12.0
|   |       \---gclib_example
|   |           \---gclib_example
|   \---vb
|       \---2013_12.0
|           \---gclib_example
|               \---gclib_example
|                   \---My Project
+---include
+---lib
|   \---dynamic
|       +---x64
|       \---x86
\---source
    +---gclibo
    \---wrappers
        +---cs
        +---gcl
        \---vb

dll

The dll directory contains the binary dynamic link libraries (DLLs) for both x86 and x64 architectures. Dynamically linked executables must have the correct dlls in their path at runtime.

doc

The doc directory contains this documentation and a printable, pdf version.

examples

The examples directory contains example projects for various compilers. The cpp directory contains x_examples.h and the implementation of the example files documented in this manual.

Warning
Before using the examples, copy the files to a user location such as C:\Users\user\Documents. Failing to do so may cause source files to be deleted upon gclib uninstallation.

include

The include directory contains header files needed for compiling code. The compiler will need to know where these files are at compile time. See the compiler-specific directions for more information, e.g. gclib using MinGW.

lib

The lib directory contains linker files (gclib.lib and gclibo.lib) for both x86 and x64 architectures. The linker should include gclib.lib and gclibo.lib.

source

The source directory contains source files such as gclibo.c.