Skip to main content

Install Self-Service XDMB (Android)

The following describes how to install the Self-Service DMB (XDMB) application on an Android device:


The following identifies the hardware and software requirements for the POS device:




Version 11 (or later)

Esper Foundation

Version (or later)


Intel(R) Celeron(R) J6412 2.60 GHz


Disconnect the Customer-Facing Display from the POS device BEFORE installing the XDMB app.

OCU Configuration

To setup and configure the Order Confirmation Unit (OCU) for the XDMB app, use the Peripherals and Terminals editors in Data Management.

Create OCU Peripheral

Xenial Portal Data Management Ordering Settings Hardware Peripherals

To create the OCU peripheral device:

  1. From the upper-right of the Peripherals area, select New Peripheral.

  2. From the Peripheral Type dropdown, select Order Confirmation Board.

  3. From the Peripheral Schema dropdown, select Order Confirmation Board.

  4. From the Connection Type dropdown, select LAN.

  5. Select Continue.

  6. Locate the Peripheral Type section.

    • Toggle Active to Active if the device is available for use at the site.

    • Multi-site users: To the right of the field, select the globe icon to define values for each site.

  7. Locate the Peripheral Configuration section.

    • In the Peripheral Name field, type a name for the device.

  8. Locate the Connection Configuration section.

    • In the IP field, type

    • In the Port field, type 22222.

  9. From the upper-right of the screen, select Save.

Assign OCU to Terminal

Xenial Portal Data Management Ordering Settings Hardware Terminals

To assign the OCU peripheral to a terminal:

  1. From the Terminal List homepage, select the terminal from the list.

  2. From the menu pane on the left, select Peripherals.

  3. From the Order Confirmation Board dropdown, select the specific OCU to assign to the terminal.

    • Multi-site users: To the right of the field, select the globe icon to define values for each site.

  4. To the right of the Order Confirmation Board field, select Filtered Destinations to identify the order destinations to display on the peripheral device.

    From the lower-right of the Destinations Filter window, select Done.

  5. From the upper-right of the screen, select Save.

Install the XDMB Application (Android)

To install the XDMB application on an Android device:

  1. Copy the APK file to a USB flash drive.

  2. Insert the USB flash drive into the POS device.

  3. From the POS device, run the APK file to launch the installation.

  4. From the confirmation prompt, select CONTINUE.

  5. From the installation prompt, select INSTALL.

  6. From the app installed prompt, select the desired option:

    • DONE - Finish the installation without launching the XDMB application.

    • OPEN - Finish the installation and launch the XDMB application.

Link Android Device to Display Layout

When XDMB launches for the first time on a device, a share code is required to link the device to a display layout on the Xenial Portal.

A share code is a unique 5-digit code that is generated for a specific site and its device. A share code cannot be used to link devices at more than one site.

To generate a share code for a site, see Generate Share Code.

To link an Android device to an XDMB display layout:

  1. Please wait for the XDMB App to launch on the device. When the device prompts for the share code, use the remote control for the device to enter the 5-digit code.

  2. After the share code is entered, the message "Validating Share Code" is displayed. Please wait while the code is validated.

  3. From the Select a Layout screen, select the desired display layout.

  4. From the Select a Display screen, select the desired display.

  5. After the layout and display selections are made, the message "Registering Device" is displayed. Please wait while the device is registered.

  6. Please wait while the XDMB content is downloaded and displayed on the screen.


    If a Display Layout has not yet been deployed, the following notification is displayed:

    "The <Name of Display> is successfully connected. No content is assigned."

  7. Shut down the XDMB App on the device.


    To shutdown the XDMB App:

    1. Open the Recent Apps list.

    2. Locate the XDMB app.

    3. Swipe the XDMB app off the screen.

  8. Connect the Order Confirmation Unit (OCU) to the device using a FeDP/FeDP cable.

  9. Launch the XDMB App on the device. Now the XDMB content should only be displayed on the OCU.

  10. Launch the Xenial POS App on the device.