gclib  528
Communications API for Galil controllers and PLCs
jog_example.cpp
Go to the documentation of this file.
1 
11 #include "examples.h"
12 
13 #include <iostream> //std::cout
14 using namespace std;
15 
17 
22 int main(int argc, char * argv[])
23 {
24  GReturn rc = GALIL_EXAMPLE_OK;
25  char buf[G_SMALL_BUFFER];
26 
27  //var used to refer to a unique connection. A valid connection is nonzero.
28  GCon g = 0;
29 
30  try
31  {
32  if (argc != 2) //Invalid number of arguments
33  {
34  cerr << "Incorrect number of arguments provided\n";
35  cerr << "Usage: jog_example.exe <ADDRESS>\n";
36  return GALIL_EXAMPLE_ERROR;
37  }
38 
39  char* address = argv[1]; //Retrieve address from command line
40  e(GOpen(address, &g)); //Opens a connection at the provided address
41 
42  //Puts controller into Jog Mode and accepts user input to adjust the speed
43  rc = jog(g);
44  }
45  catch (GReturn gr)
46  {
47  GError(gr, buf, G_SMALL_BUFFER); //Get Error Information
48  cout << buf << '\n';
49  if (g)
50  {
51  GSize size = sizeof(buf);
52  GUtility(g, G_UTIL_ERROR_CONTEXT, buf, &size);
53  cout << buf << '\n'; //further context
54  }
55  return GALIL_EXAMPLE_ERROR;
56  }
57 
58  return rc;
59 }
GReturn jog(GCon g)
Puts controller into Jog Mode and accepts user input to adjust the speed.
Definition: jog.cpp:29
void * GCon
Connection handle. Unique for each connection in process. Assigned a non-zero value in GOpen().
Definition: gclib.h:92
GCLIB_DLL_EXPORTED GReturn GCALL GUtility(GCon g, GOption request, GMemory memory1, GMemory memory2)
Provides read/write access to driver settings and convenience features based on the request variable.
int main(int argc, char *argv[])
Main function for Commands Example.
#define G_UTIL_ERROR_CONTEXT
GUtility(), provides additional error context, where available.
Definition: gclib.h:70
GCLIB_DLL_EXPORTED GReturn GCALL GOpen(GCStringIn address, GCon *g)
Open a connection to a Galil Controller.
GCLIB_DLL_EXPORTED void GCALL GError(GReturn rc, GCStringOut error, GSize error_len)
Provides a human-readable description string for return codes.
Definition: gclibo.c:445
unsigned int GSize
Size of buffers, etc.
Definition: gclib.h:93
#define G_SMALL_BUFFER
Most reads from Galil are small. This value will easily hold most, e.g. TH, TZ, etc.
Definition: gclib.h:87
void e(GReturn rc)
A trivial, C++ style return code check used in Galil's examples and demos.
Definition: examples.h:30
int GReturn
Every function returns a value of type GReturn. See gclib_errors.h for possible values.
Definition: gclib.h:91