Configuring the Device Manager File

This task uses the following file.

File name Folder
DeviceManager.xml Configuration folder
  • For a system with a 32-bit OS: %PROGRAMFILES%\NCR\AdvancedStore\POS\Configuration
  • For a system with a 64-bit OS: %PROGRAMFILES(X86)%\NCR\AdvancedStore\POS\Configuration

To configure the devices and peripherals in the DeviceManager.xml file, follow these steps:

  1. Open the DeviceManager.xml file.
  2. Scroll through the file and browse for the list of devices. The following table lists the default devices listed in the DeviceManager.xml file.
    Device nameDefault oposDeviceName
    ScannerNCRScanner.0
    PrinterAS.Printer.2
    Windows PrinterAS.Windows.Printer
    MsrNCRMSR.0
    PinPadNo description
    LineDisplayNCRLineDisplay.0
    MicrNCRMicr.0
    CashDrawerNCRCashDrawer.0
    StorageNCRHardTotals.0
    ToneNCRToneIndicator.0
    Note

    The default oposDeviceName represents the initial POS configurations in the DeviceManager.xml file after the POS application is installed.

  3. Use the following table to configure the attribute values.
    AttributeDescription
    NameIndicates the name of the device referenced by the application.
    Type

    Identifies the type of device. Use one of the following valid values:

    • Proxy
    • Opos
    • Simulate
    • SimpleFilePrinter
    oposDeviceName

    Identifies the name of the configured OPOS device.

    Ensure that this name matches the profile name for the device in the RSM tool.

    Note

    Ensure that this name matches the profile name for the device in the RSM tool.

    Example

    If the printer profile created in the RSM Tool uses the Profile Name NCRScanner.7872, modify the default value of the oposDeviceName of the printer device into NCRScanner.7872.

    TerminatorDefines the name of the termination key that is returned with any input data from the device.
    EnabledBy default, the value is set to true. This value indicates that the device is set to be enabled when opened. Enabling the device permits input to be received from that device. If the device is not enabled but its termination key is valid for the current view, the device becomes enabled while at the current view.
    optionalDeviceBy default, the value is set to true. This value indicates that this device is not needed in order to run the application. If a device is not optional and it is not successfully opened, the platform throws an exception.
    runOnMainThreadBy default, the value is set to false. This value indicates that this control runs only if it is started on the main application thread. This should only be set to true if the Service Object control requires this control; otherwise, the application performance can be affected.
    allowBufferingBy default, the value is set to true. This value indicates that date for this device can be stored in the input manager until such a time that it is required.
  4. Configure the attribute values as required.
  5. To enable a Windows printer for HTML reports, remove the comments from the line for the AS.Windows.Printer device, as in the following example:
    Example

    <!-- ** Printer - Windows Printer ** -->
    <Device name="AS.Windows.Printer" ofmCreationClassName="AsWindowsPrinter" terminator="SlipIn"/>

    Note

    The Use Default Printer for Reports parameter determines if the Windows default printer will always be used to print HTML reports. For more information, refer to Local Customization.

  6. Save the file.

Simulated Devices

The POS application can be configured to enable simulated devices for the peripherals, such as the printer, scanner, or cash drawer. The DeviceSimulator.xml file configures the Device Simulator application. To configure the simulated devices, open the DeviceSimulator.xml file.

This task uses the following file.

File name Folder
DeviceSimulator.xml Configuration folder
  • For a system with a 32-bit OS: %PROGRAMFILES%\NCR\AdvancedStore\POS\Configuration
  • For a system with a 64-bit OS: %PROGRAMFILES(X86)%\NCR\AdvancedStore\POS\Configuration