xerodotc / overdrive-python

Anki Overdrive API for Python

overdrive-python

Object interface for controlling Anki Overdrive with Python.

This project provide an API to control Anki Overdrive from Python. Commands are mostly reverse engineered from Anki Drive SDK and node-mqtt-for-anki-overdrive.

This code is depended on bluepy, so it's only work on Linux system.

Requirements

• Python 3.4+
• bluepy
• Root permission

Usages

To use this interface, start with initiate Overdrive object with desired Bluetooth MAC address:

from overdrive import Overdrive

car = Overdrive("YOUR OVERDRIVE MAC ADDRESS")

For example, if your Overdrive Bluetooth MAC address is 00:11:22:33:44:55, use the following code:

from overdrive import Overdrive

car = Overdrive("00:11:22:33:44:55")

After initialization, you can perform desired action on created object. For example, if you want to set a speed for your Overdrive, call changeSpeed function on car object. The following code is an example with speed of 500 and acceleration of 1000:

car.changeSpeed(500, 1000)

Documentation

See overdrive.py file.

License

This project is licensed under MIT license. See LICENSE file for details.

overdrive-python's Issues

Fork and PyPI upload

Hi, thanks for the library! This is really useful for the project I'm working on.

I've forked your code and made a few changes, mostly to the handling of messages received by the cars. In order to use this library in projects, I've created a PyPI package.

Since I need to get on with my project this week, I'm publishing from my own repository, but as it's mostly your code, would you rather have control of this? It probably makes more sense, because I don't own the Anki kit I'm working with. It can be set up so we can both be listed as owners/collaborators on PyPI now.

Happy to discuss how you want to proceed with this.

Cheers,
Ellis

Velocity Measurements

Hi!
Using this API I'm trying to implement an anti collision algorithm on the anki vehicles, which is dependent on the velocity and position measurements. Do you know if these are measured separately (so with different sensors). And it seems that the velocity measurements are only send when a also new location measurements are available, is this correct? There could be over 1 second between location measurements, but for the anti collision algorithm I need higher frequency velocity measurements..
Thank you in advance.