bt_audio_hal_interface.h

浏览该文件的文档.

/*
 * Copyright (c) HiSilicon (Shanghai) Technologies Co., Ltd. 2022. All rights reserved.
 * Description:  BT AUDIO HAL module.
 */
 
#ifndef BT_AUDIO_HAL_INTERFACE_H
#define BT_AUDIO_HAL_INTERFACE_H
#include <stdint.h>
#include <td_type.h>
#ifdef __cplusplus
extern "C" {
#endif
 
#define BT_A2DP_CODECCAPS_MAX_LEN 0x10
 
#define BT_AVRCP_EVENT_STATUS_MAX_LEN 0x08
 
#define BTS_ERR_INVALID_TASKID 0xffffffff
 
typedef enum {
    BT_AUDIO_PARAM_A2DP_CODEC,      
    BT_AUDIO_PARAM_AVRCP_VOLUME,    
} bt_audio_param_type;
 
#define BT_AUDIO_CODEC_SBC      0x00
 
#define BT_AUDIO_CODEC_MPEG12   0x01
#define BT_AUDIO_CODEC_MPEG24   0x02
 
#define BT_AUDIO_CODEC_UNKNOWN  0xFF
 
enum {
    /* sampling_freq, do not need to shift again, already in macro */
    BT_AUDIO_A2DP_SBC_SF_16000 =                0x80,
    BT_AUDIO_A2DP_SBC_SF_32000 =                0x40,
    BT_AUDIO_A2DP_SBC_SF_44100 =                0x20, /* SRC must support 44.1 or 48, SNK must support both */
    BT_AUDIO_A2DP_SBC_SF_48000 =                0x10,
    BT_AUDIO_A2DP_SBC_SF_ALL =                  0xF0,
    BT_AUDIO_A2DP_SBC_CHMODE_MONO =             0x08,
    BT_AUDIO_A2DP_SBC_CHMODE_DUAL_CHANNEL =     0x04,
    BT_AUDIO_A2DP_SBC_CHMODE_STEREO =           0x02,
    BT_AUDIO_A2DP_SBC_CHMODE_JOINT_STEREO =     0x01,
    BT_AUDIO_A2DP_SBC_CHMODE_ALL =              0x0F
};
 
enum {
    BT_AUDIO_A2DP_SBC_BLOCK_4 =                 0x80, /* block_len, do not need to shift */
    BT_AUDIO_A2DP_SBC_BLOCK_8 =                 0x40,
    BT_AUDIO_A2DP_SBC_BLOCK_12 =                0x20,
    BT_AUDIO_A2DP_SBC_BLOCK_16 =                0x10,
    BT_AUDIO_A2DP_SBC_BLOCK_ALL =               0xF0,
    BT_AUDIO_A2DP_SBC_SUBBAND_4 =               0x08, /* subbands, do not need to shift */
    BT_AUDIO_A2DP_SBC_SUBBAND_8 =               0x04,
    BT_AUDIO_A2DP_SBC_SUBBAND_ALL =             0x0C,
    BT_AUDIO_A2DP_SBC_SNR =                     0x02, /* allocation_method, do not need to shift */
    BT_AUDIO_A2DP_SBC_LOUDNESS =                0x01, /* Default, most headphone only support Loudness */
    BT_AUDIO_A2DP_SBC_ALLOCATION_ALL =          0x03
};
 
#define BT_AUDIO_A2DP_SBC_MINBITPOOL            0x02
#define BT_AUDIO_A2DP_SBC_MAXBITPOOL            0x44
 
/* MPEG12 capabilitis */
/* chnl_mode */
#define BT_AUDIO_A2DP_MPEG12_JOINTSTEREO       0x01
#define BT_AUDIO_A2DP_MPEG12_STEREO            0x02
#define BT_AUDIO_A2DP_MPEG12_DUAL              0x04
#define BT_AUDIO_A2DP_MPEG12_MONO              0x08
/* crc */
#define BT_AUDIO_A2DP_MPEG12_CRCSUPPORT        0x01
/* layer */
#define BT_AUDIO_A2DP_MPEG12_LAYER1            0x04
#define BT_AUDIO_A2DP_MPEG12_LAYER2            0x02
#define BT_AUDIO_A2DP_MPEG12_LAYER3            0x01
/* sample_frequency */
#define BT_AUDIO_A2DP_MPEG12_FS48000           0x01
#define BT_AUDIO_A2DP_MPEG12_FS44100           0x02
#define BT_AUDIO_A2DP_MPEG12_FS32000           0x04
#define BT_AUDIO_A2DP_MPEG12_FS24000           0x08
#define BT_AUDIO_A2DP_MPEG12_FS22050           0x10
#define BT_AUDIO_A2DP_MPEG12_FS16000           0x20
 
#define BT_AUDIO_A2DP_MPEG12_MPF2SUPPORT       0x01
/* bitrate */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0000        0x0001  /* free */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0001        0x0002  /* 32Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0010        0x0004  /* 40Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0011        0x0008  /* 48Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0100        0x0010  /* 56Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0101        0x0020  /* 64Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0110        0x0040  /* 80Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE0111        0x0080  /* 96Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1000        0x0100  /* 112Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1001        0x0200  /* 128Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1010        0x0400  /* 160Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1011        0x0800  /* 192Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1100        0x1000  /* 224Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1101        0x2000  /* 256Kbps for MPEG-1 layer 3 */
#define BT_AUDIO_A2DP_MPEG12_BITRATE1110        0x4000  /* 320Kbps for MPEG-1 layer 3 */
/* vbr */
#define BT_AUDIO_A2DP_MPEG12_VBRSUPPORT        0x01
 
/* MPEG24(AAC) capabilitis */
#define BT_AUDIO_A2DP_AAC_SF8000                 0x0800
#define BT_AUDIO_A2DP_AAC_SF11025                0x0400
#define BT_AUDIO_A2DP_AAC_SF12000                0x0200
#define BT_AUDIO_A2DP_AAC_SF16000                0x0100
#define BT_AUDIO_A2DP_AAC_SF22050                0x0080
#define BT_AUDIO_A2DP_AAC_SF24000                0x0040
#define BT_AUDIO_A2DP_AAC_SF32000                0x0020
#define BT_AUDIO_A2DP_AAC_SF44100                0x0010
#define BT_AUDIO_A2DP_AAC_SF48000                0x0008
#define BT_AUDIO_A2DP_AAC_SF64000                0x0004
#define BT_AUDIO_A2DP_AAC_SF88200                0x0002
#define BT_AUDIO_A2DP_AAC_SF96000                0x0001
#define BT_AUDIO_A2DP_AAC_SFSEPALL               0x0FFF
 
/* MPEG AAC Sampling Frequency */
#define BT_AUDIO_A2DP_SMAPLE_RATE8000   8000
#define BT_AUDIO_A2DP_SMAPLE_RATE11025  11025
#define BT_AUDIO_A2DP_SMAPLE_RATE12000  12000
#define BT_AUDIO_A2DP_SMAPLE_RATE16000  16000
#define BT_AUDIO_A2DP_SMAPLE_RATE22050  22050
#define BT_AUDIO_A2DP_SMAPLE_RATE24000  24000
#define BT_AUDIO_A2DP_SMAPLE_RATE32000  32000
#define BT_AUDIO_A2DP_SMAPLE_RATE44100  44100
#define BT_AUDIO_A2DP_SMAPLE_RATE48000  48000
#define BT_AUDIO_A2DP_SMAPLE_RATE64000  64000
#define BT_AUDIO_A2DP_SMAPLE_RATE88200  88200
#define BT_AUDIO_A2DP_SMAPLE_RATE96000  96000
 
#define BT_AUDIO_A2DP_AAC_MPEG2_LC                0x80
 
#define BT_AUDIO_A2DP_AAC_MPEG4_LC                0x40
 
#define BT_AUDIO_A2DP_AAC_MPEG4_LTP               0x20
 
#define BT_AUDIO_A2DP_AAC_MPEG4_SCALABLE          0x10
 
#define BT_AUDIO_A2DP_AAC_OBJECT_SEPALL           0xF0
 
#define BT_AUDIO_A2DP_AAC_CH_1                    0x02
 
#define BT_AUDIO_A2DP_AAC_CH_2                    0x01
 
#define BT_AUDIO_A2DP_AAC_VBR                     0x01
 
#define BT_AUDIO_A2DP_AAC_NOVBR                   0x00
 
typedef struct {
    td_u8 codec_type;       
    td_u8 cap_len;          
    td_u16 payload;         
    td_u8 codec_caps[BT_A2DP_CODECCAPS_MAX_LEN]; 
} bt_a2dp_codec_param;
 
/* SBC codec 信息 */
typedef struct {
    td_u32 sample_frequency;    
    td_u8 chnl_mode;            
    td_u8 block_length;         
    td_u8 subband;              
    td_u8 alloc_method;         
    td_u8 min_bitpool;          
    td_u8 max_bitpool;          
} bt_a2dp_sbc_codec_caps;
 
typedef struct {
    td_u32 sample_frequency;
    td_u32 bit_rate;
    td_u8 channels;
    td_u8 object_type;
    td_u8 rfa;
    td_u8 vbr;
} bt_a2dp_mpeg24_codec_caps;
 
typedef enum {
    BT_AUDIO_A2DP_STREAM_CREATE,        /* A2DP流创建，数据为流handle，长度为sizeof(td_pvoid) */
    BT_AUDIO_A2DP_STREAM_OPENED,        /* A2DP流打开，数据为 bt_audio_a2dp_stream_open_data，长度为sizeof(td_pvoid) */
    BT_AUDIO_A2DP_STREAM_STRAT,         /* A2DP流开始，数据为流handle，长度为sizeof(td_pvoid) */
    BT_AUDIO_A2DP_STREAM_SUSPENDED,     /* A2DP流暂停，数据为流handle，长度为sizeof(td_pvoid) */
    BT_AUDIO_A2DP_STREAM_CLOSED,        /* A2DP流关闭，数据为流handle，长度为sizeof(td_pvoid) */
    BT_AUDIO_A2DP_STREAM_CONFIG_CHANGE, /* A2DP流参数变更，数据结构为 bt_audio_a2dp_config_chg_data */
    BT_AUDIO_SCO_CONN_ESTABLISHED,      /* SCO连接建立，数据为流handle，长度为sizeof(td_pvoid) */
    BT_AUDIO_SCO_CONN_RELEASED,         /* SCO连接释放，数据为流handle，长度为sizeof(td_pvoid) */
} bt_audio_event_type;
 
typedef struct {
    td_pvoid stream_hdl;
    td_u16 stream_mtu;
    td_u16 frame_size;
    td_u8 num_frame;
    td_u8 pad;
    td_u16 pad1;
} bt_audio_a2dp_stream_open_data;
 
typedef struct {
    td_pvoid stream_hdl;
    bt_a2dp_codec_param codec;
} bt_audio_a2dp_config_chg_data;
 
typedef enum {
    A2DP,
    SCO_IN,
    SCO_OUT,
    BT_AUDIO_PORT_MAX
} bt_audio_port_type;
 
typedef struct {
    bt_audio_port_type port_type;   
    union {
        td_u32 share_mem_id;        
    };
} bt_audio_port_params;
 
typedef td_void (*bt_audio_listener_cb)(bt_audio_event_type type, const td_void *data, int32_t size, td_void *context);
 
td_u32 bt_register_audio_listener(bt_audio_listener_cb cb, td_void *context);
 
td_u32 bt_deregister_audio_listener(bt_audio_listener_cb cb);
 
td_u32 bt_start_audio_stream(td_pvoid stream_hdl);
 
td_u32 bt_pause_audio_stream(td_pvoid stream_hdl);
 
td_u32 bt_stop_audio_stream(td_pvoid stream_hdl);
 
td_u32 bt_attach_audio_port(td_pvoid stream_hdl, bt_audio_port_params *param);
 
td_u32 bt_detach_audio_port(td_pvoid stream_hdl, bt_audio_port_params *param);
 
td_u32 bt_set_audio_parameter(td_pvoid stream_hdl, bt_audio_param_type type, td_void *params, int32_t len);
 
td_u32 bt_get_audio_parameter(td_pvoid stream_hdl, bt_audio_param_type type, td_void *params, int32_t len);
 
#ifdef __cplusplus
}
#endif
#endif /* BT_AUDIO_HAL_INTERFACE_H */