OPOS Manager

Content

• Introduction

• Installation

• Configuration

• Testing Cash Drawer

• Testing MSR

• Testing Line Display

• Testing POS Printer

• Testing Scanner

• Return Code Table

Introduction

OPOS Manager is a setup utility for registering, modifying, or deleting devices and port environments of Advantech OPOS drivers to the system registry.

The content contains an outline of the installation and demo application for OPOS drivers.

OPOS Install Revision History

Device name mapping table

Installation

OPOS Driver

1. Double click an application: OEM OPOS Setup on desktop for installation.
2. Default is selected all components.

1. Click Install.

1. Click Finish to exit the setup wizard.

Cash Drawer Driver

Cash Drawer Driver, please Install the corresponding file according to the host board Cash Drawer GPIO Pin define.

1. Double click an application: CashDrawer Driver For UPOS-XXX.exe on desktop for installation.

1. Click Install.

1. Click Finish on the Completing installation screen. A system restart is required to complete the installation.

Configuration

Launch this OPOS-Manager-Tool Properties icon on desktop.

The OPOS-Manage-Tool has been configured six types of OPOS devices, allows you to modify Cash Drawer, MSR, Printer, Line Display, Keylock, and Scanner.

1. When you select the item i.e. Cash Drawer from the Device Class listbox, its available devices appear as shown below. Choose the device what is right pane, and then click on OPOS Driver Configuration.

1. A dialog with Cash Drawer Control is appearing for add/ remove the device, and create Logical Device Name (LDN).

Testing Cash Drawer

1. Click Cash Drawer Demo.

1. Select the Select Device from the drop-down list, and then click on Open, Claim, and Enable.

1. Click Open Drawer, the cash drawer is opening and the following dialog will be shown 'OPOS_SUCCESS' status messages.

Testing MSR

Please check the Windows operating system package is upgrading to KB4482887 if the IDTECH MSR does not work.

1. Click MSR Demo.

1. Select the Select Device from the drop-down list, and then click on Open, Claim, and Enable.

1. When one swipes a valid card with the MSR device, the following dialog will be shown 'OPOS_SUCCESS' status messages.

Note:

When you use OPOS driver, please follow below table to setup Header and Footer for each device and confirm them with vendor utility.

• Advantech MSR

Track	Header information	Footer information
1	“%”	“?”
2	“;”	“?”
3	“+”	“?”

Testing Line Display

1. Click Line Display Demo.

1. Select the Select Device from drop-down list, and then click Settings.

1. Set COM Port , Baud Rate , and Code Page. Click OK to return to the previous screen.

1. Select the Select Device from drop-down list, and then click Open, Claim, Enable, and Display. The following dialog will be shown 'OPOS_SUCCESS' status messages and Line display is shown the text.

Testing POS Printer

• TP 32XX Printer Port Type Setting

1. Connect a RS232 serial cable/ USB cable to TP32XX.

2. Find the device's serial number/ USB in Windows's device manager.

3. Select the POSPrinter device from below list, and then click OPOS Driver Configuration.

4. Select the Select Device from drop-down list, and then click Settings.

1. Select TP32X0_01 and click Modify Printer that set USB or COM port for port types. Click OK to complete setup.

1. Click Printer Demo for testing

   
2. Select Device Name to ‘TP 32XX_01
3. Click "Open -> Close”, “Claim->Release”, “Enable->Disable"

4. Click Print Text Button.

5. Check the printer printing results If you got error message dialog, please check the connection or device driver

Testing Scanner

• Newland scanner setting

1. Click Scanner Demo.

2. Select the Scanner device from below list, and then click OPOS Driver Configuration.

3. Select the Check Device from drop-down list, and then click Settings.

4. Click "EnumDevice" to list installed scanners. Note: "NLScanner" is the default value and cannot be modified

1. Select Scanner ID and AUTO-USB Type. Success message pop-up after from AddDevice button clicked.

1. You can rename the device, please follow below steps to do that.

1. Renamed.

• Newlan scanner test

1. Click Scanner Demo.

2. Select the Scanner Device Name from drop-down list, and then click Open, Claim, and Enable.

3. It is shown current raw data and data label after scanner got a barcode.

Return Code List

The Control notification result, please refer the tables below for the ResultCode Property values and the OpenResult Property values.

ResultCode	Value
OPOS_SUCCESS	0
OPOS_E_CLOSED	101
OPOS_E_CLAIMED	102
OPOS_E_NOTCLAIMED	103
OPOS_E_NOSERVICE	104
OPOS_E_DISABLED	105
OPOS_E_ILLEGAL	106
OPOS_E_NOHARDWARE	107
OPOS_E_OFFLINE	108
OPOS_E_NOEXIST	109
OPOS_E_EXISTS	110
OPOS_E_FAILURE	111
OPOS_E_TIMEOUT	112
OPOS_E_BUSY	113
OPOS_E_EXTENDED	114

OpenResult	Value
OPOS_OR_ALREADYOPEN	301
OPOS_OR_REGBADNAM	302
OPOS_OR_REGPROGID	303
OPOS_OR_CREATE	304
OPOS_OR_BADIF	305
OPOS_OR_FAILEDOPEN	306
OPOS_OR_BADVERSION	307
OPOS_ORS_NOPORT	401
OPOS_ORS_NOTSUPPORTED	402
OPOS_ORS_CONFIG	403
OPOS_ORS_SPECIFIC	450
OPOS_ORS_BADCO	451
OPOS_ORS_RESOURCEFAIL	452
OPOS_ORS_ALREADYOPENED	453

Please refer the tables below for Return code definition.