TapHome

Sensibo Inteligentné ovládanie klimatizácie

Packet Parser → HTTP
Pridal
Posledná aktualizácia: 05. 2026
Sensibo Inteligentné ovládanie klimatizácie

Šablóna Sensibo Air Conditioner Smart Control pripája TapHome k akejkoľvek klimatizácii ovládanej infračerveným signálom prostredníctvom inteligentného ovládača Sensibo (Sky, Air alebo Air Pro). Zariadenie Sensibo sa umiestni v blízkosti klimatizácie, naučí sa jej IR kódy a sprístupní kompletné ovládanie cez Sensibo Cloud API v2. TapHome komunikuje so servermi Sensibo cez HTTPS a prijíma stavové dáta v JSON formáte — nie je potrebná žiadna fyzická kabeláž ku klimatizácii.

Šablóna poskytuje 8 zariadení pokrývajúcich zapnutie/vypnutie, výber prevádzkového režimu, rýchlosť ventilátora, polohu vertikálnych lamiel, termostat s nastavením cieľovej teploty, monitorovanie teploty a vlhkosti, ovládanie displeja a upozornenia na údržbu filtra. Jediné požiadavky sú účet Sensibo, zariadenie Sensibo pripojené k Wi-Fi a API kľúč.

Konfigurácia

Sensibo účet a nastavenie zariadenia

Zariadenie Sensibo (Sky, Air alebo Air Pro) musí byť nainštalované, spárované s klimatizáciou cez mobilnú aplikáciu Sensibo a pripojené k Wi-Fi sieti. Zariadenie musí byť zobrazené ako online v aplikácii Sensibo pred pokračovaním s integráciou TapHome.

Získanie API kľúča
  1. Otvorte home.sensibo.com/me/api vo webovom prehliadači
  2. Prihláste sa pomocou prihlasovacích údajov účtu Sensibo
  3. Kliknite na Generate API Key, ak ešte nemáte vygenerovaný kľúč
  4. Skopírujte API kľúč — je to dlhý alfanumerický reťazec

API kľúč poskytuje prístup ku všetkým zariadeniam Sensibo na vašom účte.

Zistenie identifikátora POD

POD je unikátny identifikátor pre každé zariadenie Sensibo. Kde ho nájdete:

  • V aplikácii Sensibo — otvorte nastavenia zariadenia a vyhľadajte Device ID
  • Cez API — zavolajte GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} a poznačte si pole id pre každé zariadenie

Každé zariadenie Sensibo má iný POD. Ak máte viacero zariadení Sensibo, musíte šablónu importovať samostatne pre každé s jeho vlastným POD.

Parametre importu

Pri importovaní šablóny v TapHome zadajte:

  • API Key — API kľúč z vývojárskeho portálu Sensibo
  • POD — unikátny identifikátor pre konkrétnu jednotku Sensibo
Závislosť na internete

Toto je čisto cloudová integrácia. Všetky dáta prechádzajú cez servery Sensibo (home.sensibo.com:443). Šablóna nebude fungovať bez aktívneho internetového pripojenia na TapHome Core aj na zariadení Sensibo.

Schopnosti zariadení

Monitorovanie teploty a vlhkosti

Senzor Current Temperature & Humidity číta zabudované snímače teploty a vlhkosti na zariadení Sensibo. Teplota je hlásená v jednotke nakonfigurovanej na zariadení Sensibo (typicky Celsius). Vlhkosť je delená 100 pre rozsah analógového vstupu TapHome 0–1 (napr. 60 % sa zobrazí ako 0,60).

Ovládanie termostatu

Thermostat poskytuje kompletné ovládanie klímy s nastavením cieľovej teploty. Číta aktuálnu izbovú teplotu, vlhkosť a cieľovú teplotu zo stavu klimatizácie. Zápis nového setpointu odošle PATCH požiadavku na Sensibo API, ktoré následne vyšle zodpovedajúci IR príkaz klimatizácii. Dostupný teplotný rozsah závisí od spárovaného modelu klimatizácie (typicky 16–32 °C).

Ovládanie napájania

Spínač Power zapína a vypína klimatizáciu. Po vypnutí Sensibo odošle IR príkaz na vypnutie. Po zapnutí klimatizácia obnoví posledný aktívny režim.

Výber režimu klimatizácie

Prepínač AC Mode ovláda prevádzkový režim so 6 stavmi:

HodnotaRežim
0VYP
1Chladenie
2Kúrenie
3Ventilátor
4Sušenie
5Auto

Nastavenie režimu na 0 (VYP) odošle príkaz na vypnutie namiesto zmeny režimu. Dostupné režimy závisia od spárovanej klimatizácie — nie všetky jednotky podporujú každý režim.

Ovládanie rýchlosti ventilátora

Prepínač Fan Level ovláda rýchlosť ventilátora so 6 úrovňami:

HodnotaÚroveň
0Žiadna
1Nízka
2Stredná
3Vysoká
4Auto
5Silná

Dostupné úrovne ventilátora závisia od modelu spárovanej klimatizácie.

Ovládanie vertikálnych lamiel

Prepínač Vertical Swing ovláda polohu vertikálnych lamiel s 10 stavmi:

HodnotaPoloha
0Zastavené
1Fixná hore
2Fixná stred-hore
3Fixná stred
4Fixná stred-dole
5Fixná dole
6Rozsah hore
7Rozsah stred
8Rozsah dole
9Rozsah plný

Dostupné polohy lamiel závisia od spárovanej klimatizácie. Mnohé jednotky podporujú len podmnožinu týchto polôh.

Ovládanie displeja

Spínač Display Light ovláda LED displej na klimatizácii. Nie všetky modely klimatizácií podporujú ovládanie displeja cez IR — ak spárovaná jednotka túto funkciu nepodporuje, príkaz nebude mať žiadny efekt.

