Cập nhật chương trình cơ sở cho thiết bị ngoại vi thông qua fwupd

Phiên bản: 2.4.3
Lần cập nhật gần đây nhất: 2025-07-23

Tổng quan

Mục đích của hướng dẫn này là mô tả cách định cấu hình các bản cập nhật phần mềm fwupd do giao diện người dùng ChromeOS hỗ trợ.

Thông tin khái quát

fwupd là một trình nền nguồn mở thực hiện các bản cập nhật chương trình cơ sở cho thiết bị ngoại vi và các hệ thống khác dựa trên Linux. fwupd là cơ chế mà ChromeOS dùng để cập nhật chương trình cơ sở cho thiết bị ngoại vi.

Tải trọng cập nhật fwupd bao gồm các tệp .cab được lưu trữ trong Dịch vụ phần mềm của nhà cung cấp Linux (LVFS). Trong Linux, các bản cập nhật fwupd có thể được cung cấp rộng rãi sau khi được tải lên LVFS. Tuy nhiên, để các bản cập nhật có thể được cung cấp trong ChromeOS, nhóm ChromeOS sẽ xác minh và đưa các bản cập nhật mới vào danh sách cho phép riêng để đảm bảo mang lại trải nghiệm tối ưu cho người dùng.

Quy trình fwupd

Sau đây chỉ áp dụng cho các thiết bị ngoại vi được chứng nhận WWCB mà mẫu đã được gửi đến Allion.

Nếu phiên bản fwupd hiện tại trong ChromeOS chưa hỗ trợ thiết bị ngoại vi, hãy làm theo hướng dẫn trong trường hợp sử dụng 1 và trường hợp sử dụng 2. Nếu phiên bản fwupd hiện tại trong ChromeOS đã hỗ trợ thiết bị ngoại vi, thì hãy chuyển sang trường hợp sử dụng 2.

Trường hợp sử dụng 1: Phiên bản fwupd hiện tại của ChromeOS không hỗ trợ thiết bị ngoại vi

Phiên bản fwupd hiện tại trong ChromeOS chưa hỗ trợ thiết bị ngoại vi này.

1. ODM và OEM sẽ làm việc trực tiếp với các nhà cung cấp chipset để gửi các thay đổi về trình bổ trợ vào cơ sở mã fwupd.

   1. Tham khảo Sổ tay tích hợp fwupd (Bước thứ hai – sử dụng fwupd).
   2. Thay đổi về trình bổ trợ: ví dụ 1, ví dụ 2
   3. VIDs:PIDs trùng khớp trong tệp .quirk: ví dụ 3
      • Ngoài các thay đổi đối với tệp quirk, nếu thiết bị ngoại vi USB được trình bổ trợ hiện có hỗ trợ, thì bạn có thể tuân theo quy cách DS20.
   4. Hợp nhất các thay đổi về trình bổ trợ và hành vi bất thường do người duy trì fwupd thực hiện.
   5. Chờ bản phát hành chính thức của fwupd (tức là 1.8.4), hãy ghi lại phiên bản.

2. Các bản phát hành fwupd thường xuyên được phản chiếu vào ChromeOS và sẽ tuân theo lịch phát hành Chromium.

3. Nếu bạn gửi các thay đổi về trình bổ trợ, bản sửa lỗi hoặc các thay đổi về tệp đặc biệt sau ngày ngừng bổ sung tính năng của một bản phát hành Chromium sắp tới, nhưng các thay đổi đó có mức độ ưu tiên cao đối với bản phát hành ChromeOS tiếp theo, thì:

   1. Chuyển đến Trình theo dõi vấn đề của đối tác.
   2. Đăng nhập bằng Tài khoản miền đối tác của Google.

   3. Nhấp vào nút Tạo vấn đề trong trình đơn bên trái để tạo một lỗi trong thành phần của bạn (ChromeOS > External > WWCB > PERIPHERAL OEM > fwupd). Thao tác này sẽ cảnh báo cho nhóm ChromeOS để nâng cấp phiên bản fwupd trong ChromeOS.

      Cung cấp thông tin sau trong lỗi:

      1. Tiêu đề lỗi:

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

      2. Nội dung mô tả lỗi:

         1. Số phiên bản fwupd bao gồm các thay đổi về trình bổ trợ:
            • Những tính năng nào được thêm vào?
            • Những lỗi nào đã được khắc phục?
            • Những thiết bị nào được hỗ trợ?
         2. Hãng sản xuất/Kiểu thiết bị
         3. VID, PID
         4. GUID (giá trị nhận dạng duy nhất trên toàn cầu)

      3. Ảnh chụp màn hình ví dụ:

         

