hci.h

Go to the documentation of this file.

/*
 * Copyright (c) 2015-2016, Texas Instruments Incorporated
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * *  Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * *  Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in the
 *    documentation and/or other materials provided with the distribution.
 *
 * *  Neither the name of Texas Instruments Incorporated nor the names of
 *    its contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
 * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */
/*!*****************************************************************************
 *  @defgroup HCI HCI
 *  @brief This module implements the Host Controller Interface
 *  @{
 *
 *  @defgroup HCI_Function_Maps HCI Function Maps
 *  HCI Function Mapping
 *  @{
 * 
 * This section lists the mapping between stack APIs and function names, as described 
 * in the BT core spec. The App column indicates if the command 
 * can be called by the application where Y means yes and N means no.
 *
 * <table>
 * <caption id="API_Function_Map">API Function Map</caption>
 * <tr>
 *   <th>Stack API</th>
 *   <th>BT Function</th>
 *   <th>App</th>
 * </tr>
 * <tr>
 *   <td>@ref HCI_DisconnectCmd</td>
 *   <td>Disconnect Command</td>
 *   <td>N</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_HostNumCompletedPktCmd</td>
 *   <td>Host Number Of Completed Packets Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_AddDeviceToResolvingListCmd</td>
 *   <td>LE Add Device to Resolving List Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>
 *   <td>@ref HCI_LE_AddWhiteListCmd</td>
 *   <td>LE Add Device To White List Command</td>
 *   <td>Y</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_ClearWhiteListCmd</td>
 *   <td>LE Clear White List Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_LE_ConnUpdateCmd</td>
 *   <td>LE Connection Update Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_CreateConnCancelCmd</td>
 *   <td>LE Create Connection Cancel Command</td>
 *   <td>N</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_LE_CreateConnCmd</td>
 *   <td>LE Create Connection Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_EncryptCmd</td>
 *   <td>LE Encrypt Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_LE_GenerateDHKeyCmd</td>
 *   <td>LE Generate DHKey Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_LtkReqNegReplyCmd</td>
 *   <td>LE Long Term Key Request Negative Reply Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_LtkReqReplyCmd</td>
 *   <td>LE Long Term Key Request Reply Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_RandCmd</td>
 *   <td>LE Rand Command</td>
 *   <td>N</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_ReadAdvChanTxPowerCmd</td>
 *   <td>Read Transmit Power Level Command</td>
 *   <td>Y</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_LE_ReadBufSizeCmd</td>
 *   <td>LE Read Buffer Size Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr> 
 *   <td>@ref HCI_LE_ReadChannelMapCmd</td>
 *   <td>LE Read Channel Map Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr> 
 *   <td>@ref HCI_LE_ReadLocalP256PublicKeyCmd</td>
 *   <td>LE Read Local P-256 Public Key Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr> 
 *   <td>@ref HCI_LE_ReadLocalResolvableAddressCmd</td>
 *   <td>LE Read Local Resolvable Address Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>
 *   <td>@ref HCI_LE_ReadLocalSupportedFeaturesCmd</td>
 *   <td>Read Local Supported Commands Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr> 
 *   <td>@ref HCI_LE_ReadMaxDataLenCmd</td>
 *   <td>Set Event Mask Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr>
 *   <td>@ref HCI_LE_ReadPeerResolvableAddressCmd</td>
 *   <td>LE Read Peer Resolvable Address Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr> 
 *   <td>@ref HCI_LE_ReadRemoteUsedFeaturesCmd</td>
 *   <td>LE Read Remote Used Features Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr>
 *   <td>@ref HCI_LE_ReadResolvingListSizeCmd</td>
 *   <td>LE Read Resolving List Size Command</td>
 *   <td>N</td>
 * </tr>      
 * <tr>   
 *   <td>@ref HCI_LE_ReadSuggestedDefaultDataLenCmd</td>
 *   <td>LE Read Suggested Default Data Length Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>    
 *   <td>@ref HCI_LE_ReadSupportedStatesCmd</td>
 *   <td>LE Read Supported States Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_ReadWhiteListSizeCmd</td>
 *   <td>LE Read White List Size Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_RemoteConnParamReqNegReplyCmd</td>
 *   <td>LE Remote Connection Parameter Request Negative Reply Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_RemoteConnParamReqReplyCmd</td>
 *   <td>LE Remote Connection Parameter Request Reply Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_RemoveDeviceFromResolvingListCmd</td>
 *   <td>LE Remove Device From Resolving List Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_RemoveWhiteListCmd</td>
 *   <td>LE Remove Device From White List Command</td>
 *   <td>Y</td>
 * </tr>   
 * <tr>  
 *   <td>@ref HCI_LE_SetAddressResolutionEnableCmd</td>
 *   <td>LE Set Address Resolution Enable Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>    
 *   <td>@ref HCI_LE_SetAdvDataCmd</td>
 *   <td>LE Set Advertising Data Command</td>
 *   <td>N</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_LE_SetAdvEnableCmd</td>
 *   <td>LE Set Advertise Enable Command</td>
 *   <td>N</td>
 * </tr>               
 * <tr>   
 *   <td>@ref HCI_LE_SetDataLenCmd</td>
 *   <td>LE Set Data Length Command</td>
 *   <td>Y</td>
 * </tr>       
 * <tr>   
 *   <td>@ref HCI_LE_SetEventMaskCmd</td>
 *   <td>LE Set Event Mask Command</td>
 *   <td>Y</td>
 * </tr>               
 * <tr>   
 *   <td>@ref HCI_LE_SetHostChanClassificationCmd</td>
 *   <td>LE Set Host Channel Classification Command</td>
 *   <td>Y</td>
 * </tr>    
 * <tr>   
 *   <td>@ref HCI_LE_SetRandomAddressCmd</td>
 *   <td>LE Set Random Address Command</td>
 *   <td>N</td>
 * </tr>               
 * <tr>   
 *   <td>@ref HCI_LE_SetResolvablePrivateAddressTimeoutCmd</td>
 *   <td>LE Set Resolvable Private Address Timeout Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>   
 *   <td>@ref HCI_LE_SetScanEnableCmd</td>
 *   <td>LE Set Scan Enable Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>   
 *   <td>@ref HCI_LE_SetScanParamCmd</td>
 *   <td>LE Set Scan Parameters Command</td>
 *   <td>N</td>
 * </tr>               
 * <tr>   
 *   <td>@ref HCI_LE_SetAdvDataCmd</td>
 *   <td>LE Set Advertising Data Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>   
 *   <td>@ref HCI_LE_SetAdvEnableCmd</td>
 *   <td>LE Set Advertise Enable Command</td>
 *   <td>N</td>
 * </tr>   
 * <tr>   
 *   <td>@ref HCI_LE_SetAdvParamCmd</td>
 *   <td>LE Set Advertising Parameters Command</td>
 *   <td>N</td>
 * </tr>                         
 * <tr>   
 *   <td>@ref HCI_LE_SetScanRspDataCmd</td>
 *   <td>LE Set Scan Response Data Command</td>
 *   <td>N</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_LE_StartEncyptCmd</td>
 *   <td>LE Start Encryption Command</td>
 *   <td>N</td>
 * </tr>     
 * <tr>   
 *   <td>@ref HCI_LE_TestEndCmd</td>
 *   <td>LE Test End Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_LE_TransmitterTestCmd</td>
 *   <td>LE Transmitter Test Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_LE_WriteSuggestedDefaultDataLenCmd</td>
 *   <td>LE Write Suggested Default Data Length Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadAuthPayloadTimeoutCmd</td>
 *   <td>Read Authenticated Payload Timeout Command</td>
 *   <td>N</td>
 * </tr>     
 * <tr>   
 *   <td>@ref HCI_ReadBDADDRCmd</td>
 *   <td>Read BD_ADDR Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadLocalSupportedCommandsCmd</td>
 *   <td>Read Local Supported Commands Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadLocalSupportedFeaturesCmd</td>
 *   <td>Read Local Supported Features Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadLocalVersionInfoCmd</td>
 *   <td>Read Local Version Information Command</td>
 *   <td>Y</td>
 * </tr>     
 * <tr>   
 *   <td>@ref HCI_ReadRemoteVersionInfoCmd</td>
 *   <td>Read Remote Version Information Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadRssiCmd</td>
 *   <td>Read RSSI Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ReadTransmitPowerLevelCmd</td>
 *   <td>Read Transmit Power Level Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_ResetCmd</td>
 *   <td>Reset Command</td>
 *   <td>Y</td>
 * </tr>  
 * <tr>   
 *   <td>@ref HCI_SetEventMaskCmd</td>
 *   <td>Set Event Mask Command</td>
 *   <td>Y</td>
 * </tr> 
 * <tr>   
 *   <td>@ref HCI_SetEventMaskPage2Cmd</td>
 *   <td>Set Event Mask Page 2 Command</td>
 *   <td>Y</td>
 * </tr> 
 * </table>
 *
 * This section lists the mapping between stack APIs and function names, as described 
 * in the Vendor Specific API guide included with the installer.
 *
 * <table>
 * <caption id="Vendor_Specific_API_Function_Map">Vendor Specific API Function Map</caption>
 * <tr>
 *   <th>Stack API</th>
 *   <th>BT Function</th>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_AdvEventNoticeCmd</td>
 *   <td>HCI Extension Advertiser Event Notice</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_BuildRevisionCmd</td>
 *   <td>HCI Extension Build Revision</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ConnEventNoticeCmd</td>
 *   <td>HCI Extension Connection Event Notice</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_DeclareNvUsageCmd</td>
 *   <td>HCI Extension Declare NV Usage</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_DecryptCmd</td>
 *   <td>HCI Extension Decrypt</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_DisconnectImmedCmd</td>
 *   <td>HCI Extension Disconnect Immediate</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_EnablePTMCmd</td>
 *   <td>HCI Extension Enable PTM</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_EndModemTestCmd</td>
 *   <td>Set Event Mask Command</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_EndModemTestCmd</td>
 *   <td>HCI Extension End Modem Test</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ModemHopTestTxCmd</td>
 *   <td>HCI Extension Modem Hop Test Transmit</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ModemTestRxCmd</td>
 *   <td>HCI Extension Modem Test Receive</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ModemTestTxCmd</td>
 *   <td>HCI Extension Modem Test Transmit</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_NumComplPktsLimitCmd</td>
 *   <td>HCI Extension Number Completed Packets Limit</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_OnePktPerEvtCmd</td>
 *   <td>HCI Extension One Packet Per Event</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_PacketErrorRateCmd</td>
 *   <td>HCI Extension Packet Error Rate</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_PERbyChanCmd</td>
 *   <td>HCI Extension Packet Error Rate By Channel</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_SaveFreqTuneCmd</td>
 *   <td>HCI Extension Save Frequency Tuning</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ScanEventNoticeCmd </td>
 *   <td>HCI Extension Scan Event Notice</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_ScanReqRptCmd</td>
 *   <td>HCI Extension Scan Request Report</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_EXT_SetBDADDRCmd</td>
 *   <td>HCI Extension Set BDADDR</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_SetFastTxResponseTimeCmd</td>
 *   <td>HCI Extension Set Fast Transmit Response Time</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_SetFreqTuneCmd</td>
 *   <td>HCI Extension Set Frequency Tuning</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_SetLocalSupportedFeaturesCmd</td>
 *   <td>HCI Extension Set Local Supported Features</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_EXT_SetMaxDataLenCmd</td>
 *   <td>HCI Extension Set Max Data Length</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_SetMaxDtmTxPowerCmd</td>
 *   <td>HCI Extension Set Max DTM Transmitter Power</td>
 * </tr> 
 * <tr>
 *   <td>@ref HCI_EXT_SetRxGainCmd</td>
 *   <td>HCI Extension Set Receiver Gain</td>
 * </tr>  
 * <tr>
 *   <td>@ref HCI_EXT_SetSCACmd</td>
 *   <td>HCI Extension Set SCA</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_SetSlaveLatencyOverrideCmd</td>
 *   <td>HCI Extension Set Slave Latency Override</td>
 * </tr>
 * <tr>
 *   <td>@ref HCI_EXT_SetTxPowerCmd</td>
 *   <td>HCI Extension Set Transmitter Power</td>
 * </tr> 
 * </table>
 *
 * @} End HCI_Function_Maps
 *
 *  @file       hci.h
 *  @brief      HCI layer interface
 */

