$PGLOR,NET - Report network information
  $PGLOR,NET,<TTFF>,<ATFF>,<RTFF>,<TTPR>,<STIME>,<SP><STYPE><NS>,<ASST>,<RLS>,<SS>*CC

Where:

  • PGLOR Proprietary NMEA sentence identifier for Broadcom
  • NET Sentence identifier
  • TTFF Time To First Fix or Time To First Measurement. Unit are seconds An empty field indicates too few measurements or a fix failure
  • ATFF Assistance time to first fix in seconds An empty field indicates no assistance received.
  • RTFF Request to first fix in seconds An empty field indicates no report generated.
  • TTPR Time to fix position report. An empty field indicates server didn't send fix to the set.
  • STIME Request start until end of session from bearer Unit are seconds An empty field indicates no session was involved.
  • SP Session Protocol. Possible values are:
    • U - Unspecified (autonomous or local operation only)
    • S - SUPL
    • 2 - 2G-RRLP (GSM)
    • 3 - 3G-RRC (UMTS)
    • G - 2G or 3G (GSM)
    • 4 - 4G-LLP (LTE)
    • D - CDMA
    • C - Unspecified Control Plane (if RIL does not expose network type)
    • L - LBS
  • STYPE Session Type. Possible values are:
    • U - Unspecified
    • S - Set Initiated
    • N - Network Initiated
    • W - Stay Warm (LBS sync?)
    • A - Get Assistance
  • NS Network status: Case 1. When the last protocol result was fail, the whole session will be regarded as F (failure). Case 2. When there were not a single failure but the session ended, the protocol was too slow and didn't contribute to assistance so it's D (disconnected).
    • U - Unspecified
    • C - Connected, Successful
    • D - Disconnected, Successful
    • A - Autonomous, Unsuccessful
    • F - Fail, Unsuccessful
  • ASST Assistance data provided. Possible values are a list:
    • L - Reference location
    • T - Reference time
    • E - Ephemeris
    • F - Fine time
    • C - Frequency (count-in)
    • A - Acquisition assistance
    • O - Other information (ionospheric, almanac, etc). An empty field indicates no assistance was provided.
  • RLS Reference Location Source
    • U - Unknown
    • A - Autonomous
    • S - SET-assisted
    • B - SET-based
    • C - Cell ID
    • L - Last known
    • Z - LBS An empty field is not possible.
  • SS Session status
    • 0 - EOS Pass
    • <num> - EOS Fail. <num> is a per-bearer error code An empty field indicates no session was involved.
  • CC Standard NMEA checksum

EXAMPLE:

    $PGLOR,NET,5.4,5,7,12.2,13.3,3NC,LTEC,B,0*56

SEE ALSO: This NMEA sentence is programmed in the HAL. See glhal/src/glgps_hal_net.c for programming details.


Timing Diagrams

These letters are used in the following diagram:

  • R - request received
  • A - assistance data completely received
  • S - positioning (or measurement) started
  • F - position calculated
  • M - measurements calculated
  • P - position received
  • V - successful periodic position reported
  • I - unsuccesful periodic position reported
  • E - End of session. Includes bearer pass/fail indication

In MS-Assisted TTPR is empty if position was not received. In MS-Based the TTPR is always empty.

Network cases include SUPL, 2G, 3G, and 4G.

Autonomous Timing

ATFF, TTPR, and Session Time are empty in autonomous cases.

Single shot

     R (autonomous single shot)
     |
     +------------------S--------------------------------F--------------> time
     |                  |                                |
     |                  +------------- TTFF -------------+
     +--------------------- RTFF ------------------------+

Periodic

Subsequent fixes (TTF) are reported in PGLOR,FIX. See $PGLOR,0,FIX - Time To Fix.

     R (autonomous periodic)
     |
     +---S----------V---------I----------V---------------V---------------> time
     |   |          |                    |               |
     |   +-- TTFF --+                    |               |
     +---- RTFF ----+------- TTFF -------+---- (TTF) ----+

Set Initiated Timing

TTPR and Session Time are empty.

MS-Based

Control plane SILR behaves like NILR in that the GLL request start 'S' timing is based on the end of assistance arrival 'A'. In 2G/RRLP, the request is explicitly restarted as shown. In 3G/RRC, the request might not be restarted, but the 3G server accounts for the set performance from the end of 'A', even though the PGLOR,NET output might not match this value.

     R (SILR - MS-Based)
     |
     +--------AAAAA--E--S---------------------------I----F-----F--------> time
     |            |  |  |                                |
     |            |  |  +------------- TTFF -------------+
     |            +--+----------- ATFF ------------------+
     +---------------+----- RTFF ------------------------+
     +-- Sess. Time -+

SUPL does not restart the request when assistance is received, so the GLL start 'S' happens concurrent with the SUPL assistance request 'A':

     R (SILR - MS-Based)
     |
     +----S---AAAAA--E------------------------------I----F-----F--------> time
     |    |       |  |                                   |
     |    +-------+--+---------------- TTFF -------------+
     |            +--+----------- ATFF ------------------+
     +---------------+----- RTFF ------------------------+
     +-- Sess. Time -+

In MS-Assisted the TTPR is empty if the position was not received.

     R (SILR - MS-Assisted)
     |                  +---- TTPR (position received) --------+
     |                  |                                      |
     +---------AAAA-----S--------------------------------M-----P---E-----> time
     |            |     |                                |         |
     |            |     +------------- TTFM -------------+         |
     |            +-------------- ATFF ------------------+         |
     +--------------------- RTFF ------------------------+         |
     +--------------------- Session Time --------------------------+

Network Initiated Timing

     R (NILR MS-Based)
     |
     +----------AAA-----S----------------------I---------F---I-----E-----> time
     |            |     |                                |         |
     |            |     +------------- TTFF -------------+         |
     |            +-------------- ATFF ------------------+         |
     +--------------------- RTFF ------------------------+         |  
     +--------------------- Session Time --------------------------+

MS-Assisted

     R (NILR MS-Assisted)
     |                  +---- TTPR (position received) --------+
     |                  |                                      |
     +------------A-----S--------------------------------M-----P-----E---> time
     |            |     |                                |           |
     |            |     +------------- TTFM -------------+           |
     |            +-------------- ATFF ------------------+           |
     +--------------------- RTFF ------------------------+           |
     +--------------------- Session Time ----------------------------+
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Defines