טיפול בשקע חשמל

יכולות המסך (כמו מצבי תצוגה וסוגים נתמכים של HDR) יכולות להשתנות באופן דינמי במכשירים עם מסכים מחוברים חיצונית (באמצעות HDMI או DisplayPort), כמו ממירי Android TV ומכשירי OTT. השינוי הזה יכול לקרות כתוצאה מאות hotplug של HDMI, למשל כשהמשתמש עובר ממסך אחד למסך אחר או מפעיל את המכשיר בלי מסך מחובר. ב-Android מגרסה 12 ואילך יש שינויים במסגרת לטיפול ביכולות של חיבור חם ותצוגה דינמית.

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

הערה: המונח display mode שמופיע ב-API וב-framework של Android, זהה למונח display config שמופיע ב-HAL של Composer.

עדכון יכולות התצוגה

בקטע הזה מוסבר איך מסגרת Android מטפלת בשינויים ביכולות התצוגה שמתחילים ב-Composer HAL.

כדי שמערכת Android תוכל לטפל כראוי בשינויים ביכולות התצוגה, יצרן הציוד המקורי צריך להטמיע את Composer HAL כדי שהיא תשתמש ב-onHotplug(display, connection=CONNECTED) כדי להודיע ל-framework על שינויים ביכולות התצוגה. אחרי ההטמעה, Android מטפלת בשינויים ביכולות התצוגה באופן הבא:

1. כשמזהים שינוי ביכולות התצוגה, ה-framework מקבל התראה לגבי onHotplug(display, connection=CONNECTED).
2. כשמתקבלת ההתראה, המסגרת משחררת את מצב התצוגה שלה ויוצרת אותו מחדש עם היכולות החדשות מ-HAL באמצעות השיטות getActiveConfig,‏ getDisplayConfigs,‏ getDisplayAttribute,‏ getColorModes,‏ getHdrCapabilities ו-getDisplayCapabilities.
3. אחרי שהמסגרת יוצרת מחדש מצב תצוגה חדש, היא שולחת את הפונקציה החוזרת (callback) onDisplayChanged לאפליקציות שמקשיבות לאירועים כאלה.

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

המסגרת מקצה מחדש את מאגרי ה-framebuffer באירועי onHotplug(display, connection=CONNECTED) עתידיים. במאמר ניהול framebuffer של לקוח מוסבר איך לנהל כראוי את זיכרון ה-framebuffer כדי למנוע כשלים במהלך הקצאת framebuffers חדשים.

טיפול בתרחישי חיבור נפוצים

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

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

אזהרה: אל תשלחו התראת onHotplug(display, connection=DISCONNECTED) למסך הראשי, כי הפעולה הזו גורמת לקריסה של המסגרת.

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

תרחיש	שימוש
אין מסך מחובר בזמן ההפעלה	שולחים אות onHotplug(display, connection=CONNECTED) מ-Composer HAL ל-framework. החלפת מצב התצוגה הפיזית ב-Composer HAL במצב תצוגה של placeholder. הערה: מומלץ להגדיר למיקום ה-placeholder מצב תצוגה אחד נתמך עם רזולוציה של 1080x1920 ותדירות רענון של 60 Hz, כי רוב האפליקציות תומכות במצב התצוגה הזה.
המסך הראשי מחובר פיזית	שולחים ל-framework עוד אירוע onHotplug(display, connection=CONNECTED) מ-Composer HAL. הפעולה הזו גורמת למסגרת לטעון מחדש את כל יכולות התצוגה.
המסך הראשי מנותק פיזית	שולחים ל-framework עוד אירוע onHotplug(display, connection=CONNECTED) מ-Composer HAL. החלפת מצב התצוגה הפיזית ב-Composer HAL במצב תצוגה של placeholder. לתצוגת placeholder צריך להיות רק מצב תצוגה אחד, כדי שהמסגרת תשלח את קריאת החזרה (callback) onDisplayChanged לאפליקציות (כי קבוצת המצבים הנתמכים השתנתה). מצב התצוגה היחיד הזה צריך להתאים למצב הפעיל האחרון של המסך הפיזי לפני הניתוק, כדי שהאפליקציות לא יקבלו אירועי שינוי הגדרה.

שיקולים לגבי חיבור שאינו HDMI

ב-Android TV יש תמיכה רק ברזולוציות הבאות:

• 720x1280
• 1080x1920
• 2160x3840
• 4320x7680

כש-STB או מתאם טלוויזיה מנסים להציג רזולוציה שלא נתמכת, כמו 480i בחיבור CVBS, מוצגת למשתמש הודעת שגיאה.

