#smart #tp-link #plugs #error #manipulate #hs100 #hs110

hs100api

A library to manipulate and get data from a TP-Link HS-100/110 smart plugs

2 releases

Uses old Rust 2015

0.1.1 Jul 16, 2017
0.1.0 Jul 16, 2017

#823 in Hardware support

29 downloads per month

MIT license

10KB
211 lines

HS100 API for Rust

CratesIo

Simple library in Rust to access HS100/110 functions.

Special thanks to: https://github.com/sausheong/hs1xxplug for the Go version (which this library is basically a port from).

Resource on Reverse Engineering the HS110: https://www.softscheck.com/en/reverse-engineering-tp-link-hs110/

Usage

extern crate hs100;

use hs100::SmartPlug;
use hs100::error::Error;

const HOST: &'static str = "192.168.0.37:9999"; // your device IP

fn main() {
    let api = SmartPlug::new(HOST);

    // Quick example:
    println!("[sysinfo]: {:?}\n", api.sysinfo());
    println!("[meterinfo]: {:?}\n", api.meterinfo());
    println!("[dailystats]: {:?}\n", api.dailystats(7, 2017));

    // Handle specific error types:
    match api.sysinfo() {
        Ok(info) => println!("[sysinfo]: {:?}\n", info),
        Err(err) => {
            match err {
                Error::IoError(_) => println!("some io error occurred"),
                Error::EncryptError => println!("error encrypting the message"),
                Error::DeserializeError(_) => println!("couldn't deserialize the message"),
            }
        }
    }

    // See the example folder for more usage patterns.
}

TODO

  • Deserialize json into structs
  • Proper error handling
  • Use Futures / asynchronous I/O

License

MIT

Dependencies

~0.8–1.6MB
~36K SLoC