Skip to main content

A Python driver for driving the Rover Robotics OpenRover Basic robot

Project description

OpenRover Python3 Driver

This is the official Python driver for the Rover Robotics "Open Rover Basic" robot. Use this as a starting point to get up and running quickly.


To install official releases from PyPi:

python -m pip install -U pip setuptools
python -m pip install -U openrover --no-cache-dir



Pitstop is a new utility to bootload your rover and set options. After installing, you can invoke it with pitstop or python3 -m openrover.pitstop.

> pitstop --help
usage: pitstop [-h] [-p port] [-f path/to/firmware.hex] [-m version]
               [-u k:v [k:v ...]]

OpenRover companion utility to bootload robot and configure settings.

optional arguments:
  -h, --help            show this help message and exit
  -p port, --port port  Which device to use. If omitted, we will search for a possible rover device
  -f path/to/firmware.hex, --flash path/to/firmware.hex
                        Load the specified firmware file onto the rover
  -m version, --minimumversion version
                        Check that the rover reports at least the given version
                        version may be in the form N.N.N, N.N, or N
  -u k:v [k:v ...], --updatesettings k:v [k:v ...]
                        Send additional commands to the rover. v may be 0-255; k may be:


To run tests, first attach the rover via breakout cable then run either openrover-test or python3 -m openrover.test. By default, tests that involve running the motors will be skipped, since you may not want a rover ripping cables out of your computer. If you have made sure running the motors will not damage anything, these tests can be opted in with the flag --motorok.

> openrover-test
==================== test session starts =====================
platform win32 -- Python 3.7.3, pytest-4.3.1, py-1.8.0, pluggy-0.9.0
rootdir: ..., inifile:
plugins: trio-0.5.2
collected 32 items

..\openrover\tests\ .s                [  6%]
..\openrover\tests\ ..                      [ 12%]
..\openrover\tests\ ....             [ 25%]
..\openrover\tests\ ....      [ 37%]
..\openrover\tests\   [100%]

=========== 24 passed, 8 skipped in 89.14 seconds ============

OpenRover Basic

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for openrover, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size openrover-0.3.1.tar.gz (54.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page