Sprinkler module released

Co-authored-by: Copilot <copilot@github.com>
2026-06-13 19:36:23 +03:00 · 2026-05-22 22:44:36 +03:00
parent 641b314218
commit 985d058c50
3 changed files with 202 additions and 50 deletions
--- a/documentation/Sprinkler_module.md
+++ b/documentation/Sprinkler_module.md
@@ -28,13 +28,13 @@ INIT			|  		true				| OFF                  | выключить клапана
 OFF          | vMax && !FREEZE             | FULL                 | выключить vIN, rDren|
 OFF          | ! vMax && !FREEZE    | DREN\_ON|включить rDren|
 DREN\_ON|fbDren (насос дренажа реально работает)|DREN\_OPERATE|
-DREN\_ON|таймаут 10 сек|DREN\_EMPTY|
+DREN\_ON|таймаут 10 сек|DREN\_EMPTY| насос так и не заработал - видимо в колодце пусто
 DREN\_EMPTY|включен цикл полива и бак не полон|VIN|включить клапан vIN для набора бака из водопровода|
-DREN\_OPERATE|fbDren (насос дренажа более не работает)|DREN\_EMPTY||
-VIN|fbDren|DREN\_OPERATE|вылючить клапан vIN для набора бака из водопровода|
-VIN, DREN\_OPERATE|vMax|FULL                 | выключить vIN, rDren|
-VIN|таймаут 1200 сек	| FAULT\_VIN| выключить vIN|
-DREN\_OPERATE|таймаут 1200 сек	|FAULT_DREN||
+DREN\_OPERATE| ! fbDren (насос дренажа более не работает)|DREN\_EMPTY||
+VIN|fbDren|DREN\_OPERATE|вылючить клапан vIN для набора бака из водопровода - заработал дренажный насос|
+VIN, DREN\_OPERATE|vMax|FULL                 | выключить vIN, rDren  - бак полон|
+VIN|таймаут 1200 сек	| FAULT\_VIN| выключить vIN - бак так и не наполнился|
+DREN\_OPERATE|таймаут 2000 сек	|FAULT_DREN|выключить rDren  - не смотря на продолжительную работу насоса бак не наполнен|



@@ -59,7 +59,8 @@ DREN\_OPERATE|таймаут 1200 сек	|FAULT_DREN||
   		},
   "nord":{"pin":6,"set":60,"cmd":1},
   "south":{"pin":7,"set":100,"cmd":1},
-   "trees":{"pin":10,"set":60,"cmd":2} 
+   "trees":{"pin":10,"set":60,"cmd":2},
+   "outlets:{} 

 	}]
 }
@@ -79,15 +80,19 @@ DREN\_OPERATE|таймаут 1200 сек	|FAULT_DREN||

 Контроллер должен передать это значение в выходной топик ```root/name/s_out/sprinkrer/garden/set``` и оно будет восстановлено при перезагрузке контроллера

+
 отработанный обьем воды или время будет сохраняться в параметре "val" каждой зоны (параметр будет автоматически увеличиваться при работе зоны, передаваться в соответствующий зоне топик для мониторинга и восстановления в случае перезагрузки контроллера)

 **Пример топика:** ```root/s_out/sprinkler/garden/val```

-Когда данный параметр достигнет значения, заданного в параметре "set" контроллер завершит полив данной зоны и перейдет к следующей.
+Когда данный параметр достигнет значения (или времени), заданного в параметре "set" контроллер завершит полив данной зоны и перейдет к следующей.
+
+Важно: если set=0 (по умолчанию) то время работы зоны не лимитируется. Если такая зона включена - система полива не будет отключаться после окончания полива прочих зон и насос не будет обесточиваться. Это удобно, если в системе полива есть водяная розетка для подключения поливочного шланга, которая всегда должна находиться под давлением. Такую зону конфигурируйте последней в списке.

 Для сброса счетчиков можно использовать как непосредственную установку значения параметра "val" для каждой зоны так и команду RESET, отправленную в нужную зону или в объект sprinkler через суффикс /cmd. 

 В последнем случае, контроллер итерационно сбросит счетчики в значение 0 для каждой зоны полива.
+А также, отключит систему полива, чтобы программа не стартовала в момент сброса счетчиков (например, в полночь)

 **Пример:** ```root/name/sprinkler/cmd -> RESET```

@@ -178,4 +183,128 @@ root/s_out/sprinkler/garden/cmd - ON или OFF - признак включен
 root/s_out/sprinkler/garden/$state - ON или OFF - признак того что зона поливается в настоящее время
 root/s_out/sprinkler/garden/val - текущее время или обьем полива данной зоны

