dfu-tool - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

dfu-tool - Công cụ nâng cấp chương trình cơ sở thiết bị

SYNOPSIS

công cụ dfu [ --dài dòng ] [ --phiên bản ] [ --lực lượng ] [ --device = VID: PID ] [ --chuyển khoản-
kích thước = BYTES ]

MÔ TẢ

Trang hướng dẫn sử dụng này tài liệu ngắn gọn về công cụ dfu chỉ huy.

công cụ dfu cho phép người dùng ghi nhiều loại phần sụn khác nhau lên các thiết bị hỗ trợ USB
Giao thức nâng cấp chương trình cơ sở thiết bị. Công cụ này có thể được sử dụng để chuyển thiết bị từ
chế độ thời gian chạy bình thường sang chế độ DFU cho phép người dùng đọc và ghi phần sụn.
Toàn bộ thiết bị có thể được ghi trong một thao tác hoặc các `` mục tiêu '' riêng lẻ có thể được
được chỉ định với tên hoặc số thay thế.

công cụ dfu sử dụng thư viện chia sẻ libdfu để thực hiện các hành động. Tất cả các hành động đồng bộ có thể
được hủy một cách an toàn và nếu không thành công sẽ trả lại lỗi với cả một loại và một văn bản đầy đủ
sự mô tả. libdfu hỗ trợ DFU 1.0, DFU 1.1 và phần mở rộng dành cho nhà cung cấp ST DfuSe, và
xử lý nhiều lỗi thiết bị cần thiết cho việc triển khai DFU trong thế giới thực.

Ngoài ra công cụ dfu có thể được sử dụng để chuyển đổi chương trình cơ sở từ nhiều định dạng khác nhau, hoặc
để sửa đổi thông tin chi tiết về các phần tử, hình ảnh và siêu dữ liệu có bên trong chương trình cơ sở
tập tin. Ví dụ: bạn có thể dễ dàng chuyển đổi phần sụn DFU 1.1 thành DfuSe của nhà cung cấp cụ thể
định dạng, chuyển đổi tệp Intel HEX thành tệp thô được đệm theo kích thước cụ thể hoặc thêm tệp mới
bản quyền và thông tin cấp phép cho một tệp hiện có. Các trường chẳng hạn như nhà cung cấp và
ID sản phẩm có thể được thay đổi và các phần tử chương trình cơ sở có thể được mã hóa và giải mã bằng cách sử dụng
nhiều phương pháp khác nhau. Cũng có thể hợp nhất hai tệp DfuSe với nhau, mặc dù
chỉ định các số thiết lập thay thế khác nhau trước khi hợp nhất là một ý kiến ​​hay để tránh nhầm lẫn.

Mặc dù công cụ dfu cố gắng cung cấp một số lượng lớn các lệnh dễ sử dụng, nó chỉ có thể
có thể thực hiện các thao tác nhất định bằng cách sử dụng thư viện libdfu trực tiếp. Điều này dễ dàng hơn
nghe có vẻ vậy, vì thư viện được xây dựng với hỗ trợ GObject Introspection, giúp nó có thể sử dụng được trong
nhiều ngôn ngữ như C, Javascript và Python. Hơn nữa, sử dụng thư viện là một
ví dụ: nếu bạn muốn thực hiện nhiều thao tác trên các tệp phần sụn lớn,
chuyển đổi từ tệp Intel HEX, đệm thành một kích thước nhất định, thiết lập nhà cung cấp và thêm
thông tin cấp phép và sau đó lưu vào một vị trí từ xa.

LỰA CHỌN

Chương trình này tuân theo cú pháp dòng lệnh GNU thông thường, với các tùy chọn dài bắt đầu bằng
hai dấu gạch ngang (-). Dưới đây là một bản tóm tắt các tùy chọn.

--Cứu giúp
Hiển thị tóm tắt của tất cả các lệnh có sẵn để sử dụng.

--phiên bản
Hiển thị phiên bản của công cụ dfu cài đặt.

--dài dòng
Hiển thị thêm thông tin gỡ lỗi.

--device = VID: PID
Nếu nhiều thiết bị hỗ trợ DFU được đính kèm, bạn có thể chỉ định nhà cung cấp cụ thể
và ID sản phẩm của thiết bị DFU mà bạn muốn truy vấn.

--transfer-size = BYTES
Ghi đè thủ công kích thước của mỗi lần chuyển USB mà bạn có thể muốn vì không đáng tin cậy
phần cứng hoặc khi thiết bị có kích thước gói lớn nhất mà nó chấp nhận.

