OdooWiki OCA HUB

Point of Sale - LED Customer Display

pos_customer_display folder_open OCA/pos open_in_new
Point Of Sale License: AGPL-3

This module adds support for LED Customer Display in the Point of Sale.

It has been tested with the following devices:

  • Bixolon BCD-2000 (https://www.bixolon.com/product_view.php?idx=162),
  • Bixolon BCD-1100 (Discontinued by Bixolon. Support page: https://www.bixolon.com/download_view.php?idx=78),
  • Aures OCD 300 (https://www.aures.com/point-de-vente-equipment-solutions-systemes/ecrans-tactiles-afficheurs/ocd-300-350-afficheur-client-graphique)

But it should support most serial and USB-serial LED displays out-of-the-box or with minor adaptations in the source code

  • of the module hw_customer_display if you use the POSbox,
  • or of the Python lib pyposdisplay if you use pywebdriver.

auto_awesome What this module does

AI-generated from the code · Odoo 14.0

Lets you show order information on an LED customer display connected to your Point of Sale, and configure the welcome and closed messages shown on it.

This module adds support for LED customer displays (the small two-line screens facing the customer) in the Point of Sale.

On each Point of Sale configuration you get new settings: an option to enable the LED Customer Display, an option for an Epson ePOS display connected through the Epson printer, a display format (2 lines of 20 characters), the line length, and four customisable messages — two shown when the POS is open ("Next Customer") and two shown when the POS is closed.

Business rules and automatic behaviour: - You cannot enable both the IoT-box display and the Epson ePOS display at the same time; Odoo blocks it with an error. - Each message is checked against the line length and rejected if too long. - The line length is computed automatically from the chosen format. - Turning off the IoT box or the other devices option automatically clears the matching display option.

During sales, the display shows the product name, quantity, unit price, discount and line total when a line is added, changed or deleted; the total, amount paid, change and remaining amount to pay on the payment screen; and the welcome message when the product screen opens. The module touches pos.config and the Point of Sale front-end screens.

Depends on

pos_epson_printer
Models and fields (1)
  • pos.config · extends an existing modelepos_customer_display (LED Customer Display (Epson ePOS)), iface_customer_display (LED Customer Display), customer_display_format (Customer Display Format), customer_display_line_length (Line Length), customer_display_msg_next_l1 (Next Customer (Line 1)), customer_display_msg_next_l2 (Next Customer (Line 2)), customer_display_msg_closed_l1 (PoS Closed (Line 1)), customer_display_msg_closed_l2 (PoS Closed (Line 2))

Text generated by AI (DeepSeek) from reading the Odoo 14.0 code on GitHub; it may contain mistakes, so check the code before deciding. View the code on GitHub

Availability by version

Reviewed: 2026-11-03
Confirmed (verified in repository and branch) Estimated (unverified) No information

Confirmation status: 2 confirmed, 7 with no information of 9 versions.

terminal Installation and usage

OCA documentation · Odoo 14.0

Installation

Source · Odoo 14.0

This module is designed to be installed on the main Odoo server. On the POSbox, you should install the module hw_customer_display. But you will certainly prefer to use pywebdriver instead of the POSbox. Compared to the POSbox, Pywebdriver has several advantages:

  • smaller footprint: no need to have a full-blown Odoo on the computer of the cashier (or his small Linux-based PC connected to the hardware, like the RaspberryPi for the POSbox),
  • native support for the customer display, payment terminal, etc.
  • nice test/diagnosis Web interface,
  • Windows support.

Configuration

Source · Odoo 14.0

To configure this module,

  • go to the menu Point of Sale > Configuration > Point of Sale
  • edit the point of sale for which you want to enable the LED:
  • In the IotBox section, activate the option LED Customer Display,
  • configure the format of your LED screen. (2 lines of 20 characters, by default)
  • optionaly, you can customize the Next customer message and the POS closed message

Usage

Source · Odoo 14.0

Once everything is configured, just start the POS as usual. You will see messages on the device when:

  • you start the POS,
  • you add or remove a product,
  • you select or deselect a customer,
  • you press the Payment button: the device will display the total amount,
  • you enter the amount of cash you receive: the device will display the amount of the change to give back,
  • you validate an order and go to the next customer,
  • you close the POS.
info

Data imported from GitHub: this sheet reflects the latest catalog review, not a live lookup. Always check the module documentation and staging before installing in production.