Skip to content
Technical guide

Installing an OPOS driver and declaring it in point-of-sale software

Have ready: An administrator account on the Windows station, the Service Object published by the device manufacturer, and the logical name the client’s software expects.

An OPOS driver installs in two stages: the manufacturer’s Service Object, then registering the device under a logical name. The software never calls the device directly: it opens that logical name. A misspelled name is the most common cause of a “device not found” error.

Level: integration

Procedure

  1. Confirm the client’s software speaks OPOS

    Plenty of software drives a printer through ESC/POS or the Windows print driver, without OPOS at all. Installing an OPOS layer nobody uses adds a component to maintain, with no benefit.

  2. Download the Service Object from the manufacturer

    The Service Object is specific to the device and to its firmware version. Download it only from the manufacturer’s own site for that model, and record the installed version in the station’s file.

  3. Install the common control objects before the Service Object

    The OPOS architecture layers common control objects under a per-device Service Object. Installing the second without the first produces a registration error on the first call, often hard to trace back to its cause.

  4. Register the device under a logical name

    The manufacturer’s utility creates the entry and picks the port. Enter the logical name the client’s software requires, exactly as given: it is an exact string, case-sensitive in most implementations. Copy it directly from the vendor’s documentation.

  5. Test with the utility before opening the software

    The manufacturer’s test tool opens the logical name and triggers a print or a drawer kick. If it fails, the problem is in the OPOS install. If it succeeds, the problem is in the software’s configuration.

  6. Declare the logical name in the client’s software

    Paste the exact string into the software’s settings, restart the service or the application, then replay a full transaction. Record the name used: it is the first thing a colleague taking over the station will need.

Check these before calling support

  • The manufacturer’s test tool opens the logical name without error, with the till software closed.
  • The logical name is written identically in the utility and in the software.

Useful terms

  • OPOS

    OPOS is the Windows implementation of the UnifiedPOS standard: a driver layer that exposes a point-of-sale device to a Windows application under a logical name, always the same way..

  • UnifiedPOS (UPOS)

    UnifiedPOS is the application interface specification for point-of-sale devices, maintained by the Object Management Group (OMG).

  • Driver and firmware

    The driver is the software that lets a device talk to the operating system; the firmware is the software embedded in the device itself.

  • JavaPOS

    JavaPOS is the Java implementation of the UnifiedPOS standard.

Related guides

Sources

Guide revised on

Reseller program

Open a reseller account

The account is free and reserved for businesses. It gives you access to our wholesale prices, training and technical support.