Definition: This function is called by the stack to inform HAL which RF path signal is used for TX/RX and, based on the RF front-end design, which respective GPIO pin will be controlled.
Usage of the RFCTRL1 variable:
The RFCtrl1 parameter is used to select the RF output frequency range (or band). The following values are applicable for the parameter.
ENUM Value |
Frequency Region |
TX Power |
---|---|---|
RFO_LF |
< 525 MHz |
-4 to +15 dBm |
RFO_HF |
From 779 MHz |
-4 to +15 dBm |
PA_BOOST |
All frequencies |
+2 to +17 dBm |
Usage of RFCTRL2 variable:
The RFCtrl2 parameter is used to select either a transmit or receive operation by the transceiver.
RFCtrl1 |
RFCtrl2 |
Operation |
---|---|---|
RFO_LF |
TX |
|
RFO_HF |
TX |
|
PA_BOOST |
Do not care |
|
RFO_LF |
RX |
|
RFO_HF |
RX |
|
For the SAM R34 Xplained Pro board or WLR089 Xplained Pro board:
Syntax
void HAL_EnableRFCtrl(RFCtrl1_t RFCtrl1, RFCtrl2_t RFCtrl2)
Parameters Name |
Parameter Type |
Description |
---|---|---|
RFCtrl1 |
ENUM |
RF Control 1 indicates the FREQUENCY band (Higher UHF or Lower UHF) or PA Boost
enabled.
|
RFCtrl2 |
ENUM |
RF Control 2 indicates the Transmit or Receive path.
|
Return Types and Values
<void>
API Type – Synchronous