alryaz / hass-isp-cabinet

HomeAssistant ISP Cabinet

Провайдеры Интернет для Home Assistant

Предоставление информации о текущем состоянии ваших лицевых счетов провайдеров интернет.

Поддерживаемые провайдеры

Все провайдеры поддерживают следующие атрибуты:

• code: Номер лицевого счёта
• current_balance: Текущий баланс
• tariff_name: Название тарифа
• tariff_speed: Скорость тарифа
• tariff_speed_unit: Мера исчисления скорости
• tariff_monthly_cost: Ежемесячная стоимость тарифа

Также отдельные провайдеры поддерживают набор дополнительных атрибутов:

Название	Идентификатор	Рекомендуемый платёж payment_suggested	Требуемый платёж payment_required	Оплатить до payment_until	Бонусы bonuses	Адрес address	Клиент client
Almatel Альмател	almatel 2kom	Да1	Да	Да	Да	Да	Да
SevenSky ГорКом	sevensky gorcom	Да1	Да	Да	Нет	Да	Да
Sky Engineering	sky_engineering	Да	Нет	Да	Нет	Нет	Да
МГТС	mgts mts	Да1	Да	Да	Нет	Нет	Да
Акадо	в разработке

¹ Атрибут вычисляется посредством вычета текущего состояния баланса из ежемесячной стоимости тарифа.

Установка

Посредством HACS

1. Откройте HACS (через Extensions в боковой панели)
2. Добавьте новый произвольный репозиторий:
   1. Выберите Integration (Интеграция) в качестве типа репозитория
   2. Введите ссылку на репозиторий: https://github.com/alryaz/hass-isp-cabinet
   3. Нажмите кнопку Add (Добавить)
   4. Дождитесь добавления репозитория (занимает до 10 секунд)
   5. Теперь вы должны видеть доступную интеграцию ISP Cabinet в списке новых интеграций.
3. Нажмите кнопку Install чтобы увидеть доступные версии
4. Установите последнюю версию нажатием кнопки Install
5. Перезапустите HomeAssistant

Примечание: Не рекомендуется устанавливать ветку master. Она используется исключительно для разработки.

Вручную

Клонируйте репозиторий во временный каталог, затем создайте каталог custom_components внутри папки конфигурации вашего HomeAssistant (если она еще не существует). Затем переместите папку isp_cabinet из папки custom_components репозитория в папку custom_components внутри папки конфигурации HomeAssistant. Пример (при условии, что конфигурация HomeAssistant доступна по адресу /mnt/homeassistant/config) для Unix-систем:

git clone https://github.com/alryaz/hass-isp-cabinet.git hass-isp-cabinet
mkdir -p /mnt/homeassistant/config/custom_components
mv hass-isp-cabinet/custom_components/isp_cabinet /mnt/homeassistant/config/custom_components

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

Через интерфейс HomeAssistant

1. Откройте Настройки -> Интеграции
2. Нажмите внизу справа страницы кнопку с плюсом
3. Введите в поле поиска ISP Cabinet или ЛК Интернет-провайдера
   1. Если по какой-то причине интеграция не была найдена, убедитесь, что HomeAssistant был перезапущен после установки интеграции.
4. Выберите первый результат из списка
5. Выберите требуемого провайдера и введите данные вашей учётной записи для входа в личный кабинет
6. Нажмите кнопку Продолжить
7. Через несколько секунд начнётся обновление; проверяйте список ваших объектов на наличие объектов, чьи названия выглядят как <имя провайдера> <номер лицевого счёта>.

Через configuration.yaml

Базовая конфигурация

Для настройки данной интеграции потребуются данные авторизации в ЛК провайдера.
isp - Идентификатор провайдера (см. выше)
username - Имя пользователя (телефон / адрес эл. почты)
password - Пароль

isp_cabinet:
  isp: my_internet_provider
  username: !secret my_internet_provider_username
  password: !secret my_internet_provider_password

Несколько пользователей

Возможно добавить несколько пользователей. Для этого вводите данные, используя пример ниже:

isp_cabinet:
    # First account
  - isp: first_provider
    username: !secret first_provider_username
    password: !secret first_provider_password

    # Second account
  - isp: second_provider
    username: !secret second_provider_username
    password: !secret second_provider_password

    # Third account
  - isp: third_provider
    username: !secret third_provider_username
    password: !secret third_provider_password 

Изменение интервалов обновления

Если по какой-то причине Вам требуется обновлять данные чаще, чем по умолчанию, Вы можете переопределить интервал обновления одним из следующих образов:

isp_cabinet:
  ...
  # Интервал обновления данных
  scan_interval:
    hours: 6
    seconds: 3
    minutes: 1
    ...

  # ... также возможно задать секундами
  scan_interval: 21600