Home | History | Annotate | Download | only in dm
      1 /******************************************************************************
      2  *
      3  *  Copyright (C) 2003-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 /******************************************************************************
     20  *
     21  *  This is the main implementation file for the BTA device manager.
     22  *
     23  ******************************************************************************/
     24 
     25 #include "bta_api.h"
     26 #include "bta_dm_int.h"
     27 #include "bta_sys.h"
     28 
     29 /*****************************************************************************
     30  * Constants and types
     31  ****************************************************************************/
     32 
     33 tBTA_DM_CB bta_dm_cb;
     34 tBTA_DM_SEARCH_CB bta_dm_search_cb;
     35 tBTA_DM_DI_CB bta_dm_di_cb;
     36 
     37 #define BTA_DM_NUM_ACTIONS (BTA_DM_MAX_EVT & 0x00ff)
     38 
     39 /* type for action functions */
     40 typedef void (*tBTA_DM_ACTION)(tBTA_DM_MSG* p_data);
     41 
     42 /* action function list */
     43 const tBTA_DM_ACTION bta_dm_action[] = {
     44 
     45     /* device manager local device API events */
     46     bta_dm_enable,         /* 0  BTA_DM_API_ENABLE_EVT */
     47     bta_dm_disable,        /* 1  BTA_DM_API_DISABLE_EVT */
     48     bta_dm_set_dev_name,   /* 2  BTA_DM_API_SET_NAME_EVT */
     49     bta_dm_set_visibility, /* 3  BTA_DM_API_SET_VISIBILITY_EVT */
     50     bta_dm_acl_change,     /* 8  BTA_DM_ACL_CHANGE_EVT */
     51     bta_dm_add_device,     /* 9  BTA_DM_API_ADD_DEVICE_EVT */
     52     bta_dm_close_acl,      /* 10  BTA_DM_API_ADD_DEVICE_EVT */
     53 
     54     /* security API events */
     55     bta_dm_bond,        /* 11  BTA_DM_API_BOND_EVT */
     56     bta_dm_bond_cancel, /* 12  BTA_DM_API_BOND_CANCEL_EVT */
     57     bta_dm_pin_reply,   /* 13 BTA_DM_API_PIN_REPLY_EVT */
     58 
     59     /* power manger events */
     60     bta_dm_pm_btm_status, /* 16 BTA_DM_PM_BTM_STATUS_EVT */
     61     bta_dm_pm_timer,      /* 17 BTA_DM_PM_TIMER_EVT*/
     62 
     63     /* simple pairing events */
     64     bta_dm_confirm, /* 18 BTA_DM_API_CONFIRM_EVT */
     65 
     66     bta_dm_set_encryption, /* BTA_DM_API_SET_ENCRYPTION_EVT */
     67 
     68     /* out of band pairing events */
     69     bta_dm_loc_oob,        /* 20 BTA_DM_API_LOC_OOB_EVT */
     70     bta_dm_ci_io_req_act,  /* 21 BTA_DM_CI_IO_REQ_EVT */
     71     bta_dm_ci_rmt_oob_act, /* 22 BTA_DM_CI_RMT_OOB_EVT */
     72 
     73     bta_dm_add_blekey,        /*  BTA_DM_API_ADD_BLEKEY_EVT           */
     74     bta_dm_add_ble_device,    /*  BTA_DM_API_ADD_BLEDEVICE_EVT        */
     75     bta_dm_ble_passkey_reply, /*  BTA_DM_API_BLE_PASSKEY_REPLY_EVT    */
     76     bta_dm_ble_confirm_reply, /*  BTA_DM_API_BLE_CONFIRM_REPLY_EVT    */
     77     bta_dm_security_grant, bta_dm_ble_set_bg_conn_type,
     78     bta_dm_ble_set_conn_params,      /* BTA_DM_API_BLE_CONN_PARAM_EVT */
     79     bta_dm_ble_set_conn_scan_params, /* BTA_DM_API_BLE_CONN_SCAN_PARAM_EVT */
     80     bta_dm_ble_observe,
     81     bta_dm_ble_update_conn_params, /* BTA_DM_API_UPDATE_CONN_PARAM_EVT */
     82 #if (BLE_PRIVACY_SPT == TRUE)
     83     bta_dm_ble_config_local_privacy, /* BTA_DM_API_LOCAL_PRIVACY_EVT */
     84 #endif
     85     bta_dm_ble_set_data_length, /* BTA_DM_API_SET_DATA_LENGTH_EVT */
     86     bta_dm_ble_get_energy_info,    /* BTA_DM_API_BLE_ENERGY_INFO_EVT */
     87 
     88     bta_dm_enable_test_mode,  /*  BTA_DM_API_ENABLE_TEST_MODE_EVT     */
     89     bta_dm_disable_test_mode, /*  BTA_DM_API_DISABLE_TEST_MODE_EVT    */
     90     bta_dm_execute_callback,  /*  BTA_DM_API_EXECUTE_CBACK_EVT        */
     91 
     92     bta_dm_remove_all_acl, /* BTA_DM_API_REMOVE_ALL_ACL_EVT */
     93     bta_dm_remove_device,  /* BTA_DM_API_REMOVE_DEVICE_EVT */
     94 };
     95 
     96 /* state machine action enumeration list */
     97 enum {
     98   BTA_DM_API_SEARCH,                 /* 0 bta_dm_search_start */
     99   BTA_DM_API_SEARCH_CANCEL,          /* 1 bta_dm_search_cancel */
    100   BTA_DM_API_DISCOVER,               /* 2 bta_dm_discover */
    101   BTA_DM_INQUIRY_CMPL,               /* 3 bta_dm_inq_cmpl */
    102   BTA_DM_REMT_NAME,                  /* 4 bta_dm_rmt_name */
    103   BTA_DM_SDP_RESULT,                 /* 5 bta_dm_sdp_result */
    104   BTA_DM_SEARCH_CMPL,                /* 6 bta_dm_search_cmpl*/
    105   BTA_DM_FREE_SDP_DB,                /* 7 bta_dm_free_sdp_db */
    106   BTA_DM_DISC_RESULT,                /* 8 bta_dm_disc_result */
    107   BTA_DM_SEARCH_RESULT,              /* 9 bta_dm_search_result */
    108   BTA_DM_QUEUE_SEARCH,               /* 10 bta_dm_queue_search */
    109   BTA_DM_QUEUE_DISC,                 /* 11 bta_dm_queue_disc */
    110   BTA_DM_SEARCH_CLEAR_QUEUE,         /* 12 bta_dm_search_clear_queue */
    111   BTA_DM_SEARCH_CANCEL_CMPL,         /* 13 bta_dm_search_cancel_cmpl */
    112   BTA_DM_SEARCH_CANCEL_NOTIFY,       /* 14 bta_dm_search_cancel_notify */
    113   BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL, /* 15 bta_dm_search_cancel_transac_cmpl */
    114   BTA_DM_DISC_RMT_NAME,              /* 16 bta_dm_disc_rmt_name */
    115   BTA_DM_API_DI_DISCOVER,            /* 17 bta_dm_di_disc */
    116   BTA_DM_CLOSE_GATT_CONN,            /* 18 bta_dm_close_gatt_conn */
    117   BTA_DM_SEARCH_NUM_ACTIONS          /* 19 */
    118 };
    119 
    120 /* action function list */
    121 const tBTA_DM_ACTION bta_dm_search_action[] = {
    122 
    123     bta_dm_search_start,               /* 0 BTA_DM_API_SEARCH */
    124     bta_dm_search_cancel,              /* 1 BTA_DM_API_SEARCH_CANCEL */
    125     bta_dm_discover,                   /* 2 BTA_DM_API_DISCOVER */
    126     bta_dm_inq_cmpl,                   /* 3 BTA_DM_INQUIRY_CMPL */
    127     bta_dm_rmt_name,                   /* 4 BTA_DM_REMT_NAME */
    128     bta_dm_sdp_result,                 /* 5 BTA_DM_SDP_RESULT */
    129     bta_dm_search_cmpl,                /* 6 BTA_DM_SEARCH_CMPL */
    130     bta_dm_free_sdp_db,                /* 7 BTA_DM_FREE_SDP_DB */
    131     bta_dm_disc_result,                /* 8 BTA_DM_DISC_RESULT */
    132     bta_dm_search_result,              /* 9 BTA_DM_SEARCH_RESULT */
    133     bta_dm_queue_search,               /* 10 BTA_DM_QUEUE_SEARCH */
    134     bta_dm_queue_disc,                 /* 11 BTA_DM_QUEUE_DISC */
    135     bta_dm_search_clear_queue,         /* 12 BTA_DM_SEARCH_CLEAR_QUEUE */
    136     bta_dm_search_cancel_cmpl,         /* 13 BTA_DM_SEARCH_CANCEL_CMPL */
    137     bta_dm_search_cancel_notify,       /* 14 BTA_DM_SEARCH_CANCEL_NOTIFY */
    138     bta_dm_search_cancel_transac_cmpl, /* 15 BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL
    139                                           */
    140     bta_dm_disc_rmt_name,              /* 16 BTA_DM_DISC_RMT_NAME */
    141     bta_dm_di_disc,                    /* 17 BTA_DM_API_DI_DISCOVER */
    142     bta_dm_close_gatt_conn};
    143 
    144 #define BTA_DM_SEARCH_IGNORE BTA_DM_SEARCH_NUM_ACTIONS
    145 /* state table information */
    146 #define BTA_DM_SEARCH_ACTIONS 2    /* number of actions */
    147 #define BTA_DM_SEARCH_NEXT_STATE 2 /* position of next state */
    148 #define BTA_DM_SEARCH_NUM_COLS 3   /* number of columns in state tables */
    149 
    150 /* state table for listen state */
    151 const uint8_t bta_dm_search_idle_st_table[][BTA_DM_SEARCH_NUM_COLS] = {
    152 
    153     /* Event                        Action 1
    154        Action 2                    Next State */
    155     /* API_SEARCH */ {BTA_DM_API_SEARCH, BTA_DM_SEARCH_IGNORE,
    156                       BTA_DM_SEARCH_ACTIVE},
    157     /* API_SEARCH_CANCEL */ {BTA_DM_SEARCH_CANCEL_NOTIFY, BTA_DM_SEARCH_IGNORE,
    158                              BTA_DM_SEARCH_IDLE},
    159     /* API_SEARCH_DISC */ {BTA_DM_API_DISCOVER, BTA_DM_SEARCH_IGNORE,
    160                            BTA_DM_DISCOVER_ACTIVE},
    161     /* INQUIRY_CMPL */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    162                         BTA_DM_SEARCH_IDLE},
    163     /* REMT_NAME_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    164                          BTA_DM_SEARCH_IDLE},
    165     /* SDP_RESULT_EVT */ {BTA_DM_FREE_SDP_DB, BTA_DM_SEARCH_IGNORE,
    166                           BTA_DM_SEARCH_IDLE},
    167     /* SEARCH_CMPL_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    168                            BTA_DM_SEARCH_IDLE},
    169     /* DISCV_RES_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    170                          BTA_DM_SEARCH_IDLE},
    171     /* API_DI_DISCOVER_EVT */ {BTA_DM_API_DI_DISCOVER, BTA_DM_SEARCH_IGNORE,
    172                                BTA_DM_SEARCH_ACTIVE},
    173     /* DISC_CLOSE_TOUT_EVT */
    174     {BTA_DM_CLOSE_GATT_CONN, BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IDLE}};
    175 const uint8_t bta_dm_search_search_active_st_table[][BTA_DM_SEARCH_NUM_COLS] = {
    176 
    177     /* Event                        Action 1
    178        Action 2                    Next State */
    179     /* API_SEARCH */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    180                       BTA_DM_SEARCH_ACTIVE},
    181     /* API_SEARCH_CANCEL */ {BTA_DM_API_SEARCH_CANCEL, BTA_DM_SEARCH_IGNORE,
    182                              BTA_DM_SEARCH_CANCELLING},
    183     /* API_SEARCH_DISC */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    184                            BTA_DM_SEARCH_ACTIVE},
    185     /* INQUIRY_CMPL */ {BTA_DM_INQUIRY_CMPL, BTA_DM_SEARCH_IGNORE,
    186                         BTA_DM_SEARCH_ACTIVE},
    187     /* REMT_NAME_EVT */ {BTA_DM_REMT_NAME, BTA_DM_SEARCH_IGNORE,
    188                          BTA_DM_SEARCH_ACTIVE},
    189     /* SDP_RESULT_EVT */ {BTA_DM_SDP_RESULT, BTA_DM_SEARCH_IGNORE,
    190                           BTA_DM_SEARCH_ACTIVE},
    191     /* SEARCH_CMPL_EVT */ {BTA_DM_SEARCH_CMPL, BTA_DM_SEARCH_IGNORE,
    192                            BTA_DM_SEARCH_IDLE},
    193     /* DISCV_RES_EVT */ {BTA_DM_SEARCH_RESULT, BTA_DM_SEARCH_IGNORE,
    194                          BTA_DM_SEARCH_ACTIVE},
    195     /* API_DI_DISCOVER_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    196                                BTA_DM_SEARCH_ACTIVE},
    197     /* DISC_CLOSE_TOUT_EVT */
    198     {BTA_DM_CLOSE_GATT_CONN, BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_ACTIVE}
    199 
    200 };
    201 
    202 const uint8_t
    203     bta_dm_search_search_cancelling_st_table[][BTA_DM_SEARCH_NUM_COLS] = {
    204 
    205         /* Event                        Action 1
    206            Action 2                    Next State */
    207         /* API_SEARCH */ {BTA_DM_QUEUE_SEARCH, BTA_DM_SEARCH_IGNORE,
    208                           BTA_DM_SEARCH_CANCELLING},
    209         /* API_SEARCH_CANCEL */ {BTA_DM_SEARCH_CLEAR_QUEUE,
    210                                  BTA_DM_SEARCH_CANCEL_NOTIFY,
    211                                  BTA_DM_SEARCH_CANCELLING},
    212         /* API_SEARCH_DISC */ {BTA_DM_QUEUE_DISC, BTA_DM_SEARCH_IGNORE,
    213                                BTA_DM_SEARCH_CANCELLING},
    214         /* INQUIRY_CMPL */ {BTA_DM_SEARCH_CANCEL_CMPL, BTA_DM_SEARCH_IGNORE,
    215                             BTA_DM_SEARCH_IDLE},
    216         /* REMT_NAME_EVT */ {BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL,
    217                              BTA_DM_SEARCH_CANCEL_CMPL, BTA_DM_SEARCH_IDLE},
    218         /* SDP_RESULT_EVT */ {BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL,
    219                               BTA_DM_SEARCH_CANCEL_CMPL, BTA_DM_SEARCH_IDLE},
    220         /* SEARCH_CMPL_EVT */ {BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL,
    221                                BTA_DM_SEARCH_CANCEL_CMPL, BTA_DM_SEARCH_IDLE},
    222         /* DISCV_RES_EVT */ {BTA_DM_SEARCH_CANCEL_TRANSAC_CMPL,
    223                              BTA_DM_SEARCH_CANCEL_CMPL, BTA_DM_SEARCH_IDLE},
    224         /* API_DI_DISCOVER_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    225                                    BTA_DM_SEARCH_CANCELLING},
    226         /* DISC_CLOSE_TOUT_EVT */
    227         {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_CANCELLING}};
    228 
    229 const uint8_t bta_dm_search_disc_active_st_table[][BTA_DM_SEARCH_NUM_COLS] = {
    230 
    231     /* Event                        Action 1
    232        Action 2                    Next State */
    233     /* API_SEARCH */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    234                       BTA_DM_DISCOVER_ACTIVE},
    235     /* API_SEARCH_CANCEL */ {BTA_DM_SEARCH_CANCEL_NOTIFY, BTA_DM_SEARCH_IGNORE,
    236                              BTA_DM_SEARCH_CANCELLING},
    237     /* API_SEARCH_DISC */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    238                            BTA_DM_DISCOVER_ACTIVE},
    239     /* INQUIRY_CMPL */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    240                         BTA_DM_DISCOVER_ACTIVE},
    241     /* REMT_NAME_EVT */ {BTA_DM_DISC_RMT_NAME, BTA_DM_SEARCH_IGNORE,
    242                          BTA_DM_DISCOVER_ACTIVE},
    243     /* SDP_RESULT_EVT */ {BTA_DM_SDP_RESULT, BTA_DM_SEARCH_IGNORE,
    244                           BTA_DM_DISCOVER_ACTIVE},
    245     /* SEARCH_CMPL_EVT */ {BTA_DM_SEARCH_CMPL, BTA_DM_SEARCH_IGNORE,
    246                            BTA_DM_SEARCH_IDLE},
    247     /* DISCV_RES_EVT */ {BTA_DM_DISC_RESULT, BTA_DM_SEARCH_IGNORE,
    248                          BTA_DM_DISCOVER_ACTIVE},
    249     /* API_DI_DISCOVER_EVT */ {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE,
    250                                BTA_DM_DISCOVER_ACTIVE},
    251     /* DISC_CLOSE_TOUT_EVT */
    252     {BTA_DM_SEARCH_IGNORE, BTA_DM_SEARCH_IGNORE, BTA_DM_DISCOVER_ACTIVE}};
    253 
    254 typedef const uint8_t (*tBTA_DM_ST_TBL)[BTA_DM_SEARCH_NUM_COLS];
    255 
    256 /* state table */
    257 const tBTA_DM_ST_TBL bta_dm_search_st_tbl[] = {
    258     bta_dm_search_idle_st_table, bta_dm_search_search_active_st_table,
    259     bta_dm_search_search_cancelling_st_table,
    260     bta_dm_search_disc_active_st_table};
    261 
    262 /*******************************************************************************
    263  *
    264  * Function         bta_dm_sm_disable
    265  *
    266  * Description     unregister BTA DM
    267  *
    268  *
    269  * Returns          void
    270  *
    271  ******************************************************************************/
    272 void bta_dm_sm_disable() { bta_sys_deregister(BTA_ID_DM); }
    273 
    274 /*******************************************************************************
    275  *
    276  * Function         bta_dm_sm_execute
    277  *
    278  * Description      State machine event handling function for DM
    279  *
    280  *
    281  * Returns          void
    282  *
    283  ******************************************************************************/
    284 bool bta_dm_sm_execute(BT_HDR* p_msg) {
    285   uint16_t event = p_msg->event & 0x00ff;
    286 
    287   APPL_TRACE_EVENT("bta_dm_sm_execute event:0x%x", event);
    288 
    289   /* execute action functions */
    290   if (event < BTA_DM_NUM_ACTIONS) {
    291     (*bta_dm_action[event])((tBTA_DM_MSG*)p_msg);
    292   }
    293 
    294   return true;
    295 }
    296 
    297 /*******************************************************************************
    298  *
    299  * Function         bta_dm_sm_search_disable
    300  *
    301  * Description     unregister BTA SEARCH DM
    302  *
    303  *
    304  * Returns          void
    305  *
    306  ******************************************************************************/
    307 void bta_dm_search_sm_disable() { bta_sys_deregister(BTA_ID_DM_SEARCH); }
    308 
    309 /*******************************************************************************
    310  *
    311  * Function         bta_dm_search_sm_execute
    312  *
    313  * Description      State machine event handling function for DM
    314  *
    315  *
    316  * Returns          void
    317  *
    318  ******************************************************************************/
    319 bool bta_dm_search_sm_execute(BT_HDR* p_msg) {
    320   tBTA_DM_ST_TBL state_table;
    321   uint8_t action;
    322   int i;
    323 
    324   APPL_TRACE_EVENT("bta_dm_search_sm_execute state:%d, event:0x%x",
    325                    bta_dm_search_cb.state, p_msg->event);
    326 
    327   /* look up the state table for the current state */
    328   state_table = bta_dm_search_st_tbl[bta_dm_search_cb.state];
    329 
    330   bta_dm_search_cb.state =
    331       state_table[p_msg->event & 0x00ff][BTA_DM_SEARCH_NEXT_STATE];
    332 
    333   /* execute action functions */
    334   for (i = 0; i < BTA_DM_SEARCH_ACTIONS; i++) {
    335     action = state_table[p_msg->event & 0x00ff][i];
    336     if (action != BTA_DM_SEARCH_IGNORE) {
    337       (*bta_dm_search_action[action])((tBTA_DM_MSG*)p_msg);
    338     } else {
    339       break;
    340     }
    341   }
    342   return true;
    343 }
    344