עדכון קושחה של ציוד היקפי באמצעות fwupd

גרסה: 2.4.3
תאריך העדכון האחרון: 2025-07-23

סקירה כללית

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

תרשים זרימה של fwupd

רקע

‫fwupd הוא דמון קוד פתוח שמבצע עדכוני קושחה של ציוד היקפי ושל מערכות אחרות במערכות מבוססות Linux. ‏fwupd הוא המנגנון שבאמצעותו ChromeOS מעדכן את הקושחה של הציוד ההיקפי.

מטעני העדכון של fwupd מורכבים מקובצי .cab שמאוחסנים ב-Linux Vendor Firmware Service‏ (LVFS). ב-Linux, אפשר להפוך עדכוני fwupd לזמינים באופן נרחב אחרי שהם מועלים ל-LVFS. עם זאת, כדי שהעדכונים יהיו זמינים ב-ChromeOS, צוות ChromeOS יאמת בנפרד עדכונים חדשים ויוסיף אותם לרשימת ההיתרים כדי להבטיח חוויית משתמש אופטימלית.

תהליך fwupd

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

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

תרחיש לדוגמה 1: הגרסה הנוכחית של fwupd ב-ChromeOS לא תומכת בציוד ההיקפי

הגרסה הנוכחית של fwupd ב-ChromeOS לא תומכת בציוד ההיקפי.

תמונה

  1. יצרני ODM ויצרני ציוד מקורי (OEM) יכולים לעבוד ישירות עם ספקי ערכות השבבים כדי לשלוח שינויים בפלאגין למאגר הקוד של fwupd.

    1. אפשר לעיין במדריך השילוב של fwupd (שלב שני – שימוש ב-fwupd).
    2. שינויים בתוסף: דוגמה 1, דוגמה 2
    3. התאמה ל-VIDs:PIDs בקובץ .quirk: example 3
      • אם התוסף הקיים תומך בציוד ההיקפי של ה-USB, אפשר לפעול לפי המפרט של DS20 במקום לשנות את קובץ ה-quirk.
    4. השינויים שמתקבלים בתוסף ובמאפיין מוזגו על ידי המתחזקים של fwupd.
    5. Wait for official point release of fwupd (i.e., ‫1.8.4), make a note of the version.

  2. גרסאות של fwupd משוכפלות באופן קבוע ל-ChromeOS בהתאם ללוח הזמנים של גרסאות Chromium.

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

    1. עוברים אל כלי המעקב אחר בעיות של שותפים.
    2. מתחברים באמצעות חשבון הדומיין של שותף Google.

    3. כדי ליצור באג ברכיב (ChromeOS > External > WWCB > PERIPHERAL OEM > fwupd), לוחצים על הלחצן Create Issue (יצירת בעיה) בתפריט בצד ימין. כך צוות ChromeOS יקבל התראה על הצורך בעדכון הגרסה של fwupd ב-ChromeOS.

      צריך לציין בבאג את הפרטים הבאים:

      1. כותרת הבאג:

        [PRODUCT NAME - fwupd]: New Plugin NAME OF THE PLUGIN requires fwupd X.Y.Z version uprev

      2. תיאור הבאג:

        1. מספר הגרסה של fwupd שכולל שינויים בתוסף:
          • אילו תכונות נוספות הוא כולל?
          • אילו באגים תוקנו?
          • באילו מכשירים יש תמיכה?
        2. יצרן/דגם המכשיר
        3. VID, PID
        4. מזהה ייחודי גלובלי (GUID)

      3. צילום מסך לדוגמה:

        צילום מסך של באג ב-fwupd uprev

  4. הבאג יסווג לפי חומרתו, והגרסה הסלקטיבית של fwupd תצורף ל-ChromeOS על ידי מהנדסי Google.

  5. הגרסה המשודרגת של fwupd תקודם לערוץ Canary כשרשימת השינויים תאושר.

    • כדאי להשאיר תגובה על הבאג כדי לדעת איזו גרסת build של ChromeOS כוללת את הגרסה המעודכנת של fwupd. אפשר גם להשתמש ב-CL Finder כדי לחפש את גרסת ה-build ב-ChromeOS partner console (CPCon) (נדרש חשבון דומיין של שותף Google corp. כדי לקבל גישה ל-CPCon, צריך לפנות ל-TAM).

