Fast Antenna Diversity (FAD) Software Support:
The 802.15.4 PHY provides the following API to configure the FAD feature:
- PhyPlmeSetFADStateRequest
- PhyPlmeSetFADThresholdRequest
- PhyPlmeSetANTXStateRequest
- PhyPlmeGetANTXStateRequest
To use the FAD feature, one must use the PhyPlmeSetFADThresholdRequest() to set the correlator threshold at which the antenna will be selected, and call PhyPlmeSetFADStateRequest() to enable the FAD functionality.
When FAD is enabled, the PhyPlmeSetANTXStateRequest() function can be used to set the starting antenna. If FAD is disabled, this function will actually set he active antenna!
To retrieve the antenna selected by the hardware one must call PhyPlmeGetANTXStateRequest().
For more information please consult the 802.15.4 MAC_PHY Software Reference Manual documentation included in the BeeKit Wireless Connectivity Toolkit.