TapHome

Sensibo Air Conditioner Smart Control

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 10. 2026
Sensibo Air Conditioner Smart Control

Predložak Sensibo Air Conditioner Smart Control povezuje TapHome sa svakim klima-uređajem kojim se upravlja infracrvenim (IR) daljinskim upravljačem, preko pametnog upravljača klima-uređaja Sensibo (Sky, Air ili Air Pro). Uređaj Sensibo postavlja se blizu klima-uređaja, uči IR kodove njegova daljinskog upravljača i daje potpuno upravljanje klima-uređajem preko Sensibo Cloud API v2. TapHome šalje upite poslužiteljima Sensibo preko HTTPS-a i prima podatke o stanju u stvarnom vremenu u formatu JSON, pa fizičko ožičenje do klima-uređaja nije potrebno.

Predložak daje 8 uređaja: uključivanje i isključivanje, odabir načina rada, brzinu ventilatora, položaj okomitog njihanja, termostat sa zadanom temperaturom, praćenje temperature i vlažnosti, upravljanje svjetlom zaslona i upozorenja za održavanje filtra. Potrebni su samo Sensibo račun, uređaj Sensibo spojen na Wi-Fi i API ključ.

Konfiguracija

Postavljanje Sensibo računa i uređaja

Uređaj Sensibo (Sky, Air ili Air Pro) mora biti ugrađen, uparen s vašim klima-uređajem u mobilnoj aplikaciji Sensibo i spojen na vašu Wi-Fi mrežu. Prije integracije sa sustavom TapHome uređaj se u aplikaciji Sensibo mora prikazivati kao povezan s mrežom.

Dobivanje API ključa
  1. U web-pregledniku otvorite home.sensibo.com/me/api
  2. Prijavite se podacima svojeg Sensibo računa
  3. Kliknite Generate API Key ako ključ još nemate
  4. Kopirajte API ključ: to je dugi alfanumerički niz

API ključ daje pristup svim uređajima Sensibo na vašem računu.

Pronalaženje identifikatora POD

POD je jedinstveni identifikator svakog uređaja Sensibo. Gdje ga pronaći:

  • U aplikaciji Sensibo — otvorite postavke uređaja i potražite Device ID
  • Preko API-ja — pozovite GET https://home.sensibo.com/api/v2/users/me/pods?apiKey={apiKey} i zapišite polje id za svaki uređaj

Svaki uređaj Sensibo ima drugačiji POD. Ako imate više uređaja Sensibo, predložak treba uvesti zasebno za svaki od njih, s njegovim POD-om.

Parametri uvoza

Pri uvozu predloška u TapHome unesite:

  • API Key — API ključ s portala Sensibo za razvojne programere
  • POD — jedinstveni identifikator određenog uređaja Sensibo
Ovisnost o internetu

Ovo je integracija isključivo preko oblaka. Svi podaci idu preko poslužitelja Sensibo (home.sensibo.com:443). Predložak ne radi bez aktivne internetske veze i na centralnoj jedinici TapHome Core i na uređaju Sensibo.

Mogućnosti uređaja

Praćenje temperature i vlažnosti

Senzor Trenutačna temperatura i vlažnost čita ugrađene senzore temperature i vlažnosti uređaja Sensibo. Temperatura se iskazuje u jedinici postavljenoj na uređaju Sensibo (obično u Celzijevim stupnjevima). Vlažnost se dijeli sa 100 za raspon analognog ulaza TapHome 0–1 (npr. 60 % postaje 0,60).

Upravljanje termostatom

Termostat omogućuje potpuno upravljanje klimom sa zadanom temperaturom. Čita trenutačnu sobnu temperaturu, vlažnost i ciljnu temperaturu iz stanja klima-uređaja. Upis nove zadane temperature šalje zahtjev PATCH na Sensibo API, koji zatim klima-uređaju šalje odgovarajuću IR naredbu. Dostupni raspon temperature ovisi o uparenom modelu klima-uređaja (obično 16–32 °C).

Uključivanje i isključivanje

Sklopka Uključivanje uključuje ili isključuje klima-uređaj. Pri isključivanju Sensibo šalje klima-uređaju IR naredbu za isključivanje. Pri uključivanju klima-uređaj nastavlja rad u posljednjem aktivnom načinu.

Odabir načina rada klima-uređaja

