TapHome

Xiaomi 1T (Valetudo)

Packet Parser → HTTP
Autor
Posljednje ažuriranje: 03. 2026
Xiaomi 1T (Valetudo)

Xiaomi Mijia 1T (STYTJ02ZHM) robotski je usisavač s funkcijom brisanja koji proizvodi Dreame, a prodaje se pod markom Xiaomi. Ovaj predložak zahtijeva Valetudo — firmver otvorenog koda koji ovisnost o oblaku proizvođača zamjenjuje lokalnim HTTP API-jem. Nakon instalacije firmvera Valetudo na robot TapHome komunicira izravno s Valetudo REST API-jem v2 u lokalnoj mreži. Nije potrebna veza s oblakom ni autentifikacija.

Predložak omogućuje praćenje baterije, prikaz stanja s više vrijednosti te tipkala za pokretanje, pauziranje, zaustavljanje i vraćanje usisavača na bazu. Funkcija pronalaženja pokreće zvučni signal koji pomaže pronaći robot.

Prije upotrebe ovog predloška na robot mora biti instaliran Valetudo. Predložak komunicira s Valetudo HTTP API-jem, a ne s uslugama u oblaku tvrtke Xiaomi. Za rootanje uređaja Xiaomi 1T potrebni su USB-UART adapter od 3,3 V i pločica Dreame Breakout PCB — detaljne upute potražite na stranici s robotima koje podržava Valetudo.

Konfiguracija

Tijekom uvoza predloška unesite IP adresu robota u lokalnoj mreži (u predlošku je unaprijed upisan primjer 192.168.0.1). Valetudo REST API sluša na portu 80 bez autentifikacije.

Budući da Valetudo ne objavljuje mDNS naziv hosta, dodijelite robotu statičku IP adresu ili DHCP rezervaciju kako se adresa ne bi promijenila nakon ponovnog pokretanja mreže.

Otvorite http://<robot-ip>/swagger/ u pregledniku kako biste interaktivno istražili sve dostupne krajnje točke Valetudo API-ja. To je korisno za provjeru povezivosti i pregled trenutačnog stanja robota.

Mogućnosti uređaja

Razina baterije

Predložak čita stanje napunjenosti baterije iz odgovora /api/v2/robot/state/attributes. Raščlanjuje BatteryStateAttribute.level (vrijednost 0–100) i dijeli je sa 100 kako bi za TapHome dobio raspon 0,0–1,0. Vrijednost se osvježava svakih 2,5 sekunde.

Stanje usisavača

Prekidač s više vrijednosti prikazuje trenutačno radno stanje robota. Predložak raščlanjuje StatusStateAttribute.value iz odgovora s atributima stanja i pretvara ga u cjelobrojni indeks:

StanjeVrijednostOpis
Docked0Robot je na bazi za punjenje
Cleaning1Ciklus čišćenja u tijeku
Returning2Vraćanje na bazu
Paused3Čišćenje je pauzirano
Idle4Ne čisti i nije na bazi
Unknown9Neprepoznato stanje

Valetudo API može javiti i stanja error, manual_control i moving — ona nisu zasebno preslikana i prikazuju se kao „Unknown” (vrijednost 9).

Upravljanje usisavačem

Četiri tipkala upravljaju usisavačem preko krajnje točke BasicControlCapability:

  • Pokreni — pokreće cijeli ciklus čišćenja
  • Pauza — pauzira trenutačno čišćenje
  • Zaustavi — zaustavlja trenutačno čišćenje
  • Povratak na bazu — šalje robot natrag na bazu za punjenje

Svako tipkalo šalje zahtjev PUT na /api/v2/robot/capabilities/BasicControlCapability s odgovarajućom radnjom.

Pronalaženje

Tipkalo Pronađi preko krajnje točke LocateCapability pokreće zvučni signal na robotu. To je korisno kad robot treba pronaći jer je zapeo ili se nalazi na neočekivanom mjestu.

Dodatne mogućnosti

Valetudo API nudi nekoliko mogućnosti koje predložak trenutačno ne podržava: upravljanje brzinom ventilatora (unaprijed postavljene razine usisne snage), upravljanje potrošnjom vode (intenzitet brisanja), čišćenje po zonama, odlazak na zadano mjesto, snimke karte, praćenje potrošnih dijelova (filtar, četke, senzori), glasnoću zvučnika, raspored načina „ne ometaj”, stanje punjenja i jačinu Wi-Fi signala. One se mogu dodati u nekom budućem ažuriranju predloška.

Rješavanje problema

Uređaj ne odgovara
  1. Provjerite je li robot uključen, povezan s Wi-Fi mrežom i ima li valjanu IP adresu
  2. Otvorite http://<robot-ip>/ u pregledniku — ako se učita web-sučelje Valetudo, API je dostupan
  3. Provjerite jesu li TapHome i robot u istoj mreži ili VLAN-u
  4. Provjerite radi li Valetudo — ako je robot vraćen na tvorničke postavke, Valetudo će možda trebati ponovno instalirati
