Merge pull request #2972 from imurchie/isaac-docs2

Add network connection doc

docs/en/network_connection.md

@@ -0,0 +1,59 @@
+# Adjusting Network Connection
+
+The Selenium [Mobile JSON Wire Protocol Specification](https://code.google.com/p/selenium/source/browse/spec-draft.md?repo=mobile) supports an [API](https://code.google.com/p/selenium/source/browse/spec-draft.md?repo=mobile#104) for getting and setting the network connection for a device. The API works through a bitmask, assigning an integer to each possible state:
+
+| Value (Alias)      | Data | Wifi | Airplane Mode |
+| ------------------ | ---- | ---- | ------------- |
+| 0 (None)           | 0    | 0    | 0 |
+| 1 (Airplane Mode)  | 0    | 0    | 1 |
+| 2 (Wifi only)      | 0    | 1    | 0 |
+| 4 (Data only)      | 1    | 0    | 0 |
+| 6 (All network on) | 1    | 1    | 0 |
+
+## iOS
+
+Unfortunately, at the moment Appium does not support the Selenium network
+connection API for iOS.
+
+## Android
+
+Choose the setting you would like to use, and then send the correct bitmask from
+the table above.
+
+```js
+// set airplane mode
+driver.setNetworkConnection(1)
+
+// set wifi only
+driver.setNetworkConnection(2)
+
+// set data only
+driver.setNetworkConnection(4)
+
+// set wifi and data
+driver.setNetworkConnection(6)
+```
+
+Retrieving the network connection settings returns the same bitmask, from which
+the status can be decoded.
+
+```js
+var connectionType = driver.getNetworkConnection();
+switch (connectionType) {
+  case 0:
+    // no network connection
+    break;
+  case 1:
+    // airplane mode
+    break;
+  case 2:
+    // wifi
+    break;
+  case 4:
+    // data
+    break;
+  case 6:
+    // wifi and data
+    break;
+}
+```