easee_hass

ВАЖНЫЙ!

Пожалуйста, обновитесь до версии 0.9.64 или более поздней как можно скорее, если вы используете версию между v0.9.58 и v0.9.62! Во всех версиях этой интеграции между v0.9.58 и v0.9.62 возникала проблема с обработкой ошибок повторного подключения signalr, которая приводила к множеству неудачных попыток доступа к серверам Easee signalr. Установка более новой версии поможет повысить стабильность серверов Easee и высвободить ресурсы для более быстрого реагирования. Возможно, у вас не возникло никаких проблем при установке, но внутри было много проблем. Более подробную информацию см. в примечаниях к выпуску версии 0.9.64.

Компонент зарядного устройства Easee EV для Home Assistant

Специальный компонент для поддержки зарядных устройств и эквалайзеров Easee EV.

Датчик состояния является датчиком по умолчанию и имеет следующие значения:

 disconnected
awaiting_start
charging
ready_to_charge
completed
error

Некоторые из других нестандартных датчиков, таких как ток и напряжение, по умолчанию отключены (отображаются как «недоступные»). Их можно включить в графическом интерфейсе HA через «Интеграции» -> «Имя Easee» -> «Устройства» -> «Имя эквалайзера Easee» и в разделе «Диагностика» щелкните «Ток/Напряжение» -> значок шестеренки, а затем «Включить». Каждый из этих датчиков также имеет атрибуты, которые содержат такие значения, как ток и напряжение на фазу. См. #271 о том, как использовать эти атрибуты.

Установка

Существует 2 различных метода установки пользовательского компонента.

установка HACS

1. Добавьте этот репозиторий из HACS->Интеграции.
2. Перезапустите Домашний помощник.
3. Установите компонент из Настройки->Интеграции. Возможно, вам придется очистить кеш браузера, чтобы интеграция Easee появилась в списке.

Установка Git

1. Убедитесь, что на вашем компьютере установлен git.
2. Перейдите в папку конфигурации домашнего помощника.
3. Создайте папку custom_components , поскольку ее не существует, перейдите в нее после создания.
4. Выполните следующую команду: git clone https://github.com/nordicopen/easee_hass.git easee
5. Запустите bash links.sh

Контролируемые зарядные устройства/эквалайзеры

Начиная с версии 0.9.47, интеграция включает только те зарядные устройства и эквалайзеры, которые были добавлены в официальное приложение Easee, а не показывает все, что доступно вошедшему в систему пользователю. Это изменение было сделано потому, что в более крупных установках в списке может быть от 10 до 100 зарядных устройств, что в большинстве случаев не имеет особого смысла. Поэтому, если вы не видите все свои продукты в интеграции, откройте официальное приложение и убедитесь, что они указаны там в первую очередь. Также обратите внимание, что если в приложение вообще не добавлены зарядные устройства, при установке будет отображаться сообщение об ошибке «В этой учетной записи не найдено сайтов».

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

Конфигурация выполняется в разделе «Конфигурация» > «Интеграции», где вы сначала настраиваете ее, а затем устанавливаете параметры того, что вы хотите отслеживать.

Использовать

Основное использование интеграций из пользовательского интерфейса должно быть самоочевидным. Интеграция определяет ряд сервисов, которые можно использовать из средств автоматизации и сценариев для управления зарядным устройством и процессом зарядки. Доступные службы можно найти в Home Assistant в разделе «Инструменты разработчика» -> «Сервисы».

Самый простой способ настроить сервисы и их параметры — использовать редактор автоматизации или инструменты разработчика. Однако вы также можете написать код в обычном формате yaml. Пользовательский интерфейс будет использовать device_id в качестве целевого объекта для служб. Это случайная строка, сгенерированная внутри HA, и она не очень удобна для пользователя. Чтобы упростить работу хардкорным программистам и обеспечить обратную совместимость с предыдущими версиями этой интеграции, вы также можете использовать charge_id или Circuit_id в качестве целей. Три примера, которые будут делать то же самое:

 service : easee.set_circuit_dynamic_limit
data :
  device_id : b40f1f45d28b0891
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  charger_id : EVK1234
  current_p1 : 10 

 service : easee.set_circuit_dynamic_limit
data :
  circuit_id : 30456
  current_p1 : 10

Подробную информацию об API Easee см. на странице https://developer.easee.cloud/reference.

Ведение журнала отладки

Полный журнал отладки можно включить, введя следующее в configuration.yaml и перезапустив Home Assistant.

 logger :
  default : info
  logs :
    pyeasee : debug
    custom_components.easee : debug 

Контейнер разработки

Одним из вариантов разработки является использование контейнера разработки VS Code. Вам необходимо установить Docker.

1. Откройте новый пустой vscode
2. Выберите Палитра команд -> Контейнеры разработки: Клонировать репозиторий в именованный том контейнера.
3. Следуйте подсказкам
4. Подождите, пока контейнер будет построен.
5. Нажмите Ctrl + Shift + P и выберите Tasks: Run Task > Run Home Assistant on port 9125 .
6. Подождите, пока запустится Home Assistant, и перейдите по адресу http://localhost:9125/.
7. Ознакомьтесь с пользовательским интерфейсом первого запуска Home Assistant.
8. Перейдите по адресу http://localhost:9125/config/integrations, нажмите Add Integration и добавьте интеграцию Easee .
9. Для отладки нажмите F5 , чтобы подключиться к Home Assistant, работающему в контейнере.

Всегда запускайте

$ make lint

прежде чем отправлять изменения.

Перевод

Мы используем Lokalise для обработки переводов. Они предоставляют нам потрясающую платформу, которую легко использовать и поддерживать.

Чтобы помочь с переводом интеграции Easee, нажмите здесь. Если вас попросят войти в систему, обычно проще всего использовать «Войти через GitHub».

Если вы хотите добавить новый язык, откройте проблему здесь, в этом репозитории.

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

Если вы хотите добавить новые элементы, требующие перевода, вам следует ввести их в /translations/en.json и отправить запрос на перевод. Новые ключи появятся в Lokalise после объединения PR.

Атрибуция, поддержка и сотрудничество

Этот проект был начат покойным Никласом Фондбергом, @fondberg. Репозиторий унаследовали его сотрудники.

Проект поддерживается