#include < gps.h >

שדות נתונים
size_t	גודל

GnssMeasurementFlags	דגלים

int16_t	svid

GnssConstellationType	קבוצת כוכבים

לְהַכפִּיל	זמן_הזזת_נס

GnssMeasurementState	מדינה

int64_t	receive_sv_time_in_ns

int64_t	קיבל_sv_זמן_אי-ודאות_ב_נס

לְהַכפִּיל	c_n0_dbhz

לְהַכפִּיל	pseudorange_rate_mps

לְהַכפִּיל	pseudorange_rate_uncertainty_mps

GnssAccumulatedDeltaRangeState	מצב_טווח_מצטבר_delta

לְהַכפִּיל	טווח_מצטבר_דלתא

לְהַכפִּיל	צבור_מחסום_טווח_מחסום_מ

לָצוּף	carrier_frequency_hz

int64_t	carrier_cycles

לְהַכפִּיל	carrier_phase

לְהַכפִּיל	אי-ודאות_שלב_נשא

GnssMultipathIndicator	multipath_indicator

לְהַכפִּיל	snr_db

תיאור מפורט

מייצג מדידת GNSS, הוא מכיל מידע גולמי ומחושב.

עצמאות - כל מידע מדידת האות (למשל sv_time, pseudorange_rate, multipath_indicator) המדווח במבנה זה צריך להיות מבוסס על מדידות אותות GNSS בלבד. אינך רשאי לסנתז מדידות על ידי חישוב או דיווח על מדידות צפויות על סמך מיקום, מהירות או זמן ידועים או משוערים.

הגדרה בשורה 1656 של הקובץ gps.h.

תיעוד שטח

כפול טווח_מצטבר_דלתא

טווח דלתא מצטבר מאז איפוס הערוץ האחרון במטרים. ערך חיובי מציין שה-SV מתרחק מהמקלט.

הסימן של 'טווח הדלתא המצטבר' והקשר שלו לסימן 'פאזה נושאת' ניתן על ידי המשוואה: טווח דלתא מצטבר = -k * פאזה נושאת (כאשר k הוא קבוע)

ערך זה חייב להיות מאוכלס אם 'מצב טווח דלתא מצטבר' != GPS_ADR_STATE_UNKNOWN. עם זאת, צפוי שהנתונים מדויקים רק כאשר: 'מצב טווח דלתא מצטבר' == GPS_ADR_STATE_VALID.

הגדרה בשורה 1835 של הקובץ gps.h.

GnssAccumulatedDeltaRangeState accumulated_delta_range_state

מצב טווח הדלתא המצטבר. זה מציין אם ADR מאופס או שיש החלקת מחזור (המעידה על אובדן הנעילה).

זהו ערך חובה.

הגדרה בשורה 1821 של הקובץ gps.h.

כפול מצטבר_אי-ודאות_טווח_דלתא

אי ודאות 1-Sigma של טווח הדלתא המצטבר במטרים. ערך זה חייב להיות מאוכלס אם 'מצב טווח דלתא מצטבר' != GPS_ADR_STATE_UNKNOWN.

הגדרה בשורה 1841 של הקובץ gps.h.

כפול c_n0_dbhz

צפיפות הספק לרעש ב-dB-Hz, בדרך כלל בטווח [0, 63]. הוא מכיל את ערך C/N0 הנמדד עבור האות ביציאת האנטנה.

זהו ערך חובה.

הגדרה בשורה 1778 של הקובץ gps.h.

int64_t carrier_cycles

מספר מחזורי הספק המלאים בין הלוויין למקלט. תדר הייחוס ניתן על ידי השדה 'carrier_frequency_hz'. ניתן להסיק אינדיקציות של החלקות מחזור ואיפוסים אפשריים בהצטברות של ערך זה מהדגלים של accumulated_delta_range_state.

אם הנתונים זמינים, 'דגלים' חייבים להכיל GNSS_MEASUREMENT_HAS_CARRIER_CYCLES.

הגדרה בשורה 1861 של הקובץ gps.h.

float carrier_frequency_hz

תדר הספק שבו קודים והודעות מאופנים, זה יכול להיות L1 או L2. אם השדה לא מוגדר, ההנחה היא שתדר הנשא הוא L1.

אם הנתונים זמינים, 'דגלים' חייבים להכיל GNSS_MEASUREMENT_HAS_CARRIER_FREQUENCY.

הגדרה בשורה 1850 של הקובץ gps.h.

כפול carrier_phase

שלב ה-RF שזוהה על ידי המקלט, בטווח [0.0, 1.0]. זה בדרך כלל החלק השברי של מדידת שלב הנשא המלא.

תדר הייחוס ניתן על ידי השדה 'carrier_frequency_hz'. הערך מכיל את 'אי הוודאות של שלב הנשא' בו.