תרחיש לדוגמה 2: הגרסה הנוכחית של fwupd ב-ChromeOS תומכת בציוד ההיקפי

הגרסה הנוכחית של fwupd ב-ChromeOS כבר תומכת בציוד ההיקפי ויש קושחה חדשה.

תמונה

  1. יוצרים קובץ .cab.

    כל הקושחה מועלית כארכיון cabinet. בנוסף לקובץ הבינארי של הקושחה, מערכת LVFS מצפה שהארכיון יכיל לפחות קובץ אחד מסוג .metainfo.xml שמתאר את מכשיר היעד ואת הקושחה. אפשר ליצור ארכיונים של קבצים באמצעות gcab (ספרייה ליצירת קבצים) ב-Linux.

  2. מעלים את עדכון הקושחה הסופי שנבדק (קובץ .cab) אל LVFS.

    1. מוודאים שהעדכון זמין בשלט הרחוק היציב.

      אם הוא זמין במאגר המרוחק private,‏ embargo או testing, הוא לא יתווסף למאגר המקומי של ChromeOS.

    2. עדכונים שמסומנים כמאומתים ב-LVFS באמצעות דוח חתום.

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

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

  3. צריך לבדוק את שדרוג הקושחה ב-ChromeOS באמצעות דוח חתום.

    1. מעלים אישורים ל-LVFS כדי לקשר את ה-DUT לחשבון שלכם.

      1. מתחברים ל-LVFS באמצעות החשבון.
      2. לוחצים על סמל האדם בפינה השמאלית העליונה או על https://fwupd.org/lvfs/profile{:.external}.
      3. לוחצים על הגדרות הפרופיל.

      4. מאתרים את אישור הלקוח ב-Chromebook.

        • הערה: ה-Chromebook צריך להיות במצב פיתוח
        • מפעילים את מעטפת המפתחים של ChromeOS על ידי הקשה על Ctrl+Alt+t.

        • סוג:

          shell

        • ניווט אל /var/lib/fwupd/pki:

          cd /var/lib/fwupd/pki

        • מעתיקים את client.pem לתיקייה ב-Chromebook, לדוגמה: Downloads.

          cp client.pm /home/chronos/user/MyFiles/Downloads/

    2. בקטע Client Certificates באתר LVFS, לוחצים על הלחצן Upload Certificate ומעלים את האישור.

      1. חוזרים על השלבים האלה בכל Chromebook שמשמש לבדיקה (אפשר להעלות כמה אישורים למחשבים שונים).

    3. בודקים את השדרוג ומעלים דוחות חתומים באמצעות ה-DUT.

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

        fwupdmgr refresh
