[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..e4eaecdd96d77d82a384f3a76415bfef9c361e3a 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,34 @@ 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 provided by an external device, e.g.
+a phone.
+
+### 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 carrier when the hotspot is provided by a
+      cellular connection.
+
+* **SignalStrength**
+    * (optional, read-only) - **integer**
+    * The current signal strength for the hotspot's signal strength in the

[stevenjb, 2017/04/18 23:46:10]

'current value for the hotspot's signal strength' ? (Current phrasing is awkward
/ confusing).

[Kyle Horimoto, 2017/04/18 23:49:21]

Done.

+      range [0, 100]. Note that this value refers to the strength of the signal
+      between the external device and its data provider, not the strength of the
+      signal between the current device and the external device.
+
+
 ## Bluetooth / WiFi Direct Networks
 
 This format will eventually also cover configuration of Bluetooth and WiFi