Hardware Setup

FlexotiumPOS works with standard retail hardware over browser-native protocols. No drivers or proprietary software are needed on most devices.

Barcode Scanners

USB HID scanners

Any generic USB barcode scanner that emulates a keyboard (HID mode) works with FlexotiumPOS:

  1. Plug the scanner into a USB port on your device
  2. Open FlexotiumPOS — the scanner is detected automatically
  3. Click in the product search field and scan a barcode to test

Most USB scanners ship in HID mode by default. If yours doesn't work, check the manual for instructions to switch to keyboard emulation mode.

Recommended models: Honeywell Voyager 1250g, Symbol LS2208, Zebra DS2208, any generic USB HID scanner.

Bluetooth HID scanners

  1. Put the scanner in pairing mode (refer to the device manual)
  2. On your device, open Bluetooth settings and pair the scanner
  3. Once paired, the scanner works identically to a USB scanner

Receipt Printers

FlexotiumPOS communicates with ESC/POS printers via the Web Serial API (Chrome/Edge) or WebUSB API. Safari does not support Web Serial — use Chrome or Edge on Mac/iPad.

Setting up a new printer

  1. Connect the printer via USB (or pair via Bluetooth)
  2. In FlexotiumPOS, go to Settings → Hardware → Receipt Printers → Add Printer
  3. Click Detect Printer — Chrome will show a permission dialog; select your printer
  4. Click Print Test Receipt to confirm

Supported printer models

Any ESC/POS compatible thermal printer works. Commonly used models:

| Model | Connection | Notes | |-------|-----------|-------| | Epson TM-T20III | USB, Serial | Industry standard, recommended | | Star Micronics TSP100 | USB | Reliable, wide support | | BIXOLON SRP-350III | USB, Ethernet | Good for shared printers | | Generic 58mm/80mm ESC/POS | USB | Budget option, works well |

Cash drawer

A cash drawer connected via RJ11 to the receipt printer opens automatically after every cash sale. No additional configuration is needed.

Troubleshooting

| Issue | Fix | |-------|-----| | Printer not detected | Try a different USB port; ensure you're using Chrome/Edge | | Print job sent but nothing prints | Check paper is loaded; check printer is online | | Partial print / garbled text | Wrong paper width selected — go to printer settings and match to your paper width (58mm or 80mm) | | Scanner not responding | Check the product search field is focused; try clicking it first | | Scanner types codes instead of searching | Change scanner to HID keyboard mode via its configuration barcode |

Device health monitoring

Connected hardware is monitored in Settings → Hardware → Devices. The status panel shows whether each device has been seen in the last 5 minutes and the timestamp of the last successful interaction.