Upozornenie na údržbu filtra

Senzor Filter Clean Required (jazýčkový kontakt) indikuje, kedy filtre klimatizácie potrebujú vyčistenie. Číta príznak shouldCleanFilters zo Sensibo API — hodnota je 1, keď filtre potrebujú čistenie, a 0, keď sú čisté. Indikátor filtra je možné resetovať cez mobilnú aplikáciu Sensibo.

Ďalšie schopnosti

Sensibo API tiež sprístupňuje ovládanie horizontálnych lamiel, časovače, Climate React (automatické ovládanie klímy na základe prahových hodnôt), historické merania a senzory kvality vzduchu (TVOC, CO2 na Air Pro). Tieto funkcie môžu byť pridané v budúcej aktualizácii šablóny.

Riešenie problémov

API vracia chybu alebo žiadne dáta
  1. Overte, že zariadenie Sensibo je online — skontrolujte stavovú LED a mobilnú aplikáciu Sensibo
  2. Potvrďte, že API kľúč je správny a nebol preg enerovaný
  3. Uistite sa, že parameter POD presne zodpovedá identifikátoru zariadenia (rozlišuje veľké a malé písmená)
  4. Skontrolujte, že TapHome Core aj zariadenie Sensibo majú aktívne internetové pripojenie
Chyba “API Key is empty” alebo “Pod is empty”

Šablóna overuje, či sú oba parametre nastavené pred odoslaním API požiadaviek. Ak vidíte túto chybu, otvorte premenné modulu v TapHome a overte, že polia API Key a POD obsahujú správne hodnoty.

Príkazy nemajú žiadny efekt na klimatizáciu

Zariadenie Sensibo ovláda klimatizáciu cez IR (infračervené) signály. Uistite sa, že zariadenie Sensibo má priamy výhľad na IR prijímač klimatizácie. Ak konkrétna funkcia (displej, poloha lamiel) nefunguje, spárovaná klimatizácia nemusí túto funkciu podporovať cez svoj IR protokol.

Sensibo Cloud API vyžaduje aktívne internetové pripojenie a závisí od dostupnosti serverov Sensibo. Počas výpadkov cloudu alebo prerušenia internetu šablóna nebude prijímať aktualizované dáta ani odosielať príkazy. Neexistuje lokálna záloha — všetka komunikácia prechádza cez servery Sensibo.

Dostupné zariadenia

Sensibo Inteligentné ovládanie klimatizácie Modul
Vlastné premenné
apiKey (string)Kľúč Sensibo Cloud API (získajte na https://home.sensibo.com/me/api)
pod (string)Identifikátor zariadenia Sensibo (POD ID, unikátny pre každé zariadenie Sensibo)

Sensibo Air Conditioner Smart Control

Čítanie (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álna teplota a vlhkosť Teplotný senzor Len na čítanie

Zabudované snímače teploty a vlhkosti — vlhkosť delená 100 pre rozsah TapHome 0–1

numeric Jednotka: °C / % JSON parsejson()

Aktuálna teplota a vlhkosť

Čítanie vlhkosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čítanie teploty
PARSEJSON(responseJson,"$.result.measurements.temperature");
Rýchlosť ventilátora Viacstavový prepínač

Ovládanie rýchlosti ventilátora klimatizácie — nízka, stredná, vysoká, auto, silná (dostupné úrovne závisia od spárovaného modelu)

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

Rýchlosť ventilátora

Čítanie stavu prepínača
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Zápis stavu prepínača
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 Prepínač

Ovládanie LED displeja klimatizácie — nie všetky modely túto funkciu podporujú

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

Displej

Čítanie stavu prepínača
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Zápis stavu prepínača
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Režim klimatizácie Viacstavový prepínač

Prevádzkový režim klimatizácie — VYP, Chladenie, Kúrenie, Ventilátor, Sušenie, Auto (dostupné režimy závisia od spárovaného modelu)

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

Režim klimatizácie

Čítanie stavu prepínača
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Zápis stavu prepínača
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ájanie Prepínač

Ovládanie zapnutia/vypnutia klimatizácie cez IR príkaz

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

Napájanie

Čítanie stavu prepínača
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Zápis stavu prepínača
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Čistenie filtra vyžadované Jazýčkový kontakt Len na čítanie

Upozornenie na údržbu filtra — indikuje, kedy filtre klimatizácie potrebujú vyčistenie

boolean JSON parsejson() + IF

Čistenie filtra vyžadované

Čítanie
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Vertikálne lamely Viacstavový prepínač

Ovládanie polohy vertikálnych lamiel — 10 polôh od fixných po rozsahové (dostupné polohy závisia od spárovaného modelu)

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

Vertikálne lamely

Čítanie stavu prepínača
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 prepínača
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

Nastavenie cieľovej teploty s aktuálnymi hodnotami teploty a vlhkosti

numeric Jednotka: °C JSON parsejson()

Termostat

Čítanie teploty
PARSEJSON(responseJson,"$.result.measurements.temperature");
Čítanie vlhkosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čítanie požadovanej teploty
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Zápis požadovanej teploty
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Pripojenie: Packet Parser → HTTP
Možné vylepšenia (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 ste problém s touto šablónou zariadenia?

Napíšte nám, čo nefunguje, čo chýba, alebo ako by sa mala šablóna správať. Vaša spätná väzba nám pomáha udržiavať katalóg presný.

Overené TapHomom

Chcete to použiť vo svojom TapHome jadre?

Otvorte túto šablónu v Customer Portali a aplikujte ju na svoj domov, alebo navrhnite zmenu a odošlite ju späť do katalógu.

Otvoriť v portáli