bta_av_api.c revision efb0d06adb3e4354401133f65b1f7529c6432d02
1/****************************************************************************** 2 * 3 * Copyright (C) 2011-2012 Broadcom Corporation 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at: 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 ******************************************************************************/ 18 19/****************************************************************************** 20 * 21 * This is the implementation of the API for the advanced audio/video (AV) 22 * subsystem of BTA, Broadcom's Bluetooth application layer for mobile 23 * phones. 24 * 25 ******************************************************************************/ 26 27#include "bt_target.h" 28#if defined(BTA_AV_INCLUDED) && (BTA_AV_INCLUDED == TRUE) 29 30#include "bta_api.h" 31#include "bd.h" 32#include "bta_sys.h" 33#include "bta_av_api.h" 34#include "bta_av_int.h" 35#include "gki.h" 36#include <string.h> 37 38/***************************************************************************** 39** Constants 40*****************************************************************************/ 41 42static const tBTA_SYS_REG bta_av_reg = 43{ 44 bta_av_hdl_event, 45 BTA_AvDisable 46}; 47 48/******************************************************************************* 49** 50** Function BTA_AvEnable 51** 52** Description Enable the advanced audio/video service. When the enable 53** operation is complete the callback function will be 54** called with a BTA_AV_ENABLE_EVT. This function must 55** be called before other function in the AV API are 56** called. 57** 58** Returns void 59** 60*******************************************************************************/ 61void BTA_AvEnable(tBTA_SEC sec_mask, tBTA_AV_FEAT features, tBTA_AV_CBACK *p_cback) 62{ 63 tBTA_AV_API_ENABLE *p_buf; 64 65 /* register with BTA system manager */ 66 bta_sys_register(BTA_ID_AV, &bta_av_reg); 67 68 if ((p_buf = (tBTA_AV_API_ENABLE *) GKI_getbuf(sizeof(tBTA_AV_API_ENABLE))) != NULL) 69 { 70 p_buf->hdr.event = BTA_AV_API_ENABLE_EVT; 71 p_buf->p_cback = p_cback; 72 p_buf->features = features; 73 p_buf->sec_mask = sec_mask; 74 bta_sys_sendmsg(p_buf); 75 } 76} 77 78/******************************************************************************* 79** 80** Function BTA_AvDisable 81** 82** Description Disable the advanced audio/video service. 83** 84** Returns void 85** 86*******************************************************************************/ 87void BTA_AvDisable(void) 88{ 89 BT_HDR *p_buf; 90 91 bta_sys_deregister(BTA_ID_AV); 92 if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL) 93 { 94 p_buf->event = BTA_AV_API_DISABLE_EVT; 95 bta_sys_sendmsg(p_buf); 96 } 97} 98 99/******************************************************************************* 100** 101** Function BTA_AvRegister 102** 103** Description Register the audio or video service to stack. When the 104** operation is complete the callback function will be 105** called with a BTA_AV_REGISTER_EVT. This function must 106** be called before AVDT stream is open. 107** 108** 109** Returns void 110** 111*******************************************************************************/ 112void BTA_AvRegister(tBTA_AV_CHNL chnl, const char *p_service_name, UINT8 app_id, tBTA_AV_DATA_CBACK *p_data_cback) 113{ 114 tBTA_AV_API_REG *p_buf; 115 116 117 if ((p_buf = (tBTA_AV_API_REG *) GKI_getbuf(sizeof(tBTA_AV_API_REG))) != NULL) 118 { 119 p_buf->hdr.layer_specific = chnl; 120 p_buf->hdr.event = BTA_AV_API_REGISTER_EVT; 121 if(p_service_name) 122 { 123 BCM_STRNCPY_S(p_buf->p_service_name, sizeof(p_buf->p_service_name), p_service_name, BTA_SERVICE_NAME_LEN); 124 p_buf->p_service_name[BTA_SERVICE_NAME_LEN-1] = 0; 125 } 126 else 127 { 128 p_buf->p_service_name[0] = 0; 129 } 130 p_buf->app_id = app_id; 131 p_buf->p_app_data_cback = p_data_cback; 132 bta_sys_sendmsg(p_buf); 133 } 134} 135 136/******************************************************************************* 137** 138** Function BTA_AvDeregister 139** 140** Description Deregister the audio or video service 141** 142** Returns void 143** 144*******************************************************************************/ 145void BTA_AvDeregister(tBTA_AV_HNDL hndl) 146{ 147 BT_HDR *p_buf; 148 149 if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL) 150 { 151 p_buf->layer_specific = hndl; 152 p_buf->event = BTA_AV_API_DEREGISTER_EVT; 153 bta_sys_sendmsg(p_buf); 154 } 155} 156 157/******************************************************************************* 158** 159** Function BTA_AvOpen 160** 161** Description Opens an advanced audio/video connection to a peer device. 162** When connection is open callback function is called 163** with a BTA_AV_OPEN_EVT. 164** 165** Returns void 166** 167*******************************************************************************/ 168void BTA_AvOpen(BD_ADDR bd_addr, tBTA_AV_HNDL handle, BOOLEAN use_rc, tBTA_SEC sec_mask, 169 UINT16 uuid) 170{ 171 tBTA_AV_API_OPEN *p_buf; 172 173 if ((p_buf = (tBTA_AV_API_OPEN *) GKI_getbuf(sizeof(tBTA_AV_API_OPEN))) != NULL) 174 { 175 p_buf->hdr.event = BTA_AV_API_OPEN_EVT; 176 p_buf->hdr.layer_specific = handle; 177 bdcpy(p_buf->bd_addr, bd_addr); 178 p_buf->use_rc = use_rc; 179 p_buf->sec_mask = sec_mask; 180 p_buf->switch_res = BTA_AV_RS_NONE; 181 p_buf->uuid = uuid; 182 bta_sys_sendmsg(p_buf); 183 } 184} 185 186/******************************************************************************* 187** 188** Function BTA_AvClose 189** 190** Description Close the current streams. 191** 192** Returns void 193** 194*******************************************************************************/ 195void BTA_AvClose(tBTA_AV_HNDL handle) 196{ 197 BT_HDR *p_buf; 198 199 if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL) 200 { 201 p_buf->event = BTA_AV_API_CLOSE_EVT; 202 p_buf->layer_specific = handle; 203 bta_sys_sendmsg(p_buf); 204 } 205} 206 207/******************************************************************************* 208** 209** Function BTA_AvDisconnect 210** 211** Description Close the connection to the address. 212** 213** Returns void 214** 215*******************************************************************************/ 216void BTA_AvDisconnect(BD_ADDR bd_addr) 217{ 218 tBTA_AV_API_DISCNT *p_buf; 219 220 if ((p_buf = (tBTA_AV_API_DISCNT *) GKI_getbuf(sizeof(tBTA_AV_API_DISCNT))) != NULL) 221 { 222 p_buf->hdr.event = BTA_AV_API_DISCONNECT_EVT; 223 bdcpy(p_buf->bd_addr, bd_addr); 224 bta_sys_sendmsg(p_buf); 225 } 226} 227 228/******************************************************************************* 229** 230** Function BTA_AvStart 231** 232** Description Start audio/video stream data transfer. 233** 234** Returns void 235** 236*******************************************************************************/ 237void BTA_AvStart(void) 238{ 239 BT_HDR *p_buf; 240 241 if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL) 242 { 243 p_buf->event = BTA_AV_API_START_EVT; 244 bta_sys_sendmsg(p_buf); 245 } 246} 247 248/******************************************************************************* 249** 250** Function BTA_AvEnable_Sink 251** 252** Description Enable/Disable A2DP Sink.. 253** 254** Returns void 255** 256*******************************************************************************/ 257void BTA_AvEnable_Sink(int enable) 258{ 259#if (BTA_AV_SINK_INCLUDED == TRUE) 260 BT_HDR *p_buf; 261 if ((p_buf = (BT_HDR *) GKI_getbuf(sizeof(BT_HDR))) != NULL) 262 { 263 p_buf->event = BTA_AV_API_SINK_ENABLE_EVT; 264 p_buf->layer_specific = enable; 265 bta_sys_sendmsg(p_buf); 266 } 267#else 268 return; 269#endif 270} 271 272/******************************************************************************* 273** 274** Function BTA_AvStop 275** 276** Description Stop audio/video stream data transfer. 277** If suspend is TRUE, this function sends AVDT suspend signal 278** to the connected peer(s). 279** 280** Returns void 281** 282*******************************************************************************/ 283void BTA_AvStop(BOOLEAN suspend) 284{ 285 tBTA_AV_API_STOP *p_buf; 286 287 if ((p_buf = (tBTA_AV_API_STOP *) GKI_getbuf(sizeof(tBTA_AV_API_STOP))) != NULL) 288 { 289 p_buf->hdr.event = BTA_AV_API_STOP_EVT; 290 p_buf->flush = TRUE; 291 p_buf->suspend = suspend; 292 bta_sys_sendmsg(p_buf); 293 } 294} 295 296/******************************************************************************* 297** 298** Function BTA_AvReconfig 299** 300** Description Reconfigure the audio/video stream. 301** If suspend is TRUE, this function tries the suspend/reconfigure 302** procedure first. 303** If suspend is FALSE or when suspend/reconfigure fails, 304** this function closes and re-opens the AVDT connection. 305** 306** Returns void 307** 308*******************************************************************************/ 309void BTA_AvReconfig(tBTA_AV_HNDL hndl, BOOLEAN suspend, UINT8 sep_info_idx, 310 UINT8 *p_codec_info, UINT8 num_protect, UINT8 *p_protect_info) 311{ 312 tBTA_AV_API_RCFG *p_buf; 313 314 if ((p_buf = (tBTA_AV_API_RCFG *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_RCFG) + num_protect))) != NULL) 315 { 316 p_buf->hdr.layer_specific = hndl; 317 p_buf->hdr.event = BTA_AV_API_RECONFIG_EVT; 318 p_buf->num_protect = num_protect; 319 p_buf->suspend = suspend; 320 p_buf->sep_info_idx = sep_info_idx; 321 p_buf->p_protect_info = (UINT8 *)(p_buf + 1); 322 memcpy(p_buf->codec_info, p_codec_info, AVDT_CODEC_SIZE); 323 memcpy(p_buf->p_protect_info, p_protect_info, num_protect); 324 bta_sys_sendmsg(p_buf); 325 } 326} 327 328/******************************************************************************* 329** 330** Function BTA_AvProtectReq 331** 332** Description Send a content protection request. This function can only 333** be used if AV is enabled with feature BTA_AV_FEAT_PROTECT. 334** 335** Returns void 336** 337*******************************************************************************/ 338void BTA_AvProtectReq(tBTA_AV_HNDL hndl, UINT8 *p_data, UINT16 len) 339{ 340 tBTA_AV_API_PROTECT_REQ *p_buf; 341 342 if ((p_buf = (tBTA_AV_API_PROTECT_REQ *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_PROTECT_REQ) + len))) != NULL) 343 { 344 p_buf->hdr.layer_specific = hndl; 345 p_buf->hdr.event = BTA_AV_API_PROTECT_REQ_EVT; 346 p_buf->len = len; 347 if (p_data == NULL) 348 { 349 p_buf->p_data = NULL; 350 } 351 else 352 { 353 p_buf->p_data = (UINT8 *) (p_buf + 1); 354 memcpy(p_buf->p_data, p_data, len); 355 } 356 bta_sys_sendmsg(p_buf); 357 } 358} 359 360/******************************************************************************* 361** 362** Function BTA_AvProtectRsp 363** 364** Description Send a content protection response. This function must 365** be called if a BTA_AV_PROTECT_REQ_EVT is received. 366** This function can only be used if AV is enabled with 367** feature BTA_AV_FEAT_PROTECT. 368** 369** Returns void 370** 371*******************************************************************************/ 372void BTA_AvProtectRsp(tBTA_AV_HNDL hndl, UINT8 error_code, UINT8 *p_data, UINT16 len) 373{ 374 tBTA_AV_API_PROTECT_RSP *p_buf; 375 376 if ((p_buf = (tBTA_AV_API_PROTECT_RSP *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_PROTECT_RSP) + len))) != NULL) 377 { 378 p_buf->hdr.layer_specific = hndl; 379 p_buf->hdr.event = BTA_AV_API_PROTECT_RSP_EVT; 380 p_buf->len = len; 381 p_buf->error_code = error_code; 382 if (p_data == NULL) 383 { 384 p_buf->p_data = NULL; 385 } 386 else 387 { 388 p_buf->p_data = (UINT8 *) (p_buf + 1); 389 memcpy(p_buf->p_data, p_data, len); 390 } 391 bta_sys_sendmsg(p_buf); 392 } 393} 394 395/******************************************************************************* 396** 397** Function BTA_AvRemoteCmd 398** 399** Description Send a remote control command. This function can only 400** be used if AV is enabled with feature BTA_AV_FEAT_RCCT. 401** 402** Returns void 403** 404*******************************************************************************/ 405void BTA_AvRemoteCmd(UINT8 rc_handle, UINT8 label, tBTA_AV_RC rc_id, tBTA_AV_STATE key_state) 406{ 407 tBTA_AV_API_REMOTE_CMD *p_buf; 408 409 if ((p_buf = (tBTA_AV_API_REMOTE_CMD *) GKI_getbuf(sizeof(tBTA_AV_API_REMOTE_CMD))) != NULL) 410 { 411 p_buf->hdr.event = BTA_AV_API_REMOTE_CMD_EVT; 412 p_buf->hdr.layer_specific = rc_handle; 413 p_buf->msg.op_id = rc_id; 414 p_buf->msg.state = key_state; 415 p_buf->msg.p_pass_data = NULL; 416 p_buf->msg.pass_len = 0; 417 p_buf->label = label; 418 bta_sys_sendmsg(p_buf); 419 } 420} 421 422/******************************************************************************* 423** 424** Function BTA_AvVendorCmd 425** 426** Description Send a vendor dependent remote control command. This 427** function can only be used if AV is enabled with feature 428** BTA_AV_FEAT_VENDOR. 429** 430** Returns void 431** 432*******************************************************************************/ 433void BTA_AvVendorCmd(UINT8 rc_handle, UINT8 label, tBTA_AV_CODE cmd_code, UINT8 *p_data, UINT16 len) 434{ 435 tBTA_AV_API_VENDOR *p_buf; 436 437 if ((p_buf = (tBTA_AV_API_VENDOR *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_VENDOR) + len))) != NULL) 438 { 439 p_buf->hdr.event = BTA_AV_API_VENDOR_CMD_EVT; 440 p_buf->hdr.layer_specific = rc_handle; 441 p_buf->msg.hdr.ctype = cmd_code; 442 p_buf->msg.hdr.subunit_type = AVRC_SUB_PANEL; 443 p_buf->msg.hdr.subunit_id = 0; 444 p_buf->msg.company_id = p_bta_av_cfg->company_id; 445 p_buf->label = label; 446 p_buf->msg.vendor_len = len; 447 if (p_data == NULL) 448 { 449 p_buf->msg.p_vendor_data = NULL; 450 } 451 else 452 { 453 p_buf->msg.p_vendor_data = (UINT8 *) (p_buf + 1); 454 memcpy(p_buf->msg.p_vendor_data, p_data, len); 455 } 456 bta_sys_sendmsg(p_buf); 457 } 458} 459 460/******************************************************************************* 461** 462** Function BTA_AvVendorRsp 463** 464** Description Send a vendor dependent remote control response. 465** This function must be called if a BTA_AV_VENDOR_CMD_EVT 466** is received. This function can only be used if AV is 467** enabled with feature BTA_AV_FEAT_VENDOR. 468** 469** Returns void 470** 471*******************************************************************************/ 472void BTA_AvVendorRsp(UINT8 rc_handle, UINT8 label, tBTA_AV_CODE rsp_code, UINT8 *p_data, UINT16 len, UINT32 company_id) 473{ 474 tBTA_AV_API_VENDOR *p_buf; 475 476 if ((p_buf = (tBTA_AV_API_VENDOR *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_VENDOR) + len))) != NULL) 477 { 478 p_buf->hdr.event = BTA_AV_API_VENDOR_RSP_EVT; 479 p_buf->hdr.layer_specific = rc_handle; 480 p_buf->msg.hdr.ctype = rsp_code; 481 p_buf->msg.hdr.subunit_type = AVRC_SUB_PANEL; 482 p_buf->msg.hdr.subunit_id = 0; 483 if(company_id) 484 p_buf->msg.company_id = company_id; 485 else 486 p_buf->msg.company_id = p_bta_av_cfg->company_id; 487 p_buf->label = label; 488 p_buf->msg.vendor_len = len; 489 if (p_data == NULL) 490 { 491 p_buf->msg.p_vendor_data = NULL; 492 } 493 else 494 { 495 p_buf->msg.p_vendor_data = (UINT8 *) (p_buf + 1); 496 memcpy(p_buf->msg.p_vendor_data, p_data, len); 497 } 498 bta_sys_sendmsg(p_buf); 499 } 500} 501 502/******************************************************************************* 503** 504** Function BTA_AvOpenRc 505** 506** Description Open an AVRCP connection toward the device with the 507** specified handle 508** 509** Returns void 510** 511*******************************************************************************/ 512void BTA_AvOpenRc(tBTA_AV_HNDL handle) 513{ 514 tBTA_AV_API_OPEN_RC *p_buf; 515 516 if ((p_buf = (tBTA_AV_API_OPEN_RC *) GKI_getbuf(sizeof(tBTA_AV_API_OPEN_RC))) != NULL) 517 { 518 p_buf->hdr.event = BTA_AV_API_RC_OPEN_EVT; 519 p_buf->hdr.layer_specific = handle; 520 bta_sys_sendmsg(p_buf); 521 } 522} 523 524/******************************************************************************* 525** 526** Function BTA_AvCloseRc 527** 528** Description Close an AVRCP connection 529** 530** Returns void 531** 532*******************************************************************************/ 533void BTA_AvCloseRc(UINT8 rc_handle) 534{ 535 tBTA_AV_API_CLOSE_RC *p_buf; 536 537 if ((p_buf = (tBTA_AV_API_CLOSE_RC *) GKI_getbuf(sizeof(tBTA_AV_API_CLOSE_RC))) != NULL) 538 { 539 p_buf->hdr.event = BTA_AV_API_RC_CLOSE_EVT; 540 p_buf->hdr.layer_specific = rc_handle; 541 bta_sys_sendmsg(p_buf); 542 } 543} 544 545/******************************************************************************* 546** 547** Function BTA_AvMetaRsp 548** 549** Description Send a Metadata/Advanced Control response. The message contained 550** in p_pkt can be composed with AVRC utility functions. 551** This function can only be used if AV is enabled with feature 552** BTA_AV_FEAT_METADATA. 553** 554** Returns void 555** 556*******************************************************************************/ 557void BTA_AvMetaRsp(UINT8 rc_handle, UINT8 label, tBTA_AV_CODE rsp_code, 558 BT_HDR *p_pkt) 559{ 560 tBTA_AV_API_META_RSP *p_buf; 561 562 if ((p_buf = (tBTA_AV_API_META_RSP *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_META_RSP)))) != NULL) 563 { 564 p_buf->hdr.event = BTA_AV_API_META_RSP_EVT; 565 p_buf->hdr.layer_specific = rc_handle; 566 p_buf->rsp_code = rsp_code; 567 p_buf->p_pkt = p_pkt; 568 p_buf->is_rsp = TRUE; 569 p_buf->label = label; 570 571 bta_sys_sendmsg(p_buf); 572 } else if (p_pkt) { 573 GKI_freebuf(p_pkt); 574 } 575} 576 577/******************************************************************************* 578** 579** Function BTA_AvMetaCmd 580** 581** Description Send a Metadata/Advanced Control command. The message contained 582** in p_pkt can be composed with AVRC utility functions. 583** This function can only be used if AV is enabled with feature 584** BTA_AV_FEAT_METADATA. 585** This message is sent only when the peer supports the TG role. 586*8 The only command makes sense right now is the absolute volume command. 587** 588** Returns void 589** 590*******************************************************************************/ 591void BTA_AvMetaCmd(UINT8 rc_handle, UINT8 label, tBTA_AV_CMD cmd_code, BT_HDR *p_pkt) 592{ 593 tBTA_AV_API_META_RSP *p_buf; 594 595 if ((p_buf = (tBTA_AV_API_META_RSP *) GKI_getbuf((UINT16) (sizeof(tBTA_AV_API_META_RSP)))) != NULL) 596 { 597 p_buf->hdr.event = BTA_AV_API_META_RSP_EVT; 598 p_buf->hdr.layer_specific = rc_handle; 599 p_buf->p_pkt = p_pkt; 600 p_buf->rsp_code = cmd_code; 601 p_buf->is_rsp = FALSE; 602 p_buf->label = label; 603 604 bta_sys_sendmsg(p_buf); 605 } 606} 607 608#endif /* BTA_AV_INCLUDED */ 609