Topics
	Galil Connect

Typedefs
typedef enum gclib_connection_t	gclib_connection_t
	Connection type, as returned by gclib_connection_type().

Enumerations
enum	gclib_connection_t { GCLIB_ETHERNET = 1 , GCLIB_SERIAL , GCLIB_PCI }
	Connection type, as returned by gclib_connection_type(). More...

Functions
gclib_result	gclib_addresses (char *addresses, size_t len)
	Show address, model, and serial of detected controllers, where available. Detected controllers are newline-separated. Each line is comma-separated.
gclib_result	gclib_ip_requests (char *ip_requests, size_t len)
	Show MAC address, model, and serial of all controllers requesting IP addresses, comma-separated. Use gclib_assign_ip() to assign an IP address to controllers returned by this method.
gclib_result	gclib_assign_ip (const char mac, const char ip)
	Assign IP to a controller.
gclib_result	gclib_set_dhcp_enabled (bool enabled)
	Enable or disable gcaps DHCP server.
gclib_result	gclib_dhcp_enabled (bool *enabled)
	Check if DHCP server is enabled.
void	gclib_force_gcaps (bool on)
	Force future library calls to use either gcaps or direct connections.
gclib_result	gclib_open (gclib_handle h, const char address)
	Open a connection to a controller.
gclib_result	gclib_set_baud_rate (gclib_handle h, size_t baud_rate)
	Set baud rate of serial connection.
gclib_result	gclib_close (gclib_handle *h)
	Close connection to controller.
const char *	gclib_error (gclib_handle h)
	Get library error string.
gclib_result	gclib_address (gclib_handle h, char *address, size_t len)
	Get connection address.
gclib_result	gclib_connection_type (gclib_handle h, gclib_connection_t *type)
	Get connection type.

Detailed Description

Discover available controllers and open connections

Typedef Documentation

◆ gclib_connection_t

typedef enum gclib_connection_t gclib_connection_t

Connection type, as returned by gclib_connection_type().

Enumeration Type Documentation

◆ gclib_connection_t

enum gclib_connection_t

Connection type, as returned by gclib_connection_type().

Enumerator
GCLIB_ETHERNET
GCLIB_SERIAL
GCLIB_PCI

Definition at line 302 of file gclib.h.

Function Documentation

◆ gclib_addresses()

gclib_result gclib_addresses	(	char *	addresses,
		size_t	len )

Show address, model, and serial of detected controllers, where available. Detected controllers are newline-separated. Each line is comma-separated.

Available information by connection type:

Ethernet connections show address, model, and serial.
USB connections show address and model.
Serial and PCI connections show address only.

Example output:

192.168.0.40, DMC4040 Rev 1.3i, 10601
COM5, DMC-41x3
GALILPCI0

Parameters

addresses	Output buffer
len	Length of output buffer

Returns: GCLIB_BUFFER_TOO_SMALL if output does not fit in buffer.

◆ gclib_ip_requests()

gclib_result gclib_ip_requests	(	char *	ip_requests,
		size_t	len )

Show MAC address, model, and serial of all controllers requesting IP addresses, comma-separated. Use gclib_assign_ip() to assign an IP address to controllers returned by this method.

Example output:

00:50:4c:20:29:69, DMC4000, 10601

00:50:4c:58:12:34, DMC2105, 4660

Parameters

ip_requests	Output buffer. Example output:
len	Length of output buffer

Returns: GCLIB_BUFFER_TOO_SMALL if output does not fit in buffer.

◆ gclib_assign_ip()

gclib_result gclib_assign_ip	(	const char *	mac,
		const char *	ip )

Assign IP to a controller.

Parameters

mac	The MAC address of the controller requesting an IP. Provided by gclib_ip_requests().
ip	The IP address to assign.

Returns: GCLIB_INVALID_ARGUMENT if MAC or IP is invalid, or if assigned IP puts controller in an unreachable subnet.

◆ gclib_set_dhcp_enabled()

gclib_result gclib_set_dhcp_enabled ( bool enabled )

