A simple Linux terminal for sending commands to and receiving messages from a Mimi-robot over BLE (UART-over-BLE protocol).
[DEPRECATED] Use C++ implementation instead.
Mimi-robot (short for Micro-Mitya) is a robot based on the micro:bit controller and the Tiny:bit mobile platform. The robot firmware is available in the repository: https://github.com/robot-mitya/microbit-v2-tinybit. The firmware implements control over the robot's peripherals and supports communication using simple text commands over USB Serial or BLE UART. Command documentation is available here.
IMPORTANT! This project is only supported on Linux.
Clone the project:
git clone [email protected]:robot-mitya/mimi-ble-terminal-py.git
cd mimi-ble-terminal-py
Create and activate a virtual environment:
python3 -m venv venv
source venv/bin/activate
Install the project dependencies:
pip install -r requirements.txt
Before running the script, you need to pair the robot with your operating system. To initiate pairing, simultaneously press the "A" and "B" buttons on the micro:bit and then power on the robot. The robot will then become discoverable as a Bluetooth-device, and you should pair it using your OS's Bluetooth settings.
After pairing, you can run the script. Running it without parameters will display a list of all paired Bluetooth-devices:
python3 main.py
Running it with the --robot-name="<robot-name>" parameter will launch the terminal, establish a connection with the robot, and allow you to send commands and receive messages.
<robot-name> is the Bluetooth alias of the robot, as shown in the list from the previous command.
The default name is "BBC micro:bit", but it may have been changed via the OS settings.
python3 main.py --robot-name="BBC micro:bit"