gclib  361
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 
17 **Recommended**. All instructions and examples depend on the installation paths.
18 
19 \htmlonly
20 <a href="http://www.galil.com/sw/pub/all/rn/gclib.html">
21  <img src="http://galil.com/sw/pub/all/doc/images/download.png" alt="Download" />
22  Download from the release notes page
23 </a>
24 \endhtmlonly
25 
26 ### Download Zip
27 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.
28 
29 
30 ###Required third-party DLLs
31 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.
32 
33 ### Uninstall gclib
34 * Run `uninstall.exe` in "C:\Program Files (x86)\Galil\gclib"
35 
36 ##Installed Files
37 Installation from the executable installer looks like the following.
38 
39  C:\Program Files (x86)\Galil\gclib>tree /a
40  Folder PATH listing for volume OS
41  Volume serial number is AE3F-6836
42  C:.
43  +---dll
44  | +---x64
45  | \---x86
46  +---doc
47  | \---html
48  | \---search
49  +---examples
50  | +---cpp
51  | +---cs
52  | | \---2013_12.0
53  | | \---gclib_example
54  | | \---gclib_example
55  | | \---Properties
56  | +---gcc
57  | +---mingw
58  | +---msvc
59  | | \---2013_12.0
60  | | \---gclib_example
61  | | \---gclib_example
62  | \---vb
63  | \---2013_12.0
64  | \---gclib_example
65  | \---gclib_example
66  | \---My Project
67  +---include
68  +---lib
69  | \---dynamic
70  | +---x64
71  | \---x86
72  \---source
73  +---gclibo
74  \---wrappers
75  +---cs
76  +---gcl
77  \---vb
78 
79 
80 ### dll
81 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**.
82 
83 ###doc
84 The *doc* directory contains this documentation and a printable, pdf version.
85 
86 ###examples
87 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.
88 
89 \warning
90 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.
91 
92 ###include
93 The *include* directory contains header files needed for compiling code. The compiler will need to know where these files are at compile time.
94 See the compiler-specific directions for more information, e.g. <a href="md_mingw.html">gclib using MinGW</a>.
95 
96 ###lib
97 The *lib* directory contains linker files (*gclib.lib* and *gclibo.lib*) for both x86 and x64 architectures.
98 The linker should include *gclib.lib* and *gclibo.lib*.
99 
100 ###source
101 The *source* directory contains source files such as gclibo.c.
102 
103