HFP CLIENT API
API Reference
Header File
Functions
-
esp_err_t esp_hf_client_register_callback(esp_hf_client_cb_t callback)
Register application callback function to HFP client module. This function should be called only after esp_bluedroid_enable() completes successfully.
- 参数
callback – [in] HFP client event callback function
- 返回
ESP_OK: success
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: if callback is a NULL function pointer
-
esp_err_t esp_hf_client_init(void)
Initialize the bluetooth HFP client module. This function should be called after esp_bluedroid_enable() completes successfully.
- 返回
ESP_OK: if the initialization request is sent successfully
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_deinit(void)
De-initialize for HFP client module. This function should be called only after esp_bluedroid_enable() completes successfully.
- 返回
ESP_OK: success
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_connect(esp_bd_addr_t remote_bda)
Establish a Service Level Connection to remote bluetooth HFP audio gateway(AG) device. This function must be called after esp_hf_client_init() and before esp_hf_client_deinit().
- 参数
remote_bda – [in] remote bluetooth device address
- 返回
ESP_OK: connect request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_disconnect(esp_bd_addr_t remote_bda)
Disconnect from the remote HFP audio gateway. This function must be called after esp_hf_client_init() and before esp_hf_client_deinit().
- 参数
remote_bda – [in] remote bluetooth device address
- 返回
ESP_OK: disconnect request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_connect_audio(esp_bd_addr_t remote_bda)
Create audio connection with remote HFP AG. As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
remote_bda – [in] remote bluetooth device address
- 返回
ESP_OK: connect audio request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_disconnect_audio(esp_bd_addr_t remote_bda)
Release the established audio connection with remote HFP AG. As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
remote_bda – [in] remote bluetooth device address
- 返回
ESP_OK: disconnect audio request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_start_voice_recognition(void)
Enable voice recognition in the AG. As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: starting voice recognition is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_stop_voice_recognition(void)
Disable voice recognition in the AG. As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: stoping voice recognition is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_volume_update(esp_hf_volume_control_target_t type, int volume)
Volume synchronization with AG. As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
type – [in] volume control target, speaker or microphone
volume – [in] gain of the speaker of microphone, ranges 0 to 15
- 返回
ESP_OK: volume update is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_dial(const char *number)
Place a call with a specified number, if number is NULL, last called number is called. As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
number – [in] number string of the call. If NULL, the last number is called(aka re-dial)
- 返回
ESP_OK: a call placing is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_dial_memory(int location)
Place a call with number specified by location(speed dial). As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
location – [in] location of the number in the memory
- 返回
ESP_OK: a memory call placing is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_chld_cmd(esp_hf_chld_type_t chld, int idx)
Send call hold and multiparty commands, or enhanced call control commands(Use AT+CHLD). As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
chld – [in] AT+CHLD call hold and multiparty handling AT command.
idx – [in] used in Enhanced Call Control Mechanisms, used if chld is ESP_HF_CHLD_TYPE_REL_X or ESP_HF_CHLD_TYPE_PRIV_X
- 返回
ESP_OK: command AT+CHLD is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_btrh_cmd(esp_hf_btrh_cmd_t btrh)
Send response and hold action command(Send AT+BTRH command) As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
btrh – [in] response and hold action to send
- 返回
ESP_OK: command AT+BTRH is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_answer_call(void)
Answer an incoming call(send ATA command). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: a call answering is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_reject_call(void)
Reject an incoming call or terminate an ongoing call(send AT+CHUP command). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: the call rejecting is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_query_current_calls(void)
Query list of current calls in AG(send AT+CLCC command). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: query of current calls is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_query_current_operator_name(void)
Query the name of currently selected network operator in AG(use AT+COPS commands). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: query of current operator name is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_retrieve_subscriber_info(void)
Get subscriber information number from AG(send AT+CNUM command) As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: the retrieving of subscriber information is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_dtmf(char code)
Transmit DTMF codes during an ongoing call(use AT+VTS commands) As a precondition to use this API, Service Level Connection shall exist with AG.
- 参数
code – [in] dtmf code, single ascii character in the set 0-9, #, *, A-D
- 返回
ESP_OK: the DTMF codes are sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_xapl(char *information, uint32_t features)
Send command to enable Vendor specific feature to indicate battery level and docker status This is Apple-specific commands, but used by most device, including Android and Windows.
- 参数
information – [in] XAPL vendorID-productID-version, such as “0505-1995-0610” vendorID: A string representation of the hex value of the vendor ID from the manufacturer, without the 0x prefix. productID: A string representation of the hex value of the product ID from the manufacturer, without the 0x prefix. version: The revision of the software
features – [in] A base-10 representation of a bit field. such as ESP_HF_CLIENT_XAPL_FEAT_BATTERY_REPORT
- 返回
ESP_OK: Feature enable request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_iphoneaccev(uint32_t bat_level, bool docked)
Send Battery level and docker status Enable this feature using XAPL command first This is Apple-specific commands, but used by most device, including Android and Windows.
- 参数
bat_level – [in] Battery Level: value between 0 and 9
docked – [in] Dock State: false = undocked, true = docked
- 返回
ESP_OK: battery level is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_request_last_voice_tag_number(void)
Request a phone number from AG corresponding to last voice tag recorded (send AT+BINP command). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: the phone number request corresponding to last voice tag recorded is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_send_nrec(void)
Disable echo cancellation and noise reduction in the AG (use AT+NREC=0 command). As a precondition to use this API, Service Level Connection shall exist with AG.
- 返回
ESP_OK: NREC=0 request is sent to lower layer
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
esp_err_t esp_hf_client_register_data_callback(esp_hf_client_incoming_data_cb_t recv, esp_hf_client_outgoing_data_cb_t send)
Register HFP client data output function; the callback is only used in the case that Voice Over HCI is enabled.
- 参数
recv – [in] HFP client incoming data callback function
send – [in] HFP client outgoing data callback function
- 返回
ESP_OK: success
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: if callback is a NULL function pointer
-
esp_err_t esp_hf_client_pkt_stat_nums_get(uint16_t sync_conn_handle)
Get the number of packets received and sent This function is only used in the case that Voice Over HCI is enabled and the audio state is connected. When the operation is completed, the callback function will be called with ESP_HF_CLIENT_PKT_STAT_NUMS_GET_EVT.
- 参数
sync_conn_handle – [in] the (e)SCO connection handle
- 返回
ESP_OK: if the request is sent successfully
ESP_ERR_INVALID_STATE: if bluetooth stack is not yet enabled
ESP_FAIL: others
-
void esp_hf_client_outgoing_data_ready(void)
Trigger the lower-layer to fetch and send audio data. This function is only only used in the case that Voice Over HCI is enabled. After this function is called, lower layer will invoke esp_hf_client_outgoing_data_cb_t to fetch data.
As a precondition to use this API, Service Level Connection shall exist with AG.
-
void esp_hf_client_pcm_resample_init(uint32_t src_sps, uint32_t bits, uint32_t channels)
Initialize the down sampling converter. This is a utility function that can only be used in the case that Voice Over HCI is enabled.
- 参数
src_sps – [in] original samples per second(source audio data, i.e. 48000, 32000, 16000, 44100, 22050, 11025)
bits – [in] number of bits per pcm sample (16)
channels – [in] number of channels (i.e. mono(1), stereo(2)…)
-
void esp_hf_client_pcm_resample_deinit(void)
Deinitialize the down sampling converter.
-
int32_t esp_hf_client_pcm_resample(void *src, uint32_t in_bytes, void *dst)
Down sampling utility to convert high sampling rate into 8K/16bits 1-channel mode PCM samples. This can only be used in the case that Voice Over HCI is enabled.
- 参数
src – [in] pointer to the buffer where the original sampling PCM are stored
in_bytes – [in] length of the input PCM sample buffer in byte
dst – [in] pointer to the buffer which is to be used to store the converted PCM samples
- 返回
number of samples converted
Unions
-
union esp_hf_client_cb_param_t
- #include <esp_hf_client_api.h>
HFP client callback parameters.
Public Members
-
struct esp_hf_client_cb_param_t::hf_client_conn_stat_param conn_stat
HF callback param of ESP_HF_CLIENT_CONNECTION_STATE_EVT
-
struct esp_hf_client_cb_param_t::hf_client_audio_stat_param audio_stat
HF callback param of ESP_HF_CLIENT_AUDIO_STATE_EVT
-
struct esp_hf_client_cb_param_t::hf_client_bvra_param bvra
HF callback param of ESP_HF_CLIENT_BVRA_EVT
-
struct esp_hf_client_cb_param_t::hf_client_service_availability_param service_availability
HF callback param of ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT
-
struct esp_hf_client_cb_param_t::hf_client_network_roaming_param roaming
HF callback param of ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT
-
struct esp_hf_client_cb_param_t::hf_client_signal_strength_ind_param signal_strength
HF callback param of ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT
-
struct esp_hf_client_cb_param_t::hf_client_battery_level_ind_param battery_level
HF callback param of ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT
-
struct esp_hf_client_cb_param_t::hf_client_current_operator_param cops
HF callback param of ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT
-
struct esp_hf_client_cb_param_t::hf_client_call_ind_param call
HF callback param of ESP_HF_CLIENT_CIND_CALL_EVT
-
struct esp_hf_client_cb_param_t::hf_client_call_setup_ind_param call_setup
HF callback param of ESP_HF_CLIENT_BVRA_EVT
-
struct esp_hf_client_cb_param_t::hf_client_call_held_ind_param call_held
HF callback param of ESP_HF_CLIENT_CIND_CALL_HELD_EVT
-
struct esp_hf_client_cb_param_t::hf_client_btrh_param btrh
HF callback param of ESP_HF_CLIENT_BRTH_EVT
-
struct esp_hf_client_cb_param_t::hf_client_clip_param clip
HF callback param of ESP_HF_CLIENT_CLIP_EVT
-
struct esp_hf_client_cb_param_t::hf_client_ccwa_param ccwa
HF callback param of ESP_HF_CLIENT_BVRA_EVT
-
struct esp_hf_client_cb_param_t::hf_client_clcc_param clcc
HF callback param of ESP_HF_CLIENT_CLCC_EVT
-
struct esp_hf_client_cb_param_t::hf_client_volume_control_param volume_control
HF callback param of ESP_HF_CLIENT_VOLUME_CONTROL_EVT
-
struct esp_hf_client_cb_param_t::hf_client_at_response_param at_response
HF callback param of ESP_HF_CLIENT_AT_RESPONSE_EVT
-
struct esp_hf_client_cb_param_t::hf_client_cnum_param cnum
HF callback param of ESP_HF_CLIENT_CNUM_EVT
-
struct esp_hf_client_cb_param_t::hf_client_bsirparam bsir
HF callback param of ESP_HF_CLIENT_BSIR_EVT
-
struct esp_hf_client_cb_param_t::hf_client_binp_param binp
HF callback param of ESP_HF_CLIENT_BINP_EVT
-
struct esp_hf_client_cb_param_t::hf_client_pkt_status_nums pkt_nums
HF callback param of ESP_HF_CLIENT_PKT_STAT_NUMS_GET_EVT
-
struct hf_client_at_response_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_AT_RESPONSE_EVT.
Public Members
-
esp_hf_at_response_code_t code
AT response code
-
esp_hf_cme_err_t cme
Extended Audio Gateway Error Result Code
-
esp_hf_at_response_code_t code
-
struct hf_client_audio_stat_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_AUDIO_STATE_EVT.
Public Members
-
esp_hf_client_audio_state_t state
audio connection state
-
esp_bd_addr_t remote_bda
remote bluetooth device address
-
uint16_t sync_conn_handle
(e)SCO connection handle
-
esp_hf_client_audio_state_t state
-
struct hf_client_battery_level_ind_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT.
Public Members
-
int value
battery charge value, ranges from 0 to 5
-
int value
-
struct hf_client_binp_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_BINP_EVT.
Public Members
-
const char *number
phone number corresponding to the last voice tag in the HF
-
const char *number
-
struct hf_client_bsirparam
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_BSIR_EVT.
Public Members
-
esp_hf_client_in_band_ring_state_t state
setting state of in-band ring tone
-
esp_hf_client_in_band_ring_state_t state
-
struct hf_client_btrh_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_BTRH_EVT.
Public Members
-
esp_hf_btrh_status_t status
call hold and response status result code
-
esp_hf_btrh_status_t status
-
struct hf_client_bvra_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_BVRA_EVT.
Public Members
-
esp_hf_vr_state_t value
voice recognition state
-
esp_hf_vr_state_t value
-
struct hf_client_call_held_ind_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_CALL_HELD_EVT.
Public Members
-
esp_hf_call_held_status_t status
bluetooth proprietary call hold status indicator
-
esp_hf_call_held_status_t status
-
struct hf_client_call_ind_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_CALL_EVT.
Public Members
-
esp_hf_call_status_t status
call status indicator
-
esp_hf_call_status_t status
-
struct hf_client_call_setup_ind_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_CALL_SETUP_EVT.
Public Members
-
esp_hf_call_setup_status_t status
call setup status indicator
-
esp_hf_call_setup_status_t status
-
struct hf_client_ccwa_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CCWA_EVT.
Public Members
-
const char *number
phone number string of waiting call
-
const char *number
-
struct hf_client_clcc_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CLCC_EVT.
Public Members
-
int idx
numbering(starting with 1) of the call
-
esp_hf_current_call_direction_t dir
direction of the call
-
esp_hf_current_call_status_t status
status of the call
-
esp_hf_current_call_mpty_type_t mpty
multi-party flag
-
char *number
phone number(optional)
-
int idx
-
struct hf_client_clip_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CLIP_EVT.
Public Members
-
const char *number
phone number string of call
-
const char *number
-
struct hf_client_cnum_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CNUM_EVT.
Public Members
-
const char *number
phone number string
-
esp_hf_subscriber_service_type_t type
service type that the phone number relates to
-
const char *number
-
struct hf_client_conn_stat_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CONNECTION_STATE_EVT.
Public Members
-
esp_hf_client_connection_state_t state
HF connection state
-
uint32_t peer_feat
AG supported features
-
uint32_t chld_feat
AG supported features on call hold and multiparty services
-
esp_bd_addr_t remote_bda
remote bluetooth device address
-
esp_hf_client_connection_state_t state
-
struct hf_client_current_operator_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT.
Public Members
-
const char *name
name of the network operator
-
const char *name
-
struct hf_client_network_roaming_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT.
Public Members
-
esp_hf_roaming_status_t status
roaming status
-
esp_hf_roaming_status_t status
-
struct hf_client_pkt_status_nums
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_PKT_STAT_NUMS_GET_EVT.
Public Members
-
uint32_t rx_total
the total number of packets received
-
uint32_t rx_correct
the total number of packets data correctly received
-
uint32_t rx_err
the total number of packets data with possible invalid
-
uint32_t rx_none
the total number of packets data no received
-
uint32_t rx_lost
the total number of packets data partially lost
-
uint32_t tx_total
the total number of packets send
-
uint32_t tx_discarded
the total number of packets send lost
-
uint32_t rx_total
-
struct hf_client_service_availability_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT.
Public Members
-
esp_hf_network_state_t status
service availability status
-
esp_hf_network_state_t status
-
struct hf_client_signal_strength_ind_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT.
Public Members
-
int value
signal strength value, ranges from 0 to 5
-
int value
-
struct hf_client_volume_control_param
- #include <esp_hf_client_api.h>
ESP_HF_CLIENT_VOLUME_CONTROL_EVT.
Public Members
-
esp_hf_volume_control_target_t type
volume control target, speaker or microphone
-
int volume
gain, ranges from 0 to 15
-
esp_hf_volume_control_target_t type
-
struct esp_hf_client_cb_param_t::hf_client_conn_stat_param conn_stat
Macros
-
ESP_BT_HF_CLIENT_NUMBER_LEN
-
ESP_BT_HF_CLIENT_OPERATOR_NAME_LEN
-
ESP_BT_HF_AT_SEND_XAPL_LEN
-
ESP_HF_CLIENT_PEER_FEAT_3WAY
-
ESP_HF_CLIENT_PEER_FEAT_ECNR
-
ESP_HF_CLIENT_PEER_FEAT_VREC
-
ESP_HF_CLIENT_PEER_FEAT_INBAND
-
ESP_HF_CLIENT_PEER_FEAT_VTAG
-
ESP_HF_CLIENT_PEER_FEAT_REJECT
-
ESP_HF_CLIENT_PEER_FEAT_ECS
-
ESP_HF_CLIENT_PEER_FEAT_ECC
-
ESP_HF_CLIENT_PEER_FEAT_EXTERR
-
ESP_HF_CLIENT_PEER_FEAT_CODEC
-
ESP_HF_CLIENT_PEER_FEAT_HF_IND
-
ESP_HF_CLIENT_PEER_FEAT_ESCO_S4
-
ESP_HF_CLIENT_CHLD_FEAT_REL
-
ESP_HF_CLIENT_CHLD_FEAT_REL_ACC
-
ESP_HF_CLIENT_CHLD_FEAT_REL_X
-
ESP_HF_CLIENT_CHLD_FEAT_HOLD_ACC
-
ESP_HF_CLIENT_CHLD_FEAT_PRIV_X
-
ESP_HF_CLIENT_CHLD_FEAT_MERGE
-
ESP_HF_CLIENT_CHLD_FEAT_MERGE_DETACH
-
ESP_HF_CLIENT_XAPL_FEAT_RESERVED
-
ESP_HF_CLIENT_XAPL_FEAT_BATTERY_REPORT
-
ESP_HF_CLIENT_XAPL_FEAT_DOCKED
-
ESP_HF_CLIENT_XAPL_FEAT_SIRI_STATUS_REPORT
-
ESP_HF_CLIENT_XAPL_NR_STATUS_REPORT
Type Definitions
-
typedef void (*esp_hf_client_incoming_data_cb_t)(const uint8_t *buf, uint32_t len)
HFP client incoming data callback function, the callback is useful in case of Voice Over HCI.
- Param buf
[in] : pointer to incoming data(payload of HCI synchronous data packet), the buffer is allocated inside bluetooth protocol stack and will be released after invoke of the callback is finished.
- Param len
[in] : size(in bytes) in buf
-
typedef uint32_t (*esp_hf_client_outgoing_data_cb_t)(uint8_t *buf, uint32_t len)
HFP client outgoing data callback function, the callback is useful in case of Voice Over HCI. Once audio connection is set up and the application layer has prepared data to send, the lower layer will call this function to read data and then send. This callback is supposed to be implemented as non-blocking, and if data is not enough, return value 0 is supposed.
- Param buf
[in] : pointer to incoming data(payload of HCI synchronous data packet), the buffer is allocated inside bluetooth protocol stack and will be released after invoke of the callback is finished.
- Param len
[in] : size(in bytes) in buf
- Return
length of data successfully read
-
typedef void (*esp_hf_client_cb_t)(esp_hf_client_cb_event_t event, esp_hf_client_cb_param_t *param)
HFP client callback function type.
- Param event
: Event type
- Param param
: Pointer to callback parameter
Enumerations
-
enum esp_hf_client_connection_state_t
Bluetooth HFP RFCOMM connection and service level connection status.
Values:
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_DISCONNECTED
RFCOMM data link channel released
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_CONNECTING
connecting remote device on the RFCOMM data link
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_CONNECTED
RFCOMM connection established
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_SLC_CONNECTED
service level connection established
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_DISCONNECTING
disconnecting with remote device on the RFCOMM dat link
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_DISCONNECTED
-
enum esp_hf_client_audio_state_t
Bluetooth HFP audio connection status.
Values:
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_DISCONNECTED
audio connection released
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_CONNECTING
audio connection has been initiated
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_CONNECTED
audio connection is established
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_CONNECTED_MSBC
mSBC audio connection is established
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_DISCONNECTED
-
enum esp_hf_client_in_band_ring_state_t
in-band ring tone state
Values:
-
enumerator ESP_HF_CLIENT_IN_BAND_RINGTONE_NOT_PROVIDED
-
enumerator ESP_HF_CLIENT_IN_BAND_RINGTONE_PROVIDED
-
enumerator ESP_HF_CLIENT_IN_BAND_RINGTONE_NOT_PROVIDED
-
enum esp_hf_client_cb_event_t
HF CLIENT callback events.
Values:
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_EVT
connection state changed event
-
enumerator ESP_HF_CLIENT_AUDIO_STATE_EVT
audio connection state change event
-
enumerator ESP_HF_CLIENT_BVRA_EVT
voice recognition state change event
-
enumerator ESP_HF_CLIENT_CIND_CALL_EVT
call indication
-
enumerator ESP_HF_CLIENT_CIND_CALL_SETUP_EVT
call setup indication
-
enumerator ESP_HF_CLIENT_CIND_CALL_HELD_EVT
call held indication
-
enumerator ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT
network service availability indication
-
enumerator ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT
signal strength indication
-
enumerator ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT
roaming status indication
-
enumerator ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT
battery level indication
-
enumerator ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT
current operator information
-
enumerator ESP_HF_CLIENT_BTRH_EVT
call response and hold event
-
enumerator ESP_HF_CLIENT_CLIP_EVT
Calling Line Identification notification
-
enumerator ESP_HF_CLIENT_CCWA_EVT
call waiting notification
-
enumerator ESP_HF_CLIENT_CLCC_EVT
list of current calls notification
-
enumerator ESP_HF_CLIENT_VOLUME_CONTROL_EVT
audio volume control command from AG, provided by +VGM or +VGS message
-
enumerator ESP_HF_CLIENT_AT_RESPONSE_EVT
AT command response event
-
enumerator ESP_HF_CLIENT_CNUM_EVT
subscriber information response from AG
-
enumerator ESP_HF_CLIENT_BSIR_EVT
setting of in-band ring tone
-
enumerator ESP_HF_CLIENT_BINP_EVT
requested number of last voice tag from AG
-
enumerator ESP_HF_CLIENT_RING_IND_EVT
ring indication event
-
enumerator ESP_HF_CLIENT_PKT_STAT_NUMS_GET_EVT
requested number of packet different status
-
enumerator ESP_HF_CLIENT_CONNECTION_STATE_EVT