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 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 #define BTSTACK_FILE__ "hci_cmd.c" 39 40 /* 41 * hci_cmd.c 42 * 43 * Created by Matthias Ringwald on 7/23/09. 44 */ 45 46 #include "btstack_config.h" 47 48 #include "hci.h" 49 #include "hci_cmd.h" 50 #include "btstack_debug.h" 51 52 #include <string.h> 53 54 55 #ifdef ENABLE_SDP 56 #include "classic/sdp_util.h" 57 #endif 58 59 // calculate combined ogf/ocf value 60 #define OPCODE(ogf, ocf) ((ocf) | ((ogf) << 10)) 61 62 #define INVALID_VAR_LEN 0xffffu 63 // hci_le_set_cig_parameters_test has 10 arrayed parameters 64 #define MAX_NR_ARRAY_FIELDS 10 65 #define INVALID_ARRAY_LEN 0xff 66 67 /** 68 * construct HCI Command based on template 69 * 70 * Format: 71 * 1,2,3,4: one to four byte value 72 * H: HCI connection handle 73 * B: Bluetooth Baseband Address (BD_ADDR) 74 * D: 8 byte data block 75 * E: Extended Inquiry Result 76 * N: Name up to 248 chars, \0 terminated 77 * P: 16 byte data block. Pairing code, Simple Pairing Hash and Randomizer 78 * A: 31 bytes advertising data 79 * S: Service Record (Data Element Sequence) 80 * Q: 32 byte data block, e.g. for X and Y coordinates of P-256 public key 81 * J: 8-bit length of variable size element 82 * V: variable size element, len was given with param 'J' 83 * a: number of elements in following arrayed parameters(s), specified as '[...]' 84 * b: bit field indicating number of arrayed parameters(s), specified as '[...]' 85 * [: start of arrayed param sequence 86 * ]: end of arrayed param sequence 87 */ 88 uint16_t hci_cmd_create_from_template(uint8_t *hci_cmd_buffer, const hci_cmd_t *cmd, va_list argptr){ 89 90 hci_cmd_buffer[0] = cmd->opcode & 0xffu; 91 hci_cmd_buffer[1] = cmd->opcode >> 8; 92 uint16_t pos = 3; 93 94 const char *format = cmd->format; 95 uint16_t word; 96 uint32_t longword; 97 uint8_t * ptr; 98 99 #ifdef ENABLE_BLE 100 // variable size data 101 uint16_t var_len = INVALID_VAR_LEN; 102 // array processing 103 const char * array_format = NULL; 104 void * array_data[MAX_NR_ARRAY_FIELDS]; 105 uint8_t array_num_elements = INVALID_ARRAY_LEN; 106 uint8_t array_num_fields; 107 uint8_t array_element_index; 108 bool array_done; 109 #endif 110 111 bool done_format = false; 112 while (!done_format) { 113 switch(*format) { 114 case 0: 115 done_format = true; 116 break; 117 case '1': // 8 bit value 118 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 119 hci_cmd_buffer[pos++] = word & 0xffu; 120 break; 121 case '2': // 16 bit value 122 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 123 hci_cmd_buffer[pos++] = word & 0xffu; 124 hci_cmd_buffer[pos++] = word >> 8; 125 break; 126 case 'H': // hci_handle 127 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 128 hci_cmd_buffer[pos++] = word & 0xffu; 129 hci_cmd_buffer[pos++] = word >> 8; 130 break; 131 case '3': 132 longword = va_arg(argptr, uint32_t); // LCOV_EXCL_BR_LINE 133 hci_cmd_buffer[pos++] = longword; 134 hci_cmd_buffer[pos++] = longword >> 8; 135 hci_cmd_buffer[pos++] = longword >> 16; 136 break; 137 case '4': 138 longword = va_arg(argptr, uint32_t); // LCOV_EXCL_BR_LINE 139 hci_cmd_buffer[pos++] = longword; 140 hci_cmd_buffer[pos++] = longword >> 8; 141 hci_cmd_buffer[pos++] = longword >> 16; 142 hci_cmd_buffer[pos++] = longword >> 24; 143 break; 144 case 'B': // bt-addr 145 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 146 hci_cmd_buffer[pos++] = ptr[5]; 147 hci_cmd_buffer[pos++] = ptr[4]; 148 hci_cmd_buffer[pos++] = ptr[3]; 149 hci_cmd_buffer[pos++] = ptr[2]; 150 hci_cmd_buffer[pos++] = ptr[1]; 151 hci_cmd_buffer[pos++] = ptr[0]; 152 break; 153 case 'D': // 8 byte data block 154 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 155 (void)memcpy(&hci_cmd_buffer[pos], ptr, 8); 156 pos += 8; 157 break; 158 case 'E': // Extended Inquiry Information 240 octets 159 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 160 (void)memcpy(&hci_cmd_buffer[pos], ptr, 240); 161 pos += 240; 162 break; 163 case 'N': { // UTF-8 string, null terminated 164 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 165 uint16_t len = strlen((const char*) ptr); 166 if (len > 248u) { 167 len = 248; 168 } 169 (void)memcpy(&hci_cmd_buffer[pos], ptr, len); 170 if (len < 248u) { 171 // fill remaining space with zeroes 172 memset(&hci_cmd_buffer[pos+len], 0u, 248u-len); 173 } 174 pos += 248; 175 break; 176 } 177 case 'P': // 16 byte PIN code or link key in little endian 178 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 179 (void)memcpy(&hci_cmd_buffer[pos], ptr, 16); 180 pos += 16; 181 break; 182 case 'K': // 16 byte OOB Data or Link Key in big endian 183 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 184 reverse_bytes(ptr, &hci_cmd_buffer[pos], 16); 185 pos += 16; 186 break; 187 #ifdef ENABLE_BLE 188 case 'A': // 31 bytes advertising data 189 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 190 (void)memcpy(&hci_cmd_buffer[pos], ptr, 31); 191 pos += 31; 192 break; 193 case 'J': // 8 bit variable length indicator for 'V' 194 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 195 var_len = word & 0xffu; 196 hci_cmd_buffer[pos++] = var_len; 197 break; 198 case 'V': 199 btstack_assert(var_len != INVALID_VAR_LEN); 200 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 201 (void)memcpy(&hci_cmd_buffer[pos], ptr, var_len); 202 pos += var_len; 203 var_len = INVALID_VAR_LEN; 204 break; 205 case 'a': 206 btstack_assert(array_num_elements == INVALID_ARRAY_LEN); 207 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 208 hci_cmd_buffer[pos++] = word & 0xff; 209 array_num_elements = word & 0xffu; 210 break; 211 case 'b': 212 btstack_assert(array_num_elements == INVALID_ARRAY_LEN); 213 word = va_arg(argptr, int); // LCOV_EXCL_BR_LINE 214 hci_cmd_buffer[pos++] = word & 0xff; 215 array_num_elements = count_set_bits_uint32(word & 0xffu); 216 break; 217 case '[': 218 btstack_assert(array_num_elements != INVALID_ARRAY_LEN); 219 // process array 220 format++; 221 array_format = format; 222 array_num_fields = 0; 223 array_done = false; 224 while (!array_done){ 225 switch (*format){ 226 case 0: 227 array_done = true; 228 done_format = true; 229 break; 230 case ']': 231 array_done = true; 232 break; 233 case '1': 234 case '2': 235 // all arrayed parameters are passed in as arrays 236 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 237 array_data[array_num_fields++] = ptr; 238 format++; 239 break; 240 default: 241 btstack_unreachable(); 242 break; 243 } 244 } 245 for (array_element_index = 0; array_element_index < array_num_elements ; array_element_index++){ 246 uint8_t array_field_index; 247 for (array_field_index = 0; array_field_index < array_num_fields ; array_field_index++){ 248 switch (array_format[array_field_index]){ 249 case '1': 250 hci_cmd_buffer[pos++] = ((const uint8_t *) array_data[array_field_index])[array_element_index]; 251 break; 252 case '2': 253 little_endian_store_16(hci_cmd_buffer, pos, ((const uint16_t *) array_data[array_field_index])[array_element_index]); 254 pos += 2; 255 break; 256 default: 257 btstack_unreachable(); 258 break; 259 } 260 } 261 } 262 break; 263 #endif 264 #ifdef ENABLE_LE_SECURE_CONNECTIONS 265 case 'Q': 266 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 267 reverse_bytes(ptr, &hci_cmd_buffer[pos], 32); 268 pos += 32; 269 break; 270 #endif 271 #ifdef ENABLE_SDP 272 // used by daemon 273 case 'S': { // Service Record (Data Element Sequence) 274 ptr = va_arg(argptr, uint8_t *); // LCOV_EXCL_BR_LINE 275 uint16_t len = de_get_len(ptr); 276 (void)memcpy(&hci_cmd_buffer[pos], ptr, len); 277 pos += len; 278 break; 279 } 280 #endif 281 default: 282 btstack_unreachable(); 283 break; 284 } 285 format++; 286 }; 287 hci_cmd_buffer[2] = pos - 3; 288 return pos; 289 } 290 291 /** 292 * Link Control Commands 293 */ 294 295 /** 296 * @param lap 297 * @param inquiry_length 298 * @param num_responses 299 */ 300 const hci_cmd_t hci_inquiry = { 301 HCI_OPCODE_HCI_INQUIRY, "311" 302 }; 303 304 /** 305 */ 306 const hci_cmd_t hci_inquiry_cancel = { 307 HCI_OPCODE_HCI_INQUIRY_CANCEL, "" 308 }; 309 310 /** 311 * @param max_period_length 312 * @param min_period_length 313 * @param lap 314 * @param inquiry_length 315 * @param num_responses 316 */ 317 const hci_cmd_t hci_periodic_inquiry_mode = { 318 HCI_OPCODE_HCI_PERIODIC_INQUIRY_MODE, "22311" 319 }; 320 321 /** 322 */ 323 const hci_cmd_t hci_exit_periodic_inquiry_mode = { 324 HCI_OPCODE_HCI_EXIT_PERIODIC_INQUIRY_MODE, "" 325 }; 326 327 /** 328 * @param bd_addr 329 * @param packet_type 330 * @param page_scan_repetition_mode 331 * @param reserved 332 * @param clock_offset 333 * @param allow_role_switch 334 */ 335 const hci_cmd_t hci_create_connection = { 336 HCI_OPCODE_HCI_CREATE_CONNECTION, "B21121" 337 }; 338 339 /** 340 * @param handle 341 * @param reason (0x05, 0x13-0x15, 0x1a, 0x29, see Errors Codes in BT Spec Part D) 342 */ 343 const hci_cmd_t hci_disconnect = { 344 HCI_OPCODE_HCI_DISCONNECT, "H1" 345 }; 346 347 /** 348 * @param bd_addr 349 */ 350 const hci_cmd_t hci_create_connection_cancel = { 351 HCI_OPCODE_HCI_CREATE_CONNECTION_CANCEL, "B" 352 }; 353 354 /** 355 * @param bd_addr 356 * @param role (become master, stay slave) 357 */ 358 const hci_cmd_t hci_accept_connection_request = { 359 HCI_OPCODE_HCI_ACCEPT_CONNECTION_REQUEST, "B1" 360 }; 361 362 /** 363 * @param bd_addr 364 * @param reason (e.g. CONNECTION REJECTED DUE TO LIMITED RESOURCES (0x0d)) 365 */ 366 const hci_cmd_t hci_reject_connection_request = { 367 HCI_OPCODE_HCI_REJECT_CONNECTION_REQUEST, "B1" 368 }; 369 370 /** 371 * @param bd_addr 372 * @param link_key 373 */ 374 const hci_cmd_t hci_link_key_request_reply = { 375 HCI_OPCODE_HCI_LINK_KEY_REQUEST_REPLY, "BP" 376 }; 377 378 /** 379 * @param bd_addr 380 */ 381 const hci_cmd_t hci_link_key_request_negative_reply = { 382 HCI_OPCODE_HCI_LINK_KEY_REQUEST_NEGATIVE_REPLY, "B" 383 }; 384 385 /** 386 * @param bd_addr 387 * @param pin_length 388 * @param pin (c-string) 389 */ 390 const hci_cmd_t hci_pin_code_request_reply = { 391 HCI_OPCODE_HCI_PIN_CODE_REQUEST_REPLY, "B1P" 392 }; 393 394 /** 395 * @param bd_addr 396 */ 397 const hci_cmd_t hci_pin_code_request_negative_reply = { 398 HCI_OPCODE_HCI_PIN_CODE_REQUEST_NEGATIVE_REPLY, "B" 399 }; 400 401 /** 402 * @param handle 403 * @param packet_type 404 */ 405 const hci_cmd_t hci_change_connection_packet_type = { 406 HCI_OPCODE_HCI_CHANGE_CONNECTION_PACKET_TYPE, "H2" 407 }; 408 409 /** 410 * @param handle 411 */ 412 const hci_cmd_t hci_authentication_requested = { 413 HCI_OPCODE_HCI_AUTHENTICATION_REQUESTED, "H" 414 }; 415 416 /** 417 * @param handle 418 * @param encryption_enable 419 */ 420 const hci_cmd_t hci_set_connection_encryption = { 421 HCI_OPCODE_HCI_SET_CONNECTION_ENCRYPTION, "H1" 422 }; 423 424 /** 425 * @param handle 426 */ 427 const hci_cmd_t hci_change_connection_link_key = { 428 HCI_OPCODE_HCI_CHANGE_CONNECTION_LINK_KEY, "H" 429 }; 430 431 /** 432 * @param bd_addr 433 * @param page_scan_repetition_mode 434 * @param reserved 435 * @param clock_offset 436 */ 437 const hci_cmd_t hci_remote_name_request = { 438 HCI_OPCODE_HCI_REMOTE_NAME_REQUEST, "B112" 439 }; 440 441 442 /** 443 * @param bd_addr 444 */ 445 const hci_cmd_t hci_remote_name_request_cancel = { 446 HCI_OPCODE_HCI_REMOTE_NAME_REQUEST_CANCEL, "B" 447 }; 448 449 /** 450 * @param handle 451 */ 452 const hci_cmd_t hci_read_remote_supported_features_command = { 453 HCI_OPCODE_HCI_READ_REMOTE_SUPPORTED_FEATURES_COMMAND, "H" 454 }; 455 456 /** 457 * @param handle 458 */ 459 const hci_cmd_t hci_read_remote_extended_features_command = { 460 HCI_OPCODE_HCI_READ_REMOTE_EXTENDED_FEATURES_COMMAND, "H1" 461 }; 462 463 /** 464 * @param handle 465 */ 466 const hci_cmd_t hci_read_remote_version_information = { 467 HCI_OPCODE_HCI_READ_REMOTE_VERSION_INFORMATION, "H" 468 }; 469 470 /** 471 * @param handle 472 * @param transmit_bandwidth 8000(64kbps) 473 * @param receive_bandwidth 8000(64kbps) 474 * @param max_latency >= 7ms for eSCO, 0xFFFF do not care 475 * @param voice_settings e.g. CVSD, Input Coding: Linear, Input Data Format: 2’s complement, data 16bit: 00011000000 == 0x60 476 * @param retransmission_effort e.g. 0xFF do not care 477 * @param packet_type at least EV3 for eSCO 478 */ 479 const hci_cmd_t hci_setup_synchronous_connection = { 480 HCI_OPCODE_HCI_SETUP_SYNCHRONOUS_CONNECTION, "H442212" 481 }; 482 483 /** 484 * @param bd_addr 485 * @param transmit_bandwidth 486 * @param receive_bandwidth 487 * @param max_latency 488 * @param voice_settings 489 * @param retransmission_effort 490 * @param packet_type 491 */ 492 const hci_cmd_t hci_accept_synchronous_connection = { 493 HCI_OPCODE_HCI_ACCEPT_SYNCHRONOUS_CONNECTION, "B442212" 494 }; 495 496 /** 497 * @param bd_addr 498 * @param IO_capability 499 * @param OOB_data_present 500 * @param authentication_requirements 501 */ 502 const hci_cmd_t hci_io_capability_request_reply = { 503 HCI_OPCODE_HCI_IO_CAPABILITY_REQUEST_REPLY, "B111" 504 }; 505 506 /** 507 * @param bd_addr 508 */ 509 const hci_cmd_t hci_user_confirmation_request_reply = { 510 HCI_OPCODE_HCI_USER_CONFIRMATION_REQUEST_REPLY, "B" 511 }; 512 513 /** 514 * @param bd_addr 515 */ 516 const hci_cmd_t hci_user_confirmation_request_negative_reply = { 517 HCI_OPCODE_HCI_USER_CONFIRMATION_REQUEST_NEGATIVE_REPLY, "B" 518 }; 519 520 /** 521 * @param bd_addr 522 * @param numeric_value 523 */ 524 const hci_cmd_t hci_user_passkey_request_reply = { 525 HCI_OPCODE_HCI_USER_PASSKEY_REQUEST_REPLY, "B4" 526 }; 527 528 /** 529 * @param bd_addr 530 */ 531 const hci_cmd_t hci_user_passkey_request_negative_reply = { 532 HCI_OPCODE_HCI_USER_PASSKEY_REQUEST_NEGATIVE_REPLY, "B" 533 }; 534 535 /** 536 * @param bd_addr 537 * @param c Simple Pairing Hash C 538 * @param r Simple Pairing Randomizer R 539 */ 540 const hci_cmd_t hci_remote_oob_data_request_reply = { 541 HCI_OPCODE_HCI_REMOTE_OOB_DATA_REQUEST_REPLY, "BKK" 542 }; 543 544 /** 545 * @param bd_addr 546 */ 547 const hci_cmd_t hci_remote_oob_data_request_negative_reply = { 548 HCI_OPCODE_HCI_REMOTE_OOB_DATA_REQUEST_NEGATIVE_REPLY, "B" 549 }; 550 551 /** 552 * @param bd_addr 553 * @param reason (Part D, Error codes) 554 */ 555 const hci_cmd_t hci_io_capability_request_negative_reply = { 556 HCI_OPCODE_HCI_IO_CAPABILITY_REQUEST_NEGATIVE_REPLY, "B1" 557 }; 558 559 /** 560 * @param handle 561 * @param transmit_bandwidth 562 * @param receive_bandwidth 563 * @param transmit_coding_format_type 564 * @param transmit_coding_format_company 565 * @param transmit_coding_format_codec 566 * @param receive_coding_format_type 567 * @param receive_coding_format_company 568 * @param receive_coding_format_codec 569 * @param transmit_coding_frame_size 570 * @param receive_coding_frame_size 571 * @param input_bandwidth 572 * @param output_bandwidth 573 * @param input_coding_format_type 574 * @param input_coding_format_company 575 * @param input_coding_format_codec 576 * @param output_coding_format_type 577 * @param output_coding_format_company 578 * @param output_coding_format_codec 579 * @param input_coded_data_size 580 * @param outupt_coded_data_size 581 * @param input_pcm_data_format 582 * @param output_pcm_data_format 583 * @param input_pcm_sample_payload_msb_position 584 * @param output_pcm_sample_payload_msb_position 585 * @param input_data_path 586 * @param output_data_path 587 * @param input_transport_unit_size 588 * @param output_transport_unit_size 589 * @param max_latency 590 * @param packet_type 591 * @param retransmission_effort 592 */ 593 const hci_cmd_t hci_enhanced_setup_synchronous_connection = { 594 HCI_OPCODE_HCI_ENHANCED_SETUP_SYNCHRONOUS_CONNECTION, "H4412212222441221222211111111221" 595 }; 596 597 /** 598 * @param bd_addr 599 * @param transmit_bandwidth 600 * @param receive_bandwidth 601 * @param transmit_coding_format_type 602 * @param transmit_coding_format_company 603 * @param transmit_coding_format_codec 604 * @param receive_coding_format_type 605 * @param receive_coding_format_company 606 * @param receive_coding_format_codec 607 * @param transmit_coding_frame_size 608 * @param receive_coding_frame_size 609 * @param input_bandwidth 610 * @param output_bandwidth 611 * @param input_coding_format_type 612 * @param input_coding_format_company 613 * @param input_coding_format_codec 614 * @param output_coding_format_type 615 * @param output_coding_format_company 616 * @param output_coding_format_codec 617 * @param input_coded_data_size 618 * @param outupt_coded_data_size 619 * @param input_pcm_data_format 620 * @param output_pcm_data_format 621 * @param input_pcm_sample_payload_msb_position 622 * @param output_pcm_sample_payload_msb_position 623 * @param input_data_path 624 * @param output_data_path 625 * @param input_transport_unit_size 626 * @param output_transport_unit_size 627 * @param max_latency 628 * @param packet_type 629 * @param retransmission_effort 630 */ 631 const hci_cmd_t hci_enhanced_accept_synchronous_connection = { 632 HCI_OPCODE_HCI_ENHANCED_ACCEPT_SYNCHRONOUS_CONNECTION, "B4412212222441221222211111111221" 633 }; 634 635 /** 636 * @param bd_addr 637 * @param c_192 Simple Pairing Hash C derived from P-192 public key 638 * @param r_192 Simple Pairing Randomizer derived from P-192 public key 639 * @param c_256 Simple Pairing Hash C derived from P-256 public key 640 * @param r_256 Simple Pairing Randomizer derived from P-256 public key 641 */ 642 const hci_cmd_t hci_remote_oob_extended_data_request_reply = { 643 HCI_OPCODE_HCI_REMOTE_OOB_EXTENDED_DATA_REQUEST_REPLY, "BKKKK" 644 }; 645 646 /** 647 * Link Policy Commands 648 */ 649 650 /** 651 * @param handle 652 * @param hold_mode_max_interval * 0.625 ms, range: 0x0002..0xFFFE; only even values are valid. 653 * @param hold_mode_min_interval * 0.625 ms, range: 0x0002..0xFFFE; only even values are valid. 654 */ 655 const hci_cmd_t hci_hold_mode = { 656 HCI_OPCODE_HCI_HOLD_MODE, "H22" 657 }; 658 659 /** 660 * @param handle 661 * @param sniff_max_interval 662 * @param sniff_min_interval 663 * @param sniff_attempt 664 * @param sniff_timeout 665 */ 666 const hci_cmd_t hci_sniff_mode = { 667 HCI_OPCODE_HCI_SNIFF_MODE, "H2222" 668 }; 669 670 /** 671 * @param handle 672 */ 673 const hci_cmd_t hci_exit_sniff_mode = { 674 HCI_OPCODE_HCI_EXIT_SNIFF_MODE, "H" 675 }; 676 677 /** 678 * @note Removed in Bluetooth Core v5.0 679 * @param handle 680 * @param beacon_max_interval * 0.625 ms, range: 0x000E..0xFFFE; only even values are valid. 681 * @param beacon_max_interval * 0.625 ms, range: 0x000E..0xFFFE; only even values are valid. 682 */ 683 const hci_cmd_t hci_park_state = { 684 HCI_OPCODE_HCI_PARK_STATE, "H22" 685 }; 686 687 /** 688 * @note Removed in Bluetooth Core v5.0 689 * @param handle 690 */ 691 const hci_cmd_t hci_exit_park_state = { 692 HCI_OPCODE_HCI_EXIT_PARK_STATE, "H" 693 }; 694 695 /** 696 * @param handle 697 * @param flags 698 * @param service_type 699 * @param token_rate (bytes/s) 700 * @param peak_bandwith (bytes/s) 701 * @param latency (us) 702 * @param delay_variation (us) 703 */ 704 const hci_cmd_t hci_qos_setup = { 705 HCI_OPCODE_HCI_QOS_SETUP, "H114444" 706 }; 707 708 /** 709 * @param handle 710 */ 711 const hci_cmd_t hci_role_discovery = { 712 HCI_OPCODE_HCI_ROLE_DISCOVERY, "H" 713 }; 714 715 /** 716 * @param bd_addr 717 * @param role (0=master,1=slave) 718 */ 719 const hci_cmd_t hci_switch_role_command= { 720 HCI_OPCODE_HCI_SWITCH_ROLE_COMMAND, "B1" 721 }; 722 723 /** 724 * @param handle 725 */ 726 const hci_cmd_t hci_read_link_policy_settings = { 727 HCI_OPCODE_HCI_READ_LINK_POLICY_SETTINGS, "H" 728 }; 729 730 /** 731 * @param handle 732 * @param settings 733 */ 734 const hci_cmd_t hci_write_link_policy_settings = { 735 HCI_OPCODE_HCI_WRITE_LINK_POLICY_SETTINGS, "H2" 736 }; 737 738 /** 739 * @param handle 740 * @param max_latency 741 * @param min_remote_timeout 742 * @param min_local_timeout 743 */ 744 const hci_cmd_t hci_sniff_subrating = { 745 HCI_OPCODE_HCI_SNIFF_SUBRATING, "H222" 746 }; 747 748 /** 749 * @param policy 750 */ 751 const hci_cmd_t hci_write_default_link_policy_setting = { 752 HCI_OPCODE_HCI_WRITE_DEFAULT_LINK_POLICY_SETTING, "2" 753 }; 754 755 /** 756 * @param handle 757 * @param unused 758 * @param flow_direction 759 * @param service_type 760 * @param token_rate 761 * @param token_bucket_size 762 * @param peak_bandwidth 763 * @param access_latency 764 */ 765 const hci_cmd_t hci_flow_specification = { 766 HCI_OPCODE_HCI_FLOW_SPECIFICATION, "H1114444" 767 }; 768 769 770 /** 771 * Controller & Baseband Commands 772 */ 773 774 775 /** 776 * @param event_mask_lover_octets 777 * @param event_mask_higher_octets 778 */ 779 const hci_cmd_t hci_set_event_mask = { 780 HCI_OPCODE_HCI_SET_EVENT_MASK, "44" 781 }; 782 783 /** 784 */ 785 const hci_cmd_t hci_reset = { 786 HCI_OPCODE_HCI_RESET, "" 787 }; 788 789 /** 790 * @param handle 791 */ 792 const hci_cmd_t hci_flush = { 793 HCI_OPCODE_HCI_FLUSH, "H" 794 }; 795 796 /** 797 * @param handle 798 */ 799 const hci_cmd_t hci_read_pin_type = { 800 HCI_OPCODE_HCI_READ_PIN_TYPE, "" 801 }; 802 803 /** 804 * @param handle 805 */ 806 const hci_cmd_t hci_write_pin_type = { 807 HCI_OPCODE_HCI_WRITE_PIN_TYPE, "1" 808 }; 809 810 /** 811 * @param bd_addr 812 * @param delete_all_flags 813 */ 814 const hci_cmd_t hci_delete_stored_link_key = { 815 HCI_OPCODE_HCI_DELETE_STORED_LINK_KEY, "B1" 816 }; 817 818 #ifdef ENABLE_CLASSIC 819 /** 820 * @param local_name (UTF-8, Null Terminated, max 248 octets) 821 */ 822 const hci_cmd_t hci_write_local_name = { 823 HCI_OPCODE_HCI_WRITE_LOCAL_NAME, "N" 824 }; 825 #endif 826 827 /** 828 */ 829 const hci_cmd_t hci_read_local_name = { 830 HCI_OPCODE_HCI_READ_LOCAL_NAME, "" 831 }; 832 833 /** 834 */ 835 const hci_cmd_t hci_read_page_timeout = { 836 HCI_OPCODE_HCI_READ_PAGE_TIMEOUT, "" 837 }; 838 839 /** 840 * @param page_timeout (* 0.625 ms) 841 */ 842 const hci_cmd_t hci_write_page_timeout = { 843 HCI_OPCODE_HCI_WRITE_PAGE_TIMEOUT, "2" 844 }; 845 846 /** 847 * @param scan_enable (no, inq, page, inq+page) 848 */ 849 const hci_cmd_t hci_write_scan_enable = { 850 HCI_OPCODE_HCI_WRITE_SCAN_ENABLE, "1" 851 }; 852 853 /** 854 */ 855 const hci_cmd_t hci_read_page_scan_activity = { 856 HCI_OPCODE_HCI_READ_PAGE_SCAN_ACTIVITY, "" 857 }; 858 859 /** 860 * @param page_scan_interval (* 0.625 ms) 861 * @param page_scan_window (* 0.625 ms, must be <= page_scan_interval) 862 */ 863 const hci_cmd_t hci_write_page_scan_activity = { 864 HCI_OPCODE_HCI_WRITE_PAGE_SCAN_ACTIVITY, "22" 865 }; 866 867 /** 868 */ 869 const hci_cmd_t hci_read_inquiry_scan_activity = { 870 HCI_OPCODE_HCI_READ_INQUIRY_SCAN_ACTIVITY, "" 871 }; 872 873 /** 874 * @param inquiry_scan_interval (* 0.625 ms) 875 * @param inquiry_scan_window (* 0.625 ms, must be <= inquiry_scan_interval) 876 */ 877 const hci_cmd_t hci_write_inquiry_scan_activity = { 878 HCI_OPCODE_HCI_WRITE_INQUIRY_SCAN_ACTIVITY, "22" 879 }; 880 881 /** 882 * @param authentication_enable 883 */ 884 const hci_cmd_t hci_write_authentication_enable = { 885 HCI_OPCODE_HCI_WRITE_AUTHENTICATION_ENABLE, "1" 886 }; 887 888 /** 889 * @param class_of_device 890 */ 891 const hci_cmd_t hci_write_class_of_device = { 892 HCI_OPCODE_HCI_WRITE_CLASS_OF_DEVICE, "3" 893 }; 894 895 /** 896 */ 897 const hci_cmd_t hci_read_num_broadcast_retransmissions = { 898 HCI_OPCODE_HCI_READ_NUM_BROADCAST_RETRANSMISSIONS, "" 899 }; 900 901 /** 902 * @param num_broadcast_retransmissions (e.g. 0 for a single broadcast) 903 */ 904 const hci_cmd_t hci_write_num_broadcast_retransmissions = { 905 HCI_OPCODE_HCI_WRITE_NUM_BROADCAST_RETRANSMISSIONS, "1" 906 }; 907 908 /** 909 * @param connection_handle 910 * @param type 0 = current transmit level, 1 = max transmit level 911 */ 912 const hci_cmd_t hci_read_transmit_power_level = { 913 HCI_OPCODE_HCI_READ_TRANSMIT_POWER_LEVEL, "11" 914 }; 915 916 /** 917 * @param synchronous_flow_control_enable - if yes, num completed packet everts are sent for SCO packets 918 */ 919 const hci_cmd_t hci_write_synchronous_flow_control_enable = { 920 HCI_OPCODE_HCI_WRITE_SYNCHRONOUS_FLOW_CONTROL_ENABLE, "1" 921 }; 922 923 #ifdef ENABLE_HCI_CONTROLLER_TO_HOST_FLOW_CONTROL 924 925 /** 926 * @param flow_control_enable - 0: off, 1: ACL only, 2: SCO only, 3: ACL + SCO 927 */ 928 const hci_cmd_t hci_set_controller_to_host_flow_control = { 929 HCI_OPCODE_HCI_SET_CONTROLLER_TO_HOST_FLOW_CONTROL, "1" 930 }; 931 932 /** 933 * @param host_acl_data_packet_length 934 * @param host_synchronous_data_packet_length 935 * @param host_total_num_acl_data_packets 936 * @param host_total_num_synchronous_data_packets 937 */ 938 const hci_cmd_t hci_host_buffer_size = { 939 HCI_OPCODE_HCI_HOST_BUFFER_SIZE, "2122" 940 }; 941 942 943 #if 0 944 // 945 // command sent manually sent by hci_host_num_completed_packets 946 // 947 /** 948 * @note only single handle supported by BTstack command generator 949 * @param number_of_handles must be 1 950 * @param connection_handle 951 * @param host_num_of_completed_packets for the given connection handle 952 */ 953 const hci_cmd_t hci_host_number_of_completed_packets = { 954 HCI_OPCODE_HCI_HOST_NUMBER_OF_COMPLETED_PACKETS, "1H2" 955 }; 956 #endif 957 958 #endif 959 960 /** 961 * @param handle 962 */ 963 const hci_cmd_t hci_read_link_supervision_timeout = { 964 HCI_OPCODE_HCI_READ_LINK_SUPERVISION_TIMEOUT, "H" 965 }; 966 967 /** 968 * @param handle 969 * @param timeout (0x0001 - 0xFFFF Time -> Range: 0.625ms - 40.9 sec) 970 */ 971 const hci_cmd_t hci_write_link_supervision_timeout = { 972 HCI_OPCODE_HCI_WRITE_LINK_SUPERVISION_TIMEOUT, "H2" 973 }; 974 975 /** 976 * @param num_current_iac must be 2 977 * @param iac_lap1 978 * @param iac_lap2 979 */ 980 const hci_cmd_t hci_write_current_iac_lap_two_iacs = { 981 HCI_OPCODE_HCI_WRITE_CURRENT_IAC_LAP_TWO_IACS, "133" 982 }; 983 984 /** 985 * @param inquiry_scan_type (0x00 = standard, 0x01 = interlaced) 986 */ 987 const hci_cmd_t hci_write_inquiry_scan_type = { 988 HCI_OPCODE_HCI_WRITE_INQUIRY_SCAN_TYPE, "1" 989 }; 990 991 /** 992 * @param inquiry_mode (0x00 = standard, 0x01 = with RSSI, 0x02 = extended) 993 */ 994 const hci_cmd_t hci_write_inquiry_mode = { 995 HCI_OPCODE_HCI_WRITE_INQUIRY_MODE, "1" 996 }; 997 998 /** 999 * @param page_scan_type (0x00 = standard, 0x01 = interlaced) 1000 */ 1001 const hci_cmd_t hci_write_page_scan_type = { 1002 HCI_OPCODE_HCI_WRITE_PAGE_SCAN_TYPE, "1" 1003 }; 1004 1005 /** 1006 * @param fec_required 1007 * @param exstended_inquiry_response 1008 */ 1009 const hci_cmd_t hci_write_extended_inquiry_response = { 1010 HCI_OPCODE_HCI_WRITE_EXTENDED_INQUIRY_RESPONSE, "1E" 1011 }; 1012 1013 /** 1014 * @param mode (0 = off, 1 = on) 1015 */ 1016 const hci_cmd_t hci_write_simple_pairing_mode = { 1017 HCI_OPCODE_HCI_WRITE_SIMPLE_PAIRING_MODE, "1" 1018 }; 1019 1020 /** 1021 */ 1022 const hci_cmd_t hci_read_local_oob_data = { 1023 HCI_OPCODE_HCI_READ_LOCAL_OOB_DATA, "" 1024 // return status, C, R 1025 }; 1026 1027 /** 1028 * @param mode (0 = off, 1 = on) 1029 */ 1030 const hci_cmd_t hci_write_default_erroneous_data_reporting = { 1031 HCI_OPCODE_HCI_WRITE_DEFAULT_ERRONEOUS_DATA_REPORTING, "1" 1032 }; 1033 1034 /** 1035 */ 1036 const hci_cmd_t hci_read_le_host_supported = { 1037 HCI_OPCODE_HCI_READ_LE_HOST_SUPPORTED, "" 1038 // return: status, le supported host, simultaneous le host 1039 }; 1040 1041 /** 1042 * @param le_supported_host 1043 * @param simultaneous_le_host 1044 */ 1045 const hci_cmd_t hci_write_le_host_supported = { 1046 HCI_OPCODE_HCI_WRITE_LE_HOST_SUPPORTED, "11" 1047 // return: status 1048 }; 1049 1050 /** 1051 * @param secure_connections_host_support 1052 */ 1053 const hci_cmd_t hci_write_secure_connections_host_support = { 1054 HCI_OPCODE_HCI_WRITE_SECURE_CONNECTIONS_HOST_SUPPORT, "1" 1055 // return: status 1056 }; 1057 1058 /** 1059 */ 1060 const hci_cmd_t hci_read_local_extended_oob_data = { 1061 HCI_OPCODE_HCI_READ_LOCAL_EXTENDED_OOB_DATA, "" 1062 // return status, C_192, R_192, R_256, C_256 1063 }; 1064 1065 1066 /** 1067 * Testing Commands 1068 */ 1069 1070 1071 /** 1072 */ 1073 const hci_cmd_t hci_read_loopback_mode = { 1074 HCI_OPCODE_HCI_READ_LOOPBACK_MODE, "" 1075 // return: status, loopback mode (0 = off, 1 = local loopback, 2 = remote loopback) 1076 }; 1077 1078 /** 1079 * @param loopback_mode 1080 */ 1081 const hci_cmd_t hci_write_loopback_mode = { 1082 HCI_OPCODE_HCI_WRITE_LOOPBACK_MODE, "1" 1083 // return: status 1084 }; 1085 1086 /** 1087 */ 1088 const hci_cmd_t hci_enable_device_under_test_mode = { 1089 HCI_OPCODE_HCI_ENABLE_DEVICE_UNDER_TEST_MODE, "" 1090 // return: status 1091 }; 1092 1093 /** 1094 * @param simple_pairing_debug_mode 1095 */ 1096 const hci_cmd_t hci_write_simple_pairing_debug_mode = { 1097 HCI_OPCODE_HCI_WRITE_SIMPLE_PAIRING_DEBUG_MODE, "1" 1098 // return: status 1099 }; 1100 1101 /** 1102 * @param handle 1103 * @param dm1_acl_u_mode 1104 * @param esco_loopback_mode 1105 */ 1106 const hci_cmd_t hci_write_secure_connections_test_mode = { 1107 HCI_OPCODE_HCI_WRITE_SECURE_CONNECTIONS_TEST_MODE, "H11" 1108 // return: status 1109 }; 1110 1111 1112 /** 1113 * Informational Parameters 1114 */ 1115 1116 const hci_cmd_t hci_read_local_version_information = { 1117 HCI_OPCODE_HCI_READ_LOCAL_VERSION_INFORMATION, "" 1118 }; 1119 const hci_cmd_t hci_read_local_supported_commands = { 1120 HCI_OPCODE_HCI_READ_LOCAL_SUPPORTED_COMMANDS, "" 1121 }; 1122 const hci_cmd_t hci_read_local_supported_features = { 1123 HCI_OPCODE_HCI_READ_LOCAL_SUPPORTED_FEATURES, "" 1124 }; 1125 const hci_cmd_t hci_read_buffer_size = { 1126 HCI_OPCODE_HCI_READ_BUFFER_SIZE, "" 1127 }; 1128 const hci_cmd_t hci_read_bd_addr = { 1129 HCI_OPCODE_HCI_READ_BD_ADDR, "" 1130 }; 1131 1132 /** 1133 * Status Paramters 1134 */ 1135 1136 /** 1137 * @param handle 1138 */ 1139 const hci_cmd_t hci_read_rssi = { 1140 HCI_OPCODE_HCI_READ_RSSI, "H" 1141 }; 1142 1143 /** 1144 * @param handle 1145 */ 1146 const hci_cmd_t hci_read_encryption_key_size = { 1147 HCI_OPCODE_HCI_READ_ENCRYPTION_KEY_SIZE, "H" 1148 }; 1149 1150 1151 #ifdef ENABLE_BLE 1152 /** 1153 * Low Energy Commands 1154 */ 1155 1156 /** 1157 * @param event_mask_lower_octets 1158 * @param event_mask_higher_octets 1159 */ 1160 const hci_cmd_t hci_le_set_event_mask = { 1161 HCI_OPCODE_HCI_LE_SET_EVENT_MASK, "44" 1162 // return: status 1163 }; 1164 1165 const hci_cmd_t hci_le_read_buffer_size = { 1166 HCI_OPCODE_HCI_LE_READ_BUFFER_SIZE, "" 1167 // return: status, le acl data packet len (16), total num le acl data packets(8) 1168 }; 1169 const hci_cmd_t hci_le_read_local_supported_features = { 1170 HCI_OPCODE_HCI_LE_READ_LOCAL_SUPPORTED_FEATURES, "" 1171 // return: LE_Features See [Vol 6] Part B, Section 4.6 1172 }; 1173 1174 /** 1175 * @param random_bd_addr 1176 */ 1177 const hci_cmd_t hci_le_set_random_address = { 1178 HCI_OPCODE_HCI_LE_SET_RANDOM_ADDRESS, "B" 1179 // return: status 1180 }; 1181 1182 /** 1183 * @param advertising_interval_min ([0x0020,0x4000], default: 0x0800, unit: 0.625 msec) 1184 * @param advertising_interval_max ([0x0020,0x4000], default: 0x0800, unit: 0.625 msec) 1185 * @param advertising_type (enum from 0: ADV_IND, ADC_DIRECT_IND, ADV_SCAN_IND, ADV_NONCONN_IND) 1186 * @param own_address_type (enum from 0: public device address, random device address) 1187 * @param direct_address_type () 1188 * @param direct_address (public or random address of device to be connecteed) 1189 * @param advertising_channel_map (flags: chan_37(1), chan_38(2), chan_39(4)) 1190 * @param advertising_filter_policy (enum from 0: scan any conn any, scan whitelist, con any, scan any conn whitelist, scan whitelist, con whitelist) 1191 */ 1192 const hci_cmd_t hci_le_set_advertising_parameters = { 1193 HCI_OPCODE_HCI_LE_SET_ADVERTISING_PARAMETERS, "22111B11" 1194 // return: status 1195 }; 1196 1197 const hci_cmd_t hci_le_read_advertising_channel_tx_power = { 1198 HCI_OPCODE_HCI_LE_READ_ADVERTISING_CHANNEL_TX_POWER, "" 1199 // return: status, level [-20,10] signed int (8), units dBm 1200 }; 1201 1202 /** 1203 * @param advertising_data_length 1204 * @param advertising_data (31 bytes) 1205 */ 1206 const hci_cmd_t hci_le_set_advertising_data= { 1207 HCI_OPCODE_HCI_LE_SET_ADVERTISING_DATA, "1A" 1208 // return: status 1209 }; 1210 1211 /** 1212 * @param scan_response_data_length 1213 * @param scan_response_data (31 bytes) 1214 */ 1215 const hci_cmd_t hci_le_set_scan_response_data= { 1216 HCI_OPCODE_HCI_LE_SET_SCAN_RESPONSE_DATA, "1A" 1217 // return: status 1218 }; 1219 1220 /** 1221 * @param advertise_enable (off: 0, on: 1) 1222 */ 1223 const hci_cmd_t hci_le_set_advertise_enable = { 1224 HCI_OPCODE_HCI_LE_SET_ADVERTISE_ENABLE, "1" 1225 // return: status 1226 }; 1227 1228 /** 1229 * @param le_scan_type (passive (0), active (1)) 1230 * @param le_scan_interval ([0x0004,0x4000], unit: 0.625 msec) 1231 * @param le_scan_window ([0x0004,0x4000], unit: 0.625 msec) 1232 * @param own_address_type (public (0), random (1)) 1233 * @param scanning_filter_policy (any (0), only whitelist (1)) 1234 */ 1235 const hci_cmd_t hci_le_set_scan_parameters = { 1236 HCI_OPCODE_HCI_LE_SET_SCAN_PARAMETERS, "12211" 1237 // return: status 1238 }; 1239 1240 /** 1241 * @param le_scan_enable (disabled (0), enabled (1)) 1242 * @param filter_duplices (disabled (0), enabled (1)) 1243 */ 1244 const hci_cmd_t hci_le_set_scan_enable = { 1245 HCI_OPCODE_HCI_LE_SET_SCAN_ENABLE, "11" 1246 // return: status 1247 }; 1248 1249 /** 1250 * @param le_scan_interval ([0x0004, 0x4000], unit: 0.625 msec) 1251 * @param le_scan_window ([0x0004, 0x4000], unit: 0.625 msec) 1252 * @param initiator_filter_policy (peer address type + peer address (0), whitelist (1)) 1253 * @param peer_address_type (public (0), random (1)) 1254 * @param peer_address 1255 * @param own_address_type (public (0), random (1)) 1256 * @param conn_interval_min ([0x0006, 0x0c80], unit: 1.25 msec) 1257 * @param conn_interval_max ([0x0006, 0x0c80], unit: 1.25 msec) 1258 * @param conn_latency (number of connection events [0x0000, 0x01f4]) 1259 * @param supervision_timeout ([0x000a, 0x0c80], unit: 10 msec) 1260 * @param minimum_CE_length ([0x0000, 0xffff], unit: 0.625 msec) 1261 * @param maximum_CE_length ([0x0000, 0xffff], unit: 0.625 msec) 1262 */ 1263 const hci_cmd_t hci_le_create_connection= { 1264 HCI_OPCODE_HCI_LE_CREATE_CONNECTION, "2211B1222222" 1265 // return: none -> le create connection complete event 1266 }; 1267 1268 const hci_cmd_t hci_le_create_connection_cancel = { 1269 HCI_OPCODE_HCI_LE_CREATE_CONNECTION_CANCEL, "" 1270 // return: status 1271 }; 1272 1273 const hci_cmd_t hci_le_read_white_list_size = { 1274 HCI_OPCODE_HCI_LE_READ_WHITE_LIST_SIZE, "" 1275 // return: status, number of entries in controller whitelist 1276 }; 1277 1278 const hci_cmd_t hci_le_clear_white_list = { 1279 HCI_OPCODE_HCI_LE_CLEAR_WHITE_LIST, "" 1280 // return: status 1281 }; 1282 1283 /** 1284 * @param address_type (public (0), random (1)) 1285 * @param bd_addr 1286 */ 1287 const hci_cmd_t hci_le_add_device_to_white_list = { 1288 HCI_OPCODE_HCI_LE_ADD_DEVICE_TO_WHITE_LIST, "1B" 1289 // return: status 1290 }; 1291 1292 /** 1293 * @param address_type (public (0), random (1)) 1294 * @param bd_addr 1295 */ 1296 const hci_cmd_t hci_le_remove_device_from_white_list = { 1297 HCI_OPCODE_HCI_LE_REMOVE_DEVICE_FROM_WHITE_LIST, "1B" 1298 // return: status 1299 }; 1300 1301 /** 1302 * @param conn_handle 1303 * @param conn_interval_min ([0x0006,0x0c80], unit: 1.25 msec) 1304 * @param conn_interval_max ([0x0006,0x0c80], unit: 1.25 msec) 1305 * @param conn_latency ([0x0000,0x03e8], number of connection events) 1306 * @param supervision_timeout ([0x000a,0x0c80], unit: 10 msec) 1307 * @param minimum_CE_length ([0x0000,0xffff], unit: 0.625 msec) 1308 * @param maximum_CE_length ([0x0000,0xffff], unit: 0.625 msec) 1309 */ 1310 const hci_cmd_t hci_le_connection_update = { 1311 HCI_OPCODE_HCI_LE_CONNECTION_UPDATE, "H222222" 1312 // return: none -> le connection update complete event 1313 }; 1314 1315 /** 1316 * @param channel_map_lower_32bits 1317 * @param channel_map_higher_5bits 1318 */ 1319 const hci_cmd_t hci_le_set_host_channel_classification = { 1320 HCI_OPCODE_HCI_LE_SET_HOST_CHANNEL_CLASSIFICATION, "41" 1321 // return: status 1322 }; 1323 1324 /** 1325 * @param conn_handle 1326 */ 1327 const hci_cmd_t hci_le_read_channel_map = { 1328 HCI_OPCODE_HCI_LE_READ_CHANNEL_MAP, "H" 1329 // return: status, connection handle, channel map (5 bytes, 37 used) 1330 }; 1331 1332 /** 1333 * @param conn_handle 1334 */ 1335 const hci_cmd_t hci_le_read_remote_used_features = { 1336 HCI_OPCODE_HCI_LE_READ_REMOTE_USED_FEATURES, "H" 1337 // return: none -> le read remote used features complete event 1338 }; 1339 1340 /** 1341 * @param key ((128) for AES-128) 1342 * @param plain_text (128) 1343 */ 1344 const hci_cmd_t hci_le_encrypt = { 1345 HCI_OPCODE_HCI_LE_ENCRYPT, "PP" 1346 // return: status, encrypted data (128) 1347 }; 1348 1349 const hci_cmd_t hci_le_rand = { 1350 HCI_OPCODE_HCI_LE_RAND, "" 1351 // return: status, random number (64) 1352 }; 1353 1354 /** 1355 * @param conn_handle 1356 * @param random_number_lower_32bits 1357 * @param random_number_higher_32bits 1358 * @param encryption_diversifier (16) 1359 * @param long_term_key (128) 1360 */ 1361 const hci_cmd_t hci_le_start_encryption = { 1362 HCI_OPCODE_HCI_LE_START_ENCRYPTION, "H442P" 1363 // return: none -> encryption changed or encryption key refresh complete event 1364 }; 1365 1366 /** 1367 * @param connection_handle 1368 * @param long_term_key (128) 1369 */ 1370 const hci_cmd_t hci_le_long_term_key_request_reply = { 1371 HCI_OPCODE_HCI_LE_LONG_TERM_KEY_REQUEST_REPLY, "HP" 1372 // return: status, connection handle 1373 }; 1374 1375 /** 1376 * @param conn_handle 1377 */ 1378 const hci_cmd_t hci_le_long_term_key_negative_reply = { 1379 HCI_OPCODE_HCI_LE_LONG_TERM_KEY_NEGATIVE_REPLY, "H" 1380 // return: status, connection handle 1381 }; 1382 1383 /** 1384 * @param conn_handle 1385 */ 1386 const hci_cmd_t hci_le_read_supported_states = { 1387 HCI_OPCODE_HCI_LE_READ_SUPPORTED_STATES, "H" 1388 // return: status, LE states (64) 1389 }; 1390 1391 /** 1392 * @param rx_frequency ([0x00 0x27], frequency (MHz): 2420 + N*2) 1393 */ 1394 const hci_cmd_t hci_le_receiver_test = { 1395 HCI_OPCODE_HCI_LE_RECEIVER_TEST, "1" 1396 // return: status 1397 }; 1398 1399 /** 1400 * @param tx_frequency ([0x00 0x27], frequency (MHz): 2420 + N*2) 1401 * @param test_payload_lengh ([0x00,0x25]) 1402 * @param packet_payload ([0,7] different patterns) 1403 */ 1404 const hci_cmd_t hci_le_transmitter_test = { 1405 HCI_OPCODE_HCI_LE_TRANSMITTER_TEST, "111" 1406 // return: status 1407 }; 1408 1409 /** 1410 * @param end_test_cmd 1411 */ 1412 const hci_cmd_t hci_le_test_end = { 1413 HCI_OPCODE_HCI_LE_TEST_END, "1" 1414 // return: status, number of packets (8) 1415 }; 1416 1417 /** 1418 * @param conn_handle 1419 * @param conn_interval_min ([0x0006,0x0c80], unit: 1.25 msec) 1420 * @param conn_interval_max ([0x0006,0x0c80], unit: 1.25 msec) 1421 * @param conn_latency ([0x0000,0x03e8], number of connection events) 1422 * @param supervision_timeout ([0x000a,0x0c80], unit: 10 msec) 1423 * @param minimum_CE_length ([0x0000,0xffff], unit: 0.625 msec) 1424 * @param maximum_CE_length ([0x0000,0xffff], unit: 0.625 msec) 1425 */ 1426 const hci_cmd_t hci_le_remote_connection_parameter_request_reply = { 1427 HCI_OPCODE_HCI_LE_REMOTE_CONNECTION_PARAMETER_REQUEST_REPLY, "H222222" 1428 // return: status, connection handle 1429 }; 1430 1431 /** 1432 * @param con_handle 1433 * @param reason 1434 */ 1435 const hci_cmd_t hci_le_remote_connection_parameter_request_negative_reply = { 1436 HCI_OPCODE_HCI_LE_REMOTE_CONNECTION_PARAMETER_REQUEST_NEGATIVE_REPLY, "H1" 1437 // return: status, connection handle 1438 }; 1439 1440 /** 1441 * @param con_handle 1442 * @param tx_octets 1443 * @param tx_time 1444 */ 1445 const hci_cmd_t hci_le_set_data_length = { 1446 HCI_OPCODE_HCI_LE_SET_DATA_LENGTH, "H22" 1447 // return: status, connection handle 1448 }; 1449 1450 /** 1451 */ 1452 const hci_cmd_t hci_le_read_suggested_default_data_length = { 1453 HCI_OPCODE_HCI_LE_READ_SUGGESTED_DEFAULT_DATA_LENGTH, "" 1454 // return: status, suggested max tx octets, suggested max tx time 1455 }; 1456 1457 /** 1458 * @param suggested_max_tx_octets 1459 * @param suggested_max_tx_time 1460 */ 1461 const hci_cmd_t hci_le_write_suggested_default_data_length = { 1462 HCI_OPCODE_HCI_LE_WRITE_SUGGESTED_DEFAULT_DATA_LENGTH, "22" 1463 // return: status 1464 }; 1465 1466 /** 1467 */ 1468 const hci_cmd_t hci_le_read_local_p256_public_key = { 1469 HCI_OPCODE_HCI_LE_READ_LOCAL_P256_PUBLIC_KEY, "" 1470 // LE Read Local P-256 Public Key Complete is generated on completion 1471 }; 1472 1473 /** 1474 * @param public key 1475 * @param private key 1476 */ 1477 const hci_cmd_t hci_le_generate_dhkey = { 1478 HCI_OPCODE_HCI_LE_GENERATE_DHKEY, "QQ" 1479 // LE Generate DHKey Complete is generated on completion 1480 }; 1481 1482 /** 1483 * @param Peer_Identity_Address_Type 1484 * @param Peer_Identity_Address 1485 * @param Peer_IRK 1486 * @param Local_IRK 1487 */ 1488 const hci_cmd_t hci_le_add_device_to_resolving_list = { 1489 HCI_OPCODE_HCI_LE_ADD_DEVICE_TO_RESOLVING_LIST, "1BPP" 1490 }; 1491 1492 /** 1493 * @param Peer_Identity_Address_Type 1494 * @param Peer_Identity_Address 1495 */ 1496 const hci_cmd_t hci_le_remove_device_from_resolving_list = { 1497 HCI_OPCODE_HCI_LE_REMOVE_DEVICE_FROM_RESOLVING_LIST, "1B" 1498 }; 1499 1500 /** 1501 */ 1502 const hci_cmd_t hci_le_clear_resolving_list = { 1503 HCI_OPCODE_HCI_LE_CLEAR_RESOLVING_LIST, "" 1504 }; 1505 1506 /** 1507 */ 1508 const hci_cmd_t hci_le_read_resolving_list_size = { 1509 HCI_OPCODE_HCI_LE_READ_RESOLVING_LIST_SIZE, "" 1510 }; 1511 1512 /** 1513 * @param Peer_Identity_Address_Type 1514 * @param Peer_Identity_Address 1515 */ 1516 const hci_cmd_t hci_le_read_peer_resolvable_address = { 1517 HCI_OPCODE_HCI_LE_READ_PEER_RESOLVABLE_ADDRESS, "" 1518 }; 1519 1520 /** 1521 * @param Peer_Identity_Address_Type 1522 * @param Peer_Identity_Address 1523 */ 1524 const hci_cmd_t hci_le_read_local_resolvable_address = { 1525 HCI_OPCODE_HCI_LE_READ_LOCAL_RESOLVABLE_ADDRESS, "" 1526 }; 1527 1528 /** 1529 * @param Address_Resolution_Enable 1530 */ 1531 const hci_cmd_t hci_le_set_address_resolution_enabled= { 1532 HCI_OPCODE_HCI_LE_SET_ADDRESS_RESOLUTION_ENABLED, "1" 1533 }; 1534 1535 /** 1536 * @param RPA_Timeout in seconds, range 0x0001 to 0x0E10, default: 900 s 1537 */ 1538 const hci_cmd_t hci_le_set_resolvable_private_address_timeout= { 1539 HCI_OPCODE_HCI_LE_SET_RESOLVABLE_PRIVATE_ADDRESS_TIMEOUT, "2" 1540 }; 1541 1542 /** 1543 */ 1544 const hci_cmd_t hci_le_read_maximum_data_length = { 1545 HCI_OPCODE_HCI_LE_READ_MAXIMUM_DATA_LENGTH, "" 1546 // return: status, supported max tx octets, supported max tx time, supported max rx octets, supported max rx time 1547 }; 1548 1549 /** 1550 * @param con_handle 1551 */ 1552 const hci_cmd_t hci_le_read_phy = { 1553 HCI_OPCODE_HCI_LE_READ_PHY, "H" 1554 // return: status, connection handler, tx phy, rx phy 1555 }; 1556 1557 /** 1558 * @param all_phys 1559 * @param tx_phys 1560 * @param rx_phys 1561 */ 1562 const hci_cmd_t hci_le_set_default_phy = { 1563 HCI_OPCODE_HCI_LE_SET_DEFAULT_PHY, "111" 1564 // return: status 1565 }; 1566 1567 /** 1568 * @param con_handle 1569 * @param all_phys 1570 * @param tx_phys 1571 * @param rx_phys 1572 * @param phy_options 1573 */ 1574 const hci_cmd_t hci_le_set_phy = { 1575 HCI_OPCODE_HCI_LE_SET_PHY, "H1111" 1576 // LE PHY Update Complete is generated on completion 1577 }; 1578 1579 /** 1580 * @param rx_channel 1581 * @param phy 1582 * @param modulation_index 1583 */ 1584 const hci_cmd_t hci_le_receiver_test_v2 = { 1585 HCI_OPCODE_HCI_LE_RECEIVER_TEST_V2, "111" 1586 }; 1587 1588 /** 1589 * @param tx_channel 1590 * @param test_data_length 1591 * @param packet_payload 1592 * @param phy 1593 */ 1594 const hci_cmd_t hci_le_transmitter_test_v2 = { 1595 HCI_OPCODE_HCI_LE_TRANSMITTER_TEST_V2, "1111" 1596 }; 1597 1598 /** 1599 * @param advertising_handle 1600 * @param random_address 1601 */ 1602 const hci_cmd_t hci_le_set_advertising_set_random_address = { 1603 HCI_OPCODE_HCI_LE_SET_ADVERTISING_SET_RANDOM_ADDRESS, "1B" 1604 }; 1605 1606 /** 1607 * @param advertising_handle 1608 * @param advertising_event_properties 1609 * @param primary_advertising_interval_min in 0.625 ms, range: 0x000020..0xffffff 1610 * @param primary_advertising_interval_max in 0.625 ms, range: 0x000020..0xffffff 1611 * @param primary_advertising_channel_map 1612 * @param own_address_type 1613 * @param peer_address_type 1614 * @param peer_address 1615 * @param advertising_filter_policy 1616 * @param advertising_tx_power in dBm, range: -127..20 1617 * @param primary_advertising_phy 1618 * @param secondary_advertising_max_skip 1619 * @param secondary_advertising_phy 1620 * @param advertising_sid 1621 * @param scan_request_notification_enable 1622 */ 1623 const hci_cmd_t hci_le_set_extended_advertising_parameters = { 1624 HCI_OPCODE_HCI_LE_SET_EXTENDED_ADVERTISING_PARAMETERS, "1233111B1111111" 1625 }; 1626 1627 /** 1628 * @param advertising_handle 1629 * @param operation 1630 * @param fragment_preference 1631 * @param advertising_data_length 1632 * @param advertising_data 1633 */ 1634 1635 const hci_cmd_t hci_le_set_extended_advertising_data = { 1636 HCI_OPCODE_HCI_LE_SET_EXTENDED_ADVERTISING_DATA, "111JV" 1637 }; 1638 1639 /** 1640 * @param advertising_handle 1641 * @param operation 1642 * @param fragment_preference 1643 * @param scan_response_data_length 1644 * @param scan_response_data 1645 */ 1646 1647 const hci_cmd_t hci_le_set_extended_scan_response_data = { 1648 HCI_OPCODE_HCI_LE_SET_EXTENDED_SCAN_RESPONSE_DATA, "111JV" 1649 }; 1650 1651 /** 1652 * @param enable 1653 * @param num_sets 1654 * @param advertising_handle[i] 1655 * @param duration[i] 1656 * @param max_extended_advertising_events[i] 1657 */ 1658 1659 const hci_cmd_t hci_le_set_extended_advertising_enable = { 1660 HCI_OPCODE_HCI_LE_SET_EXTENDED_ADVERTISING_ENABLE, "1a[121]" 1661 }; 1662 1663 /** 1664 */ 1665 const hci_cmd_t hci_le_read_maximum_advertising_data_length = { 1666 HCI_OPCODE_HCI_LE_READ_MAXIMUM_ADVERTISING_DATA_LENGTH, "" 1667 }; 1668 1669 /** 1670 */ 1671 const hci_cmd_t hci_le_read_number_of_supported_advertising_sets = { 1672 HCI_OPCODE_HCI_LE_READ_NUMBER_OF_SUPPORTED_ADVERTISING_SETS, "" 1673 }; 1674 1675 /** 1676 * @param advertising_handle 1677 */ 1678 const hci_cmd_t hci_le_remove_advertising_set = { 1679 HCI_OPCODE_HCI_LE_REMOVE_ADVERTISING_SET, "1" 1680 }; 1681 1682 /** 1683 */ 1684 const hci_cmd_t hci_le_clear_advertising_sets = { 1685 HCI_OPCODE_HCI_LE_CLEAR_ADVERTISING_SETS, "" 1686 }; 1687 1688 /** 1689 * @param advertising_handle 1690 * @param periodic_advertising_interval_min * 1.25 ms, range 0x0006..0xffff 1691 * @param periodic_advertising_interval_max * 1.25 ms, range 0x0006..0xffff 1692 * @param periodic_advertising_properties 1693 */ 1694 const hci_cmd_t hci_le_set_periodic_advertising_parameters = { 1695 HCI_OPCODE_HCI_LE_SET_PERIODIC_ADVERTISING_PARAMETERS, "1222" 1696 }; 1697 1698 /** 1699 * @param advertising_handle 1700 * @param operation 1701 * @param advertising_data_length 1702 * @param advertising_data 1703 */ 1704 1705 const hci_cmd_t hci_le_set_periodic_advertising_data = { 1706 HCI_OPCODE_HCI_LE_SET_PERIODIC_ADVERTISING_DATA, "11JV" 1707 }; 1708 1709 /** 1710 * @param enable 1711 * @param advertising_handle 1712 */ 1713 const hci_cmd_t hci_le_set_periodic_advertising_enable = { 1714 HCI_OPCODE_HCI_LE_SET_PERIODIC_ADVERTISING_ENABLE, "11" 1715 }; 1716 1717 /** 1718 * @param own_address_type 1719 * @param scanning_filter_policy 1720 * @param scanning_phys 0 = LE 1M PHY | 2 = LE Coded PHY 1721 * @param scan_type[i] 1722 * @param scan_interval[i] * 0.625, range = 0x0004..0xffff 1723 * @param scan_window[i] * 0.625, range = 0x0004..0xffff 1724 */ 1725 1726 const hci_cmd_t hci_le_set_extended_scan_parameters = { 1727 HCI_OPCODE_HCI_LE_SET_EXTENDED_SCAN_PARAMETERS, "11b[122]" 1728 }; 1729 1730 /** 1731 * @param enable 1732 * @param filter_duplicates 1733 * @param duration 0 = Scan continuously until explicitly disable, 10 ms 1734 * @param period 0 = Scan continuously, 1.28 s 1735 */ 1736 const hci_cmd_t hci_le_set_extended_scan_enable = { 1737 HCI_OPCODE_HCI_LE_SET_EXTENDED_SCAN_ENABLE, "1122" 1738 }; 1739 1740 /** 1741 * @param initiator_filter_policy 1742 * @param own_address_type 1743 * @param peer_address_type 1744 * @param peer_address 1745 * @param initiating_phys with bit 0 = LE 1M PHY, bit 1 = LE 2M PHY, bit 2 = Coded PHY 1746 * @param scan_interval[i] * 0.625 ms 1747 * @param scan_window[i] * 0.625 ms 1748 * @param connection_interval_min[i] * 1.25 ms 1749 * @param connection_interval_max[i] * 1.25 ms 1750 * @param connection_latency[i] 1751 * @param supervision_timeout[i] * 10 ms 1752 * @param min_ce_length[i] * 0.625 ms 1753 * @param max_ce_length[i] * 0.625 ms 1754 */ 1755 1756 const hci_cmd_t hci_le_extended_create_connection = { 1757 HCI_OPCODE_HCI_LE_EXTENDED_CREATE_CONNECTION, "111Bb[22222222]" 1758 }; 1759 1760 /** 1761 * @param options 1762 * @param advertising_sid 1763 * @param advertiser_address_type 1764 * @param advertiser_address 1765 * @param skip 1766 * @param sync_timeout * 10 ms 1767 * @param sync_cte_type 1768 */ 1769 const hci_cmd_t hci_le_periodic_advertising_create_sync = { 1770 HCI_OPCODE_HCI_LE_PERIODIC_ADVERTISING_CREATE_SYNC, "111B221" 1771 }; 1772 1773 /** 1774 */ 1775 const hci_cmd_t hci_le_periodic_advertising_create_sync_cancel = { 1776 HCI_OPCODE_HCI_LE_PERIODIC_ADVERTISING_CREATE_SYNC_CANCEL, "" 1777 }; 1778 1779 /** 1780 * @param sync_handle 1781 */ 1782 const hci_cmd_t hci_le_periodic_advertising_terminate_sync = { 1783 HCI_OPCODE_HCI_LE_PERIODIC_ADVERTISING_TERMINATE_SYNC, "" 1784 }; 1785 1786 /** 1787 * @param advertiser_address_type 1788 * @param advertiser_address 1789 * @param advertising_sid 1790 */ 1791 const hci_cmd_t hci_le_add_device_to_periodic_advertiser_list = { 1792 HCI_OPCODE_HCI_LE_ADD_DEVICE_TO_PERIODIC_ADVERTISER_LIST, "1B1" 1793 }; 1794 1795 /** 1796 * @param advertiser_address_type 1797 * @param advertiser_address 1798 * @param advertising_sid 1799 */ 1800 const hci_cmd_t hci_le_remove_device_from_periodic_advertiser_list = { 1801 HCI_OPCODE_HCI_LE_REMOVE_DEVICE_FROM_PERIODIC_ADVERTISER_LIST, "1B1" 1802 }; 1803 1804 /** 1805 */ 1806 const hci_cmd_t hci_le_clear_periodic_advertiser_list = { 1807 HCI_OPCODE_HCI_LE_CLEAR_PERIODIC_ADVERTISER_LIST, "" 1808 }; 1809 1810 /** 1811 */ 1812 const hci_cmd_t hci_le_read_periodic_advertiser_list_size = { 1813 HCI_OPCODE_HCI_LE_READ_PERIODIC_ADVERTISER_LIST_SIZE, "" 1814 }; 1815 1816 /** 1817 */ 1818 const hci_cmd_t hci_le_read_transmit_power = { 1819 HCI_OPCODE_HCI_LE_READ_TRANSMIT_POWER, "" 1820 }; 1821 1822 /** 1823 */ 1824 const hci_cmd_t hci_le_read_rf_path_compensation = { 1825 HCI_OPCODE_HCI_LE_READ_RF_PATH_COMPENSATION, "" 1826 }; 1827 1828 /** 1829 * @param rf_tx_path_compensation_value * 0.1 dB, signed 1830 * @param rf_rx_path_compensation_value * 0.1 dB, signed 1831 */ 1832 const hci_cmd_t hci_le_write_rf_path_compensation = { 1833 HCI_OPCODE_HCI_LE_WRITE_RF_PATH_COMPENSATION, "22" 1834 }; 1835 1836 /** 1837 * @param peer_identity_address_type 1838 * @param peer_identity_address 1839 * @param privacy_mode 1840 */ 1841 const hci_cmd_t hci_le_set_privacy_mode = { 1842 HCI_OPCODE_HCI_LE_SET_PRIVACY_MODE, "1B1" 1843 }; 1844 1845 /** 1846 * @param rx_channel 1847 * @param phy 1848 * @param modulation_index 1849 * @param expected_cte_length 1850 * @param expected_cte_type 1851 * @param slot_durations 1852 * @param switching_pattern_length 1853 * @param antenna_ids[i] 1854 */ 1855 1856 const hci_cmd_t hci_le_receiver_test_v3 = { 1857 HCI_OPCODE_HCI_LE_RECEIVER_TEST_V3, "111111a[1]" 1858 }; 1859 1860 /** 1861 * @param tx_channel 1862 * @param test_data_length 1863 * @param packet_payload 1864 * @param phy 1865 * @param cte_length 1866 * @param cte_type 1867 * @param switching_pattern_length 1868 * @param antenna_ids[i] 1869 */ 1870 1871 const hci_cmd_t hci_le_transmitter_test_v3 = { 1872 HCI_OPCODE_HCI_LE_TRANSMITTER_TEST_V3, "111111a[1]" 1873 }; 1874 1875 /** 1876 * @param advertising_handle 1877 * @param cte_length 1878 * @param cte_type 1879 * @param cte_count 1880 * @param switching_pattern_length 1881 * @param antenna_ids[i] 1882 */ 1883 1884 const hci_cmd_t hci_le_set_connectionless_cte_transmit_parameters = { 1885 HCI_OPCODE_HCI_LE_SET_CONNECTIONLESS_CTE_TRANSMIT_PARAMETERS, "1111a[1]" 1886 }; 1887 1888 /** 1889 * @param advertising_handle 1890 * @param cte_enable 1891 */ 1892 const hci_cmd_t hci_le_set_connectionless_cte_transmit_enable = { 1893 HCI_OPCODE_HCI_LE_SET_CONNECTIONLESS_CTE_TRANSMIT_ENABLE, "11" 1894 }; 1895 1896 /** 1897 * @param sync_handle 1898 * @param sampling_enable 1899 * @param slot_durations 1900 * @param max_sampled_ctes 1901 * @param switching_pattern_length 1902 * @param antenna_ids[i] 1903 */ 1904 1905 const hci_cmd_t hci_le_set_connectionless_iq_sampling_enable = { 1906 HCI_OPCODE_HCI_LE_SET_CONNECTIONLESS_IQ_SAMPLING_ENABLE, "2111a[i]" 1907 }; 1908 1909 /** 1910 * @param connection_handle 1911 * @param sampling_enable 1912 * @param slot_durations 1913 * @param switching_pattern_length 1914 * @param antenna_ids[i] 1915 */ 1916 1917 const hci_cmd_t hci_le_set_connection_cte_receive_parameters = { 1918 HCI_OPCODE_HCI_LE_SET_CONNECTION_CTE_RECEIVE_PARAMETERS, "211a[1]" 1919 }; 1920 1921 /** 1922 * @param connection_handle 1923 * @param cte_types 1924 * @param switching_pattern_length 1925 * @param antenna_ids[i] 1926 */ 1927 1928 const hci_cmd_t hci_le_set_connection_cte_transmit_parameters = { 1929 HCI_OPCODE_HCI_LE_SET_CONNECTION_CTE_TRANSMIT_PARAMETERS, "21a[1]" 1930 }; 1931 1932 /** 1933 * @param connection_handle 1934 * @param enable 1935 * @param cte_request_interval 1936 * @param requested_cte_length 1937 * @param requested_cte_type 1938 */ 1939 const hci_cmd_t hci_le_connection_cte_request_enable = { 1940 HCI_OPCODE_HCI_LE_CONNECTION_CTE_REQUEST_ENABLE, "H1211" 1941 }; 1942 1943 /** 1944 * @param connection_handle 1945 * @param enable 1946 */ 1947 const hci_cmd_t hci_le_connection_cte_response_enable = { 1948 HCI_OPCODE_HCI_LE_CONNECTION_CTE_RESPONSE_ENABLE, "H1" 1949 }; 1950 1951 /** 1952 */ 1953 const hci_cmd_t hci_le_read_antenna_information = { 1954 HCI_OPCODE_HCI_LE_READ_ANTENNA_INFORMATION, "" 1955 }; 1956 1957 /** 1958 * @param sync_handle 1959 * @param enable 1960 */ 1961 const hci_cmd_t hci_le_set_periodic_advertising_receive_enable = { 1962 HCI_OPCODE_HCI_LE_SET_PERIODIC_ADVERTISING_RECEIVE_ENABLE, "H1" 1963 }; 1964 1965 /** 1966 * @param connection_handle 1967 * @param service_data 1968 * @param sync_handle 1969 */ 1970 const hci_cmd_t hci_le_periodic_advertising_sync_transfer = { 1971 HCI_OPCODE_HCI_LE_PERIODIC_ADVERTISING_SYNC_TRANSFER, "H22" 1972 }; 1973 1974 /** 1975 * @param connection_handle 1976 * @param service_data 1977 * @param advertising_handle 1978 */ 1979 const hci_cmd_t hci_le_periodic_advertising_set_info_transfer = { 1980 HCI_OPCODE_HCI_LE_PERIODIC_ADVERTISING_SET_INFO_TRANSFER, "H21" 1981 }; 1982 1983 /** 1984 * @param connection_handle 1985 * @param mode 1986 * @param skip 1987 * @param sync_timeout 1988 * @param cte_type 1989 */ 1990 const hci_cmd_t hci_le_set_periodic_advertising_sync_transfer_parameters = { 1991 HCI_OPCODE_HCI_LE_SET_PERIODIC_ADVERTISING_SYNC_TRANSFER_PARAMETERS, "H1221" 1992 }; 1993 1994 /** 1995 * @param mode 1996 * @param skip 1997 * @param sync_timeout 1998 * @param cte_type 1999 */ 2000 const hci_cmd_t hci_le_set_default_periodic_advertising_sync_transfer_parameters = { 2001 HCI_OPCODE_HCI_LE_SET_DEFAULT_PERIODIC_ADVERTISING_SYNC_TRANSFER_PARAMETERS, "1221" 2002 }; 2003 2004 /** 2005 * @param 256Remote_P-256_public_key_x 2006 * @param 256Remote_P-256_public_key_y 2007 * @param key_type 2008 */ 2009 const hci_cmd_t hci_le_generate_dhkey_v2 = { 2010 HCI_OPCODE_HCI_LE_GENERATE_DHKEY_V2, "QQ1" 2011 }; 2012 2013 /** 2014 * @param action 2015 */ 2016 const hci_cmd_t hci_le_modify_sleep_clock_accuracy = { 2017 HCI_OPCODE_HCI_LE_MODIFY_SLEEP_CLOCK_ACCURACY, "1" 2018 }; 2019 2020 /** 2021 */ 2022 const hci_cmd_t hci_opcode_hci_le_read_buffer_size_v2 = { 2023 HCI_OPCODE_HCI_OPCODE_HCI_LE_READ_BUFFER_SIZE_V2, "" 2024 }; 2025 2026 /** 2027 * @param connection_handle 2028 */ 2029 const hci_cmd_t hci_le_read_iso_tx_sync = { 2030 HCI_OPCODE_HCI_LE_READ_ISO_TX_SYNC, "H" 2031 }; 2032 2033 /** 2034 * @param cig_id 2035 * @param sdu_interval_m_to_s 2036 * @param sdu_interval_s_to_m 2037 * @param slaves_clock_accuracy 2038 * @param packing 2039 * @param framing 2040 * @param max_transport_latency_m_to_s 2041 * @param max_transport_latency_s_to_m 2042 * @param cis_count 2043 * @param cis_id[i] 2044 * @param max_sdu_m_to_s[i] 2045 * @param max_sdu_s_to_m[i] 2046 * @param phy_m_to_s[i] 2047 * @param phy_s_to_m[i] 2048 * @param rtn_m_to_s[i] 2049 * @param rtn_s_to_m[i] 2050 */ 2051 2052 const hci_cmd_t hci_le_set_cig_parameters = { 2053 HCI_OPCODE_HCI_LE_SET_CIG_PARAMETERS, "13311122a[1221111]" 2054 }; 2055 2056 /** 2057 * @param cig_id 2058 * @param sdu_interval_m_to_s 2059 * @param sdu_interval_s_to_m 2060 * @param ft_m_to_s 2061 * @param ft_s_to_m 2062 * @param iso_interval 2063 * @param slaves_clock_accuracy 2064 * @param packing 2065 * @param framing 2066 * @param max_transport_latency_m_to_s 2067 * @param max_transport_latency_s_to_m 2068 * @param cis_count 2069 * @param cis_id[i] 2070 * @param nse[i] 2071 * @param max_sdu_m_to_s[i] 2072 * @param max_sdu_s_to_m[i] 2073 * @param max_pdu_m_to_s[i] 2074 * @param max_pdu_s_to_m[i] 2075 * @param phy_m_to_s[i] 2076 * @param phy_s_to_m[i] 2077 * @param bn_m_to_s[i] 2078 * @param bn_s_to_m[i] 2079 */ 2080 2081 const hci_cmd_t hci_le_set_cig_parameters_test = { 2082 HCI_OPCODE_HCI_LE_SET_CIG_PARAMETERS_TEST, "133112111a[1122221111]" 2083 }; 2084 2085 /** 2086 * @param cis_count 2087 * @param cis_connection_handle[i] 2088 * @param acl_connection_handle[i] 2089 */ 2090 2091 const hci_cmd_t hci_le_create_cis = { 2092 HCI_OPCODE_HCI_LE_CREATE_CIS, "a[22]" 2093 }; 2094 2095 /** 2096 * @param cig_id 2097 */ 2098 const hci_cmd_t hci_le_remove_cig = { 2099 HCI_OPCODE_HCI_LE_REMOVE_CIG, "1" 2100 }; 2101 2102 /** 2103 * @param connection_handle 2104 */ 2105 const hci_cmd_t hci_le_accept_cis_request = { 2106 HCI_OPCODE_HCI_LE_ACCEPT_CIS_REQUEST, "H" 2107 }; 2108 2109 /** 2110 * @param connection_handle 2111 */ 2112 const hci_cmd_t hci_le_reject_cis_request = { 2113 HCI_OPCODE_HCI_LE_REJECT_CIS_REQUEST, "H" 2114 }; 2115 2116 /** 2117 * @param big_handle 2118 * @param advertising_handle 2119 * @param num_bis 2120 * @param sdu_interval 2121 * @param max_sdu 2122 * @param max_transport_latency 2123 * @param rtn 2124 * @param phy 2125 * @param packing 2126 * @param framing 2127 * @param encryption 2128 * @param broadcast_code 2129 */ 2130 const hci_cmd_t hci_le_create_big = { 2131 HCI_OPCODE_HCI_LE_CREATE_BIG, "11132211111P" 2132 }; 2133 2134 /** 2135 * @param big_handle 2136 * @param advertising_handle 2137 * @param num_bis 2138 * @param sdu_interval 2139 * @param iso_interval 2140 * @param nse 2141 * @param max_sdu 2142 * @param max_PDU 2143 * @param phy 2144 * @param packing 2145 * @param framing 2146 * @param bn 2147 * @param irc 2148 * @param pto 2149 * @param encryption 2150 * @param broadcast_code 2151 */ 2152 const hci_cmd_t hci_le_create_big_test = { 2153 HCI_OPCODE_HCI_LE_CREATE_BIG_TEST, "111321221111111P" 2154 }; 2155 2156 /** 2157 * @param big_handle 2158 * @param reason 2159 */ 2160 const hci_cmd_t hci_le_terminate_big = { 2161 HCI_OPCODE_HCI_LE_TERMINATE_BIG, "11" 2162 }; 2163 2164 /** 2165 * @param big_handle 2166 * @param sync_handle 2167 * @param encryption 2168 * @param broadcast_code 2169 * @param mse 2170 * @param big_sync_timeout 2171 * @param num_bis 2172 * @param bis[i] 2173 */ 2174 2175 const hci_cmd_t hci_le_big_create_sync = { 2176 HCI_OPCODE_HCI_LE_BIG_CREATE_SYNC, "1H1P12a[1]" 2177 }; 2178 2179 /** 2180 * @param big_handle 2181 */ 2182 const hci_cmd_t hci_le_big_terminate_sync = { 2183 HCI_OPCODE_HCI_LE_BIG_TERMINATE_SYNC, "" 2184 }; 2185 2186 /** 2187 * @param connection_handle 2188 */ 2189 const hci_cmd_t hci_le_request_peer_sca = { 2190 HCI_OPCODE_HCI_LE_REQUEST_PEER_SCA, "H" 2191 }; 2192 2193 /** 2194 * @param connection_handle 2195 * @param data_path_direction 2196 * @param data_path_id 2197 * @param codec_id_coding_format 2198 * @param codec_id_company_identifier (Shall be ignored if codec_id_coding_format is not 0xFF) 2199 * @param codec_id_vendor_codec_id (Shall be ignored if codec_id_coding_format is not 0xFF) 2200 * @param controller_delay 2201 * @param codec_configuration_length 2202 * @param codec_configuration 2203 */ 2204 2205 const hci_cmd_t hci_le_setup_iso_data_path = { 2206 HCI_OPCODE_HCI_LE_SETUP_ISO_DATA_PATH, "H111223JV" 2207 }; 2208 2209 /** 2210 * @param connection_handle 2211 */ 2212 const hci_cmd_t hci_le_remove_iso_data_path = { 2213 HCI_OPCODE_HCI_LE_REMOVE_ISO_DATA_PATH, "H1" 2214 }; 2215 2216 /** 2217 * @param connection_handle 2218 * @param paylaod_type 2219 */ 2220 const hci_cmd_t hci_le_iso_transmit_test = { 2221 HCI_OPCODE_HCI_LE_ISO_TRANSMIT_TEST, "H1" 2222 }; 2223 2224 /** 2225 * @param connection_handle 2226 * @param paylaod_type 2227 */ 2228 const hci_cmd_t hci_le_iso_receive_test = { 2229 HCI_OPCODE_HCI_LE_ISO_RECEIVE_TEST, "H1" 2230 }; 2231 2232 /** 2233 * @param connection_handle 2234 */ 2235 const hci_cmd_t hci_le_iso_read_test_counters = { 2236 HCI_OPCODE_HCI_LE_ISO_READ_TEST_COUNTERS, "H" 2237 }; 2238 2239 /** 2240 * @param connection_handle 2241 */ 2242 const hci_cmd_t hci_le_iso_test_end = { 2243 HCI_OPCODE_HCI_LE_ISO_TEST_END, "H" 2244 }; 2245 2246 /** 2247 * @param bit_number 2248 * @param bit_value 2249 */ 2250 const hci_cmd_t hci_le_set_host_feature = { 2251 HCI_OPCODE_HCI_LE_SET_HOST_FEATURE, "11" 2252 }; 2253 2254 /** 2255 * @param connection_handle 2256 */ 2257 const hci_cmd_t hci_le_read_iso_link_quality = { 2258 HCI_OPCODE_HCI_LE_READ_ISO_LINK_QUALITY, "H" 2259 }; 2260 2261 /** 2262 * @param connection_handle 2263 * @param phy 2264 */ 2265 const hci_cmd_t hci_le_enhanced_read_transmit_power_level = { 2266 HCI_OPCODE_HCI_LE_ENHANCED_READ_TRANSMIT_POWER_LEVEL, "H1" 2267 }; 2268 2269 /** 2270 * @param connection_handle 2271 * @param phy 2272 */ 2273 const hci_cmd_t hci_le_read_remote_transmit_power_level = { 2274 HCI_OPCODE_HCI_LE_READ_REMOTE_TRANSMIT_POWER_LEVEL, "H1" 2275 }; 2276 2277 /** 2278 * @param connection_handle 2279 * @param high_threshold 2280 * @param high_hysteresis 2281 * @param low_threshold 2282 * @param low_hysteresis 2283 * @param min_time_spent 2284 */ 2285 const hci_cmd_t hci_le_set_path_loss_reporting_parameters = { 2286 HCI_OPCODE_HCI_LE_SET_PATH_LOSS_REPORTING_PARAMETERS, "211112" 2287 }; 2288 2289 /** 2290 * @param connection_handle 2291 * @param enable 2292 */ 2293 const hci_cmd_t hci_le_set_path_loss_reporting_enable = { 2294 HCI_OPCODE_HCI_LE_SET_PATH_LOSS_REPORTING_ENABLE, "H1" 2295 }; 2296 2297 /** 2298 * @param connection_handle 2299 * @param local_enable 2300 * @param remote_enable 2301 */ 2302 const hci_cmd_t hci_le_set_transmit_power_reporting_enable = { 2303 HCI_OPCODE_HCI_LE_SET_TRANSMIT_POWER_REPORTING_ENABLE, "H11" 2304 }; 2305 2306 /** 2307 * @param tx_channel 2308 * @param test_data_length 2309 * @param packet_payload 2310 * @param phy 2311 * @param cte_length 2312 * @param cte_type 2313 * @param switching_pattern_length 2314 * @param antenna_ids[i] 2315 * @param transmit_power_level 2316 */ 2317 2318 const hci_cmd_t hci_le_transmitter_test_v4 = { 2319 HCI_OPCODE_HCI_LE_TRANSMITTER_TEST_V4, "111111a[1]1" 2320 }; 2321 2322 #endif 2323 2324 // Broadcom / Cypress specific HCI commands 2325 2326 /** 2327 * @brief Enable Wide-Band Speech / mSBC decoding for PCM 2328 * @param enable_wbs is 0 for disable, 1 for enable 2329 * @param uuid_wbs is 2 for EV2/EV3 2330 */ 2331 const hci_cmd_t hci_bcm_enable_wbs = { 2332 HCI_OPCODE_HCI_BCM_ENABLE_WBS, "12" 2333 // return: status 2334 }; 2335 2336 /** 2337 * @brief Configure SCO Routing (BCM) 2338 * @param sco_routing is 0 for PCM, 1 for Transport, 2 for Codec and 3 for I2S 2339 * @param pcm_interface_rate is 0 for 128KBps, 1 for 256 KBps, 2 for 512KBps, 3 for 1024KBps, and 4 for 2048Kbps 2340 * @param frame_type is 0 for short and 1 for long 2341 * @param sync_mode is 0 for slave and 1 for master 2342 * @param clock_mode is 0 for slabe and 1 for master 2343 */ 2344 const hci_cmd_t hci_bcm_write_sco_pcm_int = { 2345 HCI_OPCODE_HCI_BCM_WRITE_SCO_PCM_INT, "11111" 2346 // return: status 2347 }; 2348 2349 /** 2350 * @brief Configure the I2S/PCM interface (BCM) 2351 * @param i2s_enable is 0 for off, 1 for on 2352 * @param is_master is 0 for slave, is 1 for master 2353 * @param sample_rate is 0 for 8 kHz, 1 for 16 kHz, 2 for 4 kHz 2354 * @param clock_rate is 0 for 128 kz, 1 for 256 kHz, 2 for 512 khz, 3 for 1024 kHz, 4 for 2048 khz 2355 * @param clock_mode is 0 for slabe and 1 for master 2356 */ 2357 const hci_cmd_t hci_bcm_write_i2spcm_interface_param = { 2358 HCI_OPCODE_HCI_BCM_WRITE_I2SPCM_INTERFACE_PARAM, "1111" 2359 // return: status 2360 }; 2361 2362 2363 /** 2364 * @brief Activates selected Sleep Mode 2365 * @param sleep_mode: 0=no sleep, 1=UART, 2=UART with Messaging, 3=USB, 4=H4IBSS, USB with Host Wake, 6=SDIO, 7=UART CS-N, 8=SPI, 9=H5, 10=H4DS, 12=UART with BREAK 2366 * @param idle_threshold_host (modes 1,2,5,7) time until considered idle, unit roughly 300 ms 2367 * @param idle_threshold_controller (modes 1-7,9) time until considered idle, unit roughly 300 ms 2368 * @param bt_wake_active_mode (modes 1,2,7) 0 = BT_WAKE line is active high, 1 = BT_WAKE is active low 2369 * @param host_wake_active_mode (modes 1,2,5,7) 0 = HOST_WAKE line is active high, 1 = HOST_WAKE is active low 2370 * @param allow_host_sleep_during_sco (modes 1,2,3,5,7) 2371 * @param combine_sleep_mode_and_lpm (modes 1,2,3,5,7) 2372 * @param enable_tristate_control_of_uart_tx_line (modes 1,2,7) 2373 * @param active_connection_handling_on_suspend (modes 3,5) 2374 * @param resume_timeout (modes 3,5) 2375 * @param enable_break_to_host (mode 12) 2376 * @param pulsed_host_wake (modes 1,12) 2377 */ 2378 const hci_cmd_t hci_bcm_set_sleep_mode = { 2379 HCI_OPCODE_HCI_BCM_SET_SLEEP_MODE, "111111111111" 2380 }; 2381 2382 /** 2383 * @brief Set TX Power Table 2384 * @param is_le 0=classic, 1=LE 2385 * @param chip_max_tx_pwr_db chip level max TX power in dBM 2386 */ 2387 const hci_cmd_t hci_bcm_write_tx_power_table = { 2388 HCI_OPCODE_HCI_BCM_WRITE_TX_POWER_TABLE, "11" 2389 }; 2390 2391 const hci_cmd_t hci_bcm_set_tx_pwr = { 2392 HCI_OPCODE_HCI_BCM_SET_TX_PWR, "11H" 2393 }; 2394 2395 /** 2396 * @brief This command starts receiving packets using packet transmission parameters such as 2397 * frequency channel, packet type, and packet length. It is used for Packet RX. 2398 * @see https://processors.wiki.ti.com/index.php/CC256x_Testing_Guide#Continuous_RX 2399 * @param frequency 2400 * @param ADPLL loop mode 2401 */ 2402 const hci_cmd_t hci_ti_drpb_tester_con_rx = { 2403 0xFD17, "11" 2404 }; 2405 2406 /** 2407 * 2408 * 2409 * @brief This command tests the RF transceiver in continuous transmission mode. 2410 * The transmitter is activated by configuring the transmission parameters such as pattern, 2411 * modulation, and frequency. 2412 * @see processors.wiki.ti.com/index.php/CC256x_VS_HCI_Commands#HCI_VS_DRPb_Tester_Con_TX.280xFD84.29 2413 * @param modulation 2414 * @param test_pattern 2415 * @param frequency 2416 * @param power_level 2417 * @param reserved1 2418 * @param reserved2 2419 */ 2420 const hci_cmd_t hci_ti_drpb_tester_con_tx = { 2421 0xFD84, "111144" 2422 }; 2423 2424 /** 2425 * @brief This command starts sending/receiving packets using packet transmission parameters such as 2426 * frequency channel, packet type, and packet length. It is used for Packet TX/RX. 2427 * @see processors.wiki.ti.com/index.php/CC256x_VS_HCI_Commands#HCI_VS_DRPb_Tester_Packet_TX_RX_.280xFD85.29 2428 * @param frequency_mode 2429 * @param tx_single_frequency 2430 * @param rx_single_frequency 2431 * @param acl_packet_type 2432 * @paarm acl_packet_data_pattern 2433 * @param reserved 2434 * @param power_level 2435 * @param disable_whitening 2436 * @param prbs9_initialization_value 2437 */ 2438 const hci_cmd_t hci_ti_drpb_tester_packet_tx_rx = { 2439 0xFD85, "1111112112" 2440 }; 2441 2442 2443 /** 2444 * @param best effort access percentage 2445 * @param guaranteed access percentage 2446 * @param poll period 2447 * @param slave burst after tx 2448 * @param slave master search count 2449 * @param master burst after tx enable 2450 * @param master burst after rx limit 2451 */ 2452 const hci_cmd_t hci_ti_configure_ddip = { 2453 HCI_OPCODE_HCI_TI_VS_CONFIGURE_DDIP, "1111111" 2454 }; 2455 2456 /** 2457 * @brief This command is used to associate the requested ACL handle with Wide Band Speech configuration. 2458 * @param enable 0=disable, 1=enable 2459 * @param a3dp_role (NL5500, WL128x only) 0=source,1=sink 2460 * @param code_upload (NL5500, WL128x only) 0=do not load a3dp code, 1=load a3dp code 2461 * @param reserved for future use 2462 */ 2463 const hci_cmd_t hci_ti_avrp_enable = { 2464 0xFD92, "1112" 2465 }; 2466 2467 /** 2468 * @brief This command is used to associate the requested ACL handle with Wide Band Speech configuration. 2469 * @param acl_con_handle 2470 */ 2471 const hci_cmd_t hci_ti_wbs_associate = { 2472 0xFD78, "H" 2473 }; 2474 2475 /** 2476 * @brief This command is used to disassociate Wide Band Speech configuration from any ACL handle. 2477 */ 2478 const hci_cmd_t hci_ti_wbs_disassociate = { 2479 0xFD79, "" 2480 }; 2481 2482 /** 2483 * @brief This command configures the codec interface parameters and the PCM clock rate, which is relevant when 2484 the Bluetooth core generates the clock. This command must be used by the host to use the PCM 2485 interface. 2486 * @param clock_rate in kHz 2487 * @param clock_direction 0=master/output, 1=slave/input 2488 * @param frame_sync_frequency in Hz 2489 * @param frame_sync_duty_cycle 0=50% (I2S Format), 0x0001-0xffff number of cycles of PCM clock 2490 * @param frame_sync_edge 0=driven/sampled at rising edge, 1=driven/sampled at falling edge of PCM clock 2491 * @param frame_sync_polariy 0=active high, 1=active low 2492 * @param reserved1 2493 * @param channel_1_data_out_size sample size in bits 2494 * @param channel_1_data_out_offset number of PCM clock cycles between rising of frame sync and data start 2495 * @param channel_1_data_out_edge 0=data driven at rising edge, 1=data driven at falling edge of PCM clock 2496 * @param channel_1_data_in_size sample size in bits 2497 * @param channel_1_data_in_offset number of PCM clock cycles between rising of frame sync and data start 2498 * @param channel_1_data_in_edge 0=data sampled at rising edge, 1=data sampled at falling edge of PCM clock 2499 * @param fsync_multiplier this field is only relevant to CC256XB from service pack 0.2 !!! -> use 0x00 2500 * @param channel_2_data_out_size sample size in bits 2501 * @param channel_2_data_out_offset number of PCM clock cycles between rising of frame sync and data start 2502 * @param channel_2_data_out_edge 0=data driven at rising edge, 1=data driven at falling edge of PCM clock 2503 * @param channel_2_data_in_size sample size in bits 2504 * @param channel_2_data_in_offset number of PCM clock cycles between rising of frame sync and data start 2505 * @param channel_2_data_in_edge 0=data sampled at rising edge, 1=data sampled at falling edge of PCM clock 2506 * @param reserved2 2507 * 2508 */ 2509 const hci_cmd_t hci_ti_write_codec_config = { 2510 0xFD06, "214211122122112212211" 2511 }; 2512 2513 /** 2514 * @brief This command is used only for internal testing. 2515 * @see https://processors.wiki.ti.com/index.php/CC256x_Testing_Guide#Continuous_TX 2516 * @param frequency 2517 * @param ADPLL loop mode 2518 */ 2519 const hci_cmd_t hci_ti_drpb_enable_rf_calibration = { 2520 0xFD80, "141" 2521 }; 2522 2523 /** 2524 * @brief This command command is only required for the continuous TX test of modulated 2525 * (GFSK, π/4-DQPSK or 8DPSK) signal. This command should be skipped when performing continuous TX test for CW. 2526 * @see https://processors.wiki.ti.com/index.php/CC256x_Testing_Guide#Continuous_RX 2527 * @param frequency 2528 * @param ADPLL loop mode 2529 */ 2530 const hci_cmd_t hci_ti_write_hardware_register = { 2531 0xFF01, "42" 2532 }; 2533 2534 /** 2535 * @brief Configure SCO routing on Realtek Controllers 2536 */ 2537 const hci_cmd_t hci_rtk_configure_sco_routing = { 2538 HCI_OPCODE (0x3f, 0x93), "111111111" 2539 }; 2540