Configuración de Hardware

El Terminal POS se integra con impresoras térmicas de recibos, cajones de dinero y escáneres de códigos de barras. Esta guía cubre la configuración y prueba de cada tipo de dispositivo.

Impresora Térmica de Recibos

El sistema soporta impresoras térmicas compatibles con ESC/POS conectadas por USB o red (TCP/IP). La mayoría de los modelos populares de Epson, Star Micronics y Bixolon son compatibles.

Configuración de Impresora USB:

1. Conecte la impresora al terminal POS mediante USB.
2. En Linux, asegúrese de que el usuario actual tenga permisos para acceder a dispositivos USB. Agregue el usuario al grupo lp: sudo usermod -aG lp $USER y cierre e inicie sesión nuevamente.
3. Identifique la ruta del dispositivo (por ejemplo, /dev/usb/lp0) o use lsusb para encontrar los IDs del fabricante y producto.
4. En el archivo .env del servidor de la tienda, configure: PRINTER_TYPE=usb y PRINTER_DEVICE=/dev/usb/lp0.

Configuración de Impresora de Red:

1. Conecte la impresora a la red local de la tienda y asigne una dirección IP estática a través del menú de configuración de la impresora.
2. Verifique la conectividad: ping <ip-impresora> y nc -z <ip-impresora> 9100 (el puerto 9100 es el puerto estándar de impresión raw).
3. En el archivo .env del servidor de la tienda, configure: PRINTER_TYPE=network, PRINTER_HOST=192.168.1.100 y PRINTER_PORT=9100.

Cajón de Dinero

Los cajones de dinero normalmente se conectan a la impresora de recibos mediante un cable RJ-11 (el conector "kick" en la parte trasera de la impresora). Cuando el sistema envía un recibo a imprimir, también envía el comando de apertura del cajón. No se necesita un controlador o configuración separada -- el cajón se abre automáticamente cuando la impresora recibe el comando ESC/POS de apertura de cajón.

Si su cajón de dinero se conecta directamente al terminal por USB, configure CASH_DRAWER_TYPE=usb y CASH_DRAWER_DEVICE=/dev/usb/drawer0 en el archivo .env. La mayoría de las configuraciones usan el enfoque de conexión a la impresora.

Escáner de Código de Barras

Los escáneres USB de códigos de barras que operan en modo de emulación de teclado (HID) funcionan de inmediato sin configuración. El escáner escribe caracteres en el campo de entrada que tenga el foco, igual que un teclado. El Terminal POS está diseñado para aceptar esta entrada en la pantalla principal de ventas.

Para mejores resultados:

1. Configure el escáner para agregar un salto de línea (Enter) después de cada escaneo. Esto activa la búsqueda del producto automáticamente.
2. Configure el escáner en modo de emulación de teclado si no lo está ya (consulte el manual del escáner para los códigos de barras de cambio de modo).
3. Evite escáneres que requieran controladores propietarios, ya que pueden no funcionar en Linux.

Probar el Hardware

El servidor de la tienda incluye una utilidad de prueba de hardware. Ejecute:

cd apps/store-server
cargo run -- test-hardware

Este comando prueba cada dispositivo configurado: envía una página de prueba a la impresora, activa el cajón de dinero y espera un escaneo de código de barras. Siga las indicaciones en pantalla para verificar que cada dispositivo funciona correctamente. Si alguna prueba falla, revise la conexión y los ajustes de configuración descritos anteriormente.