Support Portal

Installing the Zynstra POS client drivers

The Zynstra POS Client Drivers are part of the Zynstra Virtual POS solution.  They enable virtualized Point of Sale software running on the Zynstra server to access retail peripherals that are connected to remote computers and devices, such as POS terminals.  The POS Client Drivers are installed on a Zynstra server hosted Windows virtual machine running a third-party POS application such as NCR Advanced Store.

The POS Client Drivers support common retail peripherals connected using a range of common protocols, including:

  • USB devices (HID, serial and other classes, including vendor specific) - such as bar-code scanners, line displays and printers
  • Serial devices (RS232) - such as cheque readers
  • Motherboard integrated peripherals - such as cash drawers.

The following sections describe how to install and configure the Zynstra POS Client Drivers for use.  The driver installation can take place at any point during the installation of the POS virtual machine after the Windows operating system has been installed.

Installing the Zynstra USB Driver

This driver provides a Zynstra Custom VM with access to remotely connected USB devices.  It supports devices of any USB class using the USB 1.x or USB 2.0 protocols.

Step 1: Copy the installation media

Copy the USBIP_Installer32.msi file from the installation media onto the C: drive of the target Windows virtual machine.

Step 2: Install the MSI

Double-click the MSI file and follow the prompt to install the Zynstra USB Driver files. 

(The MSI file can also be installed automatically via a script using: msiexec /i USBIP_Installer32.msi /l logfile.txt /qn)

Step 3: Setup the software 

Once installed the driver and services can be setup by running the following from a command prompt:

cscript "C:\Program Files\Zynstra\USBIP\ServicesScript.js" install <model> <Ip address>

  • <Model> is either 'POS72XRT' or 'POS70XRT' depending upon the model of hardware register that the peripherals will be connected from.
  • <IP address> is the IP of the physical register

An example command is: cscript "C:\Program Files\Zynstra\USBIP\ServicesScript.js" install POS70XRT 192.0.2.11

 

Installing the Zynstra Cash Drawer Driver

This driver provides a Zynstra Custom VM with access to remotely connected cash drawer devices.  

The Zynstra Cash Drawer Driver is an OPOS Service Object conforming to version 1.14.1 of the UnifiedPOS Retail Peripheral Architecture specification.  It supports the integrated cash drawer interface of NCR 7616 (72XRT) and 7403 (70XRT) motherboards.

Step 1: Copy the installation media

Copy the CashDrawerInstaller32.msi file from the installation media onto the C: drive of the target Windows virtual machine 

Step 2: Install the MSI

Double-click the MSI file and follow the prompt to install the Zynstra Zynstra Cash Drawer Driver files. 

(The MSI file can be installed automatically via a script by running: msiexec /i CashDrawerInstaller32.msi /l logfile.txt /qn

Step 3: Setup the software

Once installed you need to enter the IP address of the physical register in the registry.

The registry key is 'HKEY_LOCAL_MACHINE\SOFTWARE\OLEforRetail\ServiceInfo\Zynstra' and the name of the value is 'hpos-ip'. 

The value will exist but with dummy data for the iP address. You need to enter in the actual IP address of the physical register

 

Installing serial (RS232) device support

No additional software or drivers need to be installed to provide access to serial (RS232) connected peripherals.


Configuring the retail POS application

Once the Zynstra POS Client Drivers are installed the POS application must be configured to use them.  These steps must take place after installation of the POS application.

The instructions below use the NCR Advanced Store application as an example.

Step 1: Enable the Cash Drawer OPOS Service Object

Edit the rcspos.ini file located in 'c:\program files\NCR\Advanced Store\POS\' and set the Cash Drawer entry to use the Zynstra driver:

[CashDrawer]
Enabled=Yes
Type=OPOS
DeviceName=ZynstraCashDrawer.0
Trace=0;RCSDrawer.log


Step 2: Configure Cheque Reader COM port settings

The cheque reader must be configured to use COM1 with the following serial port settings.  Edit the rcspos.ini file located in 'c:\program files\NCR\Advanced Store\POS\' and configure the following settings:

[ComPort1]
Baud=115200
Parity=N
Bits=8
StopBits=1

 

[CheckReader]
Enabled=Yes
Port=Com1


Step 3: Configure POS printer EdgePort settings

Use the EdgePort configuration utility to assign the POS printer serial port to an unused COM port.  Note that it is necessary to connect the POS printer to the hardware register associated with the POS virtual machine before the POS printer serial port will appear in the EdgePort configuration utility.

Step 4: Configure POS printer in RSM

Start the RSM application and edit the COM port for the POS Printer control object to use the COM port assigned in step 3.

Other optimizations

In order to optimize boot time of the POS virtual machine the NCR services for low level hardware must be disabled.  These services are not needed because they monitor and control physical hardware components that are not present in a virtualised environment.

Step 1: Disable NCR HAL

Start the Windows Device Manager and select 'Show hidden devices' from the View menu then navigate to the NCR HAL service under 'Non-Plug and Play Drivers' and disable the NCRHAL device.

Step 2: Disable NCR Bus

Start the Windows Device Manager and select 'Show hidden devices' from the View menu then navigate to the NCR Bus service under 'Non-Plug and Play Drivers' and disable the NCRBus device.

 

Was this article helpful? 0 out of 0 found this helpful
Have more questions? Submit a request