{"id":26732133,"url":"https://github.com/cedricbonhomme/ev3webcontroller","last_synced_at":"2025-03-28T00:50:05.630Z","repository":{"id":71262434,"uuid":"45320595","full_name":"cedricbonhomme/EV3WebController","owner":"cedricbonhomme","description":"This application provides a Web interface in order to control the EV3 robot.","archived":false,"fork":false,"pushed_at":"2023-12-06T06:59:35.000Z","size":153,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-02T05:09:30.887Z","etag":null,"topics":["ev3-robot","ev3dev","lego","python","robot","sensor"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cedricbonhomme.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-10-31T22:34:16.000Z","updated_at":"2024-05-02T05:09:30.887Z","dependencies_parsed_at":"2023-03-01T12:30:42.170Z","dependency_job_id":null,"html_url":"https://github.com/cedricbonhomme/EV3WebController","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedricbonhomme%2FEV3WebController","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedricbonhomme%2FEV3WebController/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedricbonhomme%2FEV3WebController/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cedricbonhomme%2FEV3WebController/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cedricbonhomme","download_url":"https://codeload.github.com/cedricbonhomme/EV3WebController/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245949590,"owners_count":20698922,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ev3-robot","ev3dev","lego","python","robot","sensor"],"created_at":"2025-03-28T00:50:05.022Z","updated_at":"2025-03-28T00:50:05.592Z","avatar_url":"https://github.com/cedricbonhomme.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"EV3WebController\n================\n\n# Presentation\n\n[EV3WebController](https://github.com/cedricbonhomme/EV3WebController)\nprovides a Web interface in order to control the Lego Mindstorms EV3 robot.\n\nTested with Python 3.4 and Python 2.7.\n\n# Installation\n\n## Installation of the system\n\nFirst, install [ev3dev](http://www.ev3dev.org) on your\nLego Mindstorms EV3 brick.\n\nDuring our tests we used *ev3-ev3dev-jessie-2015-09-13* with\n*python-ev3 0.0.3.0*.\n\nFor the network I recommend the Wireless Nano Adapter *Edimax EW-7811Un* which\nis working perfectly out of the box.\n\n## Installation of EV3WebController and the requirements\n\n    $ ssh root@192.168.1.16\n    $ wget https://bootstrap.pypa.io/get-pip.py\n    $ python get-pip.py\n    $ wget https://github.com/cedricbonhomme/EV3WebController/archive/master.tar.gz\n    $ tar -xzvf master.tar.gz\n    $ rm master.tar.gz\n    $ cd EV3WebController-master/\n    $ pip install -r requirements.txt\n    $ wget https://github.com/topikachu/python-ev3/archive/master.tar.gz\n    $ tar -xzvf master.tar.gz\n    $ rm master.tar.gz\n    $ cd python-ev3-master/\n    $ python setup.py install\n    $ cd ..\n    $ rm -Rf python-ev3-master/\n    $ cp conf/conf.cfg-sample conf/conf.cfg\n\nLaunch EV3WebController:\n\n    $ python runserver.py\n    * Running on http://0.0.0.0:5000/ (Press CTRL+C to quit)\n    * Restarting with stat\n\n# Launch EV3WebController at boot\n\nIn order to get EV3WebController start at boot, just create a new systemd\nservice.\n\nFirst create the file */etc/systemd/system/brickrc.service*:\n\n    [Unit]\n    Description=EV3WebController\n    After=multi-user.target\n\n    [Install]\n    WantedBy=multi-user.target\n\n    [Service]\n    Type=oneshot\n    RemainAfterExit=yes\n    ExecStart=/root/EV3WebController/run.sh\n\nThen enable the new service:\n\n    $ systemctl daemon-reload\n    $ systemctl enable brickrc.service\n    $ systemctl restart brickrc.service\n\n\n# How to use the interface\n\n## Move the robot\n\n    $ GET http://192.168.1.16:5000/move/\u003cdirection\u003e/\u003cspeed=800\u003e\n\nThe value of *speed* is optional. Default is 800.\n\nAcceptable values for *direction*:\n\n* forward;\n* backward;\n* left;\n* right;\n* stop.\n\n### Examples\n\n#### Action successfully completed\n\n    $ GET http://192.168.1.16:5000/move/forward\n    {\"action\": \"move\", \"direction\": \"forward\", \"message\": \"OK\"}\n\nIn this case the HTTP status code returned is 200.\n\n#### Unable to understand the request\n\n    $ GET http://192.168.1.16:5000/move/nowhere\n    {\"message\": \"Unknown direction\", \"direction\": \"nowhere\", \"action\": \"move\"}\n\nIn this case the HTTP status code returned is 400.\n\n#### Hit a wall\n\n    $ GET http://192.168.1.16:5000/move/forward?blocks=25\n    {\"action\": \"move\", \"direction\": \"forward\", \"message\": \"hit_wall\"}\n\nIf a wall is detected the current action is stopped and the server\nwill return the message \"hit_wall\".\n\n#### End of the labyrinth\n\n    $ GET http://192.168.1.16:5000/move/forward?blocks=20\n    {\"action\": \"move\", \"direction\": \"forward\", \"message\": \"in_target\"}\n\nIf the red color is detected the current action is stopped and the server\nwill return the message \"in_target\".\n\n## Retrieve values from sensors (not yet implemented)\n\n    $ GET http://192.168.1.16:5000/sensor/\u003csensor_name\u003e\n\nAcceptable values for *sensor_name*:\n\n* button;\n* ir_sensor.\n\n### Examples\n\n    $ GET http://192.168.1.16:5000/sensor/ir_sensor\n    {\"distance\": 12}\n    $ GET http://192.168.1.16:5000/sensor/color_sensor\n    {\"rgb\": [78, 31, 15], \"mode\": \"RGB-RAW\"}\n\n# License\n\nEV3WebController is free software released under the \"Modified BSD license\"\n\nCopyright (c) 2014-2015 Cédric Bonhomme - https://www.cedricbonhomme.org\n\n# Contact\n\n[Cédric Bonhomme](https://www.cedricbonhomme.org).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedricbonhomme%2Fev3webcontroller","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcedricbonhomme%2Fev3webcontroller","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcedricbonhomme%2Fev3webcontroller/lists"}