kasa-core

Core library for communicating with TP-Link Kasa smart home devices.

This crate implements the TP-Link Smart Home Protocol, which uses an XOR autokey cipher for encryption over TCP/UDP port 9999.

Features

• Async API using Tokio
• Protocol encryption/decryption (XOR autokey cipher)
• TCP communication with Kasa devices
• UDP broadcast discovery to find devices on the local network
• Broadcast commands to all devices in parallel
• Predefined command constants for common operations
• Support for both IP addresses and hostnames

Installation

[dependencies]
kasa-core = "0.1.0"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }

Usage

use kasa_core::{commands, send_command, discover, DEFAULT_PORT, DEFAULT_TIMEOUT, DEFAULT_DISCOVERY_TIMEOUT};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    // Discover devices on the local network
    let devices = discover(DEFAULT_DISCOVERY_TIMEOUT).await?;
    for device in &devices {
        println!("Found: {} ({}) at {}", device.alias, device.model, device.ip);
    }

    // Send a command to a specific device
    let response = send_command(
        "192.168.1.100",
        DEFAULT_PORT,
        DEFAULT_TIMEOUT,
        commands::INFO,
    ).await?;
    println!("{}", response);

    // Turn on the relay
    send_command(
        "192.168.1.100",
        DEFAULT_PORT,
        DEFAULT_TIMEOUT,
        commands::RELAY_ON,
    ).await?;

    Ok(())
}

Available Commands

The commands module provides constants for common operations:

Supported Devices

The following devices have been tested, but others using the same protocol should work:

• HS100 - Smart Wi-Fi Plug
• HS103 - Smart Wi-Fi Plug Lite
• HS110 - Smart Wi-Fi Plug with Energy Monitoring
• KP115 - Smart Wi-Fi Plug Slim with Energy Monitoring

License

MIT