Diese Anleitung beschreibt, wie der mBot-Roboter per BLE (Bluetooth Low Energy) mit bleak unter Ubuntu angesprochen werden kann. Dabei wird ein Python-Skript (makeblock_test.py) verwendet, das testweise die LEDs des mBots schalten kann.

• Voraussetzungen
  • Installation der benötigten Pakete
• bluetoothctrl
  • Umgang mit dem wichtigen Tool zur Kontrolle der angeschlossenen Bluetoothgeräte.
• Testen
  • Testen (hier in Python) der Verbindung und Steuern des mBot-Roboters.

Getestet wurde mit folgender Umgebung:

• Ubuntu (getestet mit 20.04 & 22.04, sollte auch auf anderen Versionen laufen)
• Python 3.11+ (Empfohlen: Anaconda oder System-Python)
• Bluetooth-Adapter mit BLE-Unterstützung
  • USB-BT500 ASUS

Führen Sie folgende Befehle aus, um alle benötigten Systempakete zu installieren:

sudo apt update
sudo apt install bluetooth bluez bluez-tools rfkill libbluetooth-dev

Damit Ihr Benutzer Bluetooth nutzen kann, muss er in die bluetooth-Gruppe aufgenommen werden:

sudo usermod -aG bluetooth $USER
newgrp bluetooth  # Änderungen sofort anwenden

Starten Sie anschließend den Bluetooth-Stack neu:

sudo systemctl restart bluetooth
sudo rfkill unblock bluetooth

Damit Sie BLE-Geräte steuern können, benötigen Sie bleak.

conda install -c conda-forge bleak

Falls Sie kein Conda nutzen:

pip install bleak

Die Bluetooth-Schnittstelle wird mit dem Tool bluetoothctlkontrolliert.

bluetoothctl

Falls Sie bereits in bluetoothctl sind, sehen Sie eine Eingabezeile wie:

[bluetooth]#

scan on

Lassen Sie den Scan 10–15 Sekunden laufen, bis Ihr mBot erscheint. Er sollte eine MAC-Adresse in diesem Format haben: 10:A5:62:22:CA:C4.

Ersetzen Sie die MAC-Adresse mit der Ihres mBots:

trust 10:A5:62:22:CA:C4
connect 10:A5:62:22:CA:C4

Falls die Verbindung klappt, sehen Sie:

[CHG] Device 10:A5:62:22:CA:C4 Connected: yes
Connection successful

Falls die Verbindung fehlschlägt, Bluetooth-Dienst neu starten:

sudo systemctl restart bluetooth

Falls Ihr mBot direkt nach dem Verbinden mit Ubuntu verbunden bleibt, trennen Sie ihn:

disconnect 10:A5:62:22:CA:C4
remove 10:A5:62:22:CA:C4

Hinweis: Der mBot sollte nur mit dem Python-Skript verbunden sein, nicht dauerhaft mit Ubuntu!

Dieses Skript prüft, ob bleak den mBot erkennt.

import asyncio
from bleak import BleakScanner

async def scan():
    print("Scanne nach BLE-Geräten...")
    devices = await BleakScanner.discover()
    for device in devices:
        print(f"Gefunden: {device.name} - {device.address}")

asyncio.run(scan())

Falls Ihr mBot erkannt wird, ist alles korrekt eingerichtet!

Dieses Script steuert mit einfachen Kommandos die LED's des mBot.

import asyncio
from bleak import BleakClient

# TODO ADJUST START
#  Makeblock BLE-Adresse hier eintragen
device_address = "10:A5:62:22:CA:C4"
# TODO_ADJUST END

WRITE_CHAR_UUID = "0000ffe3-0000-1000-8000-00805f9b34fb"

async def send_char(client, char):
    """Sendet ein einzelnes Zeichen über BLE"""
    try:
        data = bytearray([ord(char)])  # Konvertiere Zeichen in Byte
        await client.write_gatt_char(WRITE_CHAR_UUID, data)
        print(f"Gesendet: {char}")
    except Exception as e:
        print(f"Fehler beim Senden von '{char}': {e}")

async def main():
    """Verbindet sich mit dem mBot und sendet Befehle"""
    try:
        async with BleakClient(device_address) as client:
            if await client.is_connected():
                print(f"Verbunden mit {device_address}")

                while True:
                    user_input = input("Gib 'r', 'g', 'b', '0' zum Senden ein oder 'q' zum Beenden: ")

                    if user_input == 'q':
                        print("Programm beendet.")
                        break  # Beende das Programm
                    elif user_input in ['r', 'g', 'b', '0']:
                        await send_char(client, user_input)  # Sende das Zeichen
                    else:
                        print("Ungültige Eingabe! Bitte 'r', 'g', 'b', '0' oder 'q' eingeben.")

    except Exception as e:
        print(f"Verbindungsfehler: {e}")


asyncio.run(main())