5f7a8e5301
* update yotta defaults for 16kb devices * refactor deprecated blocks * updates for button events * update button events * update refference * update docs * update docs * update button event blocks * update docs * update block id
63 lines
1.6 KiB
Markdown
63 lines
1.6 KiB
Markdown
# received Signal Strength
|
|
|
|
Find how strong the radio signal is.
|
|
|
|
```sig
|
|
radio.receivedSignalStrength();
|
|
```
|
|
|
|
### ~ hint
|
|
|
|
#### Deprecated
|
|
|
|
This API has been deprecated! Use [received packet](/reference/radio/received-packet) instead.
|
|
|
|
### ~
|
|
|
|
Find how strong the ``radio`` signal is, from `-128` to `-28`.
|
|
(`-128` means a weak signal and `-28` 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](/reference/radio/on-received-number) function. That means
|
|
it needs to run **receive number** first.
|
|
|
|
## Returns
|
|
|
|
* a [number](/types/number) between `-128` and `-28` that means
|
|
how strong the signal is.
|
|
|
|
### ~ hint
|
|
|
|
#### Signal strength and board version
|
|
|
|
Measurement of the received signal strength is dependent on what version of @boardname@ you have. The @boardname@ boards prior to v2 can typically measure a signal strength up to `-42` dBm. Now, v2 boards will measure a signal strength up to `-28` dBm (typical).
|
|
|
|
### ~
|
|
|
|
## 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](/reference/radio/send-number) is.
|
|
|
|
```blocks
|
|
let x = 0;
|
|
radio.setGroup(99);
|
|
basic.forever(() => {
|
|
x = radio.receiveNumber();
|
|
basic.showNumber(radio.receivedSignalStrength());
|
|
});
|
|
```
|
|
|
|
## See also
|
|
|
|
[on received number](/reference/radio/on-received-number), [send number](/reference/radio/send-number),
|
|
[on data received](/reference/radio/on-data-received), [received packet](/reference/received-packet)
|
|
|
|
```package
|
|
radio
|
|
``` |