main/bte_main.c

   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 /******************************************************************************
  20  *
  21  *  Filename:      bte_main.c
  22  *
  23  *  Description:   Contains BTE core stack initialization and shutdown code
  24  *
  25  ******************************************************************************/
  26
  27 #define LOG_TAG "bt_main"
  28
  29 #include <assert.h>
  30 #include <fcntl.h>
  31 #include <pthread.h>
  32 #include <signal.h>
  33 #include <stdlib.h>
  34 #include <time.h>
  35
  36 #include <hardware/bluetooth.h>
  37
  38 #include "bt_hci_bdroid.h"
  39 #include "bt_utils.h"
  40 #include "bta_api.h"
  41 #include "btcore/include/counter.h"
  42 #include "btcore/include/module.h"
  43 #include "bte.h"
  44 #include "btif_common.h"
  45 #include "btsnoop.h"
  46 #include "btu.h"
  47 #include "bt_common.h"
  48 #include "device/include/interop.h"
  49 #include "hci_layer.h"
  50 #include "osi/include/alarm.h"
  51 #include "osi/include/fixed_queue.h"
  52 #include "osi/include/future.h"
  53 #include "osi/include/hash_functions.h"
  54 #include "osi/include/hash_map.h"
  55 #include "osi/include/log.h"
  56 #include "osi/include/osi.h"
  57 #include "osi/include/thread.h"
  58 #include "stack_config.h"
  59
  60 /*******************************************************************************
  61 **  Constants & Macros
  62 *******************************************************************************/
  63
  64 /* Run-time configuration file for BLE*/
  65 #ifndef BTE_BLE_STACK_CONF_FILE
  66 // TODO(armansito): Find a better way than searching by a hardcoded path.
  67 #if defined(OS_GENERIC)
  68 #define BTE_BLE_STACK_CONF_FILE "ble_stack.conf"
  69 #else  // !defined(OS_GENERIC)
  70 #define BTE_BLE_STACK_CONF_FILE "/etc/bluetooth/ble_stack.conf"
  71 #endif  // defined(OS_GENERIC)
  72 #endif  // BT_BLE_STACK_CONF_FILE
  73
  74 /******************************************************************************
  75 **  Variables
  76 ******************************************************************************/
  77
  78 /*******************************************************************************
  79 **  Static variables
  80 *******************************************************************************/
  81 static const hci_t *hci;
  82
  83 /*******************************************************************************
  84 **  Static functions
  85 *******************************************************************************/
  86
  87 /*******************************************************************************
  88 **  Externs
  89 *******************************************************************************/
  90 fixed_queue_t *btu_hci_msg_queue;
  91
  92 /******************************************************************************
  93 **
  94 ** Function         bte_main_boot_entry
  95 **
  96 ** Description      BTE MAIN API - Entry point for BTE chip/stack initialization
  97 **
  98 ** Returns          None
  99 **
 100 ******************************************************************************/
 101 void bte_main_boot_entry(void)
 102 {
 103     module_init(get_module(COUNTER_MODULE));
 104     module_init(get_module(INTEROP_MODULE));
 105
 106     hci = hci_layer_get_interface();
 107     if (!hci)
 108       LOG_ERROR(LOG_TAG, "%s could not get hci layer interface.", __func__);
 109
 110     btu_hci_msg_queue = fixed_queue_new(SIZE_MAX);
 111     if (btu_hci_msg_queue == NULL) {
 112       LOG_ERROR(LOG_TAG, "%s unable to allocate hci message queue.", __func__);
 113       return;
 114     }
 115
 116     data_dispatcher_register_default(hci->event_dispatcher, btu_hci_msg_queue);
 117     hci->set_data_queue(btu_hci_msg_queue);
 118
 119     module_init(get_module(STACK_CONFIG_MODULE));
 120 }
 121
 122 /******************************************************************************
 123 **
 124 ** Function         bte_main_shutdown
 125 **
 126 ** Description      BTE MAIN API - Shutdown code for BTE chip/stack
 127 **
 128 ** Returns          None
 129 **
 130 ******************************************************************************/
 131 void bte_main_shutdown()
 132 {
 133     data_dispatcher_register_default(hci_layer_get_interface()->event_dispatcher, NULL);
 134     hci->set_data_queue(NULL);
 135     fixed_queue_free(btu_hci_msg_queue, NULL);
 136
 137     btu_hci_msg_queue = NULL;
 138
 139     module_clean_up(get_module(STACK_CONFIG_MODULE));
 140
 141     module_clean_up(get_module(INTEROP_MODULE));
 142     module_clean_up(get_module(COUNTER_MODULE));
 143 }
 144
 145 /******************************************************************************
 146 **
 147 ** Function         bte_main_enable
 148 **
 149 ** Description      BTE MAIN API - Creates all the BTE tasks. Should be called
 150 **                  part of the Bluetooth stack enable sequence
 151 **
 152 ** Returns          None
 153 **
 154 ******************************************************************************/
 155 void bte_main_enable()
 156 {
 157     APPL_TRACE_DEBUG("%s", __FUNCTION__);
 158
 159     module_start_up(get_module(BTSNOOP_MODULE));
 160     module_start_up(get_module(HCI_MODULE));
 161
 162     BTU_StartUp();
 163 }
 164
 165 /******************************************************************************
 166 **
 167 ** Function         bte_main_disable
 168 **
 169 ** Description      BTE MAIN API - Destroys all the BTE tasks. Should be called
 170 **                  part of the Bluetooth stack disable sequence
 171 **
 172 ** Returns          None
 173 **
 174 ******************************************************************************/
 175 void bte_main_disable(void)
 176 {
 177     APPL_TRACE_DEBUG("%s", __FUNCTION__);
 178
 179     module_shut_down(get_module(HCI_MODULE));
 180     module_shut_down(get_module(BTSNOOP_MODULE));
 181
 182     BTU_ShutDown();
 183 }
 184
 185 /******************************************************************************
 186 **
 187 ** Function         bte_main_postload_cfg
 188 **
 189 ** Description      BTE MAIN API - Stack postload configuration
 190 **
 191 ** Returns          None
 192 **
 193 ******************************************************************************/
 194 void bte_main_postload_cfg(void)
 195 {
 196     hci->do_postload();
 197 }
 198
 199 #if (defined(HCILP_INCLUDED) && HCILP_INCLUDED == TRUE)
 200 /******************************************************************************
 201 **
 202 ** Function         bte_main_enable_lpm
 203 **
 204 ** Description      BTE MAIN API - Enable/Disable low power mode operation
 205 **
 206 ** Returns          None
 207 **
 208 ******************************************************************************/
 209 void bte_main_enable_lpm(BOOLEAN enable)
 210 {
 211     hci->send_low_power_command(enable ? LPM_ENABLE : LPM_DISABLE);
 212 }
 213
 214 /******************************************************************************
 215 **
 216 ** Function         bte_main_lpm_allow_bt_device_sleep
 217 **
 218 ** Description      BTE MAIN API - Allow the BT controller to go to sleep
 219 **
 220 ** Returns          None
 221 **
 222 ******************************************************************************/
 223 void bte_main_lpm_allow_bt_device_sleep()
 224 {
 225     hci->send_low_power_command(LPM_WAKE_DEASSERT);
 226 }
 227
 228 /******************************************************************************
 229 **
 230 ** Function         bte_main_lpm_wake_bt_device
 231 **
 232 ** Description      BTE MAIN API - Wake BT controller up if it is in sleep mode
 233 **
 234 ** Returns          None
 235 **
 236 ******************************************************************************/
 237 void bte_main_lpm_wake_bt_device()
 238 {
 239     hci->send_low_power_command(LPM_WAKE_ASSERT);
 240 }
 241 #endif  // HCILP_INCLUDED
 242
 243 /******************************************************************************
 244 **
 245 ** Function         bte_main_hci_send
 246 **
 247 ** Description      BTE MAIN API - This function is called by the upper stack to
 248 **                  send an HCI message. The function displays a protocol trace
 249 **                  message (if enabled), and then calls the 'transmit' function
 250 **                  associated with the currently selected HCI transport
 251 **
 252 ** Returns          None
 253 **
 254 ******************************************************************************/
 255 void bte_main_hci_send (BT_HDR *p_msg, UINT16 event)
 256 {
 257     UINT16 sub_event = event & BT_SUB_EVT_MASK;  /* local controller ID */
 258
 259     p_msg->event = event;
 260
 261     counter_add("main.tx.packets", 1);
 262     counter_add("main.tx.bytes", p_msg->len);
 263
 264     if((sub_event == LOCAL_BR_EDR_CONTROLLER_ID) || \
 265        (sub_event == LOCAL_BLE_CONTROLLER_ID))
 266     {
 267         hci->transmit_downward(event, p_msg);
 268     }
 269     else
 270     {
 271         APPL_TRACE_ERROR("Invalid Controller ID. Discarding message.");
 272         osi_free(p_msg);
 273     }
 274 }