JavaScript library to control SBrick (a Lego® Power Functions compatible Bluetooth controller) through Web Bluetooth APIs.
Project page: sbrick.360fun.net
Check your browser and platform implementation status first.
bluetooth.js Generic library that I previusly made to simplify the use of the Web BLuetooth APIs.
promise-queue Promise-based Queue library, since ECMAScript 6 doesn't implement one by itself.
You must have a SBrick or SBrick Plus in order to use this library with your Lego® creations.
The currently supported firmware is 4.17+, so upgrade your SBrick to be compatible with the SBrick protocol 17.
Device information - 180a
- Model number string
- Firmware revision string
- Hardware revision string
- Software revision string
- Manufacturer string
Remote control service - 4dc591b0-857c-41de-b5f1-15abda665b0c (partially implemented)
- 00 Break
- 01 Drive
- 0F Query ADC (Temperature, Battery voltage + Sensor measurements on Sbrick Plus)
- 2C PVM (Periodic Voltage Measurements on SBrick Plus)
Quick Drive - 489a6ae0-c1ab-4c9c-bdb2-11d373c1b7fb
OTA service - 1d14d6ee-fd63-4fa1-bfa4-8f47b42119f0 (NOT implemented)
In order to use the class is necessary to create an instance of it, in this way is possible to connect multiple Sbricks at the same time! ;)
If not specified any name the discovery popup will show all the nearby BLE devices, otherwise it will filter them by the given string.
let SBRICK1 = new SBrick(); // create a new SBrick object
let SBRICK2 = new SBrick('SBrick'); // create a new SBrick object and set the device name
SBRICK1.connect(); // open a popup showing all the BLE devices nearby
SBRICK2.connect(); // show only the SBricks with "Sbrick" in their name (so also "SBrick1" for example)
.then( ()=> {
// the SBrick is now connected
} );
SBRICK1.disconnect()
.then( ()=> {
// the SBrick is now disconnected
} );
Check if the SBrick is connected:
SBRICK1.isConnected(); // returns true or false
Get basic SBrick Informations:
SBRICK1.getModelNumber().then( model => {
alert( model );
});
SBRICK1.getFirmwareVersion().then( version => {
alert( version );
});
SBRICK1.getHardwareVersion().then( version => {
alert( version );
});
SBRICK1.getSoftwareVersion().then( version => {
alert( version );
});
SBRICK1.getManufacturerName().then( version => {
alert( version );
});
Sending a command is pretty easy and some constants will help the process:
SBRICK1.CHANNEL0-3 // Channels 0 to 3
SBRICK1.CW-CCW // Clockwise and Counterclockwise
SBRICK1.MIN // Minimum power
SBRICK1.MAX // Maximum power for Drive (255)
Get the Battery voltage:
SBRICK1.getBattery()
.then( battery => {
alert( battery + '%' );
} );
Get the SBrick internal Temperature:
let fahrenheit = true-false; // default is false: C°
SBRICK1.getTemp(fahrenheit)
.then( temp => {
alert( temp + fahrenheit ? ' F°' : ' C°' );
});
Get sensor data (SBrick Plus only!) - work in progress:
SBRICK1.getSensor(SBRICK1.PORT0)
.then( data => {
console.log( data );
});
To send a Drive command is pretty easy, are just needed: channel, direction and power. For example, the Channel 0 (supposedly a motor) drives in clockwise direction at the maximum (255) speed:
SBRICK1.drive( SBRICK1.CHANNEL0, SBRICK1.CW, SBRICK1.MAX );
QuickDrive permits to send up to 4 Drive commands at the same instant, without any delay between the channels. It accepts an Array of Objects (1 to 4) or a single Object (but better use Drive in that case). In the following example Channel 0 and 1 start to drive both in clockwise direction at the max speed:
SBRICK1.quickDrive( [
{ channel: SBRICK1.CHANNEL0, direction: SBRICK1.CW, power: SBRICK1.MAX }
{ channel: SBRICK1.CHANNEL1, direction: SBRICK1.CW, power: SBRICK1.MAX }
] );
Stop a specific Channel.
SBRICK1.stop( SBrick.CHANNEL0 ); //stops Channel 0
Stop all Channels at once.
SBRICK1.stopAll();
SBrick Plus support is partially implemented: any help will be appreciated!
I tried my best to manage errors but there's more work to be done.
Francesco Marino - [email protected] - www.360fun.net