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

Sürüm: 2.4.4
Son güncelleme: 23.07.2026

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.

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 yaygın olarak kullanılabilir. Ancak güncellemelerin ChromeOS'te kullanılabilmesi için ChromeOS ekibi, optimum kullanıcı deneyimi sağlamak amacıyla yeni güncellemeleri ayrı ayrı doğrulayıp izin verilenler listesine ekler.

fwupd Süreci

Aşağıdaki bilgiler yalnızca Allion'a örnekleri 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.

1. ODM'ler ve OEM'ler, eklenti değişikliklerini doğrudan yonga seti satıcılarıyla birlikte çalışarak fwupd kod tabanına göndermelidir.

   1. fwupd Integration Handbook (Second step - using fwupd) başlıklı makaleyi inceleyin.
   2. Eklenti değişiklikleri: 1. örnek, 2. örnek
   3. .quirk dosyasında VIDs:PIDs ile eşleşme: örnek 3
      • Tuhaflık dosyası değişikliklerine alternatif olarak, USB çevre birimi mevcut eklenti tarafından destekleniyorsa DS20 spesifikasyonunu uygulayabilirsiniz.
   4. Ortaya çıkan eklenti ve tuhaflık değişiklikleri, fwupd'nin bakımcıları tarafından birleştirilir.
   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 göre yayınlanır.

3. Yaklaşan bir Chromium sürümünün özellik dondurma son tarihinden 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 kaydında 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ü:

         

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

   • 1. örnek değişiklik listesi
   • Not: fwupd uprev, Chromium yayın planına uyar. fwupd uprev isteğinin, dal özelliklerinin dondurulacağı tarihten önce gönderildiğinden emin olun.

5. Değişiklik listesi onaylandığında fwupd'nin yükseltilmiş sürümü, deneysel kanala 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'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 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.

1. .cab dosyası oluşturun.

   Tüm donanım yazılımları, kabin arşivi olarak yüklenir. LVFS, donanım yazılımı ikili programıyla birlikte, arşivin hedef cihazı ve donanım yazılımını açıklayan en az bir .metainfo.xml dosyası içermesini bekler. Linux'ta gcab (kabine dosyaları oluşturmaya yarayan bir kitaplık) kullanarak kabine 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.

      Private, embargo veya testing uzaktan erişiminde kullanılabiliyorsa ChromeOS yansıtmasına eklenmez.

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

      Cihaz testlerinin eklendiğinden emin olun.

      • Cihaz testi için test çerçevesi tarafından desteklenen örnek JSON dosyası

   3. Bu ilk donanım yazılımı yüklemesi ise LVFS'nin kararlı deposunda en az 2 donanım yazılımının (düşürme testini yapmak için temel donanım yazılımı ve yükseltme testini yapmak için yeni donanım yazılımı) 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 sayfasına 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 İstemci Sertifikaları bölümünde 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 aracılığıyla 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 kimlik doğrulama yapın.

         fwupdmgr refresh
         fwupdmgr update
         fwupdmgr report-history --sign

      2. Not: --sign işaretini kullanmadan rapor 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.
      Not: Raporun LVFS'de görünmesi yaklaşık 4 saat sürer.

   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ğe bakın.
      • Release Gating (Sürüm Kontrolü) bölümünde "ChromOS kullanıcıları tarafından kullanılabilir" ifadesinin yanında yeşil bir 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 donanım yazılımını ChromeOS kullanıcı arayüzü üzerinden yükseltebilir. Ayarlar > ChromeOS hakkında > Donanım yazılımı güncellemeleri'ne gidin.
      • Not: Gerekli tüm eklenti değişikliklerinin belirli bir kilometre taşı için ChromeOS'te mevcut olması durumunda donanım yazılımı güncellemeleri kullanıma 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'yı tarayıcı üzerinden açın (M109 veya sonraki sürümler).
   1. fwupd_version adresine gidin.
2. Veya geliştirici modu, kök konsolu aracılığıyla,
   1. Tür fwupdmgr --version
   2. runtime org.freedesktop.fwupd ifadesini bulun

S: fwupd sürüm yükseltme 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 sürüm planı hakkında daha fazla bilgiyi nereden edinebilirim?

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+yenileme 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çirilir (ör. Geliştirici modu nasıl devre dışı bırakılır)?

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 eski sürüme geçmeyi destekliyor mu?

Hayır. fwupd'nin üretim sürümü veya donanım yazılımı bozulursa imzalı raporu https://fwupd.org/lvfs/dashboard üzerinden silmeniz gerekir. Eklenti değişiklikleri gönderdiğinizde ve/veya yeni bir yazılımınız olduğunda test yapmanız önemlidir. LVFS'nin kararlı bir uzaktan kumandasında 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 ile ilgili yorum bırakarak değişikliklerin hangi derleme sürümüne dahil edildiğini sorabilirsiniz. Google mühendisleri bu bilgiyi sizinle paylaşabilir. Ayrıca, ChromeOS iş ortağı konsolunda (CPCon) derleme sürümünü aramak için CL Finder'ı da kullanabilirsiniz (Google corp 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 çapraz referans verilebilir.

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

Getting an Account (Hesap Alma) LVFS dokümanlarına bakın.

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

LVFS dokümanlarındaki Uploading Firmware (Donanım Yazılımı 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 doğrulayabilirim?

Bu, en iyi bilinen yapılandırma dosyası aracılığıyla mümkündür. Daha fazla bilgi için fwupd Best Known Configuration (En İyi Bilinen Yapılandırma) başlıklı makaleyi inceleyin.

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 (Google kurumsal iş ortağı alan hesabı gerekir. CPFE'ye erişim için TAM'lerle iletişime geçin).

LVFS dokümanlarındaki ChromeOS'te donanım yazılımı testi başlıklı makaleyi inceleyin. Alternatif olarak Moblab ile fwupd testleri de çalıştırabilirsiniz.

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

Kullanıcı, güncellemeye LVFS'de atanan öncelik 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.
Orta
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 veya otomatik olarak gerçekleşmez.

S: DS20 Şartnamesi'nin 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. USB cihaz bu şekilde 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 tuhaf dosya değişikliklerine yönelik alternatif bir seçenek midir?

Evet. Çoğu zaman gelecekteki donanımlar için gerçek kod değişiklikleri yerine mevcut bir eklentiye yalnızca VID ve PID'lerin eklenmesi gerekir. Kod değişiklikleri gerekiyorsa satıcı, eklenti değişikliklerini fwupd'ye göndermelidir.

Ekler

1. Geliştirici kılavuzu
2. Geliştirici Destek Ekibi
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
2026-07-23	2.4.4	fwupd entegrasyonu için playbook bağlantısını güncelleme
2025-07-23	2.4.3	1. kullanım alanı iş akışını güncelleme
2024-10-18	2.4.2	fwupd iş akışı resimlerini ve istemci sertifikası yükleme 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üncelleme (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. örnekte resimler eklendi, iş ortağı sitesinde barındırılan fwupd Entegrasyon El Kitabı
2022-08-14	2,0	İlk iş ortağı sitesi yayını