Integración domótica HP Printer, gratuita y de código abierto
Siga los niveles de tinta y tóner, el estado, las alertas y las páginas de sus impresoras HP.
Publicado por prohand
- Dispositivos
- Versión 1.0.1
- Requiere Gladys >=5.1.0
- ★ 0
English · Français · Deutsch · Español
Siga sus impresoras HP desde Gladys: niveles de tinta o tóner, estado, alertas (sin papel, atasco, tapa abierta…) y número de páginas impresas. Reciba un aviso por escena cuando un cartucho se esté acabando, e imprima un texto desde una escena.
Todo ocurre en su red local: sin cuenta HP, sin nube, nada que instalar junto a Gladys.
Índice
- Lo que necesita
- Instalación
- Configuración
- Dispositivos
- Escenas
- Widgets del panel
- Botones de la pantalla Configuración
- Solución de problemas
- Privacidad
Lo que necesita
- Gladys Assistant 5.1 o posterior.
- Una impresora HP conectada a la red (Wi-Fi o Ethernet), en la misma red que Gladys.
- IPP activado en la impresora. Viene activado de fábrica en casi todas las impresoras HP (es lo que usan AirPrint y Mopria). Si hace falta: abra la página web de la impresora (escriba su dirección IP en un navegador) → Red → Avanzado → IPP / AirPrint.
La integración lee la impresora por el puerto 631 (IPP), y por el puerto 80 para el contador de páginas.
Instalación
- En Gladys: Integraciones → busque HP Printer → Instalar.
- Abra la pantalla Configuración de la integración. Las impresoras de su red se detectan solas. Si falta alguna, escriba su dirección IP en Direcciones de las impresoras y guarde.
- Abra la pestaña Descubrimiento y añada sus impresoras.
Consejo: asigne una dirección IP fija a sus impresoras (una reserva DHCP en su router). La integración encuentra una impresora que cambió de dirección cuando la detección automática está activa, pero una dirección fija siempre es más fiable.
Configuración
| Campo | Por defecto | Para qué sirve |
|---|---|---|
| Direcciones de las impresoras | vacío | Direcciones IP o nombres de host, separados por comas. ipp://192.168.1.20/ipp/print también vale. Solo hace falta si una impresora no se detecta. |
| Detectar las impresoras HP automáticamente | activado | Busca impresoras HP en la red (mDNS, como un ordenador). |
| Intervalo de actualización (s) | 300 | Cada cuánto se lee cada impresora. De 60 a 3600 segundos. |
| Umbral de nivel bajo (%) | 15 | Un cartucho en este nivel o por debajo activa Tinta o tóner bajo. |
| Idioma de los estados de los dispositivos | English | Idioma de los textos Estado y Alertas, y de los nombres de funciones de los nuevos dispositivos. |
| Registros detallados | desactivado | Escribe en los registros de la integración lo que responde cada impresora. Desactívelo cuando encuentre el problema. |
No compatible: direcciones ipps:// / https:// (IPP cifrado). El certificado
de la impresora es autofirmado, y confiar en él a ciegas daría una falsa
sensación de seguridad: use la dirección ipp:// simple en su red local.
Dispositivos
Cada impresora es un dispositivo de Gladys:
| Función | Tipo | Valores |
|---|---|---|
| Estado | texto | Lista, Imprimiendo, Detenida, Sin conexión |
| Alertas | texto | Sin alertas, o la lista de problemas: Sin papel, Atasco de papel, Tapa abierta, Cartucho vacío o ausente, Bandeja de salida llena, Falta la bandeja, Error de la impresora |
| Tinta / Tóner (uno por color) | % | 0 a 100 |
| Páginas impresas | contador | número total de páginas, si la impresora lo da |
La tarjeta del dispositivo muestra además una insignia local (la impresora responde) o inaccesible (no responde: apagada, en reposo profundo, desenchufada).
Cuando la impresora no responde, el estado pasa a Sin conexión y se mantienen los últimos niveles conocidos.
Algunas impresoras no dan el nivel de cada cartucho (algunas solo dicen «queda tinta»): ese cartucho no muestra entonces ningún valor.
Escenas
Disparadores
| Disparador | Cuándo | Filtros | Variables |
|---|---|---|---|
| Tinta o tóner bajo | un cartucho baja del umbral de la configuración | impresora, color (negro, cian, magenta, amarillo…) | supply, color, level |
| Problema de impresora | aparece un problema nuevo | impresora, problema | problem, label |
| Impresora inaccesible | la impresora deja de responder | impresora | name |
Cada disparador se activa una sola vez, cuando ocurre el cambio: un cartucho que se queda en 10 % no vuelve a activarlo en cada lectura. Vuelve a activarse después de cambiar el cartucho, cuando vuelve a estar bajo.
Valores de problem: paper_out, paper_jam, door_open, supply_problem,
output_full, tray_missing, other. label es el mismo problema escrito en
el idioma de la configuración.
Ejemplo: «Cuando la tinta negra de la impresora de la oficina esté baja,
envíame un mensaje: Tinta \{\{triggerEvent.data.supply\}\} al \{\{triggerEvent.data.level\}\} %.»
Acciones
| Acción | Campos | Resultados |
|---|---|---|
| Leer una impresora | impresora | reachable, state (idle, printing, stopped, offline), alerts, lowest_level, pages |
| Imprimir un texto | impresora, título (opcional), texto | printed (verdadero / falso), job_id |
lowest_level y pages valen -1 cuando la impresora no los da.
Imprimir un texto crea un PDF A4 de una a veinte páginas y lo envía a la
impresora. El texto puede usar variables de escena, por ejemplo una lista de la
compra. Si la impresora no responde o rechaza el documento, printed es
falso y la escena sigue: ponga una condición sobre él para enviar un mensaje
en su lugar.
Widgets del panel
- Impresora HP: una impresora. Un indicador por cartucho (verde, naranja bajo el umbral, rojo bajo 5 %), el contador de páginas, el estado, las alertas y la dirección. Botones Actualizar y Página de prueba (con confirmación). Elija la impresora en los ajustes del widget.
- Impresoras HP: todas las impresoras, una por línea, con su estado (o su problema) y su nivel más bajo.
Botones de la pantalla Configuración
- Probar las impresoras: lee ahora cada impresora y muestra cuáles
responden, su estado y su nivel más bajo, y las direcciones que no
respondieron (con el motivo, por ejemplo
ECONNREFUSEDoTIMEOUT). - Buscar impresoras: busca impresoras HP en la red y las enumera.
- Imprimir una página de prueba: imprime una página en la impresora elegida.
Solución de problemas
No se encuentra mi impresora.
- Compruebe que la impresora y Gladys están en la misma red. La detección automática no atraviesa VLAN ni redes Wi-Fi de invitados.
- Escriba la dirección IP de la impresora en Direcciones de las impresoras (aparece en la pantalla de la impresora o en su página de configuración de red).
- Pulse Probar las impresoras: una dirección que no responde aparece con el
motivo.
ECONNREFUSED: IPP está desactivado en la impresora.TIMEOUToEHOSTUNREACH: dirección incorrecta, o impresora apagada.
Sin nivel de tinta. La impresora dice que no conoce el nivel (es frecuente con cartuchos compatibles o recargados). No hay nada que corregir en Gladys.
Sin «Páginas impresas». El contador de páginas se lee en la página web de la impresora (puerto 80). Algunas impresoras solo lo dan por HTTPS, o no lo dan: la función no aparece entonces.
La impresora aparece a menudo «Sin conexión». Una impresora en reposo profundo puede dejar de responder en la red. Revise sus ajustes de energía (reposo / apagado automático).
«Imprimir un texto» no hace nada. La impresora debe aceptar documentos PDF por la red: la mayoría de las impresoras HP recientes lo hacen. El botón Imprimir una página de prueba indica el motivo si falla.
Registros detallados. Active Registros detallados, espere una lectura (o pulse Probar las impresoras) y abra los registros de la integración en Gladys. Desactívelos después.
Privacidad
- La integración solo habla con sus impresoras, en su red local.
- No se envía nada a HP ni a ningún otro servicio en línea.
- Los últimos valores conocidos se guardan en el almacenamiento propio de la
integración (
/data): una impresora apagada al reiniciar Gladys sigue apareciendo.
Parámetros de configuración
Estos son los parámetros que HP Printer te pide en su pantalla de configuración en Gladys.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Primeros pasos | section | No | La integración lee sus impresoras HP en la red local (IPP, puerto 631): nada que instalar, sin cuenta HP. Las impresoras se detectan solas; si falta alguna, escriba su dirección IP abajo. Después añada las impresoras desde la pestaña Descubrimiento. |
| Direcciones de las impresoras | string | No | Opcional. Direcciones IP o nombres de host, separados por comas. Una dirección IPP (ipp://host:631/ipp/print) también vale. |
| Detectar las impresoras HP automáticamente | boolean | No | Busca impresoras HP en la red local (mDNS, como lo hacen los ordenadores). |
| Intervalo de actualización (s) | number | No | Cada cuánto se lee cada impresora, en segundos (un minuto como mínimo). |
| Umbral de nivel bajo (%) | number | No | Un cartucho en este nivel o por debajo activa el disparador de escena «Tinta o tóner bajo». |
| Idioma de los estados de los dispositivos | select | No | Idioma de los textos de estado y alertas, y de los nombres de funciones de los nuevos dispositivos. |
| Registros detallados | boolean | No | Registra lo que responde cada impresora. Desactívelo cuando encuentre el problema. |
Cómo instalar HP Printer en Gladys
- En Gladys, abre Integraciones: HP Printer aparece en el catálogo junto a las integraciones nativas, con una insignia de comunidad.
- Haz clic en Instalar. Gladys descarga la imagen Docker (
ghcr.io/prohand/gladys-hpprinter:1.0.1), la ejecuta en un entorno aislado del núcleo y genera la interfaz de la integración (dispositivos, descubrimiento y configuración). - Abre la pantalla de Configuración de la integración, rellena los parámetros y guarda.
- También puedes instalarla directamente desde la URL de su repositorio: https://github.com/prohand/gladys-hpprinter.
HP Printer requiere Gladys >=5.1.0. El catálogo de Gladys se actualiza cada hora, así que una nueva versión está disponible como máximo una hora después de publicarse.
¿Todavía no usas Gladys? Es gratuito y de código abierto: sigue la guía de instalación para empezar.
Sobre las integraciones externas
HP Printer es una integración externa: una integración comunitaria empaquetada como contenedor Docker y publicada en GitHub. Gladys la instala con un clic y la ejecuta en un entorno aislado del núcleo. La publica y mantiene prohand, no el equipo principal de Gladys.
- Explorar todas las integraciones, nativas y de la comunidad
- Crear y publicar tu propia integración externa
- Código fuente en GitHub — fuente de esta documentación