4. Lỗi này sẽ được phân loại và phiên bản chọn lọc của fwupd sẽ được các kỹ sư Google tích hợp vào ChromeOS.

   • Ví dụ về danh sách thay đổi 1
   • Lưu ý: fwupd uprev tuân theo lịch phát hành Chromium, hãy đảm bảo bạn gửi yêu cầu fwupd uprev trước ngày ngừng cung cấp tính năng của nhánh.

5. Phiên bản fwupd được nâng cấp sẽ được chuyển lên kênh canary khi danh sách thay đổi được phê duyệt.

   • Để lại bình luận về lỗi để biết phiên bản bản dựng nào của ChromeOS bao gồm phiên bản fwupd được nâng cấp. Bạn cũng có thể dùng CL Finder để tìm kiếm phiên bản bản dựng trong Bảng điều khiển đối tác ChromeOS (CPCon) (yêu cầu có tài khoản miền đối tác của Google Corp, vui lòng liên hệ với TAM để được cấp quyền truy cập vào CPCon).

Trường hợp sử dụng 2: Phiên bản fwupd hiện tại của ChromeOS hỗ trợ thiết bị ngoại vi

Phiên bản fwupd hiện tại trong ChromeOS đã hỗ trợ thiết bị ngoại vi và có sẵn chương trình cơ sở mới.

1. Tạo tệp .cab.

   Tất cả chương trình cơ sở đều được tải lên dưới dạng một tệp lưu trữ cabinet. Cùng với tệp nhị phân phần sụn, LVFS yêu cầu kho lưu trữ chứa ít nhất một tệp .metainfo.xml mô tả thiết bị đích và phần sụn. Bạn có thể tạo tệp lưu trữ cabinet bằng gcab (một thư viện để tạo tệp cabinet) trên Linux.

2. Tải bản cập nhật chương trình cơ sở đã kiểm thử và là bản cuối cùng (tệp .cab) lên LVFS.

   1. Đảm bảo bản cập nhật có trên điều khiển từ xa ổn định.

      Nếu có trên kho lưu trữ từ xa riêng tư, hạn chế hoặc thử nghiệm, thì kho lưu trữ đó sẽ không được thêm vào bản sao ChromeOS.

   2. Bản cập nhật được đánh dấu là đã xác thực trong LVFS thông qua báo cáo đã ký.

      Đảm bảo bạn đã thêm các kiểm thử thiết bị.

      • Ví dụ về tệp json, được khung kiểm thử hỗ trợ để kiểm thử thiết bị

   3. Nếu đây là lần đầu tiên bạn tải chương trình cơ sở lên, hãy đảm bảo rằng có ít nhất 2 chương trình cơ sở, chương trình cơ sở cơ bản (để kiểm thử việc hạ cấp) và chương trình cơ sở mới (để kiểm thử việc nâng cấp) trong kho lưu trữ từ xa ổn định của LVFS.

