| /****************************************************************************** |
| * |
| * Copyright 2000-2012 Broadcom Corporation |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at: |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| * |
| ******************************************************************************/ |
| |
| /***************************************************************************** |
| * |
| * This file contains functions that manages ACL link modes. |
| * This includes operations such as active, hold, |
| * park and sniff modes. |
| * |
| * This module contains both internal and external (API) |
| * functions. External (API) functions are distinguishable |
| * by their names beginning with uppercase BTM. |
| * |
| *****************************************************************************/ |
| |
| #define LOG_TAG "bt_btm_pm" |
| |
| #include <stddef.h> |
| #include <stdio.h> |
| #include <stdlib.h> |
| #include <string.h> |
| |
| #include "bt_common.h" |
| #include "bt_types.h" |
| #include "bt_utils.h" |
| #include "btm_api.h" |
| #include "btm_int.h" |
| #include "btm_int_types.h" |
| #include "btu.h" |
| #include "device/include/interop.h" |
| #include "hcidefs.h" |
| #include "hcimsgs.h" |
| #include "l2c_int.h" |
| #include "osi/include/log.h" |
| #include "osi/include/osi.h" |
| |
| /*****************************************************************************/ |
| /* to handle different modes */ |
| /*****************************************************************************/ |
| #define BTM_PM_STORED_MASK 0x80 /* set this mask if the command is stored */ |
| #define BTM_PM_NUM_SET_MODES 3 /* only hold, sniff & park */ |
| |
| /* Usage: (ptr_features[ offset ] & mask )?true:false */ |
| /* offset to supported feature */ |
| const uint8_t btm_pm_mode_off[BTM_PM_NUM_SET_MODES] = {0, 0, 1}; |
| /* mask to supported feature */ |
| const uint8_t btm_pm_mode_msk[BTM_PM_NUM_SET_MODES] = {0x40, 0x80, 0x01}; |
| |
| #define BTM_PM_GET_MD1 1 |
| #define BTM_PM_GET_MD2 2 |
| #define BTM_PM_GET_COMP 3 |
| |
| const uint8_t |
| btm_pm_md_comp_matrix[BTM_PM_NUM_SET_MODES * BTM_PM_NUM_SET_MODES] = { |
| BTM_PM_GET_COMP, BTM_PM_GET_MD2, BTM_PM_GET_MD2, |
| |
| BTM_PM_GET_MD1, BTM_PM_GET_COMP, BTM_PM_GET_MD1, |
| |
| BTM_PM_GET_MD1, BTM_PM_GET_MD2, BTM_PM_GET_COMP}; |
| |
| /* function prototype */ |
| static int btm_pm_find_acl_ind(const RawAddress& remote_bda); |
| static tBTM_STATUS btm_pm_snd_md_req(uint8_t pm_id, int link_ind, |
| const tBTM_PM_PWR_MD* p_mode); |
| static const char* mode_to_string(const tBTM_PM_MODE mode); |
| |
| #if (BTM_PM_DEBUG == TRUE) |
| const char* btm_pm_state_str[] = {"pm_active_state", "pm_hold_state", |
| "pm_sniff_state", "pm_park_state", |
| "pm_pend_state"}; |
| |
| const char* btm_pm_event_str[] = {"pm_set_mode_event", "pm_hci_sts_event", |
| "pm_mod_chg_event", "pm_update_event"}; |
| |
| const char* btm_pm_action_str[] = {"pm_set_mode_action", "pm_update_db_action", |
| "pm_mod_chg_action", "pm_hci_sts_action", |
| "pm_update_action"}; |
| #endif // BTM_PM_DEBUG |
| |
| /*****************************************************************************/ |
| /* P U B L I C F U N C T I O N S */ |
| /*****************************************************************************/ |
| /******************************************************************************* |
| * |
| * Function BTM_PmRegister |
| * |
| * Description register or deregister with power manager |
| * |
| * Returns BTM_SUCCESS if successful, |
| * BTM_NO_RESOURCES if no room to hold registration |
| * BTM_ILLEGAL_VALUE |
| * |
| ******************************************************************************/ |
| tBTM_STATUS BTM_PmRegister(uint8_t mask, uint8_t* p_pm_id, |
| tBTM_PM_STATUS_CBACK* p_cb) { |
| int xx; |
| |
| /* de-register */ |
| if (mask & BTM_PM_DEREG) { |
| if (*p_pm_id >= BTM_MAX_PM_RECORDS) return BTM_ILLEGAL_VALUE; |
| btm_cb.pm_reg_db[*p_pm_id].mask = BTM_PM_REC_NOT_USED; |
| return BTM_SUCCESS; |
| } |
| |
| for (xx = 0; xx < BTM_MAX_PM_RECORDS; xx++) { |
| /* find an unused entry */ |
| if (btm_cb.pm_reg_db[xx].mask == BTM_PM_REC_NOT_USED) { |
| /* if register for notification, should provide callback routine */ |
| if (mask & BTM_PM_REG_NOTIF) { |
| if (p_cb == NULL) return BTM_ILLEGAL_VALUE; |
| btm_cb.pm_reg_db[xx].cback = p_cb; |
| } |
| btm_cb.pm_reg_db[xx].mask = mask; |
| *p_pm_id = xx; |
| return BTM_SUCCESS; |
| } |
| } |
| |
| return BTM_NO_RESOURCES; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTM_SetPowerMode |
| * |
| * Description store the mode in control block or |
| * alter ACL connection behavior. |
| * |
| * Returns BTM_SUCCESS if successful, |
| * BTM_UNKNOWN_ADDR if bd addr is not active or bad |
| * |
| ******************************************************************************/ |
| tBTM_STATUS BTM_SetPowerMode(uint8_t pm_id, const RawAddress& remote_bda, |
| const tBTM_PM_PWR_MD* p_mode) { |
| uint8_t* p_features; |
| int ind, acl_ind; |
| tBTM_PM_MCB* p_cb = nullptr; /* per ACL link */ |
| tBTM_PM_MODE mode; |
| int temp_pm_id; |
| |
| if (pm_id >= BTM_MAX_PM_RECORDS) { |
| pm_id = BTM_PM_SET_ONLY_ID; |
| } |
| |
| if (!p_mode) { |
| LOG(ERROR) << __func__ << ": pm_id " << unsigned(pm_id) |
| << " p_mode is null for " << remote_bda; |
| return BTM_ILLEGAL_VALUE; |
| } |
| |
| VLOG(2) << __func__ << " pm_id " << pm_id << " BDA: " << remote_bda |
| << " mode:" << std::to_string(p_mode->mode); |
| |
| /* take out the force bit */ |
| mode = p_mode->mode & ~BTM_PM_MD_FORCE; |
| |
| acl_ind = btm_pm_find_acl_ind(remote_bda); |
| if (acl_ind == MAX_L2CAP_LINKS) return (BTM_UNKNOWN_ADDR); |
| |
| p_cb = &(btm_cb.pm_mode_db[acl_ind]); |
| |
| if (mode != BTM_PM_MD_ACTIVE) { |
| /* check if the requested mode is supported */ |
| ind = mode - BTM_PM_MD_HOLD; /* make it base 0 */ |
| p_features = BTM_ReadLocalFeatures(); |
| if (!(p_features[btm_pm_mode_off[ind]] & btm_pm_mode_msk[ind]) || |
| interop_match_addr(INTEROP_DISABLE_SNIFF, &remote_bda)) { |
| LOG(ERROR) << __func__ << ": pm_id " << unsigned(pm_id) << " mode " |
| << unsigned(mode) << " is not supported for " << remote_bda; |
| return BTM_MODE_UNSUPPORTED; |
| } |
| } |
| |
| if (mode == p_cb->state) { |
| /* already in the requested mode and the current interval has less latency |
| * than the max */ |
| if ((mode == BTM_PM_MD_ACTIVE) || |
| ((p_mode->mode & BTM_PM_MD_FORCE) && (p_mode->max >= p_cb->interval) && |
| (p_mode->min <= p_cb->interval)) || |
| ((p_mode->mode & BTM_PM_MD_FORCE) == 0 && |
| (p_mode->max >= p_cb->interval))) { |
| VLOG(1) << __func__ << " already in requested mode " |
| << std::to_string(p_mode->mode) << ", interval " << p_cb->interval |
| << " max " << p_mode->max << " min " << p_mode->min; |
| return BTM_SUCCESS; |
| } |
| } |
| |
| temp_pm_id = pm_id; |
| if (pm_id == BTM_PM_SET_ONLY_ID) { |
| temp_pm_id = BTM_MAX_PM_RECORDS; |
| } |
| |
| /* update mode database */ |
| if (((pm_id != BTM_PM_SET_ONLY_ID) && |
| (btm_cb.pm_reg_db[pm_id].mask & BTM_PM_REG_SET)) || |
| ((pm_id == BTM_PM_SET_ONLY_ID) && |
| (btm_cb.pm_pend_link != MAX_L2CAP_LINKS))) { |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("BTM_SetPowerMode: Saving cmd acl_ind %d temp_pm_id %d", |
| acl_ind, temp_pm_id); |
| #endif // BTM_PM_DEBUG |
| /* Make sure mask is set to BTM_PM_REG_SET */ |
| btm_cb.pm_reg_db[temp_pm_id].mask |= BTM_PM_REG_SET; |
| *(&p_cb->req_mode[temp_pm_id]) = *p_mode; |
| p_cb->chg_ind = true; |
| } |
| |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm state:0x%x, pm_pend_link: %d", p_cb->state, |
| btm_cb.pm_pend_link); |
| #endif // BTM_PM_DEBUG |
| /* if mode == hold or pending, return */ |
| if ((p_cb->state == BTM_PM_STS_HOLD) || (p_cb->state == BTM_PM_STS_PENDING) || |
| (btm_cb.pm_pend_link != MAX_L2CAP_LINKS)) { |
| /* command pending */ |
| if (acl_ind != btm_cb.pm_pend_link) { |
| /* set the stored mask */ |
| p_cb->state |= BTM_PM_STORED_MASK; |
| BTM_TRACE_DEBUG("%s: btm_pm state stored:%d", __func__, acl_ind); |
| } |
| return BTM_CMD_STORED; |
| } |
| |
| return btm_pm_snd_md_req(pm_id, acl_ind, p_mode); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTM_ReadPowerMode |
| * |
| * Description This returns the current mode for a specific |
| * ACL connection. |
| * |
| * Input Param remote_bda - device address of desired ACL connection |
| * |
| * Output Param p_mode - address where the current mode is copied into. |
| * BTM_ACL_MODE_NORMAL |
| * BTM_ACL_MODE_HOLD |
| * BTM_ACL_MODE_SNIFF |
| * BTM_ACL_MODE_PARK |
| * (valid only if return code is BTM_SUCCESS) |
| * |
| * Returns BTM_SUCCESS if successful, |
| * BTM_UNKNOWN_ADDR if bd addr is not active or bad |
| * |
| ******************************************************************************/ |
| tBTM_STATUS BTM_ReadPowerMode(const RawAddress& remote_bda, |
| tBTM_PM_MODE* p_mode) { |
| int acl_ind; |
| |
| acl_ind = btm_pm_find_acl_ind(remote_bda); |
| if (acl_ind == MAX_L2CAP_LINKS) return (BTM_UNKNOWN_ADDR); |
| |
| *p_mode = btm_cb.pm_mode_db[acl_ind].state; |
| return BTM_SUCCESS; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_read_power_mode_state |
| * |
| * Description This returns the current pm state for a specific |
| * ACL connection. |
| * |
| * Input Param remote_bda - device address of desired ACL connection |
| * |
| * Output Param pmState - address where the current pm state is copied. |
| * BTM_PM_ST_ACTIVE |
| * BTM_PM_ST_HOLD |
| * BTM_PM_ST_SNIFF |
| * BTM_PM_ST_PARK |
| * BTM_PM_ST_PENDING |
| * (valid only if return code is BTM_SUCCESS) |
| * |
| * Returns BTM_SUCCESS if successful, |
| * BTM_UNKNOWN_ADDR if bd addr is not active or bad |
| * |
| ******************************************************************************/ |
| tBTM_STATUS btm_read_power_mode_state(const RawAddress& remote_bda, |
| tBTM_PM_STATE* pmState) { |
| int acl_ind = btm_pm_find_acl_ind(remote_bda); |
| |
| if (acl_ind == MAX_L2CAP_LINKS) return (BTM_UNKNOWN_ADDR); |
| |
| *pmState = btm_cb.pm_mode_db[acl_ind].state; |
| return BTM_SUCCESS; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTM_SetSsrParams |
| * |
| * Description This sends the given SSR parameters for the given ACL |
| * connection if it is in ACTIVE mode. |
| * |
| * Input Param remote_bda - device address of desired ACL connection |
| * max_lat - maximum latency (in 0.625ms)(0-0xFFFE) |
| * min_rmt_to - minimum remote timeout |
| * min_loc_to - minimum local timeout |
| * |
| * |
| * Returns BTM_SUCCESS if the HCI command is issued successful, |
| * BTM_UNKNOWN_ADDR if bd addr is not active or bad |
| * BTM_CMD_STORED if the command is stored |
| * |
| ******************************************************************************/ |
| tBTM_STATUS BTM_SetSsrParams(const RawAddress& remote_bda, uint16_t max_lat, |
| uint16_t min_rmt_to, uint16_t min_loc_to) { |
| #if (BTM_SSR_INCLUDED == TRUE) |
| int acl_ind; |
| tBTM_PM_MCB* p_cb; |
| |
| acl_ind = btm_pm_find_acl_ind(remote_bda); |
| if (acl_ind == MAX_L2CAP_LINKS) return (BTM_UNKNOWN_ADDR); |
| |
| if (BTM_PM_STS_ACTIVE == btm_cb.pm_mode_db[acl_ind].state || |
| BTM_PM_STS_SNIFF == btm_cb.pm_mode_db[acl_ind].state) { |
| btsnd_hcic_sniff_sub_rate(btm_cb.acl_db[acl_ind].hci_handle, max_lat, |
| min_rmt_to, min_loc_to); |
| return BTM_SUCCESS; |
| } |
| p_cb = &btm_cb.pm_mode_db[acl_ind]; |
| p_cb->max_lat = max_lat; |
| p_cb->min_rmt_to = min_rmt_to; |
| p_cb->min_loc_to = min_loc_to; |
| return BTM_CMD_STORED; |
| #else |
| return BTM_ILLEGAL_ACTION; |
| #endif // BTM_SSR_INCLUDED |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_reset |
| * |
| * Description as a part of the BTM reset process. |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void btm_pm_reset(void) { |
| int xx; |
| tBTM_PM_STATUS_CBACK* cb = NULL; |
| |
| /* clear the pending request for application */ |
| if ((btm_cb.pm_pend_id != BTM_PM_SET_ONLY_ID) && |
| (btm_cb.pm_reg_db[btm_cb.pm_pend_id].mask & BTM_PM_REG_NOTIF)) { |
| cb = btm_cb.pm_reg_db[btm_cb.pm_pend_id].cback; |
| } |
| |
| /* clear the register record */ |
| for (xx = 0; xx < BTM_MAX_PM_RECORDS; xx++) { |
| btm_cb.pm_reg_db[xx].mask = BTM_PM_REC_NOT_USED; |
| } |
| |
| if (cb != NULL && btm_cb.pm_pend_link < MAX_L2CAP_LINKS) |
| (*cb)(btm_cb.acl_db[btm_cb.pm_pend_link].remote_addr, BTM_PM_STS_ERROR, |
| BTM_DEV_RESET, 0); |
| |
| /* no command pending */ |
| btm_cb.pm_pend_link = MAX_L2CAP_LINKS; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_sm_alloc |
| * |
| * Description This function initializes the control block of an ACL link. |
| * It is called when an ACL connection is created. |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| void btm_pm_sm_alloc(uint8_t ind) { |
| tBTM_PM_MCB* p_db = &btm_cb.pm_mode_db[ind]; /* per ACL link */ |
| memset(p_db, 0, sizeof(tBTM_PM_MCB)); |
| p_db->state = BTM_PM_ST_ACTIVE; |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_sm_alloc ind:%d st:%d", ind, p_db->state); |
| #endif // BTM_PM_DEBUG |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_find_acl_ind |
| * |
| * Description This function initializes the control block of an ACL link. |
| * It is called when an ACL connection is created. |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| static int btm_pm_find_acl_ind(const RawAddress& remote_bda) { |
| tACL_CONN* p = &btm_cb.acl_db[0]; |
| uint8_t xx; |
| |
| for (xx = 0; xx < MAX_L2CAP_LINKS; xx++, p++) { |
| if (p->in_use && p->remote_addr == remote_bda && |
| p->transport == BT_TRANSPORT_BR_EDR) { |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_find_acl_ind ind:%d, st:%d", xx, |
| btm_cb.pm_mode_db[xx].state); |
| #endif // BTM_PM_DEBUG |
| break; |
| } |
| } |
| return xx; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_compare_modes |
| * Description get the "more active" mode of the 2 |
| * Returns void |
| * |
| ******************************************************************************/ |
| static tBTM_PM_PWR_MD* btm_pm_compare_modes(const tBTM_PM_PWR_MD* p_md1, |
| const tBTM_PM_PWR_MD* p_md2, |
| tBTM_PM_PWR_MD* p_res) { |
| uint8_t res; |
| |
| if (p_md1 == NULL) { |
| *p_res = *p_md2; |
| p_res->mode &= ~BTM_PM_MD_FORCE; |
| |
| return p_res; |
| } |
| |
| if (p_md2->mode == BTM_PM_MD_ACTIVE || p_md1->mode == BTM_PM_MD_ACTIVE) { |
| return NULL; |
| } |
| |
| /* check if force bit is involved */ |
| if (p_md1->mode & BTM_PM_MD_FORCE) { |
| *p_res = *p_md1; |
| p_res->mode &= ~BTM_PM_MD_FORCE; |
| return p_res; |
| } |
| |
| if (p_md2->mode & BTM_PM_MD_FORCE) { |
| *p_res = *p_md2; |
| p_res->mode &= ~BTM_PM_MD_FORCE; |
| return p_res; |
| } |
| |
| res = (p_md1->mode - 1) * BTM_PM_NUM_SET_MODES + (p_md2->mode - 1); |
| res = btm_pm_md_comp_matrix[res]; |
| switch (res) { |
| case BTM_PM_GET_MD1: |
| *p_res = *p_md1; |
| return p_res; |
| |
| case BTM_PM_GET_MD2: |
| *p_res = *p_md2; |
| return p_res; |
| |
| case BTM_PM_GET_COMP: |
| p_res->mode = p_md1->mode; |
| /* min of the two */ |
| p_res->max = (p_md1->max < p_md2->max) ? (p_md1->max) : (p_md2->max); |
| /* max of the two */ |
| p_res->min = (p_md1->min > p_md2->min) ? (p_md1->min) : (p_md2->min); |
| |
| /* the intersection is NULL */ |
| if (p_res->max < p_res->min) return NULL; |
| |
| if (p_res->mode == BTM_PM_MD_SNIFF) { |
| /* max of the two */ |
| p_res->attempt = (p_md1->attempt > p_md2->attempt) ? (p_md1->attempt) |
| : (p_md2->attempt); |
| p_res->timeout = (p_md1->timeout > p_md2->timeout) ? (p_md1->timeout) |
| : (p_md2->timeout); |
| } |
| return p_res; |
| } |
| return NULL; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_get_set_mode |
| * Description get the resulting mode from the registered parties, then compare |
| * it with the requested mode, if the command is from an |
| * unregistered party. |
| * |
| * Returns void |
| * |
| ******************************************************************************/ |
| static tBTM_PM_MODE btm_pm_get_set_mode(uint8_t pm_id, tBTM_PM_MCB* p_cb, |
| const tBTM_PM_PWR_MD* p_mode, |
| tBTM_PM_PWR_MD* p_res) { |
| int xx, loop_max; |
| tBTM_PM_PWR_MD* p_md = NULL; |
| |
| if (p_mode != NULL && p_mode->mode & BTM_PM_MD_FORCE) { |
| *p_res = *p_mode; |
| p_res->mode &= ~BTM_PM_MD_FORCE; |
| return p_res->mode; |
| } |
| |
| if (!p_mode) |
| loop_max = BTM_MAX_PM_RECORDS + 1; |
| else |
| loop_max = BTM_MAX_PM_RECORDS; |
| |
| for (xx = 0; xx < loop_max; xx++) { |
| /* g through all the registered "set" parties */ |
| if (btm_cb.pm_reg_db[xx].mask & BTM_PM_REG_SET) { |
| if (p_cb->req_mode[xx].mode == BTM_PM_MD_ACTIVE) { |
| /* if at least one registered (SET) party says ACTIVE, stay active */ |
| return BTM_PM_MD_ACTIVE; |
| } else { |
| /* if registered parties give conflicting information, stay active */ |
| if ((btm_pm_compare_modes(p_md, &p_cb->req_mode[xx], p_res)) == NULL) |
| return BTM_PM_MD_ACTIVE; |
| p_md = p_res; |
| } |
| } |
| } |
| |
| /* if the resulting mode is NULL(nobody registers SET), use the requested mode |
| */ |
| if (p_md == NULL) { |
| if (p_mode) |
| *p_res = *((tBTM_PM_PWR_MD*)p_mode); |
| else /* p_mode is NULL when btm_pm_snd_md_req is called from |
| btm_pm_proc_mode_change */ |
| return BTM_PM_MD_ACTIVE; |
| } else { |
| /* if the command is from unregistered party, |
| compare the resulting mode from registered party*/ |
| if ((pm_id == BTM_PM_SET_ONLY_ID) && |
| ((btm_pm_compare_modes(p_mode, p_md, p_res)) == NULL)) |
| return BTM_PM_MD_ACTIVE; |
| } |
| |
| return p_res->mode; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_snd_md_req |
| * Description get the resulting mode and send the resuest to host controller |
| * Returns tBTM_STATUS |
| *, bool *p_chg_ind |
| ******************************************************************************/ |
| static tBTM_STATUS btm_pm_snd_md_req(uint8_t pm_id, int link_ind, |
| const tBTM_PM_PWR_MD* p_mode) { |
| tBTM_PM_PWR_MD md_res; |
| tBTM_PM_MODE mode; |
| tBTM_PM_MCB* p_cb = &btm_cb.pm_mode_db[link_ind]; |
| bool chg_ind = false; |
| |
| mode = btm_pm_get_set_mode(pm_id, p_cb, p_mode, &md_res); |
| md_res.mode = mode; |
| |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_snd_md_req link_ind:%d, mode: %d", link_ind, mode); |
| #endif // BTM_PM_DEBUG |
| |
| if (p_cb->state == mode) { |
| /* already in the resulting mode */ |
| if ((mode == BTM_PM_MD_ACTIVE) || |
| ((md_res.max >= p_cb->interval) && (md_res.min <= p_cb->interval))) |
| return BTM_CMD_STORED; |
| /* Otherwise, needs to wake, then sleep */ |
| chg_ind = true; |
| } |
| p_cb->chg_ind = chg_ind; |
| |
| /* cannot go directly from current mode to resulting mode. */ |
| if (mode != BTM_PM_MD_ACTIVE && p_cb->state != BTM_PM_MD_ACTIVE) |
| p_cb->chg_ind = true; /* needs to wake, then sleep */ |
| |
| if (p_cb->chg_ind) /* needs to wake first */ |
| md_res.mode = BTM_PM_MD_ACTIVE; |
| #if (BTM_SSR_INCLUDED == TRUE) |
| else if (BTM_PM_MD_SNIFF == md_res.mode && p_cb->max_lat) { |
| btsnd_hcic_sniff_sub_rate(btm_cb.acl_db[link_ind].hci_handle, p_cb->max_lat, |
| p_cb->min_rmt_to, p_cb->min_loc_to); |
| p_cb->max_lat = 0; |
| } |
| #endif // BTM_SSR_INCLUDED |
| /* Default is failure */ |
| btm_cb.pm_pend_link = MAX_L2CAP_LINKS; |
| |
| /* send the appropriate HCI command */ |
| btm_cb.pm_pend_id = pm_id; |
| |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_snd_md_req state:0x%x, link_ind: %d", p_cb->state, |
| link_ind); |
| #endif // BTM_PM_DEBUG |
| |
| BTM_TRACE_DEBUG("%s switching from %s to %s.", __func__, |
| mode_to_string(p_cb->state), mode_to_string(md_res.mode)); |
| switch (md_res.mode) { |
| case BTM_PM_MD_ACTIVE: |
| switch (p_cb->state) { |
| case BTM_PM_MD_SNIFF: |
| btsnd_hcic_exit_sniff_mode(btm_cb.acl_db[link_ind].hci_handle); |
| btm_cb.pm_pend_link = link_ind; |
| break; |
| case BTM_PM_MD_PARK: |
| btsnd_hcic_exit_park_mode(btm_cb.acl_db[link_ind].hci_handle); |
| btm_cb.pm_pend_link = link_ind; |
| break; |
| default: |
| /* Failure btm_cb.pm_pend_link = MAX_L2CAP_LINKS */ |
| break; |
| } |
| break; |
| |
| case BTM_PM_MD_HOLD: |
| btsnd_hcic_hold_mode(btm_cb.acl_db[link_ind].hci_handle, md_res.max, |
| md_res.min); |
| btm_cb.pm_pend_link = link_ind; |
| break; |
| |
| case BTM_PM_MD_SNIFF: |
| btsnd_hcic_sniff_mode(btm_cb.acl_db[link_ind].hci_handle, md_res.max, |
| md_res.min, md_res.attempt, md_res.timeout); |
| btm_cb.pm_pend_link = link_ind; |
| break; |
| |
| case BTM_PM_MD_PARK: |
| btsnd_hcic_park_mode(btm_cb.acl_db[link_ind].hci_handle, md_res.max, |
| md_res.min); |
| btm_cb.pm_pend_link = link_ind; |
| break; |
| default: |
| /* Failure btm_cb.pm_pend_link = MAX_L2CAP_LINKS */ |
| break; |
| } |
| |
| if (btm_cb.pm_pend_link == MAX_L2CAP_LINKS) { |
| /* the command was not sent */ |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("pm_pend_link: %d", btm_cb.pm_pend_link); |
| #endif // BTM_PM_DEBUG |
| return (BTM_NO_RESOURCES); |
| } |
| |
| return BTM_CMD_STARTED; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_check_stored |
| * |
| * Description This function is called when an HCI command status event |
| * occurs to check if there's any PM command issued while |
| * waiting for HCI command status. |
| * |
| * Returns none. |
| * |
| ******************************************************************************/ |
| static void btm_pm_check_stored(void) { |
| int xx; |
| for (xx = 0; xx < MAX_L2CAP_LINKS; xx++) { |
| if (btm_cb.pm_mode_db[xx].state & BTM_PM_STORED_MASK) { |
| btm_cb.pm_mode_db[xx].state &= ~BTM_PM_STORED_MASK; |
| BTM_TRACE_DEBUG("btm_pm_check_stored :%d", xx); |
| btm_pm_snd_md_req(BTM_PM_SET_ONLY_ID, xx, NULL); |
| break; |
| } |
| } |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_proc_cmd_status |
| * |
| * Description This function is called when an HCI command status event |
| * occurs for power manager related commands. |
| * |
| * Input Parms status - status of the event (HCI_SUCCESS if no errors) |
| * |
| * Returns none. |
| * |
| ******************************************************************************/ |
| void btm_pm_proc_cmd_status(uint8_t status) { |
| tBTM_PM_MCB* p_cb; |
| tBTM_PM_STATUS pm_status; |
| |
| if (btm_cb.pm_pend_link >= MAX_L2CAP_LINKS) return; |
| |
| p_cb = &btm_cb.pm_mode_db[btm_cb.pm_pend_link]; |
| |
| if (status == HCI_SUCCESS) { |
| p_cb->state = BTM_PM_ST_PENDING; |
| pm_status = BTM_PM_STS_PENDING; |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_proc_cmd_status new state:0x%x", p_cb->state); |
| #endif // BTM_PM_DEBUG |
| } else /* the command was not successfull. Stay in the same state */ |
| { |
| pm_status = BTM_PM_STS_ERROR; |
| } |
| |
| /* notify the caller is appropriate */ |
| if ((btm_cb.pm_pend_id != BTM_PM_SET_ONLY_ID) && |
| (btm_cb.pm_reg_db[btm_cb.pm_pend_id].mask & BTM_PM_REG_NOTIF)) { |
| (*btm_cb.pm_reg_db[btm_cb.pm_pend_id].cback)( |
| btm_cb.acl_db[btm_cb.pm_pend_link].remote_addr, pm_status, 0, status); |
| } |
| |
| /* no pending cmd now */ |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG( |
| "btm_pm_proc_cmd_status state:0x%x, pm_pend_link: %d(new: %d)", |
| p_cb->state, btm_cb.pm_pend_link, MAX_L2CAP_LINKS); |
| #endif // BTM_PM_DEBUG |
| btm_cb.pm_pend_link = MAX_L2CAP_LINKS; |
| |
| btm_pm_check_stored(); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_process_mode_change |
| * |
| * Description This function is called when an HCI mode change event |
| * occurs. |
| * |
| * Input Parms hci_status - status of the event (HCI_SUCCESS if no errors) |
| * hci_handle - connection handle associated with the change |
| * mode - HCI_MODE_ACTIVE, HCI_MODE_HOLD, HCI_MODE_SNIFF, or |
| * HCI_MODE_PARK |
| * interval - number of baseband slots (meaning depends on |
| * mode) |
| * |
| * Returns none. |
| * |
| ******************************************************************************/ |
| void btm_pm_proc_mode_change(uint8_t hci_status, uint16_t hci_handle, |
| uint8_t mode, uint16_t interval) { |
| tACL_CONN* p; |
| tBTM_PM_MCB* p_cb = NULL; |
| int xx, yy, zz; |
| tBTM_PM_STATE old_state; |
| tL2C_LCB* p_lcb; |
| |
| /* get the index to acl_db */ |
| xx = btm_handle_to_acl_index(hci_handle); |
| if (xx >= MAX_L2CAP_LINKS) return; |
| |
| p = &btm_cb.acl_db[xx]; |
| |
| /* update control block */ |
| p_cb = &(btm_cb.pm_mode_db[xx]); |
| old_state = p_cb->state; |
| p_cb->state = mode; |
| p_cb->interval = interval; |
| |
| BTM_TRACE_DEBUG("%s switched from %s to %s.", __func__, |
| mode_to_string(old_state), mode_to_string(p_cb->state)); |
| |
| p_lcb = l2cu_find_lcb_by_bd_addr(p->remote_addr, BT_TRANSPORT_BR_EDR); |
| if (p_lcb != NULL) { |
| if ((p_cb->state == BTM_PM_ST_ACTIVE) || (p_cb->state == BTM_PM_ST_SNIFF)) { |
| /* There might be any pending packets due to SNIFF or PENDING state */ |
| /* Trigger L2C to start transmission of the pending packets. */ |
| BTM_TRACE_DEBUG( |
| "btm mode change to active; check l2c_link for outgoing packets"); |
| l2c_link_check_send_pkts(p_lcb, NULL, NULL); |
| } |
| } |
| |
| /* notify registered parties */ |
| for (yy = 0; yy <= BTM_MAX_PM_RECORDS; yy++) { |
| /* set req_mode HOLD mode->ACTIVE */ |
| if ((mode == BTM_PM_MD_ACTIVE) && |
| (p_cb->req_mode[yy].mode == BTM_PM_MD_HOLD)) |
| p_cb->req_mode[yy].mode = BTM_PM_MD_ACTIVE; |
| } |
| |
| /* new request has been made. - post a message to BTU task */ |
| if (old_state & BTM_PM_STORED_MASK) { |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_proc_mode_change: Sending stored req:%d", xx); |
| #endif // BTM_PM_DEBUG |
| btm_pm_snd_md_req(BTM_PM_SET_ONLY_ID, xx, NULL); |
| } else { |
| for (zz = 0; zz < MAX_L2CAP_LINKS; zz++) { |
| if (btm_cb.pm_mode_db[zz].chg_ind) { |
| #if (BTM_PM_DEBUG == TRUE) |
| BTM_TRACE_DEBUG("btm_pm_proc_mode_change: Sending PM req :%d", zz); |
| #endif // BTM_PM_DEBUG |
| btm_pm_snd_md_req(BTM_PM_SET_ONLY_ID, zz, NULL); |
| break; |
| } |
| } |
| } |
| |
| /* notify registered parties */ |
| for (yy = 0; yy < BTM_MAX_PM_RECORDS; yy++) { |
| if (btm_cb.pm_reg_db[yy].mask & BTM_PM_REG_NOTIF) { |
| (*btm_cb.pm_reg_db[yy].cback)(p->remote_addr, mode, interval, hci_status); |
| } |
| } |
| /*check if sco disconnect is waiting for the mode change */ |
| btm_sco_disc_chk_pend_for_modechange(hci_handle); |
| |
| /* If mode change was because of an active role switch or change link key */ |
| btm_cont_rswitch(p, btm_find_dev(p->remote_addr), hci_status); |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_proc_ssr_evt |
| * |
| * Description This function is called when an HCI sniff subrating event |
| * occurs. |
| * |
| * Returns none. |
| * |
| ******************************************************************************/ |
| #if (BTM_SSR_INCLUDED == TRUE) |
| void btm_pm_proc_ssr_evt(uint8_t* p, UNUSED_ATTR uint16_t evt_len) { |
| uint8_t status; |
| uint16_t handle; |
| uint16_t max_rx_lat; |
| int xx, yy; |
| tBTM_PM_MCB* p_cb; |
| tACL_CONN* p_acl = NULL; |
| uint16_t use_ssr = true; |
| |
| STREAM_TO_UINT8(status, p); |
| |
| STREAM_TO_UINT16(handle, p); |
| /* get the index to acl_db */ |
| xx = btm_handle_to_acl_index(handle); |
| if (xx >= MAX_L2CAP_LINKS) return; |
| |
| p += 2; |
| STREAM_TO_UINT16(max_rx_lat, p); |
| p_cb = &(btm_cb.pm_mode_db[xx]); |
| |
| p_acl = &btm_cb.acl_db[xx]; |
| if (p_cb->interval == max_rx_lat) { |
| /* using legacy sniff */ |
| use_ssr = false; |
| } |
| |
| /* notify registered parties */ |
| for (yy = 0; yy < BTM_MAX_PM_RECORDS; yy++) { |
| if (btm_cb.pm_reg_db[yy].mask & BTM_PM_REG_NOTIF) { |
| if (p_acl) { |
| (*btm_cb.pm_reg_db[yy].cback)(p_acl->remote_addr, BTM_PM_STS_SSR, |
| use_ssr, status); |
| } |
| } |
| } |
| } |
| #endif // BTM_SSR_INCLUDED |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_device_in_active_or_sniff_mode |
| * |
| * Description This function is called to check if in active or sniff mode |
| * |
| * Returns true, if in active or sniff mode |
| * |
| ******************************************************************************/ |
| bool btm_pm_device_in_active_or_sniff_mode(void) { |
| /* The active state is the highest state-includes connected device and sniff |
| * mode*/ |
| |
| /* Covers active and sniff modes */ |
| if (BTM_GetNumAclLinks() > 0) { |
| BTM_TRACE_DEBUG("%s - ACL links: %d", __func__, BTM_GetNumAclLinks()); |
| return true; |
| } |
| |
| /* Check BLE states */ |
| if (btm_ble_get_conn_st() != BLE_CONN_IDLE) { |
| BTM_TRACE_DEBUG("%s - BLE state: %x", __func__, btm_ble_get_conn_st()); |
| return true; |
| } |
| |
| return false; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function btm_pm_device_in_scan_state |
| * |
| * Description This function is called to check if in paging, inquiry or |
| * connecting mode |
| * |
| * Returns true, if in paging, inquiry or connecting mode |
| * |
| ******************************************************************************/ |
| bool btm_pm_device_in_scan_state(void) { |
| /* Scan state-paging, inquiry, and trying to connect */ |
| |
| /* Check for paging */ |
| if (btm_cb.is_paging || (!fixed_queue_is_empty(btm_cb.page_queue)) || |
| BTM_BL_PAGING_STARTED == btm_cb.busy_level) { |
| BTM_TRACE_DEBUG("btm_pm_device_in_scan_state- paging"); |
| return true; |
| } |
| |
| /* Check for inquiry */ |
| if ((btm_cb.btm_inq_vars.inq_active & |
| (BTM_BR_INQ_ACTIVE_MASK | BTM_BLE_INQ_ACTIVE_MASK)) != 0) { |
| BTM_TRACE_DEBUG("btm_pm_device_in_scan_state- Inq active"); |
| return true; |
| } |
| |
| return false; |
| } |
| |
| /******************************************************************************* |
| * |
| * Function BTM_PM_ReadControllerState |
| * |
| * Description This function is called to obtain the controller state |
| * |
| * Returns Controller State-BTM_CONTRL_ACTIVE, BTM_CONTRL_SCAN, and |
| * BTM_CONTRL_IDLE |
| * |
| ******************************************************************************/ |
| tBTM_CONTRL_STATE BTM_PM_ReadControllerState(void) { |
| if (btm_pm_device_in_active_or_sniff_mode()) |
| return BTM_CONTRL_ACTIVE; |
| else if (btm_pm_device_in_scan_state()) |
| return BTM_CONTRL_SCAN; |
| else |
| return BTM_CONTRL_IDLE; |
| } |
| |
| static const char* mode_to_string(const tBTM_PM_MODE mode) { |
| switch (mode) { |
| case BTM_PM_MD_ACTIVE: |
| return "ACTIVE"; |
| case BTM_PM_MD_SNIFF: |
| return "SNIFF"; |
| case BTM_PM_MD_PARK: |
| return "PARK"; |
| case BTM_PM_MD_HOLD: |
| return "HOLD"; |
| default: |
| return "UNKNOWN"; |
| } |
| } |