GnssMeasurement 結構參考

GnssMeasurement 結構參考

#include < gps.h >

資料欄位

尺寸_t尺寸
Gnss測量標誌旗幟
int16_t斯維德
Gnss星座類型星座
雙倍的時間偏移量ns
Gnss測量狀態狀態
int64_t收到的 sv_time_in_ns
int64_t receive_sv_time_uncertainty_in_ns
雙倍的c_n0_dbhz
雙倍的偽距速率mps
雙倍的偽距率_不確定性_mps
GnssAccumulatedDeltaRangeState累積增量範圍狀態
雙倍的累積_增量_範圍_m
雙倍的cumulative_delta_range_uncertainty_m
漂浮載波頻率_hz
int64_t載波週期
雙倍的載波相位
雙倍的載波相位不確定度
Gnss多路徑指示器多路徑指示器
雙倍的信噪比資料庫

詳細說明

表示 GNSS 測量,它包含原始資訊和計算資訊。

獨立性 - 此結構中報告的所有訊號測量資訊(例如 sv_time、pseudorange_rate、multipath_indicator)應僅基於 GNSS 訊號測量。您不得基於已知或估計的位置、速度或時間計算或報告預期測量值來綜合測量值。

定義位於檔案gps.h的第1656行。

現場文檔

雙累積_delta_range_m

自上次通道重置以來的累積增量範圍(以公尺為單位)。正值表示 SV 正在遠離接收器。

「累積增量範圍」的符號及其與「載波相位」符號的關係由以下公式給出:累積增量範圍 = -k * 載波相位(其中 k 是常數)

如果「累積增量距離狀態」!= GPS_ADR_STATE_UNKNOWN,則必須填入此值。但是,預計資料僅在以下情況下準確:「累積增量範圍狀態」== GPS_ADR_STATE_VALID。

定義位於檔案gps.h的第1835行。

累積增量範圍的狀態。它指示ADR是否重置或是否有周跳(表示失鎖)。

這是一個強制值。

檔案gps.h1821行的定義。

雙累積_delta_range_uncertainty_m

累積增量範圍的 1-Sigma 不確定度(以公尺為單位)。如果「累積增量距離狀態」!= GPS_ADR_STATE_UNKNOWN,則必須填入此值。

檔案gps.h1841行的定義。

雙 c_n0_dbhz

載噪比密度(以 dB-Hz 為單位),通常範圍為 [0, 63]。它包含天線端口處訊號的測量 C/N0 值。

這是一個強制值。

檔案gps.h1778行的定義。

int64_t 載波週期

衛星和接收器之間的完整載波週期數。參考頻率由欄位「Carrier_Frequency_hz」給出。可以從accumulated_delta_range_state標誌推斷出該值的累積中可能的周跳和重置的指示。

如果資料可用,「flags」必須包含 GNSS_MEASUREMENT_HAS_CARRIER_CYCLES。

定義位於檔案gps.h的第1861行。

浮動載波頻率_hz

調變代碼和訊息的載波頻率,可以是L1或L2。如果未設定該字段,則假定載波頻率為 L1。

如果資料可用,「flags」必須包含 GNSS_MEASUREMENT_HAS_CARRIER_FREQUENCY。

檔案gps.h1850行的定義。

雙載波相位

接收器偵測到的 RF 相位,範圍為 [0.0, 1.0]。這通常是完整載波相位測量的小數部分。

參考頻率由欄位「Carrier_Frequency_hz」給出。該值包含“載波相位不確定性”。

如果資料可用,「flags」必須包含 GNSS_MEASUREMENT_HAS_CARRIER_PHASE。

檔案gps.h1873行的定義。

雙載波相位不確定性

載波相位的 1-Sigma 不確定性。如果資料可用,「標誌」必須包含 GNSS_MEASUREMENT_HAS_CARRIER_PHASE_UNCERTAINTY。

檔案gps.h1880行的定義。

定義給定 SV 的星座。值應該是 GNSS_CONSTELLATION_* 常數之一

定義位於檔案gps.h的第1673行。

一組標誌,指示該資料結構中欄位的有效性。

定義位於檔案gps.h的第1661行。

GnssMultipathIndicator multipath_indicator

指示事件的「多路徑」狀態的枚舉。

