$PGLOR,1,SMx - Report GPS Summary Information

Pseudo-NMEA sentence $PGLOR,1,SM1 reports summary information about the current first fix (FF) or first measurement.

This is typically information known up to the last piece of protocol is sent to an AGPS network entity (e.g. control plane or SUPL server).

Pseudo-NMEA sentence $PGLOR,1,SM2 reports summary information about the network consequences of reporting the first fix or measurement. This is typically information that indicates network reaction or acknowledgement of GPS activities that may or may not happen.

See $PGLOR,FIX for information about subsequent fixes.

Summary 1 Sentence

  $PGLOR,1,SM1,<TTFFM>,<ATFF>,<RTFF>,<STIME>,<SP><STYPE><NS>,<ASST>,<RLS>,<SS>,<UTC>,<LAT>,<LON>,<ALT>,<HDOP>,<POSERR>*CC

Where:

  • PGLOR Proprietary NMEA sentence identifier for Broadcom
  • SM1 Summary 1 sentence identifier
  • 1 Version 1 of this sentence
  • TTFFM "Time To First Fix" or "Time To First Measurement." Units 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.
  • STIME Request start until end of session sent to 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 is a single letter:
    • U - Unspecified
    • S - Set Initiated
    • N - Network Initiated
    • W - Stay Warm (LBS sync?)
    • A - Get Assistance
  • NS Network status is a single letter:
    • C - Connected, Successful
    • F - The last protocol result failed.

    • D - Disconnected: The session ended without a protocol failure, but the protocol was too slow and didn't contribute assistance.
    • A - Autonomous, unsuccessful
    • U - Unspecified
  • 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.
  • UTC Time of the fix in UTC
  • LAT Latitude in degrees of the position (W is negative).
  • LON Longitude in degrees of the position (S is negative).
  • ALT Altitude in meters of the position.
  • HDOP Horizontal dilution of precision of the fix.
  • POSERR Estimated position error of the fix (in meters). An empty field indicates a position fix failure.
  • CC Standard NMEA checksum

EXAMPLE:

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

Summary 2 Sentence

  $PGLOR,1,SM2,<TYPE>,<ACK>,<NTIME>*CC

Where:

  • PGLOR Proprietary NMEA sentence identifier for Broadcom
  • SM2 Summary 2 sentence identifier for network status
  • 1 Version 1 of this sentence
  • TYPE of summary report:
    • PROTO - Local bearer protocol send status.
    • POS - The network has compute-position status.
  • ACK Success or failure of the network type:
    • ACK - Success: the protocol was sent or position received.
    • NAK - Failure.
  • NTIME Time from end of session sent until this message received. Unit are seconds.
  • CC Standard NMEA checksum

If POS,ACK or POS,NAK is received before the session has ended, then NTIME is a negative number relative to the start of the current session.

If PROTO is received before end of session, no PGLOR,1,SM2 is produced.

EXAMPLE:

    $PGLOR,1,SM2,POS,ACK,3.3*34

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
  • I - unsuccessful periodic position reported
  • E - End of session sent
  • N - Network ack/nak of end of session

In MS-Assisted TTFP 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

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

Periodic

Subsequent fixes (TTF) are reported in PGLOR,FIX. See pglor_fix.

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

Set Initiated Timing

Session Time is empty.

MS-Based

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

If TTPR is received before E, then it is reported in SM2 as a negative number relative to S:

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

If TTPR is received after N, it is reported in SM2 as a positive number relative to E:

                  +---- TTPR (+position received) -------+
                  |                                      |
     ...----M-----E-------N-----N------------------------P------> time

Network Initiated Timing

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

MS-Assisted

If TTPR is received before N, it is reported in SM2 as a negative number relative to S:

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