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
- Plug the printer into any USB port on your device.
- The printer appears as
/dev/usb/lp0or/dev/ttyUSB0. - In WifiCone, go to Admin Panel → Voucher Printer.
- Select the detected port from the dropdown.
- Click Save.
Serial (RS-232)
- Connect via serial cable to a COM port.
- The printer appears as
/dev/ttyS0or/dev/ttyS1. - 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
- Go to Vouchers.
- Select the batch you want to print.
- Click Print Batch → select the number of copies.
- 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 |