TapHome

Sensibo Inteligentní ovládání klimatizace

Packet Parser → HTTP
Přidal
Poslední aktualizace: 06. 2026
Sensibo Inteligentní ovládání klimatizace

Šablona Sensibo Air Conditioner Smart Control připojuje TapHome k jakékoli klimatizaci ovládané infračerveným signálem prostřednictvím inteligentního ovladače Sensibo (Sky, Air nebo Air Pro). Zařízení Sensibo se umístí v blízkosti klimatizace, naučí se její IR kódy a zpřístupní kompletní ovládání přes Sensibo Cloud API v2. TapHome komunikuje se servery Sensibo přes HTTPS a přijímá stavová data ve formátu JSON — není potřeba žádná fyzická kabeláž ke klimatizaci.

Šablona poskytuje 8 zařízení pokrývajících zapnutí/vypnutí, výběr provozního režimu, rychlost ventilátoru, polohu vertikálních lamel, termostat s nastavením cílové teploty, monitorování teploty a vlhkosti, ovládání displeje a upozornění na údržbu filtru. Jediné požadavky jsou účet Sensibo, zařízení Sensibo připojené k Wi-Fi a API klíč.

Konfigurace

Sensibo účet a nastavení zařízení

Zařízení Sensibo (Sky, Air nebo Air Pro) musí být nainstalováno, spárováno s klimatizací přes mobilní aplikaci Sensibo a připojeno k Wi-Fi síti. Zařízení musí být zobrazeno jako online v aplikaci Sensibo před pokračováním s integrací TapHome.

Získání API klíče
  1. Otevřete home.sensibo.com/me/api ve webovém prohlížeči
  2. Přihlaste se pomocí přihlašovacích údajů účtu Sensibo
  3. Klikněte na Generate API Key, pokud ještě nemáte vygenerovaný klíč
  4. Zkopírujte API klíč — je to dlouhý alfanumerický řetězec

API klíč poskytuje přístup ke všem zařízením Sensibo na vašem účtu.

Zjištění identifikátoru POD

POD je unikátní identifikátor pro každé zařízení Sensibo. Kde ho najdete:

  • V aplikaci Sensibo — otevřete nastavení zařízení a vyhledejte Device ID
  • Přes API — zavolejte GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} a poznamenejte si pole id pro každé zařízení

Každé zařízení Sensibo má jiný POD. Pokud máte více zařízení Sensibo, musíte šablonu importovat samostatně pro každé s jeho vlastním POD.

Parametry importu

Při importování šablony v TapHome zadejte:

  • API Key — API klíč z vývojářského portálu Sensibo
  • POD — unikátní identifikátor pro konkrétní jednotku Sensibo
Závislost na internetu

Jedná se o čistě cloudovou integraci. Všechna data procházejí přes servery Sensibo (home.sensibo.com:443). Šablona nebude fungovat bez aktivního internetového připojení na TapHome Core i na zařízení Sensibo.

Schopnosti zařízení

Monitorování teploty a vlhkosti

Senzor Current Temperature & Humidity čte vestavěné snímače teploty a vlhkosti na zařízení Sensibo. Teplota je hlášena v jednotce nakonfigurované na zařízení Sensibo (typicky Celsius). Vlhkost je dělena 100 pro rozsah analogového vstupu TapHome 0–1 (např. 60 % se zobrazí jako 0,60).

Ovládání termostatu

Thermostat poskytuje kompletní ovládání klimatu s nastavením cílové teploty. Čte aktuální pokojovou teplotu, vlhkost a cílovou teplotu ze stavu klimatizace. Zápis nového setpointu odešle PATCH požadavek na Sensibo API, které následně vyšle odpovídající IR příkaz klimatizaci. Dostupný teplotní rozsah závisí na spárovaném modelu klimatizace (typicky 16–32 °C).

Ovládání napájení

Spínač Power zapíná a vypíná klimatizaci. Po vypnutí Sensibo odešle IR příkaz k vypnutí. Po zapnutí klimatizace obnoví poslední aktivní režim.

Výběr režimu klimatizace

Přepínač AC Mode ovládá provozní režim se 6 stavy:

HodnotaRežim
0VYP
1Chlazení
2Topení
3Ventilátor
4Sušení
5Auto

Nastavení režimu na 0 (VYP) odešle příkaz k vypnutí namísto změny režimu. Dostupné režimy závisí na spárované klimatizaci — ne všechny jednotky podporují každý režim.

Ovládání rychlosti ventilátoru

Přepínač Fan Level ovládá rychlost ventilátoru se 6 úrovněmi:

HodnotaÚroveň
0Žádná
1Nízká
2Střední
3Vysoká
4Auto
5Silná

Dostupné úrovně ventilátoru závisí na modelu spárované klimatizace.

Ovládání vertikálních lamel

Přepínač Vertical Swing ovládá polohu vertikálních lamel s 10 stavy:

