2016-09-26 09:37:39 -04:00
|
|
|
/******************************************************************************
|
|
|
|
|
*
|
|
|
|
|
* Copyright (C) 2006-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.
|
|
|
|
|
*
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
*
|
|
|
|
|
* nterface to AVRCP Application Programming Interface
|
|
|
|
|
*
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
#ifndef AVRC_API_H
|
|
|
|
|
#define AVRC_API_H
|
|
|
|
|
#include "bt_target.h"
|
|
|
|
|
#include "avct_api.h"
|
|
|
|
|
#include "sdp_api.h"
|
|
|
|
|
#include "avrc_defs.h"
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
** constants
|
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/* API function return value result codes. */
|
|
|
|
|
#define AVRC_SUCCESS AVCT_SUCCESS /* 0 Function successful */
|
|
|
|
|
#define AVRC_NO_RESOURCES AVCT_NO_RESOURCES /* 1 Not enough resources */
|
|
|
|
|
#define AVRC_BAD_HANDLE AVCT_BAD_HANDLE /* 2 Bad handle */
|
|
|
|
|
#define AVRC_PID_IN_USE AVCT_PID_IN_USE /* 3 PID already in use */
|
|
|
|
|
#define AVRC_NOT_OPEN AVCT_NOT_OPEN /* 4 Connection not open */
|
|
|
|
|
#define AVRC_MSG_TOO_BIG 5 /* 5 the message length exceed the MTU of the browsing channel */
|
|
|
|
|
#define AVRC_FAIL 0x10 /* 0x10 generic failure */
|
|
|
|
|
#define AVRC_BAD_PARAM 0x11 /* 0x11 bad parameter */
|
|
|
|
|
|
|
|
|
|
/* Control role - same as AVCT_TARGET/AVCT_CONTROL */
|
|
|
|
|
#define AVRC_CT_TARGET 1 /* target */
|
|
|
|
|
#define AVRC_CT_CONTROL 2 /* controller */
|
|
|
|
|
#define AVRC_CT_PASSIVE 4 /* If conflict, allow the other side to succeed */
|
|
|
|
|
|
|
|
|
|
/* Connection role */
|
|
|
|
|
#define AVRC_CONN_INT AVCT_INT /* initiator */
|
|
|
|
|
#define AVRC_CONN_ACP AVCT_ACP /* Acceptor */
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* AVRC CTRL events */
|
|
|
|
|
/* AVRC_OPEN_IND_EVT event is sent when the connection is successfully opened.
|
|
|
|
|
* This eventis sent in response to an AVRC_Open(). */
|
|
|
|
|
#define AVRC_OPEN_IND_EVT 0
|
|
|
|
|
|
|
|
|
|
/* AVRC_CLOSE_IND_EVT event is sent when a connection is closed.
|
|
|
|
|
* This event can result from a call to AVRC_Close() or when the peer closes
|
|
|
|
|
* the connection. It is also sent when a connection attempted through
|
|
|
|
|
* AVRC_Open() fails. */
|
|
|
|
|
#define AVRC_CLOSE_IND_EVT 1
|
|
|
|
|
|
|
|
|
|
/* AVRC_CONG_IND_EVT event indicates that AVCTP is congested and cannot send
|
|
|
|
|
* any more messages. */
|
|
|
|
|
#define AVRC_CONG_IND_EVT 2
|
|
|
|
|
|
|
|
|
|
/* AVRC_UNCONG_IND_EVT event indicates that AVCTP is uncongested and ready to
|
|
|
|
|
* send messages. */
|
|
|
|
|
#define AVRC_UNCONG_IND_EVT 3
|
|
|
|
|
|
2016-11-24 13:10:15 -05:00
|
|
|
/* AVRC_BROWSE_OPEN_IND_EVT event is sent when the browse channel is successfully opened.
|
|
|
|
|
* This eventis sent in response to an AVRC_Open() or AVRC_OpenBrowse() . */
|
2016-09-26 09:37:39 -04:00
|
|
|
#define AVRC_BROWSE_OPEN_IND_EVT 4
|
|
|
|
|
|
|
|
|
|
/* AVRC_BROWSE_CLOSE_IND_EVT event is sent when a browse channel is closed.
|
|
|
|
|
* This event can result from a call to AVRC_Close(), AVRC_CloseBrowse() or when the peer closes
|
|
|
|
|
* the connection. It is also sent when a connection attempted through
|
|
|
|
|
* AVRC_OpenBrowse() fails. */
|
|
|
|
|
#define AVRC_BROWSE_CLOSE_IND_EVT 5
|
|
|
|
|
|
|
|
|
|
/* AVRC_BROWSE_CONG_IND_EVT event indicates that AVCTP browse channel is congested and cannot send
|
|
|
|
|
* any more messages. */
|
|
|
|
|
#define AVRC_BROWSE_CONG_IND_EVT 6
|
|
|
|
|
|
|
|
|
|
/* AVRC_BROWSE_UNCONG_IND_EVT event indicates that AVCTP browse channel is uncongested and ready to
|
|
|
|
|
* send messages. */
|
|
|
|
|
#define AVRC_BROWSE_UNCONG_IND_EVT 7
|
|
|
|
|
|
|
|
|
|
/* AVRC_CMD_TIMEOUT_EVT event indicates timeout waiting for AVRC command response from the peer */
|
|
|
|
|
#define AVRC_CMD_TIMEOUT_EVT 8
|
|
|
|
|
|
|
|
|
|
/* Supported categories */
|
|
|
|
|
#define AVRC_SUPF_CT_CAT1 0x0001 /* Category 1 */
|
|
|
|
|
#define AVRC_SUPF_CT_CAT2 0x0002 /* Category 2 */
|
|
|
|
|
#define AVRC_SUPF_CT_CAT3 0x0004 /* Category 3 */
|
|
|
|
|
#define AVRC_SUPF_CT_CAT4 0x0008 /* Category 4 */
|
|
|
|
|
#define AVRC_SUPF_CT_BROWSE 0x0040 /* Browsing */
|
|
|
|
|
|
|
|
|
|
#define AVRC_SUPF_TG_CAT1 0x0001 /* Category 1 */
|
|
|
|
|
#define AVRC_SUPF_TG_CAT2 0x0002 /* Category 2 */
|
|
|
|
|
#define AVRC_SUPF_TG_CAT3 0x0004 /* Category 3 */
|
|
|
|
|
#define AVRC_SUPF_TG_CAT4 0x0008 /* Category 4 */
|
|
|
|
|
#define AVRC_SUPF_TG_APP_SETTINGS 0x0010 /* Player Application Settings */
|
|
|
|
|
#define AVRC_SUPF_TG_GROUP_NAVI 0x0020 /* Group Navigation */
|
|
|
|
|
#define AVRC_SUPF_TG_BROWSE 0x0040 /* Browsing */
|
|
|
|
|
#define AVRC_SUPF_TG_MULTI_PLAYER 0x0080 /* Muliple Media Player */
|
|
|
|
|
|
|
|
|
|
#define AVRC_META_SUCCESS AVRC_SUCCESS
|
|
|
|
|
#define AVRC_META_FAIL AVRC_FAIL
|
|
|
|
|
#define AVRC_METADATA_CMD 0x0000
|
|
|
|
|
#define AVRC_METADATA_RESP 0x0001
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
** data type definitions
|
|
|
|
|
*****************************************************************************/
|
|
|
|
|
|
|
|
|
|
/* This data type is used in AVRC_FindService() to initialize the SDP database
|
|
|
|
|
* to hold the result service search. */
|
2016-11-24 13:10:15 -05:00
|
|
|
typedef struct {
|
2016-09-26 09:37:39 -04:00
|
|
|
UINT32 db_len; /* Length, in bytes, of the discovery database */
|
|
|
|
|
tSDP_DISCOVERY_DB *p_db; /* Pointer to the discovery database */
|
|
|
|
|
UINT16 num_attr;/* The number of attributes in p_attrs */
|
|
|
|
|
UINT16 *p_attrs; /* The attributes filter. If NULL, AVRCP API sets the attribute filter
|
|
|
|
|
* to be ATTR_ID_SERVICE_CLASS_ID_LIST, ATTR_ID_BT_PROFILE_DESC_LIST,
|
|
|
|
|
* ATTR_ID_SUPPORTED_FEATURES, ATTR_ID_SERVICE_NAME and ATTR_ID_PROVIDER_NAME.
|
|
|
|
|
* If not NULL, the input is taken as the filter. */
|
|
|
|
|
} tAVRC_SDP_DB_PARAMS;
|
|
|
|
|
|
|
|
|
|
/* This callback function returns service discovery information to the
|
|
|
|
|
* application after the AVRC_FindService() API function is called. The
|
|
|
|
|
* implementation of this callback function must copy the p_service_name
|
|
|
|
|
* and p_provider_name parameters passed to it as they are not guaranteed
|
|
|
|
|
* to remain after the callback function exits. */
|
|
|
|
|
typedef void (tAVRC_FIND_CBACK) (UINT16 status);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/* This is the control callback function. This function passes events
|
|
|
|
|
* listed in Table 20 to the application. */
|
|
|
|
|
typedef void (tAVRC_CTRL_CBACK) (UINT8 handle, UINT8 event, UINT16 result,
|
2016-11-24 13:10:15 -05:00
|
|
|
BD_ADDR peer_addr);
|
2016-09-26 09:37:39 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
/* This is the message callback function. It is executed when AVCTP has
|
|
|
|
|
* a message packet ready for the application. The implementation of this
|
|
|
|
|
* callback function must copy the tAVRC_MSG structure passed to it as it
|
|
|
|
|
* is not guaranteed to remain after the callback function exits. */
|
|
|
|
|
typedef void (tAVRC_MSG_CBACK) (UINT8 handle, UINT8 label, UINT8 opcode,
|
2016-11-24 13:10:15 -05:00
|
|
|
tAVRC_MSG *p_msg);
|
2016-09-26 09:37:39 -04:00
|
|
|
|
2016-11-24 13:10:15 -05:00
|
|
|
typedef struct {
|
2016-09-26 09:37:39 -04:00
|
|
|
tAVRC_CTRL_CBACK *p_ctrl_cback; /* pointer to application control callback */
|
|
|
|
|
tAVRC_MSG_CBACK *p_msg_cback; /* pointer to application message callback */
|
|
|
|
|
UINT32 company_id; /* the company ID */
|
|
|
|
|
UINT8 conn; /* Connection role (Initiator/acceptor) */
|
|
|
|
|
UINT8 control; /* Control role (Control/Target) */
|
|
|
|
|
} tAVRC_CONN_CB;
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*****************************************************************************
|
|
|
|
|
** external function declarations
|
|
|
|
|
*****************************************************************************/
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
extern "C"
|
|
|
|
|
{
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_AddRecord
|
|
|
|
|
**
|
|
|
|
|
** Description This function is called to build an AVRCP SDP record.
|
|
|
|
|
** Prior to calling this function the application must
|
|
|
|
|
** call SDP_CreateRecord() to create an SDP record.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** service_uuid: Indicates TG(UUID_SERVCLASS_AV_REM_CTRL_TARGET)
|
|
|
|
|
** or CT(UUID_SERVCLASS_AV_REMOTE_CONTROL)
|
|
|
|
|
**
|
|
|
|
|
** p_service_name: Pointer to a null-terminated character
|
|
|
|
|
** string containing the service name.
|
|
|
|
|
** If service name is not used set this to NULL.
|
|
|
|
|
**
|
|
|
|
|
** p_provider_name: Pointer to a null-terminated character
|
|
|
|
|
** string containing the provider name.
|
|
|
|
|
** If provider name is not used set this to NULL.
|
|
|
|
|
**
|
|
|
|
|
** categories: Supported categories.
|
|
|
|
|
**
|
|
|
|
|
** sdp_handle: SDP handle returned by SDP_CreateRecord().
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_NO_RESOURCES if not enough resources to build the SDP record.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_AddRecord(UINT16 service_uuid, char *p_service_name,
|
2016-11-24 13:10:15 -05:00
|
|
|
char *p_provider_name, UINT16 categories, UINT32 sdp_handle);
|
2016-09-26 09:37:39 -04:00
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_FindService
|
|
|
|
|
**
|
|
|
|
|
** Description This function is called by the application to perform service
|
|
|
|
|
** discovery and retrieve AVRCP SDP record information from a
|
|
|
|
|
** peer device. Information is returned for the first service
|
|
|
|
|
** record found on the server that matches the service UUID.
|
|
|
|
|
** The callback function will be executed when service discovery
|
|
|
|
|
** is complete. There can only be one outstanding call to
|
|
|
|
|
** AVRC_FindService() at a time; the application must wait for
|
|
|
|
|
** the callback before it makes another call to the function.
|
|
|
|
|
** The application is responsible for allocating memory for the
|
|
|
|
|
** discovery database. It is recommended that the size of the
|
|
|
|
|
** discovery database be at least 300 bytes. The application
|
|
|
|
|
** can deallocate the memory after the callback function has
|
|
|
|
|
** executed.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** service_uuid: Indicates TG(UUID_SERVCLASS_AV_REM_CTRL_TARGET)
|
|
|
|
|
** or CT(UUID_SERVCLASS_AV_REMOTE_CONTROL)
|
|
|
|
|
**
|
|
|
|
|
** bd_addr: BD address of the peer device.
|
|
|
|
|
**
|
|
|
|
|
** p_db: SDP discovery database parameters.
|
|
|
|
|
**
|
|
|
|
|
** p_cback: Pointer to the callback function.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_PARAMS if discovery database parameters are invalid.
|
|
|
|
|
** AVRC_NO_RESOURCES if there are not enough resources to
|
|
|
|
|
** perform the service search.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_FindService(UINT16 service_uuid, BD_ADDR bd_addr,
|
|
|
|
|
tAVRC_SDP_DB_PARAMS *p_db, tAVRC_FIND_CBACK *p_cback);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_Open
|
|
|
|
|
**
|
|
|
|
|
** Description This function is called to open a connection to AVCTP.
|
|
|
|
|
** The connection can be either an initiator or acceptor, as
|
|
|
|
|
** determined by the p_ccb->stream parameter.
|
|
|
|
|
** The connection can be a target, a controller or for both role,
|
|
|
|
|
** as determined by the p_ccb->control parameter.
|
|
|
|
|
** By definition, a target connection is an acceptor connection
|
|
|
|
|
** that waits for an incoming AVCTP connection from the peer.
|
|
|
|
|
** The connection remains available to the application until
|
|
|
|
|
** the application closes it by calling AVRC_Close(). The
|
|
|
|
|
** application does not need to reopen the connection after an
|
|
|
|
|
** AVRC_CLOSE_IND_EVT is received.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** p_ccb->company_id: Company Identifier.
|
|
|
|
|
**
|
|
|
|
|
** p_ccb->p_ctrl_cback: Pointer to control callback function.
|
|
|
|
|
**
|
|
|
|
|
** p_ccb->p_msg_cback: Pointer to message callback function.
|
|
|
|
|
**
|
|
|
|
|
** p_ccb->conn: AVCTP connection role. This is set to
|
|
|
|
|
** AVCTP_INT for initiator connections and AVCTP_ACP
|
|
|
|
|
** for acceptor connections.
|
|
|
|
|
**
|
|
|
|
|
** p_ccb->control: Control role. This is set to
|
|
|
|
|
** AVRC_CT_TARGET for target connections, AVRC_CT_CONTROL
|
|
|
|
|
** for control connections or (AVRC_CT_TARGET|AVRC_CT_CONTROL)
|
|
|
|
|
** for connections that support both roles.
|
|
|
|
|
**
|
|
|
|
|
** peer_addr: BD address of peer device. This value is
|
|
|
|
|
** only used for initiator connections; for acceptor
|
|
|
|
|
** connections it can be set to NULL.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** p_handle: Pointer to handle. This parameter is only
|
|
|
|
|
** valid if AVRC_SUCCESS is returned.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_NO_RESOURCES if there are not enough resources to open
|
|
|
|
|
** the connection.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_Open(UINT8 *p_handle, tAVRC_CONN_CB *p_ccb,
|
|
|
|
|
BD_ADDR_PTR peer_addr);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_Close
|
|
|
|
|
**
|
|
|
|
|
** Description Close a connection opened with AVRC_Open().
|
|
|
|
|
** This function is called when the
|
|
|
|
|
** application is no longer using a connection.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_Close(UINT8 handle);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_OpenBrowse
|
|
|
|
|
**
|
|
|
|
|
** Description This function is called to open a browsing connection to AVCTP.
|
|
|
|
|
** The connection can be either an initiator or acceptor, as
|
|
|
|
|
** determined by the conn_role.
|
|
|
|
|
** The handle is returned by a previous call to AVRC_Open.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_NO_RESOURCES if there are not enough resources to open
|
|
|
|
|
** the connection.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_OpenBrowse(UINT8 handle, UINT8 conn_role);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_CloseBrowse
|
|
|
|
|
**
|
|
|
|
|
** Description Close a connection opened with AVRC_OpenBrowse().
|
|
|
|
|
** This function is called when the
|
|
|
|
|
** application is no longer using a connection.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_CloseBrowse(UINT8 handle);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_MsgReq
|
|
|
|
|
**
|
|
|
|
|
** Description This function is used to send the AVRCP byte stream in p_pkt
|
|
|
|
|
** down to AVCTP.
|
|
|
|
|
**
|
|
|
|
|
** It is expected that p_pkt->offset is at least AVCT_MSG_OFFSET
|
|
|
|
|
** p_pkt->layer_specific is AVCT_DATA_CTRL or AVCT_DATA_BROWSE
|
|
|
|
|
** p_pkt->event is AVRC_OP_VENDOR, AVRC_OP_PASS_THRU or AVRC_OP_BROWSING
|
|
|
|
|
** The above BT_HDR settings are set by the AVRC_Bld* functions.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_MsgReq (UINT8 handle, UINT8 label, UINT8 ctype, BT_HDR *p_pkt);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_UnitCmd
|
|
|
|
|
**
|
|
|
|
|
** Description Send a UNIT INFO command to the peer device. This
|
|
|
|
|
** function can only be called for controller role connections.
|
|
|
|
|
** Any response message from the peer is passed back through
|
|
|
|
|
** the tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_UnitCmd(UINT8 handle, UINT8 label);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_SubCmd
|
|
|
|
|
**
|
|
|
|
|
** Description Send a SUBUNIT INFO command to the peer device. This
|
|
|
|
|
** function can only be called for controller role connections.
|
|
|
|
|
** Any response message from the peer is passed back through
|
|
|
|
|
** the tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label.
|
|
|
|
|
**
|
|
|
|
|
** page: Specifies which part of the subunit type table
|
|
|
|
|
** is requested. For AVRCP it is typically zero.
|
|
|
|
|
** Value range is 0-7.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_SubCmd(UINT8 handle, UINT8 label, UINT8 page);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_PassCmd
|
|
|
|
|
**
|
|
|
|
|
** Description Send a PASS THROUGH command to the peer device. This
|
|
|
|
|
** function can only be called for controller role connections.
|
|
|
|
|
** Any response message from the peer is passed back through
|
|
|
|
|
** the tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label.
|
|
|
|
|
**
|
|
|
|
|
** p_msg: Pointer to PASS THROUGH message structure.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_PassCmd(UINT8 handle, UINT8 label, tAVRC_MSG_PASS *p_msg);
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_PassRsp
|
|
|
|
|
**
|
|
|
|
|
** Description Send a PASS THROUGH response to the peer device. This
|
|
|
|
|
** function can only be called for target role connections.
|
|
|
|
|
** This function must be called when a PASS THROUGH command
|
|
|
|
|
** message is received from the peer through the
|
|
|
|
|
** tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label. Must be the same value as
|
|
|
|
|
** passed with the command message in the callback function.
|
|
|
|
|
**
|
|
|
|
|
** p_msg: Pointer to PASS THROUGH message structure.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_PassRsp(UINT8 handle, UINT8 label, tAVRC_MSG_PASS *p_msg);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_VendorCmd
|
|
|
|
|
**
|
|
|
|
|
** Description Send a VENDOR DEPENDENT command to the peer device. This
|
|
|
|
|
** function can only be called for controller role connections.
|
|
|
|
|
** Any response message from the peer is passed back through
|
|
|
|
|
** the tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label.
|
|
|
|
|
**
|
|
|
|
|
** p_msg: Pointer to VENDOR DEPENDENT message structure.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_VendorCmd(UINT8 handle, UINT8 label, tAVRC_MSG_VENDOR *p_msg);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_VendorRsp
|
|
|
|
|
**
|
|
|
|
|
** Description Send a VENDOR DEPENDENT response to the peer device. This
|
|
|
|
|
** function can only be called for target role connections.
|
|
|
|
|
** This function must be called when a VENDOR DEPENDENT
|
|
|
|
|
** command message is received from the peer through the
|
|
|
|
|
** tAVRC_MSG_CBACK callback function.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** handle: Handle of this connection.
|
|
|
|
|
**
|
|
|
|
|
** label: Transaction label. Must be the same value as
|
|
|
|
|
** passed with the command message in the callback function.
|
|
|
|
|
**
|
|
|
|
|
** p_msg: Pointer to VENDOR DEPENDENT message structure.
|
|
|
|
|
**
|
|
|
|
|
** Output Parameters:
|
|
|
|
|
** None.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_SUCCESS if successful.
|
|
|
|
|
** AVRC_BAD_HANDLE if handle is invalid.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT16 AVRC_VendorRsp(UINT8 handle, UINT8 label, tAVRC_MSG_VENDOR *p_msg);
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_SetTraceLevel
|
|
|
|
|
**
|
|
|
|
|
** Description Sets the trace level for AVRC. If 0xff is passed, the
|
|
|
|
|
** current trace level is returned.
|
|
|
|
|
**
|
|
|
|
|
** Input Parameters:
|
|
|
|
|
** new_level: The level to set the AVRC tracing to:
|
|
|
|
|
** 0xff-returns the current setting.
|
|
|
|
|
** 0-turns off tracing.
|
|
|
|
|
** >= 1-Errors.
|
|
|
|
|
** >= 2-Warnings.
|
|
|
|
|
** >= 3-APIs.
|
|
|
|
|
** >= 4-Events.
|
|
|
|
|
** >= 5-Debug.
|
|
|
|
|
**
|
|
|
|
|
** Returns The new trace level or current trace level if
|
|
|
|
|
** the input parameter is 0xff.
|
|
|
|
|
**
|
|
|
|
|
******************************************************************************/
|
|
|
|
|
extern UINT8 AVRC_SetTraceLevel (UINT8 new_level);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_Init
|
|
|
|
|
**
|
|
|
|
|
** Description This function is called at stack startup to allocate the
|
|
|
|
|
** control block (if using dynamic memory), and initializes the
|
|
|
|
|
** control block and tracing level.
|
|
|
|
|
**
|
|
|
|
|
** Returns void
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern void AVRC_Init(void);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_ParsCommand
|
|
|
|
|
**
|
|
|
|
|
** Description This function is used to parse the received command.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_STS_NO_ERROR, if the message in p_data is parsed successfully.
|
|
|
|
|
** Otherwise, the error code defined by AVRCP 1.4
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern tAVRC_STS AVRC_ParsCommand (tAVRC_MSG *p_msg, tAVRC_COMMAND *p_result,
|
|
|
|
|
UINT8 *p_buf, UINT16 buf_len);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_ParsResponse
|
|
|
|
|
**
|
|
|
|
|
** Description This function is used to parse the received response.
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_STS_NO_ERROR, if the message in p_data is parsed successfully.
|
|
|
|
|
** Otherwise, the error code defined by AVRCP 1.4
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern tAVRC_STS AVRC_ParsResponse (tAVRC_MSG *p_msg, tAVRC_RESPONSE *p_result,
|
|
|
|
|
UINT8 *p_buf, UINT16 buf_len);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_BldCommand
|
|
|
|
|
**
|
|
|
|
|
** Description This function builds the given AVRCP command to the given
|
|
|
|
|
** GKI buffer
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_STS_NO_ERROR, if the command is built successfully
|
|
|
|
|
** Otherwise, the error code.
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern tAVRC_STS AVRC_BldCommand( tAVRC_COMMAND *p_cmd, BT_HDR **pp_pkt);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_BldResponse
|
|
|
|
|
**
|
|
|
|
|
** Description This function builds the given AVRCP response to the given
|
|
|
|
|
** GKI buffer
|
|
|
|
|
**
|
|
|
|
|
** Returns AVRC_STS_NO_ERROR, if the response is built successfully
|
|
|
|
|
** Otherwise, the error code.
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern tAVRC_STS AVRC_BldResponse( UINT8 handle, tAVRC_RESPONSE *p_rsp, BT_HDR **pp_pkt);
|
|
|
|
|
|
|
|
|
|
/**************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_IsValidAvcType
|
|
|
|
|
**
|
|
|
|
|
** Description Check if correct AVC type is specified
|
|
|
|
|
**
|
|
|
|
|
** Returns returns TRUE if it is valid
|
|
|
|
|
**
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern BOOLEAN AVRC_IsValidAvcType(UINT8 pdu_id, UINT8 avc_type);
|
|
|
|
|
|
|
|
|
|
/*******************************************************************************
|
|
|
|
|
**
|
|
|
|
|
** Function AVRC_IsValidPlayerAttr
|
|
|
|
|
**
|
|
|
|
|
** Description Check if the given attrib value is a valid one
|
|
|
|
|
**
|
|
|
|
|
**
|
|
|
|
|
** Returns returns TRUE if it is valid
|
|
|
|
|
**
|
|
|
|
|
*******************************************************************************/
|
|
|
|
|
extern BOOLEAN AVRC_IsValidPlayerAttr(UINT8 attr);
|
|
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
|
}
|
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
#endif /* AVRC_API_H */
|
