microblue

An easy solution to communicate with your micro:bit by bluetooth

Note: Raspbian/linux are currently the only tested OSes. The other platforms as Windows, Mac OS X, FreeBSD should also work.

Status

This library is in the early stages so things might change and break. Apologies in advance! If the version you use is not stable please try with a previous version.

Prerequisites

It is necessary to paire your device (PC/raspberry/mobile) to the micro:bit without connect it.

Linux

• Kernel version 3.6 or above
• sh libbluetooth-dev

Ubuntu/Debian/Raspbian

sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev

Make sure node is on your path, if it's not, some options:

• symlink nodejs to node: sudo ln -s /usr/bin/nodejs /usr/bin/node
• install Node.js using the NodeSource package

Paire the micro:bit (without graphic solution)

bluetoothctl

scan on

Went your micro:bit is discover

scan off

pair xx:xx:xx:xx:xx:xx

exit

Install

npm install microblue

Usage

var microblue = require('microblue');

Actions

Connect to your micro:bit

microblue.connect(callback());

Uart

Read

microblue.read(callback(data));

Write

var data = Buffer.from('...');

microblue.write(data); //data is a Buffer

Accelerometer

Read

microblue.accelerometer(callback(data)); //data is a JSON which contains measurements for X, Y and Z axes

Magnetometer

Read

microblue.compass(callback(data)); //data is a JSON which contains measurements for X, Y and Z axes

Create at

To Do

• ~~Create function to Read/Write (Uart)~~
• ~~Create function to Read data from accelerometer~~
• ~~Create function to Read data from magnetometer~~
• Create function to Read input from the buttons
• Create function to Read/Write input from the IO pins
• Create function to Read/Write on the LED matrix
• Create function to Read temperature