Upload files to "/"
This commit is contained in:
commit
64f12e6a38
118
README.en.md
Normal file
118
README.en.md
Normal file
@ -0,0 +1,118 @@
|
||||
[🇵🇱 Polish version](README.md)
|
||||
|
||||
|
||||
# TS0601_BY_RK.js
|
||||
Minimalist Zigbee2MQTT converter for Tuya TS0601 TRV heads (ON / OFF)
|
||||
|
||||
## Why this converter exists
|
||||
|
||||
This converter was created to solve a real-world problem:
|
||||
some Tuya TS0601 thermostatic radiator valves generate a huge amount of Zigbee reports, which:
|
||||
|
||||
- spam MQTT
|
||||
- cause constant state changes in Home Assistant
|
||||
- increase CPU usage and database load
|
||||
- destabilise automations
|
||||
- provide no real value in everyday use
|
||||
|
||||
In installations with many TRVs (a dozen or more), this resulted in:
|
||||
- Home Assistant slowdowns
|
||||
- difficult troubleshooting
|
||||
- unpredictable automation behaviour
|
||||
|
||||
## Conscious design decision
|
||||
|
||||
Instead of fighting every reported variable, a different approach was chosen:
|
||||
|
||||
minimalism over completeness
|
||||
|
||||
This converter:
|
||||
- removes all unnecessary exposes
|
||||
- ignores temperature, mode, and calibration reports
|
||||
- reduces control to a single simple action: ON / OFF
|
||||
|
||||
Result:
|
||||
- minimal Zigbee traffic
|
||||
- no MQTT spam
|
||||
- stable Home Assistant
|
||||
- predictable automations
|
||||
|
||||
## How the converter works
|
||||
|
||||
Tuya TS0601 TRVs are controlled using datapoint DP=2 (setpoint).
|
||||
|
||||
Mapping:
|
||||
- ON -> sends 45°C (valve forced fully open)
|
||||
- OFF -> sends 0°C (valve fully closed)
|
||||
|
||||
Any other value:
|
||||
- is treated as ON
|
||||
- is not corrected back to avoid generating additional Zigbee traffic
|
||||
|
||||
The state is published immediately after sending the command, without waiting for further device reports.
|
||||
|
||||
## What is NOT exposed (by design)
|
||||
|
||||
This converter deliberately does NOT expose:
|
||||
- target temperature
|
||||
- operating modes
|
||||
- calibration or offsets
|
||||
- diagnostic data
|
||||
|
||||
This is not a bug or missing feature — it is a deliberate limitation to ensure system stability.
|
||||
|
||||
## Exposed features
|
||||
|
||||
- Switch (ON / OFF) – main valve control
|
||||
- Battery (%) – if reported by the device
|
||||
- Local temperature (°C) – passive only
|
||||
|
||||
## How to add the converter to Zigbee2MQTT
|
||||
|
||||
1. Copy the file TS0601_BY_RK.js to the Zigbee2MQTT directory, for example:
|
||||
/zigbee2mqtt/external_converters/TS0601_BY_RK.js
|
||||
|
||||
If the external_converters directory does not exist, create it.
|
||||
|
||||
2. In /zigbee2mqtt/configuration.yaml add:
|
||||
```
|
||||
external_converters:
|
||||
- TS0601_BY_RK.js
|
||||
```
|
||||
|
||||
|
||||
3. Restart Zigbee2MQTT
|
||||
|
||||
## How to add a new TRV (fingerprint)
|
||||
|
||||
If your TS0601 TRV is not supported, you need to add its identifier.
|
||||
|
||||
1. In Zigbee2MQTT, check:
|
||||
- modelID
|
||||
- manufacturerName
|
||||
|
||||
Example:
|
||||
modelID: TS0601
|
||||
manufacturerName: _TZE200_xxxxxxxx
|
||||
|
||||
2. In TS0601_BY_RK.js add a new fingerprint entry:
|
||||
```
|
||||
{ modelID: 'TS0601', manufacturerName: '_TZE200_NOWYID' }
|
||||
```
|
||||
<img width="1371" height="1282" alt="add new trv" src="https://github.com/user-attachments/assets/f1e24681-78da-4464-8183-a78c7d2229dd" />
|
||||
|
||||
3. Restart Zigbee2MQTT
|
||||
|
||||
## Who this converter is for
|
||||
|
||||
- installations with many TRVs
|
||||
- systems sensitive to MQTT spam
|
||||
- simple open / close valve control
|
||||
- stable and predictable automations
|
||||
|
||||
It is NOT intended for users who expect full temperature control from Home Assistant.
|
||||
|
||||
## Summary
|
||||
|
||||
This converter does not try to be perfect.
|
||||
Its goal is stability, silence, and predictable behaviour.
|
||||
117
README.md
Normal file
117
README.md
Normal file
@ -0,0 +1,117 @@
|
||||
[🇬🇧 English version](README.en.md)
|
||||
|
||||
|
||||
# TS0601_BY_RK.js
|
||||
Minimalistyczny konwerter Zigbee2MQTT dla głowic Tuya TS0601 (ON / OFF)
|
||||
|
||||
## Po co ten konwerter istnieje
|
||||
|
||||
Ten konwerter powstał jako rozwiązanie realnego problemu:
|
||||
niektóre głowice termostatyczne Tuya TS0601 generują ogromne ilości raportów Zigbee, które:
|
||||
|
||||
- spamują MQTT
|
||||
- powodują ciągłe zmiany stanów w Home Assistant
|
||||
- zwiększają zużycie CPU i bazy danych
|
||||
- destabilizują automatyzacje
|
||||
- nie wnoszą realnej wartości w codziennym użytkowaniu
|
||||
|
||||
W instalacjach z wieloma głowicami (kilkanaście lub więcej) prowadziło to do:
|
||||
- spowolnienia Home Assistant
|
||||
- trudnej diagnostyki
|
||||
- nieprzewidywalnego działania automatyzacji
|
||||
|
||||
## Świadoma decyzja projektowa
|
||||
|
||||
Zamiast walczyć z każdą raportowaną zmienną, przyjęto podejście:
|
||||
|
||||
minimalizm zamiast kompletności
|
||||
|
||||
Konwerter:
|
||||
- usuwa wszystkie zbędne expose’y
|
||||
- ignoruje raporty temperatur, trybów i kalibracji
|
||||
- redukuje sterowanie do jednej prostej akcji: ON / OFF
|
||||
|
||||
Efekt:
|
||||
- minimalny ruch Zigbee
|
||||
- brak spamu MQTT
|
||||
- stabilny Home Assistant
|
||||
- przewidywalne automatyzacje
|
||||
|
||||
## Jak działa konwerter
|
||||
|
||||
Głowice Tuya TS0601 sterowane są poprzez datapoint DP=2 (setpoint).
|
||||
|
||||
Mapowanie:
|
||||
- ON -> wysyłane 45°C (zawór wymuszony maksymalnie otwarty)
|
||||
- OFF -> wysyłane 0°C (zawór zamknięty)
|
||||
|
||||
Każda inna wartość:
|
||||
- traktowana jest jako ON
|
||||
- nie jest korygowana zwrotnie, aby nie generować dodatkowego ruchu Zigbee
|
||||
|
||||
Stan publikowany jest natychmiast po wysłaniu komendy, bez oczekiwania na kolejne raporty z urządzenia.
|
||||
|
||||
## Co NIE jest udostępniane (celowo)
|
||||
|
||||
Ten konwerter świadomie nie udostępnia:
|
||||
- temperatury zadanej
|
||||
- trybów pracy
|
||||
- kalibracji i offsetów
|
||||
- danych diagnostycznych
|
||||
|
||||
Nie jest to błąd ani brak funkcji — to celowe ograniczenie, mające na celu stabilność systemu.
|
||||
|
||||
## Udostępnione expose
|
||||
|
||||
- Switch (ON / OFF) – główne sterowanie zaworem
|
||||
- Battery (%) – jeśli urządzenie raportuje
|
||||
- Local temperature (°C) – tylko pasywnie
|
||||
|
||||
## Jak dodać konwerter do Zigbee2MQTT
|
||||
|
||||
1. Skopiuj plik TS0601_BY_RK.js do katalogu Zigbee2MQTT, .:
|
||||
/zigbee2mqtt/external_converters/TS0601_BY_RK.js
|
||||
jesli katalog external_converters nie istnieje dodaj go
|
||||
|
||||
2. W pliku /zigbee2mqtt/configuration.yaml dodaj:
|
||||
```
|
||||
external_converters:
|
||||
- TS0601_BY_RK.js
|
||||
```
|
||||
|
||||
|
||||
3. Zrestartuj Zigbee2MQTT
|
||||
|
||||
## Jak dodać nową głowicę (fingerprint)
|
||||
|
||||
Jeśli Twoja głowica TS0601 nie jest obsługiwana, należy dodać jej identyfikator.
|
||||
|
||||
1. W Zigbee2MQTT sprawdź:
|
||||
- modelID
|
||||
- manufacturerName
|
||||
|
||||
Przykład:
|
||||
modelID: TS0601
|
||||
manufacturerName: _TZE200_xxxxxxxx
|
||||
|
||||
2. W pliku TS0601_BY_RK.js dodaj nowy fingerprint do listy:
|
||||
```
|
||||
{ modelID: 'TS0601', manufacturerName: '_TZE200_NOWYID' }
|
||||
```
|
||||
<img width="1371" height="1282" alt="add new trv" src="https://github.com/user-attachments/assets/f1e24681-78da-4464-8183-a78c7d2229dd" />
|
||||
|
||||
4. Zrestartuj Zigbee2MQTT
|
||||
|
||||
## Dla kogo ten konwerter jest przeznaczony
|
||||
|
||||
- instalacje z wieloma głowicami TRV
|
||||
- systemy wrażliwe na spam MQTT
|
||||
- proste sterowanie otwórz / zamknij
|
||||
- stabilne automatyzacje
|
||||
|
||||
Nie jest przeznaczony dla osób oczekujących pełnej kontroli temperatury z Home Assistant.
|
||||
|
||||
## Podsumowanie
|
||||
|
||||
Ten konwerter nie próbuje być idealny.
|
||||
Jego celem jest stabilność, cisza i przewidywalność działania.
|
||||
73
TS0601_BY_RK.js
Normal file
73
TS0601_BY_RK.js
Normal file
@ -0,0 +1,73 @@
|
||||
const exposes = require('zigbee-herdsman-converters/lib/exposes');
|
||||
const ea = exposes.access;
|
||||
|
||||
function intTo4BytesBE(value) {
|
||||
return [(value >> 24) & 0xFF, (value >> 16) & 0xFF, (value >> 8) & 0xFF, value & 0xFF];
|
||||
}
|
||||
|
||||
async function sendSetpoint(entity, setpoint) {
|
||||
const payload = {
|
||||
seq: 0,
|
||||
dpValues: [{
|
||||
dp: 2,
|
||||
datatype: 0x02,
|
||||
data: intTo4BytesBE(setpoint),
|
||||
}],
|
||||
};
|
||||
await entity.command('manuSpecificTuya', 'dataRequest', payload, {disableDefaultResponse: true});
|
||||
}
|
||||
|
||||
module.exports = [
|
||||
{
|
||||
fingerprint: [
|
||||
{ modelID: 'TS0601', manufacturerName: '_TZE200_b6wax7g0' },
|
||||
{ modelID: 'TS0601', manufacturerName: '_TZE204_pcdmj88b' }
|
||||
],
|
||||
model: 'TS0601-TRV-MANUAL-RK',
|
||||
vendor: 'Moes',
|
||||
description: 'TS0601 TRV manual ON/OFF (ON=45, OFF=0, auto-sync)',
|
||||
fromZigbee: [
|
||||
{
|
||||
cluster: 'manuSpecificTuya',
|
||||
type: ['commandDataResponse', 'commandDataReport'],
|
||||
convert: (model, msg, publish, options, meta) => {
|
||||
const dp = msg.data.dpValues[0].dp;
|
||||
const raw = msg.data.dpValues[0].data;
|
||||
const value = raw[3]; // ostatni bajt wystarcza dla setpoint
|
||||
|
||||
if (dp === 2) {
|
||||
if (value === 0) {
|
||||
return {state: 'OFF', current_heating_setpoint: 0};
|
||||
} else if (value >= 45) {
|
||||
return {state: 'ON', current_heating_setpoint: 45};
|
||||
} else {
|
||||
// jeżeli przyjdzie np. 22 → traktujemy jako ON, ale poprawki nie wysyłamy z fromZigbee
|
||||
return {state: 'ON', current_heating_setpoint: 45};
|
||||
}
|
||||
}
|
||||
},
|
||||
},
|
||||
],
|
||||
toZigbee: [
|
||||
{
|
||||
key: ['state'],
|
||||
convertSet: async (entity, key, value) => {
|
||||
let setpoint = 0;
|
||||
if (value.toLowerCase() === 'on') setpoint = 45;
|
||||
if (value.toLowerCase() === 'off') setpoint = 0;
|
||||
|
||||
await sendSetpoint(entity, setpoint);
|
||||
|
||||
// natychmiast publikujemy nowy stan
|
||||
return {state: {state: value.toUpperCase(), current_heating_setpoint: setpoint}};
|
||||
},
|
||||
},
|
||||
],
|
||||
exposes: [
|
||||
exposes.switch().withState('state', ea.ALL)
|
||||
.withDescription('ON = valve forced open (45°C), OFF = valve closed (0°C)'),
|
||||
exposes.numeric('battery', ea.STATE).withUnit('%').withDescription('Battery level'),
|
||||
exposes.numeric('local_temperature', ea.STATE).withUnit('°C').withDescription('Measured local temperature'),
|
||||
],
|
||||
},
|
||||
];
|
||||
Loading…
Reference in New Issue
Block a user