SmartSTROM Logo

digitalSTROM Server Api in Rust ⚡

This repository provides a digitalStrom Server API as well as a Command Line Interface to control your installation directly.

Library goals

Small footporint library
Easy to use API for digitalStrom Server
Easy to use CLI for controlling the digitalStrom server
Open to contribute for everyone

Usage of the API

Add dss as a dependency in Cargo.toml:

[dependencies]

dss = "0.1.2"

extern crate dss;

fn main() {
    // Connect to the digital strom server
    let  appt = dss::Appartement::connect("url", "user", "password").unwrap();

    // Get an overview of the complete appartment
    println!("{:#?}\n", appt.get_zones().unwrap().iter().find(|z| z.id == zone));

    // turn the light in the zone 2 and group 0 on
    appt.set_value(2, Some(0), dss::Value::Light(1.0)).unwrap();
}

Usage of the CLI

Install the CLI in your terminal by cargo install dss.
Run the CLI
- Run the CLI by typing dss and follow the login instructions
- Run the CLI by typing dss server user password to login automatically
Type zones to get an overview of your apprtment
Type office light on to turn the light on in the office zone

Other Commands are:

office light off
office light 0.0
light 1.0 office
light on 2

office schadow open open
shadow 0.5 0.5 office
shadow 0.5 close 2

Small Special for the german folks:

büro licht an
büro licht 0.0
licht 1.0 büro
licht an 2

büro schatten auf auf
schatten 0.5 0.5 büro
schatten 0.5 zu 2

Contributing

Please contribute!

The goal is to make this library as usefull as possible :)

If you need any kind of help, open an issue or write me an mail. Pull requests are welcome!

License