Prekidač s više vrijednosti Način rada klima-uređaja upravlja načinom rada sa 6 stanja:

VrijednostNačin
0OFF
1Cool
2Heat
3Fan
4Dry
5Auto

Postavljanje načina na 0 (OFF) šalje naredbu za isključivanje umjesto promjene načina. Dostupni načini ovise o uparenom klima-uređaju: ne podržavaju svi klima-uređaji svaki način.

Upravljanje brzinom ventilatora

Prekidač s više vrijednosti Razina ventilatora upravlja brzinom ventilatora sa 6 razina:

VrijednostRazina ventilatora
0None
1Low
2Medium
3High
4Auto
5Strong

Dostupne razine ventilatora ovise o modelu uparenog klima-uređaja.

Upravljanje okomitim njihanjem

Prekidač s više vrijednosti Okomito njihanje upravlja položajem okomite lamele s 10 stanja:

VrijednostPoložaj
0Stopped
1Fixed Top
2Fixed Middle Top
3Fixed Middle
4Fixed Middle Bottom
5Fixed Bottom
6Range Top
7Range Middle
8Range Bottom
9Range Full

Dostupni položaji njihanja ovise o uparenom klima-uređaju. Mnogi klima-uređaji podržavaju samo dio tih položaja. Aplikacija TapHome prikazuje nazive vrijednosti iz Sensibo API-ja (na primjer fixedTop, rangeFull, low).

Upravljanje svjetlom zaslona

Sklopka Svjetlo zaslona upravlja LED zaslonom na klima-uređaju. Ne podržavaju svi modeli klima-uređaja upravljanje svjetlom zaslona preko IR-a: ako upareni uređaj ne podržava tu funkciju, naredba nema učinka.

Upozorenje za održavanje filtra

Senzor Potrebno čišćenje filtra (magnetski kontakt) pokazuje kada treba očistiti filtre klima-uređaja. Čita zastavicu shouldCleanFilters iz Sensibo API-ja: vrijednost je 1 kada filtre treba očistiti, a 0 kada su čisti. Pokazatelj filtra može se poništiti u mobilnoj aplikaciji Sensibo.

Dodatne mogućnosti

Sensibo API daje i upravljanje vodoravnim njihanjem, funkcije timera, Climate React (automatsko upravljanje klimom na temelju pragova), povijesna mjerenja i senzore kvalitete zraka (TVOC, CO₂ na Air Pro). Mogu se dodati u budućem ažuriranju predloška.

Rješavanje problema

API vraća grešku ili nema podataka
  1. Provjerite je li uređaj Sensibo na mreži: provjerite LED stanja i mobilnu aplikaciju Sensibo
  2. Provjerite je li API ključ ispravan i nije li ponovno izrađen
  3. Provjerite odgovara li parametar POD točno identifikatoru uređaja (razlikuju se velika i mala slova)
  4. Provjerite imaju li centralna jedinica TapHome Core i uređaj Sensibo aktivnu internetsku vezu
Greška „API Key is empty” ili „Pod is empty”

Predložak prije slanja API zahtjeva provjerava jesu li oba parametra postavljena. Ako vidite ovu grešku, u sustavu TapHome otvorite varijable modula i provjerite sadrže li polja API Key i POD ispravne vrijednosti.

Naredbe nemaju učinka na klima-uređaj

Uređaj Sensibo upravlja klima-uređajem infracrvenim (IR) signalima. Između uređaja Sensibo i IR prijemnika klima-uređaja mora postojati izravna vidljivost. Ako određena funkcija (svjetlo zaslona, položaj njihanja) ne radi, upareni klima-uređaj možda ne podržava tu funkciju u svojem IR protokolu.

Sensibo Cloud API zahtijeva aktivnu internetsku vezu i ovisi o dostupnosti poslužitelja Sensibo. Tijekom prekida rada oblaka ili interneta predložak ne prima nove podatke i ne šalje naredbe. Ne postoji lokalni rezervni put: sva komunikacija ide preko poslužitelja Sensibo.

Dostupni uređaji

