blob: 17253c5a25108be6ee28d9c6ad6edeebf9198c10 [file] [log] [blame]
/*
* Copyright 2019 The Android Open Source Project
*
* 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.
*/
#include <statslog.h>
#include "btif_bqr.h"
#include "btif_dm.h"
#include "common/leaky_bonded_queue.h"
#include "osi/include/properties.h"
#include "stack/btm/btm_int.h"
namespace bluetooth {
namespace bqr {
using bluetooth::common::LeakyBondedQueue;
using std::chrono::system_clock;
// The instance of BQR event queue
static std::unique_ptr<LeakyBondedQueue<BqrVseSubEvt>> kpBqrEventQueue(
new LeakyBondedQueue<BqrVseSubEvt>(kBqrEventQueueSize));
bool BqrVseSubEvt::ParseBqrEvt(uint8_t length, uint8_t* p_param_buf) {
if (length < kBqrParamTotalLen) {
LOG(FATAL) << __func__
<< ": Parameter total length: " << std::to_string(length)
<< " is abnormal. It shall be not shorter than: "
<< std::to_string(kBqrParamTotalLen);
return false;
}
STREAM_TO_UINT8(quality_report_id_, p_param_buf);
STREAM_TO_UINT8(packet_types_, p_param_buf);
STREAM_TO_UINT16(connection_handle_, p_param_buf);
STREAM_TO_UINT8(connection_role_, p_param_buf);
STREAM_TO_UINT8(tx_power_level_, p_param_buf);
STREAM_TO_INT8(rssi_, p_param_buf);
STREAM_TO_UINT8(snr_, p_param_buf);
STREAM_TO_UINT8(unused_afh_channel_count_, p_param_buf);
STREAM_TO_UINT8(afh_select_unideal_channel_count_, p_param_buf);
STREAM_TO_UINT16(lsto_, p_param_buf);
STREAM_TO_UINT32(connection_piconet_clock_, p_param_buf);
STREAM_TO_UINT32(retransmission_count_, p_param_buf);
STREAM_TO_UINT32(no_rx_count_, p_param_buf);
STREAM_TO_UINT32(nak_count_, p_param_buf);
STREAM_TO_UINT32(last_tx_ack_timestamp_, p_param_buf);
STREAM_TO_UINT32(flow_off_count_, p_param_buf);
STREAM_TO_UINT32(last_flow_on_timestamp_, p_param_buf);
STREAM_TO_UINT32(buffer_overflow_bytes_, p_param_buf);
STREAM_TO_UINT32(buffer_underflow_bytes_, p_param_buf);
const auto now = system_clock::to_time_t(system_clock::now());
localtime_r(&now, &tm_timestamp_);
return true;
}
std::string BqrVseSubEvt::ToString() const {
std::stringstream ss_return_string;
ss_return_string << QualityReportIdToString(quality_report_id_)
<< ", Handle: " << loghex(connection_handle_) << ", "
<< PacketTypeToString(packet_types_) << ", "
<< ((connection_role_ == 0) ? "Master" : "Slave ")
<< ", PwLv: " << loghex(tx_power_level_)
<< ", RSSI: " << std::to_string(rssi_)
<< ", SNR: " << std::to_string(snr_) << ", UnusedCh: "
<< std::to_string(unused_afh_channel_count_)
<< ", UnidealCh: "
<< std::to_string(afh_select_unideal_channel_count_)
<< ", ReTx: " << std::to_string(retransmission_count_)
<< ", NoRX: " << std::to_string(no_rx_count_)
<< ", NAK: " << std::to_string(nak_count_)
<< ", FlowOff: " << std::to_string(flow_off_count_)
<< ", OverFlow: " << std::to_string(buffer_overflow_bytes_)
<< ", UndFlow: " << std::to_string(buffer_underflow_bytes_);
return ss_return_string.str();
}
std::string QualityReportIdToString(uint8_t quality_report_id) {
switch (quality_report_id) {
case QUALITY_REPORT_ID_MONITOR_MODE:
return "Monitoring ";
case QUALITY_REPORT_ID_APPROACH_LSTO:
return "Appro LSTO ";
case QUALITY_REPORT_ID_A2DP_AUDIO_CHOPPY:
return "A2DP Choppy";
case QUALITY_REPORT_ID_SCO_VOICE_CHOPPY:
return "SCO Choppy ";
default:
return "Invalid ";
}
}
std::string PacketTypeToString(uint8_t packet_type) {
switch (packet_type) {
case PACKET_TYPE_ID:
return "ID";
case PACKET_TYPE_NULL:
return "NULL";
case PACKET_TYPE_POLL:
return "POLL";
case PACKET_TYPE_FHS:
return "FHS";
case PACKET_TYPE_HV1:
return "HV1";
case PACKET_TYPE_HV2:
return "HV2";
case PACKET_TYPE_HV3:
return "HV3";
case PACKET_TYPE_DV:
return "DV";
case PACKET_TYPE_EV3:
return "EV3";
case PACKET_TYPE_EV4:
return "EV4";
case PACKET_TYPE_EV5:
return "EV5";
case PACKET_TYPE_2EV3:
return "2EV3";
case PACKET_TYPE_2EV5:
return "2EV5";
case PACKET_TYPE_3EV3:
return "3EV3";
case PACKET_TYPE_3EV5:
return "3EV5";
case PACKET_TYPE_DM1:
return "DM1";
case PACKET_TYPE_DH1:
return "DH1";
case PACKET_TYPE_DM3:
return "DM3";
case PACKET_TYPE_DH3:
return "DH3";
case PACKET_TYPE_DM5:
return "DM5";
case PACKET_TYPE_DH5:
return "DH5";
case PACKET_TYPE_AUX1:
return "AUX1";
case PACKET_TYPE_2DH1:
return "2DH1";
case PACKET_TYPE_2DH3:
return "2DH3";
case PACKET_TYPE_2DH5:
return "2DH5";
case PACKET_TYPE_3DH1:
return "3DH1";
case PACKET_TYPE_3DH3:
return "3DH3";
case PACKET_TYPE_3DH5:
return "3DH5";
default:
return "UnKnown ";
}
}
void AddBqrEventToQueue(uint8_t length, uint8_t* p_stream) {
std::unique_ptr<BqrVseSubEvt> p_bqr_event = std::make_unique<BqrVseSubEvt>();
if (!p_bqr_event->ParseBqrEvt(length, p_stream)) {
LOG(WARNING) << __func__ << ": Fail to parse BQR sub event.";
return;
}
LOG(WARNING) << *p_bqr_event;
int ret = android::util::stats_write(
android::util::BLUETOOTH_QUALITY_REPORT_REPORTED,
p_bqr_event->quality_report_id_, p_bqr_event->packet_types_,
p_bqr_event->connection_handle_, p_bqr_event->connection_role_,
p_bqr_event->tx_power_level_, p_bqr_event->rssi_, p_bqr_event->snr_,
p_bqr_event->unused_afh_channel_count_,
p_bqr_event->afh_select_unideal_channel_count_, p_bqr_event->lsto_,
p_bqr_event->connection_piconet_clock_,
p_bqr_event->retransmission_count_, p_bqr_event->no_rx_count_,
p_bqr_event->nak_count_, p_bqr_event->last_tx_ack_timestamp_,
p_bqr_event->flow_off_count_, p_bqr_event->last_flow_on_timestamp_,
p_bqr_event->buffer_overflow_bytes_,
p_bqr_event->buffer_underflow_bytes_);
if (ret < 0) {
LOG(WARNING) << __func__ << ": failed to log BQR event to statsd, error "
<< ret;
}
kpBqrEventQueue->Enqueue(p_bqr_event.release());
}
void ConfigureBqrCmpl(uint32_t current_evt_mask) {
LOG(INFO) << __func__ << ": current_evt_mask: " << loghex(current_evt_mask);
// (Un)Register for VSE of Bluetooth Quality Report sub event
tBTM_STATUS btm_status = BTM_BT_Quality_Report_VSE_Register(
current_evt_mask > kQualityEventMaskAllOff, AddBqrEventToQueue);
if (btm_status != BTM_SUCCESS) {
LOG(ERROR) << __func__ << ": Fail to (un)register VSE of BQR sub event."
<< " status: " << btm_status;
}
}
void EnableBtQualityReport(bool is_enable) {
LOG(INFO) << __func__ << ": is_enable: " << logbool(is_enable);
char bqr_prop_evtmask[PROPERTY_VALUE_MAX] = {0};
char bqr_prop_interval_ms[PROPERTY_VALUE_MAX] = {0};
osi_property_get(kpPropertyEventMask, bqr_prop_evtmask, "");
osi_property_get(kpPropertyMinReportIntervalMs, bqr_prop_interval_ms, "");
if (strlen(bqr_prop_evtmask) == 0 || strlen(bqr_prop_interval_ms) == 0) {
LOG(WARNING) << __func__ << ": Bluetooth Quality Report is disabled."
<< " bqr_prop_evtmask: " << bqr_prop_evtmask
<< ", bqr_prop_interval_ms: " << bqr_prop_interval_ms;
return;
}
BqrConfiguration bqr_config = {};
if (is_enable) {
bqr_config.report_action = REPORT_ACTION_ADD;
bqr_config.quality_event_mask =
static_cast<uint32_t>(atoi(bqr_prop_evtmask));
bqr_config.minimum_report_interval_ms =
static_cast<uint16_t>(atoi(bqr_prop_interval_ms));
} else {
bqr_config.report_action = REPORT_ACTION_CLEAR;
bqr_config.quality_event_mask = kQualityEventMaskAllOff;
bqr_config.minimum_report_interval_ms = kMinReportIntervalNoLimit;
}
LOG(INFO) << __func__
<< ": Event Mask: " << loghex(bqr_config.quality_event_mask)
<< ", Interval: " << bqr_config.minimum_report_interval_ms;
ConfigureBqr(bqr_config);
}
void BqrVscCompleteCallback(tBTM_VSC_CMPL* p_vsc_cmpl_params) {
if (p_vsc_cmpl_params->param_len < 1) {
LOG(ERROR) << __func__ << ": The length of returned parameters is less than 1";
return;
}
uint8_t* p_event_param_buf = p_vsc_cmpl_params->p_param_buf;
uint8_t status = 0xff;
// [Return Parameter] | [Size] | [Purpose]
// Status | 1 octet | Command complete status
// Current_Quality_Event_Mask | 4 octets | Indicates current bit mask setting
STREAM_TO_UINT8(status, p_event_param_buf);
if (status != HCI_SUCCESS) {
LOG(ERROR) << __func__ << ": Fail to configure BQR. status: " << loghex(status);
return;
}
if (p_vsc_cmpl_params->param_len != 5) {
LOG(FATAL) << __func__
<< ": The length of returned parameters is not equal to 5: "
<< std::to_string(p_vsc_cmpl_params->param_len);
return;
}
uint32_t current_quality_event_mask = kQualityEventMaskAllOff;
STREAM_TO_UINT32(current_quality_event_mask, p_event_param_buf);
LOG(INFO) << __func__
<< ", current event mask: " << loghex(current_quality_event_mask);
ConfigureBqrCmpl(current_quality_event_mask);
}
void ConfigureBqr(const BqrConfiguration& bqr_config) {
if (bqr_config.report_action > REPORT_ACTION_CLEAR ||
bqr_config.quality_event_mask > kQualityEventMaskAll ||
bqr_config.minimum_report_interval_ms > kMinReportIntervalMaxMs) {
LOG(FATAL) << __func__ << ": Invalid Parameter"
<< ", Action: " << bqr_config.report_action
<< ", Mask: " << loghex(bqr_config.quality_event_mask)
<< ", Interval: " << bqr_config.minimum_report_interval_ms;
return;
}
LOG(INFO) << __func__ << ": Action: " << bqr_config.report_action
<< ", Mask: " << loghex(bqr_config.quality_event_mask)
<< ", Interval: " << bqr_config.minimum_report_interval_ms;
uint8_t param[sizeof(BqrConfiguration)];
uint8_t* p_param = param;
UINT8_TO_STREAM(p_param, bqr_config.report_action);
UINT32_TO_STREAM(p_param, bqr_config.quality_event_mask);
UINT16_TO_STREAM(p_param, bqr_config.minimum_report_interval_ms);
BTM_VendorSpecificCommand(HCI_CONTROLLER_BQR_OPCODE_OCF, p_param - param,
param, BqrVscCompleteCallback);
}
void DebugDump(int fd) {
dprintf(fd, "\nBT Quality Report Events: \n");
if (kpBqrEventQueue->Empty()) {
dprintf(fd, "Event queue is empty.\n");
return;
}
while (!kpBqrEventQueue->Empty()) {
std::unique_ptr<BqrVseSubEvt> p_event(kpBqrEventQueue->Dequeue());
bool warning = (p_event->rssi_ < kCriWarnRssi ||
p_event->unused_afh_channel_count_ > kCriWarnUnusedCh);
std::stringstream ss_timestamp;
ss_timestamp << std::put_time(&p_event->tm_timestamp_, "%m-%d %H:%M:%S");
dprintf(fd, "%c %s %s\n", warning ? '*' : ' ', ss_timestamp.str().c_str(),
p_event->ToString().c_str());
}
dprintf(fd, "\n");
}
} // namespace bqr
} // namespace bluetooth