mirror of
https://github.com/andvikt/mega_hacs.git
synced 2025-12-11 00:54:28 +05:00
1270ea2ee2
- add ws28 support - add transitions to pwm - add units of measurement for all i2c sensors - remove mqtt support
85 lines
7.0 KiB
Markdown
85 lines
7.0 KiB
Markdown
|
||
|
||
# MegaD HomeAssistant integration
|
||
[](https://github.com/custom-components/hacs)
|
||
[](https://yoomoney.ru/to/410013955329136)
|
||
|
||
Интеграция с [MegaD-2561, MegaD-328](https://www.ab-log.ru/smart-house/ethernet/megad-2561)
|
||
|
||
Если вам понравилась интеграция, не забудьте поставить звезду на гитхабе - вам не сложно, а мне приятно ) А если
|
||
интеграция очень понравилась - еще приятнее, если вы воспользуетесь кнопкой доната )
|
||
|
||
Обновление прошивки MegaD можно делать прямо из HA с помощью [аддона](https://github.com/andvikt/mega_addon.git)
|
||
|
||
Подробная документация по [ссылке](https://github.com/andvikt/mega_hacs/wiki)
|
||
|
||
Предложения по доработкам просьба писать в [discussions](https://github.com/andvikt/mega_hacs/discussions), о проблемах
|
||
создавать [issue](https://github.com/andvikt/mega_hacs/issues/new/choose)
|
||
## Основные особенности:
|
||
- Настройка в веб-интерфейсе + [yaml](https://github.com/andvikt/mega_hacs/wiki/Кастомизация)
|
||
- Все порты автоматически добавляются как устройства (для обычных релейных выходов создается
|
||
`light`, для шим - `light` с поддержкой яркости, для цифровых входов `binary_sensor`, для датчиков
|
||
`sensor`)
|
||
- Поддержка rgb+w лент как с использованием диммеров, так и адресных лент на чипах ws28xx и подобных,
|
||
[подробнее про rgbw](https://github.com/andvikt/mega_hacs/wiki/rgbw)
|
||
- Плавное диммирование с поддержкой [transition](https://www.home-assistant.io/integrations/scene#using-scene-transitions)
|
||
для любых диммируемых объектов (в том числе с аппаратной поддержкой и без)
|
||
- Возможность работы с несколькими megad
|
||
- Обратная связь по [http](https://github.com/andvikt/mega_hacs/wiki/http)
|
||
будет выключена в версиях >= 1.0.0, тк в нем нет необходимости)
|
||
- Автоматическое восстановление состояний выходов после перезагрузки контроллера
|
||
- Автоматическое добавление/изменение объектов после перезагрузки контроллера
|
||
- [События](https://github.com/andvikt/mega_hacs/wiki/События) на двойные/долгие нажатия
|
||
- Команды выполняются друг за другом без конкурентного доступа к ресурсам megad, это дает гарантии надежного исполнения
|
||
большого кол-ва команд (например в сценах). Каждая следующая команда отправляется только после получения ответа о
|
||
выполнении предыдущей.
|
||
- поддержка [ds2413](https://www.ab-log.ru/smart-house/ethernet/megad-2w) в том числе несколько шиной (начиная с версии 0.4.1)
|
||
- поддержка расширителей MegaD-16I-XT, MegaD-16R-XT, MegaD-16PWM (начиная с версии 0.5.1)
|
||
- поддержка всех возможных датчиков в режиме I2C-ANY, полный список поддерживаемых датчиков
|
||
[по ссылке](https://github.com/andvikt/mega_hacs/wiki/i2c) (начиная с версии 0.6.1)
|
||
|
||
## Установка
|
||
Рекомендованный способ с поддержкой обновлений - [HACS](https://hacs.xyz/docs/installation/installation):
|
||
|
||
HACS - Integrations - Explore, в поиске ищем MegaD.
|
||
|
||
Чтобы включить возможность использования бета-версий, зайдите в HACS, найдите интеграцию MegaD, нажмите три точки,
|
||
там кнопка "переустановить" или reinstall, дальше нужно нажать галку "показывать бета-версии"
|
||
|
||
Обновления выполняются так же в меню HACS.
|
||
Информация об обновлениях приходит с некоторым интервалом, чтобы вручную проверить наличие обновлений
|
||
нажмите три точки возле интеграции в меню HACS и нажмите `обновить информацию`
|
||
|
||
Альтернативный способ установки:
|
||
```shell
|
||
# из папки с конфигом
|
||
wget -q -O - https://raw.githubusercontent.com/andvikt/mega_hacs/master/install.sh | bash -
|
||
```
|
||
Не забываем перезагрузить HA
|
||
|
||
## Настройка
|
||
`Настройки` -> `Интеграции` -> `Добавить интеграцию` в поиске ищем mega
|
||
|
||
Все имеющиеся у вас порты будут настроены автоматически. Вы можете менять названия, иконки и entity_id так же из интерфейса.
|
||
|
||
В самой меге необходимо прописать настройки:
|
||
```yaml
|
||
srv: "192.168.1.4:8123" # ip:port вашего HA
|
||
script: "mega" # это api интеграции, к которому будет обращаться контроллер
|
||
```
|
||
Так же необходимо настроить Mega-ID в настройках контроллера, для каждой меги id должен быть разным.
|
||
|
||
При любых изменениях настроек контроллера (типы входов, id и тд) необходимо в настройках интеграции нажать `Обновить
|
||
объекты`
|
||
|
||
## Зависимости
|
||
Для максимальной скорости реакции на команды сервера, рекомендуется выключить `имитацию http-ответа` в
|
||
настройках интеграции и настроить proxy_pass к HA, самый простой способ сделать это - воспользоваться
|
||
[специальным аддоном](https://github.com/andvikt/mega_addon/tree/master/mega-proxy)
|
||
|
||
Обновить ваш контроллер до последней версии, обновление прошивки MegaD можно делать
|
||
из HA с помощью [аддона](https://github.com/andvikt/mega_addon.git)
|
||
|
||
|
||
Подробная документация по [ссылке](https://github.com/andvikt/mega_hacs/wiki)
|