1 /* 2 * Copyright (C) 2014 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 * HFP Hands-Free (HF) unit and Audio Gateway Commons 40 * 41 */ 42 43 #ifndef BTSTACK_HFP_H 44 #define BTSTACK_HFP_H 45 46 #include "hci.h" 47 #include "classic/sdp_client_rfcomm.h" 48 49 #if defined __cplusplus 50 extern "C" { 51 #endif 52 53 54 /* HF Supported Features: 55 0: EC and/or NR function 56 1: Three-way calling 57 2: CLI presentation capability 58 3: Voice recognition activation 59 4: Remote volume control 60 5: Enhanced call status 61 6: Enhanced call control 62 7: Codec negotiation 63 8: HF Indicators 64 9: eSCO S4 (and T2) Settings Supported 65 10-31: Reserved for future definition 66 */ 67 #define HFP_HFSF_EC_NR_FUNCTION 0 68 #define HFP_HFSF_THREE_WAY_CALLING 1 69 #define HFP_HFSF_CLI_PRESENTATION_CAPABILITY 2 70 #define HFP_HFSF_VOICE_RECOGNITION_FUNCTION 3 71 #define HFP_HFSF_REMOTE_VOLUME_CONTROL 4 72 #define HFP_HFSF_ENHANCED_CALL_STATUS 5 73 #define HFP_HFSF_ENHANCED_CALL_CONTROL 6 74 #define HFP_HFSF_CODEC_NEGOTIATION 7 75 #define HFP_HFSF_HF_INDICATORS 8 76 #define HFP_HFSF_ESCO_S4 9 77 #define HFP_HFSF_ENHANCED_VOICE_RECOGNITION_STATUS 10 78 #define HFP_HFSF_VOICE_RECOGNITION_TEXT 11 79 80 /* AG Supported Features: 81 0: Three-way calling 82 1: EC and/or NR function 83 2: Voice recognition function 84 3: In-band ring tone capability 85 4: Attach a number to a voice tag 86 5: Ability to reject a call 87 6: Enhanced call status 88 7: Enhanced call control 89 8: Extended Error Result Codes 90 9: Codec negotiation 91 10: HF Indicators 92 11: eSCO S4 (and T2) Settings Supported 93 12-31: Reserved for future definition 94 */ 95 #define HFP_AGSF_THREE_WAY_CALLING 0 96 #define HFP_AGSF_EC_NR_FUNCTION 1 97 #define HFP_AGSF_VOICE_RECOGNITION_FUNCTION 2 98 #define HFP_AGSF_IN_BAND_RING_TONE 3 99 #define HFP_AGSF_ATTACH_A_NUMBER_TO_A_VOICE_TAG 4 100 #define HFP_AGSF_ABILITY_TO_REJECT_A_CALL 5 101 #define HFP_AGSF_ENHANCED_CALL_STATUS 6 102 #define HFP_AGSF_ENHANCED_CALL_CONTROL 7 103 #define HFP_AGSF_EXTENDED_ERROR_RESULT_CODES 8 104 #define HFP_AGSF_CODEC_NEGOTIATION 9 105 #define HFP_AGSF_HF_INDICATORS 10 106 #define HFP_AGSF_ESCO_S4 11 107 #define HFP_AGSF_ENHANCED_VOICE_RECOGNITION_STATUS 12 108 #define HFP_AGSF_VOICE_RECOGNITION_TEXT 13 109 110 #define HFP_DEFAULT_HF_SUPPORTED_FEATURES 0x0000 111 #define HFP_DEFAULT_AG_SUPPORTED_FEATURES 0x0009 112 113 #define HFP_MAX_NUM_INDICATORS 10 114 #define HFP_MAX_NUM_CALL_SERVICES 20 115 #define HFP_CALL_SERVICE_SIZE 3 116 #define HFP_MAX_NUM_CODECS 10 117 118 #define HFP_MAX_INDICATOR_DESC_SIZE 20 119 #define HFP_MAX_VR_TEXT_SIZE 100 120 #define HFP_MAX_NETWORK_OPERATOR_NAME_SIZE 17 121 122 123 #define HFP_SUPPORTED_FEATURES "+BRSF" 124 #define HFP_AVAILABLE_CODECS "+BAC" 125 #define HFP_INDICATOR "+CIND" 126 #define HFP_ENABLE_STATUS_UPDATE_FOR_AG_INDICATORS "+CMER" 127 #define HFP_ENABLE_CLIP "+CLIP" 128 #define HFP_ENABLE_CALL_WAITING_NOTIFICATION "+CCWA" 129 #define HFP_UPDATE_ENABLE_STATUS_FOR_INDIVIDUAL_AG_INDICATORS "+BIA" // +BIA:<enabled>,,<enabled>,,,<enabled> 130 #define HFP_SUPPORT_CALL_HOLD_AND_MULTIPARTY_SERVICES "+CHLD" 131 #define HFP_GENERIC_STATUS_INDICATOR "+BIND" 132 #define HFP_TRANSFER_AG_INDICATOR_STATUS "+CIEV" // +CIEV: <index>,<value> 133 #define HFP_TRANSFER_HF_INDICATOR_STATUS "+BIEV" // +BIEC: <index>,<value> 134 #define HFP_QUERY_OPERATOR_SELECTION "+COPS" // +COPS: <mode>,0,<opearator> 135 #define HFP_ENABLE_EXTENDED_AUDIO_GATEWAY_ERROR "+CMEE" 136 #define HFP_EXTENDED_AUDIO_GATEWAY_ERROR "+CME ERROR" 137 #define HFP_TRIGGER_CODEC_CONNECTION_SETUP "+BCC" 138 #define HFP_CONFIRM_COMMON_CODEC "+BCS" 139 #define HFP_ANSWER_CALL "ATA" 140 #define HFP_HANG_UP_CALL "+CHUP" 141 #define HFP_CHANGE_IN_BAND_RING_TONE_SETTING "+BSIR" 142 #define HFP_CALL_PHONE_NUMBER "ATD" 143 #define HFP_REDIAL_LAST_NUMBER "+BLDN" 144 #define HFP_TURN_OFF_EC_AND_NR "+NREC" // EC (Echo CAnceling), NR (Noise Reduction) 145 #define HFP_ACTIVATE_VOICE_RECOGNITION "+BVRA" // Voice Recognition 146 #define HFP_SET_MICROPHONE_GAIN "+VGM" 147 #define HFP_SET_SPEAKER_GAIN "+VGS" 148 #define HFP_PHONE_NUMBER_FOR_VOICE_TAG "+BINP" 149 #define HFP_TRANSMIT_DTMF_CODES "+VTS" 150 #define HFP_SUBSCRIBER_NUMBER_INFORMATION "+CNUM" 151 #define HFP_LIST_CURRENT_CALLS "+CLCC" 152 #define HFP_RESPONSE_AND_HOLD "+BTRH" 153 154 #define HFP_OK "OK" 155 #define HFP_ERROR "ERROR" 156 #define HFP_RING "RING" 157 158 // Codecs 159 #define HFP_CODEC_CVSD 0x01 160 #define HFP_CODEC_MSBC 0x02 161 162 typedef enum { 163 HFP_ROLE_INVALID = 0, 164 HFP_ROLE_AG, 165 HFP_ROLE_HF, 166 } hfp_role_t; 167 168 typedef enum { 169 HFP_CMD_NONE = 0, 170 HFP_CMD_ERROR, 171 HFP_CMD_UNKNOWN, 172 HFP_CMD_OK, 173 HFP_CMD_RING, 174 HFP_CMD_SUPPORTED_FEATURES, // 5 175 HFP_CMD_AVAILABLE_CODECS, 176 HFP_CMD_RETRIEVE_AG_INDICATORS_GENERIC, 177 HFP_CMD_RETRIEVE_AG_INDICATORS, 178 HFP_CMD_RETRIEVE_AG_INDICATORS_STATUS, 179 HFP_CMD_ENABLE_INDICATOR_STATUS_UPDATE, // 10 180 HFP_CMD_ENABLE_INDIVIDUAL_AG_INDICATOR_STATUS_UPDATE, 181 HFP_CMD_SUPPORT_CALL_HOLD_AND_MULTIPARTY_SERVICES, 182 HFP_CMD_ENABLE_CLIP, 183 HFP_CMD_AG_SENT_CLIP_INFORMATION, 184 HFP_CMD_ENABLE_CALL_WAITING_NOTIFICATION, // 15 185 HFP_CMD_AG_SENT_CALL_WAITING_NOTIFICATION_UPDATE, 186 HFP_CMD_LIST_GENERIC_STATUS_INDICATORS, 187 HFP_CMD_RETRIEVE_GENERIC_STATUS_INDICATORS, 188 HFP_CMD_RETRIEVE_GENERIC_STATUS_INDICATORS_STATE, 189 HFP_CMD_SET_GENERIC_STATUS_INDICATOR_STATUS, // 20 190 HFP_CMD_TRANSFER_AG_INDICATOR_STATUS, 191 HFP_CMD_QUERY_OPERATOR_SELECTION_NAME, 192 HFP_CMD_QUERY_OPERATOR_SELECTION_NAME_FORMAT, 193 HFP_CMD_ENABLE_EXTENDED_AUDIO_GATEWAY_ERROR, 194 HFP_CMD_EXTENDED_AUDIO_GATEWAY_ERROR, // 25 195 HFP_CMD_TRIGGER_CODEC_CONNECTION_SETUP, 196 HFP_CMD_AG_SEND_COMMON_CODEC, 197 HFP_CMD_AG_SUGGESTED_CODEC, 198 HFP_CMD_HF_CONFIRMED_CODEC, 199 HFP_CMD_CALL_ANSWERED, 200 HFP_CMD_CALL_HOLD, 201 HFP_CMD_HANG_UP_CALL, 202 HFP_CMD_CHANGE_IN_BAND_RING_TONE_SETTING, 203 HFP_CMD_CALL_PHONE_NUMBER, 204 HFP_CMD_REDIAL_LAST_NUMBER, 205 HFP_CMD_TURN_OFF_EC_AND_NR, 206 HFP_CMD_AG_ACTIVATE_VOICE_RECOGNITION, 207 HFP_CMD_HF_ACTIVATE_VOICE_RECOGNITION, 208 HFP_CMD_AG_ACTIVATE_ENHANCED_VOICE_RECOGNITION, 209 HFP_CMD_HF_REQUEST_PHONE_NUMBER, 210 HFP_CMD_AG_SENT_PHONE_NUMBER, 211 HFP_CMD_TRANSMIT_DTMF_CODES, 212 HFP_CMD_SET_MICROPHONE_GAIN, 213 HFP_CMD_SET_SPEAKER_GAIN, 214 HFP_CMD_GET_SUBSCRIBER_NUMBER_INFORMATION, 215 HFP_CMD_LIST_CURRENT_CALLS, 216 HFP_CMD_RESPONSE_AND_HOLD_QUERY, 217 HFP_CMD_RESPONSE_AND_HOLD_COMMAND, 218 HFP_CMD_RESPONSE_AND_HOLD_STATUS, 219 HFP_CMD_HF_INDICATOR_STATUS 220 } hfp_command_t; 221 222 223 typedef enum { 224 HFP_CME_ERROR_AG_FAILURE = 0, 225 HFP_CME_ERROR_NO_CONNECTION_TO_PHONE, 226 HFP_CME_ERROR_2, 227 HFP_CME_ERROR_OPERATION_NOT_ALLOWED, 228 HFP_CME_ERROR_OPERATION_NOT_SUPPORTED, 229 HFP_CME_ERROR_PH_SIM_PIN_REQUIRED, 230 HFP_CME_ERROR_6, 231 HFP_CME_ERROR_7, 232 HFP_CME_ERROR_8, 233 HFP_CME_ERROR_9, 234 HFP_CME_ERROR_SIM_NOT_INSERTED, 235 HFP_CME_ERROR_SIM_PIN_REQUIRED, 236 HFP_CME_ERROR_SIM_PUK_REQUIRED, 237 HFP_CME_ERROR_SIM_FAILURE, 238 HFP_CME_ERROR_SIM_BUSY, 239 HFP_CME_ERROR_15, 240 HFP_CME_ERROR_INCORRECT_PASSWORD, 241 HFP_CME_ERROR_SIM_PIN2_REQUIRED, 242 HFP_CME_ERROR_SIM_PUK2_REQUIRED, 243 HFP_CME_ERROR_19, 244 HFP_CME_ERROR_MEMORY_FULL, 245 HFP_CME_ERROR_INVALID_INDEX, 246 HFP_CME_ERROR_22, 247 HFP_CME_ERROR_MEMORY_FAILURE, 248 HFP_CME_ERROR_TEXT_STRING_TOO_LONG, 249 HFP_CME_ERROR_INVALID_CHARACTERS_IN_TEXT_STRING, 250 HFP_CME_ERROR_DIAL_STRING_TOO_LONG, 251 HFP_CME_ERROR_INVALID_CHARACTERS_IN_DIAL_STRING, 252 HFP_CME_ERROR_28, 253 HFP_CME_ERROR_29, 254 HFP_CME_ERROR_NO_NETWORK_SERVICE, 255 HFP_CME_ERROR_NETWORK_TIMEOUT, 256 HFP_CME_ERROR_NETWORK_NOT_ALLOWED_EMERGENCY_CALLS_ONLY 257 } hfp_cme_error_t; 258 259 typedef enum { 260 HFP_CALL_STATUS_NO_HELD_OR_ACTIVE_CALLS = 0, 261 HFP_CALL_STATUS_ACTIVE_OR_HELD_CALL_IS_PRESENT 262 } hfp_call_status_t; 263 264 typedef enum { 265 HFP_CALLSETUP_STATUS_NO_CALL_SETUP_IN_PROGRESS = 0, 266 HFP_CALLSETUP_STATUS_INCOMING_CALL_SETUP_IN_PROGRESS, 267 HFP_CALLSETUP_STATUS_OUTGOING_CALL_SETUP_IN_DIALING_STATE, 268 HFP_CALLSETUP_STATUS_OUTGOING_CALL_SETUP_IN_ALERTING_STATE 269 } hfp_callsetup_status_t; 270 271 typedef enum { 272 HFP_CALLHELD_STATUS_NO_CALLS_HELD = 0, 273 HFP_CALLHELD_STATUS_CALL_ON_HOLD_OR_SWAPPED, 274 HFP_CALLHELD_STATUS_CALL_ON_HOLD_AND_NO_ACTIVE_CALLS 275 } hfp_callheld_status_t; 276 277 278 typedef enum { 279 HFP_AG_INCOMING_CALL, 280 HFP_AG_INCOMING_CALL_ACCEPTED_BY_AG, 281 HFP_AG_INCOMING_CALL_ACCEPTED_BY_HF, 282 HFP_AG_AUDIO_CONNECTION_ESTABLISHED, 283 HFP_AG_OUTGOING_CALL_INITIATED_BY_AG, 284 HFP_AG_OUTGOING_CALL_INITIATED_BY_HF, 285 HFP_AG_OUTGOING_CALL_REJECTED, 286 HFP_AG_OUTGOING_CALL_ACCEPTED, 287 HFP_AG_OUTGOING_CALL_RINGING, 288 HFP_AG_OUTGOING_CALL_ESTABLISHED, 289 HFP_AG_OUTGOING_REDIAL_INITIATED, 290 HFP_AG_HELD_CALL_JOINED_BY_AG, 291 HFP_AG_TERMINATE_CALL_BY_AG, 292 HFP_AG_TERMINATE_CALL_BY_HF, 293 HFP_AG_CALL_DROPPED, 294 HFP_AG_RESPONSE_AND_HOLD_ACCEPT_INCOMING_CALL_BY_AG, 295 HFP_AG_RESPONSE_AND_HOLD_ACCEPT_HELD_CALL_BY_AG, 296 HFP_AG_RESPONSE_AND_HOLD_REJECT_HELD_CALL_BY_AG, 297 HFP_AG_RESPONSE_AND_HOLD_ACCEPT_INCOMING_CALL_BY_HF, 298 HFP_AG_RESPONSE_AND_HOLD_ACCEPT_HELD_CALL_BY_HF, 299 HFP_AG_RESPONSE_AND_HOLD_REJECT_HELD_CALL_BY_HF, 300 HFP_AG_CALL_HOLD_USER_BUSY, 301 HFP_AG_CALL_HOLD_RELEASE_ACTIVE_ACCEPT_HELD_OR_WAITING_CALL, 302 HFP_AG_CALL_HOLD_PARK_ACTIVE_ACCEPT_HELD_OR_WAITING_CALL, 303 HFP_AG_CALL_HOLD_ADD_HELD_CALL, 304 HFP_AG_CALL_HOLD_EXIT_AND_JOIN_CALLS, 305 HFP_AG_SET_CLIP 306 } hfp_ag_call_event_t; 307 308 309 typedef enum { 310 HFP_PARSER_CMD_HEADER = 0, 311 HFP_PARSER_CMD_SEQUENCE, 312 HFP_PARSER_SECOND_ITEM, 313 HFP_PARSER_THIRD_ITEM 314 } hfp_parser_state_t; 315 316 typedef enum { 317 HFP_VOICE_RECOGNITION_STATE_AG_READY = 0, 318 HFP_VOICE_RECOGNITION_STATE_AG_READY_TO_ACCEPT_AUDIO_INPUT = 1, 319 HFP_VOICE_RECOGNITION_STATE_AG_IS_SENDING_AUDIO_TO_HF = 2, 320 HFP_VOICE_RECOGNITION_STATE_AG_IS_PROCESSING_AUDIO_INPUT = 4 321 } hfp_voice_recognition_state_t; 322 323 typedef enum { 324 HFP_TEXT_TYPE_RECOGNISED_FROM_HF_AUDIO = 0, 325 HFP_TEXT_TYPE_MESSAGE_FROM_AG, 326 HFP_TEXT_TYPE_QUESTION_FROM_AG, 327 HFP_TEXT_TYPE_ERROR_FROM_AG 328 } hfp_text_type_t; 329 330 typedef enum { 331 HFP_TEXT_OPERATION_NEW_TEXT = 1, 332 HFP_TEXT_OPERATION_REPLACE, 333 HFP_TEXT_OPERATION_APPEND 334 } hfp_text_operation_t; 335 336 typedef enum { 337 HFP_IDLE = 0, //0 338 HFP_SDP_QUERY_RFCOMM_CHANNEL, 339 HFP_W2_SEND_SDP_QUERY, 340 HFP_W4_SDP_QUERY_COMPLETE, 341 HFP_W4_RFCOMM_CONNECTED, 342 343 HFP_EXCHANGE_SUPPORTED_FEATURES, // 5 344 HFP_W4_EXCHANGE_SUPPORTED_FEATURES, 345 346 HFP_NOTIFY_ON_CODECS, 347 HFP_W4_NOTIFY_ON_CODECS, 348 349 HFP_RETRIEVE_INDICATORS, 350 HFP_W4_RETRIEVE_INDICATORS, // 10 351 352 HFP_RETRIEVE_INDICATORS_STATUS, 353 HFP_W4_RETRIEVE_INDICATORS_STATUS, 354 355 HFP_ENABLE_INDICATORS_STATUS_UPDATE, 356 HFP_W4_ENABLE_INDICATORS_STATUS_UPDATE, 357 358 HFP_RETRIEVE_CAN_HOLD_CALL, // 15 359 HFP_W4_RETRIEVE_CAN_HOLD_CALL, 360 361 HFP_LIST_GENERIC_STATUS_INDICATORS, 362 HFP_W4_LIST_GENERIC_STATUS_INDICATORS, 363 364 HFP_RETRIEVE_GENERIC_STATUS_INDICATORS, 365 HFP_W4_RETRIEVE_GENERIC_STATUS_INDICATORS, //20 366 367 HFP_RETRIEVE_INITITAL_STATE_GENERIC_STATUS_INDICATORS, 368 HFP_W4_RETRIEVE_INITITAL_STATE_GENERIC_STATUS_INDICATORS, 369 370 HFP_SERVICE_LEVEL_CONNECTION_ESTABLISHED, 371 372 HFP_W2_CONNECT_SCO, 373 HFP_W4_SCO_CONNECTED, 374 375 HFP_AUDIO_CONNECTION_ESTABLISHED, 376 377 378 HFP_W2_DISCONNECT_SCO, 379 HFP_W4_SCO_DISCONNECTED, 380 HFP_W4_SCO_DISCONNECTED_TO_SHUTDOWN, 381 HFP_W4_WBS_SHUTDOWN, 382 383 HFP_W2_DISCONNECT_RFCOMM, 384 HFP_W4_RFCOMM_DISCONNECTED, 385 HFP_W4_RFCOMM_DISCONNECTED_AND_RESTART, 386 HFP_W4_CONNECTION_ESTABLISHED_TO_SHUTDOWN 387 } hfp_state_t; 388 389 390 typedef enum { 391 HFP_VRA_VOICE_RECOGNITION_OFF, 392 393 HFP_VRA_W4_VOICE_RECOGNITION_OFF, 394 HFP_VRA_W4_VOICE_RECOGNITION_ACTIVATED, 395 HFP_VRA_VOICE_RECOGNITION_ACTIVATED, 396 397 HFP_VRA_W4_ENHANCED_VOICE_RECOGNITION_OFF, 398 HFP_VRA_W4_ENHANCED_VOICE_RECOGNITION_ACTIVATED, 399 HFP_VRA_W4_ENHANCED_VOICE_RECOGNITION_STATUS, 400 HFP_VRA_W4_ENHANCED_VOICE_RECOGNITION_MSG, 401 HFP_VRA_W4_ENHANCED_VOICE_RECOGNITION_NEW_SESSION, 402 HFP_VRA_ENHANCED_VOICE_RECOGNITION_ACTIVATED 403 } hfp_voice_recognition_activation_status_t; 404 405 typedef struct { 406 uint16_t text_id; 407 hfp_text_type_t text_type; 408 hfp_text_operation_t text_operation; 409 uint8_t * text; 410 } hfp_voice_recognition_message_t; 411 412 typedef enum { 413 HFP_CODECS_IDLE, 414 HFP_CODECS_RECEIVED_LIST, 415 HFP_CODECS_RECEIVED_TRIGGER_CODEC_EXCHANGE, 416 HFP_CODECS_W4_AG_COMMON_CODEC, 417 HFP_CODECS_AG_SENT_COMMON_CODEC, 418 HFP_CODECS_AG_RESEND_COMMON_CODEC, 419 HFP_CODECS_HF_CONFIRMED_CODEC, 420 HFP_CODECS_EXCHANGED, 421 HFP_CODECS_ERROR 422 } hfp_codecs_state_t; 423 424 typedef enum { 425 HFP_CALL_IDLE, 426 HFP_CALL_TRIGGER_AUDIO_CONNECTION, 427 HFP_CALL_W4_AUDIO_CONNECTION_FOR_IN_BAND_RING, 428 HFP_CALL_RINGING, 429 HFP_CALL_W4_AUDIO_CONNECTION_FOR_ACTIVE, 430 HFP_CALL_ACTIVE, 431 HFP_CALL_W2_SEND_CALL_WAITING, 432 HFP_CALL_W4_CHLD, 433 HFP_CALL_OUTGOING_INITIATED, 434 HFP_CALL_OUTGOING_DIALING, 435 HFP_CALL_OUTGOING_RINGING 436 } hfp_call_state_t; 437 438 typedef enum{ 439 HFP_ENHANCED_CALL_DIR_OUTGOING, 440 HFP_ENHANCED_CALL_DIR_INCOMING 441 } hfp_enhanced_call_dir_t; 442 443 typedef enum{ 444 HFP_ENHANCED_CALL_STATUS_ACTIVE, 445 HFP_ENHANCED_CALL_STATUS_HELD, 446 HFP_ENHANCED_CALL_STATUS_OUTGOING_DIALING, 447 HFP_ENHANCED_CALL_STATUS_OUTGOING_ALERTING, 448 HFP_ENHANCED_CALL_STATUS_INCOMING, 449 HFP_ENHANCED_CALL_STATUS_INCOMING_WAITING, 450 HFP_ENHANCED_CALL_STATUS_CALL_HELD_BY_RESPONSE_AND_HOLD 451 } hfp_enhanced_call_status_t; 452 453 typedef enum{ 454 HFP_ENHANCED_CALL_MODE_VOICE, 455 HFP_ENHANCED_CALL_MODE_DATA, 456 HFP_ENHANCED_CALL_MODE_FAX 457 } hfp_enhanced_call_mode_t; 458 459 typedef enum{ 460 HFP_ENHANCED_CALL_MPTY_NOT_A_CONFERENCE_CALL, 461 HFP_ENHANCED_CALL_MPTY_CONFERENCE_CALL 462 } hfp_enhanced_call_mpty_t; 463 464 typedef enum { 465 HFP_RESPONSE_AND_HOLD_INCOMING_ON_HOLD = 0, 466 HFP_RESPONSE_AND_HOLD_HELD_INCOMING_ACCEPTED, 467 HFP_RESPONSE_AND_HOLD_HELD_INCOMING_REJECTED 468 } hfp_response_and_hold_state_t; 469 470 typedef enum { 471 HFP_HF_QUERY_OPERATOR_FORMAT_NOT_SET = 0, 472 HFP_HF_QUERY_OPERATOR_SET_FORMAT, 473 HFP_HF_QUERY_OPERATOR_W4_SET_FORMAT_OK, 474 HFP_HF_QUERY_OPERATOR_FORMAT_SET, 475 HFP_HF_QUERY_OPERATOR_SEND_QUERY, 476 HPF_HF_QUERY_OPERATOR_W4_RESULT 477 } hfp_hf_query_operator_state_t; 478 479 typedef enum { 480 HFP_LINK_SETTINGS_D0 = 0, 481 HFP_LINK_SETTINGS_D1, 482 HFP_LINK_SETTINGS_S1, 483 HFP_LINK_SETTINGS_S2, 484 HFP_LINK_SETTINGS_S3, 485 HFP_LINK_SETTINGS_S4, 486 HFP_LINK_SETTINGS_T1, 487 HFP_LINK_SETTINGS_T2, 488 HFP_LINK_SETTINGS_NONE, 489 } hfp_link_settings_t; 490 491 typedef enum{ 492 HFP_NONE_SM, 493 HFP_SLC_SM, 494 HFP_SLC_QUERIES_SM, 495 HFP_CODECS_CONNECTION_SM, 496 HFP_AUDIO_CONNECTION_SM, 497 HFP_CALL_SM 498 } hfp_state_machine_t; 499 500 typedef struct{ 501 uint16_t uuid; 502 uint8_t state; // enabled 503 } hfp_generic_status_indicator_t; 504 505 typedef struct{ 506 uint8_t index; 507 char name[HFP_MAX_INDICATOR_DESC_SIZE]; 508 uint8_t min_range; 509 uint8_t max_range; 510 uint8_t status; 511 uint8_t mandatory; 512 uint8_t enabled; 513 uint8_t status_changed; 514 } hfp_ag_indicator_t; 515 516 typedef struct{ 517 char name[HFP_CALL_SERVICE_SIZE]; 518 } hfp_call_service_t; 519 520 521 typedef struct{ 522 uint8_t mode; 523 uint8_t format; 524 char name[HFP_MAX_NETWORK_OPERATOR_NAME_SIZE]; // enabled 525 } hfp_network_opearator_t; 526 527 528 typedef struct hfp_connection { 529 btstack_linked_item_t item; 530 531 // local role: HF or AG 532 hfp_role_t local_role; 533 534 bd_addr_t remote_addr; 535 hci_con_handle_t acl_handle; 536 hci_con_handle_t sco_handle; 537 uint16_t rfcomm_channel_nr; 538 uint16_t rfcomm_cid; 539 540 hfp_state_machine_t state_machine; 541 hfp_call_state_t call_state; 542 hfp_state_t state; 543 hfp_codecs_state_t codecs_state; 544 545 // needed for reestablishing connection - service uuid of the remote 546 uint16_t service_uuid; 547 548 // used during service level connection establishment 549 hfp_command_t command; 550 hfp_parser_state_t parser_state; 551 int parser_item_index; 552 int parser_indicator_index; 553 uint32_t parser_indicator_value; 554 bool parser_quoted; 555 uint8_t line_buffer[HFP_MAX_VR_TEXT_SIZE]; 556 int line_size; 557 558 uint32_t remote_supported_features; 559 560 uint16_t remote_codecs_nr; 561 uint8_t remote_codecs[HFP_MAX_NUM_CODECS]; 562 563 uint16_t ag_indicators_nr; 564 hfp_ag_indicator_t ag_indicators[HFP_MAX_NUM_INDICATORS]; 565 uint32_t ag_indicators_status_update_bitmap; 566 uint8_t enable_status_update_for_ag_indicators; 567 568 uint16_t remote_call_services_index; 569 hfp_call_service_t remote_call_services[HFP_MAX_NUM_CALL_SERVICES]; 570 571 // TODO: use bitmap. 572 uint16_t generic_status_indicators_nr; 573 uint32_t generic_status_update_bitmap; 574 hfp_generic_status_indicator_t generic_status_indicators[HFP_MAX_NUM_INDICATORS]; 575 576 hfp_network_opearator_t network_operator; 577 578 // Retrieved during service level connection establishment, not used yet 579 uint8_t negotiated_codec; 580 581 // HF -> AG configuration 582 uint8_t clip_enabled; 583 uint8_t call_waiting_notification_enabled; 584 585 // TODO: put these bit flags in a bitmap 586 uint8_t ok_pending; 587 // uint8_t send_ok; 588 uint8_t send_error; 589 590 bool found_equal_sign; 591 uint8_t ignore_value; 592 593 uint8_t change_status_update_for_individual_ag_indicators; 594 uint8_t operator_name_changed; 595 596 uint8_t enable_extended_audio_gateway_error_report; 597 uint8_t extended_audio_gateway_error_value; 598 uint8_t extended_audio_gateway_error; 599 600 // establish codecs connection 601 uint8_t suggested_codec; 602 uint8_t codec_confirmed; 603 uint8_t sco_for_msbc_failed; 604 uint8_t trigger_codec_exchange; 605 606 // establish audio connection 607 hfp_link_settings_t link_setting; 608 uint8_t accept_sco; // 1 = SCO, 2 = eSCO 609 610 uint8_t establish_audio_connection; 611 uint8_t release_audio_connection; 612 uint8_t release_slc_connection; 613 614 btstack_timer_source_t hfp_timeout; 615 616 uint8_t microphone_gain; 617 uint8_t send_microphone_gain; 618 619 uint8_t speaker_gain; 620 uint8_t send_speaker_gain; 621 622 uint8_t send_phone_number_for_voice_tag; 623 uint8_t send_ag_status_indicators; 624 uint8_t send_ag_indicators_segment; 625 uint8_t send_response_and_hold_status; // 0 - don't send. BRTH:0 == 1, .. 626 627 // AG only 628 uint8_t change_in_band_ring_tone_setting; 629 uint8_t ag_ring; 630 uint8_t ag_send_clip; 631 uint8_t ag_echo_and_noise_reduction; 632 uint8_t ag_activate_voice_recognition; 633 uint8_t ag_notify_incoming_call_waiting; 634 uint8_t send_subscriber_number; 635 uint8_t next_subscriber_number_to_send; 636 uint8_t ag_call_hold_action; 637 uint8_t ag_response_and_hold_action; 638 uint8_t ag_dtmf_code; 639 bool ag_send_no_carrier; 640 641 int send_status_of_current_calls; 642 int next_call_index; 643 644 // HF only 645 hfp_hf_query_operator_state_t hf_query_operator_state; 646 uint8_t hf_answer_incoming_call; 647 uint8_t hf_initiate_outgoing_call; 648 uint8_t hf_initiate_memory_dialing; 649 uint8_t hf_initiate_redial_last_number; 650 bool hf_send_codec_confirm; 651 bool hf_send_supported_codecs; 652 653 int memory_id; 654 655 uint8_t hf_send_clip_enable; 656 uint8_t hf_send_chup; 657 uint8_t hf_send_chld_0; 658 uint8_t hf_send_chld_1; 659 uint8_t hf_send_chld_2; 660 uint8_t hf_send_chld_3; 661 uint8_t hf_send_chld_4; 662 uint8_t hf_send_chld_x; 663 uint8_t hf_send_chld_x_index; 664 char hf_send_dtmf_code; 665 uint8_t hf_send_binp; 666 uint8_t hf_send_clcc; 667 uint8_t hf_send_rrh; 668 char hf_send_rrh_command; 669 uint8_t hf_send_cnum; 670 671 uint8_t hf_activate_call_waiting_notification; 672 uint8_t hf_deactivate_call_waiting_notification; 673 674 uint8_t hf_activate_calling_line_notification; 675 uint8_t hf_deactivate_calling_line_notification; 676 uint8_t hf_activate_echo_canceling_and_noise_reduction; 677 uint8_t hf_deactivate_echo_canceling_and_noise_reduction; 678 679 hfp_voice_recognition_activation_status_t vra_status; 680 681 hfp_voice_recognition_activation_status_t ag_vra_status; 682 hfp_voice_recognition_state_t ag_vra_state; 683 684 hfp_voice_recognition_message_t ag_msg; 685 686 uint8_t clcc_idx; 687 uint8_t clcc_dir; 688 uint8_t clcc_status; 689 uint8_t clcc_mode; 690 uint8_t clcc_mpty; 691 692 uint8_t call_index; 693 // also used for CLCC, CCWA, CLIP if set 694 uint8_t bnip_type; // 0 == not set 695 char bnip_number[25]; // 696 697 #ifdef ENABLE_CC256X_ASSISTED_HFP 698 bool cc256x_send_write_codec_config; 699 bool cc256x_send_wbs_associate; 700 bool cc256x_send_wbs_disassociate; 701 #endif 702 #ifdef ENABLE_BCM_PCM_WBS 703 bool bcm_send_enable_wbs; 704 bool bcm_send_disable_wbs; 705 bool bcm_send_write_i2spcm_interface_param; 706 #endif 707 } hfp_connection_t; 708 709 // UTILS_START : TODO move to utils 710 int send_str_over_rfcomm(uint16_t cid, char * command); 711 int join(char * buffer, int buffer_size, uint8_t * values, int values_nr); 712 int join_bitmap(char * buffer, int buffer_size, uint32_t values, int values_nr); 713 int get_bit(uint16_t bitmap, int position); 714 int store_bit(uint32_t bitmap, int position, uint8_t value); 715 // UTILS_END 716 717 void hfp_finalize_connection_context(hfp_connection_t * hfp_connection); 718 void hfp_emit_sco_event(hfp_connection_t * hfp_connection, uint8_t status, hci_con_handle_t con_handle, bd_addr_t addr, uint8_t negotiated_codec); 719 720 void hfp_set_ag_callback(btstack_packet_handler_t callback); 721 void hfp_set_ag_rfcomm_packet_handler(btstack_packet_handler_t handler); 722 723 void hfp_set_hf_callback(btstack_packet_handler_t callback); 724 void hfp_set_hf_rfcomm_packet_handler(btstack_packet_handler_t handler); 725 726 void hfp_init(void); 727 void hfp_deinit(void); 728 729 void hfp_create_sdp_record(uint8_t * service, uint32_t service_record_handle, uint16_t service_uuid, int rfcomm_channel_nr, const char * name); 730 void hfp_handle_hci_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size, hfp_role_t local_role); 731 void hfp_handle_rfcomm_event(uint8_t packet_type, uint16_t channel, uint8_t *packet, uint16_t size, hfp_role_t local_role); 732 void hfp_emit_event(hfp_connection_t * hfp_connection, uint8_t event_subtype, uint8_t value); 733 void hfp_emit_simple_event(hfp_connection_t * hfp_connection, uint8_t event_subtype); 734 void hfp_emit_string_event(hfp_connection_t * hfp_connection, uint8_t event_subtype, const char * value); 735 void hfp_emit_slc_connection_event(hfp_connection_t * hfp_connection, uint8_t status, hci_con_handle_t con_handle, bd_addr_t addr); 736 737 hfp_connection_t * get_hfp_connection_context_for_rfcomm_cid(uint16_t cid); 738 hfp_connection_t * get_hfp_connection_context_for_bd_addr(bd_addr_t bd_addr, hfp_role_t hfp_role); 739 hfp_connection_t * get_hfp_connection_context_for_sco_handle(uint16_t handle, hfp_role_t hfp_role); 740 hfp_connection_t * get_hfp_connection_context_for_acl_handle(uint16_t handle, hfp_role_t hfp_role); 741 742 btstack_linked_list_t * hfp_get_connections(void); 743 void hfp_parse(hfp_connection_t * connection, uint8_t byte, int isHandsFree); 744 745 /** 746 * @brief Establish RFCOMM connection, and perform service level connection agreement: 747 * @param bd_addr 748 * @param service_uuid 749 * @param local_role 750 * @return status ERROR_CODE_SUCCESS if successful, otherwise: 751 * - ERROR_CODE_COMMAND_DISALLOWED if connection already exists, or 752 * - BTSTACK_MEMORY_ALLOC_FAILED 753 */ 754 uint8_t hfp_establish_service_level_connection(bd_addr_t bd_addr, uint16_t service_uuid, hfp_role_t local_role); 755 756 /** 757 * @brief Prepare connection for audio and SLC connections release 758 * @param hfp_connection 759 */ 760 void hfp_trigger_release_service_level_connection(hfp_connection_t * hfp_connection); 761 762 /** 763 * @brief Prepare connection for audio connection release 764 * @param hfp_connection 765 */ 766 void hfp_trigger_release_audio_connection(hfp_connection_t * hfp_connection); 767 768 void hfp_reset_context_flags(hfp_connection_t * hfp_connection); 769 770 void hfp_setup_synchronous_connection(hfp_connection_t * hfp_connection); 771 void hfp_accept_synchronous_connection(hfp_connection_t * hfp_connection, bool incoming_eSCO); 772 int hfp_supports_codec(uint8_t codec, int codecs_nr, uint8_t * codecs); 773 void hfp_hf_drop_mSBC_if_eSCO_not_supported(uint8_t * codecs, uint8_t * codecs_nr); 774 void hfp_init_link_settings(hfp_connection_t * hfp_connection, uint8_t eSCO_S4_supported); 775 hfp_link_settings_t hfp_next_link_setting(hfp_link_settings_t current_setting, bool local_eSCO_supported, bool remote_eSCO_supported, bool eSCO_s4_supported, uint8_t negotiated_codec); 776 777 const char * hfp_hf_feature(int index); 778 const char * hfp_ag_feature(int index); 779 780 void hfp_log_rfcomm_message(const char * tag, uint8_t * packet, uint16_t size); 781 782 const char * hfp_enhanced_call_dir2str(uint16_t index); 783 const char * hfp_enhanced_call_status2str(uint16_t index); 784 const char * hfp_enhanced_call_mode2str(uint16_t index); 785 const char * hfp_enhanced_call_mpty2str(uint16_t index); 786 787 #ifdef ENABLE_CC256X_ASSISTED_HFP 788 void hfp_cc256x_prepare_for_sco(hfp_connection_t * hfp_connection); 789 void hfp_cc256x_write_codec_config(hfp_connection_t * hfp_connection); 790 #endif 791 #ifdef ENABLE_BCM_PCM_WBS 792 void hfp_bcm_prepare_for_sco(hfp_connection_t * hfp_connection); 793 void hfp_bcm_write_i2spcm_interface_param (hfp_connection_t * hfp_connection); 794 #endif 795 796 /** 797 * @brief Set packet types for SCO connections 798 * @param common single packet_types: HFP_SCO_PACKET_TYPES_* 799 */ 800 void hfp_set_sco_packet_types(uint16_t packet_types); 801 802 /** 803 * @brief Get packet types for SCO connections 804 * @returns packet_types 805 */ 806 uint16_t hfp_get_sco_packet_types(void); 807 808 #if defined __cplusplus 809 } 810 #endif 811 812 #endif // BTSTACK_HFP_H 813