#ifndef HCI_H
#define HCI_H

#ifdef __cplusplus
extern "C"
{
#endif

/*
 * INCLUDES
 */
#include "bcomdef.h"
#include "osal.h"
#include "ll.h"
#include "hal_assert.h"

/*
 * MACROS
 */

/*
 * CONSTANTS
 */

#define HCI_SUCCESS                                                         0x00 
#define HCI_ERROR_CODE_UNKNOWN_HCI_CMD                                      0x01 
#define HCI_ERROR_CODE_UNKNOWN_CONN_ID                                      0x02 
#define HCI_ERROR_CODE_HW_FAILURE                                           0x03 
#define HCI_ERROR_CODE_PAGE_TIMEOUT                                         0x04 
#define HCI_ERROR_CODE_AUTH_FAILURE                                         0x05 
#define HCI_ERROR_CODE_PIN_KEY_MISSING                                      0x06 
#define HCI_ERROR_CODE_MEM_CAP_EXCEEDED                                     0x07 
#define HCI_ERROR_CODE_CONN_TIMEOUT                                         0x08 
#define HCI_ERROR_CODE_CONN_LIMIT_EXCEEDED                                  0x09 
#define HCI_ERROR_CODE_SYNCH_CONN_LIMIT_EXCEEDED                            0x0A 
#define HCI_ERROR_CODE_ACL_CONN_ALREADY_EXISTS                              0x0B 
#define HCI_ERROR_CODE_CMD_DISALLOWED                                       0x0C 
#define HCI_ERROR_CODE_CONN_REJ_LIMITED_RESOURCES                           0x0D 
#define HCI_ERROR_CODE_CONN_REJECTED_SECURITY_REASONS                       0x0E 
#define HCI_ERROR_CODE_CONN_REJECTED_UNACCEPTABLE_BDADDR                    0x0F 
#define HCI_ERROR_CODE_CONN_ACCEPT_TIMEOUT_EXCEEDED                         0x10 
#define HCI_ERROR_CODE_UNSUPPORTED_FEATURE_PARAM_VALUE                      0x11 
#define HCI_ERROR_CODE_INVALID_HCI_CMD_PARAMS                               0x12 
#define HCI_ERROR_CODE_REMOTE_USER_TERM_CONN                                0x13 
#define HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_LOW_RESOURCES                0x14 
#define HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_POWER_OFF                    0x15 
#define HCI_ERROR_CODE_CONN_TERM_BY_LOCAL_HOST                              0x16 
#define HCI_ERROR_CODE_REPEATED_ATTEMPTS                                    0x17 
#define HCI_ERROR_CODE_PAIRING_NOT_ALLOWED                                  0x18 
#define HCI_ERROR_CODE_UNKNOWN_LMP_PDU                                      0x19 
#define HCI_ERROR_CODE_UNSUPPORTED_REMOTE_FEATURE                           0x1A 
#define HCI_ERROR_CODE_SCO_OFFSET_REJ                                       0x1B 
#define HCI_ERROR_CODE_SCO_INTERVAL_REJ                                     0x1C 
#define HCI_ERROR_CODE_SCO_AIR_MODE_REJ                                     0x1D 
#define HCI_ERROR_CODE_INVALID_LMP_PARAMS                                   0x1E 
#define HCI_ERROR_CODE_UNSPECIFIED_ERROR                                    0x1F 
#define HCI_ERROR_CODE_UNSUPPORTED_LMP_PARAM_VAL                            0x20 
#define HCI_ERROR_CODE_ROLE_CHANGE_NOT_ALLOWED                              0x21 
#define HCI_ERROR_CODE_LMP_LL_RESP_TIMEOUT                                  0x22 
#define HCI_ERROR_CODE_LMP_ERR_TRANSACTION_COLLISION                        0x23 
#define HCI_ERROR_CODE_LMP_PDU_NOT_ALLOWED                                  0x24 
#define HCI_ERROR_CODE_ENCRYPT_MODE_NOT_ACCEPTABLE                          0x25 
#define HCI_ERROR_CODE_LINK_KEY_CAN_NOT_BE_CHANGED                          0x26 
#define HCI_ERROR_CODE_REQ_QOS_NOT_SUPPORTED                                0x27 
#define HCI_ERROR_CODE_INSTANT_PASSED                                       0x28 
#define HCI_ERROR_CODE_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED                  0x29 
#define HCI_ERROR_CODE_DIFFERENT_TRANSACTION_COLLISION                      0x2A 
#define HCI_ERROR_CODE_RESERVED1                                            0x2B 
#define HCI_ERROR_CODE_QOS_UNACCEPTABLE_PARAM                               0x2C 
#define HCI_ERROR_CODE_QOS_REJ                                              0x2D 
#define HCI_ERROR_CODE_CHAN_ASSESSMENT_NOT_SUPPORTED                        0x2E 
#define HCI_ERROR_CODE_INSUFFICIENT_SECURITY                                0x2F 
#define HCI_ERROR_CODE_PARAM_OUT_OF_MANDATORY_RANGE                         0x30 
#define HCI_ERROR_CODE_RESERVED2                                            0x31 
#define HCI_ERROR_CODE_ROLE_SWITCH_PENDING                                  0x32 
#define HCI_ERROR_CODE_RESERVED3                                            0x33 
#define HCI_ERROR_CODE_RESERVED_SLOT_VIOLATION                              0x34 
#define HCI_ERROR_CODE_ROLE_SWITCH_FAILED                                   0x35 
#define HCI_ERROR_CODE_EXTENDED_INQUIRY_RESP_TOO_LARGE                      0x36 
#define HCI_ERROR_CODE_SIMPLE_PAIRING_NOT_SUPPORTED_BY_HOST                 0x37 
#define HCI_ERROR_CODE_HOST_BUSY_PAIRING                                    0x38 
#define HCI_ERROR_CODE_CONN_REJ_NO_SUITABLE_CHAN_FOUND                      0x39 
#define HCI_ERROR_CODE_CONTROLLER_BUSY                                      0x3A 
#define HCI_ERROR_CODE_UNACCEPTABLE_CONN_PARAMETERS                         0x3B 
#define HCI_ERROR_CODE_DIRECTED_ADV_TIMEOUT                                 0x3C 
#define HCI_ERROR_CODE_CONN_TERM_MIC_FAILURE                                0x3D 
#define HCI_ERROR_CODE_CONN_FAILED_TO_ESTABLISH                             0x3E 
#define HCI_ERROR_CODE_MAC_CONN_FAILED                                      0x3F 
#define HCI_ERROR_CODE_COARSE_CLOCK_ADJUST_REJECTED                         0x40 

#define HCI_MAX_NUM_CMD_BUFFERS                        LL_MAX_NUM_CMD_BUFFERS  
#if defined(CC2540) || defined(CC2541) || defined(CC2541S)
#define HCI_MAX_NUM_DATA_BUFFERS                       LL_MAX_NUM_DATA_BUFFERS  //<! Max Num Data Buffers
#endif // CC2540 | CC2541 | CC2541S

// Send Data Packet Boundary Flags
#define FIRST_PKT_HOST_TO_CTRL                         LL_DATA_FIRST_PKT_HOST_TO_CTRL       
#define CONTINUING_PKT                                 LL_DATA_CONTINUATION_PKT             
#define FIRST_PKT_CTRL_TO_HOST                         LL_DATA_FIRST_PKT_CTRL_TO_HOST       


#define HCI_RSSI_NOT_AVAILABLE                         LL_RSSI_NOT_AVAILABLE

#define HCI_DISCONNECT_AUTH_FAILURE                    HCI_ERROR_CODE_AUTH_FAILURE                              
#define HCI_DISCONNECT_REMOTE_USER_TERM                HCI_ERROR_CODE_REMOTE_USER_TERM_CONN                     
#define HCI_DISCONNECT_REMOTE_DEV_LOW_RESOURCES        HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_LOW_RESOURCES     
#define HCI_DISCONNECT_REMOTE_DEV_POWER_OFF            HCI_ERROR_CODE_REMOTE_DEVICE_TERM_CONN_POWER_OFF         
#define HCI_DISCONNECT_UNSUPPORTED_REMOTE_FEATURE      HCI_ERROR_CODE_UNSUPPORTED_REMOTE_FEATURE                
#define HCI_DISCONNECT_KEY_PAIRING_NOT_SUPPORTED       HCI_ERROR_CODE_PAIRING_WITH_UNIT_KEY_NOT_SUPPORTED       
#define HCI_DISCONNECT_UNACCEPTABLE_CONN_INTERVAL      HCI_ERROR_CODE_UNACCEPTABLE_CONN_INTERVAL                

// Tx Power Types
#define HCI_READ_CURRENT_TX_POWER_LEVEL                LL_READ_CURRENT_TX_POWER_LEVEL           
#define HCI_READ_MAX_TX_POWER_LEVEL                    LL_READ_MAX_TX_POWER_LEVEL               

#define HCI_CTRL_TO_HOST_FLOW_CTRL_OFF                 0        
#define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_ON_SYNCH_OFF    1        
#define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_OFF_SYNCH_ON    2        
#define HCI_CTRL_TO_HOST_FLOW_CTRL_ACL_ON_SYNCH_ON     3        

#define HCI_PUBLIC_DEVICE_ADDRESS                      LL_DEV_ADDR_TYPE_PUBLIC      
#define HCI_RANDOM_DEVICE_ADDRESS                      LL_DEV_ADDR_TYPE_RANDOM      

#define HCI_CONNECTABLE_UNDIRECTED_ADV                 LL_ADV_CONNECTABLE_UNDIRECTED_EVT        
#define HCI_CONNECTABLE_DIRECTED_HDC_ADV               LL_ADV_CONNECTABLE_DIRECTED_HDC_EVT      
#define HCI_SCANNABLE_UNDIRECTED                       LL_ADV_SCANNABLE_UNDIRECTED_EVT          
#define HCI_NONCONNECTABLE_UNDIRECTED_ADV              LL_ADV_NONCONNECTABLE_UNDIRECTED_EVT     
#define HCI_CONNECTABLE_DIRECTED_LDC_ADV               LL_ADV_CONNECTABLE_DIRECTED_LDC_EVT      

#define HCI_ADV_CHAN_37                                LL_ADV_CHAN_37       
#define HCI_ADV_CHAN_38                                LL_ADV_CHAN_38       
#define HCI_ADV_CHAN_39                                LL_ADV_CHAN_39       
#define HCI_ADV_CHAN_ALL                               (LL_ADV_CHAN_37 | LL_ADV_CHAN_38 | LL_ADV_CHAN_39)   

#define HCI_ADV_WL_POLICY_ANY_REQ                      LL_ADV_WL_POLICY_ANY_REQ             
#define HCI_ADV_WL_POLICY_WL_SCAN_REQ                  LL_ADV_WL_POLICY_WL_SCAN_REQ         
#define HCI_ADV_WL_POLICY_WL_CONNECT_REQ               LL_ADV_WL_POLICY_WL_CONNECT_REQ      
#define HCI_ADV_WL_POLICY_WL_ALL_REQ                   LL_ADV_WL_POLICY_WL_ALL_REQ          

#define HCI_ENABLE_ADV                                 LL_ADV_MODE_ON       
#define HCI_DISABLE_ADV                                LL_ADV_MODE_OFF      

#define HCI_SCAN_PASSIVE                               LL_SCAN_PASSIVE      
#define HCI_SCAN_ACTIVE                                LL_SCAN_ACTIVE       

// Scan White List Policy
#define HCI_SCAN_WL_POLICY_ANY_ADV_PKTS                LL_SCAN_WL_POLICY_ANY_ADV_PKTS       
#define HCI_SCAN_WL_POLICY_USE_WHITE_LIST              LL_SCAN_WL_POLICY_USE_WHITE_LIST     

// Scan Filtering
#define HCI_FILTER_REPORTS_DISABLE                     LL_FILTER_REPORTS_DISABLE    
#define HCI_FILTER_REPORTS_ENABLE                      LL_FILTER_REPORTS_ENABLE     

// Scan Commands
#define HCI_SCAN_STOP                                  LL_SCAN_STOP     
#define HCI_SCAN_START                                 LL_SCAN_START    

#define HCI_INIT_WL_POLICY_USE_PEER_ADDR               LL_INIT_WL_POLICY_USE_PEER_ADDR      
#define HCI_INIT_WL_POLICY_USE_WHITE_LIST              LL_INIT_WL_POLICY_USE_WHITE_LIST     

#define HCI_ENCRYPTION_OFF                             LL_ENCRYPTION_OFF        
#define HCI_ENCRYPTION_ON                              LL_ENCRYPTION_ON         

#define HCI_DIRECT_TEST_PAYLOAD_PRBS9                  LL_DIRECT_TEST_PAYLOAD_PRBS9     
#define HCI_DIRECT_TEST_PAYLOAD_0x0F                   LL_DIRECT_TEST_PAYLOAD_0x0F      
#define HCI_DIRECT_TEST_PAYLOAD_0x55                   LL_DIRECT_TEST_PAYLOAD_0x55      
#define HCI_DIRECT_TEST_PAYLOAD_PRBS15                 LL_DIRECT_TEST_PAYLOAD_PRBS15    
#define HCI_DIRECT_TEST_PAYLOAD_0xFF                   LL_DIRECT_TEST_PAYLOAD_0xFF      
#define HCI_DIRECT_TEST_PAYLOAD_0x00                   LL_DIRECT_TEST_PAYLOAD_0x00      
#define HCI_DIRECT_TEST_PAYLOAD_0xF0                   LL_DIRECT_TEST_PAYLOAD_0xF0      
#define HCI_DIRECT_TEST_PAYLOAD_0xAA                   LL_DIRECT_TEST_PAYLOAD_0xAA      

#define HCI_DTM_STANDARD_MODULATION_INDEX              LL_DTM_STANDARD_MODULATION_INDEX     
#define HCI_DTM_STABLE_MODULATION_INDEX                LL_DTM_STABLE_MODULATION_INDEX       

#define HCI_DISABLE_ADDR_RESOLUTION                    LL_DISABLE_ADDR_RESOLUTION       
#define HCI_ENABLE_ADDR_RESOLUTION                     LL_ENABLE_ADDR_RESOLUTION        

#define HCI_PHY_USE_PHY_PARAM                          LL_PHY_USE_PHY_PARAM     
#define HCI_PHY_USE_ANY_PHY                            LL_PHY_USE_ANY_PHY       
//
#define HCI_PHY_1_MBPS                                 LL_PHY_1_MBPS            
#define HCI_PHY_2_MBPS                                 LL_PHY_2_MBPS            

#define HCI_EXT_RX_GAIN_STD                            LL_EXT_RX_GAIN_STD       
#define HCI_EXT_RX_GAIN_HIGH                           LL_EXT_RX_GAIN_HIGH      

#if defined( CC26XX ) || defined( CC13XX )
#define HCI_EXT_TX_POWER_MINUS_21_DBM                  LL_EXT_TX_POWER_MINUS_21_DBM  
#define HCI_EXT_TX_POWER_MINUS_18_DBM                  LL_EXT_TX_POWER_MINUS_18_DBM  
#define HCI_EXT_TX_POWER_MINUS_15_DBM                  LL_EXT_TX_POWER_MINUS_15_DBM  
#define HCI_EXT_TX_POWER_MINUS_12_DBM                  LL_EXT_TX_POWER_MINUS_12_DBM  
#define HCI_EXT_TX_POWER_MINUS_9_DBM                   LL_EXT_TX_POWER_MINUS_9_DBM  
#define HCI_EXT_TX_POWER_MINUS_6_DBM                   LL_EXT_TX_POWER_MINUS_6_DBM  
#define HCI_EXT_TX_POWER_MINUS_3_DBM                   LL_EXT_TX_POWER_MINUS_3_DBM  
#define HCI_EXT_TX_POWER_0_DBM                         LL_EXT_TX_POWER_0_DBM  
#define HCI_EXT_TX_POWER_1_DBM                         LL_EXT_TX_POWER_1_DBM  
#define HCI_EXT_TX_POWER_2_DBM                         LL_EXT_TX_POWER_2_DBM  
#define HCI_EXT_TX_POWER_3_DBM                         LL_EXT_TX_POWER_3_DBM  
#define HCI_EXT_TX_POWER_4_DBM                         LL_EXT_TX_POWER_4_DBM  
#define HCI_EXT_TX_POWER_5_DBM                         LL_EXT_TX_POWER_5_DBM  
#else // CC254x
#define HCI_EXT_TX_POWER_MINUS_23_DBM                  LL_EXT_TX_POWER_MINUS_23_DBM 
#define HCI_EXT_TX_POWER_MINUS_6_DBM                   LL_EXT_TX_POWER_MINUS_6_DBM  
#define HCI_EXT_TX_POWER_0_DBM                         LL_EXT_TX_POWER_0_DBM        
#define HCI_EXT_TX_POWER_4_DBM                         LL_EXT_TX_POWER_4_DBM        
#endif // CC26XX/CC13XX

#define HCI_EXT_ENABLE_ONE_PKT_PER_EVT                 LL_EXT_ENABLE_ONE_PKT_PER_EVT    
#define HCI_EXT_DISABLE_ONE_PKT_PER_EVT                LL_EXT_DISABLE_ONE_PKT_PER_EVT   



#define HCI_EXT_ENABLE_CLK_DIVIDE_ON_HALT              LL_EXT_ENABLE_CLK_DIVIDE_ON_HALT 
#define HCI_EXT_DISABLE_CLK_DIVIDE_ON_HALT             LL_EXT_DISABLE_CLK_DIVIDE_ON_HALT    



#define HCI_EXT_NV_IN_USE                              LL_EXT_NV_IN_USE         
#define HCI_EXT_NV_NOT_IN_USE                          LL_EXT_NV_NOT_IN_USE     

#define HCI_EXT_ENABLE_FAST_TX_RESP_TIME               LL_EXT_ENABLE_FAST_TX_RESP_TIME  
#define HCI_EXT_DISABLE_FAST_TX_RESP_TIME              LL_EXT_DISABLE_FAST_TX_RESP_TIME 

#define HCI_EXT_ENABLE_SL_OVERRIDE                     LL_EXT_ENABLE_SL_OVERRIDE    
#define HCI_EXT_DISABLE_SL_OVERRIDE                    LL_EXT_DISABLE_SL_OVERRIDE   

#define HCI_EXT_TX_MODULATED_CARRIER                   LL_EXT_TX_MODULATED_CARRIER  
#define HCI_EXT_TX_UNMODULATED_CARRIER                 LL_EXT_TX_UNMODULATED_CARRIER 

#define HCI_PTM_SET_FREQ_TUNE_DOWN                     LL_EXT_SET_FREQ_TUNE_DOWN    
#define HCI_PTM_SET_FREQ_TUNE_UP                       LL_EXT_SET_FREQ_TUNE_UP      



#define HCI_EXT_PM_IO_PORT_P0                          LL_EXT_PM_IO_PORT_P0
#define HCI_EXT_PM_IO_PORT_P1                          LL_EXT_PM_IO_PORT_P1
#define HCI_EXT_PM_IO_PORT_P2                          LL_EXT_PM_IO_PORT_P2
#define HCI_EXT_PM_IO_PORT_NONE                        LL_EXT_PM_IO_PORT_NONE

#define HCI_EXT_PM_IO_PORT_PIN0                        LL_EXT_PM_IO_PORT_PIN0
#define HCI_EXT_PM_IO_PORT_PIN1                        LL_EXT_PM_IO_PORT_PIN1
#define HCI_EXT_PM_IO_PORT_PIN2                        LL_EXT_PM_IO_PORT_PIN2
#define HCI_EXT_PM_IO_PORT_PIN3                        LL_EXT_PM_IO_PORT_PIN3
#define HCI_EXT_PM_IO_PORT_PIN4                        LL_EXT_PM_IO_PORT_PIN4
#define HCI_EXT_PM_IO_PORT_PIN5                        LL_EXT_PM_IO_PORT_PIN5
#define HCI_EXT_PM_IO_PORT_PIN6                        LL_EXT_PM_IO_PORT_PIN6
#define HCI_EXT_PM_IO_PORT_PIN7                        LL_EXT_PM_IO_PORT_PIN7


#define HCI_EXT_PER_RESET                              LL_EXT_PER_RESET     
#define HCI_EXT_PER_READ                               LL_EXT_PER_READ      



#define HCI_EXT_HALT_DURING_RF_DISABLE                 LL_EXT_HALT_DURING_RF_DISABLE    
#define HCI_EXT_HALT_DURING_RF_ENABLE                  LL_EXT_HALT_DURING_RF_ENABLE     



#define HCI_EXT_SET_USER_REVISION                      LL_EXT_SET_USER_REVISION     
#define HCI_EXT_READ_BUILD_REVISION                    LL_EXT_READ_BUILD_REVISION   

#define HCI_EXT_RESET_SYSTEM_HARD                      LL_EXT_RESET_SYSTEM_HARD     
#define HCI_EXT_RESET_SYSTEM_SOFT                      LL_EXT_RESET_SYSTEM_SOFT     



#define HCI_EXT_DISABLE_OVERLAPPED_PROCESSING          LL_EXT_DISABLE_OVERLAPPED_PROCESSING 
#define HCI_EXT_ENABLE_OVERLAPPED_PROCESSING           LL_EXT_ENABLE_OVERLAPPED_PROCESSING  



#define HCI_EXT_DISABLE_NUM_COMPL_PKTS_ON_EVENT        LL_EXT_DISABLE_NUM_COMPL_PKTS_ON_EVENT   
#define HCI_EXT_ENABLE_NUM_COMPL_PKTS_ON_EVENT         LL_EXT_ENABLE_NUM_COMPL_PKTS_ON_EVENT    

#define HCI_EXT_DISABLE_SCAN_REQUEST_REPORT            LL_EXT_DISABLE_SCAN_REQUEST_REPORT   
#define HCI_EXT_ENABLE_SCAN_REQUEST_REPORT             LL_EXT_ENABLE_SCAN_REQUEST_REPORT    

// HCI Link Type for Buffer Overflow
#define HCI_LINK_TYPE_SCO_BUFFER_OVERFLOW              0    
#define HCI_LINK_TYPE_ACL_BUFFER_OVERFLOW              1    

/*
 * TYPEDEFS
 */

typedef uint8 hciStatus_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connectionHandle;
  uint8  role;
  uint8  peerAddrType;
  uint8  peerAddr[B_ADDR_LEN];
  uint16 connInterval;
  uint16 connLatency;
  uint16 connTimeout;
  uint8  clockAccuracy;
} hciEvt_BLEConnComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connectionHandle;
  uint8  role;
  uint8  peerAddrType;
  uint8  peerAddr[B_ADDR_LEN];
  uint16 connInterval;
  uint16 connLatency;
  uint16 connTimeout;
  uint8  clockAccuracy;
  // Note: These fields normally follow peerAddr. Put here for Host optimization.
  uint8  localRPA[B_ADDR_LEN];
  uint8  peerRPA[B_ADDR_LEN];
} hciEvt_BLEEnhConnComplete_t;

