micromelon 1.2.0

A Python module to control Micromelon Robots over BLE, TCP, or Serial with a Raspberry Pi connected to the rover

Micromelon Python Module

This module provides an API for connecting and controlling Micromelon Rovers and simulated rovers in the Micromelon Robot Simulator.
The API is equivalent to what is available in the Micromelon Code Editor application.

Installation

pip install micromelon

Usage

After import you will need a reference to the RoverController

from micromelon import *
rc = RoverController()

The RoverController object contains all the functionality for connection and control of the robot's state.
At the start of any script that controls the rover you will need to connect and put the rover in a running state. Once complete you will need to return the rover to the idle state and optionally you can end the Python program.

rc.connectBLE(1) # Connects over Bluetooth to rover with ID of 1
rc.startRover() # Puts in running state

# Body of script controlling rover
# eg. Motors.write(20, 20, 1)

rc.stopRover() # Returns to idle state
rc.end() # Disconnects and end Python program

Full code examples available in the examples folder.

Documentation

Generating Documentation

Full API documentation available at https://micromelon-robotics.github.io/mm-pymodule/

Documentation is generated through the python module pdoc3.
Full documentation on pdoc available here.

1. Installing pdoc

Install pdoc through pip.
Requires python 3.

pip3 install pdoc3

2. Generating HTML

pdoc --html --template-dir docs/pdoc_templates -o docs micromelon -f

3. Running docs locally

You can run the documentation as a webserver on your local machine with:

pdoc --http : micromelon

Then open http://localhost:8080/ in a browser.

Building

Get Python build tool

python -m pip install --upgrade build

Build package

python -m build

Uploading

Install twine

python -m pip install --upgrade twine

Uploading

python -m twine upload dist/*