‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

גרסה: 2.4.4
עדכון אחרון: 2026-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 כבר תומכת בציוד ההיקפי, אפשר לדלג אל תרחיש לדוגמה 2.

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

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

תמונה

יצרני ציוד מקורי (OEM) ויצרני עיצוב מקורי (ODM) צריכים לעבוד ישירות עם ספקי ערכות השבבים כדי לשלוח שינויים בפלאגין אל בסיס הקוד של fwupd.
1. אפשר לעיין במדריך השילוב של fwupd (שלב שני – שימוש ב-fwupd).
2. שינויים בתוסף: דוגמה 1, דוגמה 2
3. התאמה ל-VIDs:PIDs בקובץ .quirk: example 3
  - כחלופה לשינויים בקובץ quirk, אם הציוד ההיקפי של ה-USB נתמך על ידי התוסף הקיים, אפשר לפעול לפי המפרט של DS20.
4. השינויים שנובעים מכך בתוסף ובמאפיינים מוזגו על ידי המתחזקים של fwupd.
5. ממתינים לפרסום רשמי של גרסת נקודה של fwupd (כלומר, ‫1.8.4), כדאי לרשום את הגרסה.
גרסאות של fwupd משוכפלות באופן קבוע ל-ChromeOS, בהתאם ללוח הזמנים לפרסום של Chromium.
אם תשלחו שינויים בתוספים, תיקוני באגים או שינויים בקובץ 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 תשולב ב-ChromeOS על ידי מהנדסי Google.
- דוגמה לרשימת שינויים 1
- הערה: fwupd uprev פועל לפי לוח זמנים לפרסום של Chromium. חשוב לוודא שבקשת fwupd uprev נשלחת לפני תאריך הסיום של הקפאת התכונות של הענף.
הגרסה המשודרגת של fwupd תועבר לערוץ Canary ברגע שרשימת השינויים תאושר.
- אפשר להשאיר תגובה על הבאג כדי לדעת איזו גרסת build של ChromeOS כוללת את הגרסה המעודכנת של fwupd. אפשר גם להשתמש ב-CL Finder כדי לחפש גרסת build במסוף השותפים של ChromeOS‏ (CPCon) (נדרש חשבון בדומיין של שותף Google corp. כדי לקבל גישה ל-CPCon, צריך לפנות ל-TAM).

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

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

תמונה

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

כל הקושחה מועלית כארכיון cabinet. בנוסף לקובץ הבינארי של הקושחה, ה-LVFS מצפה שהארכיון יכיל לפחות קובץ .metainfo.xml אחד שמתאר את מכשיר היעד ואת הקושחה. אפשר ליצור ארכיונים של קבצים באמצעות gcab (ספרייה ליצירת קבצים) ב-Linux.
מעלים את עדכון הקושחה הסופי שנבדק (קובץ .cab) אל LVFS.
1. מוודאים שהעדכון זמין בשלט הרחוק היציב.
  
  אם הוא זמין במאגר המרוחק הפרטי, המוגבל או הניסיוני, הוא לא יתווסף למאגר המקומי של ChromeOS.
2. עדכונים שמסומנים כמאומתים ב-LVFS באמצעות דוח חתום.
  
  מוודאים שמבחני המכשיר נוספו.
  - קובץ JSON לדוגמה, שנתמך על ידי מסגרת הבדיקה לבדיקת מכשירים
3. אם זו ההעלאה הראשונה של קושחה, צריך לוודא שלפחות 2 קושחות,קושחת הבסיס (לצורך בדיקת שדרוג לאחור) והקושחה החדשה (לצורך בדיקת שדרוג), זמינות במאגר היציב של LVFS.
צריך לבדוק את שדרוג הקושחה ב-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. לוחצים על הלחצן Upload Certificate בקטע Client Certificates באתר LVFS ומעלים את האישור.
  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.
4. אימות גרסת הקושחה ב-LVFS כולל דוחות חתומים
  - מחפשים את הציוד ההיקפי ב-LVFS.
  - אם הדוח החתום שהועלה נוצר אחרי שדרוג מוצלח של גרסת הקושחה בציוד ההיקפי באמצעות Chromebook, בקטע Tested By יופיעו גרסת ChromeOS, גרסת fwupd והישות. לדוגמה
  - מוודאים שליד Release Gating מופיע סימן וי ירוק עם הכיתוב 'Available to ChromOS users'.
5. החל מגרסה M126, עדכוני קושחה יהיו זמינים רק למשתמשי ChromeOS אם הקושחה כוללת דוחות חתומים (נבדקה ב-ChromeOS) ב-LVFS.
  - אחרי 24 שעות, המשתמשים יכולים לחבר את הציוד ההיקפי ל-Chromebook ולשדרג את הקושחה דרך ממשק המשתמש של ChromeOS. עוברים אל הגדרות > מידע על מערכת ההפעלה של Chrome > עדכוני קושחה.
  - הערה: עדכוני קושחה יהיו זמינים אם כל השינויים הנדרשים בתוסף יהיו זמינים ב-ChromeOS עבור אבן דרך מסוימת.

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

שאלות נפוצות

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

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

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

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

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

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

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

בלוח הזמנים לפרסום של Chromium.

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

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

שאלה: איך מעבירים 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?

אפשר לעיין במאמר Getting an Account (פתיחת חשבון) במאמרי העזרה של 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.

נספחים

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

תאריך	גרסה	פתקים
2026-07-23	2.4.4	עדכון הקישור למדריך השילוב של 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	פרסום ראשוני של אתר שותף