/Home_Assistant_EDP_Box

Integração das EDP Box com Home Assistant Core

GNU General Public License v3.0GPL-3.0

Âmbito

A integração entre os contadores inteligentes com sistemas de domótica permite potenciar automações, controlo e análises com base na informação disponível das grandezas elétricas. Nomeadamente, tensão, intensidade de corrente, potência ativa, fator de potência, frequência, estado do disjuntor controlador de potência, et al.

A EDP Distribuição S.A. surge neste contexto enquanto Operadora da Rede de Distribuição de baixa tensão. Independentemente do comercializador de energia elétrica com quem tem contrato de fornecimento e de estar em mercado regulado ou liberalizado.

Objetivo

Pretende-se partilhar o conceito de integração entre dispositivos EDP Box com um HUB de domótica a executar Home Assistant Core.

Esta integração é possível graças à porta de comunicação HAN que está disponível internamente nos contadores inteligentes. É também proposto neste repositório um procedimento para requisitar formalmente o acesso a esta porta.

São propostas duas alternativas distintas possíveis para integração:

  1. Integração indireta com Home Assistant, usando um microcontrolador ESP8266 com firmware Tasmota, através de MQTT com Home Assistant Core.
  2. Integração direta com Home Assistant Core, com o seu componente nativo para protocolo MODBUS.

Conteúdos

  1. A EDP Box e a sua porta HAN
    1. Pedido de acesso
    2. Interface físico
    3. Impedância de linha
    4. Comunicação
  2. Tasmota e script de configuração para MODBUS - Para método indireto
    1. Descarga e instalação do firmware no ESP8266
    2. Configuração do script para Smart Meter Interface (SMI)
    3. Ligação física entre o contador inteligente, o ESP8266 e o hub com Home Assistant Core
  3. Home Assitant Core e a sua configuração - Para método direto e indireto
    1. Ligação física entre o contador inteligente e o hub com Home Assistant Core
    2. Ficheiro de configuração
    3. Personalizar as entidades geradas - método direto
    4. Aplicação das configurações

Requisitos mínimos

Transversais

  • Contador inteligente com porta HAN ativada, suportando o protocolo de tramas MODBUS.
  • Acesso exterior à porta HAN, previamente instalado pela EDP Distribuição S.A.;
  • Raspberry Pi 3 B+ ou superior (alternativamente, Home Assistant Core em PC, máquina física ou virtualizada em Proxmox);
  • Home Assistant Core instalado (versão inicial de prova de conceito: 0.106.6. Recomendada a versão 0.109.7 ou superior.);
  • Mosquitto MQTT Broker instalado (versão 5.0 ou superior, como add-on oficial em Home Assistant Core. Ou qualquer outro broker MQTT à sua discrição);
  • Acessórios de ligação variados.

Exclusivamente para o 1º método (indireto)

  • Conversor TTL vs RS-485 (por exemplo, "TTL to RS485 For Arduino")
  • Wemos D1 Mini
  • Resistência de 120 Ohm

Exclusivamente para o 2º método (direto)

  • Conversor USB - TTL vs RS-485 (por exemplo, "Waveshare Industrial USB to RS485")
  • Cabo extensor USB "A macho" - "A fêmea" (recomendado)

Fontes

EDP Box - HAN protocol specification (DEF-C44-509/N)

Descrição dos requisitos e respetiva aplicabilidade em função do tipo de módulo HAN

Contadores de energia elétrica - Especificação funcional (DEF-C44-506/N)

Novos Equipamentos

Notas importantes

A porta de comunicação HAN está no interior das EDP Box. A manipulação, danos, prejuízos ou acesso não autorizado a esta porta é da total responsabilidade do próprio.

Todas as marcas registadas, nomes de produtos ou de marcas, referidas neste documento, são propriedade registada do respectivo detentor.

Versionamento

  • 4 de Julho de 2020: segunda integração validada e publicada, através de MQTT e WIFI.
  • 13 de Março de 2020: primeira integração publicada e validada, através de USB.

A fazeres

Método direto:

  • Potência ativa
  • Totalizadores de energia
  • Religação do DCP

Método indireto:

  • Tarifa
  • Estado do DCP
  • Totalizadores de energia
  • Religação do DCP