fwupdmgr update
fwupdmgr report-history --sign

      2. הערה: אם כבר העליתם דוחות בלי הדגל --sign, אתם יכולים להשתמש בפקודה fwupdmgr report-history --sign --force כדי להעלות מחדש את אותו דוח ל-LVFS.

        fwupdmgr report-history --sign --force

        • אפשר להעביר את --verbose כדי לראות את תגובת השרת.

          fwupdmgr report-history --force --verbose

      3. לוחצים על כן בתיבת הדו-שיח לאישור.

        • הפעולה הזו אמורה להעלות את הדוח החתום לחשבון שלכם.
        • כדי לאשר, עוברים אל https://fwupd.org/lvfs/dashboard ולוחצים על Signed Reports [דוחות חתומים] בקטע Home [דף הבית] בפינה הימנית העליונה.

    4. אימות הגרסה של הקושחה ב-LVFS כולל דוחות חתומים

      • מחפשים את הציוד ההיקפי ב-LVFS.
      • אם הדוח החתום שהועלה נוצר אחרי שדרוג מוצלח של גרסת הקושחה בציוד ההיקפי באמצעות Chromebook, בקטע Tested By יופיעו גרסת ChromeOS, גרסת fwupd והישות. לדוגמה
      • מוודאים שהגבלת גישה לגרסה מסומנת בסימן וי ירוק 'זמין למשתמשי ChromeOS'.

    5. החל מגרסה M126, עדכוני קושחה יהיו זמינים למשתמשי ChromeOS רק אם הקושחה כוללת דוחות חתומים (נבדקה באמצעות ChromeOS) ב-LVFS.

      • אחרי 24 שעות, המשתמשים יכולים לחבר את הציוד ההיקפי ל-Chromebook ולשדרג את הקושחה דרך ממשק המשתמש של ChromeOS. מנווטים אל הגדרות > מידע על מערכת ההפעלה של Chrome > עדכוני קושחה.
      • הערה: עדכוני קושחה יהיו זמינים אם כל השינויים הנדרשים בתוסף יהיו זמינים ב-ChromeOS עבור אבן דרך מסוימת.

פרטים נוספים על דוחות חתומים זמינים ב-LVFS.

שאלות נפוצות

ש: איזה Chromebook תומך ב-fwupd?

כל מכשירי ChromeOS בגרסה M101 ומעלה.

ש: איך אפשר לדעת איזו גרסה של fwupd משולבת ב-ChromeOS?

  1. פותחים את chrome://system דרך הדפדפן (גרסה M109 ואילך).
    1. נווט אל fwupd_version.
  2. או דרך מצב מפתחים, מסוף root,
    1. מקלידים fwupdmgr --version
    2. חיפוש של runtime org.freedesktop.fwupd

ש: כמה זמן נמשך תהליך העדכון של fwupd?

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

שאלה: איפה אפשר לקבל מידע נוסף על לוח הזמנים של גרסאות ChromeOS?

בלוח הזמנים של גרסאות Chromium.

שאלה: איך מעבירים Chromebook למצב פיתוח?

  1. מכבים את ה-Chromebook.
  2. לוחצים לחיצה ארוכה על Esc + רענון ואז לוחצים על לחצן ההפעלה.
    • הערה: בחלק ממכשירי Chromebook צריך ללחוץ על Esc + → (מקש החץ שמאלה) ואז על לחצן ההפעלה.
  3. המכשיר מופעל ומוצג מסך השחזור או מצב השחזור.
  4. אחר כך מקישים על Ctrl+d ואז על Enter כדי לאשר.
    • הערה: אם תלחצו על מקשים כלשהם לפני Ctrl+d, המכשיר לא יעבור למצב פיתוח.
  5. המכשיר יופעל מחדש, ישמיע צפצוף ותוצג ההודעה 'המערכת עוברת למצב מפתח'.
  6. אחרי כ-30 שניות, תוצג ההודעה 'מערכת ההכנה למצב פיתוח'.
  7. בסופו של דבר (התהליך יכול להימשך בין 10 דקות ליותר משעה, בהתאם לגודל הדיסק), המכשיר יאותחל למסך הפתיחה הרגיל.
  8. כדי להגיע אל שורת הפקודה, מקישים על Ctrl+Alt+→ (מקש החץ שמאלה).
    • הערה: בחלק ממכשירי Chromebook, מקש הקיצור הוא Ctrl+Alt+Refresh.
    • כדי לחזור לתצוגת הדפדפן, מקישים על Ctrl+Alt+← (מקש החץ שמאלה).
  9. פרטים נוספים זמינים במאמר בנושא [מצב פיתוח]

שאלה: איך מעבירים Chromebook למצב רגיל (כלומר, משביתים את מצב הפיתוח)?

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

פרטים נוספים זמינים במאמר בנושא [מצב פיתוח].

ש: האם ChromeOS תומך בשדרוגים לאחור באמצעות fwupd?

