Configuration

Get the built-in test working before integrating.

Choose your connection type, check the physical settings and use the included tests to confirm each capability.

Updated:

Settings by connection type

IP + port

Network

Android and the printer must be able to communicate. Enter the printer's IP address and TCP port, often 9100. Avoid an address that changes over time.

Cable + permission

USB

Connect using the correct cable or OTG adapter, select the detected device and accept Android's permission prompt.

Pair + select

Bluetooth

Pair the printer in Android Settings. Return to PosPrinterDriver and select it from the list.

Paper and resolution

ProfilePrint width used by the appWhat to check
2 inches384 pixelsActual printable width and logo scaling
3 inches640 pixelsCommon on 80 mm printers, but test your model
4 inches812 pixelsPrinter and paper roll compatibility
CustomUser-entered valueDo not exceed the print head's printable width
Resolution180 or 203 DPIChoose the value that matches your printer

Logo, cutter and cash drawer

You can select an image up to 500 × 500 pixels, print it as a header, convert it to greyscale or invert it. Run the logo test before enabling it for real jobs.

Cutting can be disabled or set to partial or full, with feed lines before cutting. Cash drawer opening and cut types depend on the printer supporting those ESC/POS commands.

  • If the logo is cropped, reduce its width and check the paper profile.
  • If it appears black or inverted, check greyscale and inversion settings.
  • If cutting fails, try the other mode and confirm hardware support.

Visual references