From b676a4a70db36bdd6ce5060d16f453f797378098 Mon Sep 17 00:00:00 2001
From: Vinit Deshapnde <vinitd@google.com>
Date: Fri, 16 Aug 2013 17:16:45 -0700
Subject: [PATCH] Expose WifiManager.setTdlsEnabled public API

Bug: 10221775

Change-Id: I559e4a2afd525a03c8a13fd151eca4638426d03e
---
 api/current.txt                             |  2 ++
 wifi/java/android/net/wifi/WifiManager.java | 30 +++++++++++++++++------------
 2 files changed, 20 insertions(+), 12 deletions(-)

diff --git a/api/current.txt b/api/current.txt
index 002b8d77621b..eb403be47990 100644
--- a/api/current.txt
+++ b/api/current.txt
@@ -14474,6 +14474,8 @@ package android.net.wifi {
     method public boolean reconnect();
     method public boolean removeNetwork(int);
     method public boolean saveConfiguration();
+    method public void setTdlsEnabled(java.net.InetAddress, boolean);
+    method public void setTdlsEnabledWithMacAddress(java.lang.String, boolean);
     method public boolean setWifiEnabled(boolean);
     method public boolean startScan();
     method public int updateNetwork(android.net.wifi.WifiConfiguration);
diff --git a/wifi/java/android/net/wifi/WifiManager.java b/wifi/java/android/net/wifi/WifiManager.java
index 679371066cae..b56cd5315434 100644
--- a/wifi/java/android/net/wifi/WifiManager.java
+++ b/wifi/java/android/net/wifi/WifiManager.java
@@ -1146,16 +1146,26 @@ public class WifiManager {
 
 
     /**
-     * Enable TDLS on a specific local route
+     * Enable/Disable TDLS on a specific local route.
      *
-     * This API is used by WiFi display, but eventually it can be made public,
-     * just depends on how popular TDLS gets
+     * <p>
+     * TDLS enables two wireless endpoints to talk to each other directly
+     * without going through the access point that is managing the local
+     * network. It saves bandwidth and improves quality of the link.
+     * </p>
+     * <p>
+     * This API enables/disables the option of using TDLS. If enabled, the
+     * underlying hardware is free to use TDLS or a hop through the access
+     * point. If disabled, existing TDLS session is torn down and
+     * hardware is restricted to use access point for transferring wireless
+     * packets. Default value for all routes is 'disabled', meaning restricted
+     * to use access point for transferring packets.
+     * </p>
      *
      * @param remoteIPAddress IP address of the endpoint to setup TDLS with
      * @param enable true = setup and false = tear down TDLS
-     * @hide
      */
-    public void enableTdls(InetAddress remoteIPAddress, boolean enable) {
+    public void setTdlsEnabled(InetAddress remoteIPAddress, boolean enable) {
         try {
             mService.enableTdls(remoteIPAddress.getHostAddress(), enable);
         } catch (RemoteException e) {
@@ -1164,16 +1174,12 @@ public class WifiManager {
     }
 
     /**
-     * Enable TDLS on a specific local route
-     *
-     * This API is used by WiFi display, but eventually it can be made public,
-     * just depends on how popular TDLS gets
-     *
+     * Similar to {@link #setTdlsEnabled(InetAddress, boolean) }, except
+     * this version allows you to specify remote endpoint with a MAC address.
      * @param remoteMacAddress MAC address of the remote endpoint such as 00:00:0c:9f:f2:ab
      * @param enable true = setup and false = tear down TDLS
-     * @hide
      */
-    public void enableTdlsWithMacAddress(String remoteMacAddress, boolean enable) {
+    public void setTdlsEnabledWithMacAddress(String remoteMacAddress, boolean enable) {
         try {
             mService.enableTdlsWithMacAddress(remoteMacAddress, enable);
         } catch (RemoteException e) {
-- 
2.11.0