#EV3WebController

#Presentation

EV3WebController provides a Web interface in order to control the Lego Mindstorms EV3 robot.

Tested with Python 3.4 and Python 2.7.

#Installation

First, install ev3dev on your Lego Mindstorms EV3 brick.

For the network I recommend the Wireless Nano Adapter Edimax EW-7811Un which is working perfectly out of the box.

Then on the robot:

$ ssh root@192.168.1.16
$ wget https://bootstrap.pypa.io/get-pip.py
$ python get-pip.py
$ wget https://bitbucket.org/cedricbonhomme/ev3webcontroller/get/master.tar.gz
$ tar -xzvf master.tar.gz
$ rm master.tar.gz
$ cd cedricbonhomme-ev3webcontroller-*
$ pip install -r requirements.txt
$ wget https://github.com/topikachu/python-ev3/archive/master.tar.gz
$ tar -xzvf master.tar.gz
$ rm master.tar.gz
$ cd python-ev3-master/
$ python setup.py install
$ cd ..
$ rm -Rf python-ev3-master/
$ cp conf/conf.cfg-sample conf/conf.cfg

Launch the web server:

$ python runserver.py

#How to use the interface

#Move the robot

$ GET http://192.168.1.16:5000/move/<direction>/<speed=60>

The value of speed is optional. Default is 60.

Acceptable values for direction:

• forward;
• backward;
• left;
• right;
• stop.

#Examples

$ GET http://192.168.1.16:5000/move/forward/50
{"message": "OK", "direction": "forward", "action": "move"}

In this case the HTTP status code returned is 200.

$ GET http://192.168.1.16:5000/move/nowhere
{"message": "Unknown direction", "direction": "nowhere", "action": "move"}

In this case the HTTP status code returned is 400.

#Retrieve values from sensors

$ GET http://192.168.1.16:5000/sensor/<sensor_name>

Acceptable values for sensor_name:

• button;
• ir_sensor.

#Examples

$ GET http://192.168.1.16:5000/sensor/ir_sensor
{"distance": 12}

#Donation

If you wish and if you like EV3WebController, you can donate via bitcoin 1GVmhR9fbBeEh7rP1qNq76jWArDdDQ3otZ. Thank you!

#License

EV3WebController is free software released under the "Modified BSD license"

Copyright (c) 2014-2015 Cédric Bonhomme - https://www.cedricbonhomme.org

#Contact

Cédric Bonhomme.