fwupd üzerinden çevre birimi donanım yazılımı güncelleme

Sürüm: 2.4.3
Son güncelleme: 2025-07-23

Genel Bakış

Bu kılavuzun amacı, ChromeOS kullanıcı arayüzü tarafından desteklenen fwupd donanım yazılımı güncellemelerinin nasıl yapılandırılacağını açıklamaktır.

fwupd akış şeması

Arka plan

fwupd, Linux tabanlı sistemlerde çevre birimi ve diğer sistem donanım yazılımı güncellemelerini gerçekleştiren açık kaynaklı bir arka plan programıdır. fwupd, ChromeOS'in çevre birimi donanım yazılımını güncellediği mekanizmadır.

fwupd güncelleme yükleri, Linux Vendor Firmware Service'te (LVFS) depolanan .cab dosyalarından oluşur. Linux'ta, fwupd güncellemeleri LVFS'ye yüklendikten sonra geniş kitlelere sunulabilir. Ancak güncellemelerin ChromeOS'te kullanılabilmesi için ChromeOS ekibi, optimum kullanıcı deneyimi sağlamak amacıyla yeni güncellemeleri ayrı olarak doğrulayıp izin verilenler listesine ekler.

fwupd Süreci

Aşağıdaki bilgiler yalnızca örnekleri Allion'a gönderilmiş WWCB sertifikalı çevre birimleri için geçerlidir.

ChromeOS'teki mevcut fwupd sürümü çevre birimini desteklemiyorsa kullanım alanı 1 ve kullanım alanı 2'de verilen talimatları uygulayın. ChromeOS'teki mevcut fwupd sürümü çevre birimini zaten destekliyorsa 2. kullanım alanına geçin.

1. Kullanım alanı: ChromeOS'in mevcut fwupd sürümü, çevre birimini desteklemiyor

ChromeOS'teki mevcut fwupd sürümü, çevre birimini henüz desteklemiyor.

resim

  1. ODM'ler ve OEM'ler, eklenti değişikliklerini doğrudan yonga seti tedarikçileriyle birlikte çalışarak fwupd kod tabanına gönderebilir.

    1. fwupd Integration Handbook (İkinci adım - fwupd kullanma) başlıklı makaleyi inceleyin.
    2. Eklenti değişiklikleri: 1. örnek, 2. örnek
    3. .quirk dosyasında VIDs:PIDs ile eşleşen: örnek 3
      • Tuhaflık dosyası değişikliklerine alternatif olarak, USB çevre birimi mevcut eklenti tarafından destekleniyorsa DS20 spesifikasyonunu uygulayabilirsiniz.
    4. Elde edilen eklenti ve tuhaflık değişikliklerinin fwupd'nin bakımcıları tarafından birleştirilmesini sağlayın.
    5. fwupd'nin resmi nokta sürümünü (ör. 1.8.4) sürümünü not edin.

  2. fwupd sürümleri düzenli olarak ChromeOS'e yansıtılır ve Chromium yayın planına uygun şekilde yayınlanır.

  3. Yaklaşan bir Chromium sürümünün özelliklerin dondurulması için son tarihten sonra eklenti değişiklikleri, hata düzeltmeleri veya tuhaflık dosyası değişiklikleri gönderirseniz ancak değişiklikler bir sonraki ChromeOS sürümü için yüksek öncelikli ise:

    1. İş Ortağı Sorun İzleyici'ye gidin.
    2. Google İş Ortağı Alanı Hesabınızla giriş yapın.

    3. Bileşeninizde hata oluşturmak için sol taraftaki menüden Create Issue (Sorun Oluştur) düğmesini tıklayın (ChromeOS > External > WWCB > PERIPHERAL OEM > fwupd). Bu işlem, ChromeOS ekibini ChromeOS'teki fwupd sürümünü yükseltmesi için uyarır.

      Hata raporunda aşağıdaki bilgileri sağlayın:

      1. Hata başlığı:

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

      2. Hata açıklaması:

        1. Eklenti değişikliklerinden oluşan fwupd sürüm numarası:
          • Hangi özellikleri ekler?
          • Hangi hatalar düzeltildi?
          • Hangi donanımlar desteklenir?
        2. Cihazın Markası/Modeli
        3. VID, PID
        4. GUID (küresel olarak benzersiz tanımlayıcı)

      3. Örnek ekran görüntüsü:

        fwupd uprev hatasının ekran görüntüsü

  4. Hata önceliklendirilir ve fwupd'nin seçici sürümü, Google mühendisleri tarafından ChromeOS'e dahil edilir.

  5. Değişiklik listesi onaylandığında fwupd'nin yükseltilmiş sürümü, kanarya kanalına yükseltilir.

    • fwupd'nin güncellenmiş sürümünü içeren ChromeOS derleme sürümünü öğrenmek için hatayla ilgili yorum bırakın. Ayrıca, ChromeOS İş Ortağı Konsolu (CPCon)'nda derleme sürümünü aramak için CL Finder'ı da kullanabilirsiniz (Google kurumsal iş ortağı alan hesabı gerektirir. CPCon'a erişim için lütfen TAM'lerle iletişime geçin).