Enable or disable gcaps DHCP server.

The gcaps DHCP server is enabled by default. When disabled, gclib_ip_requests() and gclib_assign_ip() will no longer function. This setting will persist across restarts.

Parameters

enabled Set whether the DHCP server should be enabled or disabled.

◆ gclib_dhcp_enabled()

gclib_result gclib_dhcp_enabled ( bool * enabled )

Check if DHCP server is enabled.

Use gclib_set_dhcp() to enable or disable the gcaps DHCP server. Persists across restarts.

Parameters

enabled The status of the DHCP server.

Returns: gclib_result GCLIB_INVALID_ARGUMENT if another process is using the DHCP server port (67).

◆ gclib_force_gcaps()

void gclib_force_gcaps ( bool on )

Force future library calls to use either gcaps or direct connections.

The default behavior of gclib is to prefer gcaps, but fall back to direct operations when gcaps is not running. This method allows disabling the default behavior process-wide, but cannot be undone.

Parameters

on	If true, all future gclib calls will fail if gcaps not found, rather than falling back to direct operations. If false, gcaps will not be used for any future gclib calls.

◆ gclib_open()

gclib_result gclib_open	(	gclib_handle *	h,
		const char *	address )

Open a connection to a controller.

Opens a connection through gcaps, if available. Otherwise, a direct connection will be opened. If fallback is not desirable, see gclib_force_gcaps().

If opening a serial connection, the baud rate will default to 115200. Call gclib_set_baud_rate() if necessary before attempting communications.

Parameters

h	Handle that will be needed for future gclib calls operating on this controller.
address	Address of controller, obtained from gclib_addresses().

Returns: GCLIB_NOT_CONNECTED if unable to open connection.

◆ gclib_set_baud_rate()

gclib_result gclib_set_baud_rate	(	gclib_handle	h,
		size_t	baud_rate )

Set baud rate of serial connection.

Parameters

h	Handle to an open connection.
baud_rate	Baud rate to use for serial connection.

Returns: GCLIB_NOT_CONNECTED if unable to communicate with controller after setting baud rate.

◆ gclib_close()

gclib_result gclib_close ( gclib_handle * h )

Close connection to controller.

Parameters

h	Handle to an open connection. Will be set to NULL on success.

Returns: GCLIB_INVALID_ARGUMENT if h does not appear to be a valid handle to an open connection.

◆ gclib_error()

const char * gclib_error ( gclib_handle h )

Get library error string.

Pass NULL to get the last error generated by gclib functions not taking a gclib_handle, such as gclib_addresses().

Warning: The string returned is an internal error string, which may change between releases.

Parameters

h	Handle to an open connection. May be NULL.

Returns: The last error string generated by the library.

◆ gclib_address()

gclib_result gclib_address	(	gclib_handle	h,
		char *	address,
		size_t	len )

Get connection address.

Parameters

h	Handle to an open connection.
address	Output buffer for connection address.
len	Size of output buffer.

Returns: GCLIB_BUFFER_TOO_SMALL if output does not fit in buffer.

◆ gclib_connection_type()

gclib_result gclib_connection_type	(	gclib_handle	h,
		gclib_connection_t *	type )

Get connection type.

Parameters

h	Handle to an open connection.
type	Will be set to the type of the connection.

Returns: GCLIB_INVALID_ARGUMENT if h does not refer to an open connection.

Topics

Typedefs

Enumerations

Functions

Detailed Description

Typedef Documentation

◆ gclib_connection_t

Enumeration Type Documentation

◆ gclib_connection_t

Function Documentation

◆ gclib_addresses()

◆ gclib_ip_requests()

◆ gclib_assign_ip()

◆ gclib_set_dhcp_enabled()

◆ gclib_dhcp_enabled()

◆ gclib_force_gcaps()

◆ gclib_open()

◆ gclib_set_baud_rate()

◆ gclib_close()

◆ gclib_error()

◆ gclib_address()

◆ gclib_connection_type()