3.1 KiB

Raw Permalink Blame History

duplo-controller

Librairie Python minimale pour contrôler un train LEGO DUPLO Bluetooth (Hub n°5) via le protocole LEGO Wireless.

Fonctionnalités

connexion BLE avec adresse explicite ou découverte automatique du hub
avancer / reculer / stop (vitesse -100..100)
jouer les sons DUPLO (brake, station_departure, water_refill, horn, steam)
jouer un tone direct (0..10) via play_tone(...)
allumer/changer la couleur de la lumière (11 couleurs)
éteindre la lumière (turn_off_light())
script CLI interactif (duplo-test) pour tests manuels

Installation

python -m venv .venv
source .venv/bin/activate
pip install -e .

Utilisation rapide

import asyncio
from duplo_controller import DuploTrainHub, DuploColor, DuploSound

async def main():
    async with DuploTrainHub() as hub:
        await hub.forward(50)
        await asyncio.sleep(2)
        await hub.stop()
        await hub.play_sound(DuploSound.HORN)
        await hub.change_light_color(DuploColor.WHITE)
        await hub.play_tone(4)
        await asyncio.sleep(1)
        await hub.turn_off_light()

asyncio.run(main())

Script de test manuel

python -m tests.manual_test
# ou après installation:
duplo-test

Options:

--address XX:XX:XX:XX:XX:XX pour forcer une adresse BLE
--speed 50 vitesse par défaut du menu

Dans le menu, l'option de couleur supporte : black, pink, purple, blue, lightblue, cyan, green, yellow, orange, red, white.

Dans le menu, l'option son supporte : brake, station_departure, water_refill, horn, steam.

API principale

await hub.connect() / await hub.disconnect()
await hub.forward(speed=50)
await hub.backward(speed=50)
await hub.stop()
await hub.set_motor_speed(speed)
await hub.change_light_color(DuploColor.RED)
await hub.turn_off_light()
await hub.play_sound(DuploSound.HORN)
await hub.play_tone(4)
await hub.demo()

Intégration pygame (résumé)

DuploTrainHub est asynchrone (asyncio).

Option simple : démarrer une boucle asyncio dans un thread dédié et y soumettre les commandes BLE depuis la boucle pygame.
Option avancée : piloter la boucle pygame depuis une coroutine principale asyncio.

Exemple minimal de pattern (thread + loop asyncio) :

import asyncio
import threading

ble_loop = asyncio.new_event_loop()
threading.Thread(target=ble_loop.run_forever, daemon=True).start()

hub = DuploTrainHub()
asyncio.run_coroutine_threadsafe(hub.connect(), ble_loop).result()

# Depuis un event pygame:
# asyncio.run_coroutine_threadsafe(hub.forward(60), ble_loop)

# À la fin:
asyncio.run_coroutine_threadsafe(hub.disconnect(), ble_loop).result()
ble_loop.call_soon_threadsafe(ble_loop.stop)

Notes techniques

Service LEGO Hub: 00001623-1212-efde-1623-785feabcd123
Characteristic LEGO Hub: 00001624-1212-efde-1623-785feabcd123
Hub DUPLO détecté via manufacturer data LEGO (0x0397) + type 0x20

Références

Protocole officiel: https://lego.github.io/lego-ble-wireless-protocol-docs/
Référence commandes (inspiration): https://github.com/corneliusmunz/legoino

3.1 KiB Raw Permalink Blame History