typedef union _hciEvt_BLEConnComplete_u_
{
  hciEvt_BLEConnComplete_t      legEvt;
  hciEvt_BLEEnhConnComplete_t   enhEvt;
} hciEvt_BLEConnComplete_u;

typedef struct
{
  uint8  eventType;                       // advertisement or scan response event type
  uint8  addrType;                        // public or random address type
  uint8  addr[B_ADDR_LEN];                // device address
  uint8  dataLen;                         // length of report data
  uint8  rspData[B_MAX_ADV_LEN];          // report data given by dataLen
  int8   rssi;                            // report RSSI
} hciEvt_DevInfo_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  numDevices;
  hciEvt_DevInfo_t* devInfo;              // pointer to the array of devInfo
} hciEvt_BLEAdvPktReport_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  eventType;                       // scan request event type
  uint8  peerAddrType;                    // public or random address type
  uint8  peerAddr[B_ADDR_LEN];            // peer device address
  uint8  bleChan;                         // BLE channel
  int8   rssi;                            // report RSSI
} hciEvt_BLEScanReqReport_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connectionHandle;
  uint16 connInterval;
  uint16 connLatency;
  uint16 connTimeout;
} hciEvt_BLEConnUpdateComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connectionHandle;
  uint8  features[8];
} hciEvt_BLEReadRemoteFeatureComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint16 connHandle;
  uint8  reason;
  uint8  encEnable;
} hciEvt_EncryptChange_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint16 connHandle;
  uint8  random[B_RANDOM_NUM_SIZE];
  uint16 encryptedDiversifier;
} hciEvt_BLELTKReq_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  numHandles;
  uint16 *pConnectionHandle;              // pointer to the connection handle array
  uint16 *pNumCompletedPackets;           // pointer to the number of completed packets array
} hciEvt_NumCompletedPkt_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  numHciCmdPkt;                    // number of HCI Command Packet
  uint16 cmdOpcode;
  uint8  *pReturnParam;                   // pointer to the return parameter
} hciEvt_CmdComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8   length;                         // length of parametric data, in bytes
  uint16  cmdOpcode;
  uint8  *pEventParam;
} hciEvt_VSCmdComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  cmdStatus;
  uint8  numHciCmdPkt;
  uint16 cmdOpcode;
} hciEvt_CommandStatus_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8 hardwareCode;
} hciEvt_HardwareError_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  status;
  uint16 connHandle;                      // connection handle
  uint8  reason;
} hciEvt_DisconnComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8 linkType;                         // synchronous or asynchronous buffer overflow
} hciEvt_BufferOverflow_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint16 connHandle;
} hciEvt_AptoExpired_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connHandle;
  uint16 Interval_Min;
  uint16 Interval_Max;
  uint16 Latency;
  uint16 Timeout;
} hciEvt_BLERemoteConnParamReq_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint8  status;
  uint16 connHandle;
  uint8  txPhy;
  uint8  rxPhy;
} hciEvt_BLEPhyUpdateComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8  BLEEventCode;
  uint16 connHandle;
  uint16 maxTxOctets;
  uint16 maxTxTime;
  uint16 maxRxOctets;
  uint16 maxRxTime;
} hciEvt_BLEDataLengthChange_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8 BLEEventCode;
  uint8 status;
  uint8 p256Key[LL_SC_P256_KEY_LEN];
} hciEvt_BLEReadP256PublicKeyComplete_t;