אם למתאם הטלוויזיה או ל-STB יש חיבור HDMI וגם חיבור HDMI, חיבור ה-HDMI הוא המסך הראשי והחיבור שאינו HDMI לא פעיל. כתוצאה מכך, אם חיבור ה-HDMI מנותק בזמן שחיבור שאינו HDMI עדיין מחובר, מתבצע שליחת אירוע אל SurfaceFlinger, והיכולות של המסך שאינו HDMI צריכות לעבור דרך getDisplayAttribute ו-API אחרים של iComposerClient (כמו getHdrCapabilities).

שימוש במזהי תצורה ברצף כדי למנוע מרוץ תהליכים

מרוץ תהליכים יכול להתרחש אם Composer HAL מעדכן את הגדרות התצוגה הנתמכות במקביל ל-framework של קריאה ל-setActiveConfig או ל-setActiveConfigWithConstraints. הפתרון הוא להטמיע את Composer HAL כך שישתמש במזהים רציפים כדי למנוע את הבעיה הזו.

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

נניח את רצף האירועים הבא, שבו לא הוקצו מזהי רצף חדשים להגדרות התצוגה החדשות, וכתוצאה מכך נוצר מצב מרוץ:

1. מזהי ההגדרות הנתמכים של התצוגה הם:

   • id=1, ‏ 1080x1920 60 Hz
   • id=2, 1,080x1,920 50 Hz

2. המסגרת קוראת ל-setActiveConfig(display, config=1).

3. במקביל, ה-HAL של Composer מעבד שינוי בהגדרות התצוגה ומעדכן את המצב הפנימי שלו לקבוצה חדשה של הגדרות תצוגה, כפי שמתואר בהמשך:

   • id=1, ‏ 2160x3840 60 Hz
   • id=2, ‏ 2160x3840 50 Hz
   • id=3, ‏ 1080x1920 60 Hz
   • id=4, ‏ 1080x1920 50 Hz

4. ‏Composer HAL שולח לארגז הכלים אירוע onHotplug כדי להודיע על שינוי בקבוצת המצבים הנתמכים.

5. ה-HAL של Composer מקבל את setActiveConfig(display, config=1) (מ-שלב 2).

6. ה-HAL מפרש שהמסגרת ביקשה שינוי בהגדרה ל-2160x3840 60 Hz, אבל בפועל רצתה 1080x1920 60 Hz.

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

הגדרת Composer HAL לשימוש במזהים עוקבים

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

• כש-Composer HAL מעדכן את הגדרות התצוגה הנתמכות, הוא מקצה מזהים עוקבים חדשים להגדרות התצוגה החדשות.
• כשהמסגרת קוראת ל-setActiveConfig או ל-setActiveConfigWithConstraints עם מזהה תצורה לא תקין, ה-HAL של Composer מתעלם מהקריאה.

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

נבחן את רצף האירועים הבא, כאשר מזהים עוקבים חדשים מוקצים להגדרות התצוגה החדשות:

1. מזהי התצורה הנתמכים של התצוגה הם:

   • id=1, ‏ 1080x1920 60 Hz
   • id=2, ‏ 1080x1920 50 Hz

2. המסגרת קוראת ל-setActiveConfig(display, config=1).

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

   • id=3, ‏ 2160x3840 60 Hz

   • id=4, ‏ 2160x3840 50 Hz

   • id=5, ‏ 1080x1920 60 Hz

   • id=6, 1,080x1,920 50 Hz

4. ה-HAL של Composer שולח לארגז הכלים אירוע onHotplug כדי להודיע על שינוי בקבוצת המצבים הנתמכים.

5. Composer HAL מקבל setActiveConfig(display, config=1) (משלב 2).

6. Composer HAL מתעלם מהקריאה כי המזהה כבר לא חוקי.

7. המסגרת מקבלת ומעבדת את האירוע onHotplug משלב 4. הוא קורא ל-HAL של Composer באמצעות הפונקציות getDisplayConfigs ו-getDisplayAttribute. בעזרת הפונקציות האלה, המסגרת מזהה את המזהה החדש (5) לרזולוציה ולקצב הרענון הרצויים של 1080x1920 ו-60 Hz.

   הערה: המסגרת גם קוראת ל-getActiveConfig כדי לקבל את מצב התצוגה הנוכחי, ואם הוא שונה ממצב התצוגה הרצוי, היא קוראת שוב ל-setActiveConfig().

8. המסגרת שולחת אירוע נוסף מסוג setActiveConfig עם מזהה מעודכן של 5.

9. ה-HAL של Composer מקבל את setActiveConfig(display, config=5) משלב 5.

10. ה-HAL מפרש בצורה נכונה שהמסגרת ביקשה שינוי של ההגדרה ל-1080x1920 60 Hz.

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