多路徑指示器旨在報告重疊訊號的存在,這些訊號表現為失真的相關峰值。

  • 如果存在扭曲的相關峰值形狀,則報告多徑為 GNSS_MULTIPATH_INDICATOR_PRESENT。
  • 如果不存在扭曲的相關峰形狀,則報告 GNSS_MULTIPATH_INDICATOR_NOT_PRESENT
  • 如果訊號太弱而無法識別此訊息,請報告 GNSS_MULTIPATH_INDICATOR_UNKNOWN

範例:在進行標準化重疊多路徑性能測試 (3GPP TS 34.171) 時,多徑指示器應針對那些被追蹤且包含多路徑的訊號報告 GNSS_MULTIPATH_INDICATOR_PRESENT,並針對那些被追蹤且不包含多路徑的訊號報告 GNSS_MULTIPATH_INDICATOR_NOT_PRESENTENT。

檔案gps.h第 1901行的定義。

雙偽距率_mps

時間戳處的偽距速率(以公尺/秒為單位)。給定偽距速率值的校正包括對接收機和衛星時脈頻率誤差的校正。確保該欄位是獨立的(請參閱GnssMeasurement結構頂部的註釋。)

必須提供“未校正的”“偽距率”,並提供GpsClock的“漂移”欄位(當提供未校正的偽距率時,請勿應用上述校正。)

該值包含“偽距速率不確定性”。正的“未校正”值表示 SV 正在遠離接收器。

「未校正」「偽距率」的符號及其與「多普勒頻移」符號的關係由下列方程式給出:偽距率 = -k * 多普勒頻移(其中 k 是常數)

根據來自該通道的最新訊號測量,這應該是最準確的偽距速率。

當訊號足夠強且穩定時,例如來自 GPS 模擬器的訊號 >= 35 dB-Hz 時,必須以典型的載波相位 PRR 品質(每秒幾公分/秒的不確定性或更好)提供該值。

定義位於檔案gps.h的第1805行。

雙偽距_rate_uncertainty_mps

偽距率_mps 的 1-Sigma 不確定性。不確定性表示為絕對(單邊)值。

這是一個強制值。

檔案gps.h1813行的定義。

int64_t receive_sv_time_in_ns

在測量時間接收到的 GNSS 週時間(以奈秒為單位)。確保該欄位是獨立的(請參閱GnssMeasurement結構頂部的註釋。)

對於 GPS 和 QZSS,這是:在測量時間接收到的 GPS 週時間(以奈秒為單位)。該值相對於當前 GPS 週的開始時間。