typedef struct
{
  osal_event_hdr_t  hdr;
  uint8 BLEEventCode;
  uint8 status;
  uint8 dhKey[LL_SC_DHKEY_LEN];
} hciEvt_BLEGenDHKeyComplete_t;

typedef struct
{
  uint8  status;
  uint16 dataPktLen;
  uint8  numDataPkts;
} hciRetParam_LeReadBufSize_t;

typedef struct
{
  osal_event_hdr_t hdr;
  uint8            *pData;
} hciPacket_t;

typedef struct
{
  osal_event_hdr_t hdr;
  uint8  pktType;
  uint16 connHandle;
  uint8  pbFlag;
  uint16 pktLen;
  uint8  *pData;
} hciDataPacket_t;


// OSAL HCI_DATA_EVENT message format. This message is used to forward incoming
// data messages up to an application
typedef struct
{
  osal_event_hdr_t hdr;                   // OSAL event header
  uint16 connHandle;                      // connection handle
  uint8  pbFlag;                          // data packet boundary flag
  uint16 len;                             // length of data packet
  uint8  *pData;                          // data packet given by len
} hciDataEvent_t;


#if defined( CC26XX ) || defined( CC13XX )
PACKED_TYPEDEF_STRUCT
#else // CC254x
typedef struct
#endif // CC26XX/CC13XX
{
  uint8 connId;                           // device connection handle
  uint8 role;                             // device connection role
  uint8 addr[LL_DEVICE_ADDR_LEN];         // peer device address
  uint8 addrType;                         // peer device address type
} hciConnInfo_t;

