IonPort.ini is an optional text file used to preconfigure EdgePort variables before installation. It must be placed in the Windows System32 folder. IonPort.ini settings are ignored after an EdgePort(s) installation. Use the EdgePort Configuration Utility to change settings after EdgePort has been installed.
IonPort.ini consists of sections in which variables are defined. A section begins with a section header and extends to the next section header or the end of the file.
This is the format of a section header:
[sectionname]
This is the format of a variable definition:
variable = value
where variable is a system-defined variable that pertains to the section that its located. value is either a string or a decimal number. Each variable must be defined on a separate line.
Comments are also allowed. The first non-space character of a comment line must be a semicolon (“;”). Spaces are allowed between tokens.
There are two section types: a “General” section and serial port section(s). These two types of sections are defined below.
The optional General section defines variables that apply to all EdgePorts. Currently the only the BOOLEAN ComMappingBasedOnUsbPort can be defined in the General section. If omitted, ComMappingBasedOnUsbPort defaults to 0.
Example:
[General]
ComMappingBasedOnUsbPort = 1
A serial port section defines variables that apply to an EdgePort serial port. The format of the serial port section header is:
[ EpInstance:x]
or
[ default]
where EpInstance represents the EdgePort instance and x is the serial port number starting with 1. If “ComMappingBasedOnUsbPort” is 0, EpInstance is EdgePort’s serial number. If “ComMappingBasedOnUsbPort” is 1 EpInstance is the Usb Port to which EdgePort is attached. (See “IonPort.ini samples”.)
The variables defined in the optional [default] section apply to any serial port without a matching specific section. Note that “PortName” variable should never be included in this section.
A table that describes the serial port variables is shown below. These variables are all optional. Users will typically only define “PortName” and leave the other variables defaulted.
Serial Port variables:
|
Serial Port Variable |
Type |
Description |
Example |
|
PortName |
String |
PortName defines the serial port name in COMx format. |
PortName = COM4 |
|
LowLatency |
Flag |
Rarely used. Contact tech support for details. |
LowLatency = 0 |
|
RemapBaud |
Flag |
Rarely used. Contact tech support for details. |
RemapBaud = 1 |
|
IgnoreFlush |
Flag |
Rarely used. Contact tech support for details. |
IgnoreFlush = 1 |
|
FastWrites |
Flag |
Rarely used. Contact tech support for details. |
FastWrites = 0 |
|
DisablePnP |
Flag |
Rarely used. Contact tech support for details. |
DisablePnP = 0 |
|
FastReads |
Flag |
Rarely used. Contact tech support for details. |
FastReads = 1 |
|
IgnoreTxFlush |
Flag |
Rarely used. Contact tech support for details. |
IgnoreTxFlush = 1 |
A sample ionport.ini is shown below which maps ports 1 and 2 of an EdgePort/2 to COM3 and COM4 respectively. The EdgePort/2 is identified by its Usb Port of Port-12.
[General]
ComMappingBasedOnUsbPort = 1
; this section defines config for 1st serial port of EP/2 located at USB Port “12”
[Port-12:1]
PortName = COM3
; this section defines config for 2nd serial port of EP/2 located at USB Port “12”
[Port-12:2]
PortName = COM4
;this section preconfigures FastReads variable to 1 for all unspecified com ports.
[default]
FastReads = 1
Here’s another sample ionport.ini in which ComMappingBasedOnUsbPort is 0. It’s unlikely that a user would want set ComMappingBasedOnUsbPort to 0 since it limits EdgePort configurations to only the EdgePort with the matching serial number.
[General]
ComMappingBasedOnUsbPort = 0
; This section defines configuration for the 1st serial port of EP/2 with
; serial number V22651684-0
[V22651684-0:1]
PortName = COM3
; This section defines configuration for the 2nd serial port of EP/2 with
; serial number V22651684-0
[V22651684-0:2]
PortName = COM4
The EdgePort coinstaller ignore ionport.ini if there are any errors and will log a message to ionport.log which will be located in the system32 subdirectory.