diff --git a/docs/reference/bluetooth/start-led-service.md b/docs/reference/bluetooth/start-led-service.md new file mode 100755 index 00000000..3f0a7c19 --- /dev/null +++ b/docs/reference/bluetooth/start-led-service.md @@ -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) + diff --git a/docs/static/bluetooth/microbit_led.png b/docs/static/bluetooth/microbit_led.png new file mode 100755 index 00000000..4b5c57cd Binary files /dev/null and b/docs/static/bluetooth/microbit_led.png differ