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.

library on apps

jBLE4Bricks

Fonctionnalités