xref: /btstack/src/classic/avdtp.h (revision a8d51f092f1b660d0f6921369ad2bc3f9368296c)
1 /*
2  * Copyright (C) 2016 BlueKitchen GmbH
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the copyright holders nor the names of
14  *    contributors may be used to endorse or promote products derived
15  *    from this software without specific prior written permission.
16  * 4. Any redistribution, use, or modification is done solely for
17  *    personal benefit and not for any commercial purpose or for
18  *    monetary gain.
19  *
20  * THIS SOFTWARE IS PROVIDED BY BLUEKITCHEN GMBH AND CONTRIBUTORS
21  * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
22  * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
23  * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL MATTHIAS
24  * RINGWALD OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
25  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
26  * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
27  * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
28  * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
29  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
30  * THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31  * SUCH DAMAGE.
32  *
33  * Please inquire about commercial licensing options at
34  * [email protected]
35  *
36  */
37 
38 /*
39  * avdtp.h
40  *
41  * Audio/Video Distribution Transport Protocol
42  *
43  * This protocol defines A/V stream negotiation, establishment, and transmission
44  * procedures. Also specified are the message formats that are exchanged between
45  * such devices to transport their A/V streams in A/V distribution applications.
46  *
47  * Media packets are unidirectional, they travel downstream from AVDTP Source to AVDTP Sink.
48  */
49 
50 #ifndef AVDTP_H
51 #define AVDTP_H
52 
53 #include <stdint.h>
54 #include "hci.h"
55 #include "btstack_ring_buffer.h"
56 
57 #if defined __cplusplus
58 extern "C" {
59 #endif
60 
61 #define AVDTP_MAX_NUM_SEPS 10
62 #define AVDTP_MAX_CSRC_NUM 15
63 #define AVDTP_MAX_CONTENT_PROTECTION_TYPE_VALUE_LEN 10
64 
65 // Supported Features
66 #define AVDTP_SOURCE_FEATURE_MASK_PLAYER        0x0001u
67 #define AVDTP_SOURCE_FEATURE_MASK_MICROPHONE    0x0002u
68 #define AVDTP_SOURCE_FEATURE_MASK_TUNER         0x0004u
69 #define AVDTP_SOURCE_FEATURE_MASK_MIXER         0x0008u
70 
71 #define AVDTP_SINK_FEATURE_MASK_HEADPHONE       0x0001u
72 #define AVDTP_SINK_FEATURE_MASK_SPEAKER         0x0002u
73 #define AVDTP_SINK_FEATURE_MASK_RECORDER        0x0004u
74 #define AVDTP_SINK_FEATURE_MASK_AMPLIFIER       0x0008u
75 
76 // ACP to INT, Signal Response Header Error Codes
77 #define BAD_HEADER_FORMAT 0x01
78 
79 // ACP to INT, Signal Response Payload Format Error Codes
80 #define BAD_LENGTH 0x11
81 #define BAD_ACP_SEID 0x12
82 #define SEP_IN_USE 0x13
83 #define SEP_NOT_IN_USE 0x14
84 #define BAD_SERV_CATEGORY 0x17
85 #define BAD_PAYLOAD_FORMAT 0x18
86 #define NOT_SUPPORTED_COMMAND 0x19
87 #define INVALID_CAPABILITIES 0x1A
88 
89 // ACP to INT, Signal Response Transport Service Capabilities Error Codes
90 #define BAD_RECOVERY_TYPE 0x22
91 #define BAD_MEDIA_TRANSPORT_FORMAT 0x23
92 #define BAD_RECOVERY_FORMAT 0x25
93 #define BAD_ROHC_FORMAT 0x26
94 #define BAD_CP_FORMAT 0x27
95 #define BAD_MULTIPLEXING_FORMAT 0x28
96 #define UNSUPPORTED_CONFIGURATION 0x29
97 
98 // ACP to INT, Procedure Error Codes
99 #define BAD_STATE 0x31
100 
101 #define AVDTP_INVALID_SEP_SEID 0xFF
102 
103 
104 // Signal Identifier fields
105 typedef enum {
106     AVDTP_SI_NONE = 0x00,
107     AVDTP_SI_DISCOVER = 0x01,
108     AVDTP_SI_GET_CAPABILITIES,
109     AVDTP_SI_SET_CONFIGURATION,
110     AVDTP_SI_GET_CONFIGURATION,
111     AVDTP_SI_RECONFIGURE, //5
112     AVDTP_SI_OPEN,  //6
113     AVDTP_SI_START, //7
114     AVDTP_SI_CLOSE,
115     AVDTP_SI_SUSPEND,
116     AVDTP_SI_ABORT, //10
117     AVDTP_SI_SECURITY_CONTROL,
118     AVDTP_SI_GET_ALL_CAPABILITIES, //12
119     AVDTP_SI_DELAYREPORT
120 } avdtp_signal_identifier_t;
121 
122 typedef enum {
123     AVDTP_SINGLE_PACKET = 0,
124     AVDTP_START_PACKET    ,
125     AVDTP_CONTINUE_PACKET ,
126     AVDTP_END_PACKET
127 } avdtp_packet_type_t;
128 
129 typedef enum {
130     AVDTP_CMD_MSG = 0,
131     AVDTP_GENERAL_REJECT_MSG   ,
132     AVDTP_RESPONSE_ACCEPT_MSG ,
133     AVDTP_RESPONSE_REJECT_MSG
134 } avdtp_message_type_t;
135 
136 typedef enum {
137     AVDTP_AUDIO = 0,
138     AVDTP_VIDEO,
139     AVDTP_MULTIMEDIA
140 } avdtp_media_type_t;
141 
142 typedef enum {
143     AVDTP_CODEC_SBC             = 0x00,
144     AVDTP_CODEC_MPEG_1_2_AUDIO  = 0x01,
145     AVDTP_CODEC_MPEG_2_4_AAC    = 0x02,
146     AVDTP_CODEC_ATRAC_FAMILY    = 0x04,
147     AVDTP_CODEC_NON_A2DP        = 0xFF
148 } avdtp_media_codec_type_t;
149 
150 typedef enum {
151     AVDTP_CONTENT_PROTECTION_DTCP = 0x0001,
152     AVDTP_CONTENT_PROTECTION_SCMS_T = 0x0002
153 } avdtp_content_protection_type_t;
154 
155 typedef enum {
156     AVDTP_SOURCE = 0,
157     AVDTP_SINK
158 } avdtp_sep_type_t;
159 
160 typedef enum {
161     AVDTP_ROLE_SOURCE = 0,
162     AVDTP_ROLE_SINK
163 } avdtp_role_t;
164 
165 typedef enum {
166     AVDTP_SERVICE_CATEGORY_INVALID_0 = 0x00,
167     AVDTP_MEDIA_TRANSPORT = 0X01,
168     AVDTP_REPORTING,
169     AVDTP_RECOVERY,
170     AVDTP_CONTENT_PROTECTION, //4
171     AVDTP_HEADER_COMPRESSION, //5
172     AVDTP_MULTIPLEXING,       //6
173     AVDTP_MEDIA_CODEC,        //7
174     AVDTP_DELAY_REPORTING,    //8
175     AVDTP_SERVICE_CATEGORY_INVALID_FF = 0xFF
176 } avdtp_service_category_t;
177 
178 typedef struct {
179     uint8_t recovery_type;                  // 0x01 = RFC2733
180     uint8_t maximum_recovery_window_size;   // 0x01 to 0x18, for a Transport Packet
181     uint8_t maximum_number_media_packets;   // 0x01 to 0x18, The maximum number of media packets a specific parity code covers
182 } avdtp_recovery_capabilities_t;
183 
184 typedef struct {
185     avdtp_media_type_t       media_type;
186     avdtp_media_codec_type_t media_codec_type;
187     uint16_t  media_codec_information_len;
188     uint8_t * media_codec_information;
189 } adtvp_media_codec_capabilities_t;
190 
191 
192 typedef struct {
193     uint16_t cp_type;
194     uint16_t cp_type_value_len;
195     uint8_t cp_type_value[AVDTP_MAX_CONTENT_PROTECTION_TYPE_VALUE_LEN];
196 } adtvp_content_protection_t;
197 
198 typedef struct{
199     uint8_t back_ch;  // byte0 - bit 8; 0=Not Available/Not Used; 1=Available/In Use
200     uint8_t media;    // byte0 - bit 7
201     uint8_t recovery; // byte0 - bit 6
202 } avdtp_header_compression_capabilities_t;
203 
204 typedef struct{
205     uint8_t fragmentation; // byte0 - bit 8, Allow Adaptation Layer Fragmentation, 0 no, 1 yes
206     // Request/indicate value of the Transport Session Identifier for a media, reporting, or recovery transport sessions, respectively
207     uint8_t transport_identifiers_num;
208     uint8_t transport_session_identifiers[3];   // byte1, upper 5bits, 0x01 to 0x1E
209     // Request/indicate value for TCID for a media, reporting, or transport session
210     uint8_t tcid[3];         // byte2 0x01 to 0x1E
211 } avdtp_multiplexing_mode_capabilities_t;
212 
213 typedef struct{
214     avdtp_recovery_capabilities_t recovery;
215     adtvp_media_codec_capabilities_t media_codec;
216     adtvp_content_protection_t content_protection;
217     avdtp_header_compression_capabilities_t header_compression;
218     avdtp_multiplexing_mode_capabilities_t multiplexing_mode;
219 } avdtp_capabilities_t;
220 
221 typedef enum{
222     AVDTP_SBC_48000 = 1,
223     AVDTP_SBC_44100 = 2,
224     AVDTP_SBC_32000 = 4,
225     AVDTP_SBC_16000 = 8
226 } avdtp_sbc_sampling_frequency_t;
227 
228 typedef enum{
229     AVDTP_SBC_JOINT_STEREO  = 1,
230     AVDTP_SBC_STEREO        = 2,
231     AVDTP_SBC_DUAL_CHANNEL  = 4,
232     AVDTP_SBC_MONO          = 8
233 } avdtp_sbc_channel_mode_t;
234 
235 typedef enum{
236     AVDTP_SBC_BLOCK_LENGTH_16 = 1,
237     AVDTP_SBC_BLOCK_LENGTH_12 = 2,
238     AVDTP_SBC_BLOCK_LENGTH_8  = 4,
239     AVDTP_SBC_BLOCK_LENGTH_4  = 8
240 } avdtp_sbc_block_length_t;
241 
242 typedef enum{
243     AVDTP_SBC_SUBBANDS_8 = 1,
244     AVDTP_SBC_SUBBANDS_4 = 2
245 } avdtp_sbc_subbands_t;
246 
247 typedef enum{
248     AVDTP_SBC_ALLOCATION_METHOD_LOUDNESS = 1,
249     AVDTP_SBC_ALLOCATION_METHOD_SNR      = 2
250 } avdtp_sbc_allocation_method_t;
251 
252 typedef struct {
253     uint8_t fragmentation;
254     uint8_t starting_packet; // of fragmented SBC frame
255     uint8_t last_packet;     // of fragmented SBC frame
256     uint8_t num_frames;
257 } avdtp_sbc_codec_header_t;
258 
259 // typedef struct {
260 //     uint8_t transaction_label;
261 //     avdtp_packet_type_t packet_type;
262 //     avdtp_message_type_t message_type;
263 //     uint8_t signal_identifier;
264 // } avdtp_signaling_packet_header_t;
265 
266 typedef struct {
267     uint8_t version;
268     uint8_t padding;
269     uint8_t extension;
270     uint8_t csrc_count;
271     uint8_t marker;
272     uint8_t payload_type;
273 
274     uint16_t sequence_number;
275     uint32_t timestamp;
276     uint32_t synchronization_source;
277 
278     uint32_t csrc_list[AVDTP_MAX_CSRC_NUM];
279 } avdtp_media_packet_header_t;
280 
281 typedef enum {
282     AVDTP_BASIC_SERVICE_MODE = 0,
283     AVDTP_MULTIPLEXING_SERVICE_MODE
284 } avdtp_service_mode_t;
285 
286 typedef enum {
287     AVDTP_STREAM_ENDPOINT_IDLE = 0,
288     AVDTP_STREAM_ENDPOINT_CONFIGURATION_SUBSTATEMACHINE,
289     AVDTP_STREAM_ENDPOINT_CONFIGURED,
290 
291     AVDTP_STREAM_ENDPOINT_W2_REQUEST_OPEN_STREAM,
292     AVDTP_STREAM_ENDPOINT_W4_ACCEPT_OPEN_STREAM,
293     AVDTP_STREAM_ENDPOINT_W4_L2CAP_FOR_MEDIA_CONNECTED,
294 
295     AVDTP_STREAM_ENDPOINT_OPENED,
296     AVDTP_STREAM_ENDPOINT_STREAMING,
297 
298     AVDTP_STREAM_ENDPOINT_CLOSING,
299     AVDTP_STREAM_ENDPOINT_ABORTING,
300     AVDTP_STREAM_ENDPOINT_W4_L2CAP_FOR_MEDIA_DISCONNECTED
301 } avdtp_stream_endpoint_state_t;
302 
303 typedef enum {
304     AVDTP_INITIATOR_STREAM_CONFIG_IDLE = 0,
305     AVDTP_INITIATOR_W2_SET_CONFIGURATION,
306     AVDTP_INITIATOR_W2_SUSPEND_STREAM_WITH_SEID,
307     AVDTP_INITIATOR_W2_RECONFIGURE_STREAM_WITH_SEID,
308 
309     AVDTP_INITIATOR_W2_OPEN_STREAM,
310 
311     AVDTP_INITIATOR_W2_STREAMING_ABORT,
312     AVDTP_INITIATOR_FRAGMENTATED_COMMAND,
313     AVDTP_INITIATOR_W4_ANSWER
314 } avdtp_initiator_stream_endpoint_state_t;
315 
316 typedef enum {
317     AVDTP_ACCEPTOR_STREAM_CONFIG_IDLE = 0,
318     AVDTP_ACCEPTOR_W2_ANSWER_GET_CAPABILITIES,
319     AVDTP_ACCEPTOR_W2_ANSWER_GET_ALL_CAPABILITIES,
320     AVDTP_ACCEPTOR_W2_ANSWER_DELAY_REPORT,
321     AVDTP_ACCEPTOR_W2_ANSWER_SET_CONFIGURATION,
322     AVDTP_ACCEPTOR_W2_ANSWER_RECONFIGURE,
323     AVDTP_ACCEPTOR_W2_ANSWER_GET_CONFIGURATION,
324     AVDTP_ACCEPTOR_W2_ANSWER_OPEN_STREAM,
325     AVDTP_ACCEPTOR_W2_ANSWER_START_STREAM,
326     AVDTP_ACCEPTOR_W2_ANSWER_CLOSE_STREAM,
327     AVDTP_ACCEPTOR_W2_ANSWER_ABORT_STREAM,
328     AVDTP_ACCEPTOR_W2_SUSPEND_STREAM_WITH_SEID,
329     AVDTP_ACCEPTOR_W2_ANSWER_SUSPEND_STREAM,
330     AVDTP_ACCEPTOR_W2_REJECT_WITH_ERROR_CODE,
331     AVDTP_ACCEPTOR_W2_REJECT_CATEGORY_WITH_ERROR_CODE,
332     AVDTP_ACCEPTOR_W2_REJECT_UNKNOWN_CMD,
333     AVDTP_ACCEPTOR_STREAMING
334 } avdtp_acceptor_stream_endpoint_state_t;
335 
336 typedef struct {
337     uint8_t seid;           // 0x01 – 0x3E, 6bit
338     uint8_t in_use;         // 1 bit, 0 - not in use, 1 - in use
339     avdtp_media_type_t media_type;     // 4 bit
340     avdtp_sep_type_t   type;       // 1 bit, 0 - SRC, 1 - SNK
341 
342     uint16_t registered_service_categories;
343     avdtp_capabilities_t capabilities;
344 
345     uint16_t configured_service_categories;
346     avdtp_capabilities_t configuration;
347 } avdtp_sep_t;
348 
349 
350 typedef enum {
351     AVDTP_SIGNALING_CONNECTION_IDLE = 0,
352     AVDTP_SIGNALING_W2_SEND_SDP_QUERY_FOR_REMOTE_SINK,
353     AVDTP_SIGNALING_W4_SDP_QUERY_FOR_REMOTE_SINK_COMPLETE,
354     AVDTP_SIGNALING_W2_SEND_SDP_QUERY_FOR_REMOTE_SOURCE,
355     AVDTP_SIGNALING_W4_SDP_QUERY_FOR_REMOTE_SOURCE_COMPLETE,
356     AVDTP_SIGNALING_CONNECTION_W4_L2CAP_CONNECTED,
357     AVDTP_SIGNALING_CONNECTION_W2_L2CAP_RETRY,
358     AVDTP_SIGNALING_CONNECTION_OPENED,
359     AVDTP_SIGNALING_CONNECTION_W4_L2CAP_DISCONNECTED
360 } avdtp_connection_state_t;
361 
362 typedef enum {
363     AVDTP_SIGNALING_CONNECTION_ACCEPTOR_IDLE = 0,
364     AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_ANSWER_DISCOVER_SEPS,
365     AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_REJECT_WITH_ERROR_CODE,
366     AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_REJECT_CATEGORY_WITH_ERROR_CODE,
367     AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_GENERAL_REJECT_WITH_ERROR_CODE
368 } avdtp_acceptor_connection_state_t;
369 
370 typedef enum {
371     AVDTP_SIGNALING_CONNECTION_INITIATOR_IDLE = 0,
372     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_DISCOVER_SEPS,
373     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_SEND_SDP_QUERY_THEN_GET_ALL_CAPABILITIES,
374     AVDTP_SIGNALING_CONNECTION_INITIATOR_W4_SDP_QUERY_COMPLETE_THEN_GET_ALL_CAPABILITIES,
375     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_CAPABILITIES,
376     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_ALL_CAPABILITIES,
377     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_CONFIGURATION,
378     AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_SEND_DELAY_REPORT,
379     AVDTP_SIGNALING_CONNECTION_INITIATOR_W4_ANSWER
380 } avdtp_initiator_connection_state_t;
381 
382 typedef struct {
383     uint8_t  command[200];
384     uint16_t size;
385     uint16_t offset;
386     uint8_t  acp_seid;
387     uint8_t  int_seid;
388     uint16_t transaction_label;
389     uint16_t num_packets;
390     avdtp_signal_identifier_t   signal_identifier;
391     avdtp_message_type_t        message_type;
392     avdtp_packet_type_t         packet_type;
393 } avdtp_signaling_packet_t;
394 
395 typedef enum {
396     AVDTP_CONFIGURATION_STATE_IDLE = 0,
397     AVDTP_CONFIGURATION_STATE_LOCAL_INITIATED,
398     AVDTP_CONFIGURATION_STATE_LOCAL_CONFIGURED,
399     AVDTP_CONFIGURATION_STATE_REMOTE_INITIATED,
400     AVDTP_CONFIGURATION_STATE_REMOTE_CONFIGURED,
401 } avtdp_configuration_state_t;
402 
403 typedef enum {
404     A2DP_IDLE = 0,
405     A2DP_W4_CONNECTED,
406     A2DP_CONNECTED,
407     A2DP_DISCOVER_SEPS,
408     A2DP_GET_CAPABILITIES,
409     A2DP_W2_GET_ALL_CAPABILITIES, //5
410     A2DP_SET_CONFIGURATION,
411     A2DP_W4_GET_CONFIGURATION,
412     A2DP_W4_SET_CONFIGURATION,
413     A2DP_CONFIGURED,
414     A2DP_W2_SUSPEND_STREAM_WITH_SEID, //10
415     A2DP_W2_RECONFIGURE_WITH_SEID,
416     A2DP_W2_OPEN_STREAM_WITH_SEID,
417     A2DP_W4_OPEN_STREAM_WITH_SEID,
418     A2DP_W2_START_STREAM_WITH_SEID,
419     A2DP_W2_ABORT_STREAM_WITH_SEID,   //15
420     A2DP_W2_STOP_STREAM_WITH_SEID,
421     A2DP_STREAMING_OPENED
422 } a2dp_state_t;
423 
424 
425 typedef struct {
426     btstack_linked_item_t    item;
427     bd_addr_t remote_addr;
428 
429     uint16_t avdtp_cid;
430     hci_con_handle_t con_handle;
431 
432     // SDP results
433     uint16_t avdtp_l2cap_psm;
434     uint16_t avdtp_version;
435     bool     sink_supported;
436     bool     source_supported;
437 
438     uint16_t l2cap_signaling_cid;
439     uint16_t l2cap_mtu;
440 
441     avdtp_connection_state_t state;
442     avdtp_acceptor_connection_state_t  acceptor_connection_state;
443     avdtp_initiator_connection_state_t initiator_connection_state;
444 
445     // used to reassemble fragmented commands
446     avdtp_signaling_packet_t acceptor_signaling_packet;
447 
448     // used to prepare outgoing signaling packets
449     avdtp_signaling_packet_t initiator_signaling_packet;
450 
451     uint8_t initiator_local_seid;
452     uint8_t initiator_remote_seid;
453 
454     uint8_t acceptor_local_seid;
455 
456     uint16_t delay_ms;
457 
458     // for repeating the set_configuration
459     void * active_stream_endpoint;
460 
461     uint8_t initiator_transaction_label;
462     uint8_t acceptor_transaction_label;
463     bool    wait_to_send_acceptor;
464 	bool    wait_to_send_initiator;
465 
466     uint8_t suspended_seids[AVDTP_MAX_NUM_SEPS];
467     uint8_t num_suspended_seids;
468 
469     uint8_t reject_service_category;
470     avdtp_signal_identifier_t reject_signal_identifier;
471     uint8_t error_code;
472 
473     // configuration state machine
474     avtdp_configuration_state_t configuration_state;
475     // btstack_timer_source_t configuration_timer;
476 
477     bool incoming_declined;
478     btstack_timer_source_t retry_timer;
479 
480     bool    a2dp_source_discover_seps;
481     uint8_t supported_codecs_bitmap;
482 
483 } avdtp_connection_t;
484 
485 
486 typedef struct avdtp_stream_endpoint {
487     btstack_linked_item_t    item;
488 
489     // original capabilities configured via avdtp_register_x_category
490     avdtp_sep_t sep;
491 
492     // media codec configuration
493     uint16_t  media_codec_configuration_len;
494     uint8_t * media_codec_configuration_info;
495 
496     avdtp_sep_t remote_sep;
497     hci_con_handle_t media_con_handle;
498     uint16_t l2cap_media_cid;
499     uint16_t l2cap_reporting_cid;
500     uint16_t l2cap_recovery_cid;
501 
502     avdtp_stream_endpoint_state_t  state;
503     avdtp_acceptor_stream_endpoint_state_t  acceptor_config_state;
504     avdtp_initiator_stream_endpoint_state_t initiator_config_state;
505     a2dp_state_t a2dp_state;
506     // active connection
507     avdtp_connection_t * connection;
508 
509     // currently active remote seid
510     avdtp_capabilities_t remote_capabilities;
511     uint16_t remote_capabilities_bitmap;
512 
513     uint16_t remote_configuration_bitmap;
514     avdtp_capabilities_t remote_configuration;
515 
516     // temporary SBC config used by A2DP Source
517     avdtp_media_codec_type_t media_codec_type;
518     avdtp_media_type_t media_type;
519     uint8_t media_codec_sbc_info[4];
520 
521     // preferred sampling frequency
522     uint32_t preferred_sampling_frequency;
523 
524     // register request for media L2cap connection release
525     uint8_t media_disconnect;
526     uint8_t media_connect;
527     uint8_t start_stream;
528     uint8_t close_stream;
529     uint8_t request_can_send_now;
530     uint8_t abort_stream;
531     uint8_t suspend_stream;
532     uint16_t sequence_number;
533 } avdtp_stream_endpoint_t;
534 
535 typedef struct {
536     uint32_t fill_audio_ring_buffer_timeout_ms;
537     uint32_t time_audio_data_sent; // msstream
538     uint32_t acc_num_missed_samples;
539     uint32_t samples_ready;
540     btstack_timer_source_t fill_audio_ring_buffer_timer;
541     btstack_ring_buffer_t sbc_ring_buffer;
542 
543     int reconfigure;
544     int num_channels;
545     int sampling_frequency;
546     int channel_mode;
547     int block_length;
548     int subbands;
549     int allocation_method;
550     int min_bitpool_value;
551     int max_bitpool_value;
552     avdtp_stream_endpoint_t * local_stream_endpoint;
553     uint8_t active_remote_sep_index;
554 } avdtp_stream_endpoint_context_t;
555 
556 void avdtp_init(void);
557 avdtp_connection_t * avdtp_get_connection_for_avdtp_cid(uint16_t avdtp_cid);
558 avdtp_connection_t * avdtp_get_connection_for_l2cap_signaling_cid(uint16_t l2cap_cid);
559 btstack_linked_list_t * avdtp_get_connections(void);
560 btstack_linked_list_t * avdtp_get_stream_endpoints(void);
561 
562 avdtp_stream_endpoint_t * avdtp_get_stream_endpoint_for_seid(uint16_t seid);
563 
564 btstack_packet_handler_t avdtp_packet_handler_for_stream_endpoint(const avdtp_stream_endpoint_t *stream_endpoint);
565 void avdtp_emit_sink_and_source(uint8_t * packet, uint16_t size);
566 void avdtp_emit_source(uint8_t * packet, uint16_t size);
567 
568 void avdtp_register_media_transport_category(avdtp_stream_endpoint_t * stream_endpoint);
569 void avdtp_register_reporting_category(avdtp_stream_endpoint_t * stream_endpoint);
570 void avdtp_register_delay_reporting_category(avdtp_stream_endpoint_t * stream_endpoint);
571 void avdtp_register_recovery_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t maximum_recovery_window_size, uint8_t maximum_number_media_packets);
572 void avdtp_register_content_protection_category(avdtp_stream_endpoint_t * stream_endpoint, uint16_t cp_type, const uint8_t * cp_type_value, uint8_t cp_type_value_len);
573 void avdtp_register_header_compression_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t back_ch, uint8_t media, uint8_t recovery);
574 void avdtp_register_media_codec_category(avdtp_stream_endpoint_t * stream_endpoint, avdtp_media_type_t media_type, avdtp_media_codec_type_t media_codec_type, uint8_t * media_codec_info, uint16_t media_codec_info_len);
575 void avdtp_register_multiplexing_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t fragmentation);
576 
577 // sink only
578 void avdtp_register_media_handler(void (*callback)(uint8_t local_seid, uint8_t *packet, uint16_t size));
579 
580 void avdtp_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size);
581 avdtp_stream_endpoint_t * avdtp_create_stream_endpoint(avdtp_sep_type_t sep_type, avdtp_media_type_t media_type);
582 void avdtp_finalize_stream_endpoint(avdtp_stream_endpoint_t * stream_endpoint);
583 
584 uint8_t avdtp_connect(bd_addr_t remote, avdtp_role_t role, uint16_t * avdtp_cid);
585 uint8_t avdtp_disconnect(uint16_t avdtp_cid);
586 void    avdtp_register_sink_packet_handler(btstack_packet_handler_t callback);
587 void    avdtp_register_source_packet_handler(btstack_packet_handler_t callback);
588 
589 uint8_t avdtp_open_stream(uint16_t avdtp_cid, uint8_t local_seid, uint8_t remote_seid);
590 uint8_t avdtp_start_stream(uint16_t avdtp_cid, uint8_t local_seid);
591 uint8_t avdtp_stop_stream (uint16_t avdtp_cid, uint8_t local_seid);
592 uint8_t avdtp_abort_stream(uint16_t avdtp_cid, uint8_t local_seid);
593 uint8_t avdtp_suspend_stream(uint16_t avdtp_cid, uint8_t local_seid);
594 
595 uint8_t avdtp_discover_stream_endpoints(uint16_t avdtp_cid);
596 uint8_t avdtp_get_capabilities(uint16_t avdtp_cid, uint8_t remote_seid);
597 uint8_t avdtp_get_all_capabilities(uint16_t avdtp_cid, uint8_t remote_seid);
598 uint8_t avdtp_get_configuration(uint16_t avdtp_cid, uint8_t remote_seid);
599 uint8_t avdtp_set_configuration(uint16_t avdtp_cid, uint8_t local_seid, uint8_t remote_seid, uint16_t configured_services_bitmap, avdtp_capabilities_t configuration);
600 uint8_t avdtp_reconfigure(uint16_t avdtp_cid, uint8_t local_seid, uint8_t remote_seid, uint16_t configured_services_bitmap, avdtp_capabilities_t configuration);
601 
602 // frequency will be used by avdtp_choose_sbc_sampling_frequency if supported by both endpoints
603 void    avdtp_set_preferred_sampling_frequeny(avdtp_stream_endpoint_t * stream_endpoint, uint32_t sampling_frequency);
604 //
605 void    avdtp_set_preferred_sbc_channel_mode(avdtp_stream_endpoint_t * stream_endpoint, uint32_t sampling_frequency);
606 
607 uint8_t avdtp_choose_sbc_channel_mode(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_channel_mode_bitmap);
608 uint8_t avdtp_choose_sbc_allocation_method(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_allocation_method_bitmap);
609 uint8_t avdtp_choose_sbc_sampling_frequency(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_sampling_frequency_bitmap);
610 uint8_t avdtp_choose_sbc_subbands(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_subbands_bitmap);
611 uint8_t avdtp_choose_sbc_block_length(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_block_length_bitmap);
612 uint8_t avdtp_choose_sbc_max_bitpool_value(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_max_bitpool_value);
613 uint8_t avdtp_choose_sbc_min_bitpool_value(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_min_bitpool_value);
614 
615 uint8_t avdtp_stream_endpoint_seid(avdtp_stream_endpoint_t * stream_endpoint);
616 
617 uint8_t is_avdtp_remote_seid_registered(avdtp_stream_endpoint_t * stream_endpoint);
618 
619 uint16_t avdtp_get_next_transaction_label(void);
620 
621 #if defined __cplusplus
622 }
623 #endif
624 
625 #endif // AVDTP_H
626