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.dev4.tar.gz
(15.0 kB
view hashes)
Built Distribution
mebo-0.1.0.dev4-py3-none-any.whl
(18.6 kB
view hashes)
Close
Hashes for mebo-0.1.0.dev4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 48f132d0606ece4d71edbb2d4475426badc0e29a997648217e34bd345dd4839e |
|
MD5 | 53ff8d44a68d96103d5c5e00435a7190 |
|
BLAKE2b-256 | c6f826688f290b4be22d6774b6fc770e1dbe569cdbe0169912fc52ca1138491b |