This page is a part of ReMapPro online Help Manual.
|6. Comport||< previous | content | next >|
You can start Comport by clicking on the Comport item in the ReMapPro Programs' folder (i.e., from the Start/Programs/ReMapPro menu):
The COMPORT dialog box will appear on your display:
Before you start a Comport session, you should first have Port settings and TCP/IP settings defined in a COM-Port tab. The COM-Port tab's header shows the COMx-Port pair (one serial-network data connection channel). One or more COM-Port tabs make up the COM-Port table. You can configure Comport for several serial ports at a time and associate each serial port with a different TCP/IP port either as a TCP/IP client or as a TCP/IP server. On how you can specify Port settings and TCP/IP settings, refer to section Configuring Comport.
To manage the COM-Port table, you can use the New and Delete buttons. By clicking the Save settings button, you can store the current COM-Port tab in the comport.dat file located in the home directory of ReMapPro.
You can launch the Comport session for the current COM-Port tab by using the Start button, and then you can Pause or Resume it. To make a COM-Port tab current, just click on its header.
This button opens a new COM-Port tab for you to configure a new connection channel configuration.
Removes the current COM-Port tab (that you see at the top of the window) from the COM-Port table (in the virtual memory).
This button starts all the connections that are specified in the COM-Port table.
This button stops all the connections that are running (i.e. started).
Stops all the started channels, disconnects all the established connections, and exits Comport.
This button is used to display the Statistics window to show the status information for each configured COM-Port pair (i.e. for all running sessions):
You can select a COM port and press the Monitor button to display the COM-port monitor window for the port and then watch its activity. (Refer to section Monitoring COM Ports below.)
The utility allows the user to display and print a list of all physical ports, redirected ports, and un-configured ports with their corresponding IP address and TCP port number plus an abbreviated description and port status.
You can press the Save List button to store the connection channel lines displayed in an ASCII file and then print it.
By clicking Column Headers you can sort information as desired.
Clicking the Advanced button will come up with the Advanced dialog box that lets you specify your preferences for all running connection channels:
By using the following check boxes, you can choose whether the COMPORT window will be on the desktop or hidden on the system taskbar:
Specifies to show the Comport icon on the system taskbar. With this icon, you can exit Comport, configure Comport (i.e. to display the COMPORT window), or display the Statistics window.
With the Show Icon on System Taskbar check box enabled, specifies to hide the COMPORT window from the desktop.
By using the following radio buttons, you can choose one of debug trace options you prefer:
Specifies that no debug data will be stored in the debug file shown.
Specifies to store brief debug information in the debug file shown.
Specifies to store full debug information in the debug file shown.
This button is used to display the Timeouts dialog box to show or set a number of timeout parameters for virtual serial ports:
When you press Start the values you specify in this dialog box will begin to take effect for all serial channels (and its ports) that you start.
Note that normally the Timeouts button appears dimmed. The SetTimeouts setting in the ini-file toggles its state.
The Default button is used to reset the timeout parameters to their default values.
By clicking OK, any new settings you make to the Timeouts dialog box will be saved and the dialog will be closed.
Cancel quits the dialog with no change.
According to the MSDN resources, the timeout parameters are used to set and query the time-out parameters for a communication device. The parameters determine the behavior of the software function operations (i.e. ReadFile and WriteFile) on the device.
Specifies the maximum acceptable time, in milliseconds, to elapse between the arrivals of two characters on the communication line. During a ReadFile operation, the time period begins when the first character is received. If the interval between the arrivals of any two characters exceeds this amount, the ReadFile operation is completed and any buffered data is returned. A value of zero indicates that interval time-outs are not used.
Specifies the multiplier, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is multiplied by the requested number of bytes to be read.
Specifies the constant, in milliseconds, used to calculate the total time-out period for read operations. For each read operation, this value is added to the product of the ReadTotalTimeoutMultiplier parameter and the requested number of bytes.
A value of zero for both the ReadTotalTimeoutMultiplier and ReadTotalTimeoutConstant parameters indicates that total time-outs are not used for read operations.
Specifies the multiplier, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is multiplied by the number of bytes to be written.
Specifies the constant, in milliseconds, used to calculate the total time-out period for write operations. For each write operation, this value is added to the product of the WriteTotalTimeoutMultiplier parameter and the number of bytes to be written.
A value of zero for both the WriteTotalTimeoutMultiplier and WriteTotalTimeoutConstant parameters indicates that total time-outs are not used for write operations.
If an application sets ReadIntervalTimeout and ReadTotalTimeoutMultiplier to MAXDWORD and sets ReadTotalTimeoutConstant to a value greater than zero and less than MAXDWORD, one of the following occurs when the ReadFile function is called:
1) If there are any characters in the input buffer, ReadFile returns immediately with the characters in the buffer.
2) If there are no characters in the input buffer, ReadFile waits until a character arrives and then returns immediately.
3) If no characters arrive within the time specified by ReadTotalTimeoutConstant, ReadFile times out.
You should enter the value of -1 as MAXDWORD in the timeout entry fields.
When you have a COM Port tab configured (i.e. the Ports settings and TCP/IP settings have correctly been made) you can start/stop/pause/resume the connection channel and watch its status and activity using Port monitor, Statistics, or Advanced buttons.
This field is used to display the status (stopped/started/paused/resumed) of the current connection channel (i.e. for the current COM Port tab you see at the top of the Comport window).
This button is used to store all settings you made in the current COM Port tab in the comport.dat file located in the installation directory.
There are some additional settings you can specify to customize Comport. They are described in section The "[COMPORT]" Section of the ini-file below.
Launches the Comport's session with the settings from the current COM-Port tab.
After you have specified the parameters that you would like to use, you can press Start to establish a connection between the serial port and the TCP/IP port. The button changes to Stop and vice versa.
If the current tab is set up as a TCP/IP client, Comport will immediately try to establish a connection to the specified remote server. If the server is not available, Comport will continually try to establish the connection until it is successful.
If the tab is set up as a TCP/IP server, Comport will wait in "Listen Mode" until a client establishes a connection to it.
Suspends Comport for the current COM-Port tab. The button changes to Resume and vice versa.
You can specify how Comport as a TCP/IP server will work for the following modes:
- "single client - multiple serial ports",
- "multiple clients - single serial port",
- "multiple clients - multiple serial ports".
If the Clients check box is off, then Comport allows only one network client (one that first connected to Comport) to interact with the redirected serial port. Other clients (connected to Comport) will wait until freeing the port.
If the Clients check box is selected, then Comport will in turn redirect the incoming data flow (i.e., received from each network client connected to Comport) to the serial port (intermixing as information goes). Also, when the serial port sends data to the network, Comport will in turn duplicate the outgoing data flow to each network client connected to Comport.
If the COM-ports check box is off, then Comport allows only one network client (one that first connected to Comport) to interact with all the redirected serial ports from the list. Other clients (connected to Comport) will wait until freeing a port. Comport will duplicate the incoming data flow (received from that network client) to all the serial ports in turn. Also, when the serial ports send data to the network, Comport will in turn redirect the outgoing data flow to that network client (intermixing as information goes).
If the COM-ports check box is selected, then Comport will give all the serial ports from the list to all clients connected to Comport (one free port to only one client).
This option is available for the server mode of Comport and with a single serial port redirected to a TCP/IP port.
If this check box is enabled, then the Comport's server will connect to a new client (if it detects one) disconnecting with the currently connected client.
|6. Comport||< previous | content | next >|
|Copyright © 1999 - 2007 LabtamTM Inc.|