Descarga de ha duke energy gateway - Descargar código fuente de ha duke energy gateway

ha duke energy gateway

Generador de energía

v0.1.7

Descargar

Importante - desaprobado

Duke Energy cerró el programa Pilot de Gateway a fines de junio de 2023. Esta integración ha dejado de funcionar y está en desuso.

Duke Energy Gateway

Esta es una integración personalizada para asistente de origen. Trae el uso de energía en tiempo real de Duke Energy a través del programa Pilot Duke Energy Gateway.

Esta integración aprovecha la biblioteca pyduke-energy , también escrita por mí, para extraer datos. Esta API no es oficial y puede dejar de trabajar en cualquier momento (ver descargo de responsabilidad).

¡Requisitos previos! (Por favor lea)

Debe tener una puerta de enlace de Duke Energy conectada a su SmartMeter para que esto funcione. Este es un dispositivo separado que su medidor inteligente y es proporcionado por un programa de invitación solo en este momento. Si no sabe qué es esto, entonces probablemente no lo tenga. Esta integración no admite ningún otro método para recuperar datos (ver el requisito de puerta de enlace).

Sensores

Este componente configurará las siguientes entidades:

`sensor.duke_energy_current_usage_w`

Representa el uso de potencia en tiempo real en Watts.
Estos datos se empujan desde el dispositivo de puerta de enlace cada 1-3 segundos. Nota: Esto produce muchos datos. Si este intervalo de actualización es demasiado frecuente para usted, puede configurar un intervalo de estrangulamiento en segundos (consulte la configuración a continuación).
Tenga en cuenta que, dado que este es el uso de potencia, no se puede usar como es para el tablero de energía del asistente doméstico. En su lugar, puede usar el sensor sensor.duke_energy_usage_today_kwh , o necesita alimentar este sensor en tiempo real a través de la integración integral de Riemann Sum.
Hay atributos adicionales disponibles que contienen la identificación del medidor y la ID de puerta de enlace.

`sensor.duke_energy_usage_today_kwh`

Representa el consumo de energía actual en kilovatios-hora (desde las 0:00 hora local hasta 23:59 hora local, luego restablecimiento).
Estos datos se encuestan cada 60 segundos, pero los datos pueden retrasarse hasta 15 minutos debido a retrasos en Duke Energy que lo informan (ver limitaciones en el repositorio pyduke-energy ).
Esto se puede usar como es para el tablero de consumo de energía del asistente doméstico.
Hay atributos adicionales disponibles que contienen el ID del medidor, la ID de puerta de enlace y la marca de tiempo de la última medición.

Instalación

Instalación de HACS

Agregue como un repositorio personalizado en Configuración en HACS: mjmeli/ha-duke-energy-gateway y elija Integration como categoría.
Busque "Duke Energy Gateway" en HACS y la integración ahora debe devolverse como resultado de la búsqueda. Haga clic en él, haga clic en el botón "Descargar" y caminar a través de las indicaciones para descargar.
Reiniciar asistente de casa
En la ui de Ha, vaya a "Configuración" -> "Dispositivos y servicios", asegúrese de estar en la pestaña Integraciones, luego haga clic en "+" y busque "Duke Energy Gateway". Esto le permitirá configurarlo.

Instalación manual

Usando la herramienta de elección, abra el directorio (carpeta) para su configuración HA (donde encuentra configuration.yaml ).
Si no tiene un directorio (carpeta) custom_components allí, debe crearlo.
En el directorio custom_components (carpeta) cree una nueva carpeta llamada duke_energy_gateway .
Descargue todos los archivos de custom_components/duke_energy_gateway/ Directory (carpeta) en este repositorio.
Coloque los archivos que descargó en el nuevo directorio (carpeta) que creó.
Reiniciar asistente de casa
En la ui de Ha, vaya a "Configuración" -> "Dispositivos y servicios", asegúrese de estar en la pestaña Integraciones, luego haga clic en "+" y busque "Duke Energy Gateway". Esto le permitirá configurarlo.

Configuración

La configuración se realizará en la interfaz de usuario. Inicialmente, deberá proporcionar los siguientes datos:

Datos	Descripción
`email`	Su correo electrónico de inicio de sesión a Duke Energy.
`password`	Su contraseña de inicio de sesión a Duke Energy.

Después de configurar la integración, podrá hacer una configuración adicional haciendo clic en "Configurar" en la página de integración. Esto le permitirá modificar las siguientes opciones:

Datos Descripción

Real-time Usage Update Interval (sec) De manera predeterminada, el sensor de uso en tiempo real se actualizará cada vez que entre una lectura. Si estos datos son demasiado frecuentes, puede configurar este valor para acelerar los datos. Cuando se establece en un entero positivo X , el sensor solo se actualizará una vez cada X segundos. En otras palabras, si se establece en 30, obtendrá un nuevo uso en tiempo real cada ~ 30 segundos.

Datos	Descripción
`Real-time Usage Update Interval (sec)`	De manera predeterminada, el sensor de uso en tiempo real se actualizará cada vez que entre una lectura. Si estos datos son demasiado frecuentes, puede configurar este valor para acelerar los datos. Cuando se establece en un entero positivo `X` , el sensor solo se actualizará una vez cada `X` segundos. En otras palabras, si se establece en 30, obtendrá un nuevo uso en tiempo real cada ~ 30 segundos.

Selección de medidores

El flujo de configuración intentará identificar automáticamente su puerta de enlace y su SmartMeter. En este momento, solo uno es compatible por cuenta. Se utilizará el primero identificado. Si no se puede encontrar, el proceso de configuración debería fallar.

Si la selección de su medidor falla, un primer paso debe ser habilitar el registro del componente (ver registro). Si esto no da una idea del problema, abra un problema de GitHub.

Explotación florestal

Si se encuentra con algún problema y desea investigar los registros, esta integración proporciona registro detallado en el nivel de depuración. Eso se puede habilitar agregando lo siguiente a su archivo configuration.yaml .

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

Desarrollo

Sugiero usar el contenedor Dev para el desarrollo abriendo en el código de Visual Studio con code . y haciendo clic en la opción de volver a abrir con el contenedor Dev. En el código VS, puede ejecutar la tarea "Ejecutar el asistente de inicio en el puerto 9123" y luego acceder a ella a través de http: // localhost: 9123.

Si desea instalar manualmente, puede instalar DevSpendencias con pip install -r requirements_dev.txt .

Antes de comprometerse, ejecute pre-commit run --all-files .

Trabajar con versiones `pyduke-energy` de desarrollo

Si está trabajando en la implementación de nuevos cambios de pyduke-energy pero no desea lanzar la versión de esa biblioteca, puede configurar su entorno de desarrollo para instalar desde una rama de trabajo remoto.

Actualice requirements_dev.txt para reemplazar el main en git+https://github.com/mjmeli/pyduke-energy@main con su rama de trabajo y actualice el nombre de usuario si tiene una bifurcación (por ejemplo, git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch )
Desinstalar la versión de pyduke-energy de Pyduke: pip uninstall -y pyduke-energy
Instalación de requisitos de re -ejecutar: pip install -r requirements_dev.txt