1.1.2.1.1.4.62 BLE_GAP_SetPhy

C

uint16_t BLE_GAP_SetPhy(uint16_t connHandle, uint8_t txPhys, uint8_t rxPhys, uint8_t phyOptions);

Set the PHY preferences for the specified connection.

The Controller might not be able to make the change. Event will generate if one of the phy changes.

BLE_GAP_EVT_PHY_UPDATE Generated when phy updated.


Parameter	Description
[in] connHandle	Connection handle associated with this connection.
[in] txPhys	TX PHYs. A bit field that indicates the transmitter PHYs that the user prefers to use. See PHY option for transmit and receive.
[in] rxPhys	RX PHYs. A bit field that indicates the receiver PHYs that the user prefers to use. See PHY option for transmit and receive.
[in] phyOptions	PHY options. See Preferred PHY preference.


Return value	Description
MBA_RES_SUCCESS	Successfully set the PHY preferences for the specified connection.
MBA_RES_OOM	Internal memory allocation failure.
MBA_RES_INVALID_PARA	Invalid parameters.
MBA_RES_UNKNOWN_CONN_ID	Unknown connection identifier.
MBA_RES_COMMAND_DISALLOWED	Command disallowed.