TerraGenie Connector BT

מדריך המסכים

שלושת המסכים של האפליקציה — מה כל אזור עושה, ומה כל צבע ואייקון מנסים להגיד לך. אפשר לקרוא ברצף, או לקפוץ ישר לרכיב מהתפריט.

Screen 01

מסך הכניסה

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

מה המסך עושה

האפליקציה היא מתווך. היא לא מודדת כלום בעצמה — היא מחברת בין שלושה צדדים ומעבירה ביניהם נתונים: האנטנה שמייצרת את המיקום, שרת ה־RTK ששולח תיקון דיפרנציאלי כדי לדייק אותו, והשרתים של טרה־ג׳יני שמקבלים את התוצאה.

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

מפת המסך

כל מסגרת מקווקוות היא אזור אחד. המספרים מתאימים לרשימה שמתחת.

--/-- --% -- מיל שניות התחל הגדרות אתחול הגדרות חוזר ל-GNSS טרה-ג׳יני POS -- -- GST -- GGA -- מעביר משפטי NMEA לשרת POS↑ GST↑ GGA↑ קבלת תיקון דיפרנציאלי GGA↑ RTCM↓ הגרסה החדשה הזמינה: גרסת האפליקציה: גרסת מערכת ההפעלה: גרסת האנטנה: מזהה המכשיר: 0.2.3 1.2.0 36 1.6.2.1camerasunchongT 55eeb50c5d61fee2 שורת הסטטוס העליונה כפתורי הפעולה פאנל אזהרות מערכת כרטיסי POS · GST · GGA שורות התעבורה בקרי טיסה ומצלמה פאנל הגרסאות 1 2 3 4 5 6 7 מוסתר כשאין בעיה

המסך בתרשים מצולם במצב מנוחה: לפני לחיצה על התחל, בלי חיבור לאנטנה, ובלי אזהרות פתוחות — ולכן הערכים ריקים ופאנל האזהרות לא מופיע.

שבעת האזורים, מלמעלה למטה

1
שורת הסטטוס העליונהסוללת האנטנה, לוויינים, וחמש נורות חיווי לחיבורים.
2
כפתורי הפעולההתחל/עצור, הגדרות, אתחול GNSS, טרה־ג׳יני, ניקוי מטמון.
3
פאנל אזהרות מערכתמופיע רק כשיש בעיה. אם הוא נעלם — הכול תקין.
4
כרטיסי POS · GST · GGAאילו משפטי מיקום מגיעים מהאנטנה, ובאיזו איכות.
5
שורות התעבורההבהוב כתום בכל פעם שמשהו נשלח או מתקבל בפועל.
6
בקרי טיסה ומצלמהשני כפתורים עגולים צפים בצד ימין למטה.
7
פאנל הגרסאותחמש שורות קבועות בתחתית — מה שצריך למסור לתמיכה.

סדר העבודה הרגיל

הגדרותאתחול הגדרות GNSSהתחל. האתחול נדרש פעם אחת לאנטנה, והאפליקציה זוכרת שהוא בוצע גם אחרי סגירה. אם תלחץ התחל בלי שבוצע אתחול, תעלה שאלה אם לאתחל או להתעלם.

שורת הסטטוס העליונה

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

מונה הלוויינים

מוצג כ־בשימוש / נראים. לדוגמה 18/24 — האנטנה רואה 24 לוויינים ומשתמשת ב־18 לחישוב המיקום. המספר השמאלי הוא זה שקובע את איכות הפתרון.

--/-- אומר שאין נתון. הוא מגיע רק כשיש חיבור WiFi לאנטנה, ומתאפס יחד עם הסוללה כשהחיבור נופל — לא כשלוחצים עצור.

מד הסוללה של האנטנה

הצבע נקבע לפי הרמה, ומתחת ל־10% הוא גם מהבהב:

מעל 60%
30–60%
עד 30%
אין נתון

מד ה־ping

המספר בקצה השורה, במילישניות — זמן התגובה מול שרת התמיכה. -- פירושו שעדיין לא נמדד.