אם הנתונים זמינים, 'דגלים' חייבים להכיל GNSS_MEASUREMENT_HAS_CARRIER_PHASE.

הגדרה בשורה 1873 של הקובץ gps.h.

אי-ודאות_פאזת_נשא כפולה

אי ודאות 1-Sigma של שלב הנשא. אם הנתונים זמינים, 'דגלים' חייבים להכיל GNSS_MEASUREMENT_HAS_CARRIER_PHASE_UNCERTAINTY.

הגדרה בשורה 1880 של הקובץ gps.h.

קונסטלציה GnssConstellationType

מגדיר את קבוצת הכוכבים של ה-SV הנתון. הערך צריך להיות אחד מאותם קבועים GNSS_CONSTELLATION_*

הגדרה בשורה 1673 של הקובץ gps.h.

דגלים של GnssMeasurementFlags

קבוצה של דגלים המציינת את תקפות השדות במבנה נתונים זה.

הגדרה בשורה 1661 של הקובץ gps.h.

GnssMultipathIndicator multipath_indicator

ספירה המציינת את מצב ה'רב-נתיבים' של האירוע.

מחוון ריבוי הנתיבים נועד לדווח על נוכחות של אותות חופפים המתבטאים בפסגות מתאם מעוותות.

אם יש צורת שיא מתאם מעוותת, דווח ש-multipath הוא GNSS_MULTIPATH_INDICATOR_PRESENT.
אם אין צורת שיא מתאם מעוותת, דווח על GNSS_MULTIPATH_INDICATOR_NOT_PRESENT
אם האותות חלשים מכדי להבחין במידע זה, דווח על GNSS_MULTIPATH_INDICATOR_UNKNOWN

דוגמה: בעת ביצוע מבחן ביצועי ריבוי נתיבים חופף סטנדרטי (3GPP TS 34.171) מחוון Multipath צריך לדווח על GNSS_MULTIPATH_INDICATOR_PRESENT עבור אותם אותות שנמצאים במעקב, ומכילים ריבוי נתיבים, ו-GNSS_MULTIPATH_INDICATOR_NOT_PRESENT עבור אותם אותות שאינם מכילים ריבוי נתיבים.

הגדרה בשורה 1901 של הקובץ gps.h.

כפול pseudorange_rate_mps

קצב פסאודו טווח בחותמת הזמן ב-m/s. התיקון של ערך Pseudorange Rate נתון כולל תיקונים עבור שגיאות בתדר של מקלט ושעון לוויין. ודא ששדה זה אינו תלוי (ראה הערה בחלק העליון של מבנה GnssMeasurement .)

חובה לספק את 'קצב פסאודו-טווח' 'לא מתוקן', ולספק גם את שדה 'הסחף' של GpsClock (כאשר מספקים את שיעור הפסאודו-טווח הלא מתוקן, אל תחיל את התיקונים שתוארו לעיל).

הערך כולל את 'אי הוודאות של שיעור הפסאודור' שבו. ערך 'לא מתוקן' חיובי מציין שה-SV מתרחק מהמקלט.

הסימן של 'קצב פסאודור טווח' ה'לא מתוקן' והקשר שלו לסימן 'הסטת דופלר' ניתן במשוואה: קצב פסאודור = -k * תזוזת דופלר (כאשר k הוא קבוע)

זה אמור להיות קצב הפסאודור המדויק ביותר הקיים, בהתבסס על מדידות אותות טריים מערוץ זה.

חובה לספק ערך זה באיכות PRR אופייני לשלב הספק (כמה ס"מ/שנייה לשנייה של אי ודאות, או טוב יותר) - כאשר האותות חזקים ויציבים מספיק, למשל אותות מסימולטור GPS ב->= 35 dB-Hz.

הגדרה בשורה 1805 של הקובץ gps.h.

כפול pseudorange_rate_uncertainty_mps

אי ודאות 1-Sigma של pseudorange_rate_mps. אי הוודאות מיוצגת כערך מוחלט (חד צדדי).

זהו ערך חובה.

הגדרה בשורה 1813 של הקובץ gps.h.

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 שבוע ] : 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 מוגדר] 0 סנכרון סמל: [ 0ms : GNSS_MEASUREMENT_STATE_SYMBOL_SYNC מוגדר סנכרון סיביות : [ 0 20ms ] : GNSS_MEASUREMENT_STATE_BIT_SYNC מוגדר סנכרון מחרוזת : [ 0 2s ] : GNSS_MEASUREMENT_STATE_GLO_STRING_SYNC : [MEASUREMENT_STATE_BIT_SYNC מוגדר 0 2s ] : GNSS_MEASUREMENT_STATE_GLO_STRING_SYNC :] _MEASUREMENT_STATE_BIT_SYNC מוגדר LO_TOD_DECODED מוגדר

עבור Beidou, זהו: זמן בידו שהתקבל בשבוע, בזמן המדידה בננו-שניות.