Stanje prikazuje „Unknown” (???)

Predložak preslikava pet stanja (docked, cleaning, returning, paused, idle). Ako robot javi error, manual_control ili moving, stanje se prikazuje kao „Unknown” (vrijednost 9). To je očekivano ponašanje — nepreslikana stanja pojavljuju se u rubnim situacijama, kao što su ručno upravljanje daljinskim upravljačem ili oporavak nakon pogreške.

Razina baterije prikazuje nulu
  1. Provjerite radi li Valetudo i odgovara li API na /api/v2/robot/state/attributes
  2. Provjerite sadrži li odgovor unos BatteryStateAttribute s vrijednošću level različitom od nule
  3. Ako je robot nedavno ponovno pokrenut, pričekajte da se dovrši prvo očitavanje stanja

Dostupni uređaji

Xiaomi 1T (Valetudo) Modul
Prilagođene varijable

Xiaomi 1T (Valetudo)

Čitanje (modul)
VAR response := SENDHTTPREQUEST("/api/v2/robot/state/attributes");
IF response.IsSuccess
 state := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Razina baterije Analogni ulaz Samo za čitanje

Stanje napunjenosti baterije — postotak preostale energije (0–100 %)

numeric Jedinica: %

Razina baterije

Čitanje razine ulaza
PARSEJSON(state, "$[?(@.__class == 'BatteryStateAttribute')].level") / 100
Povratak na bazu Tipkalo
action

Povratak na bazu

Zapis stanja tipke
VAR response := SENDHTTPREQUEST("/api/v2/robot/capabilities/BasicControlCapability", "PUT", "{\"action\": \"home\"}", "accept: */*", "Content-Type: application/json");
IF response.IsSuccess
 var res := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Pronađi Tipkalo

Pokreće zvučni signal na robotu kako bi ga se lakše pronašlo

action

Pronađi

Zapis stanja tipke
VAR response := SENDHTTPREQUEST("/api/v2/robot/capabilities/LocateCapability", "PUT", "{\"action\": \"locate\"}", "accept: */*", "Content-Type: application/json");
IF response.IsSuccess
 var res := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Pauza Tipkalo
action

Pauza

Zapis stanja tipke
VAR response := SENDHTTPREQUEST("/api/v2/robot/capabilities/BasicControlCapability", "PUT", "{\"action\": \"pause\"}", "accept: */*", "Content-Type: application/json");
IF response.IsSuccess
 var res := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Pokreni Tipkalo
action

Pokreni

Zapis stanja tipke
VAR response := SENDHTTPREQUEST("/api/v2/robot/capabilities/BasicControlCapability", "PUT", "{\"action\": \"start\"}", "accept: */*", "Content-Type: application/json");
IF response.IsSuccess
 var res := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Stanje usisavača Prekidač s više vrijednosti Samo za čitanje

Trenutačno radno stanje — Docked, Cleaning, Returning, Paused, Idle ili Unknown

enum mapped
Vrijednosti / stanja: Docked · Cleaning · Returning · Paused · Idle · ???

Stanje usisavača

Čitanje stanja sklopke
var status := PARSEJSON(state, "$[?(@.__class == 'StatusStateAttribute')].value");

switch(status,
"docked", 0,
"cleaning", 1,
"returning", 2,
"paused", 3,
"idle", 4,
9);
Zaustavi Tipkalo
action

Zaustavi

Zapis stanja tipke
VAR response := SENDHTTPREQUEST("/api/v2/robot/capabilities/BasicControlCapability", "PUT", "{\"action\": \"stop\"}", "accept: */*", "Content-Type: application/json");
IF response.IsSuccess
 var res := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
Povezivanje: Packet Parser → HTTP
Moguća poboljšanja (10)
  • Fan speed control — Set suction power level (low, medium, high, max). Available via PUT with preset value.
  • Water usage control — Set mopping water flow level (low, medium, high). Available on models with mopping support.
  • Map snapshot — Retrieve current map as PNG image. Available via GET.
  • Zone cleaning — Start cleaning of specific zones defined by coordinates.
  • Go to location — Send robot to specific coordinates on the map.
  • Consumable monitoring — Read remaining life of filter, main brush, side brush, and sensor. Percentage or hours remaining.
  • Charging status — Battery charging state (charging, discharging, charged). Available in state attributes alongside battery level.
  • Speaker volume — Set robot speaker volume level (0-100).
  • Do not disturb — Enable/disable DND mode with start/end time.
  • WiFi signal strength — WiFi RSSI and signal quality. Available in state attributes response.

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