1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
/******************************************************************************
*
* Copyright 2015 Google, Inc.
*
* 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.
*
******************************************************************************/
#pragma once
#include <stdbool.h>
#include "raw_address.h"
static const char INTEROP_MODULE[] = "interop_module";
// NOTE:
// Only add values at the end of this enum and do NOT delete values
// as they may be used in dynamic device configuration.
typedef enum {
// Disable secure connections
// This is for pre BT 4.1/2 devices that do not handle secure mode
// very well.
INTEROP_DISABLE_LE_SECURE_CONNECTIONS = 0,
// Some devices have proven problematic during the pairing process, often
// requiring multiple retries to complete pairing. To avoid degrading the user
// experience for those devices, automatically re-try pairing if page
// timeouts are received during pairing.
INTEROP_AUTO_RETRY_PAIRING,
// Devices requiring this workaround do not handle Bluetooth Absolute Volume
// control correctly, leading to undesirable (potentially harmful) volume
// levels or general lack of controlability.
INTEROP_DISABLE_ABSOLUTE_VOLUME,
// Disable automatic pairing with headsets/car-kits
// Some car kits do not react kindly to a failed pairing attempt and
// do not allow immediate re-pairing. Rejectlist these so that the initial
// pairing attempt makes it to the user instead.
INTEROP_DISABLE_AUTO_PAIRING,
// Use a fixed pin for specific keyboards
// Keyboards should use a variable pin at all times. However, some keyboards
// require a fixed pin of all 0000. This workaround enables auto pairing for
// those keyboards.
INTEROP_KEYBOARD_REQUIRES_FIXED_PIN,
// Some headsets have audio jitter issues because of increased
// re-transmissions as the 3 Mbps packets have a lower link margin, and are
// more prone to interference. We can disable 3DH packets (use only 2DH
// packets) for the ACL link to improve sensitivity when streaming A2DP audio
// to the headset. Air sniffer logs show reduced re-transmissions after
// switching to 2DH packets.
// Disable 3Mbps packets and use only 2Mbps packets for ACL links when
// streaming audio.
INTEROP_2MBPS_LINK_ONLY,
// Do not use supervision timeout value received from preferred connection
// parameters, use 3s instead. Use with HID only.
INTEROP_HID_PREF_CONN_SUP_TIMEOUT_3S,
// Do not send service changed indications (GATT client).
// This should be removed after the characteristic is implmeented b/62088395.
INTEROP_GATTC_NO_SERVICE_CHANGED_IND,
// Do not use AVDTP RECONFIGURE when reconfiguring A2DP streams.
// Some A2DP Sink devices report SUCCESS to the AVDTP RECONFIGURE command,
// but fail to play the reconfigured audio stream.
INTEROP_DISABLE_AVDTP_RECONFIGURE,
// Create dynamic rejectlist to disable role switch.
// Some car kits indicate that role switch is supported, but then reject
// role switch attempts. After rejecting several role switch attempts,
// such car kits will go into bad state.
INTEROP_DYNAMIC_ROLE_SWITCH,
// Disable role switch for headsets/car-kits.
// Some car kits allow role switch but when the Phone initiates role switch,
// the Remote device will go into bad state that will lead to LMP time out.
INTEROP_DISABLE_ROLE_SWITCH,
// Set a very low initial sniff subrating for HID devices that do not
// set their own sniff interval.
INTEROP_HID_HOST_LIMIT_SNIFF_INTERVAL,
// Disable remote name requst for some devices.
// The public address of these devices are same as the Random address in ADV.
// Then will get name by LE_Create_connection, actually fails,
// but will block pairing.
INTEROP_DISABLE_NAME_REQUEST,
// Respond AVRCP profile version only 1.4 for some device.
INTEROP_AVRCP_1_4_ONLY,
// Disable sniff mode for headsets/car-kits
// Some car kits supports sniff mode but when DUT initiates sniff req
// Remote will go to bad state and its leads to LMP time out.
INTEROP_DISABLE_SNIFF,
// Do not send AVDTP SUSPEND while the playback is paused.
// Some older A2DP Sink devices might not support to pause the streaming.
INTEROP_DISABLE_AVDTP_SUSPEND,
// Some car kits do not send the AT+BIND command while establishing the SLC
// which causes an HFP profile connection failure
INTEROP_SLC_SKIP_BIND_COMMAND,
// Respond AVRCP profile version only 1.3 for some device.
INTEROP_AVRCP_1_3_ONLY,
// Some remote devices have LMP version in[5.0, 5.2] but do not support
// robust
// caching or correctly response with an error. We disable the
// database hash
// lookup for such devices.
INTEROP_DISABLE_ROBUST_CACHING,
} interop_feature_t;
// Check if a given |addr| matches a known interoperability workaround as
// identified by the |interop_feature_t| enum. This API is used for simple
// address based lookups where more information is not available. No
// look-ups or random address resolution are performed on |addr|.
bool interop_match_addr(const interop_feature_t feature,
const RawAddress* addr);
// Check if a given remote device |name| matches a known workaround.
// Name comparisons are case sensitive and do not allow for partial matches.
// If |name| is "TEST" and a workaround exists for "TESTING", then this function
// will return false. But, if |name| is "TESTING" and a workaround exists for
// "TEST", this function will return true.
// |name| cannot be null and must be null terminated.
bool interop_match_name(const interop_feature_t feature, const char* name);
// Add a dynamic interop database entry for a device matching the first |length|
// bytes of |addr|, implementing the workaround identified by |feature|.
// |addr| may not be null.
// |length| must be greater than 0 and less than RawAddress::kLength.
// As |interop_feature_t| is not exposed in the public API, feature must be a
// valid integer representing an option in the enum.
void interop_database_add(uint16_t feature, const RawAddress* addr,
size_t length);
// Clear the dynamic portion of the interoperability workaround database.
void interop_database_clear(void);
|
