pxt-calliope/docs/reference/radio/received-signal-strength.md

1.2 KiB

Received Signal Strength

Note: This API has been deprecated! Use on data packet received instead.

Find how strong the radio signal is, from 255 to 0. (255 means a weak signal and 0 means a strong one.)

The @boardname@ finds the signal strength by checking how strong it was the last time it ran the on data packet received function. That means it needs to run receive number first.

radio.receivedSignalStrength();

Returns

  • a number between 255 and 0 that means how strong the signal is.

Simulator

This function only works on the @boardname@, not in browsers.

Example

This example shows how strong the radio signal of the light level sender example is.

let x = 0;
radio.setGroup(99);
basic.forever(() => {
    x = radio.receiveNumber();
    basic.showNumber(radio.receivedSignalStrength());
});

See also

on data packet received, send number, on data received

radio