Configuration Presets

<< Click to Display Table of Contents >>

Navigation:  Serial/IP COM Port Redirector User Guide > Using the Redirector >

 

Configuration Presets

Previous pageReturn to chapter overview

 

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                

 

 

 

© 2017 Tactical Software, LLC.