1 /******************************************************************************
2  *
3  *  Copyright 2002-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 contains constants definitions and other information from the AVDTP
22  *  specification.  This file is intended for use internal to AVDT only.
23  *
24  ******************************************************************************/
25 #ifndef AVDT_DEFS_H
26 #define AVDT_DEFS_H
27 
28 /*****************************************************************************
29  * constants
30  ****************************************************************************/
31 
32 /* signalling packet type */
33 #define AVDT_PKT_TYPE_SINGLE 0 /* single packet */
34 #define AVDT_PKT_TYPE_START 1  /* start packet */
35 #define AVDT_PKT_TYPE_CONT 2   /* continue packet */
36 #define AVDT_PKT_TYPE_END 3    /* end packet */
37 
38 /* signalling message type */
39 #define AVDT_MSG_TYPE_CMD 0 /* command */
40 #define AVDT_MSG_TYPE_GRJ 1 /* general reject */
41 #define AVDT_MSG_TYPE_RSP 2 /* response accept */
42 #define AVDT_MSG_TYPE_REJ 3 /* response reject */
43 
44 /* signalling messages */
45 #define AVDT_SIG_DISCOVER 1    /* discover */
46 #define AVDT_SIG_GETCAP 2      /* get capabilities */
47 #define AVDT_SIG_SETCONFIG 3   /* set configuration */
48 #define AVDT_SIG_GETCONFIG 4   /* get configuration */
49 #define AVDT_SIG_RECONFIG 5    /* reconfigure */
50 #define AVDT_SIG_OPEN 6        /* open */
51 #define AVDT_SIG_START 7       /* start */
52 #define AVDT_SIG_CLOSE 8       /* close */
53 #define AVDT_SIG_SUSPEND 9     /* suspend */
54 #define AVDT_SIG_ABORT 10      /* abort */
55 #define AVDT_SIG_SECURITY 11   /* security control */
56 #define AVDT_SIG_GET_ALLCAP 12 /* get all capabilities */
57 #define AVDT_SIG_DELAY_RPT 13  /* delay report */
58 
59 /* maximum signal value */
60 #define AVDT_SIG_MAX AVDT_SIG_DELAY_RPT
61 
62 /* used for general reject */
63 #define AVDT_SIG_NONE 0
64 
65 /* some maximum and minimum sizes of signalling messages */
66 #define AVDT_DISCOVER_REQ_MIN 1
67 #define AVDT_DISCOVER_REQ_MAX 124
68 
69 /* service category information element field values */
70 #define AVDT_CAT_TRANS 1     /* Media Transport */
71 #define AVDT_CAT_REPORT 2    /* Reporting */
72 #define AVDT_CAT_RECOV 3     /* Recovery */
73 #define AVDT_CAT_PROTECT 4   /* Content Protection */
74 #define AVDT_CAT_HDRCMP 5    /* Header Compression */
75 #define AVDT_CAT_MUX 6       /* Multiplexing */
76 #define AVDT_CAT_CODEC 7     /* Media Codec */
77 #define AVDT_CAT_DELAY_RPT 8 /* Delay Reporting */
78 #define AVDT_CAT_MAX_CUR AVDT_CAT_DELAY_RPT
79 
80 /* min/max lengths of service category information elements */
81 #define AVDT_LEN_TRANS_MIN 0
82 #define AVDT_LEN_REPORT_MIN 0
83 #define AVDT_LEN_RECOV_MIN 3
84 #define AVDT_LEN_PROTECT_MIN 2
85 #define AVDT_LEN_HDRCMP_MIN 1
86 #define AVDT_LEN_MUX_MIN 3
87 #define AVDT_LEN_CODEC_MIN 2
88 #define AVDT_LEN_DELAY_RPT_MIN 0
89 
90 #define AVDT_LEN_TRANS_MAX 0
91 #define AVDT_LEN_REPORT_MAX 0
92 #define AVDT_LEN_RECOV_MAX 3
93 #define AVDT_LEN_PROTECT_MAX 255
94 #define AVDT_LEN_HDRCMP_MAX 1
95 #define AVDT_LEN_MUX_MAX 7
96 #define AVDT_LEN_CODEC_MAX 255
97 #define AVDT_LEN_DELAY_RPT_MAX 0
98 
99 /* minimum possible size of configuration or capabilities data */
100 #define AVDT_LEN_CFG_MIN 2
101 
102 /* minimum and maximum lengths for different message types */
103 #define AVDT_LEN_SINGLE 1
104 #define AVDT_LEN_SETCONFIG_MIN 2
105 #define AVDT_LEN_RECONFIG_MIN 1
106 #define AVDT_LEN_MULTI_MIN 1
107 #define AVDT_LEN_SECURITY_MIN 1
108 #define AVDT_LEN_DELAY_RPT 3
109 
110 /* header lengths for different packet types */
111 #define AVDT_LEN_TYPE_SINGLE 2 /* single packet */
112 #define AVDT_LEN_TYPE_START 3  /* start packet */
113 #define AVDT_LEN_TYPE_CONT 1   /* continue packet */
114 #define AVDT_LEN_TYPE_END 1    /* end packet */
115 
116 /* length of general reject message */
117 #define AVDT_LEN_GEN_REJ 2
118 
119 /* recovery service capabilities information elements */
120 /* min value for maximum recovery window */
121 #define AVDT_RECOV_MRWS_MIN 0x01
122 /* max value for maximum recovery window */
123 #define AVDT_RECOV_MRWS_MAX 0x18
124 /* min value for maximum number of media packets */
125 #define AVDT_RECOV_MNMP_MIN 0x01
126 /* max value for maximum number of media packets */
127 #define AVDT_RECOV_MNMP_MAX 0x18
128 
129 /* SEID value range */
130 #define AVDT_SEID_MIN 0x01
131 #define AVDT_SEID_MAX 0x3E
132 
133 /* first byte of media packet header */
134 #define AVDT_MEDIA_OCTET1 0x80
135 
136 /* for adaptation layer header */
137 /* coding of length field */
138 #define AVDT_ALH_LCODE_MASK 0x03
139 /* No length field present. Take length from l2cap */
140 #define AVDT_ALH_LCODE_NONE 0x00
141 /* 16bit length field */
142 #define AVDT_ALH_LCODE_16BIT 0x01
143 /* 9 bit length field, MSB = 0, 8 LSBs in 1 octet following */
144 #define AVDT_ALH_LCODE_9BITM0 0x02
145 /* 9 bit length field, MSB = 1, 8 LSBs in 1 octet following */
146 #define AVDT_ALH_LCODE_9BITM1 0x03
147 
148 /* set this for continuation packet */
149 #define AVDT_ALH_FRAG_MASK 0x04
150 
151 /*****************************************************************************
152  * message parsing and building macros
153  ****************************************************************************/
154 
155 #define AVDT_MSG_PRS_HDR(p, lbl, pkt, msg) \
156   do {                                     \
157     (lbl) = (*(p) >> 4) & 0x0F;            \
158     (pkt) = (*(p) >> 2) & 0x03;            \
159     (msg) = *(p)++ & 0x03;                 \
160   } while (0)
161 
162 #define AVDT_MSG_PRS_DISC(p, seid, in_use, type, tsep) \
163   do {                                                 \
164     (seid) = *(p) >> 2;                                \
165     (in_use) = (*(p)++ >> 1) & 0x01;                   \
166     (type) = (*(p) >> 4) & 0x0F;                       \
167     (tsep) = (*(p)++ >> 3) & 0x01;                     \
168   } while (0)
169 
170 #define AVDT_MSG_PRS_SIG(p, sig) \
171   do {                           \
172     (sig) = (*(p)++) & 0x3F;     \
173   } while (0)
174 
175 #define AVDT_MSG_PRS_SEID(p, seid)   \
176   do {                               \
177     (seid) = ((*(p)++) >> 2) & 0x3F; \
178   } while (0)
179 
180 #define AVDT_MSG_PRS_PKT_TYPE(p, pkt) \
181   do {                                \
182     (pkt) = (*(p) >> 2) & 0x03;       \
183   } while (0)
184 
185 #define AVDT_MSG_PRS_OCTET1(p, o_v, o_p, o_x, o_cc) \
186   do {                                              \
187     (o_v) = (*(p) >> 6) & 0x02;                     \
188     (o_p) = (*(p) >> 5) & 0x01;                     \
189     (o_x) = (*(p) >> 4) & 0x01;                     \
190     (o_cc) = (*(p)++) & 0x0F;                       \
191   } while (0)
192 
193 #define AVDT_MSG_PRS_RPT_OCTET1(p, o_v, o_p, o_cc) \
194   do {                                             \
195     (o_v) = (*(p) >> 6) & 0x02;                    \
196     (o_p) = (*(p) >> 5) & 0x01;                    \
197     (o_cc) = (*(p)++) & 0x1F;                      \
198   } while (0)
199 
200 #define AVDT_MSG_PRS_M_PT(p, m_pt, marker) \
201   do {                                     \
202     (marker) = (*(p) >> 7) & 0x01;         \
203     (m_pt) = (*(p)++) & 0x7F;              \
204   } while (0)
205 
206 #define AVDT_MSG_BLD_HDR(p, lbl, pkt, msg)                 \
207   do {                                                     \
208     *(p)++ = (uint8_t)((lbl) << 4) | ((pkt) << 2) | (msg); \
209   } while (0)
210 
211 #define AVDT_MSG_BLD_DISC(p, seid, in_use, type, tsep)   \
212   do {                                                   \
213     *(p)++ = (uint8_t)(((seid) << 2) | ((in_use) << 1)); \
214     *(p)++ = (uint8_t)(((type) << 4) | ((tsep) << 3));   \
215   } while (0)
216 
217 #define AVDT_MSG_BLD_SIG(p, sig) \
218   do {                           \
219     *(p)++ = (uint8_t)(sig);     \
220   } while (0)
221 
222 #define AVDT_MSG_BLD_SEID(p, seid)   \
223   do {                               \
224     *(p)++ = (uint8_t)((seid) << 2); \
225   } while (0)
226 
227 #define AVDT_MSG_BLD_ERR(p, err) \
228   do {                           \
229     *(p)++ = (uint8_t)(err);     \
230   } while (0)
231 
232 #define AVDT_MSG_BLD_PARAM(p, param) \
233   do {                               \
234     *(p)++ = (uint8_t)(param);       \
235   } while (0)
236 
237 #define AVDT_MSG_BLD_NOSP(p, nosp) \
238   do {                             \
239     *(p)++ = (uint8_t)(nosp);      \
240   } while (0)
241 
242 #endif /* AVDT_DEFS_H */
243