TapHome

Sensibo Intelligens légkondicionáló vezérlés

Packet Parser → HTTP
Beküldő
Utoljára frissítve: 06. 2026
Sensibo Intelligens légkondicionáló vezérlés

A Sensibo Air Conditioner Smart Control sablon a TapHome-ot bármely IR-vezérelt légkondicionálóhoz csatlakoztatja egy Sensibo okos klímavezérlőn (Sky, Air vagy Air Pro) keresztül. A Sensibo készülék a klímaberendezés közelében helyezkedik el, megtanulja annak IR kódjait, és a Sensibo Cloud API v2-n keresztül teljes vezérlést biztosít. A TapHome HTTPS-en kommunikál a Sensibo szerverekkel, és JSON formátumban kapja a valós idejű állapotadatokat — a légkondicionálóhoz nem szükséges fizikai kábelezés.

A sablon 8 eszközt biztosít: be-/kikapcsolás, üzemmód választás, ventilátorsebesség, függőleges lamellapozíció, termosztát célhőmérséklet-beállítással, hőmérséklet- és páratartalom-figyelés, kijelzővezérlés és szűrőkarbantartási figyelmeztetések. Az egyetlen követelmény egy Sensibo fiók, egy Wi-Fi-hez csatlakoztatott Sensibo készülék és egy API kulcs.

Konfiguráció

Sensibo fiók és készülék beállítása

A Sensibo készüléket (Sky, Air vagy Air Pro) telepíteni kell, a Sensibo mobilalkalmazáson keresztül párosítani a légkondicionálóval, és csatlakoztatni a Wi-Fi hálózathoz. A készüléknek online státuszúnak kell lennie a Sensibo alkalmazásban, mielőtt folytatná a TapHome integrációt.

API kulcs beszerzése
  1. Nyissa meg a home.sensibo.com/me/api oldalt a böngészőben
  2. Jelentkezzen be a Sensibo fiók hitelesítő adataival
  3. Kattintson a Generate API Key gombra, ha még nincs generált kulcsa
  4. Másolja ki az API kulcsot — ez egy hosszú alfanumerikus karakterlánc

Az API kulcs hozzáférést biztosít a fiókjában lévő összes Sensibo készülékhez.

POD azonosító megkeresése

A POD az egyes Sensibo készülékek egyedi azonosítója. Hol található:

  • A Sensibo alkalmazásban — nyissa meg a készülék beállításait és keresse a Device ID-t
  • Az API-n keresztül — hívja meg a GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} végpontot és jegyezze fel az egyes készülékek id mezőjét

Minden Sensibo készüléknek más a POD-ja. Ha több Sensibo készüléke van, a sablont mindegyikhez külön kell importálnia a saját POD-jával.

Importparaméterek

A sablon TapHome-ba importálásakor adja meg:

  • API Key — az API kulcs a Sensibo fejlesztői portálról
  • POD — az adott Sensibo egység egyedi azonosítója
Internetfüggőség

Ez egy kizárólag felhőalapú integráció. Minden adat a Sensibo szervereken (home.sensibo.com:443) halad keresztül. A sablon nem működik aktív internetkapcsolat nélkül sem a TapHome Core-on, sem a Sensibo készüléken.

Készülékképességek

Hőmérséklet- és páratartalom-figyelés

A Current Temperature & Humidity szenzor a Sensibo készülék beépített hőmérséklet- és páratartalom-érzékelőit olvassa. A hőmérséklet a Sensibo készüléken beállított mértékegységben jelenik meg (jellemzően Celsius). A páratartalom 100-zal osztva jelenik meg a TapHome 0–1 analóg bemeneti tartományához (pl. 60% = 0,60).

Termosztát vezérlés

A Thermostat teljes klímavezérlést biztosít célhőmérséklet-beállítással. Kiolvassa az aktuális szobahőmérsékletet, páratartalmat és a célhőmérsékletet a klíma állapotából. Új célérték írásakor PATCH kérést küld a Sensibo API-nak, amely a megfelelő IR parancsot továbbítja a légkondicionálónak. Az elérhető hőmérsékleti tartomány a párosított klímamodelltől függ (jellemzően 16–32 °C).

Tápellátás vezérlés