--lực lượng
Buộc thực hiện, bỏ qua các cảnh báo hoặc kiểm tra sự tỉnh táo như tệp CRC và
tổng kiểm tra. Điều này rất hữu ích nếu bạn thực sự biết mình đang làm gì hoặc
trường hợp chuyên biệt của libdfu kiểm tra lông tơ.

THIẾT BỊ HÀNG

Các lệnh này được sử dụng để giao tiếp với các thiết bị hỗ trợ DFU.


Lệnh này liệt kê các thiết bị có hỗ trợ DFU hiện được đính kèm. Một số thiết bị không
hỗ trợ chế độ thời gian chạy DFU chính thức và do đó không hỗ trợ tự động phát hiện bằng cách sử dụng
lệnh này. Đối với những thiết bị đó, đưa thiết bị vào chế độ DFU theo cách thủ công (ví dụ:
bằng cách nhấn giữ một nút khi khởi động lại thiết bị) sẽ hiển thị ở đây.

tách ra
Lệnh này tách thiết bị có khả năng DFU được đính kèm hiện tại thành một thiết bị đặc biệt
chế độ lập trình. Trong khi thiết bị ở chế độ DFU đặc biệt này, nó không thể được sử dụng
như một thiết bị bình thường. Ví dụ: máy in sẽ không chấp nhận tài liệu khi ở DFU
chế độ.

đính kèm
Lệnh này gắn một thiết bị có khả năng DFU trở lại thời gian chạy để nó có thể được sử dụng như một
thiết bị bình thường. Một số thiết bị không hỗ trợ đính kèm và cần phải thực hiện thủ công
ngắt kết nối và kết nối trước khi thay đổi chế độ.

đồng hồ đeo tay
Lệnh này xem các thiết bị DFU đang được cắm nóng và có thể được sử dụng để xác minh libdfu
khớp với thời gian chạy và chế độ DFU khi gắn và tách. Sử dụng CTRL + C đến
làm cho lệnh này thoát.

đọc TÊN TỆP
Lệnh này tải lên tất cả phần sụn từ thiết bị thành một tệp. Nếu thiết bị có
nhiều phân vùng được xuất dưới dạng các phần thay thế khác nhau thì tất cả chúng sẽ
được đọc thành tệp định dạng DfuSe nhiều hình ảnh. Nếu bạn chỉ muốn nội dung của một
vách ngăn, đọc thay thế là lệnh bạn muốn.

đọc thay thế TÊN TỆP THIẾT BỊ-ALT-TÊN | THIẾT BỊ-ALT-ID
Lệnh này tải lên chương trình cơ sở từ một phân vùng thành một tệp. Bạn có thể chỉ định
phân vùng theo ALT-ID hoặc ALT-NAME nếu được đặt.

ví dụ công cụ dfu đọc thay thế sao lưu.dfu SRAM

viết
Lệnh này tải chương trình cơ sở từ một tệp vào tất cả các phân vùng có thể có của
thiết bị. Nếu bạn chỉ muốn ghi một phân vùng, ghi-alt là lệnh bạn
muốn.

ghi-alt TÊN TỆP THIẾT BỊ-ALT-TÊN | THIẾT BỊ-ALT-ID [IMAGE-ALT-NAME | IMAGE-ALT-ID]
Lệnh này tải phần sụn từ tệp vào một phân vùng. Bạn có thể chỉ định
phân vùng theo ALT-ID hoặc ALT-NAME nếu được đặt.

ví dụ công cụ dfu ghi-alt sram.dfu SRAM __SRAM

PHẦN MỀM HÀNG

Các lệnh này được sử dụng để đọc và sửa đổi các tệp phần sụn hiện có.

đổ TÊN TỆP
Lệnh này kết xuất tất cả các thông tin chi tiết về một tệp phần sụn. Bản đồ bộ nhớ hoàn chỉnh
được hiển thị, cùng với bất kỳ siêu dữ liệu hoặc thông tin nhà cung cấp nào về tệp phần sụn.

chuyển đổi FORMAT TRONG TẬP TIN TẬP TIN RA [KÍCH THƯỚC]
Lệnh này chuyển đổi phần sụn từ định dạng này sang định dạng khác, tùy chọn đệm
đến một kích thước nhất định. Các giá trị có thể có cho điểm đến FORMAT bao gồm: raw, ihex,
dfu và dfuse. Các TRONG TẬP TIN và TẬP TIN RA các giá trị có thể giống nhau nếu tệp nguồn
sẽ được ghi đè. Mặc dù padding làm tăng kích thước tệp mà không rõ ràng
nó có thể được sử dụng để hỗ trợ các thiết bị không lưu trữ hình ảnh thời gian chạy
kích thước và nơi yêu cầu xác nhận phần sụn đã viết.

