Настройка интеграции с Home Assistant

  Данная инструкция предназначена для начинающих пользователей и поможет вам настроить интеграцию устройств AlphaSE с системой умного дома Home Assistant (HA). В результате вы сможете управлять всеми вашими устройствами через единый интерфейс.

1. Установка программ и служб на Raspberry Pi
1.1. Первоначальная настройка Raspberry Pi
1.1.1. Скачайте и установите Raspberry Pi Imager с официального сайта (https://www.raspberrypi.com/software/)
1.1.2. Запишите на SD-карту образ Home Assistant OS (выберите в меню Imager: Raspberry Pi Device → Ваша модель → Other specific-1.1.purpose OS → Home Automation → Home Assistant → Home Assistant OS)

1.1.3. Вставьте SD-карту в Raspberry Pi, подключите питание и сетевой кабель
1.1.4. Подождите 10-15 минут до полной загрузки системы

1.1.5. Откройте браузер и перейдите по адресу http://homeassistant.local:8123 или по IP адресу HA

1.1.6. Пройдите первоначальную настройку (создайте учетную запись, укажите имя, местоположение)

  Обязательно сохраните данные для авторизации. С помощью них вы будете авторизоваться в Web интерфейсе HA, в приложении HA на смартфоне, а AlphaSE Hub2 будет использовать эти же данные для авторизации в MQTT сервере.

1.2. Установка и настройка службы MQTT (через веб-интерфейс)
1.2.1. В левом меню выберите Настройки → Приложения

1.2.2. Нажмите кнопку "Установить приложение" в правом нижнем углу
1.2.3. В поиске найдите Mosquitto broker и нажмите на него

1.2.4. Нажмите кнопку Установить (Install), дождитесь завершения установки и нажмите кнопку Запустить
1.2.5. Включите опцию Watchdog

1.2.6. Убедитесь, что служба запущена - появились кнопки "Остановить" и "Перезапустить"
1.3. Для просмотра топиков MQTT сервера установите на ПК программу MQTT Explorer. В ходе работы она поможет лучше понять принцип работы и публикации данных в MQTT брокере HA. При настройке подключения укажите те же имя пользователя и пароль, которые указывали при настройке HA.

1.4. Установка приложения File Editor
1.4.1. Вернитесь в Настройки → Приложения→ Установить приложение
1.4.2. Найдите File Editor и нажмите на него

1.4.3. Нажмите Установить (Install)
1.4.4. После установки нажмите Запустить (Start)
1.4.5. Включите опции Watchdog и Показывать в боковой панели (Show in sidebar)

1.4.6. Теперь в боковом меню появится иконка ? для доступа к файлам
2. Настройка статического IP-адреса HA
2.1. В левом меню выберите Настройки → Система → Сеть
2.3. Выберите ваш сетевой интерфейс (обычно eth0 или enu1u для проводной сети)
2.4. Нажмите IPv4
2.5. Выберите Статический (Static)
2.6. Заполните поля:
IP-адрес: например, 192.168.0.130 (выберите адрес, не занятый в вашей сети)
Маска подсети: 255.255.255.0
Шлюз: 192.168.0.1 (адрес вашего роутера)
DNS-сервер: 8.8.8.8 или адрес роутера

  Используйте IP адрес из вашей сети. Не устанавливайте данные наугад. Если сетевые параметры HA окажутся несовместимыми с настройками сети, доступ к HA будет потерян. 

2.7. Нажмите Сохранить и подтвердите перезагрузку сети
2.8. После применения настроек запишите этот IP-адрес (он понадобится для доступа к HA)
3. Получение файла конфигурации HA из личного кабинета
3.1. Откройте браузер и перейдите на сайт https://alice.smart-elec.ru
3.2. Войдите в личный кабинет, используя свои учетные данные
3.3. Перейдите в настройки хаба и в разделе Интеграции скачайте файл конфигурации для Home Assistant

3.4. Нажмите кнопку Скачать конфигурацию
3.5. Сохраните файл на компьютере (например, ha_asehaaaaaXXXX_devices.yaml)
3.6. Откройте этот файл в любом текстовом редакторе и просмотрите содержимое. Вы увидите конфигурацию всех ваших устройств AlphaSE, сгруппированную по типам.
4. Создание папки Packages и загрузка файла конфигурации
4.1. В боковом меню HA нажмите на иконку File Editor (?)

4.2. Нажмите кнопку Browse File System в верхнем углу и вы увидите список файлов и папок в директории /homeassistant/
4.3. Нажмите кнопку Новая папка (New Folder) в правом верхнем углу
4.4. Назовите папку packages и нажмите ОК

4.5. Нажмите на папку packages, чтобы войти в неё
4.6. Нажмите кнопку Загрузить файл (Upload File) и выберите скачанный ранее файл ha_asehaaaaaXXXX_devices.yaml
4.7. Убедитесь, что файл загрузился и отображается в списке
Проверка: Путь к файлу должен быть /homeassistant/packages/ ha_asehaaaaaXXXX_devices.yaml

5. Изменение файла /homeassistant/configuration.yaml
5.1. В File Editor вернитесь в корневую папку, нажав на /homeassistant вверху
5.2. Найдите файл configuration.yaml и нажмите на него для редактирования
5.3. Прокрутите файл до конца и добавьте следующие строки:

5.4. Проверьте, что отступы соблюдены (2 пробела перед packages, 4 пробела перед asehaaaaaa590)
5.5. Нажмите кнопку Сохранить (Save) в правом верхнем углу
6. Проверка и перезапуск
6.1. В левом меню выберите Настройки → Система
6.2. В правом верхнем углу нажмите Перезапустить → Перезапустить систему
6.3. Подождите 2-3 минуты до полной загрузки
6.4. После перезапуска перейдите в Настройки → Устройства и службы
6.5. Вы должны увидеть новые устройства AlphaSE в разделе MQTT
6.6. Нажмите на любое устройство и проверьте его состояние и управление
7. Настройка AlphaSE Hub2
7.1. С компьютера зайдите в личный кабинет на сайте alice.smart-elec.ru
7.2. Убедитесь, что хаб имеет версию прошивки не менее 14. При необходимости обновите прошивку

7.3. Зайдите в настройки хаба и посмотрите его IP для подключения

7.4. В строке адреса браузер введите IP адрес AlphaSE Hub2. Для хаба из примера - http://192.168.0.200
7.5. Укажите имя пользователя admin и пароль. Последний можно найти на в настройках хаба на вкладке "Интеграции".
7.6. Войдите в Web интерфейс AlphaSE Hub2 и настройте подключение к MQTT, используя IP адрес HA, имя пользователя и пароль, указанные при регистрации (п.1.1.6). Если после нажатия кнопки "Применить" в течение 10 секунд статус подключения изменится на "Вкл", хаб успешно подключился к MQTT.

  Поздравляем! Вы успешно настроили интеграцию устройств AlphaSE с Home Assistant. Теперь вы можете управлять всеми вашими устройствами через единый интерфейс, создавать автоматизации и сценарии.

Устранение возможных проблем

Проблема: Устройства не отображаются
Решение:
Проверьте, правильно ли загрузился файл конфигурации
Убедитесь, что в файле configuration.yaml нет ошибок (можно проверить на вкладке Настройки → Система → Исправления)
Включите отладку MQTT (уже добавлено в configuration.yaml выше) и посмотрите логи

Проблема: Не удается подключиться к HA по адресу homeassistant.local
Решение:
Используйте статический IP-адрес, который вы назначили ранее, например: http://192.168.0.202:8123
Проверьте, что Raspberry Pi включен и подключен к сети