1 /*
2  * Copyright (C) 2016 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #include "wifi_feature_flags.h"
18 
19 namespace android {
20 namespace hardware {
21 namespace wifi {
22 namespace V1_4 {
23 namespace implementation {
24 namespace feature_flags {
25 
26 using V1_0::ChipModeId;
27 using V1_0::IfaceType;
28 using V1_0::IWifiChip;
29 
30 /* The chip may either have a single mode supporting any number of combinations,
31  * or a fixed dual-mode (so it involves firmware loading to switch between
32  * modes) setting. If there is a need to support more modes, it needs to be
33  * implemented manually in WiFi HAL (see changeFirmwareMode in
34  * WifiChip::handleChipConfiguration).
35  *
36  * Supported combinations are defined in device's makefile, for example:
37  *    WIFI_HAL_INTERFACE_COMBINATIONS := {{{STA, AP}, 1}, {{P2P, NAN}, 1}},
38  *    WIFI_HAL_INTERFACE_COMBINATIONS += {{{STA}, 1}, {{AP}, 2}}
39  * What means:
40  *    Interface combination 1: 1 STA or AP and 1 P2P or NAN concurrent iface
41  *                             operations.
42  *    Interface combination 2: 1 STA and 2 AP concurrent iface operations.
43  *
44  * For backward compatibility, the following makefile flags can be used to
45  * generate combinations list:
46  *  - WIFI_HIDL_FEATURE_DUAL_INTERFACE
47  *  - WIFI_HIDL_FEATURE_DISABLE_AP
48  *  - WIFI_HIDL_FEATURE_AWARE
49  * However, they are ignored if WIFI_HAL_INTERFACE_COMBINATIONS was provided.
50  * With WIFI_HIDL_FEATURE_DUAL_INTERFACE flag set, there is a single mode with
51  * two interface combinations:
52  *    Interface Combination 1: Will support 1 STA and 1 P2P or NAN (optional)
53  *                             concurrent iface operations.
54  *    Interface Combination 2: Will support 1 STA and 1 AP concurrent
55  *                             iface operations.
56  *
57  * The only dual-mode configuration supported is for alternating STA and AP
58  * mode, that may involve firmware reloading. In such case, there are 2 separate
59  * modes of operation with 1 interface combination each:
60  *    Mode 1 (STA mode): Will support 1 STA and 1 P2P or NAN (optional)
61  *                       concurrent iface operations.
62  *    Mode 2 (AP mode): Will support 1 AP iface operation.
63  *
64  * If Aware is enabled, the iface combination will be modified to support either
65  * P2P or NAN in place of just P2P.
66  */
67 // clang-format off
68 #ifdef WIFI_HAL_INTERFACE_COMBINATIONS
69 constexpr ChipModeId kMainModeId = chip_mode_ids::kV3;
70 #elif defined(WIFI_HIDL_FEATURE_DUAL_INTERFACE)
71 // former V2 (fixed dual interface) setup expressed as V3
72 constexpr ChipModeId kMainModeId = chip_mode_ids::kV3;
73 #  ifdef WIFI_HIDL_FEATURE_DISABLE_AP
74 #    ifdef WIFI_HIDL_FEATURE_AWARE
75 //     1 STA + 1 of (P2P or NAN)
76 #      define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{P2P, NAN}, 1}}
77 #    else
78 //     1 STA + 1 P2P
79 #      define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{P2P}, 1}}
80 #    endif
81 #  else
82 #    ifdef WIFI_HIDL_FEATURE_AWARE
83 //     (1 STA + 1 AP) or (1 STA + 1 of (P2P or NAN))
84 #      define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{AP}, 1}},\
85                                               {{{STA}, 1}, {{P2P, NAN}, 1}}
86 #    else
87 //     (1 STA + 1 AP) or (1 STA + 1 P2P)
88 #      define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{AP}, 1}},\
89                                               {{{STA}, 1}, {{P2P}, 1}}
90 #    endif
91 #  endif
92 #else
93 // V1 (fixed single interface, dual-mode chip)
94 constexpr ChipModeId kMainModeId = chip_mode_ids::kV1Sta;
95 #  ifdef WIFI_HIDL_FEATURE_AWARE
96 //   1 STA + 1 of (P2P or NAN)
97 #    define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{P2P, NAN}, 1}}
98 #  else
99 //   1 STA + 1 P2P
100 #    define WIFI_HAL_INTERFACE_COMBINATIONS {{{STA}, 1}, {{P2P}, 1}}
101 #  endif
102 
103 #  ifndef WIFI_HIDL_FEATURE_DISABLE_AP
104 #    define WIFI_HAL_INTERFACE_COMBINATIONS_AP {{{AP}, 1}}
105 #  endif
106 #endif
107 // clang-format on
108 
109 /**
110  * Helper class to convert a collection of combination limits to a combination.
111  *
112  * The main point here is to simplify the syntax required by
113  * WIFI_HAL_INTERFACE_COMBINATIONS.
114  */
115 struct ChipIfaceCombination
116     : public hidl_vec<IWifiChip::ChipIfaceCombinationLimit> {
ChipIfaceCombinationandroid::hardware::wifi::V1_4::implementation::feature_flags::ChipIfaceCombination117     ChipIfaceCombination(
118         const std::initializer_list<IWifiChip::ChipIfaceCombinationLimit> list)
119         : hidl_vec(list) {}
120 
operator IWifiChip::ChipIfaceCombinationandroid::hardware::wifi::V1_4::implementation::feature_flags::ChipIfaceCombination121     operator IWifiChip::ChipIfaceCombination() const { return {*this}; }
122 
make_vecandroid::hardware::wifi::V1_4::implementation::feature_flags::ChipIfaceCombination123     static hidl_vec<IWifiChip::ChipIfaceCombination> make_vec(
124         const std::initializer_list<ChipIfaceCombination> list) {
125         return hidl_vec<IWifiChip::ChipIfaceCombination>(  //
126             std::begin(list), std::end(list));
127     }
128 };
129 
130 #define STA IfaceType::STA
131 #define AP IfaceType::AP
132 #define P2P IfaceType::P2P
133 #define NAN IfaceType::NAN
134 static const std::vector<IWifiChip::ChipMode> kChipModes{
135     {kMainModeId,
136      ChipIfaceCombination::make_vec({WIFI_HAL_INTERFACE_COMBINATIONS})},
137 #ifdef WIFI_HAL_INTERFACE_COMBINATIONS_AP
138     {chip_mode_ids::kV1Ap,
139      ChipIfaceCombination::make_vec({WIFI_HAL_INTERFACE_COMBINATIONS_AP})},
140 #endif
141 };
142 #undef STA
143 #undef AP
144 #undef P2P
145 #undef NAN
146 
147 #ifdef WIFI_HIDL_FEATURE_DISABLE_AP_MAC_RANDOMIZATION
148 #pragma message                                                               \
149     "WIFI_HIDL_FEATURE_DISABLE_AP_MAC_RANDOMIZATION is deprecated; override " \
150     "'config_wifi_ap_randomization_supported' in "                            \
151     "frameworks/base/core/res/res/values/config.xml in the device overlay "   \
152     "instead"
153 #endif  // WIFI_HIDL_FEATURE_DISABLE_AP_MAC_RANDOMIZATION
154 
WifiFeatureFlags()155 WifiFeatureFlags::WifiFeatureFlags() {}
156 
getChipModes()157 std::vector<IWifiChip::ChipMode> WifiFeatureFlags::getChipModes() {
158     return kChipModes;
159 }
160 
161 }  // namespace feature_flags
162 }  // namespace implementation
163 }  // namespace V1_4
164 }  // namespace wifi
165 }  // namespace hardware
166 }  // namespace android
167