home-easy-rs
============

![Travis CI](https://travis-ci.org/NSenaud/home-easy-rs.svg?branch=master)

Description
-----------

`home-easy-rs` aims to implement the home-easy protocol, used by some home automation devices. Currently, it have been tested with Chacon [DIO remote plugs](https://www.leroymerlin.fr/v3/p/produits/lot-de-3-prises-telecommandables-interieure-dio-e183624) (Ref. 54760), a Seeds Studio 433MHz emetter and a Raspberry Pi 3 on ArchLinux. The current code is mostly a translation of the C++ code of [Vincent Demay](http://www.homautomation.org/2013/10/09/how-to-control-di-o-devices-with-a-raspberry/) and [Idleman](http://blog.idleman.fr/raspberry-pi-10-commander-le-raspberry-pi-par-radio/).

This code produce both a libray to use with your own projects, and a CLI utility called `dios` to test it easily.

Cross-Compile
-------------

You can use [cross](https://github.com/rust-embedded/cross) to compile for ARM
architecture (tested on Raspberry Pi):
```bash
cross build --target=armv7-unknown-linux-musleabihf --release
```

Use in a Container
------------------

You can use the `Makefile` directly to build a release version and create a
Docker image to deploy easily.
```bash
make release
```

On your Raspberry Pi, you can then run the `dios` command from Docker:
```bash
docker run --device /dev/gpiomem dios:v0.2.0 ./dios 0 12341234 1 off
```

CLI Utility Usage
-----------------

You must first authentify the emetter with the receipter (the way to do it depends on your device, please refer to its manual).

```bash
sudo dios 0 12321234 3 on -v
```