#if defined( CC26XX ) || defined( CC13XX )
PACKED_TYPEDEF_STRUCT
#else // CC254x
typedef struct
#endif // CC26XX/CC13XX
{
  uint16 numPkts;                         // total number of rx packets
  uint16 numCrcErr;                       // number rx packets with CRC error
  uint16 numEvents;                       // number of connection events
  uint16 numMMissedEvents;                // number missed connection events
} hciPER_t;

/*
 * LOCAL VARIABLES
 */

/*
 * GLOBAL VARIABLES
 */


extern void *HCI_bm_alloc( uint16 size );



extern uint8 HCI_ValidConnTimeParams( uint16 connIntervalMin,
                                      uint16 connIntervalMax,
                                      uint16 connLatency,
                                      uint16 connTimeout );

extern void HCI_TestAppTaskRegister( uint8 taskID );

extern void HCI_GAPTaskRegister( uint8 taskID );

extern void HCI_L2CAPTaskRegister( uint8 taskID );

extern void HCI_SMPTaskRegister( uint8 taskID );

extern void HCI_ExtTaskRegister( uint8 taskID );

extern hciStatus_t HCI_SendDataPkt( uint16 connHandle,
                                    uint8  pbFlag,
                                    uint16 pktLen,
                                    uint8  *pData );

