Simple python interface to control the mebo toy robot
Project description
===========
python-mebo
===========
This is a library to control the [Mebo robot](http://meborobot.com/) with Python. I'm releasing it, but it's still very much a work in progress.
Installation
---------------
``pip install mebo``
Usage
--------
Some basic usage is below. The API will change and no documentation exists, but it works for getting started.
.. code:: python
from mebo.mebo import Mebo
# replace with IP of your mebo. You can probably get it from your router. Autodiscovery is coming
m = Mebo(ip='192.168.1.100')
# supported directions ('n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw',)
# velocity is how fast the wheels turn (yes, it's technically speed, but originally I had a sign on velocity.
# Then I discovered that there were cardinal direction api calls and had to change it
m.move('n', velocity=255, duration=1000)
# dur is the value taken by the API. I'll clean it up soon - values < 1000 ms don't work
m.claw.open(dur=1000)
Development
-----------
Requirements:
~~~~~~~~~~~~~
* Docker
* make
See Makefile for instructions commands. To build image and run tests:
``make``
Todo
~~~~
* [X] Connect and control robot functions
* [ ] Discover the IP of mebo automatically?
* [ ] Cleaner API (better subclasses, kwargs for component methods, no metaprogramming)
* [ ] Clean up kwargs inconsistency
* [ ] Documentation
* [ ] Tests
* [ ] Video capture
* [ ] Audio capture
* [ ] Audio playback
python-mebo
===========
This is a library to control the [Mebo robot](http://meborobot.com/) with Python. I'm releasing it, but it's still very much a work in progress.
Installation
---------------
``pip install mebo``
Usage
--------
Some basic usage is below. The API will change and no documentation exists, but it works for getting started.
.. code:: python
from mebo.mebo import Mebo
# replace with IP of your mebo. You can probably get it from your router. Autodiscovery is coming
m = Mebo(ip='192.168.1.100')
# supported directions ('n', 'ne', 'e', 'se', 's', 'sw', 'w', 'nw',)
# velocity is how fast the wheels turn (yes, it's technically speed, but originally I had a sign on velocity.
# Then I discovered that there were cardinal direction api calls and had to change it
m.move('n', velocity=255, duration=1000)
# dur is the value taken by the API. I'll clean it up soon - values < 1000 ms don't work
m.claw.open(dur=1000)
Development
-----------
Requirements:
~~~~~~~~~~~~~
* Docker
* make
See Makefile for instructions commands. To build image and run tests:
``make``
Todo
~~~~
* [X] Connect and control robot functions
* [ ] Discover the IP of mebo automatically?
* [ ] Cleaner API (better subclasses, kwargs for component methods, no metaprogramming)
* [ ] Clean up kwargs inconsistency
* [ ] Documentation
* [ ] Tests
* [ ] Video capture
* [ ] Audio capture
* [ ] Audio playback
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mebo-0.1.0.dev2.tar.gz
(5.7 kB
view hashes)
Built Distribution
Close
Hashes for mebo-0.1.0.dev2-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 868f78e41c10d47d835f8e6a8ffde07b98ce467c1fbb4e4b28f29dda3ae29f35 |
|
MD5 | 46d98973ec4aaf5081c93ce268301f08 |
|
BLAKE2b-256 | cdb67b84cf3ab256cf069be7ad20a76db1c01831d5bad34d926fa4ef3f4a9f5f |