A Power kapcsoló be- és kikapcsolja a légkondicionálót. Kikapcsoláskor a Sensibo kikapcsoló IR parancsot küld. Bekapcsoláskor a klíma az utolsó aktív üzemmódban folytatja a működést.

Klíma üzemmód választás

Az AC Mode többértékű kapcsoló 6 állapottal vezérli az üzemmódot:

ÉrtékÜzemmód
0KI
1Hűtés
2Fűtés
3Ventilátor
4Szárítás
5Auto

A 0 (KI) üzemmód beállítása kikapcsoló parancsot küld az üzemmódváltás helyett. Az elérhető üzemmódok a párosított légkondicionálótól függenek — nem minden egység támogat minden üzemmódot.

Ventilátorsebesség vezérlés

A Fan Level többértékű kapcsoló 6 fokozattal vezérli a ventilátorsebességet:

ÉrtékFokozat
0Nincs
1Alacsony
2Közepes
3Magas
4Auto
5Erős

Az elérhető ventilátor fokozatok a párosított klímamodelltől függenek.

Függőleges lamella vezérlés

A Vertical Swing többértékű kapcsoló 10 állapottal vezérli a függőleges lamellapozíciót:

ÉrtékPozíció
0Megállítva
1Fix felső
2Fix közép-felső
3Fix közép
4Fix közép-alsó
5Fix alsó
6Tartomány felső
7Tartomány közép
8Tartomány alsó
9Tartomány teljes

Az elérhető lamellapozíciók a párosított légkondicionálótól függenek. Sok egység csak ezek egy részhalmazát támogatja.

Kijelzővezérlés

A Display Light kapcsoló a légkondicionáló LED kijelzőpaneljét vezérli. Nem minden klímamodell támogatja a kijelzővezérlést IR-en keresztül — ha a párosított egység nem támogatja ezt a funkciót, a parancsnak nincs hatása.

Szűrőkarbantartási figyelmeztetés

A Filter Clean Required szenzor (reed kontaktus) jelzi, amikor a klíma szűrői tisztítást igényelnek. A Sensibo API shouldCleanFilters jelzőjét olvassa — az érték 1, ha a szűrők tisztítást igényelnek, és 0, ha tiszták. A szűrőjelző a Sensibo mobilalkalmazáson keresztül állítható vissza.

További képességek

A Sensibo API emellett biztosít vízszintes lamella vezérlést, időzítő funkciókat, Climate React-ot (automatikus klímavezérlés küszöbértékek alapján), előzményméréseket és levegőminőség-érzékelőket (TVOC, CO2 az Air Pro modellen). Ezek egy jövőbeli sablonfrissítésben adhatók hozzá.

Hibaelhárítás

Az API hibát vagy üres adatot ad vissza
  1. Ellenőrizze, hogy a Sensibo készülék online-e — nézze meg a státusz LED-et és a Sensibo mobilalkalmazást
  2. Győződjön meg róla, hogy az API kulcs helyes és nem lett újragenerálva
  3. Bizonyosodjon meg arról, hogy a POD paraméter pontosan megegyezik a készülékazonosítóval (kis- és nagybetűérzékeny)
  4. Ellenőrizze, hogy a TapHome Core és a Sensibo készülék is rendelkezik aktív internetkapcsolattal
“API Key is empty” vagy “Pod is empty” hiba

A sablon ellenőrzi, hogy mindkét paraméter be van-e állítva az API kérések elküldése előtt. Ha ezt a hibát látja, nyissa meg a modulváltozókat a TapHome-ban, és ellenőrizze, hogy az API Key és POD mezők tartalmazzák-e a helyes értékeket.

A parancsok nem hatnak a légkondicionálóra

A Sensibo készülék IR (infravörös) jelekkel vezérli a légkondicionálót. Győződjön meg arról, hogy a Sensibo készüléknek szabad rálátása van a klíma IR vevőjére. Ha egy adott funkció (kijelző, lamellapozíció) nem működik, előfordulhat, hogy a párosított légkondicionáló nem támogatja azt az IR protokollon keresztül.

A Sensibo Cloud API aktív internetkapcsolatot igényel és a Sensibo szerverek elérhetőségétől függ. Felhőkimaradás vagy internetszünet esetén a sablon nem kap frissített adatokat és nem küld parancsokat. Nincs helyi tartalék — minden kommunikáció a Sensibo szervereken keresztül történik.

