בדיקה באמצעות יחידת הראש למחשב

יחידת ראש (DHU) למחשב מאפשרת למכונת הפיתוח שלכם לדמות יחידת ראש של Android Auto, כדי שתוכלו להריץ ולבדוק אפליקציות של Android Auto. ה-DHU פועלת במערכות Windows, macOS ו-Linux.

לאחר התקנת ה-DHU, אפשר לבדוק את אפליקציות Android Auto באמצעות חיבור המכשיר הנייד שלך באמצעות אחת מנגנוני החיבור הנתמכים שמתוארים במאמר הרצת ה-DHU.

הערה: אם אתם בודקים במכשיר נייד עם Android 10 (API ברמה 29) ואילך, עליכם להיכנס לחשבון שלכם בחנות Google Play ולעדכן את אפליקציית Android Auto לפני שמפעילים את DHU בפעם הראשונה. אם אתם מפתחים אפליקציית מדיה, אפשר גם לבדוק את ההטמעה של סשן המדיה באמצעות בקר המדיה אפליקציית בדיקה.

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

התקנת ה-DHU

כדי להתקין את ה-DHU במכונת הפיתוח:

1. מפעילים את מצב הפיתוח במכשיר נייד עם Android 9 (API ברמה 28) ואילך, כפי שמתואר בקטע הגדרת אפשרויות הפיתוח במכשיר.
2. הידור והתקנה של האפליקציה במכשיר.
3. מתקינים את Android Auto במכשיר. אם אפליקציית Android Auto כבר מותקנת, חשוב לוודא שאתם משתמשים בגרסה העדכנית.
4. ב-Android Studio, פותחים את מנהל ה-SDK עוברים לכרטיסייה SDK Tools (כלים ל-SDK) ומורידים את Android Auto חבילת אמולטור של יחידת ראש למחשב.

ה-DHU מותקן בספרייה SDK_LOCATION/extras/google/auto/.

1. במערכות Linux או macOS, מריצים את הפקודה הבאה בספרייה הזו כדי לוודא שאפשר להריץ את קובץ ה-DHU הבינארי:

   chmod +x ./desktop-head-unit
   

הערה: ה-DHU כולל ספרייה של libusb, שמורדת לאותה ספרייה. הספרייה הזו צריכה להישאר באותו המיקום שבו נמצא קובץ ההפעלה של DHU כדי שהוא יפעל כראוי.

שלבים נוספים ל-Linux

אם אתם מריצים את DHU בגרסה 2.x במערכת Linux, תצטרכו להתקין כמה ספריות נוספות. קובץ ה-DHU הבינארי תלוי ב-GLIBC בגרסה 2.32 ואילך. כדי לבדוק את גרסת GLIBC של המערכת, מריצים את הפקודה הבאה:

ldd --version

אם הגרסה נמוכה מ-2.32, צריך לעדכן את GLIBC לגרסה 2.32 ואילך. יכול להיות שתצטרכו לשדרג את מערכת ההפעלה לגרסה שתואמת ל-GLIBC 2.32 ואילך.

צריך גם להתקין את הספריות libc++1 ו-libc++abi1. ההתקנה משתנה בהתאם להפצה של Linux. לדוגמה, בחלוקות Linux שמבוססות על Debian, אפשר להתקין את הספריות באמצעות הפקודה הבאה:

sudo apt-get install libc++1 libc++abi1

התקנת גרסאות טרום-השקה של DHU

כדי לקבל גישה לגרסאות של DHU לפני השקה, אפשר להשתמש בגרסת טרום-השקה של Android Studio או לשנות את ערוץ העדכונים של התקנת Android Studio הקיימת לערוץ הבטא.

הרצת DHU

אחרי שתתקינו את DHU, תוכלו לבדוק את האפליקציות של Android Auto על ידי חיבור המכשיר הנייד לתחנת העבודה באמצעות USB. כדי להריץ את ה-DHU, מחברים מהמכשיר הנייד למכונת פיתוח באמצעות מצב אביזרים (מומלץ ל-DHU 2.x), או מנהור ADB.

חיבור באמצעות מצב אביזר

Android Auto תומך בהתחברות ל-DHU גרסה 2.x באמצעות Android Open אביזרים (AOA) באמצעות הפקודה הבאה:

./desktop-head-unit --usb

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

./desktop-head-unit --usb=[DEVICE_ID]

הערה: ב-Windows, יכול להיות שהתכונה הזו דורשת התקנה של מנהל ההתקן WinUSB תואם למכשיר הנייד שלך ועלול להפריע לחיבור ה-ADB. אם DHU לא מצליח למצוא את המכשיר הנייד ולהתחבר אליו. יש לנסות להריץ adb kill-server לפני התחלת ה-DHU או שימוש בחלופה אחרת.

התחברות באמצעות מנהור ADB

בשיטה הזו צריך להגדיר חיבור לשרת של יחידת הראש של Android Auto דרך Android Debug Bridge‏ (adb). כדי להגדיר את הניתוב ולרוץ את DHU, פועלים לפי השלבים הבאים:

1. הפעלת מצב הפיתוח של Android Auto אם הוא עדיין לא מופעל.

2. אם השרת של היחידה הראשית לא פועל כבר, פתח את 'אפשרויות נוספות' ו בוחרים באפשרות הפעלת שרת של יחידה ראשית, כפי שמוצג באיור 1.

   במכשיר, שירות בחזית מופיע באזור ההתראות ומציין שהשרת פועל, כפי שמוצג באיור 2.

   

   איור 1. תפריט הקשר עם אפשרויות למפתחים.

   

   איור 2. התראה על כך שהשרת של היחידה הראשית פועל.

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

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

5. חשוב לוודא שהמסך של המכשיר הנייד לא נעול כדי שתוכלו להפעיל את DHU.

6. במכונת הפיתוח, מריצים את הפקודה הבאה של adb כדי להעביר ל-socket מיציאה 5277 של מחשב הפיתוח לאותו מספר יציאה ב- מכשיר ה-Android. ההגדרה הזו מאפשרת ל-DHU להתחבר לשרת של יחידת ה-head שפועל במכשיר הנייד דרך שקע TCP.

   adb forward tcp:5277 tcp:5277
   

7. מפעילים את ה-DHU על ידי הרצת הפקודה desktop-head-unit.exe ב-Windows, או ./desktop-head-unit ב-macOS או ב-Linux, ספרייה SDK_LOCATION/extras/google/auto/:

   cd SDK_LOCATION/extras/google/auto
   desktop-head-unit.exe # Windows
   ./desktop-head-unit # macOS or Linux
   

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

אחרי שמתחילים ב-DHU, אפשר להשתמש בפקודות במסוף DHU כדי להריץ ולבדוק את האפליקציה שלכם.

אפשרויות של שורת הפקודה

כברירת מחדל, השרת של היחידה הראשית מתחבר דרך יציאה 5277. כדי לשנות את המארח או יציאה, יש להשתמש ברכיב --adb=<[localhost:]port> דגל, כמו בדוגמה הבאה:

./desktop-head-unit --adb=5999

כברירת מחדל, ה-DHU מחקה יחידת ראש שתואמת ל-Android Auto עם ממשק משתמש במסך מגע. דמה את נגיעות המשתמשים על ידי לחיצה על ה-DHU עם עכבר. כדי לדמות יחידות ראשיות שמשתמשות בבורר רוטורי לקלט, אפשר להשתמש בדגל -i rotary, כפי שמתואר בדוגמה הבאה:

./desktop-head-unit -i controller