extern hciStatus_t HCI_DisconnectCmd( uint16 connHandle,
                                      uint8  reason );


extern hciStatus_t HCI_ReadRemoteVersionInfoCmd( uint16 connHandle );


extern hciStatus_t HCI_SetEventMaskCmd( uint8 *pMask );


extern hciStatus_t HCI_SetEventMaskPage2Cmd( uint8 *pMask );


extern hciStatus_t HCI_ResetCmd( void );

extern hciStatus_t HCI_ReadTransmitPowerLevelCmd( uint16 connHandle,
                                                  uint8  txPwrType );


extern hciStatus_t HCI_SetControllerToHostFlowCtrlCmd( uint8 flowControlEnable );



extern hciStatus_t HCI_HostBufferSizeCmd( uint16 hostAclPktLen,
                                          uint8  hostSyncPktLen,
                                          uint16 hostTotalNumAclPkts,
                                          uint16 hostTotalNumSyncPkts );


extern hciStatus_t HCI_HostNumCompletedPktCmd( uint8   numHandles,
                                               uint16 *connHandles,
                                               uint16 *numCompletedPkts );


extern hciStatus_t HCI_ReadAuthPayloadTimeoutCmd( uint16  connHandle,
                                                  uint16 *aptoValue );


extern hciStatus_t HCI_WriteAuthPayloadTimeoutCmd( uint16 connHandle,
                                                   uint16 aptoValue );


