WifiCone Help

Voucher Printer Setup

WifiCone supports thermal printers for printing voucher codes. Printed vouchers can be sold at a counter or bundled with products.


Supported Printers

WifiCone works with thermal printers that support ESC/POS commands — the industry standard for receipt printers.

Common compatible printers:

  • Epson TM series (TM-T20, TM-T82, TM-T88)
  • BIXOLON SRP series
  • Xprinter XP series
  • Generic 58mm or 80mm thermal printers with USB or serial interface

Connection

USB

  1. Plug the printer into any USB port on your device.
  2. The printer appears as /dev/usb/lp0 or /dev/ttyUSB0.
  3. In WifiCone, go to Admin Panel → Voucher Printer.
  4. Select the detected port from the dropdown.
  5. Click Save.

Serial (RS-232)

  1. Connect via serial cable to a COM port.
  2. The printer appears as /dev/ttyS0 or /dev/ttyS1.
  3. Configure the baud rate to match the printer's setting (usually 9600 or 115200).

Configuration

Go to Admin Panel → Voucher Printer.

Setting Description
Enable Toggle printer on/off
Port Serial or USB device path (e.g., /dev/usb/lp0)
Baud Rate Serial speed (USB printers typically ignore this)
Paper Width 58mm or 80mm — affects layout
Header Text Business name or custom text printed at the top of each voucher
Footer Text Custom text at the bottom (e.g., "Valid for 30 days after first use")
Copies Number of copies to print per voucher

Printing Vouchers

Print a Single Batch

  1. Go to Vouchers.
  2. Select the batch you want to print.
  3. Click Print Batch → select the number of copies.
  4. The printer outputs one ticket per voucher code.

Test Print

Go to Voucher Printer → Test Print to send a sample page and verify the layout.


Voucher Ticket Layout

Each printed ticket includes:

================================
        YOUR BUSINESS NAME
================================
WiFi Voucher
Rate:  1 Hour — ₱10
Code:  AB12CD34
================================
Connect to: [Your SSID]
Go to: wifi.login
Enter your code to start.
================================
Valid for 30 days after first use
================================

The header, footer, SSID, and portal URL are customizable in the printer settings.


Troubleshooting

Problem Likely Cause Fix
Printer not detected USB not connected Check cable and try another USB port
Garbled output Wrong baud rate Match baud rate to printer's DIP switch setting
Partial printout Paper width mismatch Check paper size setting (58mm vs 80mm)
Nothing prints Port is wrong Try /dev/usb/lp0, /dev/usb/lp1, /dev/ttyUSB0
Print button disabled Printer not enabled Toggle Enable in Voucher Printer settings