4.3 Salesware .INI Settings Reference : Ports .INI settings table
 
Ports .INI settings table
 
This section presents a single large table that lists and describes all of the ports.INI settings, which are used to configure the cash drawers, customer (pole) displays and change dispensers at a salespoint. This file is located in the Sales folder.
 
ports.INI
.INI Setting
Typical values
Default
Description
[Acceptor]
AcceptorType
Bill acceptor dependent
 
Denotes the type of Bill acceptor used in Kiosk transactions
 
[Primary]
PopThruPrinter
TRUE
TRUE
Sets communications path used by software for sending pop codes to primary cash drawer. Set to TRUE if cash drawer is connected through a receipt printer. Set to FALSE if cash drawer is connected to a serial port.
 
[Primary]
PrinterName
CASHDRAWER
“” (empty string)
Sets the name given to the cash drawer in the Windows printer control panel. If the cash drawer is connected to a printer, this is the name of the printer.
 
[Primary]
PopThruPort
FALSE
TRUE
Sets communications path used by software for sending pop codes to primary cash drawer. Set to TRUE if cash drawer is connected through a serial port. Set to FALSE if cash drawer is connected to a printer.
 
[Primary]
ComPort
1
0
Sets the serial communications port to which the primary cash drawer is connected. Valid numbers are determined by the number of serial ports installed on the computer. Only valid if PopThruPort=TRUE.
 
[Primary]
BaudRate
9600
9600
Sets the comm port baud rate for the primary cash drawer. Only valid if PopThruPort=TRUE.
 
[Primary]
Parity
N
N
Sets the comm port parity for the primary cash drawer. Only valid if PopThruPort=TRUE.
 
[Primary]
DataBits
8
8
Sets the comm port data bit rate for the primary cash drawer. Only valid if PopThruPort=TRUE.
 
[Primary]
StopBits
1
1
Sets the comm port stop bit for the primary cash drawer. Only valid if PopThruPort=TRUE.
 
[Primary]
SendChars
TRUE
FALSE
Instructs the software to send the pop code characters that follow this setting. Usually set to TRUE. May be set to FALSE with some cash drawers that pop thru the printer.
 
[Primary]
Char1
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
Char1=027 - Sends the ESC command, this is required to send any further command to the printer
 
[Primary]
Char2
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
Char2=112 - Actual drawer pop command
 
[Primary]
Char3
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
Char3=048 - Drawer kick out physical connecter.  Pin 2 can be values 0 or 48, pin 5 values can be 1 or 49
 
[Primary]
Char4
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
Char4=100 - Drawer on pulse time
 
[Primary]
Char5
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
Char5=080 - Drawer off pulse time
 
[Primary]
Char6
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Primary]
Domestic
TRUE/
FALSE, YES/NO, ON/OFF, 1/0
FALSE
Used to cause the domestic cash drawer to pop automatically without choosing from a prompt, depending on what currency was tendered. If Domestic=TRUE for a drawer, then that drawer pops if and only if there is a payment in the sale without an exchange rate. If [Preferences] ChargeDrawerPop=FALSE in Sales32c.INI, this setting is also still respected. If either Domestic or Foreign is TRUE for any drawer that is in use, the logic is used for popping drawers. If Domestic and Foreign are FALSE for both drawers, then there is no change in functionality from normal.
 
[Primary]
Foreign
TRUE/
FALSE, YES/NO, ON/OFF, 1/0
FALSE
Used to cause the foreign cash drawer to pop automatically without choosing from a prompt, depending on what currency was tendered. If Foreign=TRUE for a drawer, then that drawer pops if and only if there is a payment in the sale with an exchange rate. If [Preferences] ChargeDrawerPop=FALSE in Sales32c.INI, this setting is also still respected. If either Domestic or Foreign is TRUE for any drawer that is in use, the logic is used for popping drawers. If Domestic and Foreign are FALSE for both drawers, then there is no change in functionality from normal.
 
[Secondary]
PopThruPrinter
FALSE
TRUE
Sets communications path used by software for sending pop codes to secondary cash drawer. Set to TRUE if cash drawer is connected through a receipt printer. Set to FALSE if cash drawer is connected to a serial port.
 
[Secondary]
PrinterName
FALSE
“” (empty string)
Sets the name given to the cash drawer in the Windows printer control panel.
 
[Secondary]
PopThruPort
FALSE
TRUE
Sets communications path used by software for sending pop codes to secondary cash drawer. Set to TRUE if cash drawer is connected through a serial port. Set to FALSE if cash drawer is connected to a printer.
 
[Secondary]
ComPort
0
0
Sets the serial communications port to which the secondary cash drawer is connected. Valid numbers are determined by the number of serial ports installed on the computer. Only valid if PopThruPort=TRUE.
 
[Secondary]
BaudRate
9600
9600
Sets the comm port baud rate for the secondary cash drawer. Only valid if PopThruPort=TRUE.
 
[Secondary]
Parity
N
N
Sets the comm port parity for the secondary cash drawer. Only valid if PopThruPort=TRUE.
 
[Secondary]
DataBits
8
8
Sets the comm port data bit rate for the secondary cash drawer. Only valid if PopThruPort=TRUE.
 
[Secondary]
StopBits
1
1
Sets the comm port stop bit for the secondary cash drawer. Only valid if PopThruPort=TRUE.
 
[Secondary]
SendChars
FALSE
FALSE
Instructs the software to send the pop code characters that follow this setting. Usually set to TRUE. May be set to FALSE with some cash drawers that pop thru the printer.
 
[Secondary]
Char1
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Char2
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Char3
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Char4
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Char5
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Char6
Printer brand dependent
0
Pop code character sent by printer to trigger primary cash drawer release. Some cash drawers may require up to five characters to successfully open. Each brand of printer has unique codes. Only valid if SendChars=TRUE.
 
