freesmartphone.org GSM Network Monitoring Interface
Description
The Monitor interface is used to gather auxiallary information about the GSM network, serving cells, network cells, and more, beyond what is defined in 3GPP 07.07. Implementing this interface is optional.
Namespace
org.freesmartphone.GSM.Monitor
Methods
Signals
None
Properties
None
Errors
None
Methods
GetServingCellInformation ( ) → a{sv}
Description: Retrieves serving cell information.
Returns:
a{sv}: serving_cell Information about the serving cell. Valid are the following tuples:
- ( “arfcn”, int ): Current Channel Number
- ( “c1”, int ): Path Loss Criterion C1 (in percentage, comparable with signal strength)
- ( “c2”, int ): Cell-Reselection Criterion C2 (in percentage, comparable with signal strength)
- ( “rxlev”, int ): Received Field Strength (in percentage, comparable with signal strength)
- ( “bsic”, int ): Base Station ID Code
- ( “cid”, string ): Cell Identifier
- ( “dsc”, int ): Downlink Signaling Counter actual value
- ( “txlev, int ): Transmit Power Level
- ( “tn, int ): Timeslot Number
- ( “rlt, int ): Radio Link Timeout Counter
- ( “tav, int ): Timing Advance
- ( “rxlev_f, int ): Received Field Strength full (in percentage, comparable with signal strength)
- ( “rxlev_s, int ): Received Field Strength sub (in percentage, comparable with signal strength)
- ( “rxqual_f, int ): Received Quality full
- ( “rxqual_s, int ): Received Quality sub
- ( “lac”, string ): Location Area Code
- ( “cba”, int ): Cell Bar Access
- ( “cbq”, int ): Cell Bar Qualifier
- ( “ctype”, int ): Cell Type Indicator NA/GSM/GPRS
- ( “vocoder” ): Vocoder Sig/speech/efr/amr/14.4/9.6/4.8/2.4
GetNeighbourCellInformation ( ) → aa{sv}
Description: Retrieves neighbour cell information.
Returns:
aa{sv}: neighbour_cells Information about the neighbour cells. This is an array of maps, one for every neighbour cell. Valid are the following tuples:
- ( “arfcn”, int ): Current Channel Number
- ( “c1”, int ): Path Loss Criterion C1 (in percentage, comparable with signal strength)
- ( “c2”, int ): Cell-Reselection Criterion C2
- ( “rxlev”, int ): Received Field Strength (in percentage, comparable with signal strength)
- ( “bsic”, int ): Base Station ID Code
- ( “cid”, string ): Cell Identifier
- ( “lac”, string ): Location Area Code
- ( “dsc”, int ): Downlink Signaling Counter actual value
- ( “foffset, int ): Frame Offset
- ( “timea, int ): Time Alignment
- ( “cba”, int ): Cell Bar Access
- ( “cbq”, int ): Cell Bar Qualifier
- ( “ctype”, int ): Cell Type Indicator NA/GSM/GPRS
- ( “rac”, string ): Routing Area Code
- ( “roffset, int ): Cell Reselection Offset
- ( “toffset, int ): Temporary Offset
- ( “rxlevam, int ): Rxlev access min (in percentage, comparable with signal strength)