2. Kullanım alanı: ChromeOS'in mevcut fwupd sürümü, çevre birimini destekliyor

ChromeOS'teki mevcut fwupd sürümü, çevre birimini zaten destekliyor ve yeni bir donanım yazılımı mevcut.

resim

  1. .cab dosyası oluşturun.

    Tüm donanım yazılımları, kabin arşivi olarak yüklenir. LVFS, arşivin donanım yazılımı ikilisinin yanı sıra hedef cihazı ve donanım yazılımını açıklayan en az bir .metainfo.xml dosyası içermesini bekler. Linux'ta gcab (cabinet dosyaları oluşturmak için kullanılan bir kitaplık) kullanarak cabinet arşivleri oluşturabilirsiniz.

  2. Test edilmiş ve son donanım yazılımı güncellemesini (.cab dosyası) LVFS'ye yükleyin.

    1. Güncellemenin kararlı uzaktan kumandada kullanılabilir olduğundan emin olun.

      Özel, ambargo veya test uzak deposunda mevcutsa ChromeOS yansısına eklenmez.

    2. LVFS'de imzalı rapor aracılığıyla doğrulanmış olarak işaretlenen güncellemeler.

      Cihaz testlerinin eklendiğinden emin olun.

    3. Bu ilk donanım yazılımı yüklemesi ise LVFS'nin kararlı uzaktan erişiminde en az 2 donanım yazılımının (taban donanım yazılımı (düşürme testini yapmak için) ve yeni donanım yazılımı (yükseltme testini yapmak için)) bulunduğundan emin olun.

  3. Donanım yazılımı yükseltmesi, ChromeOS'te imzalı bir rapor aracılığıyla test edilmelidir.

    1. DUT'u hesabınıza bağlamak için LVFS'ye sertifika yükleyin.

      1. Hesabınızla LVFS'ye giriş yapın.
      2. Sağ üstteki "Kişi" simgesini veya https://fwupd.org/lvfs/profile{:.external} adresini tıklayın.
      3. Profil ayarları'nı tıklayın.

      4. Chromebook'unuzda istemci sertifikasını bulun.

        • Not: Chromebook'un geliştirici modunda olması gerekir.
        • Ctrl+Alt+t tuşlarına basarak ChromeOS geliştirici kabuğunu başlatın.

        • Tür:

          shell

        • /var/lib/fwupd/pki adresine gidin:

          cd /var/lib/fwupd/pki

        • client.pem dosyasını Chromebook'unuzdaki bir klasöre kopyalayın. Örneğin: Downloads.

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

    2. LVFS web sitesindeki Client Certificates (İstemci Sertifikaları) bölümünde Upload Certificate (Sertifika Yükle) düğmesini tıklayın ve sertifikayı yükleyin.

      1. Test için kullandığınız her Chromebook'ta bu adımları tekrarlayın (farklı bilgisayarlar için birden fazla sertifika yükleyebilirsiniz).

    3. DUT üzerinden yükseltmeyi test edin ve imzalı raporları yükleyin.

      1. Raporları test etmek ve yüklemek için aşağıdaki komutları çalıştırın ve istendiğinde kimliğinizi doğrulayın.

        fwupdmgr refresh
