Set up printers, drawer, scanner and card terminal

Oloom does not supply hardware. The till works with standard devices; the list below says how each kind has been checked so far. It is indicative: test your own model before you rely on it.

Device	How it connects	Status
Till PC	Linux (x64 or ARM64) or Windows (x64)	Linux install checked; Windows install not yet checked on a real till
ESC/POS receipt or kitchen printer	Network (port 9100), a printer installed on the till PC, or a serial / USB-serial port	Checked against a simulator
Cash drawer	Plugged into the receipt printer	Checked against a simulator
Barcode scanner	USB, acting as a keyboard	Follows the standard
Scale	No direct link yet: type the weight, or scan the scale's label	Follows the standard
Card terminal	Separate from the till	The cashier records the payment
USB stick for backups	Plugged into the till PC	Checked against a simulator
Extra screens, phones, kitchen screens	Any recent browser on the shop network	See Devices

Android tills with a built-in printer are not supported. An Android phone or tablet can still be a paired device.

Add a printer

1. Open Owner › Settings › Printers and choose Add a printer.
2. Enter a name and choose the Connection: Network (IP address), Installed on this computer, or Serial or USB-serial port.
3. Enter the address (for example 192.168.1.50:9100) or pick the printer or port.
4. Choose its use (Receipts, Kitchen or Bar) and the paper width.
5. Tick Opens the cash drawer for the receipt printer that drives the drawer.
6. Tick Prints images if the printer can: it is needed for Arabic, Russian, Hindi and the logo.
7. Choose Add and print a test. A printer is marked Ready only after a test print; an unreachable printer is marked Not ready.

If a print job fails, the sale is still saved. The selling screen shows how many print jobs need you.

Receipt logo

Add it in Owner › Account › Business. It is scaled to the receipt printer and printed in black and white. A printer without image mode skips it.

Cash drawer

Plug the drawer's cable (RJ11) into the receipt printer, then tick Opens the cash drawer on that printer. The drawer opens after each saved cash sale. Opening it without a sale needs permission and a reason, and is recorded.

Barcode scanner

Plug a USB scanner that works as a keyboard. Scan on the selling screen to add a product, or in Sales history to find a receipt. No setting is needed.

Scale

The till cannot read a scale directly yet. For products sold by weight, type the weight on the keypad, or scan the barcode label your scale prints.

Card terminal

Use your bank's or provider's terminal on its own. Type the amount on the terminal, then record the card payment on the till.