בהינתן מצב הסנכרון הגבוה ביותר שניתן להשיג, לכל לוויין, הטווח התקף עבור שדה זה יכול להיות: חיפוש: [0] : GNSS_MEASUREMENT_STATE_UNKNOWN נעילת קוד C/A: [0 1ms ] : GNSS_MEASUREMENT_STATE_CODE_LOCK מוגדר [ סינכרון סיביות (D2): 0 2ms ] : GNSS_MEASUREMENT_STATE_BDS_D2_BIT_SYNC מוגדר סנכרון סיביות (D1): [0 20ms ] : GNSS_MEASUREMENT_STATE_BIT_SYNC מוגדר תת-מסגרת (D2): [ 0 0.6s ] : Subframe_20msY 1): [ 0 6s ] : GNSS_MEASUREMENT_STATE_SUBFRAME_SYNC מוגדר זמן של שבוע: [0 שבוע אחד]: GNSS_MEASUREMENT_STATE_TOW_DECODED מוגדר

עבור גלילאו, זהו: זמן גליליאו שהתקבל בשבוע, בזמן המדידה בננו-שניות.

נעילת קוד E1BC : [ 0 4ms ] : GNSS_MEASUREMENT_STATE_GAL_E1BC_CODE_LOCK מוגדר E1C נעילת קוד 2: [ 0 100ms ] : GNSS_MEASUREMENT_STATE_GAL_E1C_2ND_CODE_LOCK מוגדר

דף E1B : [ 0 2s ] : GNSS_MEASUREMENT_STATE_GAL_E1B_PAGE_SYNC מוגדר זמן בשבוע: [ 0 1שבוע ] : GNSS_MEASUREMENT_STATE_TOW_DECODED מוגדר

עבור SBAS, זהו: זמן SBAS שהתקבל, בזמן המדידה בננו-שניות.

בהינתן מצב הסנכרון הגבוה ביותר שניתן להשיג, לכל לוויין, הטווח התקף עבור שדה זה יכול להיות: חיפוש: [0] : GNSS_MEASUREMENT_STATE_UNKNOWN נעילת קוד C/A: [0 1ms] : GNSS_MEASUREMENT_STATE_CODE_LOCK מוגדר סנכרון סמל 2: [ ] : GNSS_MEASUREMENT_STATE_SYMBOL_SYNC מוגדר הודעה : [ 0 1s ] : GNSS_MEASUREMENT_STATE_SBAS_SYNC מוגדר

הגדרה בשורה 1763 של הקובץ gps.h.

int64_t receive_sv_time_uncertainty_in_ns

אי ודאות 1-Sigma של זמן ה-GPS המתקבל בננו-שניות.

ערך זה חייב להיות מאוכלס אם 'מצב' != GPS_MEASUREMENT_STATE_UNKNOWN.

הגדרה בשורה 1770 של הקובץ gps.h.

size_t size

מוגדר ל-sizeof(GpsMeasurement)

הגדרה בשורה 1658 של הקובץ gps.h.

כפול snr_db

יחס אות לרעש בפלט מתאם ב-dB. אם הנתונים זמינים, 'דגלים' חייבים להכיל GNSS_MEASUREMENT_HAS_SNR. זהו יחס ההספק של "גובה שיא המתאם מעל רצפת הרעש הנצפית" לבין "הרעש RMS".

הגדרה בשורה 1909 של הקובץ gps.h.

מצב GnssMeasurementState

לכל מצב סנכרון לווין. הוא מייצג את מצב הסנכרון הנוכחי עבור הלוויין המשויך. בהתבסס על מצב הסנכרון, יש לפרש את השדה 'גרר GPS שהתקבל' בהתאם.

זהו ערך חובה.

הגדרה בשורה 1694 של הקובץ gps.h.

int16_t svid

מספר מזהה רכב לוויני, כפי שהוגדר ב- GnssSvInfo::svid זהו ערך חובה.

הגדרה בשורה 1667 של הקובץ gps.h.

כפול זמן_קיזוז_נס

קיזוז זמן שבו נלקחה המדידה בננו-שניות. הזמן של מקלט הייחוס מוגדר על ידי GpsData::clock::time_ns ויש לפרש אותו באותו אופן כפי שמצוין על ידי GpsClock::type .

הסימן של time_offset_ns ניתן על ידי המשוואה הבאה: זמן מדידה = GpsClock::time_ns + time_offset_ns

הוא מספק חותמת זמן אינדיבידואלית למדידה, ומאפשר דיוק תת-ננושניות. זהו ערך חובה.

הגדרה בשורה 1686 של הקובץ gps.h.

התיעוד עבור מבנה זה נוצר מהקובץ הבא:

hardware/libhardware/include/hardware/ gps.h

GnssMeasurement Struct Reference

שדות נתונים

תיאור מפורט

תיעוד שטח