gclib  307
Communications API for Galil controllers and PLCs
 All Data Structures Files Functions Variables Typedefs Macros Pages
windows.md
1 # Microsoft Windows {#windows}
2 
3 ##Tested versions
4 
5 See the \link installation \endlink page for supported versions.
6 
7 ##Installation
8 On Windows, gclib is distributed in the following formats.
9 * 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.
10 * 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.
11  * A stand-alone PCI driver installer for PCI users (DMC-1806, 1800, 1802, 1417).
12 
13 \note The PCI driver is compatible with GalilTools but is enhanced for gclib communications.
14 
15 ### Download Installer
16 **Recommended**. All instructions and examples depend on installation paths. Downloads are available on the <a href="http://www.galil.com/sw/pub/all/rn/gclib.html">release notes</a> page.
17 
18 ### Download Zip
19 For custom deployment or non-default file locations. Downloads are available on the <a href="http://www.galil.com/sw/pub/all/rn/gclib.html">release notes</a> page.
20 
21 
22 ###Required third-party DLLs
23 gclib is built using MSVC2013 and requires run-time components available in the <a href="http://www.microsoft.com/en-us/download/details.aspx?id=40784">Visual C++ Redistributable Packages for Visual Studio 2013</a>. Be sure to install the appropriate architecture (x86 or x64). Installing <a href="http://galil.com/downloads/software/gdk">GDK</a> includes the 64 bit version.
24 
25 ### Uninstall gclib
26 * Run `uninstall.exe` in "C:\Program Files (x86)\Galil\gclib"
27 
28 ##Installed Files
29 Installation from the executable installer looks like the following.
30 
31  C:\Program Files (x86)\Galil\gclib>tree /a
32  Folder PATH listing for volume OS
33  Volume serial number is AE3F-6836
34  C:.
35  +---dll
36  | +---x64
37  | \---x86
38  +---doc
39  | \---html
40  | \---search
41  +---examples
42  | +---cpp
43  | +---cs
44  | | \---2013_12.0
45  | | \---gclib_example
46  | | \---gclib_example
47  | | \---Properties
48  | +---gcc
49  | +---mingw
50  | +---msvc
51  | | \---2013_12.0
52  | | \---gclib_example
53  | | \---gclib_example
54  | \---vb
55  | \---2013_12.0
56  | \---gclib_example
57  | \---gclib_example
58  | \---My Project
59  +---include
60  +---lib
61  | \---dynamic
62  | +---x64
63  | \---x86
64  \---source
65  +---gclibo
66  \---wrappers
67  +---cs
68  +---gcl
69  \---vb
70 
71 
72 ### dll
73 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**.
74 
75 ###doc
76 The *doc* directory contains this documentation and a printable, pdf version.
77 
78 ###examples
79 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.
80 
81 \warning
82 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.
83 
84 ###include
85 The *include* directory contains header files needed for compiling code. The compiler will need to know where these files are at compile time.
86 See the compiler-specific directions for more information, e.g. <a href="md_mingw.html">gclib using MinGW</a>.
87 
88 ###lib
89 The *lib* directory contains linker files (*gclib.lib* and *gclibo.lib*) for both x86 and x64 architectures.
90 The linker should include *gclib.lib* and *gclibo.lib*.
91 
92 ###source
93 The *source* directory contains source files such as gclibo.c.
94 
95