TI BLE-Stack for Bluetooth 4.2 API Documentation  3.02.00.00
hci.h
Go to the documentation of this file.
1 /******************************************************************************
2 
3  Group: WCS, BTS
4  $Target Device: DEVICES $
5 
6  ******************************************************************************
7  $License: TISD 2009 $
8  ******************************************************************************
9  $Release Name: PACKAGE NAME $
10  $Release Date: PACKAGE RELEASE DATE $
11  *****************************************************************************/
12 
455 #ifndef HCI_H
456 #define HCI_H
457 
458 #ifdef __cplusplus
459 extern "C"
460 {
461 #endif
462 
463 /*
464  * INCLUDES
465  */
466 #include "bcomdef.h"
467 #include "osal.h"
468 //#include "ll.h"
469 #include "ll_common.h"
470 #include "hal_assert.h"
471 
472 /*
473  * MACROS
474  */
475 
476 /*
477  * CONSTANTS
478  */
479 
488 #define HCI_SUCCESS 0x00
489 #define HCI_ERROR_CODE_UNKNOWN_HCI_CMD 0x01
490 #define HCI_ERROR_CODE_UNKNOWN_CONN_ID 0x02
491 #define HCI_ERROR_CODE_HW_FAILURE 0x03
492 #define HCI_ERROR_CODE_PAGE_TIMEOUT 0x04
493 #define HCI_ERROR_CODE_AUTH_FAILURE 0x05
494 #define HCI_ERROR_CODE_PIN_KEY_MISSING 0x06
495 #define HCI_ERROR_CODE_MEM_CAP_EXCEEDED 0x07
496 #define HCI_ERROR_CODE_CONN_TIMEOUT 0x08
497 #define HCI_ERROR_CODE_CONN_LIMIT_EXCEEDED 0x09
498 #define HCI_ERROR_CODE_SYNCH_CONN_LIMIT_EXCEEDED 0x0A
499 #define HCI_ERROR_CODE_ACL_CONN_ALREADY_EXISTS 0x0B
500 #define HCI_ERROR_CODE_CMD_DISALLOWED 0x0C
501 #define HCI_ERROR_CODE_CONN_REJ_LIMITED_RESOURCES 0x0D
502 #define HCI_ERROR_CODE_CONN_REJECTED_SECURITY_REASONS 0x0E
503 #define HCI_ERROR_CODE_CONN_REJECTED_UNACCEPTABLE_BDADDR 0x0F
504 #define HCI_ERROR_CODE_CONN_ACCEPT_TIMEOUT_EXCEEDED 0x10
505 #define HCI_ERROR_CODE_UNSUPPORTED_FEATURE_PARAM_VALUE 0x11
506 #define HCI_ERROR_CODE_INVALID_HCI_CMD_PARAMS 0x12
507 #define HCI_ERROR_CODE_REMOTE_USER_TERM_CONN 0x13
508 #define HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_LOW_RESOURCES 0x14
509 #define HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_POWER_OFF 0x15
510 #define HCI_ERROR_CODE_CONN_TERM_BY_LOCAL_HOST 0x16
511 #define HCI_ERROR_CODE_REPEATED_ATTEMPTS 0x17
512 #define HCI_ERROR_CODE_PAIRING_NOT_ALLOWED 0x18
513 #define HCI_ERROR_CODE_UNKNOWN_LMP_PDU 0x19
514 #define HCI_ERROR_CODE_UNSUPPORTED_REMOTE_FEATURE 0x1A
515 #define HCI_ERROR_CODE_SCO_OFFSET_REJ 0x1B
516 #define HCI_ERROR_CODE_SCO_INTERVAL_REJ 0x1C
517 #define HCI_ERROR_CODE_SCO_AIR_MODE_REJ 0x1D
518 #define HCI_ERROR_CODE_INVALID_LMP_PARAMS 0x1E
519 #define HCI_ERROR_CODE_UNSPECIFIED_ERROR 0x1F
520 #define HCI_ERROR_CODE_UNSUPPORTED_LMP_PARAM_VAL 0x20
521 #define HCI_ERROR_CODE_ROLE_CHANGE_NOT_ALLOWED 0x21
522 #define HCI_ERROR_CODE_LMP_LL_RESP_TIMEOUT 0x22
523 #define HCI_ERROR_CODE_LMP_ERR_TRANSACTION_COLLISION 0x23
524 #define HCI_ERROR_CODE_LMP_PDU_NOT_ALLOWED 0x24
525 #define HCI_ERROR_CODE_ENCRYPT_MODE_NOT_ACCEPTABLE 0x25
526 #define HCI_ERROR_CODE_LINK_KEY_CAN_NOT_BE_CHANGED 0x26
527 #define HCI_ERROR_CODE_REQ_QOS_NOT_SUPPORTED 0x27
528 #define HCI_ERROR_CODE_INSTANT_PASSED 0x28
529 #define HCI_ERROR_CODE_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED 0x29
530 #define HCI_ERROR_CODE_DIFFERENT_TRANSACTION_COLLISION 0x2A
531 #define HCI_ERROR_CODE_RESERVED1 0x2B
532 #define HCI_ERROR_CODE_QOS_UNACCEPTABLE_PARAM 0x2C
533 #define HCI_ERROR_CODE_QOS_REJ 0x2D
534 #define HCI_ERROR_CODE_CHAN_ASSESSMENT_NOT_SUPPORTED 0x2E
535 #define HCI_ERROR_CODE_INSUFFICIENT_SECURITY 0x2F
536 #define HCI_ERROR_CODE_PARAM_OUT_OF_MANDATORY_RANGE 0x30
537 #define HCI_ERROR_CODE_RESERVED2 0x31
538 #define HCI_ERROR_CODE_ROLE_SWITCH_PENDING 0x32
539 #define HCI_ERROR_CODE_RESERVED3 0x33
540 #define HCI_ERROR_CODE_RESERVED_SLOT_VIOLATION 0x34
541 #define HCI_ERROR_CODE_ROLE_SWITCH_FAILED 0x35
542 #define HCI_ERROR_CODE_EXTENDED_INQUIRY_RESP_TOO_LARGE 0x36
543 #define HCI_ERROR_CODE_SIMPLE_PAIRING_NOT_SUPPORTED_BY_HOST 0x37
544 #define HCI_ERROR_CODE_HOST_BUSY_PAIRING 0x38
545 #define HCI_ERROR_CODE_CONN_REJ_NO_SUITABLE_CHAN_FOUND 0x39
546 #define HCI_ERROR_CODE_CONTROLLER_BUSY 0x3A
547 #define HCI_ERROR_CODE_UNACCEPTABLE_CONN_PARAMETERS 0x3B
548 #define HCI_ERROR_CODE_DIRECTED_ADV_TIMEOUT 0x3C
549 #define HCI_ERROR_CODE_CONN_TERM_MIC_FAILURE 0x3D
550 #define HCI_ERROR_CODE_CONN_FAILED_TO_ESTABLISH 0x3E
551 #define HCI_ERROR_CODE_MAC_CONN_FAILED 0x3F
552 #define HCI_ERROR_CODE_COARSE_CLOCK_ADJUST_REJECTED 0x40
553 
559 #define HCI_MAX_NUM_CMD_BUFFERS LL_MAX_NUM_CMD_BUFFERS
560 #if defined(CC2540) || defined(CC2541) || defined(CC2541S)
561 #define HCI_MAX_NUM_DATA_BUFFERS LL_MAX_NUM_DATA_BUFFERS //<! Max Num Data Buffers
562 #endif // CC2540 | CC2541 | CC2541S
563 
564 // Send Data Packet Boundary Flags
565 #define FIRST_PKT_HOST_TO_CTRL LL_DATA_FIRST_PKT_HOST_TO_CTRL
566 #define CONTINUING_PKT LL_DATA_CONTINUATION_PKT
567 #define FIRST_PKT_CTRL_TO_HOST LL_DATA_FIRST_PKT_CTRL_TO_HOST
568 
569 
571 #define HCI_RSSI_NOT_AVAILABLE LL_RSSI_NOT_AVAILABLE
572 
576 #define HCI_DISCONNECT_AUTH_FAILURE HCI_ERROR_CODE_AUTH_FAILURE
577 #define HCI_DISCONNECT_REMOTE_USER_TERM HCI_ERROR_CODE_REMOTE_USER_TERM_CONN
578 #define HCI_DISCONNECT_REMOTE_DEV_LOW_RESOURCES HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_LOW_RESOURCES
579 #define HCI_DISCONNECT_REMOTE_DEV_POWER_OFF HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_POWER_OFF
580 #define HCI_DISCONNECT_UNSUPPORTED_REMOTE_FEATURE HCI_ERROR_CODE_UNSUPPORTED_REMOTE_FEATURE
581 #define HCI_DISCONNECT_KEY_PAIRING_NOT_SUPPORTED HCI_ERROR_CODE_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED
582 #define HCI_DISCONNECT_UNACCEPTABLE_CONN_INTERVAL HCI_ERROR_CODE_UNACCEPTABLE_CONN_INTERVAL
583 
588 // Tx Power Types
589 #define HCI_READ_CURRENT_TX_POWER_LEVEL LL_READ_CURRENT_TX_POWER_LEVEL
590 #define HCI_READ_MAX_TX_POWER_LEVEL LL_READ_MAX_TX_POWER_LEVEL
591 
596 #define HCI_CTRL_TO_HOST_FLOW_CTRL_OFF 0
597 #define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_ON_SYNCH_OFF 1
598 #define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_OFF_SYNCH_ON 2
599 #define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_ON_SYNCH_ON 3
600 
605 #define HCI_PUBLIC_DEVICE_ADDRESS LL_DEV_ADDR_TYPE_PUBLIC
606 #define HCI_RANDOM_DEVICE_ADDRESS LL_DEV_ADDR_TYPE_RANDOM
607 
612 #define HCI_CONNECTABLE_UNDIRECTED_ADV LL_ADV_CONNECTABLE_UNDIRECTED_EVT
613 #define HCI_CONNECTABLE_DIRECTED_HDC_ADV LL_ADV_CONNECTABLE_DIRECTED_HDC_EVT
614 #define HCI_SCANNABLE_UNDIRECTED LL_ADV_SCANNABLE_UNDIRECTED_EVT
615 #define HCI_NONCONNECTABLE_UNDIRECTED_ADV LL_ADV_NONCONNECTABLE_UNDIRECTED_EVT
616 #define HCI_CONNECTABLE_DIRECTED_LDC_ADV LL_ADV_CONNECTABLE_DIRECTED_LDC_EVT
617 
622 #define HCI_ADV_CHAN_37 LL_ADV_CHAN_37
623 #define HCI_ADV_CHAN_38 LL_ADV_CHAN_38
624 #define HCI_ADV_CHAN_39 LL_ADV_CHAN_39
625 #define HCI_ADV_CHAN_ALL (LL_ADV_CHAN_37 | LL_ADV_CHAN_38 | LL_ADV_CHAN_39)
626 
631 #define HCI_ADV_WL_POLICY_ANY_REQ LL_ADV_WL_POLICY_ANY_REQ
632 #define HCI_ADV_WL_POLICY_WL_SCAN_REQ LL_ADV_WL_POLICY_WL_SCAN_REQ
633 #define HCI_ADV_WL_POLICY_WL_CONNECT_REQ LL_ADV_WL_POLICY_WL_CONNECT_REQ
634 #define HCI_ADV_WL_POLICY_WL_ALL_REQ LL_ADV_WL_POLICY_WL_ALL_REQ
635 
640 #define HCI_ENABLE_ADV LL_ADV_MODE_ON
641 #define HCI_DISABLE_ADV LL_ADV_MODE_OFF
642 
647 #define HCI_SCAN_PASSIVE LL_SCAN_PASSIVE
648 #define HCI_SCAN_ACTIVE LL_SCAN_ACTIVE
649 
654 // Scan White List Policy
655 #define HCI_SCAN_WL_POLICY_ANY_ADV_PKTS LL_SCAN_WL_POLICY_ANY_ADV_PKTS
656 #define HCI_SCAN_WL_POLICY_USE_WHITE_LIST LL_SCAN_WL_POLICY_USE_WHITE_LIST
657 
662 // Scan Filtering
663 #define HCI_FILTER_REPORTS_DISABLE LL_FILTER_REPORTS_DISABLE
664 #define HCI_FILTER_REPORTS_ENABLE LL_FILTER_REPORTS_ENABLE
665 
670 // Scan Commands
671 #define HCI_SCAN_STOP LL_SCAN_STOP
672 #define HCI_SCAN_START LL_SCAN_START
673 
678 #define HCI_INIT_WL_POLICY_USE_PEER_ADDR LL_INIT_WL_POLICY_USE_PEER_ADDR
679 #define HCI_INIT_WL_POLICY_USE_WHITE_LIST LL_INIT_WL_POLICY_USE_WHITE_LIST
680 
685 #define HCI_ENCRYPTION_OFF LL_ENCRYPTION_OFF
686 #define HCI_ENCRYPTION_ON LL_ENCRYPTION_ON
687 
692 #define HCI_DIRECT_TEST_PAYLOAD_PRBS9 LL_DIRECT_TEST_PAYLOAD_PRBS9
693 #define HCI_DIRECT_TEST_PAYLOAD_0x0F LL_DIRECT_TEST_PAYLOAD_0x0F
694 #define HCI_DIRECT_TEST_PAYLOAD_0x55 LL_DIRECT_TEST_PAYLOAD_0x55
695 #define HCI_DIRECT_TEST_PAYLOAD_PRBS15 LL_DIRECT_TEST_PAYLOAD_PRBS15
696 #define HCI_DIRECT_TEST_PAYLOAD_0xFF LL_DIRECT_TEST_PAYLOAD_0xFF
697 #define HCI_DIRECT_TEST_PAYLOAD_0x00 LL_DIRECT_TEST_PAYLOAD_0x00
698 #define HCI_DIRECT_TEST_PAYLOAD_0xF0 LL_DIRECT_TEST_PAYLOAD_0xF0
699 #define HCI_DIRECT_TEST_PAYLOAD_0xAA LL_DIRECT_TEST_PAYLOAD_0xAA
700 
705 #define HCI_DTM_STANDARD_MODULATION_INDEX LL_DTM_STANDARD_MODULATION_INDEX
706 #define HCI_DTM_STABLE_MODULATION_INDEX LL_DTM_STABLE_MODULATION_INDEX
707 
712 #define HCI_DISABLE_ADDR_RESOLUTION LL_DISABLE_ADDR_RESOLUTION
713 #define HCI_ENABLE_ADDR_RESOLUTION LL_ENABLE_ADDR_RESOLUTION
714 
719 #define HCI_PHY_USE_PHY_PARAM LL_PHY_USE_PHY_PARAM
720 #define HCI_PHY_USE_ANY_PHY LL_PHY_USE_ANY_PHY
721 
726 #define HCI_PHY_1_MBPS LL_PHY_1_MBPS
727 #define HCI_PHY_2_MBPS LL_PHY_2_MBPS
728 
733 #define HCI_EXT_RX_GAIN_STD LL_EXT_RX_GAIN_STD
734 #define HCI_EXT_RX_GAIN_HIGH LL_EXT_RX_GAIN_HIGH
735 
740 #if defined( CC26XX ) || defined( CC13XX )
741 #define HCI_EXT_TX_POWER_MINUS_21_DBM LL_EXT_TX_POWER_MINUS_21_DBM
742 #define HCI_EXT_TX_POWER_MINUS_18_DBM LL_EXT_TX_POWER_MINUS_18_DBM
743 #define HCI_EXT_TX_POWER_MINUS_15_DBM LL_EXT_TX_POWER_MINUS_15_DBM
744 #define HCI_EXT_TX_POWER_MINUS_12_DBM LL_EXT_TX_POWER_MINUS_12_DBM
745 #define HCI_EXT_TX_POWER_MINUS_9_DBM LL_EXT_TX_POWER_MINUS_9_DBM
746 #define HCI_EXT_TX_POWER_MINUS_6_DBM LL_EXT_TX_POWER_MINUS_6_DBM
747 #define HCI_EXT_TX_POWER_MINUS_3_DBM LL_EXT_TX_POWER_MINUS_3_DBM
748 #define HCI_EXT_TX_POWER_0_DBM LL_EXT_TX_POWER_0_DBM
749 #define HCI_EXT_TX_POWER_1_DBM LL_EXT_TX_POWER_1_DBM
750 #define HCI_EXT_TX_POWER_2_DBM LL_EXT_TX_POWER_2_DBM
751 #define HCI_EXT_TX_POWER_3_DBM LL_EXT_TX_POWER_3_DBM
752 #define HCI_EXT_TX_POWER_4_DBM LL_EXT_TX_POWER_4_DBM
753 #define HCI_EXT_TX_POWER_5_DBM LL_EXT_TX_POWER_5_DBM
754 #else // CC254x
755 #define HCI_EXT_TX_POWER_MINUS_23_DBM LL_EXT_TX_POWER_MINUS_23_DBM
756 #define HCI_EXT_TX_POWER_MINUS_6_DBM LL_EXT_TX_POWER_MINUS_6_DBM
757 #define HCI_EXT_TX_POWER_0_DBM LL_EXT_TX_POWER_0_DBM
758 #define HCI_EXT_TX_POWER_4_DBM LL_EXT_TX_POWER_4_DBM
759 #endif // CC26XX/CC13XX
760 
765 #define HCI_EXT_ENABLE_ONE_PKT_PER_EVT LL_EXT_ENABLE_ONE_PKT_PER_EVT
766 #define HCI_EXT_DISABLE_ONE_PKT_PER_EVT LL_EXT_DISABLE_ONE_PKT_PER_EVT
767 
769 
771 
774 #define HCI_EXT_ENABLE_CLK_DIVIDE_ON_HALT LL_EXT_ENABLE_CLK_DIVIDE_ON_HALT
775 #define HCI_EXT_DISABLE_CLK_DIVIDE_ON_HALT LL_EXT_DISABLE_CLK_DIVIDE_ON_HALT
776 
778 
780 
783 #define HCI_EXT_NV_IN_USE LL_EXT_NV_IN_USE
784 #define HCI_EXT_NV_NOT_IN_USE LL_EXT_NV_NOT_IN_USE
785 
790 #define HCI_EXT_ENABLE_FAST_TX_RESP_TIME LL_EXT_ENABLE_FAST_TX_RESP_TIME
791 #define HCI_EXT_DISABLE_FAST_TX_RESP_TIME LL_EXT_DISABLE_FAST_TX_RESP_TIME
792 
797 #define HCI_EXT_ENABLE_SL_OVERRIDE LL_EXT_ENABLE_SL_OVERRIDE
798 #define HCI_EXT_DISABLE_SL_OVERRIDE LL_EXT_DISABLE_SL_OVERRIDE
799 
804 #define HCI_EXT_TX_MODULATED_CARRIER LL_EXT_TX_MODULATED_CARRIER
805 #define HCI_EXT_TX_UNMODULATED_CARRIER LL_EXT_TX_UNMODULATED_CARRIER
806 
811 #define HCI_PTM_SET_FREQ_TUNE_DOWN LL_EXT_SET_FREQ_TUNE_DOWN
812 #define HCI_PTM_SET_FREQ_TUNE_UP LL_EXT_SET_FREQ_TUNE_UP
813 
815 
817 
820 #define HCI_EXT_PM_IO_PORT_P0 LL_EXT_PM_IO_PORT_P0
821 #define HCI_EXT_PM_IO_PORT_P1 LL_EXT_PM_IO_PORT_P1
822 #define HCI_EXT_PM_IO_PORT_P2 LL_EXT_PM_IO_PORT_P2
823 #define HCI_EXT_PM_IO_PORT_NONE LL_EXT_PM_IO_PORT_NONE
824 
825 #define HCI_EXT_PM_IO_PORT_PIN0 LL_EXT_PM_IO_PORT_PIN0
826 #define HCI_EXT_PM_IO_PORT_PIN1 LL_EXT_PM_IO_PORT_PIN1
827 #define HCI_EXT_PM_IO_PORT_PIN2 LL_EXT_PM_IO_PORT_PIN2
828 #define HCI_EXT_PM_IO_PORT_PIN3 LL_EXT_PM_IO_PORT_PIN3
829 #define HCI_EXT_PM_IO_PORT_PIN4 LL_EXT_PM_IO_PORT_PIN4
830 #define HCI_EXT_PM_IO_PORT_PIN5 LL_EXT_PM_IO_PORT_PIN5
831 #define HCI_EXT_PM_IO_PORT_PIN6 LL_EXT_PM_IO_PORT_PIN6
832 #define HCI_EXT_PM_IO_PORT_PIN7 LL_EXT_PM_IO_PORT_PIN7
833 
835 
840 #define HCI_EXT_PER_RESET LL_EXT_PER_RESET
841 #define HCI_EXT_PER_READ LL_EXT_PER_READ
842 
844 
846 
849 #define HCI_EXT_HALT_DURING_RF_DISABLE LL_EXT_HALT_DURING_RF_DISABLE
850 #define HCI_EXT_HALT_DURING_RF_ENABLE LL_EXT_HALT_DURING_RF_ENABLE
851 
853 
855 
858 #define HCI_EXT_SET_USER_REVISION LL_EXT_SET_USER_REVISION
859 #define HCI_EXT_READ_BUILD_REVISION LL_EXT_READ_BUILD_REVISION
860 
865 #define HCI_EXT_RESET_SYSTEM_HARD LL_EXT_RESET_SYSTEM_HARD
866 #define HCI_EXT_RESET_SYSTEM_SOFT LL_EXT_RESET_SYSTEM_SOFT
867 
869 
871 
874 #define HCI_EXT_DISABLE_OVERLAPPED_PROCESSING LL_EXT_DISABLE_OVERLAPPED_PROCESSING
875 #define HCI_EXT_ENABLE_OVERLAPPED_PROCESSING LL_EXT_ENABLE_OVERLAPPED_PROCESSING
876 
878 
880 
883 #define HCI_EXT_DISABLE_NUM_COMPL_PKTS_ON_EVENT LL_EXT_DISABLE_NUM_COMPL_PKTS_ON_EVENT
884 #define HCI_EXT_ENABLE_NUM_COMPL_PKTS_ON_EVENT LL_EXT_ENABLE_NUM_COMPL_PKTS_ON_EVENT
885 
890 #define HCI_EXT_DISABLE_SCAN_REQUEST_REPORT LL_EXT_DISABLE_SCAN_REQUEST_REPORT
891 #define HCI_EXT_ENABLE_SCAN_REQUEST_REPORT LL_EXT_ENABLE_SCAN_REQUEST_REPORT
892 
899 // HCI Link Type for Buffer Overflow
900 #define HCI_LINK_TYPE_SCO_BUFFER_OVERFLOW 0
901 #define HCI_LINK_TYPE_ACL_BUFFER_OVERFLOW 1
902 
906 /*
907  * TYPEDEFS
908  */
909 
911 typedef uint8 hciStatus_t;
913 
918 typedef struct
920 {
922  uint8 BLEEventCode;
923  uint8 status;
925  uint8 role;
926  uint8 peerAddrType;
927  uint8 peerAddr[B_ADDR_LEN];
928  uint16 connInterval;
929  uint16 connLatency;
930  uint16 connTimeout;
933 
935 typedef struct
936 {
938  uint8 BLEEventCode;
939  uint8 status;
941  uint8 role;
942  uint8 peerAddrType;
943  uint8 peerAddr[B_ADDR_LEN];
944  uint16 connInterval;
945  uint16 connLatency;
946  uint16 connTimeout;
948  // Note: These fields normally follow peerAddr. Put here for Host optimization.
949  uint8 localRPA[B_ADDR_LEN];
950  uint8 peerRPA[B_ADDR_LEN];
952 
955 {
959 
961 typedef struct
962 {
963  uint8 eventType;
964  uint8 addrType;
965  uint8 addr[B_ADDR_LEN];
966  uint8 dataLen;
967  uint8 rspData[B_MAX_ADV_LEN];
968  int8 rssi;
970 
972 typedef struct
973 {
975  uint8 BLEEventCode;
976  uint8 numDevices;
979 
981 typedef struct
982 {
984  uint8 BLEEventCode;
985  uint8 eventType;
986  uint8 peerAddrType;
987  uint8 peerAddr[B_ADDR_LEN];
988  uint8 bleChan;
989  int8 rssi;
991 
993 typedef struct
994 {
996  uint8 BLEEventCode;
997  uint8 status;
999  uint16 connInterval;
1000  uint16 connLatency;
1001  uint16 connTimeout;
1003 
1005 typedef struct
1006 {
1009  uint8 status;
1011  uint8 features[8];
1013 
1015 typedef struct
1016 {
1019  uint16 connHandle;
1020  uint8 reason;
1021  uint8 encEnable;
1023 
1025 typedef struct
1026 {
1029  uint16 connHandle;
1030  uint8 random[B_RANDOM_NUM_SIZE];
1033 
1035 typedef struct
1036 {
1038  uint8 numHandles;
1042 
1044 typedef struct
1045 {
1048  uint16 cmdOpcode;
1049  uint8 *pReturnParam;
1051 
1053 typedef struct
1054 {
1056  uint8 length;
1057  uint16 cmdOpcode;
1058  uint8 *pEventParam;
1060 
1062 typedef struct
1063 {
1065  uint8 cmdStatus;
1067  uint16 cmdOpcode;
1069 
1071 typedef struct
1072 {
1076 
1078 typedef struct
1079 {
1081  uint8 status;
1082  uint16 connHandle;
1083  uint8 reason;
1085 
1087 typedef struct
1088 {
1090  uint8 linkType;
1092 
1094 typedef struct
1095 {
1097  uint16 connHandle;
1099 
1101 typedef struct
1102 {
1105  uint8 status;
1106  uint16 connHandle;
1107  uint16 Interval_Min;
1108  uint16 Interval_Max;
1109  uint16 Latency;
1110  uint16 Timeout;
1112 
1114 typedef struct
1115 {
1118  uint8 status;
1119  uint16 connHandle;
1120  uint8 txPhy;
1121  uint8 rxPhy;
1123 
1125 typedef struct
1126 {
1129  uint16 connHandle;
1130  uint16 maxTxOctets;
1131  uint16 maxTxTime;
1132  uint16 maxRxOctets;
1133  uint16 maxRxTime;
1135 
1137 typedef struct
1138 {
1141  uint8 status;
1142  uint8 p256Key[LL_SC_P256_KEY_LEN];
1144 
1146 typedef struct
1147 {
1150  uint8 status;
1151  uint8 dhKey[LL_SC_DHKEY_LEN];
1153 
1155 typedef struct
1156 {
1157  uint8 status;
1158  uint16 dataPktLen;
1159  uint8 numDataPkts;
1161 
1163 typedef struct
1164 {
1166  uint8 *pData;
1167 } hciPacket_t;
1168 
1170 typedef struct
1171 {
1173  uint8 pktType;
1174  uint16 connHandle;
1175  uint8 pbFlag;
1176  uint16 pktLen;
1177  uint8 *pData;
1178 } hciDataPacket_t;
1179 
1181 
1182 // OSAL HCI_DATA_EVENT message format. This message is used to forward incoming
1183 // data messages up to an application
1184 typedef struct
1185 {
1186  osal_event_hdr_t hdr;
1187  uint16 connHandle;
1188  uint8 pbFlag;
1189  uint16 len;
1190  uint8 *pData;
1191 } hciDataEvent_t;
1192 
1194 
1195 #if defined( CC26XX ) || defined( CC13XX )
1196 PACKED_TYPEDEF_STRUCT
1197 #else // CC254x
1198 typedef struct
1199 #endif // CC26XX/CC13XX
1200 {
1201  uint8 connId;
1202  uint8 role;
1203  uint8 addr[LL_DEVICE_ADDR_LEN];
1204  uint8 addrType;
1205 } hciConnInfo_t;
1206 
1207 #if defined( CC26XX ) || defined( CC13XX )
1208 PACKED_TYPEDEF_STRUCT
1209 #else // CC254x
1210 typedef struct
1211 #endif // CC26XX/CC13XX
1212 {
1213  uint32_t accessAddr;
1214  uint16_t connInterval;
1215  uint8_t hopValue;
1216  uint16_t mSCA;
1217  uint8_t nextChan;
1218  uint8_t chanMap[LL_NUM_BYTES_FOR_CHAN_MAP];
1219  uint32_t crcInit;
1220 }hciActiveConnInfo_t;
1221 
1222 #if defined( CC26XX ) || defined( CC13XX )
1223 PACKED_TYPEDEF_STRUCT
1224 #else // CC254x
1225 typedef struct
1226 #endif // CC26XX/CC13XX
1227 {
1228  uint16 numPkts;
1229  uint16 numCrcErr;
1230  uint16 numEvents;
1231  uint16 numMMissedEvents;
1232 } hciPER_t;
1233 
1236 /*
1237  * LOCAL VARIABLES
1238  */
1239 
1240 /*
1241  * GLOBAL VARIABLES
1242  */
1243 
1245 
1257 extern void *HCI_bm_alloc( uint16 size );
1258 
1260 
1261 
1277 extern uint8 HCI_ValidConnTimeParams( uint16 connIntervalMin,
1278  uint16 connIntervalMax,
1279  uint16 connLatency,
1280  uint16 connTimeout );
1281 
1288 extern void HCI_TestAppTaskRegister( uint8 taskID );
1289 
1296 extern void HCI_GAPTaskRegister( uint8 taskID );
1297 
1303 extern void HCI_L2CAPTaskRegister( uint8 taskID );
1304 
1310 extern void HCI_SMPTaskRegister( uint8 taskID );
1311 
1317 extern void HCI_ExtTaskRegister( uint8 taskID );
1318 
1345 extern hciStatus_t HCI_SendDataPkt( uint16 connHandle,
1346  uint8 pbFlag,
1347  uint16 pktLen,
1348  uint8 *pData );
1349 
1365 extern hciStatus_t HCI_DisconnectCmd( uint16 connHandle,
1366  uint8 reason );
1367 
1368 
1386 extern hciStatus_t HCI_ReadRemoteVersionInfoCmd( uint16 connHandle );
1387 
1388 
1403 extern hciStatus_t HCI_SetEventMaskCmd( uint8 *pMask );
1404 
1405 
1420 extern hciStatus_t HCI_SetEventMaskPage2Cmd( uint8 *pMask );
1421 
1422 
1431 extern hciStatus_t HCI_ResetCmd( void );
1432 
1444 extern hciStatus_t HCI_ReadTransmitPowerLevelCmd( uint16 connHandle,
1445  uint8 txPwrType );
1446 
1448 
1465 extern hciStatus_t HCI_SetControllerToHostFlowCtrlCmd( uint8 flowControlEnable );
1466 
1467 
1468 
1491 extern hciStatus_t HCI_HostBufferSizeCmd( uint16 hostAclPktLen,
1492  uint8 hostSyncPktLen,
1493  uint16 hostTotalNumAclPkts,
1494  uint16 hostTotalNumSyncPkts );
1495 
1497 
1530 extern hciStatus_t HCI_HostNumCompletedPktCmd( uint8 numHandles,
1531  uint16 *connHandles,
1532  uint16 *numCompletedPkts );
1533 
1534 
1547 extern hciStatus_t HCI_ReadAuthPayloadTimeoutCmd( uint16 connHandle,
1548  uint16 *aptoValue );
1549 
1550 
1562 extern hciStatus_t HCI_WriteAuthPayloadTimeoutCmd( uint16 connHandle,
1563  uint16 aptoValue );
1564 
1565 
1574 extern hciStatus_t HCI_ReadLocalVersionInfoCmd( void );
1575 
1576 
1585 extern hciStatus_t HCI_ReadLocalSupportedCommandsCmd( void );
1586 
1587 
1596 extern hciStatus_t HCI_ReadLocalSupportedFeaturesCmd( void );
1597 
1598 
1607 extern hciStatus_t HCI_ReadBDADDRCmd( void );
1608 
1609 
1627 extern hciStatus_t HCI_ReadRssiCmd( uint16 connHandle );
1628 
1643 extern hciStatus_t HCI_LE_SetEventMaskCmd( uint8 *pEventMask );
1644 
1645 
1654 extern hciStatus_t HCI_LE_ReadBufSizeCmd( void );
1655 
1656 
1665 extern hciStatus_t HCI_LE_ReadLocalSupportedFeaturesCmd( void );
1666 
1667 
1679 extern hciStatus_t HCI_LE_SetRandomAddressCmd( uint8 *pRandAddr );
1680 
1681 
1700 extern hciStatus_t HCI_LE_SetAdvParamCmd( uint16 advIntervalMin,
1701  uint16 advIntervalMax,
1702  uint8 advType,
1703  uint8 ownAddrType,
1704  uint8 directAddrType,
1705  uint8 *directAddr,
1706  uint8 advChannelMap,
1707  uint8 advFilterPolicy );
1708 
1709 
1721 extern hciStatus_t HCI_LE_SetAdvDataCmd( uint8 dataLen,
1722  uint8 *pData );
1723 
1724 
1736 extern hciStatus_t HCI_LE_SetScanRspDataCmd( uint8 dataLen,
1737  uint8 *pData );
1738 
1739 
1750 extern hciStatus_t HCI_LE_SetAdvEnableCmd( uint8 advEnable );
1751 
1752 
1761 extern hciStatus_t HCI_LE_ReadAdvChanTxPowerCmd( void );
1762 
1763 
1782 extern hciStatus_t HCI_LE_SetScanParamCmd( uint8 scanType,
1783  uint16 scanInterval,
1784  uint16 scanWindow,
1785  uint8 ownAddrType,
1786  uint8 filterPolicy );
1787 
1788 
1801 extern hciStatus_t HCI_LE_SetScanEnableCmd( uint8 scanEnable,
1802  uint8 filterDuplicates );
1803 
1804 
1831 extern hciStatus_t HCI_LE_CreateConnCmd( uint16 scanInterval,
1832  uint16 scanWindow,
1833  uint8 initFilterPolicy,
1834  uint8 addrTypePeer,
1835  uint8 *peerAddr,
1836  uint8 ownAddrType,
1837  uint16 connIntervalMin,
1838  uint16 connIntervalMax,
1839  uint16 connLatency,
1840  uint16 connTimeout,
1841  uint16 minLen,
1842  uint16 maxLen );
1843 
1844 
1853 extern hciStatus_t HCI_LE_CreateConnCancelCmd( void );
1854 
1855 
1864 extern hciStatus_t HCI_LE_ReadWhiteListSizeCmd( void );
1865 
1866 
1875 extern hciStatus_t HCI_LE_ClearWhiteListCmd( void );
1876 
1877 
1889 extern hciStatus_t HCI_LE_AddWhiteListCmd( uint8 addrType,
1890  uint8 *devAddr );
1891 
1892 
1905 extern hciStatus_t HCI_LE_RemoveWhiteListCmd( uint8 addrType,
1906  uint8 *devAddr );
1907 
1908 
1926 extern hciStatus_t HCI_LE_ConnUpdateCmd( uint16 connHandle,
1927  uint16 connIntervalMin,
1928  uint16 connIntervalMax,
1929  uint16 connLatency,
1930  uint16 connTimeout,
1931  uint16 minLen,
1932  uint16 maxLen );
1933 
1934 
1945 extern hciStatus_t HCI_LE_SetHostChanClassificationCmd( uint8 *chanMap );
1946 
1947 
1958 extern hciStatus_t HCI_LE_ReadChannelMapCmd( uint16 connHandle );
1959 
1960 
1972 extern hciStatus_t HCI_LE_ReadRemoteUsedFeaturesCmd( uint16 connHandle );
1973 
1974 
1994 extern hciStatus_t HCI_LE_EncryptCmd( uint8 *key,
1995  uint8 *plainText );
1996 
1997 
2020 extern hciStatus_t HCI_LE_RandCmd( void );
2021 
2022 
2038 extern hciStatus_t HCI_LE_StartEncyptCmd( uint16 connHandle,
2039  uint8 *random,
2040  uint8 *encDiv,
2041  uint8 *ltk );
2042 
2043 
2055 extern hciStatus_t HCI_LE_LtkReqReplyCmd( uint16 connHandle,
2056  uint8 *ltk );
2057 
2058 
2069 extern hciStatus_t HCI_LE_LtkReqNegReplyCmd( uint16 connHandle );
2070 
2071 
2080 extern hciStatus_t HCI_LE_ReadSupportedStatesCmd( void );
2081 
2082 
2096 extern hciStatus_t HCI_LE_ReceiverTestCmd( uint8 rxChan );
2097 
2098 
2115 extern hciStatus_t HCI_LE_TransmitterTestCmd( uint8 txChan,
2116  uint8 dataLen,
2117  uint8 pktPayload );
2118 
2119 
2131 extern hciStatus_t HCI_LE_TestEndCmd( void );
2132 
2133 // V4.1
2134 
2156 extern hciStatus_t HCI_LE_RemoteConnParamReqReplyCmd( uint16 connHandle,
2157  uint16 connIntervalMin,
2158  uint16 connIntervalMax,
2159  uint16 connLatency,
2160  uint16 connTimeout,
2161  uint16 minLen,
2162  uint16 maxLen );
2163 
2164 
2181 extern hciStatus_t HCI_LE_RemoteConnParamReqNegReplyCmd( uint16 connHandle,
2182  uint8 reason );
2183 
2184 
2185 // V4.2 - Extended Data Length
2186 
2202 extern hciStatus_t HCI_LE_SetDataLenCmd( uint16 connHandle,
2203  uint16 txOctets,
2204  uint16 txTime );
2205 
2206 
2219 extern hciStatus_t HCI_LE_ReadSuggestedDefaultDataLenCmd( void );
2220 
2221 
2237 extern hciStatus_t HCI_LE_WriteSuggestedDefaultDataLenCmd( uint16 txOctets,
2238  uint16 txTime );
2239 
2240 
2252 extern hciStatus_t HCI_LE_ReadMaxDataLenCmd( void );
2253 
2254 
2255 // V4.2 - Privacy 1.2
2256 
2274 extern hciStatus_t HCI_LE_AddDeviceToResolvingListCmd( uint8 peerIdAddrType,
2275  uint8 *peerIdAddr,
2276  uint8 *peerIRK,
2277  uint8 *localIRK );
2278 
2279 
2295 extern hciStatus_t HCI_LE_RemoveDeviceFromResolvingListCmd( uint8 peerIdAddrType,
2296  uint8 *peerIdAddr );
2297 
2298 
2311 extern hciStatus_t HCI_LE_ClearResolvingListCmd( void );
2312 
2313 
2326 extern hciStatus_t HCI_LE_ReadResolvingListSizeCmd( void );
2327 
2328 
2347 extern hciStatus_t HCI_LE_ReadPeerResolvableAddressCmd( uint8 peerIdAddrType,
2348  uint8 *peerIdAddr );
2349 
2350 
2369 extern hciStatus_t HCI_LE_ReadLocalResolvableAddressCmd( uint8 localIdAddrType,
2370  uint8 *localIdAddr );
2371 
2372 
2388 extern hciStatus_t HCI_LE_SetAddressResolutionEnableCmd( uint8 addrResolutionEnable );
2389 
2390 
2409 extern hciStatus_t HCI_LE_SetResolvablePrivateAddressTimeoutCmd( uint16 rpaTimeout );
2410 
2411 
2412 // V4.2 - Secure Connections
2413 
2429 extern hciStatus_t HCI_LE_ReadLocalP256PublicKeyCmd( void );
2430 
2431 
2451 extern hciStatus_t HCI_LE_GenerateDHKeyCmd( uint8 *publicKey );
2452 
2454 
2455 // V5.0 - 2Mbps PHY
2456 
2467 extern hciStatus_t HCI_LE_ReadPhyCmd( uint16 connHandle );
2468 
2469 
2488 extern hciStatus_t HCI_LE_SetDefaultPhyCmd( uint8 allPhys,
2489  uint8 txPhy,
2490  uint8 rxPhy );
2491 
2492 
2509 extern hciStatus_t HCI_LE_SetPhyCmd( uint16 connHandle,
2510  uint8 allPhys,
2511  uint8 txPhy,
2512  uint8 rxPhy );
2513 
2514 
2531 extern hciStatus_t HCI_LE_EnhancedRxTestCmd( uint8 rxChan,
2532  uint8 rxPhy,
2533  uint8 modIndex );
2534 
2535 
2553 extern hciStatus_t HCI_LE_EnhancedTxTestCmd( uint8 txChan,
2554  uint8 payloadLen,
2555  uint8 payloadType,
2556  uint8 txPhy );
2557 
2559 
2560 /*
2561 ** HCI Vendor Specific Commands: Link Layer Extensions
2562 */
2563 
2576 extern hciStatus_t HCI_EXT_SetRxGainCmd( uint8 rxGain );
2577 
2578 
2594 extern hciStatus_t HCI_EXT_SetTxPowerCmd( uint8 txPower );
2595 
2596 
2607 extern hciStatus_t HCI_EXT_OnePktPerEvtCmd( uint8 control );
2608 
2609 
2611 
2629 extern hciStatus_t HCI_EXT_ClkDivOnHaltCmd( uint8 control );
2630 
2651 extern hciStatus_t HCI_EXT_DeclareNvUsageCmd( uint8 mode );
2652 
2654 
2668 extern hciStatus_t HCI_EXT_DecryptCmd( uint8 *key,
2669  uint8 *encText );
2670 
2671 
2695 extern hciStatus_t HCI_EXT_SetLocalSupportedFeaturesCmd( uint8 *localFeatures );
2696 
2697 
2722 extern hciStatus_t HCI_EXT_SetFastTxResponseTimeCmd( uint8 control );
2723 
2725 
2744 extern hciStatus_t HCI_EXT_SetSlaveLatencyOverrideCmd( uint8 control );
2745 
2747 
2770 extern hciStatus_t HCI_EXT_ModemTestTxCmd( uint8 cwMode,
2771  uint8 txChan );
2772 
2773 
2795 extern hciStatus_t HCI_EXT_ModemHopTestTxCmd( void );
2796 
2797 
2822 extern hciStatus_t HCI_EXT_ModemTestRxCmd( uint8 rxChan );
2823 
2824 
2836 extern hciStatus_t HCI_EXT_EndModemTestCmd( void );
2837 
2838 
2864 extern hciStatus_t HCI_EXT_SetBDADDRCmd( uint8 *bdAddr );
2865 
2866 
2889 extern hciStatus_t HCI_EXT_SetSCACmd( uint16 scaInPPM );
2890 
2891 
2905 extern hciStatus_t HCI_EXT_EnablePTMCmd( void );
2906 
2907 
2926 extern hciStatus_t HCI_EXT_SetFreqTuneCmd( uint8 step );
2927 
2928 
2942 extern hciStatus_t HCI_EXT_SaveFreqTuneCmd( void );
2943 
2944 
2964 extern hciStatus_t HCI_EXT_SetMaxDtmTxPowerCmd( uint8 txPower );
2965 
2967 
3007 extern hciStatus_t HCI_EXT_MapPmIoPortCmd( uint8 ioPort, uint8 ioPin );
3008 
3010 
3027 extern hciStatus_t HCI_EXT_DisconnectImmedCmd( uint16 connHandle );
3028 
3029 
3049 extern hciStatus_t HCI_EXT_PacketErrorRateCmd( uint16 connHandle, uint8 command );
3050 
3051 
3090 extern hciStatus_t HCI_EXT_PERbyChanCmd( uint16 connHandle, perByChan_t *perByChan );
3091 
3092 
3094 
3103 extern hciStatus_t HCI_EXT_ExtendRfRangeCmd( void );
3104 
3118 extern hciStatus_t HCI_EXT_HaltDuringRfCmd( uint8 mode );
3119 
3121 
3174 extern hciStatus_t HCI_EXT_AdvEventNoticeCmd( uint8 taskID, uint16 taskEvent );
3175 
3176 
3233 extern hciStatus_t HCI_EXT_ScanEventNoticeCmd( uint8 taskID, uint16 taskEvent );
3234 
3235 
3236 
3258 extern hciStatus_t HCI_EXT_BuildRevisionCmd( uint8 mode, uint16 userRevNum );
3259 
3261 
3288 extern hciStatus_t HCI_EXT_DelaySleepCmd( uint16 delay );
3289 
3291 
3309 extern hciStatus_t HCI_EXT_ResetSystemCmd( uint8 mode );
3310 
3311 // @cond NODOC
3312 
3323 extern hciStatus_t HCI_EXT_LLTestModeCmd( uint8 testCase );
3324 
3326 
3328 
3339 extern hciStatus_t HCI_EXT_OverlappedProcessingCmd( uint8 mode );
3340 
3342 
3363 extern hciStatus_t HCI_EXT_NumComplPktsLimitCmd( uint8 limit,
3364  uint8 flushOnEvt );
3365 
3366 
3402 extern hciStatus_t HCI_EXT_GetConnInfoCmd( uint8 *numAllocConns,
3403  uint8 *numActiveConns,
3404  hciConnInfo_t *activeConnInfo );
3405 
3427 extern hciStatus_t HCI_EXT_GetActiveConnInfoCmd( uint8 connId, hciActiveConnInfo_t *activeConnInfo );
3428 
3446 extern hciStatus_t HCI_EXT_SetMaxDataLenCmd( uint16 txOctets,
3447  uint16 txTime,
3448  uint16 rxOctets,
3449  uint16 rxTime );
3450 
3501 extern hciStatus_t HCI_EXT_ScanReqRptCmd( uint8 mode );
3502 
3503 
3504 #ifdef __cplusplus
3505 }
3506 #endif
3507 
3508 #endif /* HCI_H */
3509 
hciStatus_t HCI_EXT_PacketErrorRateCmd(uint16 connHandle, uint8 command)
Packet Error Rate Command.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1073
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:996
uint8 status
status of event
Definition: hci.h:1009
This API allows the software components in the Z-Stack to be written independently of the specifics o...
uint8 eventType
scan request event type
Definition: hci.h:985
uint16 * pNumCompletedPackets
pointer to the number of completed packets array
Definition: hci.h:1040
hciStatus_t HCI_EXT_SetMaxDataLenCmd(uint16 txOctets, uint16 txTime, uint16 rxOctets, uint16 rxTime)
Set the maximum Rx and Tx Octets (in bytes) and Time (in us).
uint16 connHandle
connection handle
Definition: hci.h:1129
void HCI_TestAppTaskRegister(uint8 taskID)
HCI vendor specific registration for HCI Test Application.
uint8 status
status of event
Definition: hci.h:997
uint8 status
status of event
Definition: hci.h:1118
uint8 addrType
public or random address type
Definition: hci.h:964
uint8 pktType
packet type
Definition: hci.h:1173
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1018
uint8 clockAccuracy
connection clock accuracy
Definition: hci.h:947
uint16 Interval_Min
minimum connection interval
Definition: hci.h:1107
HCI Packet event.
Definition: hci.h:1163
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1027
#define B_RANDOM_NUM_SIZE
BLE Random Number Size.
Definition: bcomdef.h:133
uint8 numHandles
number of handles
Definition: hci.h:1038
uint8 * pReturnParam
pointer to the return parameter
Definition: hci.h:1049
hciStatus_t HCI_LE_ReadRemoteUsedFeaturesCmd(uint16 connHandle)
Read the remote device&#39;s used features.
hciStatus_t HCI_LE_SetAddressResolutionEnableCmd(uint8 addrResolutionEnable)
Disable / Enable Address Resolution.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1017
uint16 dataPktLen
data packet length
Definition: hci.h:1158
Command Status Event.
Definition: hci.h:1062
uint16 connHandle
connection handle
Definition: hci.h:1119
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1127
osal_event_hdr_t hdr
osal event header
Definition: hci.h:983
hciStatus_t HCI_LE_TestEndCmd(void)
End the Direct Test Mode test.
hciStatus_t HCI_LE_SetResolvablePrivateAddressTimeoutCmd(uint16 rpaTimeout)
Set Resolvable Private Address Timeout.
hciStatus_t HCI_EXT_AdvEventNoticeCmd(uint8 taskID, uint16 taskEvent)
Advertising Event Notice Command.
hciStatus_t HCI_EXT_SetMaxDtmTxPowerCmd(uint8 txPower)
Set the maximum transmit output power for DTM.
hciStatus_t HCI_LE_LtkReqNegReplyCmd(uint16 connHandle)
Send a negative LTK reply to the Controller.
Hardware Error Event.
Definition: hci.h:1071
hciStatus_t HCI_EXT_ModemTestTxCmd(uint8 cwMode, uint8 txChan)
Start Modem TX Test.
hciStatus_t HCI_LE_TransmitterTestCmd(uint8 txChan, uint8 dataLen, uint8 pktPayload)
This LE API is used to start the transmit Direct Test Mode test.
uint8 peerAddrType
peer address type
Definition: hci.h:942
uint8 status
status of event
Definition: hci.h:1081
hciStatus_t HCI_LE_RandCmd(void)
Generate a random number.
LE Advertising Report Event.
Definition: hci.h:961
#define B_MAX_ADV_LEN
BLE Maximum Advertising Packet Length.
Definition: bcomdef.h:130
hciStatus_t HCI_LE_ReadResolvingListSizeCmd(void)
Read Resolving List Size.
LE Data Length Change Event.
Definition: hci.h:1125
void HCI_SMPTaskRegister(uint8 taskID)
HCI vendor specific registration for Host SMP.
hciStatus_t HCI_SetEventMaskPage2Cmd(uint8 *pMask)
Set the HCI event mask page 2.
hciStatus_t HCI_LE_ReadLocalSupportedFeaturesCmd(void)
Read the LE locally supported features.
hciStatus_t HCI_LE_RemoteConnParamReqReplyCmd(uint16 connHandle, uint16 connIntervalMin, uint16 connIntervalMax, uint16 connLatency, uint16 connTimeout, uint16 minLen, uint16 maxLen)
Positively reply to the Conneciton Parameter Update Request.
hciStatus_t HCI_LE_ReadAdvChanTxPowerCmd(void)
Read transmit power when Advertising.
uint8 numDevices
number of discovered devices
Definition: hci.h:976
uint16 connectionHandle
connection handle
Definition: hci.h:924
uint16 connHandle
connection handle
Definition: hci.h:1174
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1128
hciStatus_t HCI_EXT_EnablePTMCmd(void)
Enable Production Test Mode.
hciStatus_t HCI_LE_SetDataLenCmd(uint16 connHandle, uint16 txOctets, uint16 txTime)
Set Data Length.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1007
hciStatus_t HCI_EXT_ScanReqRptCmd(uint8 mode)
Enable/disable Scan Request Reports.
LE Phy Update Complete Event.
Definition: hci.h:1114
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1096
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1037
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1104
uint8 BLEEventCode
BLE Event code.
Definition: hci.h:1140
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1055
hciStatus_t HCI_WriteAuthPayloadTimeoutCmd(uint16 connHandle, uint16 aptoValue)
Used to write the connection&#39;s Authenticated Payload Timeout value.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1080
hciStatus_t HCI_LE_SetHostChanClassificationCmd(uint8 *chanMap)
Update the current data channel map.
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1149
union _hciEvt_BLEConnComplete_u_ hciEvt_BLEConnComplete_u
LE Connection Complete Event.
uint16 connInterval
connection interval
Definition: hci.h:928
hciStatus_t HCI_LE_LtkReqReplyCmd(uint16 connHandle, uint8 *ltk)
Send a positive LTK reply to the controller.
uint16 Interval_Max
maximum connection interval
Definition: hci.h:1108
void HCI_ExtTaskRegister(uint8 taskID)
HCI vendor specific registration for Host extended commands.
uint8 length
length of parametric data, in bytes
Definition: hci.h:1056
hciStatus_t HCI_EXT_NumComplPktsLimitCmd(uint8 limit, uint8 flushOnEvt)
Set the Number of Completed Packets Limit.
uint16 connectionHandle
connection handle
Definition: hci.h:1010
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1117
uint16 maxRxTime
maximum receive time
Definition: hci.h:1133
hciStatus_t HCI_ReadRssiCmd(uint16 connHandle)
Read RSSI of last packet.
uint8 status
status
Definition: hci.h:1141
uint16 connectionHandle
connection handle
Definition: hci.h:940
hciStatus_t HCI_LE_CreateConnCancelCmd(void)
Cancel connection.
uint16 connTimeout
connection supervision timeout
Definition: hci.h:1001
uint8 encEnable
encryption enabled or not
Definition: hci.h:1021
uint16 Latency
slave latency
Definition: hci.h:1109
hciStatus_t HCI_LE_ReadSupportedStatesCmd(void)
TRead the Controller&#39;s supported states.
uint16 connLatency
connection latency
Definition: hci.h:945
uint8 linkType
synchronous or asynchronous buffer overflow
Definition: hci.h:1090
hciStatus_t HCI_LE_ReadLocalP256PublicKeyCmd(void)
Read local P-256 Public Key.
Vendor Specific Command Complete Event.
Definition: hci.h:1053
osal_event_hdr_t hdr
osal event header
Definition: hci.h:995
hciStatus_t HCI_EXT_DecryptCmd(uint8 *key, uint8 *encText)
Decrypt encrypted data using AES128.
hciStatus_t HCI_EXT_SetFreqTuneCmd(uint8 step)
Set Frequency Tuning.
Data structure for HCI Command Complete Event Return Parameter.
Definition: hci.h:1155
hciStatus_t HCI_LE_SetAdvParamCmd(uint16 advIntervalMin, uint16 advIntervalMax, uint8 advType, uint8 ownAddrType, uint8 directAddrType, uint8 *directAddr, uint8 advChannelMap, uint8 advFilterPolicy)
Set the Advertising parameters.
hciStatus_t HCI_SetEventMaskCmd(uint8 *pMask)
Set the HCI event mask.
hciStatus_t HCI_LE_AddWhiteListCmd(uint8 addrType, uint8 *devAddr)
Add a white list entry.
uint8 clockAccuracy
connection clock accuracy
Definition: hci.h:931
Disconnection Complete Event.
Definition: hci.h:1078
hciStatus_t HCI_EXT_SaveFreqTuneCmd(void)
Save the frequency tuning value to non-volatile memory.
hciStatus_t HCI_EXT_GetActiveConnInfoCmd(uint8 connId, hciActiveConnInfo_t *activeConnInfo)
This API is used to get connection related information required to follow the target connection with ...
hciStatus_t HCI_LE_ReadSuggestedDefaultDataLenCmd(void)
Read Suggested Default Data Length.
hciStatus_t HCI_EXT_ResetSystemCmd(uint8 mode)
Issue a soft or hard system reset.
osal_event_hdr_t hdr
OSAL Event header.
Definition: hci.h:1172
Authenticated Payload Timeout Expired Event.
Definition: hci.h:1094
hciStatus_t HCI_LE_CreateConnCmd(uint16 scanInterval, uint16 scanWindow, uint8 initFilterPolicy, uint8 addrTypePeer, uint8 *peerAddr, uint8 ownAddrType, uint16 connIntervalMin, uint16 connIntervalMax, uint16 connLatency, uint16 connTimeout, uint16 minLen, uint16 maxLen)
Create a connection.
hciStatus_t HCI_LE_ReadWhiteListSizeCmd(void)
Read the white list.
uint16 connHandle
connection handle
Definition: hci.h:1106
uint16 maxTxTime
maximum transmission time
Definition: hci.h:1131
hciStatus_t HCI_LE_SetEventMaskCmd(uint8 *pEventMask)
Set the HCI LE event mask.
int8 rssi
report RSSI
Definition: hci.h:968
uint16 connLatency
connection latency
Definition: hci.h:1000
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:975
uint8 * pData
data
Definition: hci.h:1177
hciStatus_t HCI_EXT_SetRxGainCmd(uint8 rxGain)
Set the receiver gain.
uint8 reason
reason
Definition: hci.h:1020
int8 rssi
report RSSI
Definition: hci.h:989
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1028
uint16 cmdOpcode
command opcode
Definition: hci.h:1067
hciStatus_t HCI_ReadRemoteVersionInfoCmd(uint16 connHandle)
Request version information from the remote device in a connection.
osal_event_hdr_t hdr
OSAL event header.
Definition: hci.h:1165
hciStatus_t HCI_EXT_EndModemTestCmd(void)
Shutdown a modem test.
hciStatus_t HCI_LE_EncryptCmd(uint8 *key, uint8 *plainText)
Perform an encryption using AES128.
hciStatus_t HCI_ReadLocalVersionInfoCmd(void)
Read the local version information.
hciStatus_t HCI_LE_ReadBufSizeCmd(void)
Determine the maximum ACL data packet size allowed by the Controller.
hciStatus_t HCI_LE_ReadLocalResolvableAddressCmd(uint8 localIdAddrType, uint8 *localIdAddr)
Read Local Resolvable Private Address.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1139
hciStatus_t HCI_EXT_ModemHopTestTxCmd(void)
Start Modem Hop Tx Test.
Command Complete Event.
Definition: hci.h:1044
uint8 rxPhy
RX PHY.
Definition: hci.h:1121
hciEvt_DevInfo_t * devInfo
pointer to the array of devInfo
Definition: hci.h:977
uint16 connHandle
connection handle
Definition: hci.h:1019
HCI Data Packet.
Definition: hci.h:1170
uint8 status
status
Definition: hci.h:1150
uint8 status
status of event
Definition: hci.h:923
uint16 connTimeout
connection supervision timeout
Definition: hci.h:946
uint16 Timeout
supervision timeout
Definition: hci.h:1110
LE Generate DHKey Complete Event.
Definition: hci.h:1146
uint16 * pConnectionHandle
pointer to the connection handle array
Definition: hci.h:1039
LE Remote Connection Parameter Request Event.
Definition: hci.h:1101
uint8 HCI_ValidConnTimeParams(uint16 connIntervalMin, uint16 connIntervalMax, uint16 connLatency, uint16 connTimeout)
Checks that the connection time parameter ranges are valid.
hciStatus_t HCI_EXT_PERbyChanCmd(uint16 connHandle, perByChan_t *perByChan)
Packet Error Rate by Channel Command.
uint16 connLatency
connection latency
Definition: hci.h:929
uint8 status
status of event
Definition: hci.h:1105
hciStatus_t HCI_ReadLocalSupportedCommandsCmd(void)
Read the locally supported commands.
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:984
hciStatus_t HCI_EXT_ModemTestRxCmd(uint8 rxChan)
Start Modem Hop RX Test.
uint16 connInterval
connection interval
Definition: hci.h:944
uint8 bleChan
BLE channel.
Definition: hci.h:988
uint8 eventType
advertisement or scan response event type
Definition: hci.h:963
osal_event_hdr_t hdr
osal event header
Definition: hci.h:921
hciEvt_BLEEnhConnComplete_t enhEvt
enhanced connection complete event
Definition: hci.h:957
hciStatus_t HCI_LE_SetAdvEnableCmd(uint8 advEnable)
Turn Advertising on or off.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:937
hciStatus_t HCI_LE_ClearResolvingListCmd(void)
Remove all devices from the whitelist.
hciStatus_t HCI_EXT_OnePktPerEvtCmd(uint8 control)
Set whether a connection will be limited to one packet per event.
uint16 connTimeout
connection supervision timeout
Definition: hci.h:930
Type definitions and macros for BLE stack.
VS LE Scan Request Report Event.
Definition: hci.h:981
hciStatus_t HCI_EXT_SetFastTxResponseTimeCmd(uint8 control)
Set Fast TX Response Time.
LE Encryption Change Event.
Definition: hci.h:1015
hciStatus_t HCI_EXT_BuildRevisionCmd(uint8 mode, uint16 userRevNum)
Set a user revision number or read the build revision number.
hciStatus_t HCI_LE_SetScanRspDataCmd(uint8 dataLen, uint8 *pData)
Set the Advertising Scan Response data.
uint16 connInterval
connection interval
Definition: hci.h:999
uint8 * pEventParam
event parameters
Definition: hci.h:1058
hciEvt_BLEConnComplete_t legEvt
connection complete event
Definition: hci.h:956
hciStatus_t HCI_ReadTransmitPowerLevelCmd(uint16 connHandle, uint8 txPwrType)
Read the transmit power level.
uint8 cmdStatus
command status
Definition: hci.h:1065
LE Enhanced Connection Complete Event.
Definition: hci.h:935
uint16 connHandle
connection handle
Definition: hci.h:1097
uint16 cmdOpcode
command opcode
Definition: hci.h:1048
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:922
Number of Completed Packets Event.
Definition: hci.h:1035
hciStatus_t HCI_LE_ReadPeerResolvableAddressCmd(uint8 peerIdAddrType, uint8 *peerIdAddr)
Read the Peer Resolvable Address.
OSAL Event Header.
Definition: osal.h:92
hciStatus_t HCI_EXT_SetLocalSupportedFeaturesCmd(uint8 *localFeatures)
Write this device&#39;s supported features.
hciStatus_t HCI_LE_ReceiverTestCmd(uint8 rxChan)
Start the receiver Direct Test Mode test.
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:938
uint8 txPhy
TX PHY.
Definition: hci.h:1120
hciStatus_t HCI_LE_RemoveDeviceFromResolvingListCmd(uint8 peerIdAddrType, uint8 *peerIdAddr)
Remove a device from the whitelist.
hciStatus_t HCI_LE_RemoveWhiteListCmd(uint8 addrType, uint8 *devAddr)
Remove a white list entry.
uint8 numDataPkts
number of data packets
Definition: hci.h:1159
uint16 pktLen
packet length
Definition: hci.h:1176
hciStatus_t HCI_EXT_SetBDADDRCmd(uint8 *bdAddr)
Set this device&#39;s BLE address (BDADDR).
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1148
uint8 peerAddrType
peer address type
Definition: hci.h:926
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1064
hciStatus_t HCI_LE_StartEncyptCmd(uint16 connHandle, uint8 *random, uint8 *encDiv, uint8 *ltk)
Start encryption in a connection.
uint16 cmdOpcode
command opcode
Definition: hci.h:1057
hciStatus_t HCI_EXT_ScanEventNoticeCmd(uint8 taskID, uint16 taskEvent)
Scan Event Notice Command.
uint8 reason
reason
Definition: hci.h:1083
uint8 numHciCmdPkt
number of HCI Command Packet
Definition: hci.h:1047
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1103
uint8 hardwareCode
hardware error code
Definition: hci.h:1074
#define B_ADDR_LEN
Default Public and Random Address Length.
Definition: bcomdef.h:115
Data Buffer Overflow Event.
Definition: hci.h:1087
uint8 role
role of connection
Definition: hci.h:941
LE Connection Complete Event.
Definition: hci.h:919
uint8 numHciCmdPkt
number of HCI command packets
Definition: hci.h:1066
uint16 encryptedDiversifier
encrypted diversifier
Definition: hci.h:1031
hciStatus_t HCI_LE_AddDeviceToResolvingListCmd(uint8 peerIdAddrType, uint8 *peerIdAddr, uint8 *peerIRK, uint8 *localIRK)
Add a device to the resolving list.
LE Read Remote Used Features Complete Event.
Definition: hci.h:1005
hciStatus_t HCI_DisconnectCmd(uint16 connHandle, uint8 reason)
Terminate a connection.
hciStatus_t HCI_LE_SetAdvDataCmd(uint8 dataLen, uint8 *pData)
Set the Advertising data.
uint8 peerAddrType
peer address type
Definition: hci.h:986
hciStatus_t HCI_LE_SetRandomAddressCmd(uint8 *pRandAddr)
Set this device&#39;s Random address.
hciStatus_t HCI_LE_SetScanParamCmd(uint8 scanType, uint16 scanInterval, uint16 scanWindow, uint8 ownAddrType, uint8 filterPolicy)
Set the Scan parameters.
void HCI_L2CAPTaskRegister(uint8 taskID)
HCI vendor specific registration for Host L2CAP.
hciStatus_t HCI_ReadLocalSupportedFeaturesCmd(void)
Read the locally supported features.
hciStatus_t HCI_LE_ReadChannelMapCmd(uint16 connHandle)
Read a connection&#39;s data channel map.
uint8 status
status of event
Definition: hci.h:1157
hciStatus_t HCI_LE_ClearWhiteListCmd(void)
Clear the white list.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1046
hciStatus_t HCI_LE_ReadMaxDataLenCmd(void)
Read max data length.
hciStatus_t HCI_EXT_SetSCACmd(uint16 scaInPPM)
Set this device&#39;s Sleep Clock Accuracy.
uint16 maxTxOctets
maximum transmission bytes
Definition: hci.h:1130
hciStatus_t HCI_ReadBDADDRCmd(void)
Read this device&#39;s BLE address (BDADDR).
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1116
hciStatus_t HCI_HostNumCompletedPktCmd(uint8 numHandles, uint16 *connHandles, uint16 *numCompletedPkts)
Set the number of HCI daata packets completed per connection handle.
hciStatus_t HCI_LE_GenerateDHKeyCmd(uint8 *publicKey)
Generate Diffie-Hellman Key.
hciStatus_t HCI_ReadAuthPayloadTimeoutCmd(uint16 connHandle, uint16 *aptoValue)
Read the connection&#39;s Authenticated Payload Timeout value.
LE Connection Complete Event.
Definition: hci.h:954
LE Connection Update Complete Event.
Definition: hci.h:993
hciStatus_t HCI_EXT_SetTxPowerCmd(uint8 txPower)
Set the transmit power.
uint8 status
status of event
Definition: hci.h:939
hciStatus_t HCI_LE_WriteSuggestedDefaultDataLenCmd(uint16 txOctets, uint16 txTime)
Write Suggested Default Data Length.
LE Read P256 Public Key Complete Event.
Definition: hci.h:1137
hciStatus_t HCI_LE_SetScanEnableCmd(uint8 scanEnable, uint8 filterDuplicates)
Turn Scanning on or off.
uint8 dataLen
length of report data
Definition: hci.h:966
hciStatus_t HCI_SendDataPkt(uint16 connHandle, uint8 pbFlag, uint16 pktLen, uint8 *pData)
Send an ACL data packet over a connection.
uint8 * pData
data
Definition: hci.h:1166
LE Advertising Packet Report Event.
Definition: hci.h:972
hciStatus_t HCI_EXT_DisconnectImmedCmd(uint16 connHandle)
Disconnect the connection immediately.
uint16 connHandle
connection handle
Definition: hci.h:1082
uint8 BLEEventCode
BLE Event Code.
Definition: hci.h:1008
hciStatus_t HCI_LE_RemoteConnParamReqNegReplyCmd(uint16 connHandle, uint8 reason)
Negatively reply to the Conneciton Parameter Update Request.
hciStatus_t HCI_LE_ConnUpdateCmd(uint16 connHandle, uint16 connIntervalMin, uint16 connIntervalMax, uint16 connLatency, uint16 connTimeout, uint16 minLen, uint16 maxLen)
Update the connection parameters.
uint8 pbFlag
flag
Definition: hci.h:1175
uint16 maxRxOctets
maximum receive bytes
Definition: hci.h:1132
uint8 role
role of connection
Definition: hci.h:925
hciStatus_t HCI_ResetCmd(void)
Reset the Link Layer.
osal_event_hdr_t hdr
osal event header
Definition: hci.h:1089
uint16 connectionHandle
connection handle
Definition: hci.h:998
void HCI_GAPTaskRegister(uint8 taskID)
HCI vendor specific registration for Host GAP.
LE Long Term Key Requested Event.
Definition: hci.h:1025
osal_event_hdr_t hdr
osal event header
Definition: hci.h:974
uint16 connHandle
connection handle
Definition: hci.h:1029
hciStatus_t HCI_EXT_GetConnInfoCmd(uint8 *numAllocConns, uint8 *numActiveConns, hciConnInfo_t *activeConnInfo)
Get Connection Info.
© Copyright 1995-2018, Texas Instruments Incorporated. All rights reserved.
Trademarks | Privacy policy | Terms of use | Terms of sale