HodnotaPoloha
0Zastaveno
1Fixní nahoře
2Fixní střed-nahoře
3Fixní střed
4Fixní střed-dole
5Fixní dole
6Rozsah nahoře
7Rozsah střed
8Rozsah dole
9Rozsah plný

Dostupné polohy lamel závisí na spárované klimatizaci. Mnohé jednotky podporují pouze podmnožinu těchto poloh.

Ovládání displeje

Spínač Display Light ovládá LED displej na klimatizaci. Ne všechny modely klimatizací podporují ovládání displeje přes IR — pokud spárovaná jednotka tuto funkci nepodporuje, příkaz nebude mít žádný efekt.

Upozornění na údržbu filtru

Senzor Filter Clean Required (jazýčkový kontakt) indikuje, kdy filtry klimatizace potřebují vyčistit. Čte příznak shouldCleanFilters ze Sensibo API — hodnota je 1, když filtry potřebují čištění, a 0, když jsou čisté. Indikátor filtru lze resetovat přes mobilní aplikaci Sensibo.

Další schopnosti

Sensibo API také zpřístupňuje ovládání horizontálních lamel, časovače, Climate React (automatické ovládání klimatu na základě prahových hodnot), historická měření a senzory kvality vzduchu (TVOC, CO2 na Air Pro). Tyto funkce mohou být přidány v budoucí aktualizaci šablony.

Řešení problémů

API vrací chybu nebo žádná data
  1. Ověřte, že zařízení Sensibo je online — zkontrolujte stavovou LED a mobilní aplikaci Sensibo
  2. Potvrďte, že API klíč je správný a nebyl přegenerován
  3. Ujistěte se, že parametr POD přesně odpovídá identifikátoru zařízení (rozlišuje velká a malá písmena)
  4. Zkontrolujte, že TapHome Core i zařízení Sensibo mají aktivní internetové připojení
Chyba “API Key is empty” nebo “Pod is empty”

Šablona ověřuje, zda jsou oba parametry nastaveny před odesláním API požadavků. Pokud vidíte tuto chybu, otevřete proměnné modulu v TapHome a ověřte, že pole API Key a POD obsahují správné hodnoty.

Příkazy nemají žádný efekt na klimatizaci

Zařízení Sensibo ovládá klimatizaci přes IR (infračervené) signály. Ujistěte se, že zařízení Sensibo má přímý výhled na IR přijímač klimatizace. Pokud konkrétní funkce (displej, poloha lamel) nefunguje, spárovaná klimatizace nemusí tuto funkci podporovat přes svůj IR protokol.

Sensibo Cloud API vyžaduje aktivní internetové připojení a závisí na dostupnosti serverů Sensibo. Během výpadků cloudu nebo přerušení internetu šablona nebude přijímat aktualizovaná data ani odesílat příkazy. Neexistuje lokální záloha — veškerá komunikace probíhá přes servery Sensibo.

Dostupná zařízení

Sensibo Inteligentní ovládání klimatizace Modul
Vlastní proměnné
apiKey (string)Klíč Sensibo Cloud API (získejte na https://home.sensibo.com/me/api)
pod (string)Identifikátor zařízení Sensibo (POD ID, unikátní pro každé zařízení Sensibo)

Sensibo Air Conditioner Smart Control

Čtení (modul)
responseJson := "error";
IF LENGTH(apiKey) = 0
    ADDERROR("API Key is empty. Fill API Key in module variables");
	RETURN(0);
END

IF LENGTH(pod) = 0
    ADDERROR("Pod is empty. Fill pod in module variables");
	RETURN(0);
END

VAR response := SENDHTTPREQUEST("/api/v2/pods/"+pod+"/?fields=*&apiKey="+apiKey, "GET", "");

IF(response.IsSuccess)
    responseJson := response.Content;
    mode := PARSEJSON(responseJson,"$.result.acState.mode");
ELSE
    VAR contentJson := response.Content;
    VAR errCode := response.StatusCode;
    VAR message := PARSEJSON(contentJson, "message", 1);
	IF ISNULL(message)
		message := PARSETEXT(response.Content, "<title>", "</title>");
	END
    ADDERROR("Failed to read data - (" + errCode + ") " + message);
END
Aktuální teplota a vlhkost Teplotní senzor Pouze ke čtení

Vestavěné snímače teploty a vlhkosti — vlhkost dělena 100 pro rozsah TapHome 0–1

numeric Jednotka: °C / % JSON parsejson()

Aktuální teplota a vlhkost

Čtení vlhkosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čtení teploty
PARSEJSON(responseJson,"$.result.measurements.temperature");
Rychlost ventilátoru Vícestavový přepínač

Ovládání rychlosti ventilátoru klimatizace — nízká, střední, vysoká, auto, silná (dostupné úrovně závisí na spárovaném modelu)

string → numeric JSON parsejson() + SWITCH mapping
Hodnoty / Stavy: low · medium · high · auto · strong

Rychlost ventilátoru

Čtení stavu přepínače
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Zápis stavu přepínače
VAR localfan := SWITCH(Mu, 1, "low", 2, "medium", 3, "high", 4, "auto", 5, "strong", "");

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/fanLevel?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localfan+"\"}");
Displej Přepínač

Ovládání LED displeje klimatizace — ne všechny modely tuto funkci podporují

string/boolean JSON parsejson() + IF comparison
Hodnoty / Stavy: ON · OFF

Displej

Čtení stavu přepínače
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Zápis stavu přepínače
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Režim klimatizace Vícestavový přepínač

Provozní režim klimatizace — VYP, Chlazení, Topení, Ventilátor, Sušení, Auto (dostupné režimy závisí na spárovaném modelu)

string → numeric Custom variable + SWITCH mapping
Hodnoty / Stavy: OFF · Cool · Heat · Fan · Dry · Auto

Režim klimatizace

Čtení stavu přepínače
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Zápis stavu přepínače
VAR localmode := SWITCH(Mu, 1, "cool", 2, "heat", 3, "fan", 4, "dry", 5, "auto", "");

IF (Mu > 0)
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/mode?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localmode+"\"}");

ELSE

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": false}");

END
Napájení Přepínač

Ovládání zapnutí/vypnutí klimatizace přes IR příkaz

boolean JSON parsejson() + IF
Hodnoty / Stavy: ON · OFF

Napájení

Čtení stavu přepínače
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Zápis stavu přepínače
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Čištění filtru vyžadováno Jazýčkový kontakt Pouze ke čtení

Upozornění na údržbu filtru — indikuje, kdy filtry klimatizace potřebují vyčistit

boolean JSON parsejson() + IF

Čištění filtru vyžadováno

Čtení
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Vertikální lamely Vícestavový přepínač

Ovládání polohy vertikálních lamel — 10 poloh od fixních po rozsahové (dostupné polohy závisí na spárovaném modelu)

string → numeric JSON parsejson() + SWITCH mapping
Hodnoty / Stavy: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Vertikální lamely

Čtení stavu přepínače
VAR swing := PARSEJSON(responseJson,"$.result.acState.swing");
SWITCH(swing, 
"stopped", 0, 
"fixedTop", 1, 
"fixedMiddleTop", 2, 
"fixedMiddle", 3, 
"fixedMiddleBottom", 4, 
"fixedBottom", 5, 
"rangeTop", 6, 
"rangeMiddle", 7, 
"rangeBottom", 8, 
"rangeFull", 9, 
0);
Zápis stavu přepínače
VAR localswing := SWITCH(Mu, 

0, "stopped", 
1, "fixedTop", 
2, "fixedMiddleTop", 
3, "fixedMiddle", 
4, "fixedMiddleBottom", 
5, "fixedBottom", 
6, "rangeTop", 
7, "rangeMiddle", 
8, "rangeBottom", 
9, "rangeFull"

, "");

SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/swing?apiKey="+apiKey, "PATCH", "{\"newValue\": \""+localswing+"\"}");
Termostat Termostat

Nastavení cílové teploty s aktuálními hodnotami teploty a vlhkosti

numeric Jednotka: °C JSON parsejson()

Termostat

Čtení teploty
PARSEJSON(responseJson,"$.result.measurements.temperature");
Čtení vlhkosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čtení požadované teploty
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Zápis požadované teploty
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Připojení: Packet Parser → HTTP
Možná vylepšení (10)
  • Horizontal Swing — Horizontal swing/louver position control. Available values vary by AC model. Present in acState but not implemented in TapHome template
  • Timer — GET/PUT/DELETE /pods/{pod}/timer — set countdown timer for AC on/off. Available in HA as 10-minute timer toggle
  • Schedules — GET/POST/PUT/DELETE /pods/{pod}/schedules — create and manage recurring AC schedules
  • Climate React — GET/PUT/POST /pods/{pod}/smartMode — automatic climate control based on temperature/humidity thresholds. Configurable high/low triggers with independent AC states
  • Historical Measurements — GET /pods/{pod}/historicalMeasurements — temperature and humidity history over time
  • TVOC Sensor — Total Volatile Organic Compounds sensor. Available on Sensibo Air Pro only
  • CO2 Sensor — Carbon dioxide level sensor. Available on Sensibo Air Pro only
  • Feels-Like Temperature — Computed feels-like temperature based on temperature and humidity. Available on Sky, Air, Air Pro
  • Filter Last Reset — Timestamp of last filter cleaning indicator reset
  • Filter Reset — Button to reset filter cleaning indicator (currently template only reads shouldCleanFilters, cannot reset)

Zdroje

Našli jste problém s touto šablonou zařízení?

Napište nám, co nefunguje, co chybí, nebo jak by se měla šablona chovat. Vaše zpětná vazba nám pomáhá udržet katalog přesný.

Ověřeno TapHome

Chcete to použít ve svém TapHome jádře?

Otevřete tuto šablonu v zákaznickém portálu a použijte ji ve svém domově, nebo navrhněte úpravu a odešlete ji zpět do katalogu.

Otevřít v portálu