The GDK Manager

The GDK Manager provides several software and hardware management utilities.

The GDK Manager is a left side, slide-out, drawer. When open, full access to utilities is provided. When closed, the drawer colapses to a toolbar featuring icons for creating new tools.

Click the Manager icon to open or close the drawer.

IP Requests and IP Assignment

When GDK launches, it will immediately listen for hardware requiring an IP address. After five seconds, any hardware that is requesting an IP will be listed under the IP Requests item.

GDK will search for hardware requesting IP addresses.

To start listening for another five seconds, click the Listen button.

If GDK finds a controller requesting an IP address, double click its row in the displayed table, or select it and click the Assign IP Address button to display the assignment dialog.

The IP Assign dialog will help choose an IP address and assign it to requesting hardware.

Click the Ping Search button to allow GDK to find an available IP address via Ping. The computer adapter's IP address is used as a starting point for the search.

To check a desired address, type in the address and click Ping Search to ensure the IP address is currently unassigned. If a Ping response is received, GDK will find the next available address.

To assign the address in the text box to the listed MAC address, click the Assign Address button.

Available Addresses

When GDK launches, it will immediately search for hardware. Any hardware that is found will be listed under the Available Addresses item. All available serial ports are also listed.

GDK will list all hardware it can see for connections.

To search again for available hardware, click the Search button.

To select an address for use in GDK, double click its row or select one or more addresses from the displayed table and click the Select button.

An exclamation mark next to an IP Address indicates that the controller is not reachable on the network. After assigning IP addresses on Microsoft Windows, a controller is often temporarily unavailable because the ARP/neighbor cache takes several seconds to update. Wait 60 seconds and click the Search button to check again for availability.

Selected Addresses

The Selected Addresses item holds all connections available to GDK's tools. Selected addresses are chosen from the Available Addresses item. A manual address entry feature is also provided.

Addresses selected in one session are persisted to the next time GDK launches. See the settings dialog to disable this feature.

Two addresses ready for connection to GDK tools.

Use the Available Addresses item to select controllers from the list of controllers that GDK finds.

Each selected address is displayed as a frame with various user interface elements.

A selected address frame showing Baud Rate for a serial connection.

The first element in the frame is a reconnect button. Use this button to reconnect all tools connected to this address. Click the downward arrow for more options including disconnecting and connecting all tools using this address.

The second element in the frame is a printout of the address Alias.

What is a GDK Alias?

Full addresses are referenced throughout GDK by their Alias. An Alias is a nickname used to refer to an address. GDK will choose a generic alias for an address, but it may be helpful to change the Alias of an address to fit the application. A descriptive Alias such as Conveyor, Gantry, or Web Tensioner makes a tool's connection clearer, especially in applciations employing several Galil controllers.

To view additional connection settings, click the More settings button to expand the frame.

An expanded address frame showing extra settings.

The following is a full list of available settings.

  • Alias edit box. Type a new Alias name and hit Enter/Return to update.
  • Address edit box. To change the simple address. Use Options for GOpen() switches.
  • Direct Connection checkbox. Check this box to connect directly with GDK's libraries instead of connecting through gcaps.
  • Options. Set additional GOpen() options. This setting is used for troubleshooting and debugging. Click the Options hyperlink to bring up a browswer window with GOpen()'s switches. Note: GDK tools may append further connection options to the options listed here. For example, the Scope adds --subscribe DR so that it receives data records from the hardware.
  • Baud Rate. Only present for serial connections.

To remove a selected address, click the "Remove address" button.

At the bottom of the Selected Addresses item are a number of buttons to operate on the selected addresses.

Use the global connect button to reconnect, connect, and disconnect all tools open in GDK.

To manually add a selected address, click the "Add address manually" button.

To remove all selected addresses, click the "Remove all selected addresses" button.

To list all selected addresses in a tabular format, click the "List full addresses" button. Note: GDK tools may append connection options to the listed base address. For example, the Scope adds --subscribe DR so that it receives data records from the hardware.

Open Tools

The Open Tools item consists of an always-visible, vertical, toolbar for lanching new tools, and a drawer item for listing and interacting with the currently open tools and loading saved tool layouts.

The vertical toolbar is always visible in the GDK window. The Open Tools item in the GDK Manager drawer provides tool interaction.

Each open tool is displayed as a frame with the following user interface elements.

  • A tool icon designating the tool type.
  • The Alias of the connected tool.
  • Tool context, if applicable. E.G. General IO.
  • A close button to close the tool.

Hovering the mouse over a tool frame will bring the associated GDK tool to the front and provide a visible indicator. This is useful for locating the tool when using many tools in the central stack, docked, popped out, etc.

To close all open tools, click the "Remove all tools" button.

Tool Layouts

The Tool Layouts provides a way to save and load tool layouts.

  • Click the load layout button to load the layout currently listed in the menu. Currently open tools will be closed.
  • Click the Save current tool layout button to save the currently open tools to a layout. GDK will prompt for a layout name.
  • Click the Rename tool layout to change a layout's name. GDK will prompt for a new name.
  • Click the Delete tool layout button to remove the listed layout.

By default, GDK will automatically save the tool layout upon exit and will reload it when launched. See the Settings dialog to disable this feature.

The GDK Log

Status messages and errors are recorded in the log.

Log showing history of errors, status, and a current message in the main window status bar.

To clear all log messages, click the "Clear log messages" button.

To copy all log messages to the clipboard, click the "Copy log to clipboard" button. The log is copied in CSV format suitable for import into spreadsheets, etc.

The GDK Status Bar

All messages that are logged are also printed temporarily in the status bar at the bottom of the main GDK window. When the GDK manager is minimized to the toolbar, errors and status messages are still presented briefly in the status bar.

Tool Errors

When tools generate errors, an error indicator will be shown to the right of the alias link button at the top left corner of the tool. Click the error icon to view and clear the error(s). Errors are automatically cleared when the tool is connected.

The error indicator shown in the terminal tool. The popup menu is used to show the error text and to clear previous errors.