ha duke energy gateway Download - ha duke energy gateway Código Fonte Download

ha duke energy gateway

PowerBuilder

v0.1.7

Baixar

Importante - depreciado

A Duke Energy encerrou o programa piloto de gateway no final de junho de 2023. Essa integração parou de funcionar e está presa.

Duke Energy Gateway

Esta é uma integração personalizada para o assistente doméstico. Ele extrai o uso de energia em tempo real da Duke Energy através do Programa Piloto de Gateway da Duke Energy.

Essa integração aproveita a biblioteca pyduke-energy , também escrita por mim, para extrair dados. Esta API não é muito oficial e pode parar de funcionar a qualquer momento (consulte a isenção de responsabilidade).

Pré-requisitos! (Por favor, leia)

Você deve ter um gateway de energia da Duke conectado ao seu SmartMeter para que isso funcione. Este é um dispositivo separado que o seu medidor inteligente e é fornecido por um programa apenas de convite no momento. Se você não sabe o que é isso, provavelmente não o tem. Essa integração não suporta nenhum outro método de recuperação de dados (consulte o requisito do gateway).

Sensores

Este componente configurará as seguintes entidades:

`sensor.duke_energy_current_usage_w`

Representa o uso de energia em tempo real em Watts.
Esses dados são empurrados do dispositivo de gateway a cada 1-3 segundos. Nota: isso produz muitos dados. Se esse intervalo de atualização for muito frequente para você, você poderá configurar um intervalo de aceleração em segundos (consulte a configuração abaixo).
Observe que, como esse é o uso de energia, ele não pode ser usado como é para o painel de energia assistente doméstico. Em vez disso, você pode usar o sensor sensor.duke_energy_usage_today_kwh , ou precisa alimentar esse sensor em tempo real através da integração integral de Riemann soma.
Atributos adicionais estão disponíveis contendo o ID do medidor e o ID do gateway.

`sensor.duke_energy_usage_today_kwh`

Representa o consumo de energia de hoje em quilowatt-hora (das 0:00, horário local às 23:59, horário local, depois redefinindo).
Esses dados são pesquisados a cada 60 segundos, mas os dados podem ser adiados até 15 minutos devido a atrasos no Duke Energy que os relatam (consulte as limitações no repo pyduke-energy .).
Isso pode ser usado como é o painel de consumo de energia do Assistente de Home.
Os atributos adicionais estão disponíveis contendo o ID do medidor, o ID do gateway e o registro de data e hora da última medição.

Instalação

Instalação HACS

Adicione como um repositório personalizado em Configurações em HACS: mjmeli/ha-duke-energy-gateway e escolha Integration como a categoria.
Procure "Duke Energy Gateway" nos HACs e a integração agora deve ser retornada como resultado de pesquisa. Clique nele, clique no botão "Download" e passe pelos avisos para baixar.
Reinicie o assistente doméstico
Na UI HA, vá para "Configurações" -> "dispositivos e serviços", verifique se você está na guia Integrações e clique em "+" e pesquise "Duke Energy Gateway". Isso permitirá que você configure.

Instalação manual

Usando a ferramenta de escolha, abra o diretório (pasta) para sua configuração de HA (onde você encontra configuration.yaml ).
Se você não possui um diretório custom_components (pasta) lá, precisará criá -lo.
No diretório custom_components (pasta), crie uma nova pasta chamada duke_energy_gateway .
Faça o download de todos os arquivos do custom_components/duke_energy_gateway/ Diretório (pasta) neste repositório.
Coloque os arquivos que você baixou no novo diretório (pasta) que você criou.
Reinicie o assistente doméstico
Na UI HA, vá para "Configurações" -> "dispositivos e serviços", verifique se você está na guia Integrações e clique em "+" e pesquise "Duke Energy Gateway". Isso permitirá que você configure.

Configuração

A configuração será feita na interface do usuário. Inicialmente, você precisará fornecer os seguintes dados:

Dados	Descrição
`email`	Seu e -mail de login para a Duke Energy.
`password`	Sua senha de login para Duke Energy.

Após a configuração da integração, você poderá fazer uma configuração adicional clicando em "Configurar" na página de integração. Isso permitirá que você modifique as seguintes opções:

Dados Descrição

Real-time Usage Update Interval (sec) Por padrão, o sensor de uso em tempo real será atualizado sempre que uma leitura chegar. Se esses dados forem muito frequentes, você poderá configurar esse valor para acelerar os dados. Quando definido como um número inteiro positivo X , o sensor será atualizado apenas uma vez a cada X segundos. Em outras palavras, se definido como 30, você obterá um novo uso em tempo real a cada ~ 30 segundos.

Dados	Descrição
`Real-time Usage Update Interval (sec)`	Por padrão, o sensor de uso em tempo real será atualizado sempre que uma leitura chegar. Se esses dados forem muito frequentes, você poderá configurar esse valor para acelerar os dados. Quando definido como um número inteiro positivo `X` , o sensor será atualizado apenas uma vez a cada `X` segundos. Em outras palavras, se definido como 30, você obterá um novo uso em tempo real a cada ~ 30 segundos.

Seleção do medidor

O fluxo de configuração tentará automaticamente identificar seu gateway e SmartMeter. No momento, apenas um é suportado por conta. O primeiro identificado será usado. Se não se pode encontrar, o processo de configuração deve falhar.

Se a seleção do seu medidor falhar, uma primeira etapa deve ser ativar o log para o componente (consulte o log). Se isso não fornecer informações sobre o problema, abra um problema do GitHub.

Log

Se você tiver algum problema e quiser olhar para os logs, essa integração fornecerá um logbose no nível de depuração. Isso pode ser ativado adicionando o seguinte ao seu arquivo configuration.yaml .

 logger :
  default : info
  logs :
    custom_components.duke_energy_gateway : debug
    pyduke_energy.client : debug
    pyduke_energy.realtime : debug

Desenvolvimento

Sugiro usar o contêiner de dev para desenvolvimento, abrindo no Código do Visual Studio com code . e clicando na opção de reabrir com o recipiente de dev. No código VS, você pode executar a tarefa "Run Home Assistant na porta 9123" e depois acessá -la via http: // localhost: 9123.

Se você deseja instalar manualmente, pode instalar dependências dev com pip install -r requirements_dev.txt .

Antes de cometer, execute pre-commit run --all-files .

Trabalhando com versões em desenvolvimento `pyduke-energy`

Se você estiver trabalhando na implementação de novas alterações da pyduke-energy mas não deseja liberar a versão dessa biblioteca, pode configurar seu ambiente de desenvolvimento para instalar a partir de uma ramificação de trabalho remoto.

Atualize requirements_dev.txt para substituir o main em git+https://github.com/mjmeli/pyduke-energy@main com sua filial de trabalho e atualize o nome de usuário se você tiver um garfo (por exemplo, git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch :
Desinstalar versão em cache localmente de pyduke-energy : pip uninstall -y pyduke-energy
Requisitos de execução Instalação: pip install -r requirements_dev.txt