tuya-rs 0.2.1

Tuya v3.3 local device protocol — TCP connection, packet codec, AES encryption
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# tuya-rs

[![Crates.io](https://img.shields.io/crates/v/tuya-rs.svg)](https://crates.io/crates/tuya-rs)
[![docs.rs](https://docs.rs/tuya-rs/badge.svg)](https://docs.rs/tuya-rs)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

Tuya v3.3 local protocol implementation in Rust.

Provides UDP device discovery, TCP connection, packet encoding/decoding, and AES-ECB encryption for communicating with Tuya-based IoT devices on the local network.

Part of the [robottino-rs](https://github.com/bennesp/robottino-rs) workspace.

## Usage

### Discover devices on the network

```rust
use tuya_rs::discovery;
use std::time::Duration;

let devices = discovery::discover(Duration::from_secs(10))?;
for dev in &devices {
    println!("{} @ {} (v{})", dev.device_id, dev.ip, dev.version);
}
```

No credentials needed — devices broadcast their ID and IP via UDP every ~5 seconds. The `local_key` must be obtained separately (via cloud API or [tinytuya](https://github.com/jasonacox/tinytuya)).

### Connect and send commands

```rust
use tuya_rs::connection::{DeviceConfig, TuyaConnection, TuyaCommand};

let config = DeviceConfig {
    dev_id: "your_device_id".into(),
    address: "192.168.1.42".into(),
    local_key: "0123456789abcdef".into(),
    ..Default::default()
};

let mut conn = TuyaConnection::connect(&config)?;
let response = conn.send(TuyaCommand::DpQuery, b"{}".to_vec())?;
println!("{:?}", response);
```

### Cloud API: get the local key

With the `cloud` feature, you can obtain the `local_key` via Tuya's OEM Mobile API:

```rust
use tuya_rs::api::{OemCredentials, TuyaOemApi, TuyaApi};

let creds = OemCredentials { /* from APK — see workspace README */ };
let mut api = TuyaOemApi::new(creds);
let _session = api.login("you@email.com", "password")?;

let homes = api.list_homes()?;
let devices = api.list_devices(homes[0].gid)?;
println!("local_key: {}", devices[0].local_key);
```

The OEM credentials must be extracted from the Android APK — see the [workspace README](../README.md#cloud-credentials) for details. The `xplorer-rs` crate provides pre-filled credentials for the X-Plorer app via `xplorer_oem_credentials()`.

## Features

| Flag | Description |
|------|-------------|
| *(default)* | UDP device discovery, TCP packet codec, AES-128-ECB encryption, CRC32 validation |
| `cloud` | OEM Mobile API client: login flow, device/home listing, HMAC-SHA256 request signing, AWS STS credentials for map storage |

## Modules

- **`discovery`** — UDP broadcast listener: find devices on the local network (ports 6666/6667)
- **`connection`** — `DeviceConfig`, `TuyaConnection` (TCP), `TuyaPacket` encode/decode, `TuyaCommand` enum
- **`crypto`** — AES-128-ECB with PKCS7 padding, hex encoding
- **`api`** *(cloud)* — OEM Mobile API: login, device listing, device control (`publish_dps`, `device_info`), AWS4 pre-signed URL generation
- **`signing`** *(cloud)* — HMAC-SHA256 request signing with Tuya's custom sign string format

## License

[MIT](../LICENSE)