/******************************************************************************
*
* Copyright (C) 2004-2012 Broadcom Corporation
*
* 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.
*
******************************************************************************/
/******************************************************************************
*
* This is the public interface file for the advanced audio/video streaming
* (AV) subsystem of BTA, Broadcom's Bluetooth application layer for mobile
* phones.
*
******************************************************************************/
#ifndef BTA_AV_API_H
#define BTA_AV_API_H
#include "a2dp_codec_api.h"
#include "avdt_api.h"
#include "avrc_api.h"
#include "bta_api.h"
/*****************************************************************************
* Constants and data types
****************************************************************************/
/* Set to TRUE if seperate authorization prompt desired for AVCTP besides A2DP
* authorization */
/* Typically FALSE when AVRCP is used in conjunction with A2DP */
#ifndef BTA_AV_WITH_AVCTP_AUTHORIZATION
#define BTA_AV_WITH_AVCTP_AUTHORIZATION FALSE
#endif
/* AV status values */
#define BTA_AV_SUCCESS 0 /* successful operation */
#define BTA_AV_FAIL 1 /* generic failure */
#define BTA_AV_FAIL_SDP 2 /* service not found */
#define BTA_AV_FAIL_STREAM 3 /* stream connection failed */
#define BTA_AV_FAIL_RESOURCES 4 /* no resources */
#define BTA_AV_FAIL_ROLE 5 /* failed due to role management related issues */
#define BTA_AV_FAIL_GET_CAP \
6 /* get capability failed due to no SEP availale on the peer */
typedef uint8_t tBTA_AV_STATUS;
/* AV features masks */
#define BTA_AV_FEAT_RCTG 0x0001 /* remote control target */
#define BTA_AV_FEAT_RCCT 0x0002 /* remote control controller */
#define BTA_AV_FEAT_PROTECT 0x0004 /* streaming media contect protection */
#define BTA_AV_FEAT_VENDOR \
0x0008 /* remote control vendor dependent commands \
*/
#define BTA_AV_FEAT_REPORT 0x0020 /* use reporting service for VDP */
#define BTA_AV_FEAT_METADATA \
0x0040 /* remote control Metadata Transfer command/response */
#define BTA_AV_FEAT_MULTI_AV \
0x0080 /* use multi-av, if controller supports it */
#define BTA_AV_FEAT_BROWSE 0x0010 /* use browsing channel */
#define BTA_AV_FEAT_MASTER 0x0100 /* stream only as master role */
#define BTA_AV_FEAT_ADV_CTRL \
0x0200 /* remote control Advanced Control command/response */
#define BTA_AV_FEAT_DELAY_RPT 0x0400 /* allow delay reporting */
#define BTA_AV_FEAT_ACP_START \
0x0800 /* start stream when 2nd SNK was accepted */
#define BTA_AV_FEAT_APP_SETTING 0x2000 /* Player app setting support */
/* Internal features */
#define BTA_AV_FEAT_NO_SCO_SSPD \
0x8000 /* Do not suspend av streaming as to AG events(SCO or Call) */
typedef uint16_t tBTA_AV_FEAT;
/* AV channel values */
#define BTA_AV_CHNL_MSK 0xC0
#define BTA_AV_CHNL_AUDIO 0x40 /* audio channel */
#define BTA_AV_CHNL_VIDEO 0x80 /* video channel */
typedef uint8_t tBTA_AV_CHNL;
#define BTA_AV_HNDL_MSK 0x3F
typedef uint8_t tBTA_AV_HNDL;
/* handle index to mask */
#define BTA_AV_HNDL_TO_MSK(h) ((uint8_t)(1 << (h)))
/* maximum number of streams created: 1 for audio, 1 for video */
#ifndef BTA_AV_NUM_STRS
#define BTA_AV_NUM_STRS 2
#endif
#ifndef BTA_AV_MAX_A2DP_MTU
/*#define BTA_AV_MAX_A2DP_MTU 668 //224 (DM5) * 3 - 4(L2CAP header) */
#define BTA_AV_MAX_A2DP_MTU 1008
#endif
#ifndef BTA_AV_MAX_VDP_MTU
#define BTA_AV_MAX_VDP_MTU 1008
#endif
/* operation id list for BTA_AvRemoteCmd */
#define BTA_AV_RC_SELECT AVRC_ID_SELECT /* select */
#define BTA_AV_RC_UP AVRC_ID_UP /* up */
#define BTA_AV_RC_DOWN AVRC_ID_DOWN /* down */
#define BTA_AV_RC_LEFT AVRC_ID_LEFT /* left */
#define BTA_AV_RC_RIGHT AVRC_ID_RIGHT /* right */
#define BTA_AV_RC_RIGHT_UP AVRC_ID_RIGHT_UP /* right-up */
#define BTA_AV_RC_RIGHT_DOWN AVRC_ID_RIGHT_DOWN /* right-down */
#define BTA_AV_RC_LEFT_UP AVRC_ID_LEFT_UP /* left-up */
#define BTA_AV_RC_LEFT_DOWN AVRC_ID_LEFT_DOWN /* left-down */
#define BTA_AV_RC_ROOT_MENU AVRC_ID_ROOT_MENU /* root menu */
#define BTA_AV_RC_SETUP_MENU AVRC_ID_SETUP_MENU /* setup menu */
#define BTA_AV_RC_CONT_MENU AVRC_ID_CONT_MENU /* contents menu */
#define BTA_AV_RC_FAV_MENU AVRC_ID_FAV_MENU /* favorite menu */
#define BTA_AV_RC_EXIT AVRC_ID_EXIT /* exit */
#define BTA_AV_RC_0 AVRC_ID_0 /* 0 */
#define BTA_AV_RC_1 AVRC_ID_1 /* 1 */
#define BTA_AV_RC_2 AVRC_ID_2 /* 2 */
#define BTA_AV_RC_3 AVRC_ID_3 /* 3 */
#define BTA_AV_RC_4 AVRC_ID_4 /* 4 */
#define BTA_AV_RC_5 AVRC_ID_5 /* 5 */
#define BTA_AV_RC_6 AVRC_ID_6 /* 6 */
#define BTA_AV_RC_7 AVRC_ID_7 /* 7 */
#define BTA_AV_RC_8 AVRC_ID_8 /* 8 */
#define BTA_AV_RC_9 AVRC_ID_9 /* 9 */
#define BTA_AV_RC_DOT AVRC_ID_DOT /* dot */
#define BTA_AV_RC_ENTER AVRC_ID_ENTER /* enter */
#define BTA_AV_RC_CLEAR AVRC_ID_CLEAR /* clear */
#define BTA_AV_RC_CHAN_UP AVRC_ID_CHAN_UP /* channel up */
#define BTA_AV_RC_CHAN_DOWN AVRC_ID_CHAN_DOWN /* channel down */
#define BTA_AV_RC_PREV_CHAN AVRC_ID_PREV_CHAN /* previous channel */
#define BTA_AV_RC_SOUND_SEL AVRC_ID_SOUND_SEL /* sound select */
#define BTA_AV_RC_INPUT_SEL AVRC_ID_INPUT_SEL /* input select */
#define BTA_AV_RC_DISP_INFO AVRC_ID_DISP_INFO /* display information */
#define BTA_AV_RC_HELP AVRC_ID_HELP /* help */
#define BTA_AV_RC_PAGE_UP AVRC_ID_PAGE_UP /* page up */
#define BTA_AV_RC_PAGE_DOWN AVRC_ID_PAGE_DOWN /* page down */
#define BTA_AV_RC_POWER AVRC_ID_POWER /* power */
#define BTA_AV_RC_VOL_UP AVRC_ID_VOL_UP /* volume up */
#define BTA_AV_RC_VOL_DOWN AVRC_ID_VOL_DOWN /* volume down */
#define BTA_AV_RC_MUTE AVRC_ID_MUTE /* mute */
#define BTA_AV_RC_PLAY AVRC_ID_PLAY /* play */
#define BTA_AV_RC_STOP AVRC_ID_STOP /* stop */
#define BTA_AV_RC_PAUSE AVRC_ID_PAUSE /* pause */
#define BTA_AV_RC_RECORD AVRC_ID_RECORD /* record */
#define BTA_AV_RC_REWIND AVRC_ID_REWIND /* rewind */
#define BTA_AV_RC_FAST_FOR AVRC_ID_FAST_FOR /* fast forward */
#define BTA_AV_RC_EJECT AVRC_ID_EJECT /* eject */
#define BTA_AV_RC_FORWARD AVRC_ID_FORWARD /* forward */
#define BTA_AV_RC_BACKWARD AVRC_ID_BACKWARD /* backward */
#define BTA_AV_RC_ANGLE AVRC_ID_ANGLE /* angle */
#define BTA_AV_RC_SUBPICT AVRC_ID_SUBPICT /* subpicture */
#define BTA_AV_RC_F1 AVRC_ID_F1 /* F1 */
#define BTA_AV_RC_F2 AVRC_ID_F2 /* F2 */
#define BTA_AV_RC_F3 AVRC_ID_F3 /* F3 */
#define BTA_AV_RC_F4 AVRC_ID_F4 /* F4 */
#define BTA_AV_RC_F5 AVRC_ID_F5 /* F5 */
#define BTA_AV_VENDOR AVRC_ID_VENDOR /* vendor unique */
typedef uint8_t tBTA_AV_RC;
/* state flag for pass through command */
#define BTA_AV_STATE_PRESS AVRC_STATE_PRESS /* key pressed */
#define BTA_AV_STATE_RELEASE AVRC_STATE_RELEASE /* key released */
typedef uint8_t tBTA_AV_STATE;
/* command codes for BTA_AvVendorCmd */
#define BTA_AV_CMD_CTRL AVRC_CMD_CTRL
#define BTA_AV_CMD_STATUS AVRC_CMD_STATUS
#define BTA_AV_CMD_SPEC_INQ AVRC_CMD_SPEC_INQ
#define BTA_AV_CMD_NOTIF AVRC_CMD_NOTIF
#define BTA_AV_CMD_GEN_INQ AVRC_CMD_GEN_INQ
typedef uint8_t tBTA_AV_CMD;
/* response codes for BTA_AvVendorRsp */
#define BTA_AV_RSP_NOT_IMPL AVRC_RSP_NOT_IMPL
#define BTA_AV_RSP_ACCEPT AVRC_RSP_ACCEPT
#define BTA_AV_RSP_REJ AVRC_RSP_REJ
#define BTA_AV_RSP_IN_TRANS AVRC_RSP_IN_TRANS
#define BTA_AV_RSP_IMPL_STBL AVRC_RSP_IMPL_STBL
#define BTA_AV_RSP_CHANGED AVRC_RSP_CHANGED
#define BTA_AV_RSP_INTERIM AVRC_RSP_INTERIM
typedef uint8_t tBTA_AV_CODE;
/* error codes for BTA_AvProtectRsp */
#define BTA_AV_ERR_NONE A2DP_SUCCESS /* Success, no error */
#define BTA_AV_ERR_BAD_STATE \
AVDT_ERR_BAD_STATE /* Message cannot be processed in this state */
#define BTA_AV_ERR_RESOURCE AVDT_ERR_RESOURCE /* Insufficient resources */
#define BTA_AV_ERR_BAD_CP_TYPE \
A2DP_BAD_CP_TYPE /* The requested Content Protection Type is not supported \
*/
#define BTA_AV_ERR_BAD_CP_FORMAT \
A2DP_BAD_CP_FORMAT /* The format of Content Protection Data is not correct \
*/
typedef uint8_t tBTA_AV_ERR;
/* AV callback events */
#define BTA_AV_ENABLE_EVT 0 /* AV enabled */
#define BTA_AV_REGISTER_EVT 1 /* registered to AVDT */
#define BTA_AV_OPEN_EVT 2 /* connection opened */
#define BTA_AV_CLOSE_EVT 3 /* connection closed */
#define BTA_AV_START_EVT 4 /* stream data transfer started */
#define BTA_AV_STOP_EVT 5 /* stream data transfer stopped */
#define BTA_AV_PROTECT_REQ_EVT 6 /* content protection request */
#define BTA_AV_PROTECT_RSP_EVT 7 /* content protection response */
#define BTA_AV_RC_OPEN_EVT 8 /* remote control channel open */
#define BTA_AV_RC_CLOSE_EVT 9 /* remote control channel closed */
#define BTA_AV_REMOTE_CMD_EVT 10 /* remote control command */
#define BTA_AV_REMOTE_RSP_EVT 11 /* remote control response */
#define BTA_AV_VENDOR_CMD_EVT 12 /* vendor dependent remote control command */
#define BTA_AV_VENDOR_RSP_EVT \
13 /* vendor dependent remote control response \
*/
#define BTA_AV_RECONFIG_EVT 14 /* reconfigure response */
#define BTA_AV_SUSPEND_EVT 15 /* suspend response */
#define BTA_AV_PENDING_EVT \
16 /* incoming connection pending: \
* signal channel is open and stream is \
* not open after \
* BTA_AV_SIGNALLING_TIMEOUT_MS */
#define BTA_AV_META_MSG_EVT 17 /* metadata messages */
#define BTA_AV_REJECT_EVT 18 /* incoming connection rejected */
#define BTA_AV_RC_FEAT_EVT \
19 /* remote control channel peer supported features update */
#define BTA_AV_SINK_MEDIA_CFG_EVT 20 /* command to configure codec */
#define BTA_AV_SINK_MEDIA_DATA_EVT 21 /* sending data to Media Task */
#define BTA_AV_OFFLOAD_START_RSP_EVT 22 /* a2dp offload start response */
#define BTA_AV_RC_BROWSE_OPEN_EVT 23 /* remote control channel open */
#define BTA_AV_RC_BROWSE_CLOSE_EVT 24 /* remote control channel closed */
/* Max BTA event */
#define BTA_AV_MAX_EVT 25
typedef uint8_t tBTA_AV_EVT;
/* Event associated with BTA_AV_ENABLE_EVT */
typedef struct { tBTA_AV_FEAT features; } tBTA_AV_ENABLE;
/* Event associated with BTA_AV_REGISTER_EVT */
typedef struct {
tBTA_AV_CHNL chnl; /* audio/video */
tBTA_AV_HNDL hndl; /* Handle associated with the stream. */
uint8_t app_id; /* ID associated with call to BTA_AvRegister() */
tBTA_AV_STATUS status;
} tBTA_AV_REGISTER;
/* data associated with BTA_AV_OPEN_EVT */
#define BTA_AV_EDR_2MBPS 0x01
#define BTA_AV_EDR_3MBPS 0x02
typedef uint8_t tBTA_AV_EDR;
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
BD_ADDR bd_addr;
tBTA_AV_STATUS status;
bool starting;
tBTA_AV_EDR edr; /* 0, if peer device does not support EDR */
uint8_t sep; /* sep type of peer device */
} tBTA_AV_OPEN;
/* data associated with BTA_AV_CLOSE_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
} tBTA_AV_CLOSE;
/* data associated with BTA_AV_START_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
tBTA_AV_STATUS status;
bool initiator; /* true, if local device initiates the START */
bool suspending;
} tBTA_AV_START;
/* data associated with BTA_AV_SUSPEND_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
bool initiator; /* true, if local device initiates the SUSPEND */
tBTA_AV_STATUS status;
} tBTA_AV_SUSPEND;
/* data associated with BTA_AV_RECONFIG_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
tBTA_AV_STATUS status;
} tBTA_AV_RECONFIG;
/* data associated with BTA_AV_PROTECT_REQ_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
uint8_t* p_data;
uint16_t len;
} tBTA_AV_PROTECT_REQ;
/* data associated with BTA_AV_PROTECT_RSP_EVT */
typedef struct {
tBTA_AV_CHNL chnl;
tBTA_AV_HNDL hndl;
uint8_t* p_data;
uint16_t len;
tBTA_AV_ERR err_code;
} tBTA_AV_PROTECT_RSP;
/* data associated with BTA_AV_RC_OPEN_EVT */
typedef struct {
uint8_t rc_handle;
tBTA_AV_FEAT peer_features;
BD_ADDR peer_addr;
tBTA_AV_STATUS status;
} tBTA_AV_RC_OPEN;
/* data associated with BTA_AV_RC_CLOSE_EVT */
typedef struct {
uint8_t rc_handle;
BD_ADDR peer_addr;
} tBTA_AV_RC_CLOSE;
/* data associated with BTA_AV_RC_BROWSE_OPEN_EVT */
typedef struct {
uint8_t rc_handle;
BD_ADDR peer_addr;
tBTA_AV_STATUS status;
} tBTA_AV_RC_BROWSE_OPEN;
/* data associated with BTA_AV_RC_BROWSE_CLOSE_EVT */
typedef struct {
uint8_t rc_handle;
BD_ADDR peer_addr;
} tBTA_AV_RC_BROWSE_CLOSE;
/* data associated with BTA_AV_RC_FEAT_EVT */
typedef struct {
uint8_t rc_handle;
tBTA_AV_FEAT peer_features;
BD_ADDR peer_addr;
} tBTA_AV_RC_FEAT;
/* data associated with BTA_AV_REMOTE_CMD_EVT */
typedef struct {
uint8_t rc_handle;
tBTA_AV_RC rc_id;
tBTA_AV_STATE key_state;
uint8_t len;
uint8_t* p_data;
tAVRC_HDR hdr; /* Message header. */
uint8_t label;
} tBTA_AV_REMOTE_CMD;
/* data associated with BTA_AV_REMOTE_RSP_EVT */
typedef struct {
uint8_t rc_handle;
tBTA_AV_RC rc_id;
tBTA_AV_STATE key_state;
uint8_t len;
uint8_t* p_data;
tBTA_AV_CODE rsp_code;
uint8_t label;
} tBTA_AV_REMOTE_RSP;
/* data associated with BTA_AV_VENDOR_CMD_EVT, BTA_AV_VENDOR_RSP_EVT */
typedef struct {
uint8_t rc_handle;
uint16_t len; /* Max vendor dependent message is 512 */
uint8_t label;
tBTA_AV_CODE code;
uint32_t company_id;
uint8_t* p_data;
} tBTA_AV_VENDOR;
/* data associated with BTA_AV_META_MSG_EVT */
typedef struct {
uint8_t rc_handle;
uint16_t len;
uint8_t label;
tBTA_AV_CODE code;
uint32_t company_id;
uint8_t* p_data;
tAVRC_MSG* p_msg;
} tBTA_AV_META_MSG;
/* data associated with BTA_AV_PENDING_EVT */
typedef struct { BD_ADDR bd_addr; } tBTA_AV_PEND;
/* data associated with BTA_AV_REJECT_EVT */
typedef struct {
BD_ADDR bd_addr;
tBTA_AV_HNDL hndl; /* Handle associated with the stream that rejected the
connection. */
} tBTA_AV_REJECT;
/* union of data associated with AV callback */
typedef union {
tBTA_AV_CHNL chnl;
tBTA_AV_ENABLE enable;
tBTA_AV_REGISTER registr;
tBTA_AV_OPEN open;
tBTA_AV_CLOSE close;
tBTA_AV_START start;
tBTA_AV_PROTECT_REQ protect_req;
tBTA_AV_PROTECT_RSP protect_rsp;
tBTA_AV_RC_OPEN rc_open;
tBTA_AV_RC_CLOSE rc_close;
tBTA_AV_RC_BROWSE_OPEN rc_browse_open;
tBTA_AV_RC_BROWSE_CLOSE rc_browse_close;
tBTA_AV_REMOTE_CMD remote_cmd;
tBTA_AV_REMOTE_RSP remote_rsp;
tBTA_AV_VENDOR vendor_cmd;
tBTA_AV_VENDOR vendor_rsp;
tBTA_AV_RECONFIG reconfig;
tBTA_AV_SUSPEND suspend;
tBTA_AV_PEND pend;
tBTA_AV_META_MSG meta_msg;
tBTA_AV_REJECT reject;
tBTA_AV_RC_FEAT rc_feat;
tBTA_AV_STATUS status;
} tBTA_AV;
typedef struct {
uint8_t* codec_info;
BD_ADDR bd_addr;
;
} tBTA_AVK_CONFIG;
/* union of data associated with AV Media callback */
typedef union {
BT_HDR* p_data;
tBTA_AVK_CONFIG avk_config;
} tBTA_AV_MEDIA;
#define BTA_GROUP_NAVI_MSG_OP_DATA_LEN 5
/* AV callback */
typedef void(tBTA_AV_CBACK)(tBTA_AV_EVT event, tBTA_AV* p_data);
typedef void(tBTA_AV_SINK_DATA_CBACK)(tBTA_AV_EVT event, tBTA_AV_MEDIA* p_data);
/* type for stream state machine action functions */
typedef void (*tBTA_AV_ACT)(void* p_cb, void* p_data);
/* type for registering VDP */
typedef void(tBTA_AV_REG)(tAVDT_CS* p_cs, char* p_service_name, void* p_data);
/* AV configuration structure */
typedef struct {
uint32_t company_id; /* AVRCP Company ID */
uint16_t avrc_mtu; /* AVRCP MTU at L2CAP for control channel */
uint16_t avrc_br_mtu; /* AVRCP MTU at L2CAP for browsing channel */
uint16_t avrc_ct_cat; /* AVRCP controller categories */
uint16_t avrc_tg_cat; /* AVRCP target categories */
uint16_t sig_mtu; /* AVDTP signaling channel MTU at L2CAP */
uint16_t audio_mtu; /* AVDTP audio transport channel MTU at L2CAP */
const uint16_t*
p_audio_flush_to; /* AVDTP audio transport channel flush timeout */
uint16_t audio_mqs; /* AVDTP audio channel max data queue size */
uint16_t video_mtu; /* AVDTP video transport channel MTU at L2CAP */
uint16_t video_flush_to; /* AVDTP video transport channel flush timeout */
bool avrc_group; /* true, to accept AVRC 1.3 group nevigation command */
uint8_t num_co_ids; /* company id count in p_meta_co_ids */
uint8_t num_evt_ids; /* event id count in p_meta_evt_ids */
tBTA_AV_CODE
rc_pass_rsp; /* the default response code for pass through commands */
const uint32_t*
p_meta_co_ids; /* the metadata Get Capabilities response for company id */
const uint8_t* p_meta_evt_ids; /* the the metadata Get Capabilities response
for event id */
const tBTA_AV_ACT* p_act_tbl; /* the action function table for VDP stream */
tBTA_AV_REG* p_reg; /* action function to register VDP */
char avrc_controller_name[BTA_SERVICE_NAME_LEN]; /* Default AVRCP controller
name */
char avrc_target_name[BTA_SERVICE_NAME_LEN]; /* Default AVRCP target name*/
} tBTA_AV_CFG;
/*****************************************************************************
* External Function Declarations
****************************************************************************/
/*******************************************************************************
*
* Function BTA_AvEnable
*
* Description Enable the advanced audio/video service. When the enable
* operation is complete the callback function will be
* called with a BTA_AV_ENABLE_EVT. This function must
* be called before other function in the AV API are
* called.
*
* Returns void
*
******************************************************************************/
void BTA_AvEnable(tBTA_SEC sec_mask, tBTA_AV_FEAT features,
tBTA_AV_CBACK* p_cback);
/*******************************************************************************
*
* Function BTA_AvDisable
*
* Description Disable the advanced audio/video service.
*
*
* Returns void
*
******************************************************************************/
void BTA_AvDisable(void);
/*******************************************************************************
*
* Function BTA_AvRegister
*
* Description Register the audio or video service to stack. When the
* operation is complete the callback function will be
* called with a BTA_AV_REGISTER_EVT. This function must
* be called before AVDT stream is open.
*
*
* Returns void
*
******************************************************************************/
void BTA_AvRegister(tBTA_AV_CHNL chnl, const char* p_service_name,
uint8_t app_id, tBTA_AV_SINK_DATA_CBACK* p_sink_data_cback,
uint16_t service_uuid);
/*******************************************************************************
*
* Function BTA_AvDeregister
*
* Description Deregister the audio or video service
*
* Returns void
*
******************************************************************************/
void BTA_AvDeregister(tBTA_AV_HNDL hndl);
/*******************************************************************************
*
* Function BTA_AvOpen
*
* Description Opens an advanced audio/video connection to a peer device.
* When connection is open callback function is called
* with a BTA_AV_OPEN_EVT.
*
* Returns void
*
******************************************************************************/
void BTA_AvOpen(BD_ADDR bd_addr, tBTA_AV_HNDL handle, bool use_rc,
tBTA_SEC sec_mask, uint16_t uuid);
/*******************************************************************************
*
* Function BTA_AvClose
*
* Description Close the current streams.
*
* Returns void
*
******************************************************************************/
void BTA_AvClose(tBTA_AV_HNDL handle);
/*******************************************************************************
*
* Function BTA_AvDisconnect
*
* Description Close the connection to the address.
*
* Returns void
*
******************************************************************************/
void BTA_AvDisconnect(BD_ADDR bd_addr);
/*******************************************************************************
*
* Function BTA_AvStart
*
* Description Start audio/video stream data transfer.
*
* Returns void
*
******************************************************************************/
void BTA_AvStart(void);
/*******************************************************************************
*
* Function BTA_AvStop
*
* Description Stop audio/video stream data transfer.
* If suspend is true, this function sends AVDT suspend signal
* to the connected peer(s).
*
* Returns void
*
******************************************************************************/
void BTA_AvStop(bool suspend);
/*******************************************************************************
*
* Function BTA_AvReconfig
*
* Description Reconfigure the audio/video stream.
* If suspend is true, this function tries the
* suspend/reconfigure procedure first.
* If suspend is false or when suspend/reconfigure fails,
* this function closes and re-opens the AVDT connection.
*
* Returns void
*
******************************************************************************/
void BTA_AvReconfig(tBTA_AV_HNDL hndl, bool suspend, uint8_t sep_info_idx,
uint8_t* p_codec_info, uint8_t num_protect,
const uint8_t* p_protect_info);
/*******************************************************************************
*
* Function BTA_AvProtectReq
*
* Description Send a content protection request. This function can only
* be used if AV is enabled with feature BTA_AV_FEAT_PROTECT.
*
* Returns void
*
******************************************************************************/
void BTA_AvProtectReq(tBTA_AV_HNDL hndl, uint8_t* p_data, uint16_t len);
/*******************************************************************************
*
* Function BTA_AvProtectRsp
*
* Description Send a content protection response. This function must
* be called if a BTA_AV_PROTECT_REQ_EVT is received.
* This function can only be used if AV is enabled with
* feature BTA_AV_FEAT_PROTECT.
*
* Returns void
*
******************************************************************************/
void BTA_AvProtectRsp(tBTA_AV_HNDL hndl, uint8_t error_code, uint8_t* p_data,
uint16_t len);
/*******************************************************************************
*
* Function BTA_AvRemoteCmd
*
* Description Send a remote control command. This function can only
* be used if AV is enabled with feature BTA_AV_FEAT_RCCT.
*
* Returns void
*
******************************************************************************/
void BTA_AvRemoteCmd(uint8_t rc_handle, uint8_t label, tBTA_AV_RC rc_id,
tBTA_AV_STATE key_state);
/*******************************************************************************
*
* Function BTA_AvRemoteVendorUniqueCmd
*
* Description Send a remote control command with Vendor Unique rc_id.
* This function can only be used if AV is enabled with
* feature BTA_AV_FEAT_RCCT.
*
* Returns void
*
******************************************************************************/
void BTA_AvRemoteVendorUniqueCmd(uint8_t rc_handle, uint8_t label,
tBTA_AV_STATE key_state, uint8_t* p_msg,
uint8_t buf_len);
/*******************************************************************************
*
* Function BTA_AvVendorCmd
*
* Description Send a vendor dependent remote control command. This
* function can only be used if AV is enabled with feature
* BTA_AV_FEAT_VENDOR.
*
* Returns void
*
******************************************************************************/
void BTA_AvVendorCmd(uint8_t rc_handle, uint8_t label, tBTA_AV_CODE cmd_code,
uint8_t* p_data, uint16_t len);
/*******************************************************************************
*
* Function BTA_AvVendorRsp
*
* Description Send a vendor dependent remote control response.
* This function must be called if a BTA_AV_VENDOR_CMD_EVT
* is received. This function can only be used if AV is
* enabled with feature BTA_AV_FEAT_VENDOR.
*
* Returns void
*
******************************************************************************/
void BTA_AvVendorRsp(uint8_t rc_handle, uint8_t label, tBTA_AV_CODE rsp_code,
uint8_t* p_data, uint16_t len, uint32_t company_id);
/*******************************************************************************
*
* Function BTA_AvOpenRc
*
* Description Open an AVRCP connection toward the device with the
* specified handle
*
* Returns void
*
******************************************************************************/
void BTA_AvOpenRc(tBTA_AV_HNDL handle);
/*******************************************************************************
*
* Function BTA_AvCloseRc
*
* Description Close an AVRCP connection
*
* Returns void
*
******************************************************************************/
void BTA_AvCloseRc(uint8_t rc_handle);
/*******************************************************************************
*
* Function BTA_AvMetaRsp
*
* Description Send a Metadata command/response. The message contained
* in p_pkt can be composed with AVRC utility functions.
* This function can only be used if AV is enabled with feature
* BTA_AV_FEAT_METADATA.
*
* Returns void
*
******************************************************************************/
void BTA_AvMetaRsp(uint8_t rc_handle, uint8_t label, tBTA_AV_CODE rsp_code,
BT_HDR* p_pkt);
/*******************************************************************************
*
* Function BTA_AvMetaCmd
*
* Description Send a Metadata/Advanced Control command. The message
*contained
* in p_pkt can be composed with AVRC utility functions.
* This function can only be used if AV is enabled with feature
* BTA_AV_FEAT_METADATA.
* This message is sent only when the peer supports the TG
*role.
*8 The only command makes sense right now is the absolute
*volume command.
*
* Returns void
*
******************************************************************************/
void BTA_AvMetaCmd(uint8_t rc_handle, uint8_t label, tBTA_AV_CMD cmd_code,
BT_HDR* p_pkt);
/*******************************************************************************
*
* Function BTA_AvOffloadStart
*
* Description Request Starting of A2DP Offload.
* This function is used to start A2DP offload if vendor lib
* has the feature enabled.
*
* Returns void
*
******************************************************************************/
void BTA_AvOffloadStart(tBTA_AV_HNDL hndl);
/*******************************************************************************
*
* Function BTA_AvOffloadStartRsp
*
* Description Response from vendor library indicating response for
* OffloadStart.
*
* Returns void
*
******************************************************************************/
void BTA_AvOffloadStartRsp(tBTA_AV_HNDL hndl, tBTA_AV_STATUS status);
#endif /* BTA_AV_API_H */