Integração e API

ESPHome Native API

Quando um nó ESPHome conecta ao Home Assistant, a Native API mantém uma sessão TCP persistente e troca mensagens binárias definidas pelo projeto. Ela expõe sensores, luzes, switches, logs e serviços sem broker MQTT, normalmente na porta 6053, com criptografia Noise opcional. É preferível para integração direta e descoberta rica. A limitação é o acoplamento maior ao ecossistema ESPHome/Home Assistant; redes instáveis exigem reconexão e mDNS pode falhar entre VLANs.

🔀 Tipos de Comunicação

TCP

Sessão persistente

O dispositivo abre conexão TCP com o cliente e mantém troca bidirecional de estados, comandos e eventos.

Binary

Mensagens tipadas

Estruturas binárias representam entidades, estados, serviços e logs com menos overhead que JSON textual.

Discovery

Descoberta de entidades

O nó anuncia automaticamente sensores, luzes, botões, números e recursos ao Home Assistant.

Noise

Criptografia Noise

Chave pré-compartilhada protege confidencialidade e autenticidade da sessão local.

✅ Vantagens Arquiteturais

⚡

Integração direta

Dispensa broker MQTT e reduz componentes intermediários entre o dispositivo e o Home Assistant.

⚡

Baixa latência

A conexão persistente entrega mudanças e comandos rapidamente, adequada a botões, luzes e sensores.

⚡

Modelo rico de entidades

Tipos nativos preservam unidades, classes, disponibilidade e serviços específicos.

⚡

Provisionamento integrado

Logs, atualização OTA e diagnóstico ficam alinhados ao fluxo de desenvolvimento do ESPHome.