Skip to main content

IPP (Internet Printing Protocol)

A integração IPP consulta impressoras compatíveis com o Internet Printing Protocol (RFC 8010/8011) e expõe status de operação, uptime e nível dos consumíveis (tonner/tinta) como sensores no Portal. Funciona com a grande maioria das impressoras de rede modernas — HP, Brother, Epson, Canon, Xerox e outras — sem drivers proprietários. Baseia-se na mesma abordagem do componente IPP do Home Assistant.
Roda apenas em um edge local (home). A impressora precisa estar acessível na mesma LAN em que o edge está ligado.

Configurar

1

Descubra o endpoint IPP

A maioria das impressoras aceita ipp://<ip>:631/ipp/print. Outros caminhos comuns: /ipp, /printers/<nome>. Se você não sabe o path, consulte a interface web da impressora (menu “Serviços” ou similar) ou o manual do fabricante.
2

Adicione a integração

Vá em Configurações → Integrações → Adicionar → IPP (Internet Printing Protocol) e selecione um edge local.
3

Informe os dados da impressora

Preencha Nome, Host, Porta (padrão 631) e Caminho (padrão /ipp/print). Para impressoras que exigem HTTPS/IPPS, habilite TLS.
4

Pronto

O Portal detecta modelo, fabricante e consumíveis automaticamente, criando um sensor por marker (tonner/tinta) mais um sensor de status geral e um sensor de uptime. Polling padrão: 60 segundos.

Entidades

Cada impressora gera as seguintes entidades: Exemplo: uma impressora colorida com quatro cartuchos gera 6 entidades no total (status, uptime e um sensor por cor).

Dashboard

Use o card Entity para exibir o status geral e cards Gauge para os níveis de tinta. O state_reasons costuma vir com valores como toner-low-warning, media-jam, door-open — úteis para alertas em automações.

Portas e caminhos comuns

Limitações atuais

  • Somente leitura: comandos (cancelar job, reiniciar) ainda não estão expostos.
  • Autenticação HTTP básica não é suportada — a maioria das impressoras deixa o endpoint IPP público na LAN.
  • Descoberta automática via mDNS/Bonjour ainda não implementada; adicione a impressora manualmente informando IP + porta + caminho.