Added documentation for Bluetooth LED service
This commit is contained in:
parent
eb01245cce
commit
c1656cf441
38
docs/reference/bluetooth/start-led-service.md
Executable file
38
docs/reference/bluetooth/start-led-service.md
Executable 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
BIN
docs/static/bluetooth/microbit_led.png
vendored
Executable file
Binary file not shown.
After Width: | Height: | Size: 168 KiB |
Loading…
Reference in New Issue
Block a user