Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 1 | // Copyright (c) 2013 The Chromium OS Authors. All rights reserved. |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 2 | // Use of this source code is governed by a BSD-style license that can be |
| 3 | // found in the LICENSE file. |
| 4 | |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 5 | #ifndef SHILL_CELLULAR_CAPABILITY_UNIVERSAL_H_ |
| 6 | #define SHILL_CELLULAR_CAPABILITY_UNIVERSAL_H_ |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 7 | |
| 8 | #include <deque> |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 9 | #include <map> |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 10 | #include <string> |
| 11 | #include <vector> |
| 12 | |
| 13 | #include <base/memory/scoped_ptr.h> |
| 14 | #include <base/memory/weak_ptr.h> |
| 15 | #include <gtest/gtest_prod.h> // for FRIEND_TEST |
Ben Chan | 5c853ef | 2012-10-05 00:05:37 -0700 | [diff] [blame] | 16 | #include <ModemManager/ModemManager.h> |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 17 | |
| 18 | #include "shill/accessor_interface.h" |
| 19 | #include "shill/cellular.h" |
| 20 | #include "shill/cellular_capability.h" |
Ben Chan | 07193fd | 2013-07-12 22:10:55 -0700 | [diff] [blame] | 21 | #include "shill/cellular_operator_info.h" |
Arman Uguray | 6e5639f | 2012-11-15 20:30:19 -0800 | [diff] [blame] | 22 | #include "shill/mm1_bearer_proxy_interface.h" |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 23 | #include "shill/mm1_modem_modem3gpp_proxy_interface.h" |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 24 | #include "shill/mm1_modem_proxy_interface.h" |
| 25 | #include "shill/mm1_modem_simple_proxy_interface.h" |
| 26 | #include "shill/mm1_sim_proxy_interface.h" |
| 27 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 28 | struct mobile_provider; |
| 29 | |
| 30 | namespace shill { |
| 31 | |
Prathmesh Prabhu | 27526f1 | 2013-03-25 19:42:18 -0700 | [diff] [blame] | 32 | class ModemInfo; |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 33 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 34 | // CellularCapabilityUniversal handles modems using the |
| 35 | // org.chromium.ModemManager1 DBUS interface. This class is used for |
| 36 | // all types of modems, i.e. CDMA, GSM, and LTE modems. |
| 37 | class CellularCapabilityUniversal : public CellularCapability { |
| 38 | public: |
| 39 | typedef std::vector<DBusPropertiesMap> ScanResults; |
| 40 | typedef DBusPropertiesMap ScanResult; |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 41 | typedef std::map<uint32_t, uint32_t> LockRetryData; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 42 | |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 43 | // Constants used in connect method call. Make available to test matchers. |
| 44 | // TODO(jglasgow): Generate from modem manager into |
| 45 | // ModemManager-names.h. |
Paul Stewart | ee6b3d7 | 2013-07-12 16:07:51 -0700 | [diff] [blame] | 46 | // See http://crbug.com/212909. |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 47 | static const char kConnectPin[]; |
| 48 | static const char kConnectOperatorId[]; |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 49 | static const char kConnectApn[]; |
| 50 | static const char kConnectIPType[]; |
| 51 | static const char kConnectUser[]; |
| 52 | static const char kConnectPassword[]; |
| 53 | static const char kConnectNumber[]; |
| 54 | static const char kConnectAllowRoaming[]; |
| 55 | static const char kConnectRMProtocol[]; |
| 56 | |
Thieu Le | ce4483e | 2013-01-23 15:12:03 -0800 | [diff] [blame] | 57 | CellularCapabilityUniversal(Cellular *cellular, |
| 58 | ProxyFactory *proxy_factory, |
Prathmesh Prabhu | 27526f1 | 2013-03-25 19:42:18 -0700 | [diff] [blame] | 59 | ModemInfo *modem_info); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 60 | |
| 61 | // Inherited from CellularCapability. |
Gary Morain | e285a84 | 2012-08-15 08:23:57 -0700 | [diff] [blame] | 62 | // Checks the modem state. If the state is kModemStateDisabled, then the |
| 63 | // modem is enabled. Otherwise, the enable command is buffered until the |
| 64 | // modem becomes disabled. ModemManager rejects the enable command if the |
| 65 | // modem is not disabled, for exmaple, if it is initializing insted. |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 66 | virtual void StartModem(Error *error, const ResultCallback &callback); |
| 67 | virtual void StopModem(Error *error, const ResultCallback &callback); |
| 68 | virtual void Connect(const DBusPropertiesMap &properties, Error *error, |
| 69 | const ResultCallback &callback); |
| 70 | virtual void Disconnect(Error *error, const ResultCallback &callback); |
Christopher Wiley | 8a46890 | 2012-11-30 11:52:38 -0800 | [diff] [blame] | 71 | virtual void DisconnectCleanup(); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 72 | virtual void Activate(const std::string &carrier, |
| 73 | Error *error, const ResultCallback &callback); |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 74 | virtual void CompleteActivation(Error *error); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 75 | |
| 76 | virtual void OnServiceCreated(); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 77 | virtual void SetupConnectProperties(DBusPropertiesMap *properties); |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 78 | virtual void GetProperties(); |
Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 79 | virtual bool IsRegistered(); |
Ben Chan | 1578603 | 2012-11-04 21:28:02 -0800 | [diff] [blame] | 80 | virtual bool IsServiceActivationRequired() const; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 81 | virtual void Register(const ResultCallback &callback); |
| 82 | |
| 83 | virtual void RegisterOnNetwork(const std::string &network_id, |
| 84 | Error *error, |
| 85 | const ResultCallback &callback); |
Eric Shienbrood | 7fce52c | 2012-04-13 19:11:02 -0400 | [diff] [blame] | 86 | virtual void SetUnregistered(bool searching); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 87 | virtual std::string CreateFriendlyServiceName(); |
| 88 | virtual void RequirePIN(const std::string &pin, bool require, |
| 89 | Error *error, const ResultCallback &callback); |
| 90 | virtual void EnterPIN(const std::string &pin, |
| 91 | Error *error, const ResultCallback &callback); |
| 92 | virtual void UnblockPIN(const std::string &unblock_code, |
| 93 | const std::string &pin, |
| 94 | Error *error, const ResultCallback &callback); |
| 95 | virtual void ChangePIN(const std::string &old_pin, |
| 96 | const std::string &new_pin, |
| 97 | Error *error, const ResultCallback &callback); |
Ben Chan | 5d0d32c | 2013-01-08 02:05:29 -0800 | [diff] [blame] | 98 | virtual void Reset(Error *error, const ResultCallback &callback); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 99 | |
| 100 | virtual void Scan(Error *error, const ResultCallback &callback); |
| 101 | virtual std::string GetNetworkTechnologyString() const; |
| 102 | virtual std::string GetRoamingStateString() const; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 103 | virtual void GetSignalQuality(); |
Jason Glasgow | 9f09aef | 2012-05-08 16:26:55 -0400 | [diff] [blame] | 104 | virtual std::string GetTypeString() const; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 105 | virtual void OnDBusPropertiesChanged( |
| 106 | const std::string &interface, |
| 107 | const DBusPropertiesMap &changed_properties, |
| 108 | const std::vector<std::string> &invalidated_properties); |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 109 | virtual bool AllowRoaming(); |
Arman Uguray | f84a424 | 2013-04-09 20:01:07 -0700 | [diff] [blame] | 110 | virtual bool ShouldDetectOutOfCredit() const; |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 111 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 112 | protected: |
| 113 | virtual void InitProxies(); |
| 114 | virtual void ReleaseProxies(); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 115 | |
Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 116 | // Updates the |sim_path_| variable and creates a new proxy to the |
| 117 | // DBUS ModemManager1.Sim interface. |
| 118 | // TODO(armansito): Put this method in a 3GPP-only subclass. |
| 119 | virtual void OnSimPathChanged(const std::string &sim_path); |
| 120 | |
| 121 | // Updates the online payment portal information, if any, for the cellular |
| 122 | // provider. |
| 123 | virtual void UpdateOLP(); |
| 124 | |
Arman Uguray | 0a3e279 | 2013-01-17 16:31:50 -0800 | [diff] [blame] | 125 | // Post-payment activation handlers. |
| 126 | virtual void UpdatePendingActivationState(); |
| 127 | |
Ben Chan | 07193fd | 2013-07-12 22:10:55 -0700 | [diff] [blame] | 128 | // Returns the operator-specific form of |mdn_|, which is passed to the online |
| 129 | // payment portal of a cellular operator. |
| 130 | std::string GetMdnForOLP( |
| 131 | const CellularOperatorInfo::CellularOperator &cellular_operator) const; |
| 132 | |
Arman Uguray | 0a3e279 | 2013-01-17 16:31:50 -0800 | [diff] [blame] | 133 | const std::string &mdn() const { return mdn_; } |
| 134 | void set_mdn(const std::string &mdn) { mdn_ = mdn; } |
| 135 | |
| 136 | const std::string &min() const { return min_; } |
| 137 | void set_min(const std::string &min) { min_ = min; } |
Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 138 | |
| 139 | const std::string &meid() const { return meid_; } |
| 140 | void set_meid(const std::string &meid) { meid_ = meid; } |
| 141 | |
| 142 | const std::string &esn() const { return esn_; } |
| 143 | void set_esn(const std::string &esn) { esn_ = esn; } |
| 144 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 145 | private: |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 146 | struct ModemModes { |
| 147 | ModemModes() |
| 148 | : allowed_modes(MM_MODEM_MODE_NONE), |
| 149 | preferred_mode(MM_MODEM_MODE_NONE) {} |
| 150 | |
| 151 | ModemModes(uint32 allowed, MMModemMode preferred) |
| 152 | : allowed_modes(allowed), |
| 153 | preferred_mode(preferred) {} |
| 154 | |
| 155 | uint32 allowed_modes; // Bits based on MMModemMode. |
| 156 | MMModemMode preferred_mode; // A single MMModemMode bit. |
| 157 | }; |
| 158 | |
Jason Glasgow | cd0349c | 2012-05-03 23:32:15 -0400 | [diff] [blame] | 159 | // Constants used in scan results. Make available to unit tests. |
| 160 | // TODO(jglasgow): Generate from modem manager into ModemManager-names.h. |
Paul Stewart | ee6b3d7 | 2013-07-12 16:07:51 -0700 | [diff] [blame] | 161 | // See http://crbug.com/212909. |
Jason Glasgow | cd0349c | 2012-05-03 23:32:15 -0400 | [diff] [blame] | 162 | static const char kStatusProperty[]; |
| 163 | static const char kOperatorLongProperty[]; |
| 164 | static const char kOperatorShortProperty[]; |
| 165 | static const char kOperatorCodeProperty[]; |
| 166 | static const char kOperatorAccessTechnologyProperty[]; |
| 167 | |
mukesh agrawal | 9da0777 | 2013-05-15 14:15:17 -0700 | [diff] [blame] | 168 | // As above, consider having this in ModemManager-names.h. |
| 169 | static const char kIpConfigPropertyMethod[]; |
| 170 | |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 171 | // Modem Model ID strings. From modem firmware via modemmanager. |
| 172 | static const char kE362ModelId[]; |
| 173 | |
Arman Uguray | 2717a10 | 2013-01-29 23:36:06 -0800 | [diff] [blame] | 174 | // Generic service name prefix, shown when the correct carrier name is |
| 175 | // unknown. |
| 176 | static const char kGenericServiceNamePrefix[]; |
| 177 | |
Arman Uguray | a14941d | 2013-04-12 16:58:26 -0700 | [diff] [blame] | 178 | static const int64 kActivationRegistrationTimeoutMilliseconds; |
| 179 | static const int64 kDefaultScanningOrSearchingTimeoutMilliseconds; |
Arman Uguray | f6366ac | 2013-06-12 16:02:28 -0700 | [diff] [blame] | 180 | static const int64 kEnterPinTimeoutMilliseconds; |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 181 | static const int64 kRegistrationDroppedUpdateTimeoutMilliseconds; |
Thieu Le | 2cac294 | 2013-03-05 18:41:08 -0800 | [diff] [blame] | 182 | static const int kSetPowerStateTimeoutMilliseconds; |
Arman Uguray | ee464d3 | 2013-02-13 17:14:36 -0800 | [diff] [blame] | 183 | |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 184 | |
Arman Uguray | 6552f8c | 2013-02-12 15:33:18 -0800 | [diff] [blame] | 185 | // Root path. The SIM path is reported by ModemManager to be the root path |
| 186 | // when no SIM is present. |
| 187 | static const char kRootPath[]; |
| 188 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 189 | friend class CellularTest; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 190 | friend class CellularCapabilityTest; |
Thieu Le | 3d27539 | 2012-07-20 15:32:58 -0700 | [diff] [blame] | 191 | friend class CellularCapabilityUniversalTest; |
Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 192 | friend class CellularCapabilityUniversalCDMATest; |
Arman Uguray | 0a3e279 | 2013-01-17 16:31:50 -0800 | [diff] [blame] | 193 | FRIEND_TEST(CellularCapabilityUniversalCDMAMainTest, PropertiesChanged); |
| 194 | FRIEND_TEST(CellularCapabilityUniversalCDMAMainTest, UpdateOLP); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 195 | FRIEND_TEST(CellularCapabilityUniversalMainTest, AllowRoaming); |
Arman Uguray | a14941d | 2013-04-12 16:58:26 -0700 | [diff] [blame] | 196 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
| 197 | ActivationWaitForRegisterTimeout); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 198 | FRIEND_TEST(CellularCapabilityUniversalMainTest, Connect); |
| 199 | FRIEND_TEST(CellularCapabilityUniversalMainTest, ConnectApns); |
| 200 | FRIEND_TEST(CellularCapabilityUniversalMainTest, CreateFriendlyServiceName); |
| 201 | FRIEND_TEST(CellularCapabilityUniversalMainTest, DisconnectNoProxy); |
Arman Uguray | 7af0fac | 2013-03-18 17:35:35 -0700 | [diff] [blame] | 202 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 203 | DisconnectWithDeferredCallback); |
| 204 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Arman Uguray | 7af0fac | 2013-03-18 17:35:35 -0700 | [diff] [blame] | 205 | GetNetworkTechnologyStringOnE362); |
Ben Chan | 07193fd | 2013-07-12 22:10:55 -0700 | [diff] [blame] | 206 | FRIEND_TEST(CellularCapabilityUniversalMainTest, GetMdnForOLP); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 207 | FRIEND_TEST(CellularCapabilityUniversalMainTest, GetTypeString); |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 208 | FRIEND_TEST(CellularCapabilityUniversalMainTest, IsMdnValid); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 209 | FRIEND_TEST(CellularCapabilityUniversalMainTest, IsServiceActivationRequired); |
Arman Uguray | 6552f8c | 2013-02-12 15:33:18 -0800 | [diff] [blame] | 210 | FRIEND_TEST(CellularCapabilityUniversalMainTest, IsValidSimPath); |
Ben Chan | d759252 | 2013-02-13 16:02:01 -0800 | [diff] [blame] | 211 | FRIEND_TEST(CellularCapabilityUniversalMainTest, NormalizeMdn); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 212 | FRIEND_TEST(CellularCapabilityUniversalMainTest, OnListBearersReply); |
Arman Uguray | c7e63af | 2013-06-13 17:07:32 -0700 | [diff] [blame] | 213 | FRIEND_TEST(CellularCapabilityUniversalMainTest, OnLockRetriesChanged); |
| 214 | FRIEND_TEST(CellularCapabilityUniversalMainTest, OnLockTypeChanged); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 215 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Ben Chan | fcca27b | 2013-01-22 15:03:44 -0800 | [diff] [blame] | 216 | OnModemCurrentCapabilitiesChanged); |
Arman Uguray | c7e63af | 2013-06-13 17:07:32 -0700 | [diff] [blame] | 217 | FRIEND_TEST(CellularCapabilityUniversalMainTest, OnSimLockPropertiesChanged); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 218 | FRIEND_TEST(CellularCapabilityUniversalMainTest, PropertiesChanged); |
| 219 | FRIEND_TEST(CellularCapabilityUniversalMainTest, Reset); |
| 220 | FRIEND_TEST(CellularCapabilityUniversalMainTest, Scan); |
| 221 | FRIEND_TEST(CellularCapabilityUniversalMainTest, ScanFailure); |
| 222 | FRIEND_TEST(CellularCapabilityUniversalMainTest, SetHomeProvider); |
Arman Uguray | d42d8ec | 2013-04-08 19:28:21 -0700 | [diff] [blame] | 223 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Arman Uguray | f84a424 | 2013-04-09 20:01:07 -0700 | [diff] [blame] | 224 | ShouldDetectOutOfCredit); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 225 | FRIEND_TEST(CellularCapabilityUniversalMainTest, SimLockStatusChanged); |
Arman Uguray | c7e63af | 2013-06-13 17:07:32 -0700 | [diff] [blame] | 226 | FRIEND_TEST(CellularCapabilityUniversalMainTest, SimLockStatusToProperty); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 227 | FRIEND_TEST(CellularCapabilityUniversalMainTest, SimPathChanged); |
| 228 | FRIEND_TEST(CellularCapabilityUniversalMainTest, SimPropertiesChanged); |
| 229 | FRIEND_TEST(CellularCapabilityUniversalMainTest, StartModem); |
| 230 | FRIEND_TEST(CellularCapabilityUniversalMainTest, StopModem); |
| 231 | FRIEND_TEST(CellularCapabilityUniversalMainTest, StopModemConnected); |
Arman Uguray | 0a3e279 | 2013-01-17 16:31:50 -0800 | [diff] [blame] | 232 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
| 233 | UpdatePendingActivationState); |
Arman Uguray | efea6e0 | 2013-02-21 13:28:04 -0800 | [diff] [blame] | 234 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 235 | UpdateRegistrationState); |
| 236 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
| 237 | UpdateRegistrationStateModemNotConnected); |
| 238 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
Arman Uguray | efea6e0 | 2013-02-21 13:28:04 -0800 | [diff] [blame] | 239 | UpdateServiceActivationState); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 240 | FRIEND_TEST(CellularCapabilityUniversalMainTest, UpdateServiceName); |
| 241 | FRIEND_TEST(CellularCapabilityUniversalMainTest, UpdateStorageIdentifier); |
| 242 | FRIEND_TEST(CellularCapabilityUniversalMainTest, UpdateOLP); |
| 243 | FRIEND_TEST(CellularCapabilityUniversalMainTest, UpdateOperatorInfo); |
| 244 | FRIEND_TEST(CellularCapabilityUniversalMainTest, |
| 245 | UpdateOperatorInfoViaOperatorId); |
| 246 | FRIEND_TEST(CellularCapabilityUniversalMainTest, UpdateScanningProperty); |
Arman Uguray | a14941d | 2013-04-12 16:58:26 -0700 | [diff] [blame] | 247 | FRIEND_TEST(CellularCapabilityUniversalTimerTest, CompleteActivation); |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 248 | FRIEND_TEST(CellularCapabilityUniversalTimerTest, |
| 249 | UpdateScanningPropertyTimeout); |
Arman Uguray | d42d8ec | 2013-04-08 19:28:21 -0700 | [diff] [blame] | 250 | FRIEND_TEST(CellularTest, EnableTrafficMonitor); |
Ben Chan | 09fa2a0 | 2012-11-07 22:09:09 -0800 | [diff] [blame] | 251 | FRIEND_TEST(CellularTest, |
| 252 | HandleNewRegistrationStateForServiceRequiringActivation); |
Thieu Le | 5218cf2 | 2012-11-26 11:52:57 -0800 | [diff] [blame] | 253 | FRIEND_TEST(CellularTest, ModemStateChangeLostRegistration); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 254 | |
Arman Uguray | c7e63af | 2013-06-13 17:07:32 -0700 | [diff] [blame] | 255 | // SimLockStatus represents the fields in the Cellular.SIMLockStatus |
| 256 | // DBUS property of the shill device. |
| 257 | struct SimLockStatus { |
| 258 | public: |
| 259 | SimLockStatus() : enabled(false), |
| 260 | lock_type(MM_MODEM_LOCK_UNKNOWN), |
| 261 | retries_left(0) {} |
| 262 | |
| 263 | bool enabled; |
| 264 | MMModemLock lock_type; |
| 265 | uint32 retries_left; |
| 266 | }; |
| 267 | |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 268 | // Methods used in starting a modem |
Gary Morain | e285a84 | 2012-08-15 08:23:57 -0700 | [diff] [blame] | 269 | void EnableModem(Error *error, const ResultCallback &callback); |
Thieu Le | b9c05e0 | 2013-03-04 14:09:32 -0800 | [diff] [blame] | 270 | void Start_ModemAlreadyEnabled(const ResultCallback &callback); |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 271 | void Start_EnableModemCompleted(const ResultCallback &callback, |
| 272 | const Error &error); |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 273 | |
| 274 | // Methods used in stopping a modem |
| 275 | void Stop_DisconnectCompleted(const ResultCallback &callback, |
| 276 | const Error &error); |
| 277 | void Stop_Disable(const ResultCallback &callback); |
| 278 | void Stop_DisableCompleted(const ResultCallback &callback, |
| 279 | const Error &error); |
Arman Uguray | ee464d3 | 2013-02-13 17:14:36 -0800 | [diff] [blame] | 280 | void Stop_PowerDown(const ResultCallback &callback); |
| 281 | void Stop_PowerDownCompleted(const ResultCallback &callback, |
| 282 | const Error &error); |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 283 | |
Arman Uguray | 2717a10 | 2013-01-29 23:36:06 -0800 | [diff] [blame] | 284 | // Updates the name property that is exposed by the service to Chrome. |
| 285 | void UpdateServiceName(); |
| 286 | |
Ben Chan | 8a2c01e | 2013-01-23 10:09:14 -0800 | [diff] [blame] | 287 | void UpdateScanningProperty(); |
| 288 | |
Arman Uguray | d73783f | 2013-01-31 16:11:21 -0800 | [diff] [blame] | 289 | // Methods used in acquiring information related to the carrier; |
| 290 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 291 | // Updates the Universal operator name and country based on a newly |
| 292 | // obtained network id. |
| 293 | void UpdateOperatorInfo(); |
| 294 | |
Arman Uguray | d73783f | 2013-01-31 16:11:21 -0800 | [diff] [blame] | 295 | // Sets the upper level information about the home cellular provider from the |
| 296 | // modem's IMSI and SPN. |
| 297 | void SetHomeProvider(); |
| 298 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 299 | // Updates the serving operator on the active service. |
| 300 | void UpdateServingOperator(); |
| 301 | |
Arman Uguray | d73783f | 2013-01-31 16:11:21 -0800 | [diff] [blame] | 302 | // Initializes the |apn_list_| property based on the current |home_provider_|. |
| 303 | void InitAPNList(); |
| 304 | |
Arman Uguray | 6e5639f | 2012-11-15 20:30:19 -0800 | [diff] [blame] | 305 | // Updates |bearer_path_| to match the currently active bearer. |
| 306 | void UpdateBearerPath(); |
| 307 | |
Arman Uguray | c953357 | 2013-01-22 17:34:20 -0800 | [diff] [blame] | 308 | // Updates the storage identifier used for the current cellular service. |
| 309 | void UpdateStorageIdentifier(); |
| 310 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 311 | |
| 312 | Stringmap ParseScanResult(const ScanResult &result); |
| 313 | |
| 314 | KeyValueStore SimLockStatusToProperty(Error *error); |
| 315 | |
| 316 | void SetupApnTryList(); |
| 317 | void FillConnectPropertyMap(DBusPropertiesMap *properties); |
| 318 | |
mukesh agrawal | bebf1b8 | 2013-04-23 15:06:33 -0700 | [diff] [blame] | 319 | void HelpRegisterConstDerivedKeyValueStore( |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 320 | const std::string &name, |
mukesh agrawal | bebf1b8 | 2013-04-23 15:06:33 -0700 | [diff] [blame] | 321 | KeyValueStore(CellularCapabilityUniversal::*get)(Error *error)); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 322 | |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 323 | // Returns true if a connect error should be retried. This function |
| 324 | // abstracts modem specific behavior for modems which do a lousy job |
| 325 | // of returning specific errors on connect failures. |
| 326 | bool RetriableConnectError(const Error &error) const; |
| 327 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 328 | // Signal callbacks |
Nathan Williams | 3022be5 | 2012-04-19 17:40:49 -0400 | [diff] [blame] | 329 | void OnNetworkModeSignal(uint32 mode); |
Eric Shienbrood | 7fce52c | 2012-04-13 19:11:02 -0400 | [diff] [blame] | 330 | void OnModemStateChangedSignal(int32 old_state, |
| 331 | int32 new_state, |
| 332 | uint32 reason); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 333 | |
| 334 | // Property Change notification handlers |
Nathan Williams | 3022be5 | 2012-04-19 17:40:49 -0400 | [diff] [blame] | 335 | void OnModemPropertiesChanged( |
Jason Glasgow | 4c0724a | 2012-04-17 15:47:40 -0400 | [diff] [blame] | 336 | const DBusPropertiesMap &properties, |
| 337 | const std::vector<std::string> &invalidated_properties); |
| 338 | |
Nathan Williams | 3022be5 | 2012-04-19 17:40:49 -0400 | [diff] [blame] | 339 | void OnSignalQualityChanged(uint32 quality); |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 340 | |
| 341 | void OnSupportedCapabilitesChanged( |
| 342 | const std::vector<uint32> &supported_capabilities); |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 343 | void OnModemCurrentCapabilitiesChanged(uint32 current_capabilities); |
| 344 | void OnMdnChanged(const std::string &mdn); |
| 345 | void OnModemManufacturerChanged(const std::string &manufacturer); |
| 346 | void OnModemModelChanged(const std::string &model); |
| 347 | void OnModemRevisionChanged(const std::string &revision); |
| 348 | void OnModemStateChanged(Cellular::ModemState state); |
| 349 | void OnAccessTechnologiesChanged(uint32 access_technologies); |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 350 | void OnSupportedModesChanged(const std::vector<ModemModes> &supported_modes); |
| 351 | void OnCurrentModesChanged(const ModemModes ¤t_modes); |
Arman Uguray | c7e63af | 2013-06-13 17:07:32 -0700 | [diff] [blame] | 352 | void OnLockRetriesChanged(const LockRetryData &lock_retries); |
| 353 | void OnLockTypeChanged(MMModemLock unlock_required); |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 354 | void OnSimLockStatusChanged(); |
| 355 | |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 356 | // Returns false if the MDN is empty or if the MDN consists of all 0s. |
| 357 | bool IsMdnValid() const; |
| 358 | |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 359 | // 3GPP property change handlers |
| 360 | virtual void OnModem3GPPPropertiesChanged( |
| 361 | const DBusPropertiesMap &properties, |
| 362 | const std::vector<std::string> &invalidated_properties); |
| 363 | void OnImeiChanged(const std::string &imei); |
| 364 | void On3GPPRegistrationChanged(MMModem3gppRegistrationState state, |
| 365 | const std::string &operator_code, |
| 366 | const std::string &operator_name); |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 367 | void Handle3GPPRegistrationChange( |
| 368 | MMModem3gppRegistrationState updated_state, |
| 369 | std::string updated_operator_code, |
| 370 | std::string updated_operator_name); |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 371 | void OnFacilityLocksChanged(uint32 locks); |
| 372 | |
| 373 | // SIM property change handlers |
Arman Uguray | 72fab6a | 2013-01-10 19:32:42 -0800 | [diff] [blame] | 374 | // TODO(armansito): Put these methods in a 3GPP-only subclass. |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 375 | void OnSimPropertiesChanged( |
| 376 | const DBusPropertiesMap &props, |
| 377 | const std::vector<std::string> &invalidated_properties); |
| 378 | void OnImsiChanged(const std::string &imsi); |
Arman Uguray | d73783f | 2013-01-31 16:11:21 -0800 | [diff] [blame] | 379 | void OnSpnChanged(const std::string &spn); |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 380 | void OnSimIdentifierChanged(const std::string &id); |
| 381 | void OnOperatorIdChanged(const std::string &operator_id); |
| 382 | void OnOperatorNameChanged(const std::string &operator_name); |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 383 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 384 | // Method callbacks |
Nathan Williams | 3022be5 | 2012-04-19 17:40:49 -0400 | [diff] [blame] | 385 | void OnRegisterReply(const ResultCallback &callback, |
| 386 | const Error &error); |
Ben Chan | 5d0d32c | 2013-01-08 02:05:29 -0800 | [diff] [blame] | 387 | void OnResetReply(const ResultCallback &callback, const Error &error); |
Nathan Williams | 3022be5 | 2012-04-19 17:40:49 -0400 | [diff] [blame] | 388 | void OnScanReply(const ResultCallback &callback, |
| 389 | const ScanResults &results, |
| 390 | const Error &error); |
Nathan Williams | b54974f | 2012-04-19 11:16:30 -0400 | [diff] [blame] | 391 | void OnConnectReply(const ResultCallback &callback, |
| 392 | const DBus::Path &bearer, |
| 393 | const Error &error); |
Arman Uguray | 6e5639f | 2012-11-15 20:30:19 -0800 | [diff] [blame] | 394 | void OnListBearersReply(const std::vector<DBus::Path> &paths, |
| 395 | const Error &error); |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 396 | |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 397 | // Timeout callback for the network scan initiated when Cellular connectivity |
| 398 | // gets enabled. |
| 399 | void OnScanningOrSearchingTimeout(); |
| 400 | |
Arman Uguray | a14941d | 2013-04-12 16:58:26 -0700 | [diff] [blame] | 401 | // Timeout callback that is called if the modem takes too long to register to |
| 402 | // a network after online payment is complete. Resets the modem. |
| 403 | void OnActivationWaitForRegisterTimeout(); |
| 404 | |
Arman Uguray | 6552f8c | 2013-02-12 15:33:18 -0800 | [diff] [blame] | 405 | // Returns true, if |sim_path| constitutes a valid SIM path. Currently, a |
| 406 | // path is accepted to be valid, as long as it is not equal to one of "" |
| 407 | // and "/". |
| 408 | bool IsValidSimPath(const std::string &sim_path) const; |
| 409 | |
Ben Chan | d759252 | 2013-02-13 16:02:01 -0800 | [diff] [blame] | 410 | // Returns the normalized version of |mdn| by keeping only digits in |mdn| |
| 411 | // and removing other non-digit characters. |
| 412 | std::string NormalizeMdn(const std::string &mdn) const; |
| 413 | |
Arman Uguray | 2717a10 | 2013-01-29 23:36:06 -0800 | [diff] [blame] | 414 | static std::string GenerateNewGenericServiceName(); |
| 415 | |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 416 | // Post-payment activation handlers. |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 417 | void ResetAfterActivation(); |
Arman Uguray | efea6e0 | 2013-02-21 13:28:04 -0800 | [diff] [blame] | 418 | void UpdateServiceActivationState(); |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 419 | void OnResetAfterActivationReply(const Error &error); |
| 420 | |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 421 | static bool IsRegisteredState(MMModem3gppRegistrationState state); |
| 422 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 423 | scoped_ptr<mm1::ModemModem3gppProxyInterface> modem_3gpp_proxy_; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 424 | scoped_ptr<mm1::ModemProxyInterface> modem_proxy_; |
| 425 | scoped_ptr<mm1::ModemSimpleProxyInterface> modem_simple_proxy_; |
| 426 | scoped_ptr<mm1::SimProxyInterface> sim_proxy_; |
| 427 | |
| 428 | base::WeakPtrFactory<CellularCapabilityUniversal> weak_ptr_factory_; |
| 429 | |
| 430 | MMModem3gppRegistrationState registration_state_; |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 431 | |
| 432 | // Bits based on MMModemCapabilities |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 433 | std::vector<uint32> supported_capabilities_; // Technologies supported |
| 434 | uint32 current_capabilities_; // Technologies supported without a reload |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 435 | uint32 access_technologies_; // Bits based on MMModemAccessTechnology |
Ben Chan | 74924d8 | 2013-06-15 17:52:55 -0700 | [diff] [blame] | 436 | std::vector<ModemModes> supported_modes_; |
| 437 | ModemModes current_modes_; |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 438 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 439 | Cellular::Operator serving_operator_; |
| 440 | std::string spn_; |
Jason Glasgow | af58328 | 2012-04-18 15:18:22 -0400 | [diff] [blame] | 441 | std::string sim_identifier_; |
| 442 | std::string operator_id_; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 443 | mobile_provider *home_provider_; |
Darin Petkov | f508c82 | 2012-09-21 13:43:17 +0200 | [diff] [blame] | 444 | bool provider_requires_roaming_; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 445 | std::string desired_network_; |
| 446 | |
| 447 | // Properties. |
| 448 | std::string carrier_; |
| 449 | std::string esn_; |
| 450 | std::string firmware_revision_; |
| 451 | std::string hardware_revision_; |
| 452 | std::string imei_; |
| 453 | std::string imsi_; |
| 454 | std::string manufacturer_; |
| 455 | std::string mdn_; |
| 456 | std::string meid_; |
| 457 | std::string min_; |
| 458 | std::string model_id_; |
| 459 | std::string selected_network_; |
| 460 | Stringmaps found_networks_; |
| 461 | std::deque<Stringmap> apn_try_list_; |
Ben Chan | 5d0d32c | 2013-01-08 02:05:29 -0800 | [diff] [blame] | 462 | bool resetting_; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 463 | bool scanning_supported_; |
| 464 | bool scanning_; |
Ben Chan | 8a2c01e | 2013-01-23 10:09:14 -0800 | [diff] [blame] | 465 | bool scanning_or_searching_; |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 466 | uint16 scan_interval_; |
| 467 | SimLockStatus sim_lock_status_; |
| 468 | Stringmaps apn_list_; |
Jason Glasgow | ef96556 | 2012-04-10 16:12:35 -0400 | [diff] [blame] | 469 | std::string sim_path_; |
Ben Chan | bd3aee8 | 2012-10-16 23:52:04 -0700 | [diff] [blame] | 470 | bool sim_present_; |
Nathan Williams | b54974f | 2012-04-19 11:16:30 -0400 | [diff] [blame] | 471 | DBus::Path bearer_path_; |
Arman Uguray | c7b1560 | 2013-02-16 00:56:18 -0800 | [diff] [blame] | 472 | bool reset_done_; |
| 473 | |
Gary Morain | e285a84 | 2012-08-15 08:23:57 -0700 | [diff] [blame] | 474 | // If the modem is not in a state to be enabled when StartModem is called, |
| 475 | // enabling is deferred using this callback. |
| 476 | base::Closure deferred_enable_modem_callback_; |
| 477 | |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 478 | // Sometimes modems may be stuck in the SEARCHING state during the lack of |
| 479 | // presence of a network. During this indefinite duration of time, keeping |
| 480 | // the Device.Scanning property as |true| causes a bad user experience. |
| 481 | // This callback sets it to |false| after a timeout period has passed. |
| 482 | base::CancelableClosure scanning_or_searching_timeout_callback_; |
Arman Uguray | a14941d | 2013-04-12 16:58:26 -0700 | [diff] [blame] | 483 | int64 scanning_or_searching_timeout_milliseconds_; |
| 484 | |
| 485 | base::CancelableClosure activation_wait_for_registration_callback_; |
| 486 | int64 activation_registration_timeout_milliseconds_; |
Arman Uguray | 1361c03 | 2013-02-11 17:53:39 -0800 | [diff] [blame] | 487 | |
Prathmesh Prabhu | 8f6479f | 2013-05-15 12:56:13 -0700 | [diff] [blame] | 488 | // Sometimes flaky cellular network causes the 3GPP registration state to |
| 489 | // rapidly change from registered --> searching and back. Delay such updates |
| 490 | // a little to smooth over temporary registration loss. |
| 491 | base::CancelableClosure registration_dropped_update_callback_; |
| 492 | int64 registration_dropped_update_timeout_milliseconds_; |
| 493 | |
Jason Glasgow | 82f9ab3 | 2012-04-04 14:27:19 -0400 | [diff] [blame] | 494 | static unsigned int friendly_service_name_id_; |
| 495 | |
| 496 | DISALLOW_COPY_AND_ASSIGN(CellularCapabilityUniversal); |
| 497 | }; |
| 498 | |
| 499 | } // namespace shill |
| 500 | |
Jason Glasgow | 1452187 | 2012-05-07 19:12:15 -0400 | [diff] [blame] | 501 | #endif // SHILL_CELLULAR_CAPABILITY_UNIVERSAL_H_ |