Fix docstrings for RIL_CellIdentity
Update the documentation to match the current
CTS requirements for Cell Identity reporting
-For LTE, WCDMA, and GSM require that the channel
number be reported.
-For LTE and WCDMA, require that the correct
physical channel identifier be reported. Note that
due to b/32774471 we still cannot require BSIC
to be reported.
Bug: 65174915
Test: none, comment-only change
Change-Id: I6866e3e78678aeb2b8f48bff032709f802cba067
diff --git a/include/telephony/ril.h b/include/telephony/ril.h
index df0e467..0512f52 100644
--- a/include/telephony/ril.h
+++ b/include/telephony/ril.h
@@ -1369,8 +1369,8 @@
int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
int cid; /* 16-bit GSM Cell Identity described in TS 27.007, 0..65535, INT_MAX if unknown */
- int arfcn; /* 16-bit GSM Absolute RF channel number, INT_MAX if unknown */
- uint8_t bsic;/* 6-bit Base Station Identity Code, 0xFF if unknown */
+ int arfcn; /* 16-bit GSM Absolute RF channel number; this value must be reported */
+ uint8_t bsic; /* 6-bit Base Station Identity Code; 0xFF if unknown */
} RIL_CellIdentityGsm_v12;
typedef struct {
@@ -1386,8 +1386,8 @@
int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
int lac; /* 16-bit Location Area Code, 0..65535, INT_MAX if unknown */
int cid; /* 28-bit UMTS Cell Identity described in TS 25.331, 0..268435455, INT_MAX if unknown */
- int psc; /* 9-bit UMTS Primary Scrambling Code described in TS 25.331, 0..511, INT_MAX if unknown */
- int uarfcn; /* 16-bit UMTS Absolute RF Channel Number, INT_MAX if unknown */
+ int psc; /* 9-bit UMTS Primary Scrambling Code described in TS 25.331, 0..511; this value must be reported */
+ int uarfcn; /* 16-bit UMTS Absolute RF Channel Number; this value must be reported */
} RIL_CellIdentityWcdma_v12;
typedef struct {
@@ -1417,9 +1417,9 @@
int mcc; /* 3-digit Mobile Country Code, 0..999, INT_MAX if unknown */
int mnc; /* 2 or 3-digit Mobile Network Code, 0..999, INT_MAX if unknown */
int ci; /* 28-bit Cell Identity described in TS ???, INT_MAX if unknown */
- int pci; /* physical cell id 0..503, INT_MAX if unknown */
+ int pci; /* physical cell id 0..503; this value must be reported */
int tac; /* 16-bit tracking area code, INT_MAX if unknown */
- int earfcn; /* 18-bit LTE Absolute RC Channel Number, INT_MAX if unknown */
+ int earfcn; /* 18-bit LTE Absolute RF Channel Number; this value must be reported */
} RIL_CellIdentityLte_v12;
typedef struct {