Phy¶

group btm_ble_phy_functions

This section provides functionality to read and update PHY.

Functions

wiced_bt_dev_status_t wiced_bt_ble_read_phy(wiced_bt_device_address_t remote_bd_addr, wiced_bt_ble_read_phy_complete_callback_t *p_read_phy_complete_callback)

Host to read the current transmitter PHY and receiver PHY on the connection identified by the remote bdaddr.

phy results notified using wiced_bt_ble_read_phy_complete_callback_t callback

Parameters

remote_bd_addr – [in] - remote device address
p_read_phy_complete_callback – [in] - read phy complete callback

Returns

wiced_result_t WICED_BT_SUCCESS : if the request was successfully sent to HCI. WICED_BT_UNKNOWN_ADDR : if device address does not correspond to a connected remote device WICED_BT_ILLEGAL_VALUE : if p_read_phy_complete_callback is NULL WICED_BT_NO_RESOURCES : if could not allocate resources to start the command

wiced_bt_dev_status_t wiced_bt_ble_set_default_phy(wiced_bt_ble_phy_preferences_t *phy_preferences)

Host to configure default transmitter phy and receiver phy to be used for all subsequent connections over the LE transport.

Note : remote_bd_addr field of the phy_preferences is ignored.

WICED_BT_SUCCESS : if the request was successfully sent to HCI. WICED_BT_ILLEGAL_VALUE : if phy_preferences is NULL WICED_BT_NO_RESOURCES : if could not allocate resources to start the command

Parameters: phy_preferences – [in] - Phy preferences
Returns: wiced_result_t

wiced_result_t wiced_bt_ble_set_phy(wiced_bt_ble_phy_preferences_t *phy_preferences)

Host to configure the LE link to 1M or 2M and LE coding to be used.

Parameters: phy_preferences – [in] - Phy preferences
Returns: wiced_result_t WICED_BT_SUCCESS : if the request was successfully sent to HCI. WICED_BT_ILLEGAL_VALUE : if phy_preferences is NULL WICED_BT_UNKNOWN_ADDR : if device address does not correspond to a connected remote device WICED_BT_NO_RESOURCES : if could not allocate resources to start the command

wiced_result_t wiced_bt_ble_set_channel_classification(const wiced_bt_ble_chnl_map_t ble_channel_map)

Set channel classification for the available 40 channels.

Channel n is bad = 0. Channel n is unknown = 1.

At least one channel shall be marked as unknown.

Parameters: ble_channel_map – [in]
Returns: wiced_result_t WICED_BT_SUCCESS if successfully initiated WICED_BT_NO_RESOURCES if could not allocate resources to start the command