חמש נורות החיווי

חמישה ריבועים קטנים בצד ימין של השורה העליונה. רק הראשון נלחץ — כל השאר הם תצוגה בלבד. הכלל משותף לכולם: סגול = עובד על זה, ירוק = מחובר, אדום = תקוע, צהוב = מחובר אבל לא מורשה. סיבוב פירושו חיפוש פעיל.

WiFi לאנטנה · לחיץ

מחבר את הטלפון ישירות לרשת ה־WiFi של האנטנה. זה מה שמאפשר לקרוא ממנה סוללה, לוויינים וגרסה, ולהריץ אתחול. לחיצה מתחברת, לחיצה נוספת מנתקת.

סגול — מנותק מצב רגיל. לחיצה מתחילה חיפוש. #5E35B1
מסתובב — מחפש סורק ומנסה להתחבר. לחכות; אם נמשך, לוודא שהאנטנה דלוקה ובטווח. #5E35B1 · 900ms
ירוק — מחובר יש חיבור לאנטנה. לחיצה מנתקת. #2E7D32
אדום — ה־WiFi בטלפון כבוי בעיה במכשיר, לא באנטנה. להדליק WiFi ותחזור לסגול לבד. #C62828

אינטרנט במכשיר

האם לטלפון עצמו יש אינטרנט אמיתי. בלי זה אין RTK ואין שליחה לשרת.

ירוק — יש אינטרנט#2E7D32
אדום — אין אינטרנטרק שתי אפשרויות כאן, אין מצב ביניים.#C62828

בלוטות׳

הנתונים עצמם מהאנטנה מגיעים בבלוטות׳, לא ב־WiFi. זו הנורה שאומרת אם הצינור הראשי פתוח.

ירוק — מחובר לאנטנהנתונים זורמים.#2E7D32
סגול מסתובב — מחפשהאנטנה מוכרת אבל עדיין לא בטווח או לא ענתה.#5E35B1
סגול קבוע — לא רץלפני לחיצה על התחל, או כשאין צימוד. במקרה של חוסר צימוד תופיע אזהרה בפאנל האזהרות.#5E35B1
אדום — בלוטות׳ כבוי או לא נתמךלהדליק בלוטות׳ בהגדרות הטלפון.#C62828

שרת ה־RTK

התיקון הדיפרנציאלי — מה שמוריד את הדיוק מרמת מטרים לרמת סנטימטרים. בלעדיו האפליקציה עדיין עובדת, אבל המיקום לא יגיע ל־FIX.

ירוק — מחובר ומורשה#2E7D32
צהוב — מחובר אך לא מורשההשרת עונה אבל דוחה את המשתמש. לבדוק שם משתמש, סיסמה ונקודת חיבור בהגדרות.#F9A825
סגול מסתובב — מנסה להתחברמנותק ומנסה שוב. אם זה לא נפסק, לבדוק כתובת ופורט או את האינטרנט.#5E35B1
סגול קבוע — לא רץלפני התחל.#5E35B1

תמיכה מרחוק

החיבור שמאפשר לצוות התמיכה לראות את מצב המכשיר מרחוק. הוא גם מקור מדידת ה־ping שלידו.

ירוק — מחובר#2E7D32
צהוב — מחובר אך לא מורשההמזהה בהגדרות נדחה על ידי השרת.#F9A825
סגול מסתובב — מנסה להתחברמסתובב רק במצב ריצה.#5E35B1
סגול קבוע — לא רץלפני התחל. אין ניסיון חיבור, ולכן גם אין סיבוב.#5E35B1

כפתורי הפעולה

חמישה כפתורים בשלוש שורות. כפתור אפור הוא כפתור מושבת — יש תנאי שעוד לא התקיים.

התחלעצור

התחל · עצור

מפעיל ועוצר את כל הצינור: החיבור לאנטנה, קבלת התיקון מה־RTK והשליחה לשרת. בזמן ריצה הכיתוב הופך ל״עצור״ וכפתור ההגדרות ננעל.

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


