gclib  437
Communications API for Galil controllers and PLCs
msvc2013.md
1 # Microsoft Visual Studio 2013 (12.0) {#msvc2013}
2 
3 For brevity, these instructions assume the default installation location of **C:\\Program Files (x86)\\Galil\\gclib**.
4 
5 ## x_simple.c from *VS2013 x64 Native Tools Command Prompt*
6 
7 Open *VS2013 x64 Native Tools Command Prompt*.
8 
9 ###Copy files
10 Navigate to a convenient, empty, writable location, e.g. *C:\\temp*.
11 
12 #### Set an environment variable for the base path.
13 
14  C:\temp>set base=C:\Program Files (x86)\Galil\gclib
15 
16 #### Copy simple example
17 
18  C:\temp>copy "%base%\examples\cpp\x_simple.c" .
19 
20 ### Edit GOpen() call as necessary
21 In a text editor, open *x_simple.c*. Find the GOpen() call and update the address to match the desired hardware. See the documentation for GOpen() for address formatting options.
22 
23 ### Compile
24 
25  C:\temp>cl x_simple.c "%base%\lib\dynamic\x64\*.lib" -I "%base%\include"
26 
27 ### Set Path to DLL
28 
29  C:\temp>set PATH=%base%\dll\x64\;%PATH%
30 
31 ### Execute
32 
33  C:\temp>x_simple.exe
34  rc: 0
35  version: 85.60.138
36  rc: 0
37  rc: 0
38  info: 10.1.3.17, DMC4020 Rev 1.2b, 291
39  rc: 0
40  response: 357247808.0000
41  :
42 
43 
44 ##Using the pre-configured MSVC project (x_examples.cpp)
45 
46 The directory *gclib\\examples\\msvc* has fully functional MSVC examples. These instructions detail how to use the 2013 version.
47 
48 * Copy *gclib\\examples\\msvc\\2013_12.0\\gclib_example* to a convenient, writable location, e.g. *C:\\temp*.
49 * Run *gclib_example\\gclib_example\\copy_source.bat* to copy the files.
50 * Open *gclib_example\\gclib_example.sln* in Visual Studio 2013.
51 * In the *Solution Explorer*, expand the *gclib_example* and expand *Source Files* to show a listing of source.
52 * Open *x_examples.cpp*
53 * Find the GOpen() call and update the address to match the desired hardware. See the documentation for GOpen() for address formatting options.
54 * Find the `#if 0` preprocessor block enclosing the example calls. Change to `#if 1` to run the examples. Comment out the function calls to be avoided. Note some calls attempt to move motors and not all functions are compatible with all Galil products.
55 * Hit *F5* to build and run the example.
56 
57 
58 ##Create Project with MSVC 2013 (x_examples.cpp)
59 
60 The instructions below allow building a project from scratch.
61 
62 The following instructions were performed on *Visual Studio Professional 2013* and can be extended to other Visual Studio versions.
63 For brevity, the instructions assume the default installation location of **C:\\Program Files (x86)\\Galil\\gclib** and a build type of **x86 (win32)**.
64 
65 * Launch *Visual Studio 2013*
66 * Choose *File->New->Project*
67 * In the *New Project* dialog, choose *Visual C++->Empty Project*
68 * Choose a Name, e.g. **gclib_example**
69 * Choose a Location, e.g. *C:\\Users\\user\\Desktop*
70 * Check *Create directory for solution*
71 * Click *OK*
72 * In the *Solution Explorer*, right-click on *Source Files* and choose *Add->Existing Item*
73  * Navigate to the gclib installation directory, then to *examples\\cpp* in the installation directory
74  * In *File Name* type **x_*.cpp** and click *Add*, this will filter out the files needed
75  * Select all files in the file chooser and click *Add*
76 * In the *Solution Explorer* right-click on *gclib_example*, choose *Properties*, highlight *Configuration Properties*, and set the following project properties
77  * At the top of the window, change *Configuration:* to *All Configurations* and ensure *Platform* lists *Active(Win32)*
78  * *Configuration Properties -> C/C++ -> Additional Include Directories* add **C:\\Program Files (x86)\\Galil\\gclib\\include**
79  * *Configuration Properties -> Linker -> General -> Additional Library Directories* add **C:\\Program Files (x86)\\Galil\\gclib\\lib\\dynamic\\x86**
80  * *Configuration Properties -> Linker -> Input -> Additional Dependencies* add **gclib.lib;gclibo.lib;**`{rest of text}` where `{rest of text}` is the original string that was in the cell. Note the semicolons between library files.
81  * *Configuration Properties -> Debugging -> Environment* add **PATH=C:\\Program Files (x86)\\Galil\\gclib\\dll\\x86;\%PATH%**
82 * In the *Solution Explorer* open *x_examples.cpp*. Find the GOpen() call and update the address to match the desired hardware. See the documentation for GOpen() for address formatting options.
83 * Find the `#if 0` preprocessor block enclosing the example calls. Change to `#if 1` to run the examples. Comment out the function calls to be avoided. Note some calls attempt to move motors and not all functions are compatible with all Galil products.
84 * Hit *F5* to build and run the example.