jBLE4Bricks

Sun, 29 Mar 2026 00:00:00 +0000

Bibliothèque Java qui découvre, connecte et commande les hubs de briques motorisées en Bluetooth Low Energy, avec une seule API pour macOS, Windows et Linux. Le code applicatif s’écrit une fois ; les différences entre piles Bluetooth des systèmes et entre protocoles des fabricants restent dans la bibliothèque.

Développement en cours : l’API n’est pas encore stable et peut changer d’une version à l’autre, sans période de dépréciation.

Fonctionnalités

Matériel — hubs LEGO Powered Up (Hub 2, Technic Hub, Move Hub, City Hub, Mario Hub, WeDo 2.0), SBrick et Circuit Cubes. BuWizz 2.0 et 3.0 sont implémentés d’après leur documentation, sans avoir encore été vérifiés sur le matériel.
Deux niveaux d’API — une API brute (scan, connexion, lecture, écriture et notifications GATT) et un DSL fluide qui traduit les commandes de chaque protocole en méthodes nommées et se charge de l’encodage des octets.
Multiplateforme — CoreBluetooth sur macOS 13+, WinRT sur Windows 11, BlueZ (D-Bus) sur Linux, en amd64 comme en aarch64.
Filtres de scan — par type de hub LEGO, par service GATT ou par identifiant d’appareil, pour retrouver toujours la même locomotive sur un réseau de trains.
Diagnostic — journalisation détaillée côté Java et côté natif pour comprendre un échec de connexion.
Qualité — chaque build exige 99 % de couverture des instructions, 100 % des branches, Checkstyle et un Quality Gate SonarQube au vert.

Les protocoles sont tirés des spécifications publiées (LEGO Wireless Protocol 3.0 en tête) et recoupés avec node-poweredup.

jBLE4Bricks — tests sur le matériel

Sun, 29 Mar 2026 00:00:00 +0000

Projet compagnon de jBLE4Bricks : ses tests ne passent qu’avec de vrais hubs allumés à portée Bluetooth. Ils vivent dans un projet Maven séparé, pour que le build de la bibliothèque n’exige jamais la présence du matériel.

Développement en cours, au rythme de la bibliothèque.

Fonctionnalités

Tests automatiques par appareil — hubs LEGO Powered Up, SBrick, Circuit Cubes, BuWizz 2.0 et 3.0 : détection au scan, connexion et découverte des services, lecture de la batterie, commande d’arrêt acceptée. Ces tests n’actionnent aucun moteur.
Banc d’essai interactif — un tableau de bord dans le terminal pilote en même temps un WeDo 2.0, un City Hub et un Circuit Cubes : on accélère ou ralentit chaque moteur au clavier et on suit en direct le capteur de distance du WeDo. De quoi vérifier à l’œil que les moteurs tournent vraiment.
Activation au cas par cas — chaque classe de test est désactivée par défaut et ne s’active que lorsque le matériel correspondant est sur la table.

Installation

Installer d’abord jBLE4Bricks dans le dépôt Maven local, puis renseigner les identifiants Bluetooth de ses hubs dans HardwareTestConfig.java (l’identifiant dépend du système ; les tests de scan l’affichent pour chaque appareil trouvé).

bluetooth on apps

jBLE4Bricks

Fonctionnalités

jBLE4Bricks — tests sur le matériel

Fonctionnalités

Installation