מה עצור לא עושה: הוא לא מנתק את ה־WiFi מהאנטנה. הסוללה, הלוויינים והגרסה ממשיכים להתעדכן.

הגדרותאתחול הגדרות חוזר ל-GNSS

הגדרות · אתחול הגדרות GNSS

הגדרות — פרטי החיבור: שם האנטנה, שרת ה־RTK, שרת התמיכה והמזהים. ננעל בזמן ריצה, כי שינוי באמצע עבודה היה שובר את החיבורים הפעילים.

אתחול הגדרות GNSS — מגדיר את האנטנה עצמה דרך ה־WiFi: מצב עבודה, פורמט הודעות, בלוטות׳ ו־IMU. נדרש פעם אחת לאנטנה, והתוצאה נשמרת גם אחרי סגירת האפליקציה. בזמן האתחול כל הכפתורים ננעלים ומופיע חיווי טעינה.


הכיתוב על כפתור האתחול מעיד על המצב: ״אתחול הגדרות GNSS״ פירושו שמעולם לא בוצע אתחול מוצלח, ואילו ״אתחול הגדרות חוזר ל־GNSS״ פירושו שכבר בוצע והכפתור רק מציע לחזור עליו.

טרה־ג׳יני

טרה־ג׳יני · ניקוי מטמון

טרה־ג׳יני פותח את ממשק העבודה. חזרה אחורה משאירה אותו פתוח ברקע — הנתונים החיים והחיבור נשמרים, ובכניסה הבאה חוזרים בדיוק לאותו מקום.

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

פאנל אזהרות מערכת

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

אזהרות מערכת
  • חסרות הגדרות. יש לעדכן את ההגדרות לפני תחילת העבודה.
  • אין חיבור לאינטרנט במכשיר.
  • לא בוצע אתחול GNSS.
  • במצב ריצה אין חיבור לשרת התיקון הדיפרנציאלי (RTK).

מה יכול להופיע שם

חסרות הגדרות · אין אינטרנט · אין צימוד בלוטות׳ לאנטנה · לא בוצע אתחול GNSS · במצב ריצה: אין חיבור לתמיכה, משתמש לא מורשה בתמיכה, בלוטות׳ כבוי, לא מורשה מול RTK, אין חיבור ל־RTK.

כרטיסי POS · GST · GGA

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

POS
FIX
CALIBRATED
GST
OK
GGA
--

למעלה: POS ו־GST פעילים, GGA לא התקבל בעשר השניות האחרונות.


מה כתוב בכרטיס

POS — סוג הפתרון ומצב ה־IMU. GST — אם נתוני הדיוק קריאים. GGA — סוג הפתרון.

סוגי פתרון, מהגרוע לטוב: GPS · DGPS · PPS · FLOAT · FIX. FIX הוא היעד — זה הדיוק הסנטימטרי. FLOAT אומר שהתיקון מתקבל אבל עוד לא התכנס.

מצבי IMU: CALIBRATED מכויל ומוכן · NOT CALIB. עובד אך לא מכויל · IMU OFF כבוי.

שורות התעבורה

שתי שורות עם תוויות שמהבהבות בכתום. הבהוב = משהו באמת עבר ברגע זה. תווית אפורה קבועה פירושה שאין תעבורה.

מעביר משפטי NMEA לשרת

POS↑GST↑GGA↑

כל תווית מהבהבת בכל שליחה מוצלחת של אותו סוג משפט לשרת טרה־ג׳יני. בדוגמה POS ו־GGA נשלחים, GST לא.

קבלת תיקון דיפרנציאלי

GGA↑RTCM↓

GGA↑ — המיקום הנוכחי נשלח לשרת ה־RTK, בערך פעם ב־5 שניות. RTCM↓ — התיקון חוזר משם.

שני החצים צריכים להבהב לסירוגין. אם GGA עולה ו־RTCM לא חוזר — הבעיה בשרת או בהרשאות, לא באנטנה.

בקרי טיסה ומצלמה