給定每個衛星可以達到的最高同步狀態,該字段的有效範圍可以是: 搜索: [ 0 ] : GNSS_MEASUREMENT_STATE_UNKNOWN C/A 代碼鎖定 : [ 0 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK 已設置 位同步 : [ 0 20ms ] : GNSS_MEASUREMENT_STATE_BIT_SYNC已設定子訊框同步: [ 0 6s ] : GNSS_MEASUREMENT_STATE_SUBFRAME_SYNC 已設定TOW 解碼: [ 0 1week ] : GNSS_MEASUREMENT_STATE_TOW_DECODED 已設定

請注意:如果整數毫秒存在任何歧義,則應在「狀態」欄位中相應地設定 GNSS_MEASUREMENT_STATE_MSEC_AMBIGUOUS。

如果 'state' != GNSS_MEASUREMENT_STATE_UNKNOWN,則必須填入此值。

對於 Glonass,這是:一天中接收到的 Glonass 時間,測量時間(以奈秒為單位)。

給定每個衛星可以達到的最高同步狀態,此欄位的有效範圍可以是: 搜尋: [ 0 ] : GNSS_MEASUREMENT_STATE_UNKNOWN C/A 代碼鎖定 : [ 0 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK 定型已設定 單元符號同步 : GNSS_MEASUREMENT_STATE_CODE_LOCK 已設定 單元符號同步 : 0:00647:70947:40: 已設定 單元符號同步 : 0:2074: 4:2_J4: 47:474: 4:2_J3: 47:47_J4:2_9 99 + 4:2_94: [37_9 標記表 4:97_94: 4:2_J3: 47:97_9 + 4:2_J4:S;已設定位元同步: [ 0 20ms ] : GNSS_MEASUREMENT_STATE_BIT_SYNC 已設定字串同步: [ 0 2s ] : GNSS_MEASURMENT_STATE_GLO_STRING_SYNC 已設定一天中的時間: [ 0 1day ] : GN =DMEING_SYNC 已設定一天中的時間: [ 0 1day ] : GN 錯誤已設定

對於北斗,這是:在測量時間(以奈秒為單位)接收到的北斗一周時間。

給定每個衛星可以達到的最高同步狀態,此欄位的有效範圍可以是: 搜尋: [ 0 ] : GNSS_MEASUREMENT_STATE_UNKNOWN C/A 代碼鎖定: [ 0 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK 已設定 位元同步 (D2): 0 位元同步] : GNSS_MEASUREMENT_STATE_BDS_D2_BIT_SYNC 已設定位元同步(D1): [ 0 20ms ] : GNSS_MEASUREMENT_STATE_BIT_SYNC 已設定子訊框(D2): [ 0 0.6s ] : GN_EUDDDPDDicALENTSU​​DD2): [ 0 4SUD:D. 0 6s ] : GNSS_MEASUREMENT_STATE_SUBFRAME_SYNC 設定的時間週: [ 0 1week ] : GNSS_MEASUREMENT_STATE_TOW_DECODED 已設定

對於伽利略,這是:在測量時間(以奈秒為單位)收到的伽利略一周時間。

E1BC 代碼鎖:[ 0 4ms ] :設定 GNSS_MEASUREMENT_STATE_GAL_E1BC_CODE_LOCK E1C 第二個代碼鎖:[ 0 100ms ] :設定 GNSS_MEASURMENT_STATE_GAL_E1C_2ND_CODE_CK

E1B 頁面:[ 0 2s ]:設定 GNSS_MEASUREMENT_STATE_GAL_E1B_PAGE_SYNC 一週時間:[0 1week]:設定 GNSS_MEASUREMENT_STATE_TOW_DECODED

對於 SBAS,這是:測量時間處接收到的 SBAS 時間(以奈秒為單位)。

給定每個衛星可以達到的最高同步狀態,此欄位的有效範圍可以是: 搜尋:[ 0 ] : GNSS_MEASUREMENT_STATE_UNKNOWN C/A 代碼鎖定:[ 0 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK 已設定 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK 已設定 符號同步:STAT 0 2007]P44ms_44ms44ms 符號同步:STAT 24ms% 47_4ms_4ms_44ms_4ms_4ms_44ms_4ms_44ms% 已設定 符號。已設定訊息: [ 0 1s ] : GNSS_MEASUREMENT_STATE_SBAS_SYNC 已設定

定義位於檔案gps.h的第1763行。

int64_t receive_sv_time_uncertainty_in_ns

接收的 GPS 週時間的 1-Sigma 不確定性(以奈秒為單位)。

如果 'state' != GPS_MEASURMENT_STATE_UNKNOWN,則必須填入此值。

檔案gps.h1770行的定義。

size_t 尺寸

設定為 sizeof(GpsMeasurement)

定義位於檔案gps.h的第1658行。

雙snr_db

相關器輸出的訊號雜訊比(以 dB 為單位)。如果資料可用,「標誌」必須包含 GNSS_MEASUREMENT_HAS_SNR。這是「觀察到的本底雜訊之上的相關峰值高度」與「雜訊 RMS」的功率比。

檔案gps.h第 1909行的定義。

每個衛星同步狀態。它代表關聯衛星的當前同步狀態。根據同步狀態,應相應地解釋「接收到的 GPS 拖曳」欄位。

這是一個強制值。

定義位於檔案gps.h的第1694行。

int16_t svid

衛星車輛 ID 號,如GnssSvInfo::svid中定義。這是一個強制值。

定義位於檔案gps.h的第1667行。

雙倍 time_offset_ns

進行測量的時間偏移(以奈秒為單位)。參考接收器的時間由 GpsData::clock::time_ns 指定,並且應以與GpsClock::type指示的相同方式解釋。

time_offset_ns 的符號由下列等式給出: 測量時間 = GpsClock::time_ns + time_offset_ns

它為測量提供單獨的時間戳,並允許亞納秒精度。這是一個強制值。

定義位於檔案gps.h的第1686行。


該結構的文檔是從以下文件產生的:
  • 硬體/libhardware/include/hardware/gps.h