extern hciStatus_t HCI_ReadLocalVersionInfoCmd( void );


extern hciStatus_t HCI_ReadLocalSupportedCommandsCmd( void );


extern hciStatus_t HCI_ReadLocalSupportedFeaturesCmd( void );


extern hciStatus_t HCI_ReadBDADDRCmd( void );


extern hciStatus_t HCI_ReadRssiCmd( uint16 connHandle );

extern hciStatus_t HCI_LE_SetEventMaskCmd( uint8 *pEventMask );


extern hciStatus_t HCI_LE_ReadBufSizeCmd( void );


extern hciStatus_t HCI_LE_ReadLocalSupportedFeaturesCmd( void );


extern hciStatus_t HCI_LE_SetRandomAddressCmd( uint8 *pRandAddr );


extern hciStatus_t HCI_LE_SetAdvParamCmd( uint16 advIntervalMin,
                                          uint16 advIntervalMax,
                                          uint8  advType,
                                          uint8  ownAddrType,
                                          uint8  directAddrType,
                                          uint8  *directAddr,
                                          uint8  advChannelMap,
                                          uint8  advFilterPolicy );


extern hciStatus_t HCI_LE_SetAdvDataCmd( uint8 dataLen,
                                         uint8 *pData );


extern hciStatus_t HCI_LE_SetScanRspDataCmd( uint8 dataLen,
                                             uint8 *pData );


extern hciStatus_t HCI_LE_SetAdvEnableCmd( uint8 advEnable );


extern hciStatus_t HCI_LE_ReadAdvChanTxPowerCmd( void );


extern hciStatus_t HCI_LE_SetScanParamCmd( uint8  scanType,
                                           uint16 scanInterval,
                                           uint16 scanWindow,
                                           uint8  ownAddrType,
                                           uint8  filterPolicy );


extern hciStatus_t HCI_LE_SetScanEnableCmd( uint8 scanEnable,
                                            uint8 filterDuplicates );


extern 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 );


extern hciStatus_t HCI_LE_CreateConnCancelCmd( void );


extern hciStatus_t HCI_LE_ReadWhiteListSizeCmd( void );


extern hciStatus_t HCI_LE_ClearWhiteListCmd( void );


extern hciStatus_t HCI_LE_AddWhiteListCmd( uint8 addrType,
                                           uint8 *devAddr );


extern hciStatus_t HCI_LE_RemoveWhiteListCmd( uint8 addrType,
                                              uint8 *devAddr );


extern hciStatus_t HCI_LE_ConnUpdateCmd( uint16 connHandle,
                                         uint16 connIntervalMin,
                                         uint16 connIntervalMax,
                                         uint16 connLatency,
                                         uint16 connTimeout,
                                         uint16 minLen,
                                         uint16 maxLen );


extern hciStatus_t HCI_LE_SetHostChanClassificationCmd( uint8 *chanMap );


extern hciStatus_t HCI_LE_ReadChannelMapCmd( uint16 connHandle );


extern hciStatus_t HCI_LE_ReadRemoteUsedFeaturesCmd( uint16 connHandle );


extern hciStatus_t HCI_LE_EncryptCmd( uint8 *key,
                                      uint8 *plainText );


extern hciStatus_t HCI_LE_RandCmd( void );


extern hciStatus_t HCI_LE_StartEncyptCmd( uint16 connHandle,
                                          uint8  *random,
                                          uint8  *encDiv,
                                          uint8  *ltk );


extern hciStatus_t HCI_LE_LtkReqReplyCmd( uint16 connHandle,
                                          uint8  *ltk );


extern hciStatus_t HCI_LE_LtkReqNegReplyCmd( uint16 connHandle );


extern hciStatus_t HCI_LE_ReadSupportedStatesCmd( void );


extern hciStatus_t HCI_LE_ReceiverTestCmd( uint8 rxChan );


extern hciStatus_t HCI_LE_TransmitterTestCmd( uint8 txChan,
                                              uint8 dataLen,
                                              uint8 pktPayload );


extern hciStatus_t HCI_LE_TestEndCmd( void );

// V4.1

extern hciStatus_t HCI_LE_RemoteConnParamReqReplyCmd( uint16 connHandle,
                                                      uint16 connIntervalMin,
                                                      uint16 connIntervalMax,
                                                      uint16 connLatency,
                                                      uint16 connTimeout,
                                                      uint16 minLen,
                                                      uint16 maxLen );


extern hciStatus_t HCI_LE_RemoteConnParamReqNegReplyCmd( uint16 connHandle,
                                                         uint8  reason );


