636 lines
27 KiB
C
636 lines
27 KiB
C
// Copyright 2018 Espressif Systems (Shanghai) PTE LTD
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef __ESP_HF_CLIENT_API_H__
|
|
#define __ESP_HF_CLIENT_API_H__
|
|
|
|
#include "esp_err.h"
|
|
#include "esp_bt_defs.h"
|
|
#include "esp_hf_defs.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
#define ESP_BT_HF_CLIENT_NUMBER_LEN (32)
|
|
#define ESP_BT_HF_CLIENT_OPERATOR_NAME_LEN (16)
|
|
|
|
/// Bluetooth HFP RFCOMM connection and service level connection status
|
|
typedef enum {
|
|
ESP_HF_CLIENT_CONNECTION_STATE_DISCONNECTED = 0, /*!< RFCOMM data link channel released */
|
|
ESP_HF_CLIENT_CONNECTION_STATE_CONNECTING, /*!< connecting remote device on the RFCOMM data link*/
|
|
ESP_HF_CLIENT_CONNECTION_STATE_CONNECTED, /*!< RFCOMM connection established */
|
|
ESP_HF_CLIENT_CONNECTION_STATE_SLC_CONNECTED, /*!< service level connection established */
|
|
ESP_HF_CLIENT_CONNECTION_STATE_DISCONNECTING, /*!< disconnecting with remote device on the RFCOMM dat link*/
|
|
} esp_hf_client_connection_state_t;
|
|
|
|
/// Bluetooth HFP audio connection status
|
|
typedef enum {
|
|
ESP_HF_CLIENT_AUDIO_STATE_DISCONNECTED = 0, /*!< audio connection released */
|
|
ESP_HF_CLIENT_AUDIO_STATE_CONNECTING, /*!< audio connection has been initiated */
|
|
ESP_HF_CLIENT_AUDIO_STATE_CONNECTED, /*!< audio connection is established */
|
|
ESP_HF_CLIENT_AUDIO_STATE_CONNECTED_MSBC, /*!< mSBC audio connection is established */
|
|
} esp_hf_client_audio_state_t;
|
|
|
|
/// in-band ring tone state
|
|
typedef enum {
|
|
ESP_HF_CLIENT_IN_BAND_RINGTONE_NOT_PROVIDED = 0,
|
|
ESP_HF_CLIENT_IN_BAND_RINGTONE_PROVIDED,
|
|
} esp_hf_client_in_band_ring_state_t;
|
|
|
|
/* features masks of AG */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_3WAY 0x01 /* Three-way calling */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_ECNR 0x02 /* Echo cancellation and/or noise reduction */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_VREC 0x04 /* Voice recognition */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_INBAND 0x08 /* In-band ring tone */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_VTAG 0x10 /* Attach a phone number to a voice tag */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_REJECT 0x20 /* Ability to reject incoming call */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_ECS 0x40 /* Enhanced Call Status */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_ECC 0x80 /* Enhanced Call Control */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_EXTERR 0x100 /* Extended error codes */
|
|
#define ESP_HF_CLIENT_PEER_FEAT_CODEC 0x200 /* Codec Negotiation */
|
|
|
|
/* CHLD feature masks of AG */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_REL 0x01 /* 0 Release waiting call or held calls */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_REL_ACC 0x02 /* 1 Release active calls and accept other waiting or held call */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_REL_X 0x04 /* 1x Release specified active call only */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_HOLD_ACC 0x08 /* 2 Active calls on hold and accept other waiting or held call */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_PRIV_X 0x10 /* 2x Request private mode with specified call(put the rest on hold) */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_MERGE 0x20 /* 3 Add held call to multiparty */
|
|
#define ESP_HF_CLIENT_CHLD_FEAT_MERGE_DETACH 0x40 /* 4 Connect two calls and leave(disconnect from multiparty) */
|
|
|
|
/// HF CLIENT callback events
|
|
typedef enum {
|
|
ESP_HF_CLIENT_CONNECTION_STATE_EVT = 0, /*!< connection state changed event */
|
|
ESP_HF_CLIENT_AUDIO_STATE_EVT, /*!< audio connection state change event */
|
|
ESP_HF_CLIENT_BVRA_EVT, /*!< voice recognition state change event */
|
|
ESP_HF_CLIENT_CIND_CALL_EVT, /*!< call indication */
|
|
ESP_HF_CLIENT_CIND_CALL_SETUP_EVT, /*!< call setup indication */
|
|
ESP_HF_CLIENT_CIND_CALL_HELD_EVT, /*!< call held indication */
|
|
ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT, /*!< network service availability indication */
|
|
ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT, /*!< signal strength indication */
|
|
ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT, /*!< roaming status indication */
|
|
ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT, /*!< battery level indication */
|
|
ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT, /*!< current operator information */
|
|
ESP_HF_CLIENT_BTRH_EVT, /*!< call response and hold event */
|
|
ESP_HF_CLIENT_CLIP_EVT, /*!< Calling Line Identification notification */
|
|
ESP_HF_CLIENT_CCWA_EVT, /*!< call waiting notification */
|
|
ESP_HF_CLIENT_CLCC_EVT, /*!< list of current calls notification */
|
|
ESP_HF_CLIENT_VOLUME_CONTROL_EVT, /*!< audio volume control command from AG, provided by +VGM or +VGS message */
|
|
ESP_HF_CLIENT_AT_RESPONSE_EVT, /*!< AT command response event */
|
|
ESP_HF_CLIENT_CNUM_EVT, /*!< subscriber information response from AG */
|
|
ESP_HF_CLIENT_BSIR_EVT, /*!< setting of in-band ring tone */
|
|
ESP_HF_CLIENT_BINP_EVT, /*!< requested number of last voice tag from AG */
|
|
ESP_HF_CLIENT_RING_IND_EVT, /*!< ring indication event */
|
|
} esp_hf_client_cb_event_t;
|
|
|
|
/// HFP client callback parameters
|
|
typedef union {
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CONNECTION_STATE_EVT
|
|
*/
|
|
struct hf_client_conn_stat_param {
|
|
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 */
|
|
} conn_stat; /*!< HF callback param of ESP_HF_CLIENT_CONNECTION_STATE_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_AUDIO_STATE_EVT
|
|
*/
|
|
struct hf_client_audio_stat_param {
|
|
esp_hf_client_audio_state_t state; /*!< audio connection state */
|
|
esp_bd_addr_t remote_bda; /*!< remote bluetooth device address */
|
|
} audio_stat; /*!< HF callback param of ESP_HF_CLIENT_AUDIO_STATE_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_BVRA_EVT
|
|
*/
|
|
struct hf_client_bvra_param {
|
|
esp_hf_vr_state_t value; /*!< voice recognition state */
|
|
} bvra; /*!< HF callback param of ESP_HF_CLIENT_BVRA_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT
|
|
*/
|
|
struct hf_client_service_availability_param {
|
|
esp_hf_service_availability_status_t status; /*!< service availability status */
|
|
} service_availability; /*!< HF callback param of ESP_HF_CLIENT_CIND_SERVICE_AVAILABILITY_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT
|
|
*/
|
|
struct hf_client_network_roaming_param {
|
|
esp_hf_roaming_status_t status; /*!< roaming status */
|
|
} roaming; /*!< HF callback param of ESP_HF_CLIENT_CIND_ROAMING_STATUS_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT
|
|
*/
|
|
struct hf_client_signal_strength_ind_param {
|
|
int value; /*!< signal strength value, ranges from 0 to 5 */
|
|
} signal_strength; /*!< HF callback param of ESP_HF_CLIENT_CIND_SIGNAL_STRENGTH_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT
|
|
*/
|
|
struct hf_client_battery_level_ind_param {
|
|
int value; /*!< battery charge value, ranges from 0 to 5 */
|
|
} battery_level; /*!< HF callback param of ESP_HF_CLIENT_CIND_BATTERY_LEVEL_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT
|
|
*/
|
|
struct hf_client_current_operator_param {
|
|
const char *name; /*!< name of the network operator */
|
|
} cops; /*!< HF callback param of ESP_HF_CLIENT_COPS_CURRENT_OPERATOR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_CALL_EVT
|
|
*/
|
|
struct hf_client_call_ind_param {
|
|
esp_hf_call_status_t status; /*!< call status indicator */
|
|
} call; /*!< HF callback param of ESP_HF_CLIENT_CIND_CALL_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_CALL_SETUP_EVT
|
|
*/
|
|
struct hf_client_call_setup_ind_param {
|
|
esp_hf_call_setup_status_t status; /*!< call setup status indicator */
|
|
} call_setup; /*!< HF callback param of ESP_HF_CLIENT_BVRA_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CIND_CALL_HELD_EVT
|
|
*/
|
|
struct hf_client_call_held_ind_param {
|
|
esp_hf_call_held_status_t status; /*!< bluetooth proprietary call hold status indicator */
|
|
} call_held; /*!< HF callback param of ESP_HF_CLIENT_CIND_CALL_HELD_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_BTRH_EVT
|
|
*/
|
|
struct hf_client_btrh_param {
|
|
esp_hf_btrh_status_t status; /*!< call hold and response status result code */
|
|
} btrh; /*!< HF callback param of ESP_HF_CLIENT_BRTH_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CLIP_EVT
|
|
*/
|
|
struct hf_client_clip_param {
|
|
const char *number; /*!< phone number string of call */
|
|
} clip; /*!< HF callback param of ESP_HF_CLIENT_CLIP_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CCWA_EVT
|
|
*/
|
|
struct hf_client_ccwa_param {
|
|
const char *number; /*!< phone number string of waiting call */
|
|
} ccwa; /*!< HF callback param of ESP_HF_CLIENT_BVRA_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CLCC_EVT
|
|
*/
|
|
struct hf_client_clcc_param {
|
|
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) */
|
|
} clcc; /*!< HF callback param of ESP_HF_CLIENT_CLCC_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_VOLUME_CONTROL_EVT
|
|
*/
|
|
struct hf_client_volume_control_param {
|
|
esp_hf_volume_control_target_t type; /*!< volume control target, speaker or microphone */
|
|
int volume; /*!< gain, ranges from 0 to 15 */
|
|
} volume_control; /*!< HF callback param of ESP_HF_CLIENT_VOLUME_CONTROL_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_AT_RESPONSE_EVT
|
|
*/
|
|
struct hf_client_at_response_param {
|
|
esp_hf_at_response_code_t code; /*!< AT response code */
|
|
esp_hf_cme_err_t cme; /*!< Extended Audio Gateway Error Result Code */
|
|
} at_response; /*!< HF callback param of ESP_HF_CLIENT_AT_RESPONSE_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_CNUM_EVT
|
|
*/
|
|
struct hf_client_cnum_param {
|
|
const char *number; /*!< phone number string */
|
|
esp_hf_subscriber_service_type_t type; /*!< service type that the phone number relates to */
|
|
} cnum; /*!< HF callback param of ESP_HF_CLIENT_CNUM_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_BSIR_EVT
|
|
*/
|
|
struct hf_client_bsirparam {
|
|
esp_hf_client_in_band_ring_state_t state; /*!< setting state of in-band ring tone */
|
|
} bsir; /*!< HF callback param of ESP_HF_CLIENT_BSIR_EVT */
|
|
|
|
/**
|
|
* @brief ESP_HF_CLIENT_BINP_EVT
|
|
*/
|
|
struct hf_client_binp_param {
|
|
const char *number; /*!< phone number corresponding to the last voice tag in the HF */
|
|
} binp; /*!< HF callback param of ESP_HF_CLIENT_BINP_EVT */
|
|
|
|
} esp_hf_client_cb_param_t;
|
|
|
|
/**
|
|
* @brief HFP client incoming data callback function, the callback is useful in case of
|
|
* Voice Over HCI.
|
|
* @param[in] buf : 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[in] len : size(in bytes) in buf
|
|
*/
|
|
typedef void (* esp_hf_client_incoming_data_cb_t)(const uint8_t *buf, uint32_t len);
|
|
|
|
/**
|
|
* @brief 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[in] buf : 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[in] len : size(in bytes) in buf
|
|
* @param[out] length of data successfully read
|
|
*/
|
|
typedef uint32_t (* esp_hf_client_outgoing_data_cb_t)(uint8_t *buf, uint32_t len);
|
|
|
|
/**
|
|
* @brief HFP client callback function type
|
|
*
|
|
* @param event : Event type
|
|
*
|
|
* @param param : Pointer to callback parameter
|
|
*/
|
|
typedef void (* esp_hf_client_cb_t)(esp_hf_client_cb_event_t event, esp_hf_client_cb_param_t *param);
|
|
|
|
/**
|
|
* @brief Register application callback function to HFP client module. This function should be called
|
|
* only after esp_bluedroid_enable() completes successfully, used by HFP client
|
|
*
|
|
* @param[in] callback: HFP client event callback function
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: if callback is a NULL function pointer
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_register_callback(esp_hf_client_cb_t callback);
|
|
|
|
/**
|
|
*
|
|
* @brief Initialize the bluetooth HFP client module. This function should be called
|
|
* after esp_bluedroid_enable() completes successfully
|
|
*
|
|
* @return
|
|
* - ESP_OK: if the initialization request is sent successfully
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_init(void);
|
|
|
|
/**
|
|
*
|
|
* @brief De-initialize for HFP client module. This function
|
|
* should be called only after esp_bluedroid_enable() completes successfully
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_deinit(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Connect to remote bluetooth HFP audio gateway(AG) device, must after esp_hf_client_init()
|
|
*
|
|
* @param[in] remote_bda: remote bluetooth device address
|
|
*
|
|
* @return
|
|
* - ESP_OK: connect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Disconnect from the remote HFP audio gateway
|
|
*
|
|
* @param[in] remote_bda: remote bluetooth device address
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Create audio connection with remote HFP AG. As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @param[in] remote_bda: remote bluetooth device address
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Release the established audio connection with remote HFP AG.
|
|
*
|
|
* @param[in] remote_bda: remote bluetooth device address
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Enable voice recognition in the AG. As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_start_voice_recognition(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Disable voice recognition in the AG. As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_stop_voice_recognition(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Volume synchronization with AG. As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @param[in] type: volume control target, speaker or microphone
|
|
* @param[in] volume: gain of the speaker of microphone, ranges 0 to 15
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @param[in] number: number string of the call. If NULL, the last number is called(aka re-dial)
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_dial(const char *number);
|
|
|
|
/**
|
|
*
|
|
* @brief Place a call with number specified by location(speed dial). As a precondition,
|
|
* to use this API, Service Level Connection shall exist with AG
|
|
*
|
|
* @param[in] location: location of the number in the memory
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
|
|
esp_err_t esp_hf_client_dial_memory(int location);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @param[in] chld: AT+CHLD call hold and multiparty handling AT command.
|
|
* @param[in] idx: used in Enhanced Call Control Mechanisms, used if chld is
|
|
* ESP_HF_CHLD_TYPE_REL_X or ESP_HF_CHLD_TYPE_PRIV_X
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Send response and hold action command(Send AT+BTRH command)
|
|
* As a precondition to use this API, Service Level Connection shall exist with AG
|
|
*
|
|
* @param[in] btrh: response and hold action to send
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_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);
|
|
|
|
/**
|
|
*
|
|
* @brief Answer an incoming call(send ATA command). As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_answer_call(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Reject an incoming call(send AT+CHUP command), As a precondition to use this API,
|
|
* Service Level Connection shall exist with AG
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_reject_call(void);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_query_current_calls(void);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_query_current_operator_name(void);
|
|
|
|
/**
|
|
*
|
|
* @brief Get subscriber information number from AG(send AT+CNUM command)
|
|
* As a precondition to use this API, Service Level Connection shall exist with AG
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_retrieve_subscriber_info(void);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @param[in] code: dtmf code, single ascii character in the set 0-9, #, *, A-D
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_send_dtmf(char code);
|
|
|
|
/**
|
|
*
|
|
* @brief 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
|
|
*
|
|
* @return
|
|
* - ESP_OK: disconnect request is sent to lower layer
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: others
|
|
*
|
|
*/
|
|
esp_err_t esp_hf_client_request_last_voice_tag_number(void);
|
|
|
|
/**
|
|
* @brief Register HFP client data output function; the callback is only used in
|
|
* the case that Voice Over HCI is enabled.
|
|
*
|
|
* @param[in] recv: HFP client incoming data callback function
|
|
* @param[in] send: HFP client outgoing data callback function
|
|
*
|
|
* @return
|
|
* - ESP_OK: success
|
|
* - ESP_INVALID_STATE: if bluetooth stack is not yet enabled
|
|
* - ESP_FAIL: if callback is a NULL function pointer
|
|
*
|
|
*/
|
|
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);
|
|
|
|
/**
|
|
* @brief 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. Precondition is that
|
|
* the HFP audio connection is connected. After this function is called, lower
|
|
* layer will invoke esp_hf_client_outgoing_data_cb_t to fetch data
|
|
*
|
|
*/
|
|
void esp_hf_client_outgoing_data_ready(void);
|
|
|
|
|
|
/**
|
|
* @brief Initialize the down sampling converter. This is a utility function that can
|
|
* only be used in the case that Voice Over HCI is enabled.
|
|
*
|
|
* @param[in] src_sps: original samples per second(source audio data, i.e. 48000, 32000,
|
|
* 16000, 44100, 22050, 11025)
|
|
* @param[in] bits: number of bits per pcm sample (16)
|
|
* @param[in] channels: number of channels (i.e. mono(1), stereo(2)...)
|
|
*/
|
|
void esp_hf_client_pcm_resample_init(uint32_t src_sps, uint32_t bits, uint32_t channels);
|
|
|
|
/**
|
|
* @brief 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.
|
|
*
|
|
* @param[in] src: pointer to the buffer where the original sampling PCM are stored
|
|
* @param[in] in_bytes: length of the input PCM sample buffer in byte
|
|
* @param[in] dst: pointer to the buffer which is to be used to store the converted PCM samples
|
|
*
|
|
* @return number of samples converted
|
|
*/
|
|
int32_t esp_hf_client_pcm_resample(void *src, uint32_t in_bytes, void *dst);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* __ESP_HF_CLIENT_API_H__ */
|