add http support

readme.md

@@ -8,18 +8,71 @@
   `light`, для шим - `light` с поддержкой яркости, для цифровых входов `binary_sensor`, для датчиков
   `sensor`)
 - Возможность работы с несколькими megad
-- Обратная связь по mqtt
+- Обратная связь по mqtt или http (на выбор)
 - События на двойные/долгие нажатия
 - Команды выполняются друг за другом без конкурентного доступа к ресурсам megad, это дает гарантии надежного исполнения
   большого кол-ва команд (например в сценах). Каждая следующая команда отправляется только после получения ответа о
   выполнении предыдущей.
 
 ## Зависимости
-**Важно!!** Перед использованием необходимо настроить интеграцию [mqtt](https://www.home-assistant.io/integrations/mqtt/) 
-в HomeAssistant
+**Важно!!** Для максимальной совместимости необходимо настроить интеграцию [mqtt](https://www.home-assistant.io/integrations/mqtt/) 
+в HomeAssistant, а так же обновить ваш контроллер до последней версии, тк были важные обновления в части mqtt
 
-Для максимальной совместимости необходимо обновить ваш контроллер до последней версии, тк были важные обновления в части
-mqtt
+## HTTP in
+Начиная с версии `0.3.1` интеграция стала поддерживать обратную связь без mqtt, используя http-сервер. Для этого в настройках
+интеграции необходимо снять галку с `использовать mqtt`
+
+В самой меге необходимо прописать настройки:
+```yaml
+srv: "192.168.1.4:8123" # ip:port вашего HA
+script: "mega" # это api интеграции, к которому будет обращаться контроллер
+```
+
+Входы будут доступны как binary_sensor, а так же в виде событий `mega.sensor`.
+События можно обрабатывать так:
+```yaml
+- alias: some double click
+  trigger:
+    - platform: event
+      event_type: mega.sensor
+      event_data:
+        pt: 1
+  action:
+    - service: light.toggle
+      entity_id: light.some_light
+```
+Для binary_sensor имеет смысл использовать режим P&R, для остальных режимов - лучше пользоваться событиями.
+
+## Ответ на входящие события от контроллера
+Контроллер ожидает ответ от сервера, который может быть сценарием (по умолчанию интеграция отвечает `d`, что означает 
+запустить то что прописано в поле act в настройках порта).
+
+Поддерживаеются шаблоны HA. Это может быть использовано, например, для запоминания яркости (тк сам контроллер этого не 
+умеет). В шаблоне можно использовать параметры, которые передает контроллер (m, click, pt, value)
+
+Примеры:
+```yaml
+mega:
+  mega1: # id меги, который вы сами придумываете в конфиге в UI
+    4: # номер порта, с которого ожидаются события
+      response_template: 5:2 # простейший пример без шаблона. Каждый раз когда будет приходить сообщение на этот порт, 
+                             # будем менять состояние на противоположное
+    5:
+      # пример с использованием шаблона, порт 1 будет выключен если он сейчас включен и включен с последней сохраненной 
+      # яркостью если он сейчас выключен     
+      response_template: >-
+        {% if is_state('light.some_port_1', 'on') %}
+        1:0
+        {% else %}
+        1:{{state_attr('light.some_port_1', 'brightness')}}
+        {% endif %}
+    6:
+      # в шаблон так же передаются все параметры, которые передает контроллер (pt, cnt, m, click)
+      # эти параметры можно использовать в условиях или непосредственно в шаблоне в виде {{pt}}
+      response_template: >-
+        {% if m==2 %}1:0{% else %}d{% endif %}
+    
+```
 
 ## Установка
 Рекомендованный способ с поддержкой обновлений - [HACS](https://hacs.xyz/docs/installation/installation):
@@ -66,22 +119,8 @@ mega:
 ```
 
 ## События
-`binary_sensor` срабатывает когда цифровой выход принимает значение 'ON', вместе с этим
-он сохраняет полученные параметры от меги в аттрибутах. Атрибутами можно пользоваться так:
-```yaml
-- alias: some double click
-  trigger:
-    - platform: state
-      entity_id: binary_sensor.mega_1
-      attribute: cnt
-      to: 2
-  action:
-    - service: light.toggle
-      entity_id: light.some_light
-```
-Однако, особенность state-триггера в атоматизациях HA в том, что он срабатывает только когда state меняется. Это может 
-мешать, тк если вы повторно совершите двойной клик, стейт уже не поменяется, поэтому рекомендуется
-пользоваться event-триггером.
+`binary_sensor` срабатывает когда цифровой выход принимает значение 'ON'. `binary_sensor` имеет смысл использовать
+только с режимом входа P&R
 
 При каждом срабатывании `binary_sensor` так же сообщает о событии типа `mega.sensor`.
 События можно использовать в автоматизациях, например так:
@@ -91,7 +130,7 @@ mega:
     - platform: event
       event_type: mega.sensor
       event_data:
-        entity_id: binary_sensor.mega_1
+        pt: 1
         cnt: 2
   action:
     - service: light.toggle