Õpetus: Kuidas toimib Airoboti termostaadi avatud API
Tagasi Termin “kohalik API nutikate WiFi-toodete jaoks” viitab tavaliselt rakenduste programmeerimise liidesele (API), mis võimaldab arendajatel suhelda ja juhtida nutikaid WiFi-seadmeid kohalikus võrgus.
Nutikad WiFi-tooted hõlmavad seadmeid nagu nutitermostaadid, nutipistikud, nutipirnid ja palju muud, mida saab juhtida ja jälgida kohaliku võrgu kaudu ilma internetiühendust nõudmata.
Airobot termostaadid toetavad lokaalset API-d, mis teeb nende liidestamise kaasaegsete majaautomaatika süsteemidega väga lihtsaks
Airoboti termostaadi liidestamine majaautomaatikaga
1. Ühendada termostaat interneti võrku. Ühendamisel termostaat registreeritakse Airobot serveris ja termostaat saab endale ID ja parooli2.
2. Kui termostaat on võrku ühendatud, siis mine termostaadi ekraanil järgmiste sammudega:
Menüü –> Seaded –> Ühenduvus –> Kohalik API ja määra selle väärtuseks „Lubatud“
Nüüd peaks termostaat olema ligipääsetav kohaliku võrgu kaudu. Viimase asjana tuleb veel kirjutada üles termostaadi ID ja parool, mis on leitav: Menüü -> Seaded -> Ühenduvus -> Mobiilirakendus.
3. Jägnevalt katseta, kas ühendus toimib. Proovime küsida termostaadilt andmeid (loe API juhendist täpsemalt):
Päringu testimiseks on saadaval kümneid rakendusi, selles konkreetses näites on kasutatud MacOs süsteemile App Storest leitav HTTPBot-i
Termostaadi poole pöördumiseks on kaks võimalust:
1. Domeeninime kaudu
2. IP aadressi kaudu.
Soovitame kasutada domeeninime kuna IP aadress võib olla muutuv. Juhul kui on soov kasutada IP aadressi, siis leiad selle: Menüü –> Teave
4. Termostaadi andmete lugemine
Teeme GET päringu: airobot-thermostat-t01774270.local/api/thermostat/getStatuses
Autentimiseks tuleb kasutada „Basic Auth“ Username lahtrisse sisesta termostaadi ID ja password lahtrisse sisesta termostaadi parool.
Kui jooksutada päringut peaks tulemus olema järgnev:
Näite peal on näha, et termostaat annab kõik andmed ilusti kätte. Andmetest saab lugeda, et näiteks TEMP_AIR = 238, mis tähendab et õhutemperatuur on 23,8 °C. Samuti näiteks CO2 tase on 490 ppm. SETPOINT_TEMP = 225 (22.5 °C), mis on termostaadi sättepunkt.
Kuna sättepunkt on madalam, siis termostaat hetkel kütet ei nõua, mida saab järeldada ka selles, et HEATING_ON = 0, S
Selgitusena: 0 = false/väär ehk küte on väljas, 1 = true/tõde ehk küte on sees.
6. Kõikide seadete lugemiseks tuleb teha päring: getSettings
Selleks muudame päringu aadressi vastavalt: airobot-thermostat-t01774270.local/api/thermostat/getSettings
Oluline on jälgida, et vajalik autentimine (kasutajanimi ja parool) on lisatud.
6. Termostaadi andmete kirjutamine
Lisaks andmete lugemisele on võimalik termostaadile saata ka käske, näiteks vahetada töörežiimi või muuta temperatuuri sättepunkti. Antud näite puhul lülitame termostaadi „EEMAL“ töörežiimile ja samas muudame „KODUS“ režiimi sättepunkti 20 °C peale.
Selleks tuleb luua uus POST päring: airobot-thermostat-t01774270.local/api/thermostat/setSettings
Andmetüüp peab olema JSON, formaat on oluline. JSON andmetena saadame termostaadile käskluse.
7. Kui päring on saadetud, peaks termostaat võtma uue seadistuse vastu. Vajalik on kontrollida kas see ka päriselt õnnestus. Selleks tuleb uuesti küsida termostaadilt seadistused getSettings päringuga:
Nagu on näha, siis MODE = 2, ehk termostaat lülitus nüüd „EEMAL“ režiimile ja „KODUS „režiimi sättepunktiks sai 20 °C.
Niimoodi käib lokaalse API kasutamin Airobot termostaadiga. Tuletame meelde, et antud näide on tehtud HTTPBot rakendusega, mis on mõeldud MacOSile. Kui liidestate mõnda majaautomaatika süsteemi Airobot termostaati, siis iga kasutajaliides on erinev, kuid tehtud näide võiks anna ülevaate kuidas see toimib.
Küsimuste korral pöörduge meie klienditoe poole abi@airobothome.com.
Head kasutamist!