Elérhető eszközök

Sensibo Intelligens légkondicionáló vezérlés Modul
Egyéni változók
apiKey (string)Sensibo Cloud API kulcs (beszerezhető: https://home.sensibo.com/me/api)
pod (string)Sensibo készülékazonosító (POD ID, egyedi minden Sensibo készülékhez)

Sensibo Air Conditioner Smart Control

Olvasás (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ális hőmérséklet és páratartalom Hőmérséklet-érzékelő Csak olvasható

Beépített hőmérséklet- és páratartalom-érzékelők — páratartalom osztva 100-zal a TapHome 0–1 tartományhoz

numeric Egység: °C / % JSON parsejson()

Aktuális hőmérséklet és páratartalom

Páratartalom olvasása
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Hőmérséklet olvasása
PARSEJSON(responseJson,"$.result.measurements.temperature");
Ventilátor fokozat Többértékű kapcsoló

Klíma ventilátorsebesség vezérlés — alacsony, közepes, magas, auto, erős (elérhető fokozatok a párosított modelltől függenek)

string → numeric JSON parsejson() + SWITCH mapping
Értékek / Állapotok: low · medium · high · auto · strong

Ventilátor fokozat

Kapcsoló állapot olvasása
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Kapcsoló állapot írása
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+"\"}");
Kijelző Kapcsoló

Klíma LED kijelző be-/kikapcsolása — nem minden modell támogatja ezt a funkciót

string/boolean JSON parsejson() + IF comparison
Értékek / Állapotok: ON · OFF

Kijelző

Kapcsoló állapot olvasása
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Kapcsoló állapot írása
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Klíma üzemmód Többértékű kapcsoló

Klíma üzemmód — KI, Hűtés, Fűtés, Ventilátor, Szárítás, Auto (elérhető üzemmódok a párosított modelltől függenek)

string → numeric Custom variable + SWITCH mapping
Értékek / Állapotok: OFF · Cool · Heat · Fan · Dry · Auto

Klíma üzemmód

Kapcsoló állapot olvasása
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Kapcsoló állapot írása
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
Tápellátás Kapcsoló

Klíma be-/kikapcsolás IR paranccsal

boolean JSON parsejson() + IF
Értékek / Állapotok: ON · OFF

Tápellátás

Kapcsoló állapot olvasása
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Kapcsoló állapot írása
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Szűrőtisztítás szükséges Reed kontaktus Csak olvasható

Szűrőkarbantartási figyelmeztetés — jelzi, amikor a klíma szűrői tisztítást igényelnek

boolean JSON parsejson() + IF

Szűrőtisztítás szükséges

Olvasás
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Függőleges lamellák Többértékű kapcsoló

Függőleges lamellapozíció vezérlés — 10 pozíció fix-től tartomány-ig (elérhető pozíciók a párosított modelltől függenek)

string → numeric JSON parsejson() + SWITCH mapping
Értékek / Állapotok: stopped · fixedTop · fixedMiddleTop · fixedMiddle · fixedMiddleBottom · fixedBottom · rangeTop · rangeMiddle · rangeBottom · rangeFull

Függőleges lamellák

Kapcsoló állapot olvasása
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);
Kapcsoló állapot írása
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+"\"}");
Termosztát Termosztát

Célhőmérséklet-beállítás aktuális hőmérséklet- és páratartalom-adatokkal

numeric Egység: °C JSON parsejson()

Termosztát

Hőmérséklet olvasása
PARSEJSON(responseJson,"$.result.measurements.temperature");
Páratartalom olvasása
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Kívánt hőmérséklet olvasása
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Kívánt hőmérséklet írása
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Kapcsolat: Packet Parser → HTTP
Lehetséges fejlesztések (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)

Források

Talált problémát ezzel az eszközsablonnal?

Írja meg, mi nem működik, mi hiányzik, vagy hogyan kellene a sablonnak viselkednie. Visszajelzése segít, hogy a katalógus pontos maradjon.

TapHome által hitelesítve

Használni szeretnéd ezt a TapHome Core-odban?

Nyisd meg ezt a sablont az ügyfélportálon, hogy alkalmazd az otthonaid egyikére, vagy készíts egy módosítást és küldd vissza a katalógusba.

Megnyitás a portálon