Linux SDK (lite-qmi)  MBPL_SDK_R25_ENG3
SatelliteSysMeasReportEnabledConst Struct Reference

#include <loc.h>

Data Fields

uint16_t gnssSvId
 
uint8_t gloFrequency
 
uint32_t svStatus
 
uint16_t validMask
 
uint8_t healthStatus
 
uint8_t svInfoMask
 
uint64_t validMeasStatusMask
 
uint64_t measurementStatus
 
uint16_t CNo
 
uint16_t gloRfLoss
 
uint32_t measLatency
 
uint32_t svTimeMs
 
float svTimeSubMs
 
float svTimeUncMs
 
float dopplerShift
 
float dopplerShiftUnc
 
uint8_t dopplerAccel_valid
 
float dopplerAccel
 
uint8_t lossOfLock
 
float multipathEstimate
 
float fineSpeed
 
float fineSpeedUnc
 
double carrierPhase
 
uint8_t cycleSlipCount
 
float svAzimuth
 
float svElevation
 

Detailed Description

Satellite System Measurement Report for Enabled Constellation Info

Parameters
gnssSvId
  • GNSS SV ID. Range:
  • For GPS: 1 to 32
  • For GLONASS: 65 to 96. When slot-number to SV ID mapping is unknown, set as 255.
  • For QZSS: 193 to 197
  • For BDS: 201 to 237
  • For Galileo: 301 to 336
  • For NavIC: 401 to 414
gloFrequency
  • GLONASS frequency number + 8. Valid only for a GLONASS system and must be ignored for all other systems.
  • Range: 1 to 14
svStatus
  • Satellite search state.
    • Valid values:
      • eQMI_LOC_SV_STATUS_IDLE (1) - SV is not being actively processed
      • eQMI_LOC_SV_STATUS_SEARCH (2) - The system is searching for this SV
      • eQMI_LOC_SV_STATUS_TRACK (3) - SV is being tracked
validMask
  • Validity mask (0 = Not valid; 1 = Valid).
    • QMI_LOC_SV_HEALTH_VALID (0x01) - SV health information is valid
    • QMI_LOC_SV_MULTIPATH_EST_VALID (0x02) - Multipath estimate for SV is valid
    • QMI_LOC_SV_FINE_SPEED_VALID (0x04) - Fine speed for SV is valid
    • QMI_LOC_SV_FINE_SPEED_UNC_VALID (0x08) - Fine speed uncertainty for SV is valid
    • QMI_LOC_SV_CARRIER_PHASE_VALID (0x10) - Carrier phase for SV is valid
    • QMI_LOC_SV_SV_DIRECTION_VALID (0x20) - SV direction information for SV is valid
    • QMI_LOC_SV_CYCLESLIP_COUNT_VALID (0x40) - Cycle slip count information is valid
    • QMI_LOC_SV_LOSSOFLOCK_VALID (0x80) - Loss of lock information is valid
healthStatus
  • Health status.
  • Range: 0 to 1, where 0 = unhealthy, 1 = healthy
svInfoMask
  • Indicates whether almanac and ephemeris information is available.
  • Valid values:
    • QMI_LOC_SVINFO_MASK_HAS_EPHEMERIS (0x01) - Ephemeris is available for this SV
    • QMI_LOC_SVINFO_MASK_HAS_ALMANAC (0x02) - Almanac is available for this SV
validMeasStatusMask
  • Validity mask for measurement status information.
  • A set bit in validMeasStatusMask indicates that the corresponding bit in measurementStatus has valid status information:
    • Valid masks:
      • QMI_LOC_MASK_MEAS_STATUS_SM_STAT_BIT_VALID (0x00000001) - Satellite time in submilliseconds (code-phase)
      • QMI_LOC_MASK_MEAS_STATUS_SB_STAT_BIT_VALID (0x00000002) - Satellite sub-bit time
      • QMI_LOC_MASK_MEAS_STATUS_MS_STAT_BIT_VALID (0x00000004) - Satellite time in milliseconds
      • QMI_LOC_MASK_MEAS_STATUS_BE_CONFIRM_STAT_BIT_VALID (0x00000008) - Signal bit edge is confirmed
      • QMI_LOC_MASK_MEAS_STATUS_VEL_STAT_BIT_VALID (0x00000010) - Satellite Doppler is measured
      • QMI_LOC_MASK_MEAS_STATUS_VEL_FINE_STAT_BIT_VALID (0x00000020) - Fine/coarse Doppler measurement indicator
      • QMI_LOC_MASK_MEAS_STATUS_LP_STAT_BIT_VALID (0x00000040) - TRUE/FALSE - Lock Point is valid/invalid
      • QMI_LOC_MASK_MEAS_STATUS_LP_POS_STAT_BIT_VALID (0x00000080) - TRUE/FALSE : Lock Point is positive/negative
      • QMI_LOC_MASK_MEAS_STATUS_FROM_RNG_DIFF_STAT_BIT_VALID (0x00000200) - Range update from satellite differences
      • QMI_LOC_MASK_MEAS_STATUS_FROM_VE_DIFF_STAT_BIT_VALID (0x00000400) - Doppler update from satellite differences
      • QMI_LOC_MASK_MEAS_STATUS_GNSS_FRESH_MEAS_STAT_BIT_VALID (0x08000000) - TRUE - Fresh GNSS measurement observed in the last second
      • QMI_LOC_MASK_MEAS_STATUS_RESERVED_UNUSED_1_BIT_VALID (0x10000000) - Reserved for future use
      • QMI_LOC_MASK_MEAS_STATUS_RESERVED_UNUSED_2_BIT_VALID (0x20000000) - Reserved for future use
      • QMI_LOC_MASK_MEAS_STATUS_100MS_STAT_BIT_VALID (0x40000000) - TRUE - SV time known with 100 ms ambiguity
      • QMI_LOC_MASK_MEAS_STATUS_2S_STAT_BIT_VALID (0x80000000) - TRUE - SV time known with 2 seconds ambiguity MSB 0xFFC0000000000000 bits indicate the validity of DONT_USE bits