לא. אם גרסת הייצור של fwupd או הקושחה נשברות, תצטרכו למחוק את הדוח החתום דרך https://fwupd.org/lvfs/dashboard. חשוב לבצע בדיקה בכל פעם ששולחים שינויים בתוסף או כשקושחה חדשה זמינה. מוודאים שגרסת בסיס של קושחה תמיד זמינה במאגר יציב של LVFS.

ש: איך אפשר לדעת אילו גרסאות של ChromeOS יתמכו בעדכוני fwupd?

אפשר להוסיף תגובה לבאג ולבקש לדעת באיזו גרסת build השינויים נכללים. מהנדסי Google יוכלו לספק לכם את המידע הזה. אפשר גם להשתמש ב-CL Finder כדי לחפש את גרסת ה-build ב-ChromeOS partner console (CPCon) (נדרש חשבון דומיין של שותף Google Corp – אפשר לפנות ל-TAM כדי לקבל גישה ל-CPCon). אפשר להשוות את גרסת ה-build ב-ChromeOS Partner Frontend ‏ (CPFE) כדי לראות לאיזו אבן דרך היא מתאימה.

ש: איך יוצרים חשבון LVFS?

אפשר לעיין במאמר קבלת חשבון במסמכי התיעוד של LVFS.

ש: איך מעלים קובצי CAB ל-LVFS?

אפשר לעיין בתיעוד של LVFS בנושא העלאת קושחה.

ש: איך אפשר לוודא שקושחה מיועדת לציוד היקפי ספציפי?

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

ש: איך אפשר לבדוק את העדכון של fwupd לפני שמעלים אותו ל-LVFS?

אחרי ששולחים את השינויים בתוסף ומשלבים את הגרסה הסלקטיבית של fwupd בתמונת הבדיקה של ChromeOS, אפשר לגשת לתמונת הבדיקה דרך ChromeOS Partner Frontend ‏ (CPFE) (נדרש חשבון בדומיין של שותף Google corp – אפשר לפנות ל-TAM לקבלת גישה ל-CPFE).

אפשר לעיין בתיעוד של LVFS בנושא בדיקת קושחה ב-ChromeOS. אפשר גם להריץ בדיקות fwupd באמצעות Moblab.

ש: איך המשתמשים יקבלו הודעה על כך שעדכון קושחה זמין לציוד ההיקפי שלהם?

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

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

ש: האם העדכונים של fwupd מתבצעים באופן אוטומטי?

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

ש: מה היתרון של מפרט DS20?

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

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

ש: האם DS20 היא אפשרות חלופית לשינויים בקובץ quirk בלבד?

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

נספחים

  1. מדריך למפתחים
  2. תמיכת מפתחים
  3. מבוא ל-Git ול-Gerrit עבור תורמים ל-CrOS
  4. ביצוע שינויים בקוד המקור
  5. תהליך הבדיקה והאישור ב-Gerrit
  6. מדריך לשילוב fwupd

היסטוריית גרסאות

תאריך גרסה הערות
2025-07-23 2.4.3 עדכון תהליך העבודה של תרחיש שימוש 1
2024-10-18 2.4.2 עדכון התמונות והשלבים של תהליך העבודה ב-fwupd להעלאת אישור לקוח
2024-07-23 2.4.1 עדכוני עיצוב.
2024-06-26 2.4 עדכון תהליך העבודה של fwupd uprev (תרחיש לדוגמה 1).(פורסם יחד עם 2.4.1)
2024-06-17 2.3 עדכון תהליך העבודה של דוח חתום. (פורסם יחד עם גרסה 2.4.1)
2024-02-01 2.2 פרסום מחדש בפלטפורמה חדשה; עדכונים קלים בניסוח.
2023-10-12 2.1 נוספו תמונות במקרה 1 ובמקרה 2, מדריך השילוב של fwupd מתארח באתר השותף
2022-08-14 2.0 פרסום ראשוני של אתר שותף