1. Общее описание
Скопировано
Home Assistant - программное обеспечение с открытым исходным кодом для домашней
автоматизации. Система поддерживает устройства разных производителей, обеспечивает создание
сложных сценариев автоматизации
с возможностью использования голосовых помощников и визуализацией посредством
веб-интерфейса.
2. Список поддерживаемых шлюзов
Скопировано
Ниже представлен список шлюзов, поддерживающих управление с Home Assistant
| Бренд | Серия | Шлюз | Поддержка на Wiren Board | Примечание |
| GREE |
HOME |
GR-1-MB-B |
Нативная |
с версии wb-2301
|
| DAIKIN |
PRO |
DK-1-MB-B |
Нативная |
с версии wb-2307
|
| DAIKIN |
PRO |
DK-5-MB-B |
Нативная |
с версии wb-2501
|
| GREE |
PRO |
GR-3-MB-B |
Нативная |
с версии wb-2501
|
| HISENSE |
PRO |
HS-3-MB-B |
Нативная |
с версии wb-2501
|
| HISENSE |
PRO |
HS-5-MB-B |
Нативная |
с версии wb-2501
|
| HISENSE |
PRO |
HS-6-MB-B |
Нативная |
с версии wb-2501
|
| HITACHI |
PRO |
HT-1-MB-B |
Нативная |
с версии wb-2501
|
| MDV |
PRO |
MD-1-MB-B |
Нативная |
с версии wb-2501
|
| MDV |
PRO |
MD-3-MB-B |
Нативная |
с версии wb-2501
|
|
MITSUBISHI ELECTRIC
|
PRO |
ME-1-MB-B |
Нативная |
с версии wb-2307
|
|
MITSUBISHI HEAVY
|
PRO |
MH-2-MB-B |
Нативная |
с версии wb-2501
|
|
TOSHIBA
|
PRO |
TB-1-MB-B |
Шаблон |
Скачать шаблон |
| TCL |
PRO |
TCL-1-MB-B |
Нативная |
с версии wb-2501
|
| TCL |
PRO |
TCL-3-MB-B |
Нативная |
с версии wb-2501
|
| TCL |
PRO |
TCL-6-MB-B |
Нативная |
с версии wb-2501
|
3. Логическая схема
Скопировано
4. Cхема подключения
Скопировано
5. Карты регистров
СкопированоКарта регистров описывает функциональность шлюза
|
GR-1-MB-B.xlsx |
HOME |
GREE |
|
AUX-1-MB-B.xlsx |
PRO |
AUX |
|
DK-1-MB-B.xlsx |
PRO |
DAIKIN |
|
DK-5-MB-B.xlsx |
PRO |
DAIKIN |
|
GR-3-MB-B.xlsx |
PRO |
GREE |
|
HR-1-MB-B.xlsx |
PRO |
HAIER |
|
HS-3-MB-B.xlsx |
PRO |
HISENSE |
|
HS-5-MB-B.xlsx |
PRO |
HISENSE |
|
HS-6-MB-B.xlsx |
PRO |
HISENSE |
|
HT-1-MB-B.xlsx |
PRO |
HITACHI |
|
MD-1-MB-B.xlsx |
PRO |
MDV |
|
MD-3-MB-B.xlsx |
PRO |
MDV |
|
ME-1-MB-B.xlsx |
PRO |
MITSUBISHI ELECTRIC |
|
MH-2-MB-B.xlsx |
PRO |
MITSUBISHI HEAVY |
|
TB-1-MB-B.xlsx |
PRO |
TOSHIBA |
|
TCL-1-MB-B.xlsx |
PRO |
TCL |
|
TCL-3-MB-B.xlsx |
PRO |
TCL |
|
TCL-6-MB-B.xlsx |
PRO |
TCL |
6. Шаблоны
СкопированоЕсли вы используете версию ПО на контроллере Wiren Board, в которой отсутствует нативная поддержка шлюзов ONOKOM, то вы можете скачать необходимый шаблон и установить его по этой инструкции.
|
GR-1-MB-B.json |
HOME |
GREE |
|
AUX-1-MB-B.json |
PRO |
AUX |
|
DK-1-MB-B.json |
PRO |
DAIKIN |
|
DK-5-MB-B.json |
PRO |
DAIKIN |
|
GR-3-MB-B.json |
PRO |
GREE |
|
HR-1-MB-B.json |
PRO |
HAIER |
|
HS-3-MB-B.json |
PRO |
HISENSE |
|
HS-5-MB-B.json |
PRO |
HISENSE |
|
HS-6-MB-B.json |
PRO |
HISENSE |
|
HT-1-MB-B.json |
PRO |
HITACHI |
|
MD-1-MB-B.json |
PRO |
MDV |
|
MD-3-MB-B.json |
PRO |
MDV |
|
ME-1-MB-B.json |
PRO |
MITSUBISHI ELECTRIC |
|
MH-2-MB-B.json |
PRO |
MITSUBISHI HEAVY |
|
TB-1-MB-B.json |
PRO |
TOSHIBA |
|
TCL-1-MB-B.json |
PRO |
TCL |
|
TCL-3-MB-B.json |
PRO |
TCL |
|
TCL-6-MB-B.json |
PRO |
TCL |
7. Инструкция по подключению
Скопировано7.1 Wiren Board
СкопированоДля корректного подключения устройство сначала необходимо добавить в контроллер Wiren Board
7.1.1 Загрузка шаблона
Скопировано
Все дальнейшие настройки выполняются на контроллере Wiren Board 7 со следующими
параметрами:
- Ревизия: 7.3.3E/11 675
- Версия ПО: wb-2404
- Ветка: Релиз
Для начала нам потребуется обновить контроллер до последней версии прошивки
Открываем приложение «Терминал»
1. Вводим протокол, имя пользователя и IP адрес контроллера в локальной сети. В
нашем случае: ssh root@192.168.151.133
2. Вводим пароль. По умолчанию это - wirenboard
3. Нажимаем кнопку «Enter»
Затем проверяем, есть ли обновление в репозиториях. Для этого вводим команду
«apt update»
Контроллер обновлен. Переходим к следующему шагу
Следующим шагом переходим в браузер и вводим IP адрес контроллера в локальной сети.
В нашем случае: «192.168.199.79»
Далее заходим в Настройки → Права доступа → «Администратор»
Ставим галочку в пункте
«Я принимаю всю ответственность за свои действия»
Нажимаем «Применить»
Теперь мы можем управлять всеми функциями контроллера
После чего мы переходим во вкладку «Конфигурационные файлы» и выбираем пункт «Настройка драйвера serial-устройств»
Ждем загрузки конфигуратора, после чего выбираем порт, к которому подключен шлюз
В нашем случае это «/dev/ttyRS485-1»
Нажимаем пункт "Добавить устройство"
Жмем на пункт с выбором устройств и ищем в списке пункт «Кондиционеры»
а в нем наш шлюз.
На данном этапе наш шлюз отсутствует, поэтому мы будем добавлять для него шаблон
самостоятельно
Подключаемся к контроллеру через приложение ForkLift , в нашем случае
она для macOS, для Windows можете использовать WinSCP
1. Protocol: SFTP
2. Server: 192.168.199.79
3. Username: root
4. Password: по умолчанию wirenboard
6. Нажимаем «Connect»
Следующим шагом переходим на веб-сервис GitHub где хранятся шаблоны ONOKOM и переходим в раздел «Wiren Board»
Выбираем шаблон WB-ONOKOM-AIR-TN-1-MB-B.json
Затем нажимаем на три точки в правом верхнем углу и нажимаем «Download»
Переходим в приложение ForkLift
Сейчас мы находимся в директории 192.168.199.79/mnt/data/root
Нам нужно попасть на одну директорию назад.
Переходим и попадаем в 192.168.199.79/mnt/data
Переходим в директорию etc
Переходим в директорию wb-mqtt-serial.conf.d
Переходим в директорию templates
Добавляем шаблон WB-ONOKOM-AIR-TN-1-MB-B.json. Просто перетащив его в нужное окно
Шаблон WB-ONOKOM-AIR-TN-1-MB-B.json загружен
7.1.2 Добавление устройства
Скопировано
Заходим в веб-интерфейс Wiren Board и нажимаем на «Настройки». В открывшемся списке выбираем «Конфигурационные файлы». Далее выбираем «Настройка драйвера serial-устройств»
Выбираем порт к которому подключен шлюз TION. В нашем примере он подключен в первый порт (RS485-1). Затем нажимаем “Добавить устройство”
Смотрим, что выбран первый порт, в который подключен шлюз (RS485-1)
Нажимаем на выпадающий список
Далее в разделе “Кондиционеры” из списка выбираем шаблон ONOKOM-AIR-TN-1-MB-B (Адаптер для бризера TION 4S)
Нажимаем “Добавить устройство”
Вводим адрес устройства. В нашем случае “1” Далее выбираем параметры, которые будут отображаться в плитке устройства. После того как выбраны все необходимые параметры, нажимаем “Сохранить настройки”
Далее переходим на вкладку “Устройства” и видим плитку управления бризером TION
7.2 Home Assistant
СкопированоПосле успешной настройки устройства на контроллере можно его добавлять в Home Assistant
7.2.1 Установка Home Assistant на Wiren Board
Скопировано
Для установки Home Assistant нам потребуется сперва установить
Docker. Это приложение позволяет запускать различное программное обеспечение в
изолированной среде из контейнеров.
Для корректной установки Docker на Wiren Board выполняем следующие
действия:
Открываем программу Терминал и подключаемся к контроллеру Wiren Board по ssh командой ssh root@IP-адрес вашего контроллера. В нашем случае это будет выглядеть так:
ssh root@192.168.199.79
Вводим пароль (по умолчанию wirenboard) и нажимаем Enter. При
вводе пароля на экране ничего не отображается
Получаем подтверждение входа
Устанавливаем зависимости для Docker:
apt update && apt install ca-certificates curl gnupg lsb-release iptables
Добавляем репозиторий с пакетами Docker:
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | tee /etc/apt/sources.list.d/docker.list > /dev/null
Добавляем для репозитория ключ:
curl -fsSL https://download.docker.com/linux/debian/gpg | gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
На контроллере с версией прошивки wb-2304 и старше вводим команды:
update-alternatives --set iptables /usr/sbin/iptables-legacy
update-alternatives --set ip6tables /usr/sbin/ip6tables-legacy
Создаём директорию на контроллере для хранения конфигурационных файлов Docker, а также формируем для неё символическую ссылку (симлинк):
mkdir /mnt/data/etc/docker && ln -s /mnt/data/etc/docker /etc/docker
Создаём директорию для хранения файлов-образов Docker
mkdir /mnt/data/.docker
Открываем во встроенном редакторе Nano файл daemon.json:
nano /etc/docker/daemon.json
Добавляем в файл следующее:
{
"data-root": "/mnt/data/.docker",
"log-driver": "json-file",
"log-opts": {
"max-size": "10m",
"max-file": "3"
}
}
Находясь в редакторе, сохраняем изменения комбинацией клавиш Ctrl+S и
закрываем его c Ctrl+X
Запускаем установку Docker командой:
apt update && apt install docker-ce docker-ce-cli containerd.io
После завершения установки проверяем работу программы:
docker run hello-world
Если в терминале появится надпись «Hello from Docker!», установка прошла корректно. Если нет, требуется перезагрузка. Выполнить её можно командой:
reboot
Создаём директорию для файлов контейнера Home Assistant:
mkdir -p /mnt/data/.docker-compose/home-assistant
Переходим в созданную директорию:
cd /mnt/data/.docker-compose/home-assistant
Создаём директорию для конфигурационных файлов контейнера:
mkdir -p config/home-assistant
Создаём директорию для медиа файлов контейнера:
mkdir -p store/media
Открываем конфигурационный файл во встроенном редакторе Nano:
nano docker-compose.yaml
Устанавливаем следующие настройки в файле:
services:
# HomeAssistant
homeassistant:
container_name: home-assistant
image: homeassistant/home-assistant:latest
volumes:
# Local path where your home assistant config will be stored
- ./config/home-assistant:/config
- ./store/media:/media
- /etc/localtime:/etc/localtime:ro
- /run/dbus:/run/dbus:ro
restart: unless-stopped
network_mode: host
environment:
TZ: "${MYTZ}"
privileged: true
labels:
- "com.centurylinklabs.watchtower.monitor-only=true"
Сохраняем изменения и закрываем файл нажатием клавиш Ctrl+S и Ctrl+X
Указываем часовой пояс. В нашем примере выбрана Самара:
echo "MYTZ=Europe/Samara" >> .env
Запускаем сборку контейнера:
docker compose up -d
Во время сборки будет скачана последняя версия Home Assistant, после чего произойдёт запуск программы в фоновом режиме.
Для работы с Home Assistant нужно зайти в веб-интерфейс. Откройте ваш браузер и
введите IP-адрес вашего Wiren Board : 8123.
В нашем случае доступ к интерфейсу происходит по адресу: http://192.168.151.79:8123
При первом входе потребуется зарегистрироваться. Сделать это можно, нажав на "Создать мой умный дом". Использованные при регистрации логин и пароль понадобятся для входа в интерфейс в дальнейшем
7.2.2 Загрузка шаблонов
Скопировано
Заходим на веб-сервис GitHub, где хранятся шаблоны ONOKOM и переходим в раздел Home Assistant
Выбираем соответствующий шаблон. В нашем примере это будет TCL-1-MB-B
Нажимаем на кнопку «Download» в правом верхнем углу окна
Открываем файловый менеджер, в данном примере используется Filezilla
Вводим:
- Хост: IP-адрес Wiren Board
- Имя пользователя: root
- Пароль: wirenboard (по умолчанию)
- Порт: 22
Нажимаем на «Быстрое соединение»
Для загрузки шаблона сначала необходимо внести изменения в конфигурационный
файл. В нашем примере Home Assistant запускается с помощью программы
Docker на
контроллере Wiren Board.
С такой конфигурацией он располагается по следующему
пути:
/mnt/data/.docker-compose/home-assistant/config/home-assistant/configuration.yaml
В файле configuration.yaml добавьте следующие строки:
homeassistant:
packages: !include_dir_named packages
Также следует создать директорию packages. Разместить её нужно по следующему
пути: /mnt/data/.docker-compose/home-assistant/config/home-assistant/
В созданную директорию копируем скачанный шаблон Home Assistant
В скопированном файле нужно заменить все значения в угловых скобках на Modbus-адрес шлюза. В нашем примере у устройства адрес 1. Если используете другое наименование MQTT топиков, то требуется это учитывать при переименовании
Готовый шаблон выглядит следующим образом
7.2.3 Добавление устройства ONOKOM в интерфейс Home Assistant
Скопировано
Для доступа к веб-интерфейсу откройте браузер и введите в адресную строку IP-адрес
устройства, на котором установлен Home Assistant и номер порта
8123 через двоеточие.
Например: 192.168.151.251:8123
Для входа нужно ввести «Имя пользователя» и «Пароль», которые были указаны ранее при регистрации
Для добавления устройства в систему переходим в раздел «Настройки»
В открывшемся меню выбираем «Устройства и службы»
Откроется вкладка интеграций. Нажимаем на «Добавить интеграцию»
Откроется меню брендов
С помощью поисковой строки находим MQTT
Выбираем MQTT без дополнительных опций
Откроется окно добавления службы. В нём нужно прописать:
- Брокер: адрес брокера (по умолчанию localhost)
- Порт: номер MQTT порта WIren Board (по умолчанию
1883)
Остальные поля можно не заполнять, если они не установлены для брокера на Wiren Board
Устройство будет добавлено. Управление им доступно в разделе «Обзор»
На данной странице располагаются все доступные переключатели кондиционера. Для доступа к карточке климата нужно нажать на иконку с тремя точками в правом верхнем углу панели
8. Демонстрация работы приложения
СкопированоНиже представлен функционал приложения. Наличие и варианты режимов выключателей и сенсоров на панелях управления будет зависеть от функционала используемого шлюза
Управление целевой температурой
Установка режимов
Выбор скоростей
Управление положением горизонтальных жалюзи
Установка режимов качания жалюзи
Дополнительные режимы и переключатели расположены на отдельных секциях панели
На панели сенсоров также выводятся ошибки от кондиционера, если это поддерживается используемой моделью шлюза
На панели списков можно управлять более сложными режимами устройства
9. Фигуры для скачивания
СкопированоВы можете скачать фигуры для вставки в свои проекты в необходимом формате
Растровый формат
.png
.jpg
Векторный формат
.svg
| Бренд | Серия | Шлюз | Формат | |||
| GREE |
HOME |
GR-1-MB-B |
PNG |
JPG |
SVG |
|
| AUX |
PRO |
AUX-1-MB-B |
PNG |
JPG |
SVG |
|
| DAIKIN |
PRO |
DK-1-MB-B |
PNG |
JPG |
SVG |
|
| DAIKIN |
PRO |
DK-5-MB-B |
PNG |
JPG |
SVG |
|
| DAIKIN адаптер DK-A5 |
PRO |
DK-A5 |
PNG |
JPG |
SVG |
|
| GREE |
PRO |
GR-3-MB-B |
PNG |
JPG |
SVG |
|
| HAIER |
PRO |
HR-1-MB-B |
PNG |
JPG |
SVG |
|
| HISENSE |
PRO |
HS-3-MB-B |
PNG |
JPG |
SVG |
|
| HISENSE |
PRO |
HS-5-MB-B |
PNG |
JPG |
SVG |
|
| HISENSE адаптер HS-A5 |
PRO |
HS-A5 |
PNG |
JPG |
SVG |
|
| HISENSE |
PRO |
HS-6-MB-B |
PNG |
JPG |
SVG |
|
| HISENSE адаптер HS-A6 |
PRO |
HS-A6 |
PNG |
JPG |
SVG |
|
| HITACHI |
PRO |
HT-1-MB-B |
PNG |
JPG |
SVG |
|
| MDV |
PRO |
MD-1-MB-B |
PNG |
JPG |
SVG |
|
| MDV |
PRO |
MD-3-MB-B |
PNG |
JPG |
SVG |
|
| MITSUBISHI ELECTRIC |
PRO |
ME-1-MB-B |
PNG |
JPG |
SVG |
|
| MITSUBISHI HEAVY |
PRO |
MH-2-MB-B |
PNG |
JPG |
SVG |
|
| TOSHIBA |
PRO |
TB-1-MB-B |
PNG |
JPG |
SVG |
|
| TCL |
PRO |
TCL-1-MB-B |
PNG |
JPG |
SVG |
|
| TCL |
PRO |
TCL-3-MB-B |
PNG |
JPG |
SVG |
|
| TCL |
PRO |
TCL-6-MB-B |
PNG |
JPG |
SVG |
|
10. Функции шлюзов
СкопированоОписываем функции шлюзов, доступные в приложении Home Assistant
Скопировано
Сайт создан - тех. отделом ONOKOM