measurementStatus
  • Bitmask indicating the SV measurement status.
    • Valid bitmasks:
      • QMI_LOC_MASK_MEAS_STATUS_SM_VALID (0x00000001) - Satellite time in submilliseconds (code phase) is known
      • QMI_LOC_MASK_MEAS_STATUS_SB_VALID (0x00000002) - Satellite sub-bit time is known
      • QMI_LOC_MASK_MEAS_STATUS_MS_VALID (0x00000004) - Satellite time in milliseconds is known
      • QMI_LOC_MASK_MEAS_STATUS_BE_CONFIRM (0x00000008) - Signal bit edge is confirmed
      • QMI_LOC_MASK_MEAS_STATUS_VELOCITY_VALID (0x00000010) - Satellite Doppler is measured
      • QMI_LOC_MASK_MEAS_STATUS_VELOCITY_FINE (0x00000020) - TRUE - Fine Doppler is measured, FALSE: Coarse Doppler is measured
      • QMI_LOC_MASK_MEAS_STATUS_LP_VALID (0x00000040) - TRUE/FALSE - Lock Point is valid/invalid
      • QMI_LOC_MASK_MEAS_STATUS_LP_POS_VALID (0x00000080) - TRUE/FALSE - Lock Point is positive/negative
      • QMI_LOC_MASK_MEAS_STATUS_FROM_RNG_DIFF (0x00000200) - Range update from satellite differences is measured
      • QMI_LOC_MASK_MEAS_STATUS_FROM_VE_DIFF (0x00000400) - Doppler update from satellite differences is measured
      • QMI_LOC_MASK_MEAS_STATUS_GNSS_FRESH_MEAS_VALID (0x08000000) - TRUE - Fresh GNSS measurement observed in last second If any MSB bit in 0xFFC0000000000000 DONT_USE is set, the measurement must not be used by the client.
CNo
  • Carrier to noise ratio at antenna.
  • Units: dBHz
  • Scale: 0.1
gloRfLoss
  • GLONASS RF loss reference to the antenna.
  • Units: dB
  • Scale: 0.1
measLatency
  • Age of the measurement. A positive value means the measurement precedes the reference time.
  • Units: Milliseconds
svTimeMs
  • Satellite time in milliseconds.
  • For GPS, BDS, GAL, and QZSS - Range is 0 through (604800000-1)
  • For GLONASS - Range is 0 through (86400000-1)
  • Units: Milliseconds Valid when the QMI_LOC_MEAS_STATUS_MS_VALID bit is set in the measurement status.
  • Note: All SV times in the current measurement block are already propagated to a common reference time epoch.
svTimeSubMs
  • Satellite time in submilliseconds. Total SV Time = svMs + svSubMs
  • Units: Milliseconds
svTimeUncMs
  • Satellite time uncertainty.
  • Units: Milliseconds
dopplerShift
  • Satellite Doppler.
  • Units: Meters per second
dopplerShiftUnc
  • Satellite Doppler uncertainty.
  • Units: Meters per second
dopplerAccel_valid
  • Validity for Doppler acceleration.
dopplerAccel
  • Satellite Doppler acceleration.
  • Units: Hz/second
lossOfLock
  • Loss of signal lock indicator.
  • 0 - Signal is in continuous track
  • 1 - Signal is not in track
multipathEstimate
  • Estimate of multipath in a measurement.
  • Units: Meters
fineSpeed
  • Carrier phase derived speed.
  • Units: Meters per second
fineSpeedUnc
  • Carrier phase derived speed uncertainty.
  • Units: Meters per second
carrierPhase
  • Carrier phase measurement (L1 cycles).
cycleSlipCount
  • Increments when a cycle slip is detected.
svAzimuth
  • Satellite azimuth.
  • Units: Radians
  • Range: 0 to 2*pi()
svElevation
  • Satellite elevation.
  • Units: Radians
  • Range: 0 to pi()/2

The documentation for this struct was generated from the following file: