bt_hfp.h

/* Copyright Statement:
 *
 * (C) 2005-2016 MediaTek Inc. All rights reserved.
 *
 * This software/firmware and related documentation ("MediaTek Software") are
 * protected under relevant copyright laws. The information contained herein
 * is confidential and proprietary to MediaTek Inc. ("MediaTek") and/or its licensors.
 * Without the prior written permission of MediaTek and/or its licensors,
 * any reproduction, modification, use or disclosure of MediaTek Software,
 * and information contained herein, in whole or in part, shall be strictly prohibited.
 * You may only use, reproduce, modify, or distribute (as applicable) MediaTek Software
 * if you have agreed to and been bound by the applicable license agreement with
 * MediaTek ("License Agreement") and been granted explicit permission to do so within
 * the License Agreement ("Permitted User"). If you are not a Permitted User,
 * please cease any access or use of MediaTek Software immediately.
 * BY OPENING THIS FILE, RECEIVER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES
 * THAT MEDIATEK SOFTWARE RECEIVED FROM MEDIATEK AND/OR ITS REPRESENTATIVES
 * ARE PROVIDED TO RECEIVER ON AN "AS-IS" BASIS ONLY. MEDIATEK EXPRESSLY DISCLAIMS ANY AND ALL
 * WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT.
 * NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT TO THE
 * SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR
 * SUPPLIED WITH MEDIATEK SOFTWARE, AND RECEIVER AGREES TO LOOK ONLY TO SUCH
 * THIRD PARTY FOR ANY WARRANTY CLAIM RELATING THERETO. RECEIVER EXPRESSLY ACKNOWLEDGES
 * THAT IT IS RECEIVER'S SOLE RESPONSIBILITY TO OBTAIN FROM ANY THIRD PARTY ALL PROPER LICENSES
 * CONTAINED IN MEDIATEK SOFTWARE. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE FOR ANY MEDIATEK
 * SOFTWARE RELEASES MADE TO RECEIVER'S SPECIFICATION OR TO CONFORM TO A PARTICULAR
 * STANDARD OR OPEN FORUM. RECEIVER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND
 * CUMULATIVE LIABILITY WITH RESPECT TO MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE,
 * AT MEDIATEK'S OPTION, TO REVISE OR REPLACE MEDIATEK SOFTWARE AT ISSUE,
 * OR REFUND ANY SOFTWARE LICENSE FEES OR SERVICE CHARGE PAID BY RECEIVER TO
 * MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
 */

#ifndef __BT_HFP_H__
#define __BT_HFP_H__

#include <stdint.h>
#include "bt_type.h"

BT_EXTERN_C_BEGIN

#define BT_HFP_INVALID_HANDLE                  0                                    
#define BT_HFP_PHONE_NUMBER_MAX_LEN            64                                   
#define BT_HFP_SLC_CONNECTING_IND           (BT_MODULE_HFP | 0x002)                 
#define BT_HFP_SLC_CONNECTED_IND            (BT_MODULE_HFP | 0x003)                 
#define BT_HFP_CONNECT_REQUEST_IND          (BT_MODULE_HFP | 0x004)                 
#define BT_HFP_DISCONNECT_IND               (BT_MODULE_HFP | 0x005)                 
#define BT_HFP_AUDIO_CONNECT_IND            (BT_MODULE_HFP | 0x006)                 
#define BT_HFP_AUDIO_DISCONNECT_IND         (BT_MODULE_HFP | 0x007)                 
#define BT_HFP_BRSF_FEATURES_IND            (BT_MODULE_HFP | 0x008)                 
#define BT_HFP_CALL_HOLD_FEATURES_IND       (BT_MODULE_HFP | 0x009)                 
#define BT_HFP_CIEV_CALL_SETUP_IND          (BT_MODULE_HFP | 0x00a)                 
#define BT_HFP_CIEV_CALL_IND                (BT_MODULE_HFP | 0x00b)                 
#define BT_HFP_CIEV_CALL_HOLD_IND           (BT_MODULE_HFP | 0x00c)                 
#define BT_HFP_CIEV_SERVICE_IND             (BT_MODULE_HFP | 0x00d)                 
#define BT_HFP_CIEV_SIGNAL_IND              (BT_MODULE_HFP | 0x00e)                 
#define BT_HFP_CIEV_ROAMING_IND             (BT_MODULE_HFP | 0x00f)                 
#define BT_HFP_CIEV_BATTCHG_IND             (BT_MODULE_HFP | 0x010)                 
#define BT_HFP_RING_IND                     (BT_MODULE_HFP | 0x011)                 
#define BT_HFP_CALL_WAITING_IND             (BT_MODULE_HFP | 0x012)                 
#define BT_HFP_CALLER_ID_IND                (BT_MODULE_HFP | 0x013)                 
#define BT_HFP_CURRENT_CALLS_IND            (BT_MODULE_HFP | 0x014)                 
#define BT_HFP_VOICE_RECOGNITION_IND        (BT_MODULE_HFP | 0x015)                 
#define BT_HFP_VOLUME_SYNC_SPEAKER_GAIN_IND (BT_MODULE_HFP | 0x016)                 
#define BT_HFP_VOLUME_SYNC_MIC_GAIN_IND     (BT_MODULE_HFP | 0x017)                 
#define BT_HFP_IN_BAND_RING_IND             (BT_MODULE_HFP | 0x018)                 
#define BT_HFP_ACTION_CMD_CNF               (BT_MODULE_HFP | 0x019)                 
#define BT_HFP_AUDIO_STATUS_CHANGE_IND      (BT_MODULE_HFP | 0x01a)                 
typedef uint8_t bt_hfp_phone_num_format_t;
#define BT_HFP_PHONE_NUM_FORMAT_TYPE_UNKNOWN          0x80  
#define BT_HFP_PHONE_NUM_FORMAT_TYPE_INTERNATIONAL    0x90  
#define BT_HFP_PHONE_NUM_FORMAT_TYPE_NATIONAL         0xA0  
#define BT_HFP_PHONE_NUM_FORMAT_TYPE_NETWORK_SPEC     0xB0  
#define BT_HFP_PHONE_NUM_FORMAT_TYPE_DEDICATED_ACC    0xC0  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_UNKNOWN          0x00  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_ISDN_TELEPHONY   0x01  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_DATA_NUMBERING   0x03  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_TELEX_NUMBERING  0x04  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_NATIONAL         0x08  
#define BT_HFP_PHONE_NUM_FORMAT_PLAN_PRIVATE          0x09  
typedef uint8_t bt_hfp_audio_direction_t;
#define BT_HFP_AUDIO_TO_HF      0x00       
#define BT_HFP_AUDIO_TO_AG      0x01       
typedef uint8_t bt_hfp_audio_status_t;
#define BT_HFP_AUDIO_STATUS_INACTIVE    0x00    
#define BT_HFP_AUDIO_STATUS_ACTIVE      0x01    
typedef uint16_t bt_hfp_init_support_feature_t;
#define BT_HFP_INIT_SUPPORT_3_WAY       0x0010  
#define BT_HFP_INIT_SUPPORT_CODEC_NEG   0x0020  
#define BT_HFP_INIT_SUPPORT_ALL         0x0030  
typedef uint8_t bt_hfp_indicator_status_t;
#define BT_HFP_INDICATOR_OFF     0x00            
#define BT_HFP_INDICATOR_ON      0x01            
#define BT_HFP_INDICATOR_IGNORE  0x02            
typedef uint8_t bt_hfp_audio_codec_type_t;
#define BT_HFP_CODEC_TYPE_NONE  0x00               
#define BT_HFP_CODEC_TYPE_CVSD  0x01               
#define BT_HFP_CODEC_TYPE_MSBC  0X02               
typedef uint8_t bt_hfp_version_t;
#define BT_HFP_VERSION_V15      0x01                      
#define BT_HFP_VERSION_V16      0x02                      
typedef uint16_t bt_hfp_ag_feature_t;
#define BT_HFP_AG_FEATURE_3_WAY                 0x0001        
#define BT_HFP_AG_FEATURE_ECHO_NOISE            0x0002        
#define BT_HFP_AG_FEATURE_VOICE_RECOGNITION     0x0004        
#define BT_HFP_AG_FEATURE_IN_BAND_RING          0x0008        
#define BT_HFP_AG_FEATURE_VOICE_TAG             0x0010        
#define BT_HFP_AG_FEATURE_CALL_REJECT           0x0020        
#define BT_HFP_AG_FEATURE_ENHANCED_CALL_STATUS  0x0040        
#define BT_HFP_AG_FEATURE_ENHANCED_CALL_CTRL    0x0080        
#define BT_HFP_AG_FEATURE_EXTENDED_ERROR        0x0100        
#define BT_HFP_AG_FEATURE_CODEC_NEGOTIATION     0x0200        
typedef uint8_t bt_hfp_ag_hold_feature_t;
#define BT_HFP_AG_HOLD_FEATURE_RELEASE_HELD_CALL        0x01          
#define BT_HFP_AG_HOLD_FEATURE_RELEASE_ACTIVE_CALL      0x02          
#define BT_HFP_AG_HOLD_FEATURE_RELEASE_SPECIFIC_CALL    0x04          
#define BT_HFP_AG_HOLD_FEATURE_HOLD_ACTIVE_CALL         0x08          
#define BT_HFP_AG_HOLD_FEATURE_HOLD_SPECIFIC_CALL       0x10          
#define BT_HFP_AG_HOLD_FEATURE_ADD_HELD_CALL            0x20          
#define BT_HFP_AG_HOLD_FEATURE_CALL_TRANSFER            0x40          
typedef uint8_t bt_hfp_ciev_call_state_t;
#define BT_HFP_CIEV_CALL_STATE_NONE                  0x00          
#define BT_HFP_CIEV_CALL_STATE_CALL                  0x01          
typedef uint8_t bt_hfp_ciev_call_setup_state_t;
#define BT_HFP_CIEV_CALL_SETUP_STATE_NONE            0x00          
#define BT_HFP_CIEV_CALL_SETUP_STATE_INCOMING        0x01          
#define BT_HFP_CIEV_CALL_SETUP_STATE_OUTGOING        0x02          
#define BT_HFP_CIEV_CALL_SETUP_STATE_REMOTE_ALERT    0x03          
typedef uint8_t bt_hfp_ciev_call_hold_state_t;
#define BT_HFP_CIEV_CALL_HOLD_STATE_NONE             0x00          
#define BT_HFP_CIEV_CALL_HOLD_STATE_SOME             0x01          
#define BT_HFP_CIEV_CALL_HOLD_STATE_ALL              0x02          
typedef uint8_t bt_hfp_call_status_t;
#define BT_HFP_CALL_STATUS_ACTIVE       0x00          
#define BT_HFP_CALL_STATUS_HOLD         0x01          
#define BT_HFP_CALL_STATUS_DIALING      0x02          
#define BT_HFP_CALL_STATUS_ALERTING     0x03          
#define BT_HFP_CALL_STATUS_INCOMING     0x04          
#define BT_HFP_CALL_STATUS_WAITING      0x05          
#define BT_HFP_CALL_STATUS_NONE         0x06          
#define BT_HFP_CALL_STATUS_UNKNOWN      0x07          
typedef uint8_t bt_hfp_call_mode_t;
#define BT_HFP_CALL_MODE_VOICE      0x00             
#define BT_HFP_CALL_MODE_DATA       0x01             
#define BT_HFP_CALL_MODE_FAX        0x02             
typedef struct {
    bt_hfp_indicator_status_t service;               
    bt_hfp_indicator_status_t signal;                
    bt_hfp_indicator_status_t roaming;               
    bt_hfp_indicator_status_t battery;               
} bt_hfp_indicator_t;