כש-DHU נמצא במצב של אמצעי בקרה רוטורי, אפשר להשתמש במקשי קיצור כדי לדמות פעולות של אמצעי הבקרה. פרטים נוספים זמינים בקטע Rotary controller. במצב של אמצעי בקרה רוטורי, ה-DHU מתעלם מקליקים בעכבר. צריך להפעיל את Android Auto באמצעות הסימולציה של הבקר החוצי ב-AI.

אפשרויות נוספות של שורת הפקודה ל-DHU מפורטות בטבלה הבאה:

אפשרות	תיאור
-c, --config=FILE	משתמשים בקובץ התצורה .ini. פרטים נוספים זמינים בקטע הגדרת DHU.
-i, --input=INPUT	משתמשים במצב הקלט שצוין, אחד מהאפשרויות הבאות: touch,‏ rotary או hybrid.
-a, --adb=HOSTPORT	שימוש בהעברת ADB. host:port או port (אופציונלי). ברירת המחדל היא יציאה 5277.
-a, --usb=DEVICE_ID	יש להשתמש בהעברה מסוג USB AOA. DEVICE_ID (אופציונלי).
-v, --version	הצגת פרטי הגרסה.
-l, --licenses	הצגת רישיונות קוד פתוח.
-h, --headless	הפעלה במצב 'דפדפן ללא GUI', ללא ממשק משתמש.
-t, --always_show_window_on_top	הצגת חלונות DHU מעל חלונות אחרים (מושבתת כברירת מחדל)
-?, --help	הצגת רשימת העזרה.

מדריך למשתמש ב-DHU

בקטע הזה מתוארות התכונות הנתמכות על ידי DHU ואופן השימוש בהן.

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

מערכת

הוראה	מפתח	תיאור
help [command]		הצגת קבוצת הפקודות המלאה. אם מציינים שם של פקודה, מציגים עזרה לגבי הפקודה הזו.
quit exit	Alt+Q	יוצאים מהיחידה הראשית.
sleep [seconds]		ממתינים שנייה אחת. אם מצוין עיכוב, מתבצעת השהיה למשך מספר הseconds. אפשר להשתמש בכך כדי לכתוב סקריפט ליחידה הראשית עם ./desktop-head-unit < script.txt, למשל בסביבת CI.
screenshot filename.png		שמירת צילום מסך ב-filename.png.
licenses		הצגת רישיונות של ספריות שנעשה בהן שימוש ב-DHU.
keycode keycode		שולחים את keycode, אחד מהשמות שמופיעים הקטע Keycodes.

מגע ולוח מגע

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

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

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

הוראה	מפתח	תיאור
tap x y		סימולציה של אירוע מגע בקואורדינטות שצוינו.

שלט רחוק

ב-DHU יש תמיכה בבקר חוגה. אחרי שמתקיים enabled, תוכלו לבצע את הפעולות הבאות:

• לחיצה למעלה, למטה, שמאלה וימינה בלחצני החיצים (D-pad)
• סיבוב בכיוון השעון ובכיוון ההפוך
• ביצוע תנועת החלקה לכיוון הסיבוב (חמישה שלבים בו-זמנית)
• לחיצה למטה ובחזרה לשלט הרחוק

הפקודות וקישורי המפתחות מפורטים בטבלה הבאה.

גלגלת הגלילה בעכבר שולחת פקודות dpad rotate, ולחיצה על הלחצן האמצעי בעכבר, בדרך כלל גלגלת הגלילה, שולחת פקודות dpad click.

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

הוראה	מפתח	תיאור
dpad {up|down|left|right}	מקשי החיצים	מזיזים את החוגה של השלט רחוק.
dpad {ur|dl|ul|dr}		מזיזים את החוגה של השלט רחוק.
dpad soft {left|right}	Shift+מקשי החיצים	יש ללחוץ על הלחצנים הצדדיים שזמינים בחלק מהבקרים החוגה.
dpad click	החזרה	לוחצים על החוגה.
dpad back	Backspace	לוחצים על הלחצן 'הקודם' שמתחת למכשירי בקרה מסוימים.
dpad rotate left	1	מסובבים את החוגה נגד כיוון השעון (שמאלה).
dpad rotate right	2	סובב את בקר החוגה בכיוון השעון (ימינה).
dpad flick left	Shift+1	מסובבים את החוגה במהירות נגד כיוון השעון.
dpad flick right	Shift+2	מסובבים את החוגה במהירות בכיוון השעון.
dpad 0-9*#+	מקלדת מספרים

