From 5168f07f44f429c51d5f4f2365d6bd4532fb863d Mon Sep 17 00:00:00 2001
From: nikzori <kzr.niki@gmail.com>
Date: Fri, 28 Jun 2024 11:46:39 +0300
Subject: [PATCH] readme edits

---
 Winner/ZigBee/README.md    |  2 +-
 Winner/ZigBee/README_en.md | 28 ++++++++++++++++++++++++++++
 2 files changed, 29 insertions(+), 1 deletion(-)

diff --git a/Winner/ZigBee/README.md b/Winner/ZigBee/README.md
index 155771d..4646adb 100644
--- a/Winner/ZigBee/README.md
+++ b/Winner/ZigBee/README.md
@@ -8,7 +8,7 @@ external_converters:
 
 ## Winner_ZigBee_Basic.js
 Базовая поддержка для Winner'а. Доступные данные:
-- Положение крана (открыт/закрыт)
+- Положение крана: открыт/закрыт
 - Статус тревоги
   - Из-за особенностей прошивки, тревогу можно только выключить.
 - Статус режима уборки
diff --git a/Winner/ZigBee/README_en.md b/Winner/ZigBee/README_en.md
index 8b13789..00b6c90 100644
--- a/Winner/ZigBee/README_en.md
+++ b/Winner/ZigBee/README_en.md
@@ -1 +1,29 @@
+# ZigBee2MQTT: config files
+Extension files for ZigBee2MQTT; only one of the files is required for device support.
+Extract the file into the `/data` folder. Add the following lines to `configuration.yaml` file in the same folder:
+```
+external_converters:
+  - Winner_ZigBee_Basic.js
+```
 
+## Winner_ZigBee_Basic.js
+Basic support for Winner. Available fields:
+- Valve position: open/closed
+- Alarm status
+    - Because of the device's firmware, you cannot turn the alarm on
+- Cleaning mode status
+- Battery charge level
+- Error code
+
+## Winner_ZigBee_dev.js
+**Works the same way as Basic version.**
+
+A version with the full list of the device DPs. Additional DPs will not work with Z2MQTT because of their non-standard implementation: you would need to write additional code for Z2MQTT libraries to properly parse the incoming data.
+
+E.g: any `sensor_*` DP is a 4 byte integer:
+```
+0xAA_AA_BB_CC , где:
+[AA_AA] - bit flags
+[BB]    - signal strength
+[CC]    - battery charge
+```
\ No newline at end of file