pxt-calliope/docs/reference/radio/set-transmit-power.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.1 KiB

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.

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.

radio.setTransmitPower(7);

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

  • power is a number between 0 and 7 that means how strong the signal is.

Simulator

This function only works on the @boardname@, not in browsers.

Example

This program makes the radio send at full strength.

radio.setTransmitPower(7)

See also

received packet, send number, send value, send string

radio