Skip to content

shamlian/root-robot-sdk

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

root-robot-sdk

Python control of Root Robot via BLE

Open Source Licence: BSD

This example will allow you to control a Root Robot via Python on a Bluetooth-equipped Raspberry Pi (or any other Linux computer with Bluetooth).

Instructions (from the Linux command line):

  1. Install Gatt-Python by following the instructions here: https://github.com/getsenic/gatt-python#installing-gatt-sdk-for-python
  2. If you're using a RasperryPi 3 or Zero W, you've already got Bluetooth Low Energy (BLE) built in, along with the necessary BlueZ library. If not, follow the Gatt instructions: https://github.com/getsenic/gatt-python#prerequisites
  3. Install crc8 (sudo pip3 install crc8) to do message CRC checks.
  4. If you're on a Raspberry Pi 3 or Zero W, follow the directions here so that the pi user has access to BLE: https://www.raspberrypi.org/forums/viewtopic.php?t=108581
  5. Clone this repo: "git clone https://github.com/shamlian/PyRoot.git"

Supplied examples:

  1. Simple driving: type "python3 drive-root.py" and then, after it finds your Root, type in command letters followed by the enter key when prompted.
  2. Plot an svg file: type "python3 svg_plot.py --help" to learn how to use the example plotter.

The full Root API is here: https://github.com/RootRobotics/root-robot-ble-protocol ; if you find something I've missed, file an issue! Pull requests are welcomed.

Thanks to https://github.com/zlite for providing a jumping-off point, and to https://github.com/mogenson for his original work!

About

Python control of Root Robot via BLE

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages