This article is about the connection of a ToolScope to the GUI of a windows computer via network.

KOMET Brinkhaus delivers an "Installation package" with the device. It contains the "ToolScope_Connector.exe" file with the corresponding "ToolScope_Connector.ini" file. These needs to be installed on the windows computer.

Copy the "ToolScope_Connector.exe" and "ToolScope_Connector.ini" files onto the Windows computer in a meaningful installation directory. However, the user must have sufficient rights for the folder and all folder on the path to it. If the user only have read rights, loading the configuration file will properly fail. There is an work around in the version 20170619 and newer, where a file named "useAppDataFolder.txt" needs to be created in the same folder as the "ToolScope_Connector.exe". Then the ToolScope Connector will copy the configuration files to a app data folder with enough permissions and will use it there.


Configure the ToolScope_Connector.ini

The "ToolScope_Connector.ini" contains information about the ToolScope IP and a couple of appearance options.

  • Behind "IP=", enter the ToolScope IP.  (example: "IP=")
  • Behind "Port=", enter the ToolScope Port if it runs multiply instances or got changed

The appearance  needs to be customized to the user and the Windows version.

  • DECORATE_WINDOW: Set it to 1 if the Windows should have a graphic border style
  • DEFINED_X: Set it to the start X position of the window
  • DEFINED_Y: Set it to the start Y position of the window
  • DEFINED_WIDTH: Set it to the width of the window. "-1" will use the width of the target ToolScope.
  • DEFINED_HEIGHT: Set it to the height of the window. "-1" will use the height of the target ToolScope.

There are other values for special cases, which should not be the case for this operating system.


Adjust ToolScope resolution to ToolScope Connector resolution

If the ToolScope Connectorshould have a defined resolution which the ToolScope can't be set to, then there is a way to changed this behaviour. The ToolScope can takeover the resolution of the ToolScope Connector's options. For this function are two steps necessary.

In the "ToolScope_Connector.ini" file, set the values for "SEND_SCREEN_LAYOUT_TO_TOOLSCOPE" to 1. Be care to not set this value for 2 clients connect to the same ToolScope. Otherwise the ToolScope cold endlessly change it resolution. Then go in the ToolScope to"Service" / "Settings" / "Display" / "Resolution", activate the option "Apply from the control panel". then the ToolScope Connector and the ToolScope must then be restarted.

Now the ToolScope will change its resolution to fit the ToolScope Connector. You can also work without this option. Then the ToolScope Connector tries to scale the picture, which does not look that good.


Example view of are running ToolScope Connector