[Secondary]
Domestic
TRUE/
FALSE, YES/NO, ON/OFF, 1/0
FALSE
Used to cause the domestic cash drawer to pop automatically without choosing from a prompt, depending on what currency was tendered. If Domestic=TRUE for a drawer, then that drawer pops if and only if there is a payment in the sale without an exchange rate. If [Preferences] ChargeDrawerPop=FALSE in Sales32c.INI, this setting is also still respected. If either Domestic or Foreign is TRUE for any drawer that is in use, the logic is used for popping drawers. If Domestic and Foreign are FALSE for both drawers, then there is no change in functionality from normal.
 
[Secondary]
Foreign
TRUE/
FALSE, YES/NO, ON/OFF, 1/0
FALSE
Used to cause the foreign cash drawer to pop automatically without choosing from a prompt, depending on what currency was tendered. If Foreign=TRUE for a drawer, then that drawer pops if and only if there is a payment in the sale with an exchange rate. If [Preferences] ChargeDrawerPop=FALSE in Sales32c.INI, this setting is also still respected. If either Domestic or Foreign is TRUE for any drawer that is in use, the logic is used for popping drawers. If Domestic and Foreign are FALSE for both drawers, then there is no change in functionality from normal.
 
[Pole]
PoleDisplay
TRUE
FALSE
Informs the software that a pole display is present. Set to TRUE if a pole display is present. Set to FALSE if no display is present.
 
[Pole]
ComPort
4
0
Sets the serial communications port to which the coin dispenser is connected. Valid numbers are determined by the number of serial ports installed on the computer. Only valid if PoleDisplay=TRUE.
 
[Pole]
BaudRate
9600
9600
Sets the com port baud rate for the customer pole display. Only valid if PoleDisplay=TRUE.
 
[Pole]
Parity
N
N
Sets the comm port parity for the customer pole display. Only valid if PoleDisplay=TRUE.
 
[Pole]
DataBits
8
8
Sets the comm port data bit rate for the customer pole display. Only valid if PoleDisplay=TRUE.
 
[Pole]
StopBits
1
1
Sets the comm port stop bits for the customer pole display. Only valid if PoleDisplay=TRUE.
 
[Pole]
PoleType
1
0
Informs the software about what type of customer pole display is attached. 0 is for a Birch brand display. 1 is for a Logic Controls brand display and other OPOS compliant displays. 2 is for Epson emulation. Only valid if PoleDisplay=TRUE.
 
[Dispenser]
UseDispense
TRUE
FALSE
Informs the software that a Telequip Transact 2+ coin dispenser is present. Set to TRUE if a coin dispenser is present. Set to FALSE if no coin dispenser is present.
 
[Dispenser]
ComPort
1
0
Sets the serial communications port to which the coin dispenser is connected. Valid numbers are determined by the number of serial ports installed on the computer. Only valid if UseDispenser=TRUE.
 
[Dispenser]
BaudRate
9600
9600
Sets the comm port baud rate for the coin dispenser. Only valid if UseDispenser=TRUE.
 
[Dispenser]
Parity
E
E
Sets the comm port parity for the coin dispenser. Use E for Telequip Transact 2+ dispenser. Only valid if UseDispenser=TRUE.
 
[Dispenser]
DataBits
7
7
Sets the comm port data bits for the coin dispenser. Set to 7 for the Telequip Transact 2+ dispenser. Only valid if UseDispenser=TRUE.
 
[Dispenser]
StopBits
1
1
Sets the com port stop bits for the coin dispenser. Only valid if UseDispenser=TRUE.
 
[Scale]
Retail
UseScale
TRUE/FALSE
Sales now supports the Salter Brecknell Series 200 floor scale. The following is necessary in Ports.INI
 
[Scale]
UseScale=TRUE
ScaleType=SalterBrecknell
ComPort=1
Timeout=3000
BaudRate=9600
DataBits=8
StopBits=1
Parity=None
 
ScaleType is either Avery or SalterBrecknell. If it's not specified, it's assumed to be Avery.
 
The NumUnits and UnitID fields have been added to the AllTrans table and can be used in a Details statement for printing the weight and weight units on a receipt when using a scale. Additionally, the transact, tr_save, and units tables are synced in the Details method.
 
[SmartPrinter]
Port
Port # of printer connection
0
Code was added for the integration with the Axess printer. To enable the printer, the following setting must be added to the ports.INI file:
 
[SmartPrinter]
Port=0 <COM Port to which the printer is connected>
POS=0 <Point-of-Sale number provided by Axess>
Project=0 <Project number provided by Axess>
 
[SmartPrinter]
POS
Axess # for the Point-of-Sale
0
Code was added for the integration with the Axess printer. To enable the printer, the following setting must be added to the ports.INI file:
 
[SmartPrinter]
Port=0 <COM Port to which the printer is connected>
POS=0 <Point-of-Sale number provided by Axess>
Project=0 <Project number provided by Axess>
 
[SmartPrinter]
Project
Axess # of the project
0
Code was added for the integration with the Axess printer. To enable the printer, the following setting must be added to the ports.INI file:
 
[SmartPrinter]
Port=0 <COM Port to which the printer is connected>
POS=0 <Point-of-Sale number provided by Axess>
Project=0 <Project number provided by Axess>
 
[SmartPrinter]
Type
2 or 6
2
Sales will respect the new setting [SmartPrinter] Type=2 (or 6) in the Ports.INI. A Type 2 (which is the default) is the Axess Smart Printer and a Type 6 is the Axess Smart Reader (Encoder). If the device type is set incorrectly in the Ports.INI based on the hardware connected, the print (encode) jobs will fail.