btif/include/btif_dm.h

   1 /******************************************************************************
   2  *
   3  *  Copyright (C) 2009-2012 Broadcom Corporation
   4  *
   5  *  Licensed under the Apache License, Version 2.0 (the "License");
   6  *  you may not use this file except in compliance with the License.
   7  *  You may obtain a copy of the License at:
   8  *
   9  *  http://www.apache.org/licenses/LICENSE-2.0
  10  *
  11  *  Unless required by applicable law or agreed to in writing, software
  12  *  distributed under the License is distributed on an "AS IS" BASIS,
  13  *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14  *  See the License for the specific language governing permissions and
  15  *  limitations under the License.
  16  *
  17  ******************************************************************************/
  18
  19 #ifndef BTIF_DM_H
  20 #define BTIF_DM_H
  21
  22 #include "bta_api.h"
  23 /************************************************************************************
  24 **  Functions
  25 ********************************************************************************/
  26
  27 /**
  28  * BTIF callback to switch context from bte to btif
  29  */
  30 void bte_dm_evt(tBTA_DM_SEC_EVT event, tBTA_DM_SEC *p_data);
  31
  32 /**
  33  * Notify BT disable being initiated. DM may chose to abort
  34  * pending commands, like pairing
  35  */
  36 void btif_dm_on_disable(void);
  37
  38 /**
  39  * Callout for handling io_capabilities request
  40  */
  41 void btif_dm_proc_io_req(BD_ADDR bd_addr, tBTA_IO_CAP *p_io_cap, tBTA_OOB_DATA *p_oob_data,
  42                       tBTA_AUTH_REQ *p_auth_req, BOOLEAN is_orig);
  43 /**
  44  * Callout for handling io_capabilities response
  45  */
  46 void btif_dm_proc_io_rsp(BD_ADDR bd_addr, tBTA_IO_CAP io_cap,
  47                       tBTA_OOB_DATA oob_data, tBTA_AUTH_REQ auth_req);
  48
  49 /**
  50  * Out-of-band functions
  51  */
  52 #if (BTM_OOB_INCLUDED == TRUE)
  53 void btif_dm_set_oob_for_io_req(tBTA_OOB_DATA  *p_oob_data);
  54 #ifdef BTIF_DM_OOB_TEST
  55 void btif_dm_load_local_oob(void);
  56 void btif_dm_proc_loc_oob(BOOLEAN valid, BT_OCTET16 c, BT_OCTET16 r);
  57 BOOLEAN btif_dm_proc_rmt_oob(BD_ADDR bd_addr,  BT_OCTET16 p_c, BT_OCTET16 p_r);
  58 #endif /* BTIF_DM_OOB_TEST */
  59 #endif /* BTM_OOB_INCLUDED */
  60 #if (BLE_INCLUDED == TRUE)
  61
  62 typedef struct
  63 {
  64     UINT8       ltk[BT_OCTET16_LEN];
  65     UINT8       rand[BT_OCTET8_LEN];
  66     UINT16      ediv;
  67     UINT8       sec_level;
  68     UINT8       key_size;
  69 }btif_dm_ble_penc_keys_t;
  70
  71 typedef struct
  72 {
  73     UINT32          counter;
  74     UINT8           csrk[BT_OCTET16_LEN];
  75     UINT8           sec_level;
  76 }btif_dm_ble_pcsrk_keys_t;
  77
  78 typedef struct
  79 {
  80     UINT16      div;
  81     UINT8       key_size;
  82     UINT8       sec_level;
  83 }btif_dm_ble_lenc_keys_t;
  84
  85 typedef struct
  86 {
  87     UINT32          counter;
  88     UINT16          div;
  89     UINT8           sec_level;
  90
  91 }btif_dm_ble_lcsrk_keys_t;
  92
  93 typedef struct
  94 {
  95     BT_OCTET16          irk;
  96     tBLE_ADDR_TYPE      addr_type;
  97     BD_ADDR             static_addr;
  98 }btif_dm_ble_pid_keys_t;
  99
 100 typedef struct
 101 {
 102     BOOLEAN                   is_penc_key_rcvd;
 103     btif_dm_ble_penc_keys_t   penc_key;       /* received peer encryption key */
 104     BOOLEAN                   is_pcsrk_key_rcvd;
 105     btif_dm_ble_pcsrk_keys_t  pcsrk_key;       /* received peer device SRK */
 106     BOOLEAN                   is_pid_key_rcvd;
 107     btif_dm_ble_pid_keys_t    pid_key;        /* peer device ID key */
 108     BOOLEAN                   is_lenc_key_rcvd;
 109     btif_dm_ble_lenc_keys_t   lenc_key;       /* local encryption reproduction keys LTK = = d1(ER,DIV,0)*/
 110     BOOLEAN                   is_lcsrk_key_rcvd;
 111     btif_dm_ble_lcsrk_keys_t  lcsrk_key;      /* local device CSRK = d1(ER,DIV,1)*/
 112     BOOLEAN                   is_lidk_key_rcvd;   /* local identity key received */
 113 } btif_dm_ble_cb_t;
 114
 115 #define BTIF_DM_LE_KEY_PENC        BTA_LE_KEY_PENC
 116 #define BTIF_DM_LE_KEY_PID         BTA_LE_KEY_PID
 117 #define BTIF_DM_LE_KEY_PCSRK       BTA_LE_KEY_PCSRK
 118 #define BTIF_DM_LE_KEY_LENC        BTA_LE_KEY_LENC
 119 #define BTIF_DM_LE_KEY_LID         BTA_LE_KEY_LID
 120 #define BTIF_DM_LE_KEY_LCSRK       BTA_LE_KEY_LCSRK
 121
 122 #define BTIF_DM_LE_LOCAL_KEY_IR       (1<<0)
 123 #define BTIF_DM_LE_LOCAL_KEY_IRK      (1<<1)
 124 #define BTIF_DM_LE_LOCAL_KEY_DHK      (1<<2)
 125 #define BTIF_DM_LE_LOCAL_KEY_ER       (1<<3)
 126
 127 void btif_dm_load_ble_local_keys(void);
 128 void btif_dm_get_ble_local_keys(tBTA_DM_BLE_LOCAL_KEY_MASK *p_key_mask, BT_OCTET16 er,
 129                                    tBTA_BLE_LOCAL_ID_KEYS *p_id_keys);
 130 void btif_dm_save_ble_bonding_keys(void);
 131 void btif_dm_remove_ble_bonding_keys(void);
 132 void btif_dm_ble_sec_req_evt(tBTA_DM_BLE_SEC_REQ *p_ble_req);
 133
 134 void btif_dm_update_ble_remote_properties( BD_ADDR bd_addr, BD_NAME bd_name,
 135                                            tBT_DEVICE_TYPE dev_type);
 136
 137 #endif /* BLE_INCLUDED */
 138
 139 #endif