2016-05-25 02:40:01 +02:00
|
|
|
# Set Transmit Power
|
|
|
|
|
2016-06-03 02:08:09 +02:00
|
|
|
Make the ``radio`` signal of the micro:bit stronger or weaker.
|
|
|
|
It can be as weak as `0` and as strong as `7`.
|
|
|
|
|
|
|
|
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-05-25 02:40:01 +02:00
|
|
|
|
2016-07-18 23:04:15 +02:00
|
|
|
```sig
|
|
|
|
radio.setTransmitPower(7);
|
|
|
|
```
|
|
|
|
|
2016-06-10 00:30:47 +02:00
|
|
|
### Range
|
2016-10-25 01:30:21 +02:00
|
|
|
|
2016-06-03 02:08:09 +02:00
|
|
|
If your micro:bit is sending with a strength of `7`, and you are in
|
|
|
|
an open area without many other computers around, the micro:bit signal
|
|
|
|
can reach as far as 70 meters (about 230 feet).
|
2016-05-25 02:40:01 +02:00
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
2016-07-18 23:04:15 +02:00
|
|
|
* ``power`` is a [number](/reference/types/number) between ``0`` and ``7`` that
|
2016-06-03 02:08:09 +02:00
|
|
|
means how strong the signal is.
|
2016-05-25 02:40:01 +02:00
|
|
|
|
2016-06-10 00:30:47 +02:00
|
|
|
### Simulator
|
|
|
|
|
|
|
|
This function only works on the micro:bit, not in browsers.
|
|
|
|
|
2016-05-25 02:40:01 +02:00
|
|
|
### Example
|
|
|
|
|
2016-06-03 02:08:09 +02:00
|
|
|
This program makes the ``radio`` send at full strength.
|
2016-05-25 02:40:01 +02:00
|
|
|
|
|
|
|
```blocks
|
|
|
|
radio.setTransmitPower(7)
|
|
|
|
```
|
|
|
|
|
|
|
|
### See also
|
|
|
|
|
2016-10-25 01:30:21 +02:00
|
|
|
[on data packet received](/reference/radio/on-data-packet-received),
|
|
|
|
[send number](/reference/radio/send-number),
|
|
|
|
[send value](/reference/radio/send-value),
|
|
|
|
[send string](/reference/radio/send-string)
|
2016-08-09 17:28:08 +02:00
|
|
|
|
|
|
|
```package
|
2016-10-23 06:29:31 +02:00
|
|
|
radio
|
2016-08-09 17:28:08 +02:00
|
|
|
```
|