pxt-calliope/docs/reference/bluetooth/on-bluetooth-connected.md

On Bluetooth Connected

~hint

For another device like a smartphone to use any of the Bluetooth "services" which the @boardname@ has, it must first be paired with the @boardname@. Once paired, the other device may connect to the @boardname@ and exchange data relating to many of the @boardname@'s features.

~

This block starts an event handler which in this case will run when something connects to your @boardname@ using Bluetooth.

bluetooth.onBluetoothConnected(() => {});

Example

You could use this event handler to display a letter "C" on the @boardname@ LED grid so you know you have a Bluetooth connection. Or you might want to send some data you've been accumulating to your smartphone as soon as it connects to your @boardname@. Maybe you've been using the accelerometer in your @boardname@ to count your steps for example. Using this event handler you could send the accumulated step count to your phone when it establishes a Bluetooth connection.

bluetooth.onBluetoothConnected(() => {
    basic.showString("C");
});

Video - on Bluetooth connected

http://www.youtube.com/watch?v=HyBcsD9Eh6I

See also

About Bluetooth, @boardname@ Bluetooth profile overview , @boardname@ Bluetooth profile reference, Bluetooth on @boardname@ resources, Bluetooth SIG

bluetooth