ha duke energy gateway

Важно - устарело

Duke Energy закрыл пилотную программу Gateway в конце июня 2023 года. Эта интеграция перестала функционировать и устарела.

Duke Energy Gateway

Это пользовательская интеграция для домашнего помощника. Он получает использование энергии в реальном времени от Duke Energy через пилотную программу Duke Energy Gateway.

Эта интеграция использует библиотеку pyduke-energy , также написанную мной, для извлечения данных. Этот API очень неофициальный и может перестать работать в любое время (см. Отказ от ответственности).

Предварительные условия! (Пожалуйста, прочитайте)

У вас обязательно подключить Guke Energy Gateway с вашим Smartmeter для работы. Это отдельное устройство, чем ваш интеллектуальный счетчик, и в настоящее время предоставляется программой только приглашения. Если вы не знаете, что это такое, то, вероятно, у вас его нет. Эта интеграция не поддерживает какой -либо другой метод получения данных (см. Требование шлюза).

Датчики

Этот компонент настроит следующие объекты:

sensor.duke_energy_current_usage_w

• Представляет использование власти в реальном времени в Уоттах.
• Эти данные выталкиваются с устройства шлюза каждые 1-3 секунды. Примечание: это создает много данных. Если этот интервал обновления слишком часты для вас, вы можете настроить интервал дросселирования за считанные секунды (см. Конфигурацию ниже).
• Обратите внимание, что, поскольку это использование мощности, его нельзя использовать, как для домашнего помощника энергетической панели. Вместо этого вы можете использовать датчик sensor.duke_energy_usage_today_kwh , или вам необходимо подавать этот датчик в реальном времени через интегральную интеграцию SUM RIEMANN.
• Доступны дополнительные атрибуты, содержащие идентификатор счетчика и идентификатор шлюза.

sensor.duke_energy_usage_today_kwh

• Представляет сегодняшнее потребление энергии в киловатт-часах (с 0:00 по местному времени до 23:59 по местному времени, а затем сброс).
• Эти данные опрошены каждые 60 секунд, но данные могут быть отложены до 15 минут из-за задержек в Duke Energy, сообщающей о нем (см. Ограничения в репо-репо pyduke-energy ).
• Это можно использовать как для домашнего помощника по энергетической панели энергопотребления.
• Доступны дополнительные атрибуты, содержащие идентификатор счетчика, идентификатор шлюза и временную метку последнего измерения.

Установка

Установка HACS

1. Добавьте в качестве пользовательского репозитория в настройках в HAC: mjmeli/ha-duke-energy-gateway и выберите Integration в качестве категории.
2. Поиск «Guke Energy Gateway» в HACS, и теперь интеграция должна быть возвращена в качестве результата поиска. Нажмите на него, нажмите кнопку «Скачать» и пройдите по подсказкам для загрузки.
3. Перезапустить домашний помощник
4. В HA UI перейдите на «Настройки» -> «Устройства и сервисы», убедитесь, что вы находитесь на вкладке Integrations, затем нажмите «+» и поищите «Gupe Energy Gateway». Это позволит вам настроить его.

Ручная установка

1. Использование инструмента выбора откройте каталог (папку) для вашей конфигурации HA (где вы найдете configuration.yaml ).
2. Если у вас нет каталога custom_components (папка), вам нужно его создать.
3. В каталоге custom_components (папка) Создайте новую папку с именем duke_energy_gateway .
4. Загрузите все файлы из custom_components/duke_energy_gateway/ каталог (папка) в этом репозитории.
5. Поместите файлы, которые вы загружали в новый каталог (папка), который вы создали.
6. Перезапустить домашний помощник
7. В HA UI перейдите на «Настройки» -> «Устройства и сервисы», убедитесь, что вы находитесь на вкладке Integrations, затем нажмите «+» и поищите «Gupe Energy Gateway». Это позволит вам настроить его.

Конфигурация

Конфигурация будет сделана в пользовательском интерфейсе. Первоначально вам нужно будет предоставить следующие данные:

Данные	Описание
email	Ваше вход в систему электронной почты Duke Energy.
password	Ваш пароль для входа в Duke Energy.

После настройки интеграции вы сможете сделать дополнительную конфигурацию, нажав «Настроить» на странице интеграции. Это позволит вам изменить следующие параметры:

Данные

Описание

Real-time Usage Update Interval (sec)

По умолчанию датчик использования в режиме реального времени будет обновляться в любое время, когда начнется чтение. Если эти данные слишком часты, вы можете настроить это значение, чтобы затопить данные. При установке на положительное целое число X датчик будет обновляться только один раз каждые X секунды. Другими словами, если вы устанавливаете 30, вы получите новое использование в реальном времени каждые ~ 30 секунд.

Выбор счетчика

Поток конфигурации автоматически попытается идентифицировать ваш шлюз и Smartmeter. Прямо сейчас только один поддерживается на учетную запись. Первый идентифицирован будет использован. Если нельзя найти, процесс конфигурации должен сбой.

Если ваш выбор измерителя не сбои, должен быть первый шаг, чтобы включить регистрацию для компонента (см. Журнал). Если это не дает понять проблему, пожалуйста, откройте проблему GitHub.

Регистрация

Если вы столкнетесь с любыми проблемами и хотите изучить журналы, эта интеграция обеспечивает многословную регистрацию на уровне отладки. Это может быть включено, добавив следующее в ваш файл configuration.yaml .

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

Разработка

Я предлагаю использовать контейнер Dev для разработки, открывшись в коде Visual Studio с code . и нажав на опцию для повторного открытия с Dev Container. В коде VS вы можете запустить задачу «запустить домашний помощник в порту 9123», а затем получить доступ к нему через http: // localhost: 9123.

Если вы хотите установить вручную, вы можете установить Dev -зависимости с помощью pip install -r requirements_dev.txt .

Прежде чем запустить, запустите pre-commit run --all-files .

Работа с версиями в разработке pyduke-energy

Если вы работаете над внедрением новых изменений от pyduke-energy но не хотите выпускать версию этой библиотеки, вы можете настроить среду разработки для установки из удаленной рабочей филиала.

1. Обновление requirements_dev.txt , чтобы заменить main in git+https://github.com/mjmeli/pyduke-energy@main с вашим рабочим филиалом и обновите имя пользователя, если у вас есть вилка (eg git+https://github.com/notmjmeli/pyduke-energy@new-feature-dev-branch
2. Удалить локально кэшированную версию pyduke-energy : pip uninstall -y pyduke-energy
3. Повторно запустить требования: pip install -r requirements_dev.txt

Взносы приветствуются!

Если вы хотите внести свой вклад в это, прочитайте рекомендации взносов

Кредиты

Этот проект был сгенерирован из @oncleben31 Home Assistant Component Semplate Cookiecutter.

Шаблон кода был в основном взят из шаблона @ludeeus ingetration_blueprint

---