2.1.28, initiation update to PXT v5.28.24 (#54)

This commit is contained in:
Amerlander
2019-12-02 05:58:26 +01:00
committed by Peli de Halleux
parent 38a964516e
commit 5c114a0c57
1261 changed files with 50692 additions and 21604 deletions

View File

@ -1,33 +1,33 @@
# Set Transmit Power
# 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`.
```sig
radio.setTransmitPower(7);
```
The signal can be as weak as `0` and as strong as `7`. Default is ``6``.
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.
```sig
radio.setTransmitPower(7);
```
### Range
## Range
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
can reach as far as 70 meters (about 230 feet).
### Parameters
## Parameters
* ``power`` is a [number](/reference/types/number) between ``0`` and ``7`` that
means how strong the signal is.
* ``power`` is a [number](/types/number) between ``0`` and ``7`` that means how strong the signal is.
### Simulator
## Simulator
This function only works on the @boardname@, not in browsers.
### Example
## Example
This program makes the ``radio`` send at full strength.
@ -35,9 +35,9 @@ This program makes the ``radio`` send at full strength.
radio.setTransmitPower(7)
```
### See also
## See also
[on data packet received](/reference/radio/on-data-packet-received),
[received packet](/reference/radio/received-packet),
[send number](/reference/radio/send-number),
[send value](/reference/radio/send-value),
[send string](/reference/radio/send-string)