---
title: "Xiaomi 1T (Valetudo)"
description: "Robotski usisavač Xiaomi Mijia 1T s firmverom Valetudo otvorenog koda. Praćenje razine baterije i stanja čišćenja te upravljanje usisavačem preko HTTP-a."
url: "https://taphome.com/hr/compatibility/valetudo-xiaomi-1t/"
language: hr
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","other","robot-vacuum","valetudo","wifi"]
  questions: ["Kako integrirati robotski usisavač s firmverom Valetudo u TapHome?","Čime upravlja predložak Xiaomi 1T Valetudo u sustavu TapHome?","Kako povezati Xiaomi 1T sa sustavom TapHome preko HTTP-a?","Zašto se stanje usisavača u sustavu TapHome prikazuje kao nepoznato?","Što je Valetudo i kako radi sa sustavom TapHome?","Kako provjeriti razinu baterije usisavača Valetudo u sustavu TapHome?"]
---

# Xiaomi 1T (Valetudo)

Komunikacija: Packet Parser → HTTP

- [Valetudo — zamjena otvorenog koda za oblak](https://valetudo.cloud/)
- [Roboti koje podržava Valetudo](https://valetudo.cloud/pages/general/supported-robots.html)

> Adresa u mreži
> 
> TapHome komunicira s uređajem na adresi unesenoj pri uvozu. Dodijelite uređaju stalnu adresu — rezervaciju IP adrese u usmjerivaču ili njegovo mDNS ime ako ga podržava — inače integracija prestaje raditi kada usmjerivač promijeni adresu.
> 
> [Priprema mreže](https://taphome.com/hr/docs/setup/network-preparation/)

## Upute za integraciju

Xiaomi Mijia 1T (STYTJ02ZHM) robotski je usisavač s funkcijom brisanja koji proizvodi Dreame, a prodaje se pod markom Xiaomi. Ovaj predložak zahtijeva [Valetudo](https://valetudo.cloud/) — 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.

> [!WARNING]
> 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](https://valetudo.cloud/pages/general/supported-robots.html).

## 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.

> [!TIP]
> 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:

| Stanje | Vrijednost | Opis |
|--------|-------|-------------|
| Docked | 0 | Robot je na bazi za punjenje |
| Cleaning | 1 | Ciklus čišćenja u tijeku |
| Returning | 2 | Vraćanje na bazu |
| Paused | 3 | Čišćenje je pauzirano |
| Idle | 4 | Ne čisti i nije na bazi |
| Unknown | 9 | Neprepoznato 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 7

Ovi se uređaji pojavljuju u TapHomeu nakon uvoza.

Xiaomi 1T (Valetudo) Modul

Prilagođene varijable

Čitanje (modul)

```taphome
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: %

Čitanje razine ulaza

```taphome
PARSEJSON(state, "$[?(@.__class == 'BatteryStateAttribute')].level") / 100
```

Povratak na bazu Tipkalo Čitanje i pisanje

action

Zapis stanja tipke

```taphome
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 Čitanje i pisanje

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

action

Zapis stanja tipke

```taphome
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 Čitanje i pisanje

action

Zapis stanja tipke

```taphome
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 Čitanje i pisanje

action

Zapis stanja tipke

```taphome
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 · ???

Čitanje stanja sklopke

```taphome
var status := PARSEJSON(state, "$[?(@.__class == 'StatusStateAttribute')].value");

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

Zaustavi Tipkalo Čitanje i pisanje

action

Zapis stanja tipke

```taphome
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.

## Parametri uvoza

Ove vrijednosti unosite pri uvozu XML-a.

| Pitanje u aplikaciji | Zadano        |
|----------------------|---------------|
| IP adresa            | `192.168.0.1` |

## Izvori

- Valetudo Capabilities Overview
  
  [valetudo.cloud](https://valetudo.cloud/pages/usage/capabilities-overview.html) 2026-03-28
- Valetudo MQTT API Reference
  
  [valetudo.cloud](https://valetudo.cloud/pages/integrations/mqtt.html) 2026-03-28
- Valetudo REST API Overview (DeepWiki)
  
  [deepwiki.com](https://deepwiki.com/Hypfer/Valetudo) 2026-03-28
- Valetudo Supported Robots — Xiaomi 1T
  
  [valetudo.cloud](https://valetudo.cloud/pages/general/supported-robots.html) 2026-03-28

## Povezana dokumentacija

- [Packet Parser Integration](https://taphome.com/hr/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/hr/docs/integration/packet-parser/)
- [Funkcije Packet parsera](https://taphome.com/hr/docs/script/packet-parser/)
- [Funkcije za raščlambu](https://taphome.com/hr/docs/script/parsing-functions/)

