[CrOS Tether] Add tether network properties (battery percentage, carrier, and signal strength) to t…

components/onc/docs/onc_spec.md

Index: components/onc/docs/onc_spec.md
diff --git a/components/onc/docs/onc_spec.md b/components/onc/docs/onc_spec.md
index 45ecc1afd50223a2e7bcabd443933e13fe682dcc..29c4183493473fb220a2188473ff1b879007d5fc 100644
--- a/components/onc/docs/onc_spec.md
+++ b/components/onc/docs/onc_spec.md
@@ -230,6 +230,11 @@ Field **NetworkConfigurations** is an array of
       [Cellular](#Cellular-type)
     * Cellular settings.
 
+* **Tether**
+    * (required if **Type** is *Tether*, otherwise ignored) -
+      [Tether](#Tether-type)
+    * Tether settings.
+
 * **Type**
     * (required if **Remove** is *false*, otherwise ignored) - **string**
     * `Allowed values are` *Cellular*,
@@ -1426,6 +1431,31 @@ ONC configuration of of **Cellular** networks is not yet supported.
       changes to *sim-puk*).
 
 
+## Tether Networks
+
+For Tether connections, **Type** must be set to *Tether* and the
+field **Tether** must be set to an object of type [Tether](#Tether-type).
+
+Used for representing a tether hotspot produced by a device with a cellular

[stevenjb, 2017/04/18 23:34:14]

s/produced by a device with a cellular chip/provided by an external device, e.g.
a phone/ ?

I don't think the technology used to provide the hotspot matters from an API
perspective.

[Kyle Horimoto, 2017/04/18 23:41:13]

Done.

+chip.
+
+### Tether type
+
+* **BatteryPercentage**
+    * (optional, read-only) - **integer**
+    * The battery percentage of the device providing the tether hotspot in the
+      range [0, 100].
+
+* **Carrier**
+    * (optional, read-only) - **string**
+    * The name of the cellular provider through which the hotspot is providing
+      an Internet connection.

[stevenjb, 2017/04/18 23:34:14]

'The name of the cellular carrier when the hotspot is provided by a cellular
connection'?

[Kyle Horimoto, 2017/04/18 23:41:13]

Done.

+
+* **SignalStrength**
+    * (optional, read-only) - **integer**
+    * The current signal strength for this network in the range [0, 100].

[stevenjb, 2017/04/18 23:34:15]

s/for this network/for the connection to the hotspot/? Or is it the hotspot's
signal strength? We should be clear either way.

[Kyle Horimoto, 2017/04/18 23:41:13]

Done, and added some extra clarification.

+
+
 ## Bluetooth / WiFi Direct Networks
 
 This format will eventually also cover configuration of Bluetooth and WiFi