fwupdmgr update
fwupdmgr report-history --sign

      2. Not: Raporları --sign işareti olmadan yüklediyseniz aynı raporu LVFS'ye yeniden yüklemek için fwupdmgr report-history --sign --force komutunu kullanabilirsiniz.

        fwupdmgr report-history --sign --force

        • Sunucu yanıtını görmek için --verbose değerini iletebilirsiniz.

          fwupdmgr report-history --force --verbose

      3. Onay iletişim kutusunda Evet'i tıklayın.

        • Bu işlem, imzalı raporu hesabınıza yükler.
        • Onaylamak için https://fwupd.org/lvfs/dashboard adresine gidin ve sol üstteki Ana Sayfa bölümünde İmzalı Raporlar'ı tıklayın.

    4. LVFS'deki donanım yazılımı sürümünün imzalı raporları olduğunu doğrulayın.

      • LVFS'de çevre birimini arayın.
      • Yüklenen imzalı rapor, Chromebook kullanılarak çevre birimindeki donanım yazılımı sürümü başarıyla yükseltildikten sonra oluşturulduysa Test Eden bölümünde ChromeOS sürümü, fwupd sürümü ve kuruluş gösterilir. Örneği inceleyin.
      • Sürüm sınırlama bölümünde "ChromOS kullanıcıları tarafından kullanılabilir" ifadesinin yanında yeşil onay işareti göründüğünden emin olun.

    5. M126'dan itibaren, donanım yazılımı güncellemeleri yalnızca LVFS'de donanım yazılımının imzalı raporları (ChromeOS ile test edilmiş) varsa ChromeOS kullanıcıları tarafından kullanılabilir.

      • 24 saat sonra kullanıcılar çevre birimini Chromebook'a bağlayabilir ve ChromeOS kullanıcı arayüzü üzerinden donanım yazılımını yükseltebilir. Ayarlar > ChromeOS hakkında > Donanım yazılımı güncellemeleri'ne gidin.
      • Not: Donanım yazılımı güncellemeleri, belirli bir kilometre taşı için gerekli tüm eklenti değişikliklerinin ChromeOS'te mevcut olması koşuluyla sunulur.

İmzalı raporlar hakkında daha fazla bilgiyi LVFS'de bulabilirsiniz.

SSS

S: Hangi Chromebook'lar fwupd'yi destekler?

M101 veya sonraki sürümlerin yüklü olduğu tüm ChromeOS cihazlar.

S: ChromeOS'e hangi fwupd sürümünün entegre edildiğini nasıl bulabilirim?

  1. chrome://system sayfasını tarayıcı üzerinden açın (M109 veya sonraki sürümler).
    1. fwupd_version adresine gidiş rotasını izle.
  2. Veya geliştirici modu, root konsolu üzerinden,
    1. Tür fwupdmgr --version
    2. runtime org.freedesktop.fwupd için arama yapın

S: fwupd uprev işlemi ne kadar sürer?

fwupd uprev, Chromium yayın takvimine uyar. fwupd uprev isteğinin, dalda özelliklerin dondurulacağı tarihten önce gönderildiğinden emin olun.

S: ChromeOS yayın planı hakkında daha fazla bilgiyi nerede bulabilirim?

Chromium yayın planında

S: Chromebook'u geliştirici moduna nasıl geçirebilirim?

  1. Chromebook'u kapatın.
  2. Esc+Yenile tuşlarını basılı tutun ve güç düğmesine basın.
    • Not: Bazı Chromebook'larda Esc+→ (sağ ok tuşu) tuşlarına basıp güç düğmesine basın.
  3. Cihaz açılır ve kurtarma ekranı / modu görünür.
  4. Ardından, kabul etmek için Ctrl+D tuşlarına ve Enter tuşuna basın.
    • Not: Ctrl+d tuşlarına basmadan önce herhangi bir tuşa basarsanız cihaz geliştirici moduna geçmez.
  5. Cihaz yeniden başlatılır, bip sesi çıkarır ve "Sisteminiz geliştirici moduna geçiyor" mesajını görürsünüz.
  6. Yaklaşık 30 saniye sonra "Sistem, geliştirici modu için hazırlanıyor" mesajını görürsünüz.
  7. Sonunda (disk boyutuna bağlı olarak 10 dakika ile 1 saatten fazla sürebilir) cihaz normal karşılama ekranında yeniden başlatılır.
  8. Komut istemini almak için Ctrl+Alt+→ (sağ ok tuşu) tuşlarına basın.
    • Not: Bazı Chromebook'larda Ctrl + Alt + Yenile tuşlarına basmanız gerekir.
    • Tarayıcı görünümüne dönmek için Ctrl+Alt+← (sol ok tuşu) tuşlarına basın.
  9. Daha fazla bilgiyi [Geliştirici Modu] bölümünde bulabilirsiniz.

S: Chromebook'u normal moda nasıl geçiririm (ör. geliştirici modunu devre dışı bırakma)?

Cihazınızı yeniden başlatın ve donanım yazılımı ekranında boşluk çubuğuna basın.

Daha fazla bilgiyi [Geliştirici Modu] bölümünde bulabilirsiniz.

S: ChromeOS, fwupd aracılığıyla sürüm düşürmeyi destekliyor mu?

Hayır. fwupd'nin veya donanım yazılımının üretim sürümü bozulursa https://fwupd.org/lvfs/dashboard adresinden imzalı raporu silmeniz gerekir. Eklenti değişiklikleri gönderdiğinizde ve/veya yeni bir donanım yazılımı kullanıma sunulduğunda test yapmanız önemlidir. LVFS'nin kararlı bir uzaktan erişiminde her zaman temel bir donanım yazılımı sürümünün bulunduğundan emin olun.

S: Hangi ChromeOS sürümlerinin hangi fwupd güncellemelerini desteklediğini nasıl öğrenebiliriz?

Hata hakkında yorum bırakarak değişikliklerin hangi derleme sürümüne dahil edildiğini sorabilirsiniz. Google mühendisleri bu bilgiyi size sağlayabilir. Ayrıca, ChromeOS İş Ortağı Konsolu'nda (CPCon) derleme sürümünü aramak için CL Finder'ı da kullanabilirsiniz (Google kurumsal iş ortağı alan hesabı gerektirir. CPCon'a erişim için TAM'lerle iletişime geçin). Hangi kilometre taşına karşılık geldiğini görmek için ChromeOS Partner Frontend'deki (CPFE) derleme sürümüne başvurabilirsiniz.

S: LVFS hesabı nasıl oluşturulur?

LVFS dokümanlarındaki Hesap Alma bölümünü inceleyin.

S: LVFS'ye cab dosyaları nasıl yüklenir?

LVFS dokümanlarındaki Firmware Yükleme bölümüne bakın.

S: Donanım yazılımının belirli bir çevre birimi için olduğunu nasıl anlarım?

Bu işlem, en iyi bilinen yapılandırma dosyası aracılığıyla yapılabilir. Daha fazla bilgi için fwupd Best Known Configuration (En İyi Bilinen Yapılandırma) bölümüne bakın.

S: fwupd güncellememi LVFS'ye yüklemeden önce nasıl test edebilirim?

Eklenti değişiklikleri gönderildikten ve fwupd'nin seçici sürümü ChromeOS test görüntüsüne dahil edildikten sonra ChromeOS Partner Frontend (CPFE) üzerinden test görüntüsüne erişebilirsiniz (ChromeOS Partner Frontend'e erişmek için Google kurumsal iş ortağı alan hesabı gerekir. CPFE'ye erişim için TAM'lerle iletişime geçin).

LVFS dokümanı Firmware testing on ChromeOS'u (ChromeOS'te donanım yazılımı testi) inceleyin. Alternatif olarak Moblab ile fwupd testleri de yapabilirsiniz.

S: Kullanıcılar, çevre birimleri için donanım yazılımı güncellemesi olduğunu nasıl öğrenir?

Kullanıcı, LVFS'de güncellemeye atanan aciliyet düzeyine göre güncellemenin kullanıma sunulduğuyla ilgili bir bildirim alır. Davranış şu şekildedir:

Öncelik Bildirim Davranışı
Düşük Kullanıcıya bildirim gönderilmez, güncellemeleri manuel olarak kontrol etmesi gerekir.
Aracı
Yüksek
Kritik Güncelleme tamamlanana kadar her yeniden başlatmada bildirim gösterilir.

S: fwupd güncellemeleri otomatik olarak mı yapılır?

Hayır. Tüm fwupd güncellemeleri kullanıcı tarafından başlatılır ve başlatma sırasında gerçekleşmez veya otomatik olarak yapılmaz.

S: DS20 Spesifikasyonu'nun avantajı nedir?

Şu anda yalnızca USB çevre birimleri için doğrulanmıştır. Diğer donanımınızda kullandığınız protokolü kullanıyorsanız yalnızca bir DS20 tanımlayıcısıyla çalışır.

Tedarikçiler, quirk dosyası verilerini fwupd projesi yerine USB tanımlayıcısına yerleştirebilir. Bu şekilde USB cihazı takıldığında fwupd, tanımlayıcı verilerini okur, eklentiyi eşleştirir, satıcının fwupd'ye yama göndermesini ve fwupd'nin güncellenmesini beklemeden cihazı numaralandırır.

S: DS20, yalnızca tuhaflık dosyası değişiklikleri için alternatif bir seçenek midir?

Evet. Gelecekteki donanımların çoğu zaman mevcut bir eklentiye VID ve PID'lerin eklenmesi yeterlidir. Gerçek kod değişiklikleri gerekmez. Kod değişiklikleri gerekiyorsa satıcı, eklenti değişikliklerini fwupd'ye göndermelidir.

Ekler

  1. Geliştirici kılavuzu
  2. Geliştirici Desteği
  3. CrOS katkıda bulunanlar için Git ve Gerrit'e giriş
  4. Kaynak kodda değişiklik yapma
  5. Gerrit inceleme/onay süreci
  6. fwupd Integration Handbook (fwupd Entegrasyon El Kitabı)

Düzeltme Geçmişi

Tarih Sürüm Notlar
2025-07-23 2.4.3 1. kullanım alanı iş akışını güncelleme
2024-10-18 2.4.2 İstemci sertifikasını yüklemek için fwupd iş akışı resimlerini ve adımlarını güncelleme
2024-07-23 2.4.1 Biçimlendirme güncellemeleri.
2024-06-26 2.4 fwupd uprev iş akışını güncelleyin (kullanım alanı 1).(2.4.1 ile birlikte yayınlandı)
2024-06-17 2.3 İmzalı rapor iş akışını güncelleyin. (2.4.1 ile birlikte yayınlanmıştır)
2024-02-01 2.2 Yeni platformda yeniden yayınlama; küçük ifade güncellemeleri.
2023-10-12 2.1 1. ve 2. kullanım alanlarına resimler eklendi, iş ortağı sitesinde barındırılan fwupd Entegrasyon El Kitabı
2022-08-14 2,0 İlk iş ortağı sitesi yayını