שני כפתורים עגולים צפים בפינה הימנית התחתונה. ירוק־כחלחל = פעיל, אפור = מושבת.

בקרי טיסה

פותח פאנל עם שלושה מחוונים: מצפן לכיוון, Roll להטיה לצדדים ו־Pitch להטיה קדימה ואחורה. שימושי בעיקר בעבודה עם מוט מוטה. הפאנל מגיע סגור בכל פתיחה של המסך, ובזמן שהוא פתוח הכפתור עצמו נעלם — לסגירה יש כפתור מזעור בפינת הפאנל.

מצלמה

פותח את מסך המצלמה לצילום ותיעוד בשטח. שם גם מפעילים ומכבים את פעילות המצלמה עצמה.

פאנל הגרסאות

חמש שורות קבועות בתחתית המסך. זה מה שמוסרים לתמיכה כשמדווחים על תקלה.

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

גרסת האפליקציה — מה מותקן על המכשיר. אם היא נמוכה מהשורה מעליה, יש עדכון.

גרסת מערכת ההפעלה — גרסת האנדרואיד.

גרסת האנטנה — הגרסה של האנטנה עצמה, נקראת באתחול ונשמרת. - פירושו שעדיין לא בוצע אתחול מוצלח.

מזהה המכשיר — המזהה הייחודי שהתמיכה מזהה לפיו.


שים לב: גרסת האנטנה נשמרת גם אחרי ניתוק. אם החלפת אנטנה, היא תראה את הגרסה הקודמת עד האתחול המוצלח הבא.

Screen 02

הגדרות

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

מבנה המסך

מסך גלילה אחד, מחולק בקווי הפרדה לארבעה חלקים לפי עם מי מתחברים: טרה־ג׳יני, האנטנה, שרת ה־RTK, ושרת התמיכה. למעלה כפתורי טעינת סטים, ולמטה כפתורי שמירת סטים וכפתור השמירה.

הכלל החשוב ביותר במסך הזה

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


אחרי שמירה יש לאתחל מחדש. שינוי הגדרות מציג הודעה שמבקשת להריץ שוב ״אתחול הגדרות GNSS״ — ההגדרות החדשות לא מגיעות לאנטנה מעצמן.

משתמש טרה־ג׳יני

לאן נשלחים נתוני המיקום, ואילו סוגי משפטים לשלוח.

כתובת host:port כתובת שרת טרה־ג׳יני שאליו נשלחים המשפטים.
משפטי מיקום GGA GST POS אילו סוגי משפטים לשלוח לשרת. לכל סוג מסומן נדרש פורט תקין — חייב להיות לפחות סוג אחד פעיל, אחרת ההגדרות נחשבות חסרות.
מזהה token המזהה שמאמת את המכשיר מול טרה־ג׳יני.

GNSS

שדה יחיד — אבל אחד הקריטיים במסך.

מזהה SSID של האנטנה שם רשת ה־WiFi של האנטנה. השדה מציע השלמה אוטומטית מהרשתות שנקלטות בסביבה — כדאי לבחור מהרשימה ולא להקליד, כדי למנוע שגיאות כתיב.

אותו שם משמש לשני דברים: גם לחיבור ה־WiFi לאנטנה וגם לזיהוי מכשיר הבלוטות׳ לצימוד. שם שגוי כאן הוא הסיבה הנפוצה ביותר לכך ששום דבר לא מתחבר.

אם מתחברים ל־WiFi של מכשיר שאינו GNSS, תופיע הודעה שמבקשת לוודא את השם בשדה הזה.

RTK

פרטי ההתחברות לשרת התיקון הדיפרנציאלי. חמישה שדות, וכולם חובה.

כתובתcaster host
פורט2101
נקודת חיבור mount point   לצד השדה יש כפתור קבל — הוא מושך מהשרת את רשימת נקודות החיבור הזמינות ומאפשר לבחור מתוכה. עדיף על הקלדה ידנית.
שם משתמשusername
סיסמהpassword

איך זה מתבטא במסך הכניסה

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

תמיכה טכנית