3. Bạn nên kiểm thử bản nâng cấp chương trình cơ sở trên ChromeOS thông qua một báo cáo đã ký.

   1. Tải chứng chỉ lên LVFS để liên kết DUT với tài khoản của bạn.

      1. Đăng nhập vào LVFS bằng tài khoản của bạn.
      2. Nhấp vào biểu tượng "Người dùng" ở trên cùng bên phải hoặc nhấp vào https://fwupd.org/lvfs/profile{:.external}.
      3. Nhấp vào Cài đặt hồ sơ.

      4. Tìm Chứng chỉ ứng dụng trên Chromebook.

         • Lưu ý: Chromebook phải ở Chế độ nhà phát triển
         • Khởi chạy trình bao nhà phát triển ChromeOS bằng cách nhấn tổ hợp phím ctrl+alt+t

         • Loại:

           shell

         • Chuyển đến /var/lib/fwupd/pki:

           cd /var/lib/fwupd/pki

         • Sao chép client.pem vào một thư mục trên Chromebook, ví dụ: Downloads.

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

   2. Nhấp vào nút Tải chứng chỉ lên trong phần Chứng chỉ máy khách trên trang web LVFS rồi tải chứng chỉ lên.

      1. Lặp lại các bước này trên mỗi Chromebook mà bạn đang dùng để kiểm thử (bạn có thể tải nhiều chứng chỉ lên cho các máy tính khác nhau).

   3. Kiểm thử quá trình nâng cấp và tải báo cáo đã ký lên thông qua DUT.

      1. Để kiểm thử và tải báo cáo lên, hãy chạy các lệnh sau và xác thực khi được nhắc.

         fwupdmgr refresh
         fwupdmgr update
         fwupdmgr report-history --sign

      2. Lưu ý: Nếu đã tải báo cáo lên mà không có cờ --sign, bạn có thể dùng fwupdmgr report-history --sign --force để tải lại cùng một báo cáo lên LVFS.

         fwupdmgr report-history --sign --force

         • Bạn có thể truyền --verbose để xem phản hồi của máy chủ.

           fwupdmgr report-history --force --verbose

      3. Nhấp vào Có trong hộp thoại xác nhận.

         • Thao tác này sẽ tải báo cáo đã ký lên tài khoản của bạn.
         • Để xác nhận, hãy chuyển đến https://fwupd.org/lvfs/dashboard rồi nhấp vào Signed Reports (Báo cáo đã ký) trong phần Home (Trang chủ) ở trên cùng bên trái.
      Lưu ý: Báo cáo sẽ xuất hiện trên LVFS sau khoảng 4 giờ.

   4. Xác minh rằng phiên bản chương trình cơ sở trên LVFS có các báo cáo đã ký

      • Tìm kiếm thiết bị ngoại vi trên LVFS.
      • Nếu báo cáo đã ký được tải lên là sau khi nâng cấp thành công phiên bản chương trình cơ sở trên thiết bị ngoại vi bằng Chromebook, thì phần Được kiểm thử bởi sẽ cho biết phiên bản ChromeOS, phiên bản fwupd và thực thể. Xem ví dụ.
      • Đảm bảo rằng Phân phối có chọn lọc có dấu kiểm màu xanh lục "Có sẵn cho người dùng ChromeOS".

   5. Kể từ M126, người dùng ChromeOS sẽ chỉ có thể cập nhật chương trình cơ sở nếu chương trình cơ sở có các báo cáo đã ký (đã thử nghiệm với ChromeOS) trên LVFS.

      • Sau 24 giờ, người dùng có thể kết nối thiết bị ngoại vi với Chromebook và nâng cấp chương trình cơ sở thông qua giao diện người dùng ChromeOS. Chuyển đến phần Cài đặt > Giới thiệu về ChromeOS > Bản cập nhật chương trình cơ sở.
      • Lưu ý: Bản cập nhật chương trình cơ sở sẽ có sẵn nếu tất cả các thay đổi cần thiết về trình bổ trợ đều có trên ChromeOS cho một cột mốc nhất định.

Bạn có thể xem thêm thông tin chi tiết về báo cáo đã ký trên LVFS.

Câu hỏi thường gặp

Hỏi: Chromebook nào hỗ trợ fwupd?

Tất cả thiết bị ChromeOS chạy M101 trở lên.

Hỏi: Làm cách nào để biết phiên bản fwupd nào được tích hợp với ChromeOS?

1. Mở chrome://system thông qua trình duyệt (M109 trở lên).
   1. Chuyển đến fwupd_version.
2. Hoặc thông qua Chế độ nhà phát triển, bảng điều khiển gốc,
   1. Loại fwupdmgr --version
   2. Tìm runtime org.freedesktop.fwupd

Hỏi: Quy trình fwupd uprev mất bao lâu?

fwupd uprev tuân theo lịch phát hành Chromium, đảm bảo yêu cầu fwupd uprev được gửi trước ngày ngừng phát triển tính năng của nhánh.

Hỏi: Tôi có thể xem thêm thông tin về lịch phát hành ChromeOS ở đâu?

Trong Lịch phát hành Chromium.

Hỏi: Làm cách nào để chuyển Chromebook sang Chế độ nhà phát triển?

