1.OCX CCI Function Commands via Function Calls

•SAMLight can be controlled by a CCI application running on the same PC:

•SAMLight → Settings → System → Remote → Function Calls must be enabled.

•The client application can use all Function commands, see DLL Commands.

2.OCX CCI Function commands via TCP

•SAMLight can be controlled by a CCI application running on a different PC. The SAM DLL (included in the SAMLight installer must be installed on the remote controlling PC, meaning that both system need to be a Windows PC.

•Both Windows PCs are connected via TCP (Ethernet).

•SAMLight → Settings → System → Remote:

oTCP must be enabled.

oIP Address must be one of the available IP addresses of the PC on which SAMLight is running and is independent of the IP of the sender of the CCI commands. Use 0.0.0.0 to allow remote control from any IP or 127.0.0.1 for local host.

•The client application can use all Function commands, see DLL Commands.

•If MultiInstance is used with two or more instances of SAMLight which should be controlled by one CCI application, different TCP connections (127.0.0.1, different Ports) have to be set in every instance of SAMLight together with two or more SAMLight Client Control OCX with different names in the CCI application. If just one TCP connection is closed by ScCloseEthernetConnection(), then TCP mode is also getting disabled and CCI switches to function call mode, which could lead to incorrect CCI function return values. So it is better to close all TCP connection and eventually reopen them all again.

•Client Control has to be initialized at a STAThread. Otherwise windows will create a temporary STAThread, which will be closed automatically after 5 minutes.

Steps for the custom program to use OCX (ActiveX) CCI:

•Initialize COM

•Instantiate ActiveX control SCAPS.ScSamlightClientCtrl

•If TCP, connect via ScOpenTCPConnection

•Call desired functions

Figure 1 illustrates how to use SCAPS.ScSamlightClientCtrl with Microsoft Visual Studio: This SAMLight Client Control implementation is simply linked via drag and drop of the SAMLight Client Control ocx onto the form of the SAMLight Client Control application.

Please start at the Toolbox at the right hand side and follow the red arrows.

The possible return values of the SAMLight Client Control function calls are normally just 0 or 1, but can also be a long, double or string value.

With the CCI command NewCciErrorReturn the extended error mode can be enabled. Possible function error return values for more detailed error analysis are: