تحديث البرامج الثابتة للأجهزة الملحقة عبر fwupd

الإصدار: 2.4.2
تاريخ آخر تعديل: 2024-10-18

نظرة عامة

الغرض من هذا الدليل هو وصف كيفية ضبط تحديثات البرامج الثابتة fwupd التي تتوافق مع واجهة مستخدم ChromeOS.

الخلفية

‫fwupd هو برنامج تابع لنظام التشغيل مفتوح المصدر ويعمل على تحديث البرامج الثابتة للأجهزة الطرفية وغيرها من البرامج الثابتة للنظام على الأنظمة المستندة إلى Linux. ويعمل برنامج fwupd على تحديث البرامج الثابتة للأجهزة الطرفية في ChromeOS.

تتكوّن حِزم تعديل fwupd من .cab ملفًا يتم تخزينها في خدمة برمجة البرامج الثابتة لجهة تصنيع Linux (LVFS). في نظام Linux، يمكن إتاحة تحديثات fwupd على نطاق واسع بمجرد تحميلها على LVFS. ومع ذلك، لإتاحة التحديثات في نظام التشغيل ChromeOS، سيتحقّق فريق نظام التشغيل ChromeOS من التحديثات الجديدة بشكلٍ منفصل وأدرِجها في القائمة المسموح بها لضمان توفير أفضل تجربة للمستخدم.

عملية إعادة التوجيه

لا ينطبق ما يلي إلا على الأجهزة الملحقة المعتمدة من WWCB والتي تم إرسال عيّنات فيها إلى Allion.

إذا كان الإصدار الحالي من fwupd في ChromeOS لا يتيح استخدام الجهاز الملحق، اتّبِع التعليمات المتوفّرة في حالة الاستخدام 1 وحالة الاستخدام 2. إذا كان الإصدار الحالي من fwupd في ChromeOS متوافقًا مع الجهاز الملحق، يمكنك الانتقال إلى حالة الاستخدام 2.

حالة الاستخدام 1: لا يتوافق الإصدار الحالي من fwupd في ChromeOS مع الجهاز الملحق

الإصدار الحالي من fwupd في ChromeOS لا يتوافق مع الأجهزة الملحقة.

1. يعمل المصنّعون الأصليون أو المصنّعون الأصليون للأجهزة بشكل مباشر مع موردي الشرائح لإرسال تغييرات المكونات الإضافية في قاعدة رموز fwupd.

   1. راجِع كتيّب دمج fwupd (الخطوة الثانية - باستخدام fwupd).
   2. تغييرات المكوّنات الإضافية: مثال 1 ومثال 2
   3. مطابقة VIDs:PIDs في ملف .quirk: مثال 3
      • كخيار بديل لتغييرات ملفات Quirk، إذا كان جهاز USB الملحق متوافقًا مع المكوّن الإضافي الحالي، يمكنك اتّباع مواصفات DS20.
   4. دمج التغييرات الناتجة عن المكوّن الإضافي والتغييرات الفريدة من خلال المشرفين على fwupd.
   5. الانتظار إلى أن يتم إصدار الإصدار الرسمي من أداة fwupd (أي 1.8.4)، قم بتدوين الإصدار.

2. تتم مزامنة الإصدارات التي تتضمّن تحديثات في ChromeOS بانتظام واتّباع الجدول الزمني لإصدارات Chromium.

3. إذا أرسلت تغييرات على المكوّن الإضافي أو إصلاحات للأخطاء أو تغييرات على ملف Quirk بعد تاريخ التوقف عن إضافة ميزات في إصدار Chromium القادم، ولكن التغييرات مهمة جدًا لإصدار ChromeOS التالي، عليك اتّباع الخطوات التالية:

   1. انتقِل إلى أداة تتبُّع مشاكل الشركاء.
   2. سجِّل الدخول باستخدام حساب نطاق شريك Google.

   3. انقر على الزر إنشاء مشكلة من القائمة الجانبية اليمنى لإنشاء خطأ في المكوِّن (ChromeOS > External > WWCB > PERIPHERAL OEM > fwupd). ينبّه ذلك فريق ChromeOS بترقية الإصدار الجديد في 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. مثال على لقطة شاشة:

         

4. سيتم تصنيف الخطأ، وسيتم دمج الإصدار الانتقائي من fwupd لاختبار صورة ChromeOS من قِبل مهندسي Google.

   • مثال على قائمة التغيير 1

5. سيتم بعد ذلك تعيين الخطأ إلى الإصدار المؤهَّل من fwupd الذي تم تعديله في chromeOS، ما يضمن عدم تعطُّل fwupd.

   • سيختار فريق الاختبار 5 منتجات ويُجري ترقية أو تقليل إصدار البرامج الثابتة باستخدام نسخة الاختبار من ChromeOS التي تتضمّن إصدارًا مُحدَّثًا من أداة fwupd.

6. سيتم تقديم نتائج التحقق من الصحة في تقرير الخطأ.

   • إذا تعذّر التحقق من الصحة بسبب وجود أخطاء أثناء الترقية، سيتم إسناد الخطأ إلى مهندس Google.

7. بعد اكتمال الاختبار، سيتم ترقية الإصدار المعدَّل من fwupd إلى قناة الإصدار التجريبي بعد الموافقة على قائمة التغييرات.

   • يُرجى ترك تعليق على الخطأ لمعرفة إصدار ChromeOS الذي يحتوي على الإصدار المعدَّل من fwupd. يمكنك أيضًا استخدام CL Finder لإصدار إصدار البحث في وحدة تحكم شركاء ChromeOS (CPCon) (يتطلب ذلك حساب نطاق شريك شركة Google، يُرجى التواصل مع TAMs للوصول إلى تكلفة النقرة).

حالة الاستخدام 2: يتوافق الإصدار الحالي من fwupd في نظام التشغيل ChromeOS مع الجهاز الملحق

يتوافق الإصدار الحالي من fwupd في ChromeOS مع الجهاز الملحق، وأصبح متاحًا فيه برنامج ثابت جديد.

1. أنشئ ملفًا بتنسيق .cab.

   يتم تحميل جميع البرامج الثابتة كأرشيف خزانة. إلى جانب البرنامج الثنائي للبرامج الثابتة، يتوقع LVFS أن يحتوي الأرشيف على ملف .metainfo.xml واحد على الأقل يصف الجهاز المستهدف والبرامج الثابتة. يمكنك إنشاء أرشيفات خزانة باستخدام gcab (مكتبة لإنشاء ملفات الخزانة) على نظام التشغيل Linux.

2. حمِّل تحديث البرامج الثابتة النهائي والمُختبَر (ملف .cab) إلى LVFS.

   1. تأكَّد من توفّر التحديث على جهاز التحكّم عن بُعد الثابت.

      إذا كان الإصدار متاحًا على جهاز ChromeOS الخاص أو المحظور أو الاختباري، لن تتم إضافته إلى النسخة المطابقة لنظام التشغيل ChromeOS.

   2. تم وضع علامة على التحديثات تشير إلى أنه تم التحقق من صحتها في LVFS من خلال تقرير موقَّع.

      تأكَّد من إضافة اختبارات الجهاز.

      • مثال على ملف json، مدعوم في إطار عمل الاختبار لاختبار الجهاز

   3. إذا كان ذلك هو عملية تحميل البرامج الثابتة الأولى، يجب التأكّد من توفّر برنامجَين ثابتَين على الأقل، والبرامج الثابتة الأساسية (لاختبار الرجوع إلى إصدار سابق) والبرامج الثابتة الجديدة (لاختبار الترقية)، على جهاز التحكّم عن بُعد الثابت في LVFS.

3. يجب اختبار ترقية البرامج الثابتة على ChromeOS من خلال تقرير موقَّع .

   1. حمِّل شهادات إلى LVFS لربط DUT بحسابك.

      1. سجِّل الدخول إلى LVFS باستخدام حسابك.
      2. انقر على رمز "الشخص" في أعلى يسار الصفحة، أو انقر على https://fwupd.org/lvfs/profile{:.external}.
      3. انقر على إعدادات الملف الشخصي.

      4. ابحث عن شهادة العميل على جهاز Chromebook.

         • ملاحظة: يجب أن يكون جهاز Chromebook في "وضع المطوّر".
         • افتح shell لمطوّري 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. انقر على الزر تحميل الشهادة في قسم شهادات العملاء على موقع 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 وانقر على التقارير الموقَّعة ضمن قسم الصفحة الرئيسية في أعلى اليسار.
      ملاحظة: قد يستغرق ظهور التقرير في LVFS
      مدة 4 ساعات تقريبًا.

   4. التحقُّق من وجود تقارير مُوقَّعة على إصدار البرامج الثابتة على LVFS

      • ابحث عن الجهاز الملحق على LVFS.
      • إذا كان التقرير الموقَّع الذي تم تحميله بعد ترقية إصدار البرامج الثابتة على الجهاز الملحق بنجاح باستخدام جهاز Chromebook، سيعرض القسم تم الاختبار بواسطة إصدار ChromeOS وإصدار fwupd والكيان. اطّلِع على المثال.
      • تأكَّد من أنّ تقييد الإصدار يعرض علامة اختيار خضراء "متاح لمستخدمي ChromeOS".

   5. اعتبارًا من الإصدار M126، لن تتوفّر تحديثات البرامج الثابتة إلا لمستخدمي ChromeOS إذا كانت البرامج الثابتة تتضمّن تقارير موقَّعة (تم اختبارها باستخدام ChromeOS) على LVFS.

      • بعد 24 ساعة، يمكن للمستخدمين توصيل الجهاز الملحق بجهاز Chromebook وترقية البرامج الثابتة من خلال واجهة مستخدم ChromeOS. انتقِل إلى الإعدادات > لمحة عن نظام التشغيل ChromeOS > تحديثات البرامج الثابتة.
      • ملاحظة: ستتوفّر تحديثات البرامج الثابتة بافتراض توفّر جميع التغييرات المطلوبة في المكوّن الإضافي على ChromeOS عند بلوغ مرحلة معيّنة.

يمكن الاطّلاع على مزيد من التفاصيل حول التقارير الموقَّعة على LVFS.

الأسئلة الشائعة

س: ما هي أجهزة Chromebook المتوافقة مع أداة fwupd؟

جميع أجهزة ChromeOS التي تعمل بالإصدار M101 أو الإصدارات الأحدث

س: كيف يمكنني معرفة إصدار fwupd المدمج مع ChromeOS؟

1. افتح chrome://system باستخدام المتصفّح (M109 أو إصدار أحدث).
   1. انتقِل إلى fwupd_version.
2. أو من خلال "وضع مطور البرامج" أو وحدة التحكم الجذر
   1. النوع fwupdmgr --version
   2. البحث عن "runtime org.freedesktop.fwupd"

س: ما المدة التي تستغرقها عملية إعادة الضبط على الإعدادات الأصلية؟

fwupd uprev يتبع الجدول الزمني لإصدار Chromium، تأكَّد من إرسال طلب تحديث الموارد قبل تاريخ الإيقاف النهائي لتجميد ميزة القسم الفرعي.

س: أين يمكنني الحصول على مزيد من المعلومات عن الجدول الزمني لإصدارات نظام التشغيل ChromeOS؟

في الجدول الزمني لإصدارات Chromium

س: كيف يمكن التبديل إلى وضع مطور البرامج على جهاز Chromebook؟

1. أوقِف تشغيل جهاز Chromebook.
2. اضغط مع الاستمرار على esc+Refresh، ثم اضغط على زر التشغيل.
   • ملاحظة: على بعض أجهزة 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؟

يمكنك ترك تعليق على الخطأ للسؤال عن إصدار الإصدار الذي يتضمن التغييرات، ومن المفترض أن يتمكن مهندسو Google من تزويدك بهذه المعلومات. يمكنك أيضًا استخدام أداة CL Finder للبحث عن إصدار الإصدار في وحدة تحكّم شركاء ChromeOS (CPCon) (تتطلب حساب نطاق شريك شركة Google، ويمكنك التواصل مع خبراء إدارة العملاء للوصول إلى CPCon). ويمكن للمرء أن يقارِن بين إصدار الإصدار على الواجهة الأمامية للشركاء في نظام التشغيل ChromeOS (CPFE) لمعرفة المعلم الرئيسي الذي يتوافق معه.

س: كيف يمكن إنشاء حساب LVFS؟

يُرجى الرجوع إلى مستندات الحصول على حساب في LVFS.

س: كيف يمكن تحميل ملفات cab إلى LVFS؟

يُرجى الرجوع إلى مستندات تحميل البرامج الثابتة في LVFS.

س: كيف يمكن التأكد من أن البرامج الثابتة لجهاز ملحق معين؟

ويمكن إجراء ذلك من خلال أكثر ملف إعداد معروف. يُرجى الرجوع إلى أفضل ملف إعدادات معروف في أداة fwupd للحصول على مزيد من المعلومات.

س: كيف يمكنني اختبار تحديث fwupd قبل التحميل إلى LVFS؟

بعد إرسال تغييرات المكوّن الإضافي ودمج الإصدار الانتقائي من fwupd في صورة اختبار ChromeOS، يمكنك الوصول إلى الصورة الاختبارية من خلال واجهة ChromeOS الشريك الأمامية (CPFE) (تتطلب حساب نطاق شريك شركة Google. يُرجى التواصل مع مسؤولي إدارة الشركاء للوصول إلى CPFE).

يُرجى الرجوع إلى مستندات LVFS اختبار البرامج الثابتة على ChromeOS. يمكنك بدلاً من ذلك أيضًا إجراء اختبارات fwupd باستخدام Moblab.

س: كيف سيتم إشعار المستخدم بتوفر تحديث البرامج الثابتة للجهاز الملحق؟

سيتلقّى المستخدم إشعارًا بأنّ هناك تحديثًا متاحًا استنادًا إلى مستوى العجلة في خدمة LVFS. يكون السلوك على النحو التالي:

حاجة ماسة	سلوك الإشعارات
منخفض	لن يتم إرسال إشعار إلى المستخدم، وسيحتاج إلى التحقّق يدويًا من توفّر التحديثات.
الوسيط
عالٍ
مشاكل ملحّة	سيظهر الإشعار كل عملية تشغيل إلى أن يكتمل التحديث.

س: هل يتم إجراء التحديثات التلقائية؟

لا، يبدأ المستخدم جميع تحديثات fwupd ولن تحدث أثناء التمهيد أو تلقائيًا.

س: ما هي مزايا مواصفة DS20؟

تم التحقق منها حاليًا لأجهزة USB الطرفية فقط، إذا كنت تستخدم البروتوكول نفسه الذي استخدمته على أجهزتك الأخرى، فلن يعمل إلا مع واصف DS20.

يمكن للمورّدين وضع بيانات ملف Quirk في وصف USB بدلاً من وضعها في مشروع fwupd. بهذه الطريقة، يتم إدخال جهاز USB، ويقرأ fwupd بيانات الوصف ويطابق المكوّن الإضافي ويُدرِج الجهاز بدون الحاجة إلى أن يُرسِل المورّد تصحيحًا إلى fwupd وينتظر تحديث fwupd.

س: هل DS20 خيار بديل لإجراء تغييرات الملف فقط؟

نعم، في معظم الأحيان، لا تحتاج الأجهزة المستقبلية إلى أكثر من إضافة معرّفَي VID وPID إلى مكوّن تكميلي حالي، بدلاً من إجراء تغييرات فعلية على الرمز. إذا كان من الضروري إجراء تغييرات على الرمز، على العميل إرسال التغييرات في المكوّن الإضافي إلى أداة fwupd.

الملاحق

1. دليل مطوّري البرامج
2. دعم المطوّرين
3. مقدّمة حول Git &Gerrit للمساهمين في "نظام ChromeOS" (CrOS)
4. إجراء تغييرات على رمز المصدر
5. عملية المراجعة/الموافقة في Gerrit
6. كتيّب دمج fwupd

سِجل النُسخ السابقة

التاريخ	الإصدار	ملاحظة
2024-10-18	2.4.2	تعديل صور سير العمل fwupd وخطوات تحميل شهادة العميل
2024-07-23	2.4.1	تعديلات التنسيق.
2024-06-26	2.4	تعديل سير عمل تحديث fwupd (حالة الاستخدام 1) (تم نشره مع الإصدار 2.4.1)
2024-06-17	2.3	تعديل سير عمل التقرير الموقَّع (تم النشر مع 2.4.1)
2024-02-01	2.2	الترويج للمحتوى على منصّة جديدة، وتعديلات بسيطة على الصياغة
2023-10-12	2.1	تمت إضافة صور في الحالة 1 والحالة 2، وكتيّب الدمج الذي تتم استضافته في موقع الشريك
2022-08-14	2.0	النشر الأولي لموقع الشريك الإلكتروني