pxt-calliope/docs/reference/radio/set-transmit-power.md

45 lines
1.1 KiB
Markdown
Raw Normal View History

2018-07-09 11:17:32 -07:00
# set Transmit Power
Make the ``radio`` signal of the @boardname@ stronger or weaker. It can be as weak as `0` and as strong as `7`. Default is ``6``.
2016-06-02 17:08:09 -07:00
The scientific name for the strength of the ``radio`` signal is
**dBm**, or **decibel-milliwatts**. A signal strength of `0`
can be measured as -30 dBm, and a strength of `7` can be
measured as +4 dBm.
2016-07-18 14:04:15 -07:00
```sig
radio.setTransmitPower(7);
```
## Range
2016-11-01 17:44:37 -07:00
If your @boardname@ is sending with a strength of `7`, and you are in
an open area without many other computers around, the @boardname@ signal
2016-06-02 17:08:09 -07:00
can reach as far as 70 meters (about 230 feet).
## Parameters
2018-07-09 11:17:32 -07:00
* ``power`` is a [number](/types/number) between ``0`` and ``7`` that means how strong the signal is.
## Simulator
2016-06-09 15:30:47 -07:00
2016-11-01 17:44:37 -07:00
This function only works on the @boardname@, not in browsers.
2016-06-09 15:30:47 -07:00
## Example
2016-06-02 17:08:09 -07:00
This program makes the ``radio`` send at full strength.
```blocks
radio.setTransmitPower(7)
```
## See also
2018-07-09 11:17:32 -07:00
[get received packet property](/reference/radio/get-received-packet-property),
[send number](/reference/radio/send-number),
[send value](/reference/radio/send-value),
[send string](/reference/radio/send-string)
```package
radio
```