// V4.2 - Extended Data Length

extern hciStatus_t HCI_LE_SetDataLenCmd( uint16 connHandle,
                                         uint16 txOctets,
                                         uint16 txTime );


extern hciStatus_t HCI_LE_ReadSuggestedDefaultDataLenCmd( void );


extern hciStatus_t HCI_LE_WriteSuggestedDefaultDataLenCmd( uint16 txOctets,
                                                           uint16 txTime );


extern hciStatus_t HCI_LE_ReadMaxDataLenCmd( void );


// V4.2 - Privacy 1.2

extern hciStatus_t HCI_LE_AddDeviceToResolvingListCmd( uint8  peerIdAddrType,
                                                       uint8 *peerIdAddr,
                                                       uint8 *peerIRK,
                                                       uint8 *localIRK );


extern hciStatus_t HCI_LE_RemoveDeviceFromResolvingListCmd( uint8  peerIdAddrType,
                                                            uint8 *peerIdAddr );


extern hciStatus_t HCI_LE_ClearResolvingListCmd( void );


extern hciStatus_t HCI_LE_ReadResolvingListSizeCmd( void );


extern hciStatus_t HCI_LE_ReadPeerResolvableAddressCmd( uint8  peerIdAddrType,
                                                        uint8 *peerIdAddr );


extern hciStatus_t HCI_LE_ReadLocalResolvableAddressCmd( uint8  localIdAddrType,
                                                         uint8 *localIdAddr );


extern hciStatus_t HCI_LE_SetAddressResolutionEnableCmd( uint8 addrResolutionEnable );


extern hciStatus_t HCI_LE_SetResolvablePrivateAddressTimeoutCmd( uint16 rpaTimeout );


// V4.2 - Secure Connections

extern hciStatus_t HCI_LE_ReadLocalP256PublicKeyCmd( void );


extern hciStatus_t HCI_LE_GenerateDHKeyCmd( uint8 *publicKey );


// V5.0 - 2Mbps PHY


extern hciStatus_t HCI_LE_ReadPhyCmd( uint16 connHandle );


extern hciStatus_t HCI_LE_SetDefaultPhyCmd( uint8 allPhys,
                                            uint8 txPhy,
                                            uint8 rxPhy );


extern hciStatus_t HCI_LE_SetPhyCmd( uint16 connHandle,
                                     uint8  allPhys,
                                     uint8  txPhy,
                                     uint8  rxPhy );


extern hciStatus_t HCI_LE_EnhancedRxTestCmd( uint8 rxChan,
                                             uint8 rxPhy,
                                             uint8 modIndex );


extern hciStatus_t HCI_LE_EnhancedTxTestCmd( uint8 txChan,
                                             uint8 payloadLen,
                                             uint8 payloadType,
                                             uint8 txPhy );


/*
** HCI Vendor Specific Commands: Link Layer Extensions
*/

extern hciStatus_t HCI_EXT_SetRxGainCmd( uint8 rxGain );


extern hciStatus_t HCI_EXT_SetTxPowerCmd( uint8 txPower );


extern hciStatus_t HCI_EXT_OnePktPerEvtCmd( uint8 control );



extern hciStatus_t HCI_EXT_ClkDivOnHaltCmd( uint8 control );


extern hciStatus_t HCI_EXT_DeclareNvUsageCmd( uint8 mode );


extern hciStatus_t HCI_EXT_DecryptCmd( uint8 *key,
                                       uint8 *encText );


extern hciStatus_t HCI_EXT_SetLocalSupportedFeaturesCmd( uint8 *localFeatures );


extern hciStatus_t HCI_EXT_SetFastTxResponseTimeCmd( uint8 control );


extern hciStatus_t HCI_EXT_SetSlaveLatencyOverrideCmd( uint8 control );


extern hciStatus_t HCI_EXT_ModemTestTxCmd( uint8 cwMode,
                                           uint8 txChan );


extern hciStatus_t HCI_EXT_ModemHopTestTxCmd( void );


extern hciStatus_t HCI_EXT_ModemTestRxCmd( uint8 rxChan );


extern hciStatus_t HCI_EXT_EndModemTestCmd( void );


extern hciStatus_t HCI_EXT_SetBDADDRCmd( uint8 *bdAddr );


extern hciStatus_t HCI_EXT_SetSCACmd( uint16 scaInPPM );


extern hciStatus_t HCI_EXT_EnablePTMCmd( void );


extern hciStatus_t HCI_EXT_SetFreqTuneCmd( uint8 step );


extern hciStatus_t HCI_EXT_SaveFreqTuneCmd( void );


extern hciStatus_t HCI_EXT_SetMaxDtmTxPowerCmd( uint8 txPower );


extern hciStatus_t HCI_EXT_MapPmIoPortCmd( uint8 ioPort, uint8 ioPin );


extern hciStatus_t HCI_EXT_DisconnectImmedCmd( uint16 connHandle );


extern hciStatus_t HCI_EXT_PacketErrorRateCmd( uint16 connHandle, uint8 command );


extern hciStatus_t HCI_EXT_PERbyChanCmd( uint16 connHandle, perByChan_t *perByChan );



extern hciStatus_t HCI_EXT_ExtendRfRangeCmd( void );

extern hciStatus_t HCI_EXT_HaltDuringRfCmd( uint8 mode );


extern hciStatus_t HCI_EXT_AdvEventNoticeCmd( uint8 taskID, uint16 taskEvent );


extern hciStatus_t HCI_EXT_ScanEventNoticeCmd( uint8 taskID, uint16 taskEvent );


extern hciStatus_t HCI_EXT_ConnEventNoticeCmd( uint16 connHandle, uint8 taskID, uint16 taskEvent );


extern hciStatus_t HCI_EXT_BuildRevisionCmd( uint8 mode, uint16 userRevNum );


extern hciStatus_t HCI_EXT_DelaySleepCmd( uint16 delay );


extern hciStatus_t HCI_EXT_ResetSystemCmd( uint8 mode );

// @cond NODOC

extern hciStatus_t HCI_EXT_LLTestModeCmd( uint8 testCase );


extern hciStatus_t HCI_EXT_OverlappedProcessingCmd( uint8 mode );


extern hciStatus_t HCI_EXT_NumComplPktsLimitCmd( uint8 limit,
                                                 uint8 flushOnEvt );


extern hciStatus_t HCI_EXT_GetConnInfoCmd( uint8         *numAllocConns,
                                           uint8         *numActiveConns,
                                           hciConnInfo_t *activeConnInfo );

extern hciStatus_t HCI_EXT_SetMaxDataLenCmd( uint16 txOctets,
                                             uint16 txTime,
                                             uint16 rxOctets,
                                             uint16 rxTime );

extern hciStatus_t HCI_EXT_ScanReqRptCmd( uint8 mode );


#ifdef __cplusplus
}
#endif

#endif /* HCI_H */