Sensibo Air Conditioner Smart Control Modul
Prilagođene varijable
apiKey (string)API ključ za Sensibo Cloud API (dobiva se na https://home.sensibo.com/me/api)
pod (string)Identifikator uređaja Sensibo (POD ID, jedinstven za svaki uređaj Sensibo)

Sensibo Air Conditioner Smart Control

Čitanje (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
Trenutačna temperatura i vlažnost Senzor temperature Samo za čitanje

Ugrađeni senzori temperature i vlažnosti — vlažnost se dijeli sa 100 za raspon TapHome 0–1

numeric Jedinica: °C / % JSON parsejson()

Trenutačna temperatura i vlažnost

Čitanje vlažnosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čitanje temperature
PARSEJSON(responseJson,"$.result.measurements.temperature");
Razina ventilatora Prekidač s više vrijednosti

Upravljanje brzinom ventilatora klima-uređaja — low, medium, high, auto, strong (dostupne razine ovise o uparenom modelu klima-uređaja)

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

Razina ventilatora

Čitanje stanja sklopke
VAR fanLevel := PARSEJSON(responseJson,"$.result.acState.fanLevel");
SWITCH(fanLevel, "low", 1, "medium", 2, "high", 3, "auto", 4, "strong", 5, 0);
Zapis stanja sklopke
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+"\"}");
Svjetlo zaslona Sklopka

Uključivanje i isključivanje LED zaslona klima-uređaja — ne podržavaju svi modeli klima-uređaja ovu funkciju

string/boolean JSON parsejson() + IF comparison
Vrijednosti / stanja: ON · OFF

Svjetlo zaslona

Čitanje stanja sklopke
IF(PARSEJSON(responseJson,"$.result.acState.light")="on",1,0)
Zapis stanja sklopke
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/light?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Način rada klima-uređaja Prekidač s više vrijednosti

Način rada klima-uređaja — OFF, Cool, Heat, Fan, Dry, Auto (dostupni načini ovise o uparenom modelu klima-uređaja)

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

Način rada klima-uređaja

Čitanje stanja sklopke
SWITCH(mode, "cool", 1, "heat", 2, "fan", 3, "dry", 4, "auto", 5, 0);
Zapis stanja sklopke
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
Uključivanje Sklopka

Uključivanje i isključivanje klima-uređaja IR naredbom

boolean JSON parsejson() + IF
Vrijednosti / stanja: ON · OFF

Uključivanje

Čitanje stanja sklopke
IF(PARSEJSON(responseJson,"$.result.acState.on"),1,0)
Zapis stanja sklopke
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/on?apiKey="+apiKey, "PATCH", "{\"newValue\": "+IF(St,"true","false")+"}");
Potrebno čišćenje filtra Magnetski kontakt Samo za čitanje

Upozorenje za održavanje filtra — pokazuje kada treba očistiti filtre klima-uređaja

boolean JSON parsejson() + IF

Potrebno čišćenje filtra

Čitanje
IF(PARSEJSON(responseJson,"$.result.filtersCleaning.shouldCleanFilters"),1,0)
Okomito njihanje Prekidač s više vrijednosti

Upravljanje položajem okomite lamele — 10 položaja, od fiksnih do njihanja u rasponu (dostupni položaji ovise o uparenom modelu klima-uređaja)

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

Okomito njihanje

Čitanje stanja sklopke
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);
Zapis stanja sklopke
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

Upravljanje zadanom temperaturom s očitanjem trenutačne temperature i vlažnosti

numeric Jedinica: °C JSON parsejson()

Termostat

Čitanje temperature
PARSEJSON(responseJson,"$.result.measurements.temperature");
Čitanje vlažnosti
PARSEJSON(responseJson,"$.result.measurements.humidity")/100.0;
Čitanje željene temperature
PARSEJSON(responseJson,"$.result.acState.targetTemperature");
Zapis željene temperature
SENDHTTPREQUEST("/api/v2/pods/"+pod+"/acStates/targetTemperature?apiKey="+apiKey, "PATCH", "{\"newValue\": "+Se+"}");
Povezivanje: Packet Parser → HTTP
Moguća poboljšanja (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)

Izvori

Pronašli ste problem s ovim predloškom uređaja?

Recite nam što ne radi, što nedostaje ili kako bi se predložak trebao ponašati. Vaše povratne informacije pomažu nam da katalog bude točan.

Provjerio TapHome

Želite ovo koristiti u svojoj centralnoj jedinici TapHome Core?

Otvorite ovaj predložak na portalu Customer Portal kako biste ga primijenili na jedan od svojih domova ili predložili poboljšanje i poslali ga natrag u katalog.

Otvorite na portalu