Guía operativa para instaladores y soporte. Cubre la conexión Ethernet directa entre la PC de la sucursal y la impresora térmica, sin router intermedio y sin instalar drivers del fabricante.
El cliente de impresión envía comandos ESC/POS crudos por TCP al puerto 9100 de la impresora. No usa el spooler de Windows ni CUPS, así que no hay que instalar ninguna impresora en el sistema operativo. La PC solo necesita poder alcanzar la IP de la impresora.
Contenido
- Cuándo aplica esta guía
- Materiales
- Esquema de direccionamiento
- Configurar la interfaz de red de la PC
- Configurar la IP de la impresora
- Verificación
- Registrar la impresora en Idoo
- Convivencia USB + red, y migración desde otro sistema
- Problemas comunes
— Anexo A: impresoras solo-USB
— Anexo B: hoja de registro por sucursal
1. Cuándo aplica esta guía
- La sucursal tiene red y la impresora tiene puerto Ethernet
→ Conectar ambas al switch/router existente y saltar directo a la sección 5.
- No hay red disponible, o se quiere aislar la impresora
→ Aplica esta guía completa: cable directo PC ↔ impresora.
- La impresora solo tiene USB
→ Ver el Anexo A al final del post.
2. Materiales
- Cable de red recto (UTP Cat5e o superior). No hace falta cable cruzado: toda tarjeta de red Gigabit tiene Auto-MDIX y hace el cruce automáticamente.
- Una segunda interfaz de red en la PC para el internet. La PC necesita internet para recibir los trabajos de impresión, así que el puerto Ethernet queda dedicado a la impresora. Opciones:
- WiFi de la PC para internet (lo más común, costo cero).
- Adaptador USB→Ethernet (~$10–15 USD) para la impresora, dejando el puerto integrado al internet.
- Si hay varias impresoras: un switch no administrado (~$10) para la red aislada.
❗ IMPORTANTE
Verifique antes de salir a sitio que la PC tiene dos vías de red. Una PC con un solo puerto Ethernet y sin WiFi no puede usar esta topología.
3. Esquema de direccionamiento
Se usa una subred aislada que no debe chocar con la red del router de la sucursal. Por eso se evitan 192.168.0.x y 192.168.1.x, que son las más frecuentes en routers comerciales.
Subred estándar Idoo: 192.168.77.0/24 (máscara 255.255.255.0)
Equipo IP
--------------------------- ----------------
PC (interfaz dedicada) 192.168.77.1
Impresora 1 (caja) 192.168.77.101
Impresora 2 (cocina) 192.168.77.102
Impresora 3 (barra) 192.168.77.103
⚠️ ADVERTENCIA — el error más costoso de esta instalación
No configure puerta de enlace (gateway) en la interfaz de la impresora. Si le pone gateway, el sistema puede intentar enrutar el tráfico de internet por el cable de la impresora y la conexión con el servidor se cae de forma intermitente, lo que es muy difícil de diagnosticar después.
La interfaz de la impresora lleva solo IP y máscara. Nada más.
4. Configurar la interfaz de red de la PC
4.1 Windows
Opción A — Interfaz gráfica
Win + R → ncpa.cpl → Enter.- Clic derecho sobre el adaptador Ethernet conectado a la impresora → Propiedades.
- Seleccionar Protocolo de Internet versión 4 (TCP/IPv4) → Propiedades.
- Marcar Usar la siguiente dirección IP:
- Dirección IP:
192.168.77.1
- Máscara de subred:
255.255.255.0
- Puerta de enlace predeterminada: dejar EN BLANCO
- Servidores DNS: dejar en blanco
- Aceptar.
Opción B — Línea de comandos (PowerShell o CMD como administrador)
# 1. Ver el nombre exacto de las interfaces
netsh interface ipv4 show interfaces
# 2. Asignar IP estática SIN gateway (ajuste el nombre "Ethernet" al real)
netsh interface ipv4 set address name="Ethernet" static 192.168.77.1 255.255.255.0
Verificar que no se rompió el internet:
# Debe haber UNA SOLA ruta por defecto, y por la interfaz de internet (WiFi)
route print -4 | findstr "0.0.0.0"
# Confirmar que hay internet
ping -n 2 idoo.restaurant
Si route print muestra dos rutas 0.0.0.0, la interfaz de la impresora quedó con gateway. Vuelva al paso 4 y bórrelo.
Perfil de red: Windows marcará la nueva conexión como "Red no identificada" y le asignará el perfil Público. Normalmente no estorba, porque la PC solo hace conexiones salientes. Si hubiera bloqueos, se puede cambiar a privada:
Set-NetConnectionProfile -InterfaceAlias "Ethernet" -NetworkCategory Private
4.2 Linux
Opción A — NetworkManager / nmcli (Ubuntu Desktop, Linux Mint, Fedora)
# 1. Identificar la interfaz (ej. enp3s0, eth0)
nmcli device status
# 2. Crear el perfil de la red de impresoras
sudo nmcli connection add type ethernet ifname enp3s0 con-name impresoras \
ipv4.method manual ipv4.addresses 192.168.77.1/24
# 3. CLAVE: impedir que esta interfaz tome la ruta por defecto
sudo nmcli connection modify impresoras ipv4.never-default yes ipv6.method disabled
# 4. Activar
sudo nmcli connection up impresoras
ipv4.never-default yes es el equivalente Linux de "sin gateway" y es obligatorio.
Opción B — netplan (Ubuntu Server). Archivo /etc/netplan/99-impresoras.yaml:
network:
version: 2
ethernets:
enp3s0:
dhcp4: false
addresses: [192.168.77.1/24]
# Sin 'gateway4' ni 'routes': esta interfaz nunca debe ser ruta por defecto
sudo netplan apply
Verificar:
# Debe existir UNA sola ruta por defecto, por la interfaz de internet
ip route show default
# Confirmar la IP asignada
ip -4 addr show enp3s0
5. Configurar la IP de la impresora
5.1 Averiguar la IP actual (autotest)
Con la impresora apagada, mantenga presionado el botón FEED, enciéndala y suelte el botón tras 2–3 segundos. Imprimirá una hoja de configuración con la IP, máscara y MAC actuales.
IPs de fábrica frecuentes: 192.168.1.100, 192.168.0.100, 192.168.192.168. No las asuma: lea el autotest.
5.2 Alcanzar la impresora en su IP de fábrica
💡 TIP — el paso que más se olvida
Para poder hablarle a la impresora y cambiarle la IP, la PC tiene que estar temporalmente en la subred de fábrica de la impresora.
Ejemplo: si el autotest dice 192.168.1.100, configure la PC temporalmente en 192.168.1.50 / 255.255.255.0 (mismo procedimiento de la sección 4), haga el cambio, y después ponga la PC en 192.168.77.1.
5.3 Cambiar la IP
Según el modelo, por orden de preferencia:
- Interfaz web embebida — abrir
http://192.168.1.100 en el navegador. La mayoría de las térmicas modernas la traen.
- Utilidad del fabricante — Printer Test Tool / Net Setting (Xprinter y genéricas), EpsonNet Config (EPSON). Es una herramienta de configuración de un solo uso, no un driver de kernel: se ejecuta una vez y se puede desinstalar.
- Botón de reset de red, si el modelo lo tiene, para volver a fábrica y reintentar.
Configure en la impresora:
- IP: la que le toque según la tabla de la sección 3
- Máscara:
255.255.255.0
- Gateway: en blanco o
0.0.0.0
- DHCP: DESACTIVADO (si queda en DHCP, perderá la IP al reiniciar)
Reinicie la impresora y saque otro autotest para confirmar que la IP quedó grabada.
6. Verificación
Ejecute los tres niveles en orden. Si uno falla, no siga: el problema está ahí.
Nivel 1 — Conectividad
ping 192.168.77.101 # Linux
ping -n 4 192.168.77.101 # Windows
Nivel 2 — Puerto 9100 abierto
Windows (PowerShell):
Test-NetConnection -ComputerName 192.168.77.101 -Port 9100
Debe reportar TcpTestSucceeded : True.
Linux:
nc -zv 192.168.77.101 9100
Nivel 3 — Ticket de prueba real
Esto envía ESC/POS crudo, exactamente igual que el aplicativo. Si esto imprime, el hardware y la red están listos.
Linux:
printf '\x1b@IDOO - PRUEBA DE CONEXION\n\n\n\x1dV\x00' | nc 192.168.77.101 9100
Windows (PowerShell):
$cliente = New-Object System.Net.Sockets.TcpClient("192.168.77.101", 9100)
$flujo = $cliente.GetStream()
$bytes = [byte[]]@(0x1B,0x40) `
+ [Text.Encoding]::ASCII.GetBytes("IDOO - PRUEBA DE CONEXION`n`n`n") `
+ [byte[]]@(0x1D,0x56,0x00)
$flujo.Write($bytes, 0, $bytes.Length)
$flujo.Flush()
$cliente.Close()
La impresora debe imprimir el texto y cortar el papel.
7. Registrar la impresora en Idoo
En el panel de administración de la sucursal, en la ficha de la impresora:
- Dirección IP:
192.168.77.101 (la asignada en la sección 3)
- Puerto:
9100
Guarde y dispare un ticket de prueba desde el panel. El visor de logs del cliente (ícono de bandeja → Ver logs) debe mostrar Connected to printer at 192.168.77.101:9100.
Confirme también que el ícono de la bandeja está en verde: significa que el cliente está conectado al servidor y listo para recibir trabajos.
8. Convivencia USB + red, y migración desde otro sistema
Es frecuente encontrar impresoras que ya están trabajando conectadas por USB a otro sistema de punto de venta. La pregunta obligada es si pueden funcionar por USB y por red al mismo tiempo.
8.1 Depende del firmware del modelo
- Simultáneo / auto-switching — acepta datos por cualquier puerto e imprime lo que llegue.
Lo más común en modelos actuales.
- Selección por DIP switch — solo una interfaz activa; hay que elegirla físicamente.
Modelos viejos o de gama baja.
- Exclusivo por prioridad — la primera interfaz que recibe datos toma el control durante un timeout.
Algunos firmwares genéricos.
En el caso más común la respuesta es sí: funciona por USB y por red simultáneamente.
8.2 El riesgo: tickets intercalados
⚠️ ADVERTENCIA
Nunca deje dos sistemas imprimiendo activamente a la misma impresora.
No existe arbitraje entre interfaces: la impresora recibe un flujo de bytes y no sabe dónde termina un ticket. Si un sistema manda por USB mientras otro manda por red, las líneas de un ticket pueden aparecer mezcladas dentro de otro.
Esto no ocurre entre dos conexiones de red (la impresora rechaza o encola la segunda conexión al puerto 9100), pero USB y Ethernet son canales físicamente distintos y ahí no hay bloqueo mutuo.
Regla operativa: la impresora puede estar conectada por ambos medios, pero solo un sistema debe estar imprimiendo.
8.3 Nota sobre Windows
Al conectar el cable USB, Windows carga solo su driver de clase (usbprint.sys) y crea el puerto USB001. Es inofensivo por sí mismo, pero deja una impresora visible en el panel de Windows que alguien podría configurar por error en otro software, provocando exactamente el intercalado descrito arriba.
8.4 Prueba de comportamiento (2 minutos)
No lo asuma por marca ni modelo. Verifíquelo:
Conecte ambos cables (USB y Ethernet).
Envíe el ticket de prueba por red (sección 6, nivel 3). Debe imprimir.
Sin desconectar nada, envíe una impresión por USB desde el sistema anterior.
Ambos imprimen sin reconfigurar → el modelo es simultáneo.
El segundo no imprime → es exclusivo o por DIP switch; habrá que elegir una sola interfaz.
8.5 Migración sin cortar la operación
Procedimiento recomendado cuando el cliente ya opera con otro sistema por USB:
- Deje el cable USB conectado y el sistema anterior operando normalmente.
- Conecte el cable Ethernet y realice las secciones 3 a 6 de esta guía.
- Valide con tickets de prueba por red mientras el restaurante sigue trabajando con el sistema anterior. Nadie se entera.
- Registre la impresora en el panel de Idoo (sección 7) y dispare un ticket de prueba real.
- Solo cuando todo esté confirmado, apague el sistema anterior y desconecte el cable USB.
- Vuelva a imprimir un ticket de prueba para confirmar la operación final.
💡 TIP
El USB también sirve como herramienta de diagnóstico: si sospecha de la red, imprimir por USB le confirma que el hardware de la impresora está sano y aísla el problema a la parte de red.
8.6 Al terminar
Si el USB no se necesita, desconecte el cable. Reduce la superficie de fallo y elimina la posibilidad de que alguien mande trabajos por ahí por error.
9. Problemas comunes
🔴 El internet de la PC se cae de forma intermitente
Causa: gateway configurado en la interfaz de la impresora.
Solución: bórrelo (sección 3). En Linux, ipv4.never-default yes.
🔴 ping no responde
Causa: cable, subred distinta o impresora apagada.
Solución: verifique los LED del puerto; confirme con autotest que ambos están en la misma subred.
🔴 ping responde pero el puerto 9100 falla
Causa: la impresora no tiene habilitada la impresión RAW, o usa otro puerto.
Solución: revise la interfaz web del modelo; algunos usan 9101 o 6001.
🔴 La impresora pierde la IP al reiniciarse
Causa: quedó con DHCP activo.
Solución: desactive DHCP en la impresora (sección 5.3).
🔴 Imprime caracteres raros o basura
Causa: no es problema de red, es el juego de caracteres.
Solución: reporte a desarrollo con el modelo exacto; el codificado es PC850.
🔴 Líneas de un ticket mezcladas dentro de otro
Causa: dos sistemas imprimiendo a la vez (USB y red).
Solución: desconecte el cable USB o apague el sistema anterior (sección 8.2).
🔴 Imprime dos veces el mismo ticket
Causa: el sistema anterior sigue activo por USB.
Solución: apague el sistema anterior (sección 8.5).
🔴 Nada imprime por red, pero por USB sí funciona
Causa: el modelo es de interfaz exclusiva o por DIP switch.
Solución: aplique la prueba de la sección 8.4 y seleccione la interfaz de red.
🔴 Imprime pero no corta el papel
Causa: modo de corte del modelo.
Solución: revise la configuración de corte en la utilidad del fabricante.
🔴 Ícono de bandeja en rojo
Causa: la PC no tiene internet o el token es inválido.
Solución: verifique el internet primero (ping idoo.restaurant), luego los logs.
🔴 Windows: "Red no identificada"
Causa: normal, no requiere acción.
Solución: solo si hay bloqueos, cambie el perfil a Privado (sección 4.1).
Anexo A: Impresoras solo-USB
El aplicativo no imprime por USB: usa exclusivamente TCP al puerto 9100. Para una impresora sin puerto Ethernet, la solución es un print server USB→Ethernet (~$25–40 USD): un adaptador que expone el puerto USB de la impresora como puerto 9100 en la red.
Una vez conectado, se configura y se registra exactamente igual que cualquier impresora de red (secciones 5 a 7); la IP se le asigna al print server, no a la impresora.
Esto evita instalar drivers del fabricante en Windows, que es la causa histórica de fallas que motivó la arquitectura de red del sistema.
Anexo B: Hoja de registro por sucursal
Llenar al terminar la instalación y archivar junto al expediente de la sucursal.
[spoiler]
Sucursal: ______________________________ Fecha: ______________
Instaló: ______________________________
PC
Interfaz de internet: [ ] WiFi [ ] Ethernet integrado [ ] Adaptador USB
Interfaz impresoras: ______________ IP: 192.168.77.____
Ruta por defecto verificada (una sola): [ ] Sí
IMPRESORAS
# | Ubicación | Modelo | MAC | IP | Prueba
1 | ___________ | _____________ | ________________ | 192.168.77.___ | [ ] OK
2 | ___________ | _____________ | ________________ | 192.168.77.___ | [ ] OK
3 | ___________ | _____________ | ________________ | 192.168.77.___ | [ ] OK
MIGRACIÓN (si venía de otro sistema)
Sistema anterior: ______________________ [ ] Apagado / desinstalado
Cables USB desconectados tras validar la red: [ ] Sí [ ] No aplica
VERIFICACIÓN FINAL
[ ] Ícono de bandeja en verde
[ ] Ticket de prueba impreso desde el panel Idoo en cada impresora
[ ] Internet estable tras 10 minutos de operación
[ ] Reinicio de PC: el servicio arranca solo y reconecta
[ ] Ningún otro sistema imprimiendo a las mismas impresoras
[/spoiler]
¿Encontraste un modelo que se comporta distinto, o un caso que esta guía no cubre? Respóndelo en este hilo para irlo documentando.