typedef struct {
    bt_hfp_init_support_feature_t support_features;        
    bt_hfp_audio_codec_type_t supported_codecs;            
    bt_hfp_indicator_t indicators;                         
    bool disable_nrec;                                     
    bool enable_call_waiting;                              
    bool enable_cli;                                       
} bt_hfp_init_param_t;


typedef struct {
    uint32_t              handle;                 
} bt_hfp_ring_ind_t;


typedef struct {
    uint32_t              handle;                 
    bt_bd_addr_t          *address;               
} bt_hfp_connect_request_ind_t;


typedef struct {
    uint32_t              handle;                 
} bt_hfp_slc_connecting_ind_t;


typedef struct {
    uint32_t                handle;                    
    bt_hfp_version_t        hfp_version;               
} bt_hfp_slc_connected_ind_t;


typedef struct {
    uint32_t              handle;                      
} bt_hfp_disconnect_ind_t;


typedef struct {
    uint32_t                     handle;               
    bt_hfp_audio_codec_type_t     codec;               
} bt_hfp_audio_connect_ind_t;


typedef struct {
    uint32_t              handle;                      
} bt_hfp_audio_disconnect_ind_t;



typedef struct {
    uint32_t                    handle;               
    uint32_t                    ag_feature;           
} bt_hfp_feature_ind_t;


