Added documentation for Bluetooth LED service

This commit is contained in:
Martin Woolley 2016-06-21 08:01:33 +01:00
parent eb01245cce
commit c1656cf441
2 changed files with 38 additions and 0 deletions

View File

@ -0,0 +1,38 @@
# Bluetooth LED Service
![](/static/bluetooth/Bluetooth_SIG.png)
The Bluetooth LED service allows another device such as a smartphone to send short text strings or patterns over a Bluetooth connection to a micro:bit for display on its LED matrix. Text will scroll across the micro:bit and the speed at which it scrolls can also be controlled using the Bluetooth LED service. Devices using the LED service may also read the current state of the micro:bit's LED matrix.
So you could, for example, draw a smiley face in a smartphone app and at the press of a button, have it magically appear on your micro:bit on the other side of the room. Or you could program your smartphone to send a message to your micro:bit whenever your phone receives an email, SMS or social media message so you could wear your micro:bit like a smart watch and leave your phone in your bag.
No additional code is needed on the micro:bit to use the Bluetooth LED service from another device.
~~~~sig
bluetooth.startLEDService();
~~~~
### Example: Starting the Bluetooth LED service
The following code shows the Bluetooth LED service being started:
~~~~blocks
bluetooth.startLEDService();
~~~~
### Video - LED service demo starts at 2:00
[![micro:bit Bluetooth demo video](/static/bluetooth/microbit_led.png)](
http://www.youtube.com/watch?v=aep_GVowKfs "Click to launch YouTube video"
)
### Advanced
For more advanced information on the micro:bit Bluetooth LED service including information on using a smartphone, see the [Lancaster University micro:bit runtime technical documentation](http://lancaster-university.github.io/microbit-docs/ble/led-service/)
### See also
[Bluetooth SIG](https://www.bluetooth.com)
[Bluetooth on micro:bit resources](http://bluetooth-mdw.blogspot.co.uk/p/bbc-microbit.html)

BIN
docs/static/bluetooth/microbit_led.png vendored Executable file

Binary file not shown.

After

Width:  |  Height:  |  Size: 168 KiB