<< Click to Display Table of Contents > 

SAMLight Manual > Global Settings > Remote

Remote
Previous pageReturn to chapter overviewNext page

The settings for an external control are available in Menu bar → Settings → System → Remote:

remote_settings

Figure 64: Remote Settings Dialog

Connection Settings: Here it is possible to define the connection method that an external CCI application uses to access the scanner application.

Function Calls: This option is only achievable inside one PC. That option has to be chosen if the controlled software and the application that controls it via the client control interface are running at the same host.

TCP: If the program should be controlled over the network using the client control interface, this option has to be selected. Normally the TCP protocol should be used. Only one TCP connection can be established at the same time.

ASCII Communication Mode: If checkbox is activated it is not necessary to send the initialization string "SAM CCI Plain\n" to start SAMLight Client Control in ASCII communication mode. This is particularly helpful if SAMLight Client Control is always used in ASCII communication mode and also for testing and debugging your own SAMLight Client Control ASCII communication application.

Debug Output sc_cci_debug.txt: See further details at CCI Debug Log.

ASCII mode code page: For TCP ASCII Communication Mode normally the current used system code page of Windows is used to send the complete command string to SAMLight. If a different code page must be used to set or get text contents (especially relevant to set a text of a text entity in another language) you can select and set the required code page from the drop-down list. After a change of the code page the Apply button has to clicked.

Bind To:

IP Address: This is the IP address of the PC on which SAMLight is running. Here following values are possible:

·0.0.0.0 if the software has to be accessible from everywhere

·One of the host systems IPs if it uses more than one and if the software has to be accessible by only one specific IP (Depending on the setup of your local network, this should be something like 192.168.1.100. Please ask your system administrator for details.)

·127.0.0.1 if only local connections have to be accepted. This case is a more theoretical one and normally should be used for testing purposes only because for plain local connections the Function Calls option can be used.

Port: Number defines where the software has to be accessible. Here any value in the range of 1...65535 is possible, but it has to be noticed that a port can be used only once per IP. So for an example if there is already a web server running at a system, port number 80 cannot be used. Therefore it is recommended to use port numbers >1024. They are reserved for custom usage.

On the other hand the application that controls the software using the SCAPS.ScSamlightClientCtrl client control interface has to open its connection to the server socket configured here using ScOpenTCPConnection(). If the plain ASCII communication has to be used, opening of a TCP/IP connection depends on the operating system and the programming language. In C the appropriate function calls to do that mainly are socket() and connect(), for sending data send() is used and recv() for the reception of an answer.

The network access to the scanner application can be restricted to some specific IPs to avoid that connection attempts are successful from hosts that are not allowed to control the application. These IPs can be defined using the two files hosts.allow and hosts.deny that are located within <SCAPS>\system of the installation directory of the scanner application. Both files expect IP numbers in the format "WWWW.XXXX.YYYY.ZZZ".

Within hosts.allow all the IPs  that are allowed to connect to the scanner application can be listed. If there are some IP numbers define here, connections are allowed only from these ones exclusively. If there are no IPs defined, connections are allowed from all IPs except the ones that are listed within hosts.deny. The file hosts.deny can contain a list of IP numbers with the format "WWWW.XXXX.YYYY.ZZZ" and defines which hosts are not allowed to control the application. If there a no IPs listed within this file, no hosts are forbidden explicitly to connect to the scanner application.

Script Settings:  See further details at Script Settings