1 /******************************************************************************
2  *
3  *  Copyright (C) 2003-2016 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  *  VRCP internal header file.
22  *
23  ******************************************************************************/
24 
25 #ifndef AVRC_INT_H
26 #define AVRC_INT_H
27 
28 #include "avct_defs.h"
29 #include "avrc_api.h"
30 #include "osi/include/alarm.h"
31 #include "osi/include/fixed_queue.h"
32 
33 /*      DEBUG FLAGS
34  *
35  * #define META_DEBUG_ENABLED
36  */
37 /*****************************************************************************
38  *  Constants
39  ****************************************************************************/
40 
41 /* Number of attributes in AVRC SDP record. */
42 #define AVRC_NUM_ATTR 6
43 
44 /* Number of protocol elements in protocol element list. */
45 #define AVRC_NUM_PROTO_ELEMS 2
46 
47 #ifndef AVRC_MIN_CMD_LEN
48 #define AVRC_MIN_CMD_LEN 20
49 #endif
50 
51 #define AVRC_UNIT_OPRND_BYTES 5
52 #define AVRC_SUB_OPRND_BYTES 4
53 #define AVRC_SUBRSP_OPRND_BYTES 3
54 #define AVRC_SUB_PAGE_MASK 7
55 #define AVRC_SUB_PAGE_SHIFT 4
56 #define AVRC_SUB_EXT_CODE 7
57 #define AVRC_PASS_OP_ID_MASK 0x7F
58 #define AVRC_PASS_STATE_MASK 0x80
59 #define AVRC_CMD_OPRND_PAD 0xFF
60 
61 #define AVRC_CTYPE_MASK 0x0F
62 #define AVRC_SUBTYPE_MASK 0xF8
63 #define AVRC_SUBTYPE_SHIFT 3
64 #define AVRC_SUBID_MASK 0x07
65 #define AVRC_SUBID_IGNORE 0x07
66 
67 #define AVRC_SINGLE_PARAM_SIZE 1
68 #define AVRC_METADATA_PKT_TYPE_MASK 0x03
69 #define AVRC_PASS_THOUGH_MSG_MASK \
70   0x80 /* MSB of msg_type indicates the PAS THROUGH msg */
71 #define AVRC_VENDOR_UNIQUE_MASK 0x70 /* vendor unique id */
72 
73 /* Company ID is 24-bit integer We can not use the macros in bt_types.h */
74 #define AVRC_CO_ID_TO_BE_STREAM(p, u32) \
75   {                                     \
76     *(p)++ = (uint8_t)((u32) >> 16);    \
77     *(p)++ = (uint8_t)((u32) >> 8);     \
78     *(p)++ = (uint8_t)(u32);            \
79   }
80 #define AVRC_BE_STREAM_TO_CO_ID(u32, p)                                   \
81   {                                                                       \
82     (u32) = (((uint32_t)(*((p) + 2))) + (((uint32_t)(*((p) + 1))) << 8) + \
83              (((uint32_t)(*(p))) << 16));                                 \
84     (p) += 3;                                                             \
85   }
86 
87 #define AVRC_AVC_HDR_SIZE 3 /* ctype, subunit*, opcode */
88 
89 #define AVRC_MIN_META_HDR_SIZE 4   /* pdu id(1), packet type(1), param len(2) */
90 #define AVRC_MIN_BROWSE_HDR_SIZE 3 /* pdu id(1), param len(2) */
91 
92 #define AVRC_VENDOR_HDR_SIZE 6 /* ctype, subunit*, opcode, CO_ID */
93 #define AVRC_MSG_VENDOR_OFFSET 23
94 #define AVRC_MIN_VENDOR_SIZE \
95   (AVRC_MSG_VENDOR_OFFSET + BT_HDR_SIZE + AVRC_MIN_META_HDR_SIZE)
96 
97 #define AVRC_PASS_THRU_SIZE 8
98 #define AVRC_MSG_PASS_THRU_OFFSET 25
99 #define AVRC_MIN_PASS_THRU_SIZE (AVRC_MSG_PASS_THRU_OFFSET + BT_HDR_SIZE + 4)
100 
101 #define AVRC_MIN_BROWSE_SIZE \
102   (AVCT_BROWSE_OFFSET + BT_HDR_SIZE + AVRC_MIN_BROWSE_HDR_SIZE)
103 
104 #define AVRC_CTRL_PKT_LEN(pf, pk) \
105   { (pf) = (uint8_t*)((pk) + 1) + (pk)->offset + 2; }
106 
107 #define AVRC_MAX_CTRL_DATA_LEN (AVRC_PACKET_LEN)
108 
109 /* Timeout for waiting for avrc command responses (in milliseconds) */
110 #ifndef AVRC_CMD_TOUT_MS
111 #define AVRC_CMD_TOUT_MS (2 * 1000)
112 #endif
113 
114 /* Flags for avrc_cb.ccb_int[].flags */
115 #define AVRC_CB_FLAGS_RSP_PENDING 0x01 /* Waiting for AVRC response */
116 
117 /*****************************************************************************
118  *  Type definitions
119  ****************************************************************************/
120 
121 #if (AVRC_METADATA_INCLUDED == TRUE)
122 /* type for Metadata fragmentation control block */
123 typedef struct {
124   BT_HDR* p_fmsg;    /* the fragmented message */
125   uint8_t frag_pdu;  /* the PDU ID for fragmentation */
126   bool frag_enabled; /* fragmentation flag */
127 } tAVRC_FRAG_CB;
128 
129 /* type for Metadata re-assembly control block */
130 typedef struct {
131   BT_HDR* p_rmsg;       /* the received message */
132   uint16_t rasm_offset; /* re-assembly flag, the offset of the start fragment */
133   uint8_t rasm_pdu;     /* the PDU ID for re-assembly */
134 } tAVRC_RASM_CB;
135 #endif
136 
137 /* AVRC internal connection control block */
138 typedef struct {
139   fixed_queue_t*
140       cmd_q;     /* Command queue for serializing vendor specific commands */
141   uint8_t flags; /* See AVRC_CB_FLAGS_* definitions */
142   alarm_t* tle;  /* Command timeout timer */
143 } tAVRC_CONN_INT_CB;
144 
145 typedef struct {
146   tAVRC_CONN_CB
147       ccb[AVCT_NUM_CONN]; /* Connection control block from AVRC_Open API */
148   tAVRC_CONN_INT_CB
149       ccb_int[AVCT_NUM_CONN]; /* Internal connection control block  */
150 #if (AVRC_METADATA_INCLUDED == TRUE)
151   tAVRC_FRAG_CB fcb[AVCT_NUM_CONN];
152   tAVRC_RASM_CB rcb[AVCT_NUM_CONN];
153 #endif
154   tAVRC_FIND_CBACK* p_cback; /* pointer to application callback */
155   tSDP_DISCOVERY_DB* p_db;   /* pointer to discovery database */
156   uint16_t service_uuid;     /* service UUID to search */
157   uint8_t trace_level;
158 } tAVRC_CB;
159 
160 /******************************************************************************
161  * Main Control Block
162  ******************************************************************************/
163 extern tAVRC_CB avrc_cb;
164 
165 extern bool avrc_is_valid_pdu_id(uint8_t pdu_id);
166 extern bool avrc_is_valid_player_attrib_value(uint8_t attrib, uint8_t value);
167 extern BT_HDR* avrc_alloc_ctrl_pkt(uint8_t pdu);
168 extern tAVRC_STS avrc_pars_pass_thru(tAVRC_MSG_PASS* p_msg,
169                                      uint16_t* p_vendor_unique_id);
170 extern uint8_t avrc_opcode_from_pdu(uint8_t pdu);
171 extern bool avrc_is_valid_opcode(uint8_t opcode);
172 extern void avrc_flush_cmd_q(uint8_t handle);
173 void avrc_start_cmd_timer(uint8_t handle, uint8_t label, uint8_t msg_mask);
174 void avrc_send_next_vendor_cmd(uint8_t handle);
175 
176 #endif /* AVRC_INT_H */
177