ví dụ công cụ dfu chuyển đổi dfu phần sụn.hex phần sụn.dfu 8000

mã hóa PHIM VÀO TÊN TỆP-OUT LOẠI KEY
Lệnh này mã hóa dữ liệu phần sụn. Chỉ có nội dung hình ảnh là thực sự
đã sửa đổi, phần chân trang DFU và phần đầu trang DfuSe không bị thay đổi. Các giá trị có thể có cho
đích đến LOẠI bao gồm: xtea và nop. Nếu KEY không phải là bắt buộc
độ dài nó được sử dụng làm đầu vào cho một hàm băm có thể tạo ra một khóa của
kích thước yêu cầu.

ví dụ công cụ dfu mã hóa phần sụn.dfu phần sụn.xdfu trà thịt bò chết

giải mã PHIM VÀO TÊN TỆP-OUT LOẠI KEY
Lệnh này giải mã dữ liệu phần sụn. Chỉ có nội dung hình ảnh là thực sự
đã sửa đổi, phần chân trang DFU và phần đầu trang DfuSe không bị thay đổi. Các giá trị có thể có cho
đích đến LOẠI bao gồm: xtea và nop. Nếu KEY không phải là bắt buộc
độ dài nó được sử dụng làm đầu vào cho một hàm băm có thể tạo ra một khóa của
kích thước yêu cầu.

ví dụ công cụ dfu giải mã phần sụn.xdfu phần sụn.dfu trà thịt bò chết

hợp nhất TẬP TIN RA TỆP1 TỆP2 [FILE3 ...]
Lệnh này hợp nhất nhiều tệp phần sụn thành một tệp. Mặc dù bạn có thể hợp nhất
các tệp có cùng ALT-ID hoặc ALT-NAME, đây có thể không phải là điều bạn muốn làm.

ví dụ công cụ dfu hợp nhất kết hợp.dfu lib.dfu ứng dụng.dfu

set-alt-cài đặt FILE ID ALT
Lệnh này sửa đổi số thay thế trên tệp phần sụn.

ví dụ công cụ dfu set-alt-cài đặt phần sụn.dfu 1

set-alt-setting-name
Lệnh này sửa đổi tên thay thế trên tệp phần sụn.

ví dụ công cụ dfu set-alt-setting-name phần sụn.dfu SRAM

siêu dữ liệu set FILE KEY VALUE
Lệnh này thêm hoặc sửa đổi siêu dữ liệu hiện có trên tệp phần sụn. LƯU Ý: Có
chỉ có không gian lưu trữ siêu dữ liệu rất hạn chế trong các tệp DFU, vì vậy các khóa và giá trị phải
giữ càng ngắn càng tốt. Đặc biệt, giá trị Giấy phép phải được chỉ định trong
Định dạng SPDX.

ví dụ công cụ dfu siêu dữ liệu set phần sụn.dfu giấy phép GPL-2.0 +

nhà cung cấp thiết lập FILE VID
Lệnh này đặt ID nhà cung cấp trên tệp phần sụn sẽ được sử dụng để khớp với
các thiết bị. Giá trị của ffff sẽ phù hợp với bất kỳ nhà cung cấp thiết bị nào.

ví dụ công cụ dfu nhà cung cấp thiết lập phần sụn.dfu 273f

bộ sản phẩm FILE PID
Lệnh này đặt ID sản phẩm trên một tệp phần sụn sẽ được sử dụng để khớp
các thiết bị cụ thể. Giá trị của ffff sẽ phù hợp với bất kỳ sản phẩm thiết bị nào.

ví dụ công cụ dfu bộ sản phẩm phần sụn.dfu 1004

thiết lập phát hành FILE RELEASE
Lệnh này đặt phiên bản phát hành trên tệp phần sụn sẽ được sử dụng để khớp
các thiết bị cụ thể. Giá trị của ffff sẽ khớp với bất kỳ bản phát hành thiết bị nào.

ví dụ công cụ dfu thiết lập phát hành phần sụn.dfu fff

Sử dụng dfu-tool trực tuyến bằng các dịch vụ onworks.net