diff --git a/docs/reference/radio/received-signal-strength.md b/docs/reference/radio/received-signal-strength.md new file mode 100644 index 00000000..d4d483e8 --- /dev/null +++ b/docs/reference/radio/received-signal-strength.md @@ -0,0 +1,36 @@ +# Received Signal Strength + +Find how strong the ``radio`` signal is, from `255` to `0`. +(`255` means a weak signal and `0` means a strong one.) + +The micro:bit finds the signal strength by checking how strong it was +the last time it ran the +[receive number](/reference/radio/receive-number) function. That means +it needs to run **receive number** first. + +### Returns + +* a [number](/reference/types/number) between `255` and `0` that means +how strong the signal is. + +## Simulator + +This function only works on the micro:bit, not in browsers. + +### Example + +This example shows how strong the radio signal of the +[light level sender example](/reference/input/send-number) is. + +```blocks +let x = 0; +radio.setGroup(99); +basic.forever(() => { + x = radio.receiveNumber(); + basic.showNumber(radio.receivedSignalStrength()); +}); +``` + +### See also + +[receive number](/reference/radio/receive-number), [send number](/reference/radio/send-number), [on data received](/reference/radio/on-data-received)