+```
+
+### Пример конфигурации Home Assistant
+```
+sensor:
+  - name: "Полив бак Макс"
+    state_topic:  "root/s_out/sprinkler/$wMax"
+    
+  - name: "Полив бак Мin"
+    state_topic:  "root/s_out/sprinkler/$wMin"    
+    
+  - name: "Полив водопровод"
+    state_topic:  "root/s_out/sprinkler/$vIN"    
+    
+  - name: "Полив дренаж вкл"
+    state_topic:  "root/s_out/sprinkler/$rDren"    
+
+  - name: "Полив дренаж качает"
+    state_topic:  "root/s_out/sprinkler/$fbDren"    
+    
+  - name: "Полив насос вкл"
+    state_topic:  "root/s_out/sprinkler/$rPump"    
+
+  - name: "Полив насос качает"
+    state_topic:  "root/s_out/sprinkler/$fbPump"       
+    
+  - name: "Полив состояние"
+    state_topic:  "root/s_out/sprinkler/$state"  
+    
+  - name: "Полив ошибка"
+    state_topic:  "root/s_out/sprinkler/$fault"
+    
+  - name: "Полив юг выполнено"
+    state_topic:  "root/s_out/sprinkler/south/val"   
+
+  - name: "Полив север выполнено"
+    state_topic:  "root/s_out/sprinkler/nord/val"   
+
+  - name: "Полив капельный выполнено"
+    state_topic:  "root/s_out/sprinkler/trees/val"   
+   
+  - name: "Полив блокировки"
+    state_topic:  "root/s_out/sprinkler/ctrl"   
+    
+switch:
+
+  - name: "Полив"
+    state_topic:  "root/s_out/sprinkler/cmd"
+    command_topic: "root/air/sprinkler/cmd"
+    availability_topic: "root/air/$state"
+    payload_available: "ready"
+    payload_not_available: "disconnected" 
+
+  - name: "Полив север"
+    state_topic:  "root/s_out/sprinkler/nord/cmd"
+    command_topic: "root/air/sprinkler/nord/cmd"
+    availability_topic: "root/air/$state"
+    payload_available: "ready"
+    payload_not_available: "disconnected" 
+
+  - name: "Полив юг"
+    state_topic:  "root/s_out/sprinkler/south/cmd"
+    command_topic: "root/air/sprinkler/south/cmd"
+    availability_topic: "root/air/$state"
+    payload_available: "ready"
+    payload_not_available: "disconnected" 
+
+  - name: "Полив капельный"
+    state_topic:  "root/s_out/sprinkler/trees/cmd"
+    command_topic: "root/air/sprinkler/trees/cmd"
+    availability_topic: "root/air/$state"
+    payload_available: "ready"
+    payload_not_available: "disconnected" 
+
+  - name: "Полив розетки"
+    state_topic:  "root/s_out/sprinkler/outlets/cmd"
+    command_topic: "root/air/sprinkler/outlets/cmd"
+    availability_topic: "root/air/$state"
+    payload_available: "ready"
+    payload_not_available: "disconnected" 
+    
+button:
+ - name: "Полив сброс"
+   command_topic: "root/air/sprinkler/cmd"
+   payload_press: "RESET"
+   
+ - name: "Полив блокировка"
+   command_topic: "root/air/sprinkler/cmd"
+   payload_press: "FREEZE"
+
+ - name: "Полив разблокировка"
+   command_topic: "root/air/sprinkler/cmd"
+   payload_press: "UNFREEZE"   
+   
+ - name: "Полив разрешить"
+   command_topic: "root/air/sprinkler/cmd"
+   payload_press: "ENABLE"
+
+ - name: "Полив запретить"
+   command_topic: "root/air/sprinkler/cmd"
+   payload_press: "DISABLE"      
+
+number:
+
+ - name: "Полив юг"
+   state_topic:  "root/s_out/sprinkler/south/set"   
+   command_topic: "root/air/sprinkler/south/set"   
+   min: 0
+   max: 6000
+   
+ - name: "Полив север"
+   state_topic:  "root/s_out/sprinkler/nord/set"   
+   command_topic: "root/air/sprinkler/nord/set"   
+   min: 0
+   max: 6000   
+   
+ - name: "Полив капельный"
+   state_topic:  "root/s_out/sprinkler/trees/set"   
+   command_topic: "root/air/sprinkler/trees/set"   
+   min: 0
+   max: 6000
+   
+          
+
 ```