pxt-calliope/docs/reference/devices/signal-strength.md

Signal Strength

The signal strength function. #docs #antenna #ble

Returns the signal strength reported by the paired device from 0 (no signal) to 4 (full strength).

Bluetooth required

The functions in the devices namespace allow the BBC micro:bit to communicate with a separate (remote) device, such as a smartphone, over Bluetooth (Smart).

The set of supported events will depend on the remote device and the BBC micro:bit apps available for the remote device.

Block Editor

KindScript

export function signalStrength() : number

Returns

• the signal strength from 0 (no signal) to 4 (full strength).

Examples

Display the signal strength on screen:

devices.onSignalStrengthChanged(() => {
    basic.showNumber(devices.signalStrength(), 150)
})

See Also

tell remote control to, raise alert to, on notified, on signal strength changed