#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行。

GnssAccumulatedDeltaRangeStatecumulative_delta_range_state

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

這是一個強制值。

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

雙累積_delta_range_uncertainty_m

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

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

雙 c_n0_dbhz

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

這是一個強制值。

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

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.h第1850行的定義。

雙載波相位

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

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

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

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

雙載波相位不確定性

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

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

GnssConstellationType星座

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

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

GnssMeasurementFlags標誌

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

定義位於檔案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.h第1813行的定義。

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_EUDDDPDDicALENTSUDD2): [ 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.h第1770行的定義。

size_t 尺寸

設定為 sizeof(GpsMeasurement)

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

雙snr_db

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

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

GnssMeasurementState狀態

每個衛星同步狀態。它代表關聯衛星的當前同步狀態。根據同步狀態，應相應地解釋「接收到的 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

GnssMeasurement 結構參考

資料欄位

詳細說明

現場文檔