pxt-calliope/docs/reference/radio/received-signal-strength.md
Peli de Halleux 2b504d863d
Radiodocsupdate (#1430)
* a few updates

* more updates

* reorder radio blocks

* more shuffling of new radio apis

* fixing hot or ocold

* more doc fixes

* more updates

* fixing docs issues

* more doc fixes

* restore docs errors

* missing packate

* renamed argument of callback

* mssing radio

* more odcs fixes

* lock turtle

* ignore docs for now
2018-10-15 15:32:09 -07:00

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 -128 to -42. (-128 means a weak signal and -42 means a strong one.)

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

radio.receivedSignalStrength();

Returns

  • a number between -128 and -42 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 received number, send number, on data received

radio