typedef struct {
    uint32_t                    handle;             
    uint8_t                     feature;            
} bt_hfp_hold_feature_ind_t;


typedef struct {
    uint32_t                       handle;            
    bt_hfp_ciev_call_state_t       state ;            
} bt_hfp_call_ind_t;


typedef struct {
    uint32_t                         handle;             
    bt_hfp_ciev_call_setup_state_t   state ;             
} bt_hfp_call_setup_ind_t;


typedef struct {
    uint32_t                         handle;              
    bt_hfp_ciev_call_hold_state_t    state ;              
} bt_hfp_call_hold_ind_t;


typedef struct {
    uint32_t              handle;                                 
    uint16_t              num_size;                               
    uint8_t               number[BT_HFP_PHONE_NUMBER_MAX_LEN];    
    uint8_t               class;                                  
    uint8_t               type;                                   
} bt_hfp_call_waiting_ind_t;


typedef struct {
    uint32_t              handle;                                  
    uint16_t              num_size;                                
    uint8_t               number[BT_HFP_PHONE_NUMBER_MAX_LEN];     
    bt_hfp_phone_num_format_t   type;                              
} bt_hfp_caller_id_ind_t;


typedef struct {
    uint32_t              handle;                                   
    uint8_t               index;                                    
    uint8_t               director;                                 
    bt_hfp_call_status_t  state;                                    
    bt_hfp_call_mode_t    mode;                                     
    uint8_t               multiple_party;                           
    uint16_t              num_size;                                 
    uint8_t               number[BT_HFP_PHONE_NUMBER_MAX_LEN];      
    bt_hfp_phone_num_format_t   type;                               
} bt_hfp_call_list_ind_t;


typedef struct {
    uint32_t              handle;                          
    uint8_t               state;                           
} bt_hfp_service_ind_t;


typedef struct {
    uint32_t              handle;                          
    uint8_t               level;                           
} bt_hfp_battery_ind_t;


typedef struct {
    uint32_t              handle;                          
    uint8_t               level ;                          
} bt_hfp_signal_ind_t;


typedef struct {
    uint32_t               handle;                         
    uint8_t                state ;                         
} bt_hfp_roaming_ind_t;


typedef struct {
    uint32_t              handle;                          
    bool                  enable;                          
} bt_hfp_voice_recognition_ind_t;


typedef struct {
    uint32_t              handle;                          
    bool                  enable;                          
} bt_hfp_in_band_ring_status_ind_t;


typedef struct {
    uint32_t              handle;                          
    uint8_t               data;                            
} bt_hfp_volume_sync_speaker_gain_ind_t;


typedef struct {
    uint32_t             handle;                          
    uint8_t              data;                            
} bt_hfp_volume_sync_mic_gain_ind_t;


typedef struct {
    uint32_t             handle;                         
    bt_hfp_audio_status_t audio_status;                  
} bt_hfp_audio_status_change_ind_t;


typedef struct {
    uint32_t              handle;                          
    int32_t               result;                          
} bt_hfp_action_cnf_t;

bt_status_t bt_hfp_connect(uint32_t *handle, bt_bd_addr_t *address);


bt_status_t bt_hfp_connect_response(uint32_t handle, bool accept);


bt_status_t bt_hfp_disconnect(uint32_t handle);


bt_status_t bt_hfp_audio_transfer(uint32_t handle, bt_hfp_audio_direction_t audio_dir);

bt_status_t bt_hfp_set_audio_status(uint32_t handle, bt_hfp_audio_status_t status);


bt_status_t bt_hfp_send_command(uint32_t handle, uint8_t *command, uint16_t command_length);


bt_bd_addr_t* bt_hfp_get_bd_addr_by_handle(uint32_t handle);


bt_status_t bt_hfp_get_init_params(bt_hfp_init_param_t *init_params);

BT_EXTERN_C_END


#endif