Handleiding · bij versie 1.4.6 · Bekijk op GitHub

Deze handleiding komt uit de openbare repository van de integratie voor Home Assistant. Er staat nog de oude naam OpenThermostat in, en het kastje heet er E32: de BBQKees Gateway E32 V2 waar Emthera nu op draait.

Apparaten: wat OpenThermostat leest, en hoe zeker we dat weten #

De firmware en de hoofdrepository van het project zijn op dit moment niet openbaar. Wat deze handleidingen zeggen over het downloaden van de firmware of een release-ZIP van GitHub, het bijwerken van de firmware van de E32 vanuit Home Assistant of met Check for updates, en het GitHub-formulier van het testerprogramma werkt voorlopig niet. De Home Assistant-integratie installeer en werk je bij via de Marketplace, zoals beschreven. Een paar verwijzingen naar pagina's die niet openbaar zijn hebben hier geen link. Vragen of problemen: open een issue.

English

OpenThermostat werkt met apparaten van veel merken. Deze pagina zegt welke routes voor elk apparaat werken, welke apparaten we getest hebben en hoe: bevestigd met een echte opname (wat een echt apparaat stuurde, bewaard als test), of gemaakt uit de apparaatbeschrijving, nog niet bevestigd (gemaakt uit wat Zigbee2MQTT of Home Assistant zegt dat het apparaat stuurt). Elk apparaat in de tabel hieronder is een test die bij elke build draait, dus een wijziging waardoor het niet meer gelezen wordt valt op vóór een release.

Staat je apparaat er niet in, of wordt het niet goed gelezen? Een apparaat aanmelden: stuur een opname. Het kost een paar minuten, en vanaf dan wordt elke build getest tegen jouw apparaat.

Elk apparaat, via Home Assistant #

Deze routes hangen niet af van het merk:

• Radiatorkraan: elke kraan die Home Assistant kent als climate-entiteit (ZHA, Z-Wave, Zigbee2MQTT, Shelly, een cloudintegratie). Kies hem in het formulier van de ruimte, onderdeel Radiatorkranen; Home Assistant stuurt hem dan volgens de regels van de E32. Zijn gewenste temperatuur komt uit temperature van de entiteit, of uit target_temp_low als het apparaat alleen een temperatuurbereik heeft. Zijn batterij komt van een batterijsensor op hetzelfde apparaat, zijn stand van een standsensor als hij die heeft.
• Instelapparaat (de thermostaat of knop waarmee je een ruimte instelt): elke climate-, number- of input_number-entiteit. Een thermostaat met alleen een temperatuurbereik (zoals de Bosch Room thermostat II) werkt via zijn target_temp_low.
• Thermometer: elke temperatuursensor in Home Assistant, of een Bluetooth-thermometer die de E32 zelf hoort (pvvx, Shelly H&T, Xiaomi).

Zigbee2MQTT-kranen die de E32 zelf stuurt #

Voor de kraanmodellen die hij kent (Bosch BTH-RA, Sonoff TRVZB, Sonoff TRV Gen2, Tuya TV02) praat de E32 zelf met Zigbee2MQTT op dezelfde MQTT-broker, ook als Home Assistant weg is. Kies voor elke andere Zigbee2MQTT-kraan Anders (alleen gewenste temperatuur). Die leest de gangbare namen in deze volgorde en gebruikt de eerste die de kraan stuurt:

• gewenste temperatuur: occupied_heating_setpoint, dan current_heating_setpoint; de E32 schrijft de gewenste temperatuur onder de naam die de kraan zelf gebruikt;
• stand: position, dan pi_heating_demand; alleen getoond, de ketel rekent nooit op de stand van een kraan die de E32 niet kent;
• batterij: battery (een percentage) en battery_low (een melding);
• modus: system_mode, dan preset; alleen om te zien dat iemand de kraan heeft uitgezet, die de E32 dan met rust laat.

Een bericht dat de E32 niet kan lezen (te groot, afgebroken, geen apparaatstatus) valt nooit stil weg: de pagina Systeem → Diagnose en systeemlog van de E32 en het tabblad Diagnose in Home Assistant (Verbinding met de E32) zeggen "Berichten die de E32 niet kon lezen sinds hij startte: 3, laatste: zigbee2mqtt/…, te groot (7,1 KB)". Zet die regel in je melding.

De apparatentabel #

De tabel wordt gemaakt uit de testverzameling (test/fixtures/devices/) door tools/dev/device_matrix.py, dus hij zegt precies wat de tests bevatten.

Radiatorkranen #

Instelapparaten #

Thermometers #

Ketels #