1. Tắt Chromebook.
2. Giữ phím esc+Làm mới rồi nhấn nút Nguồn.
   • Lưu ý: Trên một số Chromebook, bạn có thể nhấn đồng thời phím esc + → (phím mũi tên phải) rồi nhấn nút Nguồn.
3. Thiết bị sẽ bật và bạn sẽ thấy màn hình / chế độ Khôi phục.
4. Sau đó, nhấn tổ hợp phím ctrl+d, rồi nhấn phím Enter để chấp nhận.
   • Lưu ý: Nếu bạn nhấn bất kỳ phím nào trước khi nhấn tổ hợp phím ctrl+d, thì thiết bị sẽ không chuyển sang chế độ nhà phát triển.
5. Thiết bị sẽ khởi động lại, phát ra tiếng bíp và bạn sẽ thấy thông báo "Hệ thống của bạn đang chuyển sang Chế độ nhà phát triển".
6. Sau khoảng 30 giây, bạn sẽ thấy thông báo "Đang chuẩn bị hệ thống cho Chế độ nhà phát triển".
7. Cuối cùng (quá trình này có thể mất từ 10 phút đến hơn 1 giờ, tuỳ thuộc vào kích thước ổ đĩa), thiết bị sẽ khởi động lại và chuyển sang màn hình chào mừng thông thường.
8. Để mở Dấu nhắc lệnh, hãy nhấn tổ hợp phím ctrl+alt+→ (phím mũi tên phải).
   • Lưu ý: Trên một số Chromebook, tổ hợp phím này là ctrl+alt+phím làm mới.
   • Để quay lại chế độ xem trình duyệt, hãy nhấn tổ hợp phím ctrl+alt+← (phím mũi tên trái).
9. Bạn có thể xem thêm thông tin chi tiết trong phần [Chế độ nhà phát triển]

Hỏi: Làm cách nào để chuyển Chromebook sang Chế độ bình thường (tức là tắt Chế độ nhà phát triển)?

Khởi động lại thiết bị rồi nhấn phím cách trên màn hình chương trình cơ sở.

Bạn có thể xem thêm thông tin chi tiết trong phần [Chế độ nhà phát triển].

Hỏi: ChromeOS có hỗ trợ hạ cấp thông qua fwupd không?

Không. Nếu phiên bản Sản xuất của fwupd hoặc chương trình cơ sở bị lỗi, bạn sẽ phải xoá báo cáo đã ký thông qua https://fwupd.org/lvfs/dashboard. Bạn cần kiểm thử bất cứ khi nào gửi các thay đổi về trình bổ trợ và/hoặc có một chương trình cơ sở mới. Đảm bảo luôn có phiên bản cơ sở của chương trình cơ sở trên một thiết bị từ xa ổn định của LVFS.

Hỏi: Làm cách nào để biết phiên bản ChromeOS nào sẽ hỗ trợ bản cập nhật fwupd nào?

Bạn có thể để lại bình luận về lỗi để hỏi phiên bản bản dựng mà các thay đổi được đưa vào và các Kỹ sư của Google sẽ có thể cung cấp cho bạn thông tin đó. Bạn cũng có thể sử dụng CL Finder để tìm kiếm phiên bản bản dựng trong bảng điều khiển đối tác ChromeOS (CPCon) (yêu cầu có tài khoản miền đối tác của Google corp – hãy liên hệ với TAM để được cấp quyền truy cập vào CPCon). Bạn có thể tham khảo chéo phiên bản bản dựng trên Giao diện người dùng đối tác ChromeOS (CPFE) để xem phiên bản đó tương ứng với cột mốc nào.

Hỏi: Làm cách nào để tạo tài khoản LVFS?

Tham khảo tài liệu Lấy tài khoản LVFS.

Hỏi: Làm cách nào để tải tệp cab lên LVFS?

Tham khảo tài liệu LVFS về Tải phần mềm cố định lên.

Hỏi: Làm cách nào để đảm bảo chương trình cơ sở dành cho một thiết bị ngoại vi cụ thể?

Bạn có thể thực hiện việc này thông qua tệp cấu hình được biết đến nhiều nhất. Hãy tham khảo Cấu hình tốt nhất đã biết của fwupd để biết thêm thông tin.