מיקרופון

ל-DHU יש תמיכה בשימוש במיקרופון לקלט קולי או להשמעת סרטון מוקלט מראש פסקול. לנוחותך, קובצי הקול הבאים עבור קול נפוץ שכלולות ב-DHU. קובצי האודיו האלה נמצאים בספרייה SDK_LOCATION/extras/google/auto/voice/.

שם קובץ	טקסט
navhome.wav	מנווטים הביתה.
navwork.wav	ניווט לעבודה.
navsoh.wav	עוברים אל בית האופרה של סידני.
navgoogle.wav	מנווטים לכתובת 1600 Amphitheatre Parkway, California, USA.
exitnav.wav	יוצאים מהניווט.
howlong.wav	כמה זמן אגיע?
showtraffic.wav	הצגת התנועה.
showalternateroute.wav	הצגת מסלולים חלופיים.
pause.wav	השהיית המוזיקה.
nextturn.wav	מתי הפנייה הבאה שלי?

כדי להריץ קובץ .wav ספציפי בהנחיה של DHU, משתמשים בפקודה הבאה:

mic play /path/to/filename.wav

בטבלה הבאה מפורטות פקודות נוספות שקשורות למיקרופון:

הוראה	מפתח	תיאור
mic begin	M	מפעילים את המיקרופון, מדמים לחיצה על לחצן ההגה וממתינים לקלט מהמיקרופון של המחשב.
mic play filename.wav		מפעילים את המיקרופון ומפעילים את ההקלטה בקובץ ה-WAV שצוין. הערה: לא שומעים את קובץ ה-WAV מושמע, אבל כן שומעים את התשובה מ-Android Auto.
mic repeat		חוזרים על ההקלטה האחרונה שנעשה בה שימוש עם mic play.
mic reject {on|off}		להפעיל או להשבית את דחיית הבקשות למיקרופון. כשהאפשרות מופעלת, כל בקשות גישה למיקרופון נדחות.

חיישנים

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

