HCI

This section introduces the host controller interface API, including controller error code, command structures and command type codes used by the GAP module. More...

Overview

This section introduces the host controller interface API, including controller error code, command structures and command type codes used by the GAP module.

For more information, please refer to GAP.

Terms and Acronyms

Terms	Details
ACL	Asynchronous Connection-Oriented Logical Transport. For more information, please refer to Wikipedia.
HCI	Host Controller Interface. For more information, please refer to Wikipedia.
LE	Low Energy. For more information, please refer to Wikipedia.
LMP	Link Manager Protocol. For more information, please refer to Wikipedia.
MIC	Message Integrity Check. It is used to authenticate the data PDU.
PDU	Protocol Data Unit. For more information, please refer to Wikipedia.
QoS	Quality of Service. For more information, please refer to Wikipedia.
SCO	Synchronous Connection Oriented. For more information, please refer to Wikipedia.

How to use this module

1. Call the GAP APIs to set the HCI structures as parameters.
2. Call bt_app_event_callback() to parse the payload of the confirmation event with the HCI confirmation structure.

For more information on GAP APIs applied in the example implementation, please refer to GAP.

• Request example

  // Declare the HCI read RSSI structure and call bt_gap_le_read_rssi() to read the RSSI.
  bt_hci_cmd_read_rssi_t read_rssi = {
      .handle = 0x0200,
  };
  
  bt_gap_le_read_rssi(&read_rssi);

• Confirmation Example

  // Use the HCI read RSSI confirmation structure to parse the payload of the read RSSI confirmation event in the function bt_app_event_callback().
  bt_status_t bt_app_event_callback(bt_msg_type_t msg, bt_status_t status, void *buff)
  {
      switch(msg)
      {
          case BT_GAP_LE_READ_RSSI_CNF:
              const bt_hci_evt_cc_read_rssi_t *rssi = (bt_hci_evt_cc_read_rssi_t *)buff;
              BT_LOGI("APP", "connection handle=0x%04x", rssi->handle);
              if (rssi->rssi == 127) {
                  BT_LOGI("APP", "The RSSI cannot be read");
              } else {
                  if ((rssi->rssi>>7)>0){
                      BT_LOGI("APP", "rssi=%ddBm", ((~rssi->rssi)&0xFF)+0x01);
                  } else {
                      BT_LOGI("APP", "rssi=%ddBm", rssi->rssi);
                  }
              }
              break;
          // Add other cases if needed.
      }
  }

Modules
	Define
	Define HCI data types and values.
	Struct
	Define HCI commands and event data structures.