Update RIL_LTE_SignalStrength comments.

Add INT_MAX to denote invalid values and doc references.
Created bug 4575689 to get Xoom LTE ril fixed and the FW updated.

Change-Id: Ib1f7055b469ac8756bb5c0911d180ad7ba849227

diff --git a/include/telephony/ril.h b/include/telephony/ril.h
index e7e2fba..7bc0b4d 100644 (file)
--- a/include/telephony/ril.h
+++ b/include/telephony/ril.h
@@ -637,12 +637,22 @@ typedef struct {
 
 typedef struct {
     int signalStrength;  /* Valid values are (0-31, 99) as defined in TS 27.007 8.5 */
-    int rsrp;            /* The current Reference Signal Receive Power in dBm
-                          * multipled by -1. Range: 44 to 140 dBm, TODO: doc reference */
-    int rsrq;            /* The current Reference Signal Receive Quality in dB
-                          * multiplied by -1. Range: 20 to 3 dB. TODO: doc reference */
-    int rssnr;           /* TODO: Need documentation and doc reference */
-    int cqi;             /* TODO: Need documentation and doc reference */
+    int rsrp;            /* The current Reference Signal Receive Power in dBm multipled by -1.
+                          * Range: 44 to 140 dBm
+                          * INT_MAX: 0x7FFFFFFF denotes invalid value.
+                          * Reference: 3GPP TS 36.133 9.1.4 */
+    int rsrq;            /* The current Reference Signal Receive Quality in dB multiplied by -1.
+                          * Range: 20 to 3 dB.
+                          * INT_MAX: 0x7FFFFFFF denotes invalid value.
+                          * Reference: 3GPP TS 36.133 9.1.7 */
+    int rssnr;           /* The current reference signal signal-to-noise ratio in 0.1 dB units.
+                          * Range: -200 to +300 (-200 = -20.0 dB, +300 = 30dB).
+                          * INT_MAX : 0x7FFFFFFF denotes invalid value.
+                          * Reference: 3GPP TS 36.101 8.1.1 */
+    int cqi;             /* The current Channel Quality Indicator.
+                          * Range: 0 to 15.
+                          * INT_MAX : 0x7FFFFFFF denotes invalid value.
+                          * Reference: 3GPP TS 36.101 9.2, 9.3, A.4 */
 } RIL_LTE_SignalStrength;
 
 /* Deprecated, use RIL_SignalStrength_v6 */