הוראה	תיאור
fuel [percentage]	מגדירים את מפלס הדלק לאחוז שצוין או (ללא ערך מעבר) השבתת מפלס הדלק.
range [km]	מגדירים את הטווח לקילומטרים שצוינו, או (אם לא מועבר ערך) משביתים את נתוני הטווח.
lowfuel [{on|off}]	מגדירים את חיישן האזהרה על רמת דלק נמוכה או (ללא העברת ערך) משביתים את החיישן.
accel [x] [y] [z]	מגדירים את מד התאוצה לערכי x,‏ y ו-z שצוינו (m/s^2) או (ללא העברת פרמטרים) מבטלים את ההגדרה של נתוני מד התאוצה. אם צריך, מעבירים את הערך NAN כדי לדלג על פרמטרים אופציונליים.
compass bearing [pitch] [roll]	מגדירים את המצפן לפי ערכי המיסה, גובה והגלל (מעלות) שצוינו. אם צריך, מעבירים את הערך NAN כדי לדלג על פרמטרים אופציונליים.
gyro [x] [y] [z]	מגדירים את הג'ירוסקופ למהירות הסיבוב שצוינה ב-x, y וב-z (רד/s) או (ללא פרמטרים) לבטל את הגדרת נתוני הג'ירוסקופ. מעבירים את הערך ב-NAN כדי לדלג על פרמטרים אופציונליים במקרה הצורך.
location lat long [accuracy] [altitude] [speed] [bearing]	מגדירים את המיקום לערכים של קווי האורך והרוחב שצוינו, יחד עם הערכים האופציונליים של דיוק (m), גובה (m), מהירות (מ'/שנ') וכיוון (מעלות). מעבירים את הערך ב-NAN כדי לדלג על פרמטרים אופציונליים במקרה הצורך.
odometer km [current_trip_km]	מגדירים את מד המרחק לקילומטרים שצוינו יחד עם ערך אופציונלי של ק"מ בנסיעה.
speed [speed]	מגדירים את מהירות הרכב לערך שצוין (m/s) או (ללא ערך שמוענק) משביתים את החיישן.
tollcard {insert|remove}	מוסיפים או מסירים כרטיס אגרה.
gps_satellite number_in_use [[azimuth] [elevation] [prn] [snr] [used_in_fix]]	מגדירים את חיישן הלוויין של ה-GPS למספר שצוין בערך השימוש, יחד עם הרשימה האופציונלית של כיוון הזווית (מעלות בטווח 0 עד 360), גובה (מעלות בטווח 0 עד 90), prn (רעש פסאודו-אקראי), snr (dB) ו-used in fix (true או false).
parking_brake engaged	מגדירים את חיישן בלם החניה ל-true או ל-false.
gear gear_value	מגדירים את חיישן ההילוכים לערך שצוין (לדוגמה, 0 לניוטרל, 100 לנסיעה, 101 לחנייה ו-102 לנסיעה לאחור).

מצב יום ומצב לילה

ה-DHU תומך בסימולציה של מעבר בין מצב יום למצב לילה באמצעות הפקודות והקישורים למקשים הבאים:

הוראה	מפתח	תיאור
day	Shift+N	הפעלת מצב יום – בהירות גבוהה וצבע מלא.
night	Ctrl+N	הפעלת מצב לילה – בהירות נמוכה וניגודיות גבוהה.
daynight nightday	צפ'	החלפת מצב יום או לילה.

ניהול המיקוד

ה-DHU תומך בסימולציה של מיקוד Android Auto במסך הרכב באמצעות הפקודות הבאות:

הוראה	תיאור
focus video {on|off|toggle}	הפעלה או השבתה של התכונה 'מיקוד וידאו' במכשיר הראשי. השבתת המיקוד בסרטון מדמה מעבר של יחידת הראש למצב מקורי.
focus audio {on|off|toggle}	הפעלה או השבתה של מיקוד האודיו ביחידה הראשית (HU). השבתת האודיו מתבצעת פוקוס מדמה את היחידה הראשית שמשמיעה מקור אודיו משלה.
focus nav {on|off|toggle}	מפעילים או משביתים את מיקוד הניווט ביחידה הראשית. השבתת התמקדות הניווט מאפשרת לדמות את היחידה הראשית כמערכת ניווט משלה.

הגבלות וסטטוס נהיגה

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

הוראה	מפתח	תיאור
restrict none	U	משביתים את כל ההגבלות.
restrict all	Shift+U	הפעלת כל ההגבלות, למשל כדי לדמות נהיגה.

אשכול הכלים

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

אפשר להפעיל את התכונה הזו באמצעות הערך instrumentcluster בקטע [general] בקובץ התצורה, או באמצעות הערכים navcluster או phonecluster כדי לשלוט בכל תכונה בנפרד.

[general]
...
instrumentcluster = true

תצוגת אשכולות

בחלק מהרכבים יש תצוגות של אשכול מחוונים שיכולות להציג מידע חזותי עשיר, כמו משבצות מפה. החל מגרסה 2.1 של ה-DHU (כרגע זמין דרך ערוץ העדכון של Android Studio Beta ), אפשר לבצע אמולציה של תצוגה כזו במכונת הפיתוח.

אפשר לעשות זאת באמצעות קובץ תצורה עם קטע [display] של האשכולות. קטעי [display] תומכים באותן אפשרויות להגדרת וידאו כמו המסך הראשי שמוגדר בקטע [general] בקובץ.

איור 3. המסך הראשי כשמריצים את DHU עם תצוגה משנית של האשכולות.

איור 4. כשמריצים את ה-DHU באמצעות מסך האשכול תצוגת אשכול משנית.

...

# The display name following the colon can be whatever you like.
[display:cluster]
# Setting the displaytype as cluster is what lets the DHU know how to handle it.
displaytype = cluster
resolution = 800x480
dpi = 160
...

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

# Launch your landscape configuration with your cluster display configuration
./desktop-head-unit -c landscape.ini -c cluster.ini

# Launch the portait configuration with the same cluster display configuration
./desktop-head-unit -c portrait.ini -c cluster.ini

סטטוס ההפעלה של המדיה

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

אפשר להפעיל את האפשרות הזו באמצעות הערך playbackstatus בקטע [general].

[general]
...
playbackstatus = true

קודי מפתח

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

keycode home

בטבלה הבאה מפורטים קודי מפתחות זמינים נוספים:

קוד מפתח	תיאור
home	עבור אל מסך הבית.
back	חזרה.
call endcall	להתקשר או לסיים שיחה.
search	הפעלת החיפוש.
media_play_pause media_play media_pause	הפעלה או השהיה של המדיה.
media_next media_previous	מעבר לטראק המדיה הבא או הקודם.
media	עוברים לאפליקציית המדיה שמוגדרת כברירת מחדל.
navigation	עוברים לאפליקציית הניווט שמוגדרת כברירת מחדל.
tel	עוברים לאפליקציית ברירת המחדל לשיחות.

הגדרת ה-DHU

ה-DHU תומך בקובץ תצורה .ini כדי לשנות את מצבי הקלט בין משטח מגע לבין בקר רוטורי, ולהגדיר את קצב הפריימים, הרזולוציה וה-DPI שהיחידה הראשית מבקשת מהטלפון.

מיקום ברירת המחדל של קובץ התצורה הוא ~/.android/headunit.ini. שפת תרגום ומשנים את התצורה של היחידה הראשית (HU) במערכת, אפשר תשנה את הקובץ הזה.

ניתן גם לציין קובץ תצורה לטעינה באמצעות הדגל -c:

./desktop-head-unit -c /path/to/config.ini

קטע הקוד הבא מציג הגדרה לדוגמה:

[general]
touch = true
touchpad = false
controller = false
instrumentcluster = false
resolution = 800x480
dpi = 160
framerate = 30
fueltypes = unleaded,electric,hydrogen
evconnectors = supercharger

קובצי תצורה לדוגמה שמדגימים הגדרות שונות של היחידה הראשית, יהיו מתחת תיקייה אחת (SDK_LOCATION/extras/google/auto/config/). למתקדמים יותר עיינו בהגדרות הנתמכות הבאות.

הגדרת קלט

בטבלה הבאה מפורטות האפשרויות להגדרת הקלט:

שם	ברירת מחדל	סוג	תיאור
inputmode	default	מחרוזת	מגדירים את שיטת הקלט. האפשרויות touch, rotary, ו-hybrid הפעלה והשבתה תמיכה במסך מגע ובחוגה וכן הגדרת קודי מפתח כברירת מחדל, לפי הצורך. default דוחה ל-touch ול- controller אפשרויות.
controller	false	ערך בוליאני	הפעלת הקלט של הבקר החוגה. המערכת מתעלמת מהערך הזה, אלא אם inputmode הוא default.
touch	true	ערך בוליאני	מפעילים את מסך המגע. המערכת מתעלמת מהמדיניות, אלא אם inputmode default.
touchpad	false	ערך בוליאני	מפעילים את לוח המגע.
touchpadnavigation	false	ערך בוליאני	מפעילים את לוח המגע לצורך ניווט בממשק המשתמש.
touchpadtapasselect	false	ערך בוליאני	אם הערך הוא True, הקשה על לוח המגע היא אירוע נבחר.
touchpaduiabsolute	false	ערך בוליאני	כשהערך בשדה touchpadnavigation הוא true, צריך להגדיר והאם יש להתייחס לנגיעות כתנועות מוחלטות או כתנועות.

הגדרת וידאו

Android Auto תומך בשלוש רזולוציות סרטונים:

• 480p‏ (800x480, ברירת המחדל)
• ‎720p (1280x720)‎
• 1080p‏ (1920x1080)

כדי לתמוך ביחסי גובה-רוחב אחרים, יחידת הראש יכולה לציין שוליים לפורמט letterbox (pillarbox) לפי הצורך. לדוגמה, אם רוצים מסך בגודל 1,000x600, צריך להגדיר את הרזולוציה ל-720p (1,280x720) ואת הערך של marginwidth ל-280 ואת הערך של marginheight ל-120. התוצאה היא הוספת שוליים של 140 פיקסלים בקצוות השמאלי והימני ושוליים של 60 פיקסלים בחלק העליון ובחלק התחתון.

ההגדרה לדוגמה הבאה מחקה מסך רגיל בגודל 6 אינץ' (750x450):

[general]
...
resolution = 800x480
marginwidth = 50
marginheight = 30

והתצורה הבאה לדוגמה מבצעת אמולציה של מסך רחב מאוד:

[general]
...
resolution = 1280x720
marginwidth = 0
marginheight = 220

בטבלה הבאה מפורטות אפשרויות נוספות להגדרת סרטונים:

שם	ברירת מחדל	סוג	תיאור
resolution	800x480	מחרוזת	אחת מהאפשרויות הבאות: 800x480,‏ 1280x720,‏ 1920x1080.
dpi	160	מספר שלם
normalizedpi	false	ערך בוליאני	כשהערך הוא true, צריך להקטין את גודל החלון של DHU כדי להביא בחשבון ערכים גדולים יותר של DPI. כשהערך של false הוא גבוה, ערכים גבוהים יותר של DPI יוצרים חלונות גדולים יותר. המצב הזה לא מחקה מסכים אמיתיים, אבל עוזר לבדוק תוכן חזותי.
realdpi	160	מספר שלם	משמש להגדרת וידאו.
framerate	30	מספר שלם	משמש להגדרת וידאו.
marginheight	0	מספר שלם	משמש להגדרת וידאו.
marginwidth	0	מספר שלם	משמש להגדרת וידאו.
margins	0,0,0,0	מחרוזת	משמש בהגדרת הסרטון. מבטלת את marginwidth ו-marginheight, אם הן קיימות. הפורמט הוא למעלה, למטה, שמאלה,ימינה.
contentinsets	0,0,0,0	מחרוזת	משמש להגדרת וידאו. הפורמט הוא 'למעלה', 'למטה', 'שמאלה', 'ימינה'.
stablecontentinsets	0,0,0,0	מחרוזת	משמש בהגדרת הסרטון. ברירת המחדל היא הערך של contentinsets הפורמט הוא למעלה, למטה, משמאל, מימין.
cropmargins	false	ערך בוליאני	אם מציינים את הערכים margins,‏ marginheight או marginwidth, הערך true בהגדרה הזו מסיר את השוליים האלה מהסרטון המוצג. כך תוכלו לראות מה משתמש הקצה רואה.
pixelaspectratio	1.0	בלונים	משמש להגדרת וידאו.

הגדרת החיישן

כדי לדמות נתוני חיישנים ולשלוח אותם אל Android Auto, החיישנים התואמים באמצעות האפשרויות הבאות. אם חיישן לא מופעל, המערכת תתעלם מכל נתון שנשלח מהחיישן הזה באמצעות פקודות DHU. הזה יש להזין את ההגדרה בקטע [sensors] ולא בקטע [general] הקטע שמשמש את רוב ההגדרות האחרות.

[general]
touch = true
...

[sensors]
location = true
fuel = true
...

שם	ברירת מחדל	סוג	תיאור
accelerometer	false	ערך בוליאני	הפעלת נתוני חיישן מד התאוצה.
compass	false	ערך בוליאני	מפעילים את נתוני חיישן המצפן.
driving_status	false	ערך בוליאני	מפעילים את נתוני החיישן של סטטוס הנהיגה.
fuel	false	ערך בוליאני	הפעלת נתונים מחיישן הדלק.
gyroscope	false	ערך בוליאני	הפעלת הנתונים של חיישן הג'ירוסקופ.
location	false	ערך בוליאני	מפעילים את נתוני החיישן של מיקום הרכב.
night_mode	false	ערך בוליאני	מפעילים את נתוני החיישנים של מצב לילה.
odometer	false	ערך בוליאני	מפעילים את נתוני חיישן מד המרחק.
speed	false	ערך בוליאני	מפעילים את נתוני חיישן המהירות.
toll_card	false	ערך בוליאני	הפעלת נתוני החיישנים של כרטיס האגרה.
gps_satellite	false	ערך בוליאני	הפעלת נתונים מחיישן לוויין GPS.
parking_brake	false	ערך בוליאני	הפעלת הנתונים של חיישן בלם החניה.
gear	false	ערך בוליאני	מפעילים את נתוני חיישן הציוד.

אפשרויות הגדרה שונות

בטבלה הבאה מפורטות אפשרויות תצורה נוספות:

שם	ברירת מחדל	סוג	תיאור
instrumentcluster	false	ערך בוליאני	מפעילים את אשכול הכלים. הוספת חלון לממשק המשתמש להצגת הניווט וסטטוס הטלפון.
navcluster	false	ערך בוליאני	מפעילים את אשכול הכלים. הוספת חלון לממשק המשתמש להצגת ניווט הסטטוס.
phonecluster	false	ערך בוליאני	הפעלת אשכול הכלים. הוספת חלון לממשק המשתמש כדי להציג את סטטוס הטלפון.
playbackstatus	false	ערך בוליאני	הפעלת סטטוס ההפעלה. הוספת חלון לממשק המשתמש להצגת ההפעלה הודעות סטטוס.
driverposition	left	מחרוזת	אחת מהאפשרויות: left, center, או right.
windowleft		מספר שלם	מגדירים את המיקום השמאלי של החלון הראשי.
windowtop		מספר שלם	מגדירים את המיקום העליון של החלון הראשי.
fueltypes	unleaded	מיתרים	אחד או יותר מהפריטים הבאים, ברשימה שמופרדת בפסיקים: unleaded leaded diesel-1 diesel-2 biodiesel e85 lpg cng lng hydrogen electric other unknown
evconnectors		מיתרים	אפס או יותר מהפריטים הבאים, ברשימה מופרדת בפסיקים: j1772 mennekes chademo combo-1 combo-2 roadster hpwc gbt supercharger other unknown מגדירים את הערך רק אם fueltypes מכיל את electric.

פתרון בעיות

לפעמים במכשיר DHU מופיע מסך ריק בפעם הראשונה שמחברים אותו. אפשר לעקוף את הבעיה באופן הבא:

1. סוגרים את ה-DHU.
2. פועלים לפי שלב 5 שמתואר בקטע הפעלת ה-DHU כדי לעצור ולהפעיל מחדש שרת היחידה הראשית.
3. מפעילים מחדש את ה-DHU.
4. מעניקים את כל ההרשאות הנוספות הנדרשות במסך הטלפון. ה-DHU עלול להיכבות שוב.
5. אם צריך, מפעילים מחדש את ה-DHU.