Hỏi: Làm cách nào để kiểm thử bản cập nhật fwupd trước khi tải lên LVFS?

Sau khi gửi các thay đổi về trình bổ trợ và phiên bản chọn lọc của fwupd được kết hợp vào hình ảnh kiểm thử ChromeOS, bạn có thể truy cập vào hình ảnh kiểm thử thông qua Giao diện người dùng đối tác ChromeOS (CPFE) (yêu cầu có tài khoản miền đối tác của Google corp – hãy liên hệ với TAM để có quyền truy cập vào CPFE).

Tham khảo tài liệu LVFS Kiểm thử phần mềm trên ChromeOS. Ngoài ra, bạn cũng có thể chạy các kiểm thử fwupd bằng Moblab.

Hỏi: Làm cách nào để người dùng nhận được thông báo rằng có bản cập nhật chương trình cơ sở cho thiết bị ngoại vi của họ?

Người dùng sẽ nhận được thông báo cho biết có bản cập nhật dựa trên mức độ khẩn cấp mà bản cập nhật được chỉ định trong LVFS. Hành vi như sau:

Khẩn cấp	Cách hoạt động của thông báo
Thấp	Người dùng sẽ không nhận được thông báo và phải tự kiểm tra xem có bản cập nhật hay không.
Phương tiện
Cao
Nghiêm trọng	Thông báo sẽ xuất hiện mỗi khi khởi động cho đến khi quá trình cập nhật hoàn tất.

Hỏi: fwupd có tự động cập nhật không?

Không. Tất cả các bản cập nhật fwupd đều do người dùng khởi tạo và sẽ không diễn ra trong quá trình khởi động hoặc tự động.

Hỏi: Quy cách DS20 có lợi thế gì?

Hiện chỉ xác minh cho các thiết bị ngoại vi USB, nếu bạn sử dụng cùng một giao thức như trên phần cứng khác, thì giao thức này sẽ chỉ hoạt động với một nội dung mô tả DS20.

Nhà cung cấp có thể đưa dữ liệu tệp lỗi vào nội dung mô tả USB thay vì vào dự án fwupd. Bằng cách đó, thiết bị USB sẽ được chèn, fwupd đọc dữ liệu mô tả, so khớp trình bổ trợ, liệt kê thiết bị mà không cần nhà cung cấp gửi bản vá cho fwupd và chờ fwupd uprev.

Hỏi: DS20 có phải là lựa chọn thay thế để chỉ thay đổi tệp quirk không?

Có; hầu hết thời gian, phần cứng trong tương lai chỉ cần thêm VID và PID vào một trình bổ trợ hiện có, thay vì thay đổi mã thực tế. Nếu cần thay đổi mã, thì nhà cung cấp phải gửi các thay đổi về trình bổ trợ cho fwupd.

Phụ lục

1. Hướng dẫn dành cho nhà phát triển
2. Hỗ trợ dành cho nhà phát triển
3. Giới thiệu về Git và Gerrit cho cộng tác viên CrOS
4. Thay đổi mã nguồn
5. Quy trình phê duyệt/xem xét trên Gerrit
6. Sổ tay tích hợp fwupd

Nhật ký sửa đổi

Ngày	Phiên bản	Ghi chú
2025-07-23	2.4.3	Cập nhật quy trình làm việc của Trường hợp sử dụng 1
2024-10-18	2.4.2	Cập nhật hình ảnh và các bước trong quy trình fwupd để tải chứng chỉ ứng dụng lên
2024-07-23	2.4.1	Cập nhật định dạng.
2024-06-26	2.4	Cập nhật quy trình fwupd uprev (trường hợp sử dụng 1).(xuất bản cùng với 2.4.1)
2024-06-17	2.3	Cập nhật quy trình làm việc Báo cáo đã ký. (xuất bản cùng với phiên bản 2.4.1)
2024-02-01	2.2	Xuất bản lại trên nền tảng mới; cập nhật một số từ ngữ.
2023-10-12	2.1	Đã thêm hình ảnh trong Trường hợp 1 và Trường hợp 2, Sổ tay tích hợp fwupd được lưu trữ trong Trang web của đối tác
2022-08-14	2	Công bố trang web đối tác ban đầu