החיבור שמאפשר לצוות התמיכה לראות את מצב המכשיר מרחוק.

כתובתsupport host
פורטport
מזהה token מזהה שגוי כאן מייצר נורת תמיכה צהובה במסך הכניסה.

סטים ושמירה

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

טען סט 1טען סט 2

טעינה — בראש המסך

ממלא את כל השדות מהסט השמור. אם הסט ריק, תופיע הודעה על כך ושום דבר לא ישתנה.

שמור סט 1שמור סט 2

שמירת סט — בתחתית המסך

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

שמור

שמירה — הכפתור התחתון

זה הכפתור שמפעיל את ההגדרות בפועל. שמירת סט לבדה לא מחילה כלום — בלי לחיצה על ״שמור״ האפליקציה תמשיך לעבוד עם ההגדרות הקודמות.

Screen 03

מצלמה

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

מה המסך עושה

המסך מקבל וידאו מהאנטנה דרך ה־WiFi, ומציג שתי תצוגות — עליונה ותחתונה. לכל פריים מצורפת מטה־דאטה מדויקת, ולחיצה על ״צלם״ שומרת גם את התמונה וגם אותה.

נקודה חשובה

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

סרגל השליטה

בראש המסך: כותרת, שורת מצב רשת, ושני כפתורים.

שורת מצב הרשת

משנה טקסט וצבע לפי מצב החיבור לאנטנה:

Net: CONNECTED
ירוק — מחובר לאנטנה, וידאו אמור לזרום.
Net: CONNECTING...
צהוב — המצלמה הופעלה ומחפשת את האנטנה.
Net: DISCONNECTED
אפור — לא מחובר והמצלמה לא פעילה.

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

התחלעצור

התחל · עצור

זה הכפתור שמפעיל ומכבה את פעילות המצלמה. אם אין עדיין חיבור לאנטנה, הלחיצה מתחילה חיפוש והמצלמה תעלה לבד כשהחיבור ייווצר. בזמן פעילות הכיתוב הופך ל״עצור״.

צלםצלם

צלם

מושבת כל עוד המצלמה לא פעילה ונדלק ברגע שמפעילים אותה. לחיצה מצלמת את הפריים הבא משתי המצלמות.

שתי התצוגות

מתחת לסרגל יש שתי תצוגות זהות במבנה — עליונה ותחתונה — ולכל אחת שלוש שכבות מידע מעל התמונה.

live video Heading: 137.4° N Week: 2352 SoW: 381240.000 Lat: 32.08561230° Lon: 34.78134500° H: 41.882 m Pitch: 1.204° Roll: -0.338° Head: 137.412°
Heading — פינה עליונההכיוון שאליו המצלמה מופנית, במעלות.
N
מחוון הצפון האדוםמסתובב כך שהאות מצביעה תמיד לצפון האמיתי, ללא תלות בכיוון המצלמה.
מטה־דאטה — פינה תחתונההנתונים המלאים של הפריים: זמן GPS, קו רוחב ואורך, גובה, ושלוש זוויות ההטיה.

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

צילום ושמירה

לחיצה על ״צלם״ לא מצלמת את מה שרואים ברגע הלחיצה, אלא את הפריים הבא שיגיע מכל מצלמה — כך שהתמונה והמטה־דאטה שלה תמיד מסונכרנות.

מה נשמר

ארבעה קבצים בכל צילום, בתיקיית ההורדות של הטלפון: תמונה וקובץ טקסט לכל מצלמה.

מצלמה עליונהcam_top_<date_time>.jpg + .txt
מצלמה תחתונהcam_bottom_<date_time>.jpg + .txt

קובץ ה־.txt מכיל בדיוק את המטה־דאטה שמוצגת על התמונה, ושתי המצלמות חולקות את אותה חותמת זמן בשם הקובץ — כך שקל לזווג ביניהן אחר כך.


עם הלחיצה תופיע הודעה שהצילום התחיל, ובסיום הודעה על שמירה מוצלחת — או הודעת כישלון אם אחת מארבע הכתיבות לא הצליחה.