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 BLUEKITCHEN 24 * GMBH 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 * Audio/Video Distribution Transport Protocol (AVDTP) 40 * 41 * This protocol defines A/V stream negotiation, establishment, and transmission 42 * procedures. Also specified are the message formats that are exchanged between 43 * such devices to transport their A/V streams in A/V distribution applications. 44 * 45 * Media packets are unidirectional, they travel downstream from AVDTP Source to AVDTP Sink. 46 */ 47 48 #ifndef AVDTP_H 49 #define AVDTP_H 50 51 #include <stdint.h> 52 #include "hci.h" 53 #include "btstack_ring_buffer.h" 54 55 #if defined __cplusplus 56 extern "C" { 57 #endif 58 59 #define AVDTP_MAX_NUM_SEPS 10 60 #define AVDTP_MAX_CSRC_NUM 15 61 #define AVDTP_MAX_CONTENT_PROTECTION_TYPE_VALUE_LEN 10 62 63 // Supported Features 64 #define AVDTP_SOURCE_FEATURE_MASK_PLAYER 0x0001u 65 #define AVDTP_SOURCE_FEATURE_MASK_MICROPHONE 0x0002u 66 #define AVDTP_SOURCE_FEATURE_MASK_TUNER 0x0004u 67 #define AVDTP_SOURCE_FEATURE_MASK_MIXER 0x0008u 68 69 #define AVDTP_SINK_FEATURE_MASK_HEADPHONE 0x0001u 70 #define AVDTP_SINK_FEATURE_MASK_SPEAKER 0x0002u 71 #define AVDTP_SINK_FEATURE_MASK_RECORDER 0x0004u 72 #define AVDTP_SINK_FEATURE_MASK_AMPLIFIER 0x0008u 73 74 // ACP to INT, Signal Response Header Error Codes 75 #define AVDTP_ERROR_CODE_BAD_HEADER_FORMAT 0x01 76 77 // ACP to INT, Signal Response Payload Format Error Codes 78 #define AVDTP_ERROR_CODE_BAD_LENGTH 0x11 79 #define AVDTP_ERROR_CODE_BAD_ACP_SEID 0x12 80 #define AVDTP_ERROR_CODE_SEP_IN_USE 0x13 81 #define AVDTP_ERROR_CODE_SEP_NOT_IN_USE 0x14 82 #define AVDTP_ERROR_CODE_BAD_SERV_CATEGORY 0x17 83 #define AVDTP_ERROR_CODE_BAD_PAYLOAD_FORMAT 0x18 84 #define AVDTP_ERROR_CODE_NOT_SUPPORTED_COMMAND 0x19 85 #define AVDTP_ERROR_CODE_INVALID_CAPABILITIES 0x1A 86 87 // ACP to INT, Signal Response Transport Service Capabilities Error Codes 88 #define AVDTP_ERROR_CODE_BAD_RECOVERY_TYPE 0x22 89 #define AVDTP_ERROR_CODE_BAD_MEDIA_TRANSPORT_FORMAT 0x23 90 #define AVDTP_ERROR_CODE_BAD_RECOVERY_FORMAT 0x25 91 #define AVDTP_ERROR_CODE_BAD_ROHC_FORMAT 0x26 92 #define AVDTP_ERROR_CODE_BAD_CP_FORMAT 0x27 93 #define AVDTP_ERROR_CODE_BAD_MULTIPLEXING_FORMAT 0x28 94 #define AVDTP_ERROR_CODE_UNSUPPORTED_CONFIGURATION 0x29 95 96 // ACP to INT, Procedure Error Codes 97 #define AVDTP_ERROR_CODE_BAD_STATE 0x31 98 99 // Internal Error Codes 100 #define AVDTP_INVALID_SEP_SEID 0xFF 101 102 103 // Signal Identifier fields 104 typedef enum { 105 AVDTP_SI_NONE = 0x00, 106 AVDTP_SI_DISCOVER = 0x01, 107 AVDTP_SI_GET_CAPABILITIES, 108 AVDTP_SI_SET_CONFIGURATION, 109 AVDTP_SI_GET_CONFIGURATION, 110 AVDTP_SI_RECONFIGURE, //5 111 AVDTP_SI_OPEN, //6 112 AVDTP_SI_START, //7 113 AVDTP_SI_CLOSE, 114 AVDTP_SI_SUSPEND, 115 AVDTP_SI_ABORT, //10 116 AVDTP_SI_SECURITY_CONTROL, 117 AVDTP_SI_GET_ALL_CAPABILITIES, //12 118 AVDTP_SI_DELAYREPORT, 119 #ifdef ENABLE_AVDTP_ACCEPTOR_EXPLICIT_START_STREAM_CONFIRMATION 120 AVDTP_SI_ACCEPT_START 121 #endif 122 } avdtp_signal_identifier_t; 123 124 typedef enum { 125 AVDTP_SINGLE_PACKET = 0, 126 AVDTP_START_PACKET , 127 AVDTP_CONTINUE_PACKET , 128 AVDTP_END_PACKET 129 } avdtp_packet_type_t; 130 131 typedef enum { 132 AVDTP_CMD_MSG = 0, 133 AVDTP_GENERAL_REJECT_MSG , 134 AVDTP_RESPONSE_ACCEPT_MSG , 135 AVDTP_RESPONSE_REJECT_MSG 136 } avdtp_message_type_t; 137 138 typedef enum { 139 AVDTP_AUDIO = 0, 140 AVDTP_VIDEO, 141 AVDTP_MULTIMEDIA 142 } avdtp_media_type_t; 143 144 typedef enum { 145 AVDTP_CODEC_SBC = 0x00, 146 AVDTP_CODEC_MPEG_1_2_AUDIO = 0x01, 147 AVDTP_CODEC_MPEG_2_4_AAC = 0x02, 148 AVDTP_CODEC_ATRAC_FAMILY = 0x04, 149 AVDTP_CODEC_NON_A2DP = 0xFF 150 } avdtp_media_codec_type_t; 151 152 typedef enum { 153 AVDTP_CONTENT_PROTECTION_DTCP = 0x0001, 154 AVDTP_CONTENT_PROTECTION_SCMS_T = 0x0002 155 } avdtp_content_protection_type_t; 156 157 typedef enum { 158 AVDTP_SOURCE = 0, 159 AVDTP_SINK 160 } avdtp_sep_type_t; 161 162 typedef enum { 163 AVDTP_ROLE_SOURCE = 0, 164 AVDTP_ROLE_SINK 165 } avdtp_role_t; 166 167 typedef enum { 168 AVDTP_SERVICE_CATEGORY_INVALID_0 = 0x00, 169 AVDTP_MEDIA_TRANSPORT = 0X01, 170 AVDTP_REPORTING, 171 AVDTP_RECOVERY, 172 AVDTP_CONTENT_PROTECTION, //4 173 AVDTP_HEADER_COMPRESSION, //5 174 AVDTP_MULTIPLEXING, //6 175 AVDTP_MEDIA_CODEC, //7 176 AVDTP_DELAY_REPORTING, //8 177 AVDTP_SERVICE_CATEGORY_INVALID_FF = 0xFF 178 } avdtp_service_category_t; 179 180 typedef struct { 181 uint8_t recovery_type; // 0x01 = RFC2733 182 uint8_t maximum_recovery_window_size; // 0x01 to 0x18, for a Transport Packet 183 uint8_t maximum_number_media_packets; // 0x01 to 0x18, The maximum number of media packets a specific parity code covers 184 } avdtp_recovery_capabilities_t; 185 186 typedef struct { 187 avdtp_media_type_t media_type; 188 avdtp_media_codec_type_t media_codec_type; 189 uint16_t media_codec_information_len; 190 uint8_t * media_codec_information; 191 } adtvp_media_codec_capabilities_t; 192 193 194 typedef struct { 195 uint16_t cp_type; 196 uint16_t cp_type_value_len; 197 uint8_t cp_type_value[AVDTP_MAX_CONTENT_PROTECTION_TYPE_VALUE_LEN]; 198 } adtvp_content_protection_t; 199 200 typedef struct{ 201 uint8_t back_ch; // byte0 - bit 8; 0=Not Available/Not Used; 1=Available/In Use 202 uint8_t media; // byte0 - bit 7 203 uint8_t recovery; // byte0 - bit 6 204 } avdtp_header_compression_capabilities_t; 205 206 typedef struct{ 207 uint8_t fragmentation; // byte0 - bit 8, Allow Adaptation Layer Fragmentation, 0 no, 1 yes 208 // Request/indicate value of the Transport Session Identifier for a media, reporting, or recovery transport sessions, respectively 209 uint8_t transport_identifiers_num; 210 uint8_t transport_session_identifiers[3]; // byte1, upper 5bits, 0x01 to 0x1E 211 // Request/indicate value for TCID for a media, reporting, or transport session 212 uint8_t tcid[3]; // byte2 0x01 to 0x1E 213 } avdtp_multiplexing_mode_capabilities_t; 214 215 typedef struct{ 216 avdtp_recovery_capabilities_t recovery; 217 adtvp_media_codec_capabilities_t media_codec; 218 adtvp_content_protection_t content_protection; 219 avdtp_header_compression_capabilities_t header_compression; 220 avdtp_multiplexing_mode_capabilities_t multiplexing_mode; 221 } avdtp_capabilities_t; 222 223 typedef enum{ 224 AVDTP_SBC_48000 = 1, 225 AVDTP_SBC_44100 = 2, 226 AVDTP_SBC_32000 = 4, 227 AVDTP_SBC_16000 = 8 228 } avdtp_sbc_sampling_frequency_t; 229 230 typedef enum{ 231 AVDTP_SBC_JOINT_STEREO = 1, 232 AVDTP_SBC_STEREO = 2, 233 AVDTP_SBC_DUAL_CHANNEL = 4, 234 AVDTP_SBC_MONO = 8 235 } avdtp_sbc_channel_mode_t; 236 237 typedef enum{ 238 AVDTP_SBC_BLOCK_LENGTH_16 = 1, 239 AVDTP_SBC_BLOCK_LENGTH_12 = 2, 240 AVDTP_SBC_BLOCK_LENGTH_8 = 4, 241 AVDTP_SBC_BLOCK_LENGTH_4 = 8 242 } avdtp_sbc_block_length_t; 243 244 typedef enum{ 245 AVDTP_SBC_SUBBANDS_8 = 1, 246 AVDTP_SBC_SUBBANDS_4 = 2 247 } avdtp_sbc_subbands_t; 248 249 typedef enum{ 250 AVDTP_SBC_ALLOCATION_METHOD_LOUDNESS = 1, 251 AVDTP_SBC_ALLOCATION_METHOD_SNR = 2 252 } avdtp_sbc_allocation_method_t; 253 254 typedef struct { 255 uint8_t fragmentation; 256 uint8_t starting_packet; // of fragmented SBC frame 257 uint8_t last_packet; // of fragmented SBC frame 258 uint8_t num_frames; 259 } avdtp_sbc_codec_header_t; 260 261 typedef enum { 262 AVDTP_MPEG_LAYER_1 = 1, 263 AVDTP_MPEG_LAYER_2, 264 AVDTP_MPEG_LAYER_3, 265 } avdtp_mpeg_layer_t; 266 267 268 typedef enum { 269 AVDTP_AAC_MPEG2_LC = 1, 270 AVDTP_AAC_MPEG4_LC, 271 AVDTP_AAC_MPEG4_LTP, 272 AVDTP_AAC_MPEG4_SCALABLE 273 } avdtp_aac_object_type_t; 274 275 typedef enum { 276 AVDTP_ATRAC_VERSION_1 = 1, 277 AVDTP_ATRAC_VERSION_2, 278 AVDTP_ATRAC_VERSION_3 279 } avdtp_atrac_version_t; 280 281 // used for MPEG1/2 Audio, ATRAC (no stereo mode) 282 typedef enum { 283 AVDTP_CHANNEL_MODE_MONO = 1, 284 AVDTP_CHANNEL_MODE_DUAL_CHANNEL, 285 AVDTP_CHANNEL_MODE_STEREO, 286 AVDTP_CHANNEL_MODE_JOINT_STEREO, 287 } avdtp_channel_mode_t; 288 289 typedef struct { 290 uint16_t sampling_frequency; 291 avdtp_channel_mode_t channel_mode; 292 uint8_t block_length; 293 uint8_t subbands; 294 avdtp_sbc_allocation_method_t allocation_method; 295 uint8_t min_bitpool_value; 296 uint8_t max_bitpool_value; 297 } avdtp_configuration_sbc_t; 298 299 typedef struct { 300 avdtp_mpeg_layer_t layer; 301 uint8_t crc; 302 avdtp_channel_mode_t channel_mode; 303 uint8_t media_payload_format; 304 uint16_t sampling_frequency; 305 uint8_t vbr; 306 uint8_t bit_rate_index; 307 } avdtp_configuration_mpeg_audio_t; 308 309 typedef struct { 310 avdtp_aac_object_type_t object_type; 311 uint32_t sampling_frequency; 312 uint8_t channels; 313 uint32_t bit_rate; 314 uint8_t vbr; 315 } avdtp_configuration_mpeg_aac_t; 316 317 typedef struct { 318 avdtp_atrac_version_t version; 319 avdtp_channel_mode_t channel_mode; 320 uint16_t sampling_frequency; 321 uint8_t vbr; 322 uint8_t bit_rate_index; 323 uint16_t maximum_sul; 324 } avdtp_configuration_atrac_t; 325 326 327 328 typedef struct { 329 uint8_t version; 330 uint8_t padding; 331 uint8_t extension; 332 uint8_t csrc_count; 333 uint8_t marker; 334 uint8_t payload_type; 335 336 uint16_t sequence_number; 337 uint32_t timestamp; 338 uint32_t synchronization_source; 339 340 uint32_t csrc_list[AVDTP_MAX_CSRC_NUM]; 341 } avdtp_media_packet_header_t; 342 343 typedef enum { 344 AVDTP_BASIC_SERVICE_MODE = 0, 345 AVDTP_MULTIPLEXING_SERVICE_MODE 346 } avdtp_service_mode_t; 347 348 typedef enum { 349 AVDTP_STREAM_ENDPOINT_IDLE = 0, 350 AVDTP_STREAM_ENDPOINT_CONFIGURATION_SUBSTATEMACHINE, 351 AVDTP_STREAM_ENDPOINT_CONFIGURED, 352 353 AVDTP_STREAM_ENDPOINT_W2_REQUEST_OPEN_STREAM, 354 AVDTP_STREAM_ENDPOINT_W4_ACCEPT_OPEN_STREAM, 355 AVDTP_STREAM_ENDPOINT_W4_L2CAP_FOR_MEDIA_CONNECTED, 356 357 AVDTP_STREAM_ENDPOINT_OPENED, 358 AVDTP_STREAM_ENDPOINT_STREAMING, 359 360 AVDTP_STREAM_ENDPOINT_CLOSING, 361 AVDTP_STREAM_ENDPOINT_ABORTING, 362 AVDTP_STREAM_ENDPOINT_W4_L2CAP_FOR_MEDIA_DISCONNECTED 363 } avdtp_stream_endpoint_state_t; 364 365 typedef enum { 366 AVDTP_INITIATOR_STREAM_CONFIG_IDLE = 0, 367 AVDTP_INITIATOR_W2_SET_CONFIGURATION, 368 AVDTP_INITIATOR_W2_SUSPEND_STREAM_WITH_SEID, 369 AVDTP_INITIATOR_W2_RECONFIGURE_STREAM_WITH_SEID, 370 371 AVDTP_INITIATOR_W2_OPEN_STREAM, 372 373 AVDTP_INITIATOR_W2_STREAMING_ABORT, 374 AVDTP_INITIATOR_FRAGMENTATED_COMMAND, 375 AVDTP_INITIATOR_W4_ANSWER 376 } avdtp_initiator_stream_endpoint_state_t; 377 378 typedef enum { 379 AVDTP_ACCEPTOR_STREAM_CONFIG_IDLE = 0, 380 AVDTP_ACCEPTOR_W2_ACCEPT_GET_CAPABILITIES, 381 AVDTP_ACCEPTOR_W2_ACCEPT_GET_ALL_CAPABILITIES, 382 AVDTP_ACCEPTOR_W2_ACCEPT_DELAY_REPORT, 383 AVDTP_ACCEPTOR_W2_ACCEPT_SET_CONFIGURATION, 384 AVDTP_ACCEPTOR_W2_ACCEPT_RECONFIGURE, 385 AVDTP_ACCEPTOR_W2_ACCEPT_GET_CONFIGURATION, 386 AVDTP_ACCEPTOR_W2_ACCEPT_OPEN_STREAM, 387 #ifdef ENABLE_AVDTP_ACCEPTOR_EXPLICIT_START_STREAM_CONFIRMATION 388 AVDTP_ACCEPTOR_W4_USER_CONFIRM_START_STREAM, 389 AVDTP_ACCEPTOR_W2_REJECT_START_STREAM, 390 #endif 391 AVDTP_ACCEPTOR_W2_ACCEPT_START_STREAM, 392 AVDTP_ACCEPTOR_W2_ACCEPT_CLOSE_STREAM, 393 AVDTP_ACCEPTOR_W2_ACCEPT_ABORT_STREAM, 394 AVDTP_ACCEPTOR_W2_ACCEPT_SUSPEND_STREAM, 395 AVDTP_ACCEPTOR_W2_REJECT_WITH_ERROR_CODE, 396 AVDTP_ACCEPTOR_W2_REJECT_CATEGORY_WITH_ERROR_CODE, 397 AVDTP_ACCEPTOR_W2_REJECT_UNKNOWN_CMD 398 } avdtp_acceptor_stream_endpoint_state_t; 399 400 typedef struct { 401 uint8_t seid; // 0x01 – 0x3E, 6bit 402 uint8_t in_use; // 1 bit, 0 - not in use, 1 - in use 403 avdtp_media_type_t media_type; // 4 bit 404 avdtp_sep_type_t type; // 1 bit, 0 - SRC, 1 - SNK 405 406 uint16_t registered_service_categories; 407 avdtp_capabilities_t capabilities; 408 409 uint16_t configured_service_categories; 410 avdtp_capabilities_t configuration; 411 } avdtp_sep_t; 412 413 414 typedef enum { 415 AVDTP_SIGNALING_CONNECTION_IDLE = 0, 416 AVDTP_SIGNALING_W2_SEND_SDP_QUERY_FOR_REMOTE_SINK, 417 AVDTP_SIGNALING_W4_SDP_QUERY_FOR_REMOTE_SINK_COMPLETE, 418 AVDTP_SIGNALING_W2_SEND_SDP_QUERY_FOR_REMOTE_SOURCE, 419 AVDTP_SIGNALING_W4_SDP_QUERY_FOR_REMOTE_SOURCE_COMPLETE, 420 AVDTP_SIGNALING_CONNECTION_W4_L2CAP_CONNECTED, 421 AVDTP_SIGNALING_CONNECTION_W2_L2CAP_RETRY, 422 AVDTP_SIGNALING_CONNECTION_OPENED, 423 AVDTP_SIGNALING_CONNECTION_W4_L2CAP_DISCONNECTED 424 } avdtp_connection_state_t; 425 426 typedef enum { 427 AVDTP_SIGNALING_CONNECTION_ACCEPTOR_IDLE = 0, 428 AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_ANSWER_DISCOVER_SEPS, 429 AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_REJECT_WITH_ERROR_CODE, 430 AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_REJECT_CATEGORY_WITH_ERROR_CODE, 431 AVDTP_SIGNALING_CONNECTION_ACCEPTOR_W2_GENERAL_REJECT_WITH_ERROR_CODE 432 } avdtp_acceptor_connection_state_t; 433 434 typedef enum { 435 AVDTP_SIGNALING_CONNECTION_INITIATOR_IDLE = 0, 436 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_DISCOVER_SEPS, 437 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_SEND_SDP_QUERY_THEN_GET_ALL_CAPABILITIES_FROM_REMOTE_SINK, 438 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_SEND_SDP_QUERY_THEN_GET_ALL_CAPABILITIES_FROM_REMOTE_SOURCE, 439 AVDTP_SIGNALING_CONNECTION_INITIATOR_W4_SDP_QUERY_COMPLETE_THEN_GET_ALL_CAPABILITIES, 440 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_CAPABILITIES, 441 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_ALL_CAPABILITIES, 442 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_GET_CONFIGURATION, 443 AVDTP_SIGNALING_CONNECTION_INITIATOR_W2_SEND_DELAY_REPORT, 444 AVDTP_SIGNALING_CONNECTION_INITIATOR_W4_ANSWER 445 } avdtp_initiator_connection_state_t; 446 447 typedef struct { 448 uint8_t command[200]; 449 uint16_t size; 450 uint16_t offset; 451 uint8_t acp_seid; 452 uint8_t int_seid; 453 uint8_t transaction_label; 454 uint16_t num_packets; 455 avdtp_signal_identifier_t signal_identifier; 456 avdtp_message_type_t message_type; 457 avdtp_packet_type_t packet_type; 458 } avdtp_signaling_packet_t; 459 460 typedef enum { 461 AVDTP_CONFIGURATION_STATE_IDLE = 0, 462 AVDTP_CONFIGURATION_STATE_LOCAL_INITIATED, 463 AVDTP_CONFIGURATION_STATE_LOCAL_CONFIGURED, 464 AVDTP_CONFIGURATION_STATE_REMOTE_INITIATED, 465 AVDTP_CONFIGURATION_STATE_REMOTE_CONFIGURED, 466 } avtdp_configuration_state_t; 467 468 typedef enum { 469 A2DP_IDLE = 0, 470 A2DP_W4_CONNECTED, 471 A2DP_CONNECTED, 472 A2DP_DISCOVER_SEPS, 473 A2DP_GET_CAPABILITIES, 474 A2DP_W2_GET_ALL_CAPABILITIES, //5 475 A2DP_DISCOVERY_DONE, 476 A2DP_SET_CONFIGURATION, 477 A2DP_W4_GET_CONFIGURATION, 478 A2DP_W4_SET_CONFIGURATION, 479 A2DP_CONFIGURED, 480 A2DP_W2_SUSPEND_STREAM_WITH_SEID, //10 481 A2DP_W2_RECONFIGURE_WITH_SEID, 482 A2DP_W2_OPEN_STREAM_WITH_SEID, 483 A2DP_W4_OPEN_STREAM_WITH_SEID, 484 A2DP_W2_START_STREAM_WITH_SEID, 485 A2DP_W2_ABORT_STREAM_WITH_SEID, //15 486 A2DP_W2_STOP_STREAM_WITH_SEID, 487 A2DP_STREAMING_OPENED 488 } a2dp_state_t; 489 490 typedef struct { 491 bool discover_seps; 492 bool outgoing_active; 493 bool have_config; 494 bool stream_endpoint_configured; 495 a2dp_state_t state; 496 struct avdtp_stream_endpoint * local_stream_endpoint; 497 } a2dp_config_process_t; 498 499 typedef struct { 500 btstack_linked_item_t item; 501 bd_addr_t remote_addr; 502 503 uint16_t avdtp_cid; 504 hci_con_handle_t con_handle; 505 506 // SDP results 507 uint16_t avdtp_l2cap_psm; 508 uint16_t avdtp_version; 509 bool sink_supported; 510 bool source_supported; 511 512 uint16_t l2cap_signaling_cid; 513 uint16_t l2cap_mtu; 514 515 avdtp_connection_state_t state; 516 avdtp_acceptor_connection_state_t acceptor_connection_state; 517 avdtp_initiator_connection_state_t initiator_connection_state; 518 519 // used to reassemble fragmented commands 520 avdtp_signaling_packet_t acceptor_signaling_packet; 521 522 // used to prepare outgoing signaling packets 523 avdtp_signaling_packet_t initiator_signaling_packet; 524 525 uint8_t initiator_local_seid; 526 uint8_t initiator_remote_seid; 527 528 uint8_t acceptor_local_seid; 529 530 uint16_t delay_ms; 531 532 // for repeating the set_configuration 533 void * active_stream_endpoint; 534 535 uint8_t initiator_transaction_label; 536 uint8_t acceptor_transaction_label; 537 bool wait_to_send_acceptor; 538 bool wait_to_send_initiator; 539 540 uint8_t suspended_seids[AVDTP_MAX_NUM_SEPS]; 541 uint8_t num_suspended_seids; 542 543 uint8_t reject_service_category; 544 avdtp_signal_identifier_t reject_signal_identifier; 545 uint8_t error_code; 546 547 // configuration state machine 548 avtdp_configuration_state_t configuration_state; 549 550 bool incoming_declined; 551 btstack_timer_source_t retry_timer; 552 553 // A2DP SOURCE 554 a2dp_config_process_t a2dp_source_config_process; 555 556 // A2DP SINK 557 a2dp_config_process_t a2dp_sink_config_process; 558 559 } avdtp_connection_t; 560 561 562 typedef struct avdtp_stream_endpoint { 563 btstack_linked_item_t item; 564 565 // original capabilities configured via avdtp_register_x_category 566 avdtp_sep_t sep; 567 568 // media codec configuration - provided by user 569 uint16_t media_codec_configuration_len; 570 uint8_t * media_codec_configuration_info; 571 572 avdtp_sep_t remote_sep; 573 hci_con_handle_t media_con_handle; 574 uint16_t l2cap_media_cid; 575 uint16_t l2cap_reporting_cid; 576 uint16_t l2cap_recovery_cid; 577 578 avdtp_stream_endpoint_state_t state; 579 avdtp_acceptor_stream_endpoint_state_t acceptor_config_state; 580 avdtp_initiator_stream_endpoint_state_t initiator_config_state; 581 a2dp_state_t a2dp_state; 582 // active connection 583 avdtp_connection_t * connection; 584 585 // currently active remote seid 586 avdtp_capabilities_t remote_capabilities; 587 uint16_t remote_capabilities_bitmap; 588 589 uint16_t remote_configuration_bitmap; 590 avdtp_capabilities_t remote_configuration; 591 592 // temporary codec config used by A2DP Source 593 uint8_t set_config_remote_seid; 594 avdtp_media_codec_type_t media_codec_type; 595 uint8_t media_codec_info[8]; 596 597 // preferred SBC codec settings 598 uint32_t preferred_sampling_frequency; 599 uint8_t preferred_channel_mode; 600 601 // register request for media L2cap connection release 602 uint8_t media_disconnect; 603 uint8_t media_connect; 604 uint8_t start_stream; 605 uint8_t close_stream; 606 bool request_can_send_now; 607 uint8_t abort_stream; 608 uint8_t suspend_stream; 609 uint16_t sequence_number; 610 } avdtp_stream_endpoint_t; 611 612 void avdtp_init(void); 613 void avdtp_deinit(void); 614 615 avdtp_connection_t * avdtp_get_connection_for_bd_addr(bd_addr_t addr); 616 avdtp_connection_t * avdtp_get_connection_for_avdtp_cid(uint16_t avdtp_cid); 617 avdtp_connection_t * avdtp_get_connection_for_l2cap_signaling_cid(uint16_t l2cap_cid); 618 btstack_linked_list_t * avdtp_get_connections(void); 619 btstack_linked_list_t * avdtp_get_stream_endpoints(void); 620 621 avdtp_stream_endpoint_t * avdtp_get_stream_endpoint_for_seid(uint16_t seid); 622 avdtp_stream_endpoint_t * avdtp_get_source_stream_endpoint_for_media_codec(avdtp_media_codec_type_t codec_type); 623 avdtp_stream_endpoint_t * avdtp_get_source_stream_endpoint_for_media_codec_other(uint32_t vendor_id, uint16_t codec_id); 624 avdtp_stream_endpoint_t * avdtp_get_source_stream_endpoint_for_media_codec_and_type(avdtp_media_codec_type_t codec_type, avdtp_sep_type_t sep_type); 625 626 btstack_packet_handler_t avdtp_packet_handler_for_stream_endpoint(const avdtp_stream_endpoint_t *stream_endpoint); 627 void avdtp_emit_sink_and_source(uint8_t * packet, uint16_t size); 628 void avdtp_emit_source(uint8_t * packet, uint16_t size); 629 630 void avdtp_register_media_transport_category(avdtp_stream_endpoint_t * stream_endpoint); 631 void avdtp_register_reporting_category(avdtp_stream_endpoint_t * stream_endpoint); 632 void avdtp_register_delay_reporting_category(avdtp_stream_endpoint_t * stream_endpoint); 633 void avdtp_register_recovery_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t maximum_recovery_window_size, uint8_t maximum_number_media_packets); 634 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); 635 void avdtp_register_header_compression_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t back_ch, uint8_t media, uint8_t recovery); 636 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, const uint8_t *media_codec_info, uint16_t media_codec_info_len); 637 void avdtp_register_multiplexing_category(avdtp_stream_endpoint_t * stream_endpoint, uint8_t fragmentation); 638 639 // sink only 640 void avdtp_register_media_handler(void (*callback)(uint8_t local_seid, uint8_t *packet, uint16_t size)); 641 642 void avdtp_packet_handler(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size); 643 avdtp_stream_endpoint_t * avdtp_create_stream_endpoint(avdtp_sep_type_t sep_type, avdtp_media_type_t media_type); 644 void avdtp_finalize_stream_endpoint(avdtp_stream_endpoint_t * stream_endpoint); 645 646 uint8_t avdtp_connect(bd_addr_t remote, avdtp_role_t role, uint16_t * avdtp_cid); 647 uint8_t avdtp_disconnect(uint16_t avdtp_cid); 648 void avdtp_register_sink_packet_handler(btstack_packet_handler_t callback); 649 void avdtp_register_source_packet_handler(btstack_packet_handler_t callback); 650 651 uint8_t avdtp_open_stream(uint16_t avdtp_cid, uint8_t local_seid, uint8_t remote_seid); 652 uint8_t avdtp_start_stream(uint16_t avdtp_cid, uint8_t local_seid); 653 uint8_t avdtp_stop_stream (uint16_t avdtp_cid, uint8_t local_seid); 654 uint8_t avdtp_abort_stream(uint16_t avdtp_cid, uint8_t local_seid); 655 uint8_t avdtp_suspend_stream(uint16_t avdtp_cid, uint8_t local_seid); 656 657 uint8_t avdtp_discover_stream_endpoints(uint16_t avdtp_cid); 658 uint8_t avdtp_get_capabilities(uint16_t avdtp_cid, uint8_t remote_seid); 659 uint8_t avdtp_get_all_capabilities(uint16_t avdtp_cid, uint8_t remote_seid, avdtp_role_t role); 660 uint8_t avdtp_get_configuration(uint16_t avdtp_cid, uint8_t remote_seid); 661 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); 662 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); 663 uint8_t avdtp_validate_media_configuration(const avdtp_stream_endpoint_t *stream_endpoint, uint16_t avdtp_cid, 664 uint8_t reconfigure, const adtvp_media_codec_capabilities_t *media_codec); 665 666 // frequency will be used by avdtp_choose_sbc_sampling_frequency (if supported by both endpoints) 667 void avdtp_set_preferred_sampling_frequency(avdtp_stream_endpoint_t * stream_endpoint, uint32_t sampling_frequency); 668 669 // channel_mode will be used by avdtp_choose_sbc_channel_mode (if supported by both endpoints) 670 void avdtp_set_preferred_channel_mode(avdtp_stream_endpoint_t * stream_endpoint, uint8_t channel_mode); 671 672 void avdtp_set_preferred_sbc_channel_mode(avdtp_stream_endpoint_t * stream_endpoint, uint32_t sampling_frequency); 673 674 avdtp_channel_mode_t avdtp_choose_sbc_channel_mode(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_channel_mode_bitmap); 675 avdtp_sbc_allocation_method_t avdtp_choose_sbc_allocation_method(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_allocation_method_bitmap); 676 uint16_t avdtp_choose_sbc_sampling_frequency(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_sampling_frequency_bitmap); 677 uint8_t avdtp_choose_sbc_subbands(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_subbands_bitmap); 678 uint8_t avdtp_choose_sbc_block_length(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_block_length_bitmap); 679 uint8_t avdtp_choose_sbc_max_bitpool_value(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_max_bitpool_value); 680 uint8_t avdtp_choose_sbc_min_bitpool_value(avdtp_stream_endpoint_t * stream_endpoint, uint8_t remote_min_bitpool_value); 681 682 uint8_t avdtp_stream_endpoint_seid(avdtp_stream_endpoint_t * stream_endpoint); 683 684 uint8_t is_avdtp_remote_seid_registered(avdtp_stream_endpoint_t * stream_endpoint); 685 686 uint8_t avdtp_get_next_transaction_label(void); 687 688 #ifdef ENABLE_AVDTP_ACCEPTOR_EXPLICIT_START_STREAM_CONFIRMATION 689 uint8_t avdtp_start_stream_accept(uint16_t avdtp_cid, uint8_t local_seid); 690 uint8_t avdtp_start_stream_reject(uint16_t avdtp_cid, uint8_t local_seid); 691 #endif 692 693 #if defined __cplusplus 694 } 695 #endif 696 697 #endif // AVDTP_H 698