Setting Radio Channel, Power Level And Power Mode - ST SimpleMAC STM32W108 Series User Manual

UM0893
5.2.3

Setting radio channel, power level and power mode

Before starting transmitting or receiving a packet, select the radio channel and configure the
transmit power and transmit power mode.
Pseudocode example for setting the radio channel
uint8_t channel = USER_CHANNEL;
/* Set radio channel */
ST_RadioSetChannel(channel);
Default radio channel is 11. The radio channel ranges between 11 and 26. The first time a
channel is selected, all radio parameters are calibrated for this channel. This full calibration
process can take up to 200 ms. Subsequent calls to ST_RadioSetChannel() with the same
channel take less time (around 10 ms) because the values are retrieved from the Flash
memory tokens.
Pseudocode example for setting the radio transmit power
int8_t power = USER_TX_POWER;
/* Set radio transmit power level */
ST_RadioSetPower(power);
Default transmit power level is 3 dBm. The radio power ranges from -43 to 8 dBm. The
ST_RadioSetPower() function can set the power level to a value other that the one specified
in the power parameter, since not all integer power levels are available as lower power
levels. When a specific power level is not available, the next higher power level is used.
Pseudocode example for setting the radio power mode
uint16_t txPowerMode = USER_TX_POWER_MODE;
/* Set radio transmit power mode */
ST_RadioSetPowerMode(txPowerMode);
The txPowerMode parameter can take the following values:
bit 0
bit 1
Designing an application using the SimpleMAC Library APIs
0: Normal mode.
1: Boost mode. Selecting the Boost mode increases the Rx sensitivity by
approximately 1 dBm, and the Tx power by approximately 0.5 dBm.
0: Enables bidirectional transmit path
1: Enables alternate transmit when using an external power amplifier.
Doc ID 16995 Rev 10 41/54