2 * Copyright (C) 2008 The Android Open Source Project
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
17 package com.android.settings;
19 import android.app.Activity;
20 import android.app.Dialog;
21 import android.bluetooth.BluetoothAdapter;
22 import android.bluetooth.BluetoothPan;
23 import android.bluetooth.BluetoothProfile;
24 import android.content.BroadcastReceiver;
25 import android.content.Context;
26 import android.content.DialogInterface;
27 import android.content.Intent;
28 import android.content.IntentFilter;
29 import android.content.pm.PackageManager;
30 import android.hardware.usb.UsbManager;
31 import android.net.ConnectivityManager;
32 import android.net.wifi.WifiConfiguration;
33 import android.net.wifi.WifiManager;
34 import android.os.Bundle;
35 import android.os.Environment;
36 import android.os.Handler;
37 import android.os.UserManager;
38 import android.support.v14.preference.SwitchPreference;
39 import android.support.v7.preference.Preference;
40 import android.util.Log;
42 import com.android.internal.logging.nano.MetricsProto.MetricsEvent;
43 import com.android.settings.datausage.DataSaverBackend;
44 import com.android.settings.wifi.WifiApDialog;
45 import com.android.settings.wifi.WifiApEnabler;
46 import com.android.settingslib.TetherUtil;
48 import java.lang.ref.WeakReference;
49 import java.util.ArrayList;
50 import java.util.concurrent.atomic.AtomicReference;
52 import static android.net.ConnectivityManager.TETHERING_BLUETOOTH;
53 import static android.net.ConnectivityManager.TETHERING_USB;
54 import static android.net.ConnectivityManager.TETHERING_WIFI;
57 * Displays preferences for Tethering.
59 public class TetherSettings extends RestrictedSettingsFragment
60 implements DialogInterface.OnClickListener, Preference.OnPreferenceChangeListener,
61 DataSaverBackend.Listener {
63 private static final String USB_TETHER_SETTINGS = "usb_tether_settings";
64 private static final String ENABLE_WIFI_AP = "enable_wifi_ap";
65 private static final String ENABLE_BLUETOOTH_TETHERING = "enable_bluetooth_tethering";
66 private static final String TETHER_CHOICE = "TETHER_TYPE";
67 private static final String DATA_SAVER_FOOTER = "disabled_on_data_saver";
69 private static final int DIALOG_AP_SETTINGS = 1;
71 private static final String TAG = "TetheringSettings";
73 private SwitchPreference mUsbTether;
75 private WifiApEnabler mWifiApEnabler;
76 private SwitchPreference mEnableWifiAp;
78 private SwitchPreference mBluetoothTether;
80 private BroadcastReceiver mTetherChangeReceiver;
82 private String[] mUsbRegexs;
84 private String[] mWifiRegexs;
86 private String[] mBluetoothRegexs;
87 private AtomicReference<BluetoothPan> mBluetoothPan = new AtomicReference<BluetoothPan>();
89 private Handler mHandler = new Handler();
90 private OnStartTetheringCallback mStartTetheringCallback;
92 private static final String WIFI_AP_SSID_AND_SECURITY = "wifi_ap_ssid_and_security";
93 private static final int CONFIG_SUBTEXT = R.string.wifi_tether_configure_subtext;
95 private String[] mSecurityType;
96 private Preference mCreateNetwork;
98 private WifiApDialog mDialog;
99 private WifiManager mWifiManager;
100 private WifiConfiguration mWifiConfig = null;
101 private ConnectivityManager mCm;
103 private boolean mRestartWifiApAfterConfigChange;
105 private boolean mUsbConnected;
106 private boolean mMassStorageActive;
108 private boolean mBluetoothEnableForTether;
110 /* Stores the package name and the class name of the provisioning app */
111 private String[] mProvisionApp;
112 private static final int PROVISION_REQUEST = 0;
114 private boolean mUnavailable;
116 private DataSaverBackend mDataSaverBackend;
117 private boolean mDataSaverEnabled;
118 private Preference mDataSaverFooter;
121 public int getMetricsCategory() {
122 return MetricsEvent.TETHER;
125 public TetherSettings() {
126 super(UserManager.DISALLOW_CONFIG_TETHERING);
130 public void onCreate(Bundle icicle) {
131 super.onCreate(icicle);
133 addPreferencesFromResource(R.xml.tether_prefs);
134 mFooterPreferenceMixin.createFooterPreference()
135 .setTitle(R.string.tethering_footer_info);
137 mDataSaverBackend = new DataSaverBackend(getContext());
138 mDataSaverEnabled = mDataSaverBackend.isDataSaverEnabled();
139 mDataSaverFooter = findPreference(DATA_SAVER_FOOTER);
141 setIfOnlyAvailableForAdmins(true);
142 if (isUiRestricted()) {
144 getPreferenceScreen().removeAll();
148 final Activity activity = getActivity();
149 BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
150 if (adapter != null) {
151 adapter.getProfileProxy(activity.getApplicationContext(), mProfileServiceListener,
152 BluetoothProfile.PAN);
156 (SwitchPreference) findPreference(ENABLE_WIFI_AP);
157 Preference wifiApSettings = findPreference(WIFI_AP_SSID_AND_SECURITY);
158 mUsbTether = (SwitchPreference) findPreference(USB_TETHER_SETTINGS);
159 mBluetoothTether = (SwitchPreference) findPreference(ENABLE_BLUETOOTH_TETHERING);
161 mDataSaverBackend.addListener(this);
163 mCm = (ConnectivityManager) getSystemService(Context.CONNECTIVITY_SERVICE);
164 mWifiManager = (WifiManager) getSystemService(Context.WIFI_SERVICE);
166 mUsbRegexs = mCm.getTetherableUsbRegexs();
167 mWifiRegexs = mCm.getTetherableWifiRegexs();
168 mBluetoothRegexs = mCm.getTetherableBluetoothRegexs();
170 final boolean usbAvailable = mUsbRegexs.length != 0;
171 final boolean wifiAvailable = mWifiRegexs.length != 0;
172 final boolean bluetoothAvailable = mBluetoothRegexs.length != 0;
174 if (!usbAvailable || Utils.isMonkeyRunning()) {
175 getPreferenceScreen().removePreference(mUsbTether);
178 if (wifiAvailable && !Utils.isMonkeyRunning()) {
179 mWifiApEnabler = new WifiApEnabler(activity, mDataSaverBackend, mEnableWifiAp);
182 getPreferenceScreen().removePreference(mEnableWifiAp);
183 getPreferenceScreen().removePreference(wifiApSettings);
186 if (!bluetoothAvailable) {
187 getPreferenceScreen().removePreference(mBluetoothTether);
189 BluetoothPan pan = mBluetoothPan.get();
190 if (pan != null && pan.isTetheringOn()) {
191 mBluetoothTether.setChecked(true);
193 mBluetoothTether.setChecked(false);
196 // Set initial state based on Data Saver mode.
197 onDataSaverChanged(mDataSaverBackend.isDataSaverEnabled());
201 public void onDestroy() {
202 mDataSaverBackend.remListener(this);
204 BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
205 BluetoothProfile profile = mBluetoothPan.getAndSet(null);
206 if (profile != null && adapter != null) {
207 adapter.closeProfileProxy(BluetoothProfile.PAN, profile);
214 public void onDataSaverChanged(boolean isDataSaving) {
215 mDataSaverEnabled = isDataSaving;
216 mEnableWifiAp.setEnabled(!mDataSaverEnabled);
217 mUsbTether.setEnabled(!mDataSaverEnabled);
218 mBluetoothTether.setEnabled(!mDataSaverEnabled);
219 mDataSaverFooter.setVisible(mDataSaverEnabled);
223 public void onWhitelistStatusChanged(int uid, boolean isWhitelisted) {
227 public void onBlacklistStatusChanged(int uid, boolean isBlacklisted) {
230 private void initWifiTethering() {
231 final Activity activity = getActivity();
232 mWifiConfig = mWifiManager.getWifiApConfiguration();
233 mSecurityType = getResources().getStringArray(R.array.wifi_ap_security);
235 mCreateNetwork = findPreference(WIFI_AP_SSID_AND_SECURITY);
237 mRestartWifiApAfterConfigChange = false;
239 if (mWifiConfig == null) {
240 final String s = activity.getString(
241 com.android.internal.R.string.wifi_tether_configure_ssid_default);
242 mCreateNetwork.setSummary(String.format(activity.getString(CONFIG_SUBTEXT),
243 s, mSecurityType[WifiApDialog.OPEN_INDEX]));
245 int index = WifiApDialog.getSecurityTypeIndex(mWifiConfig);
246 mCreateNetwork.setSummary(String.format(activity.getString(CONFIG_SUBTEXT),
248 mSecurityType[index]));
253 public Dialog onCreateDialog(int id) {
254 if (id == DIALOG_AP_SETTINGS) {
255 final Activity activity = getActivity();
256 mDialog = new WifiApDialog(activity, this, mWifiConfig);
264 public int getDialogMetricsCategory(int dialogId) {
265 if (dialogId == DIALOG_AP_SETTINGS) {
266 return MetricsEvent.DIALOG_AP_SETTINGS;
271 private class TetherChangeReceiver extends BroadcastReceiver {
273 public void onReceive(Context content, Intent intent) {
274 String action = intent.getAction();
275 if (action.equals(ConnectivityManager.ACTION_TETHER_STATE_CHANGED)) {
276 // TODO - this should understand the interface types
277 ArrayList<String> available = intent.getStringArrayListExtra(
278 ConnectivityManager.EXTRA_AVAILABLE_TETHER);
279 ArrayList<String> active = intent.getStringArrayListExtra(
280 ConnectivityManager.EXTRA_ACTIVE_TETHER);
281 ArrayList<String> errored = intent.getStringArrayListExtra(
282 ConnectivityManager.EXTRA_ERRORED_TETHER);
283 updateState(available.toArray(new String[available.size()]),
284 active.toArray(new String[active.size()]),
285 errored.toArray(new String[errored.size()]));
286 if (mWifiManager.getWifiApState() == WifiManager.WIFI_AP_STATE_DISABLED
287 && mRestartWifiApAfterConfigChange) {
288 mRestartWifiApAfterConfigChange = false;
289 Log.d(TAG, "Restarting WifiAp due to prior config change.");
290 startTethering(TETHERING_WIFI);
292 } else if (action.equals(WifiManager.WIFI_AP_STATE_CHANGED_ACTION)) {
293 int state = intent.getIntExtra(WifiManager.EXTRA_WIFI_AP_STATE, 0);
294 if (state == WifiManager.WIFI_AP_STATE_DISABLED
295 && mRestartWifiApAfterConfigChange) {
296 mRestartWifiApAfterConfigChange = false;
297 Log.d(TAG, "Restarting WifiAp due to prior config change.");
298 startTethering(TETHERING_WIFI);
300 } else if (action.equals(Intent.ACTION_MEDIA_SHARED)) {
301 mMassStorageActive = true;
303 } else if (action.equals(Intent.ACTION_MEDIA_UNSHARED)) {
304 mMassStorageActive = false;
306 } else if (action.equals(UsbManager.ACTION_USB_STATE)) {
307 mUsbConnected = intent.getBooleanExtra(UsbManager.USB_CONNECTED, false);
309 } else if (action.equals(BluetoothAdapter.ACTION_STATE_CHANGED)) {
310 if (mBluetoothEnableForTether) {
312 .getIntExtra(BluetoothAdapter.EXTRA_STATE, BluetoothAdapter.ERROR)) {
313 case BluetoothAdapter.STATE_ON:
314 startTethering(TETHERING_BLUETOOTH);
315 mBluetoothEnableForTether = false;
318 case BluetoothAdapter.STATE_OFF:
319 case BluetoothAdapter.ERROR:
320 mBluetoothEnableForTether = false;
324 // ignore transition states
333 public void onStart() {
337 if (!isUiRestrictedByOnlyAdmin()) {
338 getEmptyTextView().setText(R.string.tethering_settings_not_available);
340 getPreferenceScreen().removeAll();
344 final Activity activity = getActivity();
346 mStartTetheringCallback = new OnStartTetheringCallback(this);
348 mMassStorageActive = Environment.MEDIA_SHARED.equals(Environment.getExternalStorageState());
349 mTetherChangeReceiver = new TetherChangeReceiver();
350 IntentFilter filter = new IntentFilter(ConnectivityManager.ACTION_TETHER_STATE_CHANGED);
351 filter.addAction(WifiManager.WIFI_AP_STATE_CHANGED_ACTION);
352 Intent intent = activity.registerReceiver(mTetherChangeReceiver, filter);
354 filter = new IntentFilter();
355 filter.addAction(UsbManager.ACTION_USB_STATE);
356 activity.registerReceiver(mTetherChangeReceiver, filter);
358 filter = new IntentFilter();
359 filter.addAction(Intent.ACTION_MEDIA_SHARED);
360 filter.addAction(Intent.ACTION_MEDIA_UNSHARED);
361 filter.addDataScheme("file");
362 activity.registerReceiver(mTetherChangeReceiver, filter);
364 filter = new IntentFilter();
365 filter.addAction(BluetoothAdapter.ACTION_STATE_CHANGED);
366 activity.registerReceiver(mTetherChangeReceiver, filter);
368 if (intent != null) mTetherChangeReceiver.onReceive(activity, intent);
369 if (mWifiApEnabler != null) {
370 mEnableWifiAp.setOnPreferenceChangeListener(this);
371 mWifiApEnabler.resume();
378 public void onStop() {
384 getActivity().unregisterReceiver(mTetherChangeReceiver);
385 mTetherChangeReceiver = null;
386 mStartTetheringCallback = null;
387 if (mWifiApEnabler != null) {
388 mEnableWifiAp.setOnPreferenceChangeListener(null);
389 mWifiApEnabler.pause();
393 private void updateState() {
394 String[] available = mCm.getTetherableIfaces();
395 String[] tethered = mCm.getTetheredIfaces();
396 String[] errored = mCm.getTetheringErroredIfaces();
397 updateState(available, tethered, errored);
400 private void updateState(String[] available, String[] tethered,
402 updateUsbState(available, tethered, errored);
403 updateBluetoothState(available, tethered, errored);
407 private void updateUsbState(String[] available, String[] tethered,
409 boolean usbAvailable = mUsbConnected && !mMassStorageActive;
410 int usbError = ConnectivityManager.TETHER_ERROR_NO_ERROR;
411 for (String s : available) {
412 for (String regex : mUsbRegexs) {
413 if (s.matches(regex)) {
414 if (usbError == ConnectivityManager.TETHER_ERROR_NO_ERROR) {
415 usbError = mCm.getLastTetherError(s);
420 boolean usbTethered = false;
421 for (String s : tethered) {
422 for (String regex : mUsbRegexs) {
423 if (s.matches(regex)) usbTethered = true;
426 boolean usbErrored = false;
427 for (String s: errored) {
428 for (String regex : mUsbRegexs) {
429 if (s.matches(regex)) usbErrored = true;
434 mUsbTether.setSummary(R.string.usb_tethering_active_subtext);
435 mUsbTether.setEnabled(!mDataSaverEnabled);
436 mUsbTether.setChecked(true);
437 } else if (usbAvailable) {
438 if (usbError == ConnectivityManager.TETHER_ERROR_NO_ERROR) {
439 mUsbTether.setSummary(R.string.usb_tethering_available_subtext);
441 mUsbTether.setSummary(R.string.usb_tethering_errored_subtext);
443 mUsbTether.setEnabled(!mDataSaverEnabled);
444 mUsbTether.setChecked(false);
445 } else if (usbErrored) {
446 mUsbTether.setSummary(R.string.usb_tethering_errored_subtext);
447 mUsbTether.setEnabled(false);
448 mUsbTether.setChecked(false);
449 } else if (mMassStorageActive) {
450 mUsbTether.setSummary(R.string.usb_tethering_storage_active_subtext);
451 mUsbTether.setEnabled(false);
452 mUsbTether.setChecked(false);
454 mUsbTether.setSummary(R.string.usb_tethering_unavailable_subtext);
455 mUsbTether.setEnabled(false);
456 mUsbTether.setChecked(false);
460 private void updateBluetoothState(String[] available, String[] tethered,
462 boolean bluetoothErrored = false;
463 for (String s: errored) {
464 for (String regex : mBluetoothRegexs) {
465 if (s.matches(regex)) bluetoothErrored = true;
469 BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
470 if (adapter == null) {
473 int btState = adapter.getState();
474 if (btState == BluetoothAdapter.STATE_TURNING_OFF) {
475 mBluetoothTether.setEnabled(false);
476 mBluetoothTether.setSummary(R.string.bluetooth_turning_off);
477 } else if (btState == BluetoothAdapter.STATE_TURNING_ON) {
478 mBluetoothTether.setEnabled(false);
479 mBluetoothTether.setSummary(R.string.bluetooth_turning_on);
481 BluetoothPan bluetoothPan = mBluetoothPan.get();
482 if (btState == BluetoothAdapter.STATE_ON && bluetoothPan != null
483 && bluetoothPan.isTetheringOn()) {
484 mBluetoothTether.setChecked(true);
485 mBluetoothTether.setEnabled(!mDataSaverEnabled);
486 int bluetoothTethered = bluetoothPan.getConnectedDevices().size();
487 if (bluetoothTethered > 1) {
488 String summary = getString(
489 R.string.bluetooth_tethering_devices_connected_subtext,
491 mBluetoothTether.setSummary(summary);
492 } else if (bluetoothTethered == 1) {
493 mBluetoothTether.setSummary(
494 R.string.bluetooth_tethering_device_connected_subtext);
495 } else if (bluetoothErrored) {
496 mBluetoothTether.setSummary(R.string.bluetooth_tethering_errored_subtext);
498 mBluetoothTether.setSummary(R.string.bluetooth_tethering_available_subtext);
501 mBluetoothTether.setEnabled(!mDataSaverEnabled);
502 mBluetoothTether.setChecked(false);
503 mBluetoothTether.setSummary(R.string.bluetooth_tethering_off_subtext);
509 public boolean onPreferenceChange(Preference preference, Object value) {
510 boolean enable = (Boolean) value;
513 startTethering(TETHERING_WIFI);
515 mCm.stopTethering(TETHERING_WIFI);
520 public static boolean isProvisioningNeededButUnavailable(Context context) {
521 return (TetherUtil.isProvisioningNeeded(context)
522 && !isIntentAvailable(context));
525 private static boolean isIntentAvailable(Context context) {
526 String[] provisionApp = context.getResources().getStringArray(
527 com.android.internal.R.array.config_mobile_hotspot_provision_app);
528 if (provisionApp.length < 2) {
531 final PackageManager packageManager = context.getPackageManager();
532 Intent intent = new Intent(Intent.ACTION_MAIN);
533 intent.setClassName(provisionApp[0], provisionApp[1]);
535 return (packageManager.queryIntentActivities(intent,
536 PackageManager.MATCH_DEFAULT_ONLY).size() > 0);
539 private void startTethering(int choice) {
540 if (choice == TETHERING_BLUETOOTH) {
541 // Turn on Bluetooth first.
542 BluetoothAdapter adapter = BluetoothAdapter.getDefaultAdapter();
543 if (adapter.getState() == BluetoothAdapter.STATE_OFF) {
544 mBluetoothEnableForTether = true;
546 mBluetoothTether.setSummary(R.string.bluetooth_turning_on);
547 mBluetoothTether.setEnabled(false);
552 mCm.startTethering(choice, true, mStartTetheringCallback, mHandler);
556 public boolean onPreferenceTreeClick(Preference preference) {
557 if (preference == mUsbTether) {
558 if (mUsbTether.isChecked()) {
559 startTethering(TETHERING_USB);
561 mCm.stopTethering(TETHERING_USB);
563 } else if (preference == mBluetoothTether) {
564 if (mBluetoothTether.isChecked()) {
565 startTethering(TETHERING_BLUETOOTH);
567 mCm.stopTethering(TETHERING_BLUETOOTH);
568 // No ACTION_TETHER_STATE_CHANGED is fired or bluetooth unless a device is
569 // connected. Need to update state manually.
572 } else if (preference == mCreateNetwork) {
573 showDialog(DIALOG_AP_SETTINGS);
576 return super.onPreferenceTreeClick(preference);
579 public void onClick(DialogInterface dialogInterface, int button) {
580 if (button == DialogInterface.BUTTON_POSITIVE) {
581 mWifiConfig = mDialog.getConfig();
582 if (mWifiConfig != null) {
584 * if soft AP is stopped, bring up
585 * else restart with new config
586 * TODO: update config on a running access point when framework support is added
588 if (mWifiManager.getWifiApState() == WifiManager.WIFI_AP_STATE_ENABLED) {
589 Log.d("TetheringSettings",
590 "Wifi AP config changed while enabled, stop and restart");
591 mRestartWifiApAfterConfigChange = true;
592 mCm.stopTethering(TETHERING_WIFI);
594 mWifiManager.setWifiApConfiguration(mWifiConfig);
595 int index = WifiApDialog.getSecurityTypeIndex(mWifiConfig);
596 mCreateNetwork.setSummary(String.format(getActivity().getString(CONFIG_SUBTEXT),
598 mSecurityType[index]));
604 public int getHelpResource() {
605 return R.string.help_url_tether;
608 private BluetoothProfile.ServiceListener mProfileServiceListener =
609 new BluetoothProfile.ServiceListener() {
610 public void onServiceConnected(int profile, BluetoothProfile proxy) {
611 mBluetoothPan.set((BluetoothPan) proxy);
613 public void onServiceDisconnected(int profile) {
614 mBluetoothPan.set(null);
618 private static final class OnStartTetheringCallback extends
619 ConnectivityManager.OnStartTetheringCallback {
620 final WeakReference<TetherSettings> mTetherSettings;
622 OnStartTetheringCallback(TetherSettings settings) {
623 mTetherSettings = new WeakReference<TetherSettings>(settings);
627 public void onTetheringStarted() {
632 public void onTetheringFailed() {
636 private void update() {
637 TetherSettings settings = mTetherSettings.get();
638 if (settings != null) {
639 settings.updateState();