---
title: "Xiaomi 1T (Valetudo)"
description: "Robotický vysavač Xiaomi Mijia 1T ovládaný přes open-source firmware Valetudo. Monitoruj stav baterie, sleduj průběh vysávání a ovládej vysavač přes HTTP."
url: "https://taphome.com/cs/compatibility/valetudo-xiaomi-1t/"
language: cs
lastmod: 2026-03-28
generator: hugo
ai:
  topics: ["http","other","robot-vacuum","valetudo","wifi"]
  questions: ["Jak integrovat robotický vysavač Valetudo s TapHome?","Co ovládá šablona Xiaomi 1T Valetudo v TapHome?","Jak připojit Xiaomi 1T přes HTTP k TapHome?","Proč se stav vysavače zobrazuje jako neznámý v TapHome?","Co je Valetudo a jak funguje s TapHome?","Jak zkontrolovat stav baterie vysavače Valetudo v TapHome?"]
---

# Xiaomi 1T (Valetudo)

Komunikace: Packet Parser → HTTP

- [Valetudo — Open-source náhrada cloudu](https://valetudo.cloud/)
- [Valetudo podporované roboty](https://valetudo.cloud/pages/general/supported-robots.html)

> Adresa v síti
> 
> TapHome komunikuje se zařízením na adrese zadané při importu. Dejte zařízení stálou adresu — rezervaci IP v routeru, nebo jeho mDNS jméno, pokud ho podporuje —, jinak integrace přestane fungovat, když router adresu změní.
> 
> [Příprava sítě](https://taphome.com/cs/docs/setup/network-preparation/)

## Návod na integraci

Xiaomi Mijia 1T (STYTJ02ZHM) je robotický vysavač s mopem vyráběný společností Dreame a prodávaný pod značkou Xiaomi. Tato šablona vyžaduje [Valetudo](https://valetudo.cloud/) — open-source firmware, který nahrazuje závislost na cloudu výrobce lokálním HTTP API. Po nainstalování Valetudo na robota TapHome komunikuje přímo s Valetudo REST API v2 v lokální síti. Není potřeba žádné cloudové připojení ani autentizace.

Šablona poskytuje monitorování baterie, vícehodnotový indikátor stavu a tlačítka pro spuštění, pozastavení, zastavení a dokování vysavače. Funkce lokalizace spustí zvukový signál pro nalezení robota.

> [!WARNING]
> Valetudo musí být nainstalováno na robotu před použitím této šablony. Šablona komunikuje s Valetudo HTTP API, ne s cloudovými službami Xiaomi. Rootování Xiaomi 1T vyžaduje 3,3 V USB-to-UART adaptér a Dreame Breakout PCB — podrobné instrukce najdeš na [stránce podporovaných robotů Valetudo](https://valetudo.cloud/pages/general/supported-robots.html).

## Konfigurace

Během importu šablony zadej IP adresu robota v lokální síti (výchozí hodnota je `192.168.0.1`). Valetudo REST API naslouchá na portu 80 bez autentizace.

Protože Valetudo nevystavuje mDNS hostname, přiřaď robotu statickou IP adresu nebo DHCP rezervaci, aby se adresa nezměnila po restartu sítě.

> [!TIP]
> Otevři `http://<robot-ip>/swagger/` v prohlížeči pro interaktivní prozkoumání všech dostupných Valetudo API endpointů. Je to užitečné pro ověření konektivity a kontrolu aktuálního stavu robota.

## Schopnosti zařízení

### Stav baterie

Šablona čte stav nabití baterie z odpovědi `/api/v2/robot/state/attributes`. Parsuje `BatteryStateAttribute.level` (reportovaný jako 0–100) a dělí 100 pro vytvoření rozsahu 0,0–1,0 pro TapHome. Hodnota se aktualizuje každé 2,5 sekundy.

### Stav vysavače

Vícehodnotový přepínač zobrazuje aktuální provozní stav robota. Šablona parsuje `StatusStateAttribute.value` z odpovědi atributů stavu a mapuje ho na celočíselný index:

| Stav | Hodnota | Popis |
|------|---------|-------|
| Docked | 0 | Robot je na nabíjecí stanici |
| Cleaning | 1 | Aktivní cyklus vysávání |
| Returning | 2 | Návrat ke stanici |
| Paused | 3 | Vysávání pozastaveno |
| Idle | 4 | Nevysává, není na stanici |
| Unknown | 9 | Nerozpoznaný stav |

Valetudo API může reportovat i stavy `error`, `manual_control` a `moving` — tyto nejsou individuálně mapovány a zobrazí se jako „Unknown" (hodnota 9).

### Ovládání vysavače

Čtyři tlačítka ovládají vysavač přes endpoint `BasicControlCapability`:

- **Start** — spustí kompletní cyklus vysávání
- **Pause** — pozastaví aktuální operaci vysávání
- **Stop** — zastaví aktuální operaci vysávání
- **Home** — pošle robota zpět na nabíjecí stanici

Každé tlačítko odešle `PUT` požadavek na `/api/v2/robot/capabilities/BasicControlCapability` s odpovídající akcí.

### Lokalizace

Tlačítko Locate spustí zvukový signál na robotu přes endpoint `LocateCapability`. Je to užitečné pro nalezení robota, když uvázl nebo je na neočekávaném místě.

### Další schopnosti

Valetudo API vystavuje několik schopností, které nejsou v šabloně implementovány: ovládání rychlosti ventilátoru (předvolby sacího výkonu), ovládání spotřeby vody (intenzita mopování), zónové vysávání, navigace na konkrétní místo, snímky mapy, monitorování spotřebního materiálu (filtr, kartáče, senzory), hlasitost reproduktoru, plánování režimu nerušit, stav nabíjení a síla Wi-Fi signálu. Tyto mohou být přidány v budoucí aktualizaci šablony.

## Řešení problémů

### Zařízení neodpovídá

1. Ověř, že robot je zapnutý, připojený k Wi-Fi a má platnou IP adresu
2. Otevři `http://<robot-ip>/` v prohlížeči — pokud se načte webové rozhraní Valetudo, API je dostupné
3. Zkontroluj, že TapHome a robot jsou ve stejné síti nebo VLANu
4. Potvrď, že Valetudo běží — pokud byl robot obnoven do továrního nastavení, Valetudo může být potřeba přeinstalovat

### Stav zobrazuje „Unknown" (???)

Šablona mapuje pět stavů (docked, cleaning, returning, paused, idle). Pokud robot reportuje `error`, `manual_control` nebo `moving`, stav se zobrazí jako „Unknown" (hodnota 9). Toto je očekávané chování — nemapované stavy se vyskytují při okrajových situacích jako manuální RC ovládání nebo obnova po chybě.

### Stav baterie ukazuje nulu

1. Potvrď, že Valetudo běží a API odpovídá na `/api/v2/robot/state/attributes`
2. Zkontroluj, že odpověď obsahuje záznam `BatteryStateAttribute` s nenulovou hodnotou `level`
3. Pokud byl robot nedávno restartován, počkej na dokončení prvního pollingu stavu

## Dostupná zařízení 7

Tato zařízení se po importu zobrazí v TapHome.

Xiaomi 1T (Valetudo) Modul

Vlastní proměnné

Čtení (modul)

```taphome
VAR response := SENDHTTPREQUEST("/api/v2/robot/state/attributes");
IF response.IsSuccess
 state := response.Content;
ELSE
 ADDERROR(response.StatusCode + " (" + response.ReasonPhrase + ")");
END
```

Stav baterie Analogový vstup Pouze ke čtení

Stav nabití baterie — procento zbývající energie (0–100 %)

numeric Jednotka: %

Čtení vstupní úrovně

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

Domů Tlačítko Čtení i zápis

action

Zápis stavu tlačítka

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

Najít Tlačítko Čtení i zápis

Spustí zvukový signál na robotu pro pomoc s jeho nalezením

action

Zápis stavu tlačítka

```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 Tlačítko Čtení i zápis

action

Zápis stavu tlačítka

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

Start Tlačítko Čtení i zápis

action

Zápis stavu tlačítka

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

Stav vysavače Vícestavový přepínač Pouze ke čtení

Aktuální provozní stav — Docked, Cleaning, Returning, Paused, Idle nebo Unknown

enum mapped

Hodnoty / Stavy: Docked · Cleaning · Returning · Paused · Idle · ???

Čtení stavu přepínače

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

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

Stop Tlačítko Čtení i zápis

action

Zápis stavu tlačítka

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

**Připojení:** Packet Parser → HTTP

Možná vylepšení (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.

## Parametry importu

Tyto hodnoty zadáte při importu XML.

| Ptá se v aplikaci | Výchozí       |
|-------------------|---------------|
| IP adresa         | `192.168.0.1` |

## Zdroje

- 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

## Související dokumentace

- [Integrace Packet Parser](https://taphome.com/cs/compatibility/packet-parser-guide/)
- [Packet Parser (HTTP, TCP, UDP, FTP, MQTT)](https://taphome.com/cs/docs/integration/packet-parser/)
- [Funkce Packet parser](https://taphome.com/cs/docs/script/packet-parser/)
- [Funkce pro parsování](https://taphome.com/cs/docs/script/parsing-functions/)