Repository files navigation

Started as a project to support OTA for MySensors and proxy for all other requests. Now exposesWebOfThings APIs for MySensors (supporting very few sensors at the moment) and on it's way to be a fully functional API based controller for MySensors. Contributions to support other sensors are welcome.

All the APIs are available as postman collection and the docs can be foundhere.

There is also a pending task to add Swagger UI as part of the server .

Integration withThings Gateway

This server also acts as a proxy between Gateway and the Controller. Both might be either connected through a serial port or a TCP connection.

Before running the server, set the correct connection type and connection port for Gateway and Controller in conf.toml file.

WoT api's are exposed athttps://{host}:8888

git clone https://github.com/tsathishkumar/MySController-rs.gitcd MySController-rssudo cargo run

If you notice any errors, make sure you have the latest rust toolchain:

rustup default beta

Beta version of toolchain is necessary for features like cargoedition field.

• Add the following to your /etc/apt/sources.list system config file:

  echo"deb http://dl.bintray.com/tsathishkumar/myscontroller-rs vivid main"| sudo tee -a /etc/apt/sources.list

• Update the package list

  apt-get update

• Install the package

  apt install myscontroller-rs

• The configuration of the server can be found at the below location.

  /etc/myscontroller-rs/conf.toml

  Example settings:

  encoding=utf-8[Gateway]type=TCPport="10.11.12.13:5003"[Controller]type=TCPport="0.0.0.0:5003"[Server]database_url="/var/lib/myscontroller-rs/sqlite.db"

• Set up the right Gateway IP and Controller IP and restart the service.

  systemctl restart myscontroller-rs.service

Note: If you are using TCP for controller - the port value will be used to create TCP server listening on the specified port. (So it shoud be the address of the machine running MySController, 0.0.0.0 always)

1. Add Web Thing add-on as follows

   Settings -> Add-ons -> Add -> Web Thing

2. Click on configure on Web Thing add-on and add the myscontroller-rs server url

   http://localhost:8888

3. Go toThings page and click on+ and you should be able to see all the sensors that are available through my-sensors network.

Check out theTODO list, and pick whichever you are interested or raise issues if you have encountered any.