<< Click to Display Table of Contents >> Configuration Presets |
|
Presets Description
Commonly used configurations for COM ports can be specified in an optional Presets file that contains predefined, named settings for virtual COM port options. The Presets file is a convenient way to manage settings that may need to be changed frequently.
Rather than retyping an IP address, the TCP port number, and the other configuration settings, a user can simply select them from the Presets drop-down list in the Serial/IP Control Panel.
The names of available presets will appear in a drop-down list named Presets in the Serial/IP Control Panel. If an entry is selected, then all virtual COM port settings that are specified by that entry will be applied to the currently selected virtual COM port.
The Presets drop-down list will only appear in the Serial/IP Control Panel if a presets.txt file already exists when the Serial/IP Control Panel starts.
Presets will be available for virtual COM port settings, but not for Advanced Options, as they apply to all COM ports. For security reasons, Presets do not include credential information.
The settings can also be changed directly at run-time by an application that is using the Configuration API.
Configuration may be automated during installation by using the Unattended Installation feature.
Presets Location
The Presets file is named presets.txt, and is located in the Serial/IP software installation folder:
C:\Program Files\Tactical Software\SerialIP\ (for x86 PCs),
or
C:\Program Files (x86)\Tactical Software\SerialIP\ (for x64 PCs).
The location of the presets file can be modified by changing the Windows registry entry PresetsFileSpec (a REG_SZ) in:
HKEY_LOCAL_MACHINE/Software/Tactical Software/SerialIP/4.0/ (for x86 PCs),
or
HKEY_LOCAL_MACHINE/Software/Wow6432Node/Tactical Software/SerialIP/4.0/ (for x64 PCs).
This will allow a Presets file to be used as a shared file for multiple users.
Entry Format
The presets.txt file is a text file that contains one or more preset entries. Each entry is on a single line, and consists of a label that is followed by one or more settings.
All entries should have the same format. The fields must appear in the order given below:
<Label>,<IP Address>,<Port Number>,<Inbound Port Number>,<Auth Option>,<Connection Protocol>,<COM Port Options>
No extra spaces are allowed, except within the Label field.
Examples
Server 1,10.0.0.251,7000,noauth
Server 2,10.0.0.252,7000,authwindows
Settings in Order of Use
Label
• | Value: text string (required) |
• | Description: The label to be used in the Presets drop-down list in the Serial/IP Control Panel. It may contain embedded spaces. It also appears in the Activity Panel of the Port Monitor. |
IP Address
• | Value: xxx.xxx.xxx.xxx or hostname (required) |
• | Description: IP Address of Server |
Port Number
• | Value: valid TCP port number (required) |
• | Description: Port Number |
Inbound Port Number
• | Value: valid TCP port number |
• | Description: Port Number for Accept Connections |
Auth Options
• | Value: noauth (default) |
• | Description: No Login Required |
• | Value: authloginprompt |
• | Description: Prompt at Login |
• | Value: authmanual |
• | Description: Use Credentials Below |
• | Value: authportopenprompt |
• | Description: Prompt on COM Port Open |
Connection Protocol
• | Value: telnet |
• | Description: Telnet |
• | Value: raw (default) |
• | Description: Raw TCP Connection |
COM Port Options
• | Value: dsr or dsrhigh |
• | Description: DSR Emulation set to Always High |
• | Value: dsrlow |
• | Description: DSR Emulation set to Always Low |
• | Value: dsrtrack |
• | Description: DSR Emulation set to Track Network Connection |
• | Value: nodsr (default) |
• | Description: DSR Emulation disabled |
• | Value: dcd or dcdhigh |
• | Description: DCD Emulation set to Always High |
• | Value: dcdlow |
• | Description: DCD Emulation set to Always Low |
• | Value: dcdtrack |
• | Description: DCD Emulation set to Track Network Connection |
• | Value: nodcd (default) |
• | Description: DCD Emulation disabled |
• | Value: cts or ctshigh |
• | Description: CTS Emulation set to Always High |
• | Value: ctslow |
• | Description: CTS Emulation set to Always Low |
• | Value: ctstrack |
• | Description: CTS Emulation set to Track Network Connection |
• | Value: nocts (default) |
• | Description: CTS Emulation disabled |
• | Value: dun |
• | Description: DTR is Modem Escape - enabled |
• | Value: nodun (default) |
• | Description: DTR is Modem Escape - disabled |
• | Value: reconnect |
• | Description: Restore Failed Connections - enabled |
• | Value: noreconnect (default) |
• | Description: Restore Failed Connections - disabled |