dfu-tool - ออนไลน์ใน Cloud

โครงการ:

ชื่อ

dfu-tool - เครื่องมืออัปเกรดเฟิร์มแวร์อุปกรณ์

เรื่องย่อ

เครื่องมือ dfu [ --รายละเอียด ] [ --รุ่น ] [ --บังคับ ] [ --อุปกรณ์=VID:PID ] [ --โอนย้าย-
ขนาด=BYTES ]

DESCRIPTION

หน้าคู่มือนี้จัดทำเอกสารโดยสังเขปเกี่ยวกับ เครื่องมือ dfu คำสั่ง

เครื่องมือ dfu อนุญาตให้ผู้ใช้เขียนเฟิร์มแวร์ประเภทต่างๆ ลงในอุปกรณ์ที่รองรับ USB
โปรโตคอลการอัพเกรดเฟิร์มแวร์ของอุปกรณ์ เครื่องมือนี้สามารถใช้เพื่อสลับอุปกรณ์จาก
โหมดรันไทม์ปกติเป็น `โหมด DFU' ซึ่งช่วยให้ผู้ใช้สามารถอ่านและเขียนเฟิร์มแวร์ได้
สามารถเขียนทั้งอุปกรณ์ในการดำเนินการเดียว หรือ "เป้าหมาย" แต่ละรายการสามารถเป็นได้
ระบุด้วยชื่อหรือหมายเลขอื่น

เครื่องมือ dfu ใช้ไลบรารีที่ใช้ร่วมกันของ libdfu เพื่อดำเนินการ การกระทำแบบซิงโครนัสทั้งหมดสามารถ
ถูกยกเลิกอย่างปลอดภัยและเมื่อล้มเหลวจะส่งคืนข้อผิดพลาดที่มีทั้งแบบและข้อความเต็ม
คำอธิบาย. libdfu รองรับ DFU 1.0, DFU 1.1 และส่วนขยายผู้ขาย ST DfuSe และ
จัดการกับ `นิสัยใจคอ' ของอุปกรณ์หลายอย่างที่จำเป็นสำหรับการนำ DFU ไปใช้งานจริง

นอกจากนี้ เครื่องมือ dfu สามารถใช้ในการแปลงเฟิร์มแวร์จากรูปแบบต่างๆ หรือ
เพื่อแก้ไขรายละเอียดเกี่ยวกับองค์ประกอบ รูปภาพ และข้อมูลเมตาที่มีอยู่ในเฟิร์มแวร์
ไฟล์. ตัวอย่างเช่น คุณสามารถแปลงเฟิร์มแวร์ DFU 1.1 เป็น DfuSe . เฉพาะผู้จำหน่ายได้อย่างง่ายดาย
ฟอร์แมต, แปลงไฟล์ Intel HEX เป็นไฟล์ดิบที่มีขนาดเฉพาะ หรือเพิ่มใหม่
ข้อมูลลิขสิทธิ์และใบอนุญาตไปยังไฟล์ที่มีอยู่ เขตข้อมูลเช่นผู้ขายและ
รหัสผลิตภัณฑ์สามารถเปลี่ยนแปลงได้ และองค์ประกอบเฟิร์มแวร์สามารถเข้ารหัสและถอดรหัสได้โดยใช้
วิธีการต่างๆ การรวมไฟล์ DfuSe สองไฟล์เข้าด้วยกันก็เป็นไปได้เช่นกัน
การระบุหมายเลขการตั้งค่า alt ต่างๆ ก่อนการรวมเป็นความคิดที่ดีเพื่อหลีกเลี่ยงความสับสน

แม้ว่า เครื่องมือ dfu พยายามให้คำสั่งที่ใช้งานง่ายจำนวนมาก อาจเป็นได้เพียง
เป็นไปได้ที่จะดำเนินการบางอย่างโดยใช้ไลบรารี libdfu โดยตรง ง่ายกว่า
ฟังดูแล้วเพราะว่าไลบรารี่ถูกสร้างขึ้นด้วยการสนับสนุน GObject Introspection ทำให้ใช้งานได้ใน
หลายภาษาเช่น C, Javascript และ Python นอกจากนี้การใช้ห้องสมุดเป็นสิ่งที่ดี
แนวคิดถ้าคุณต้องการดำเนินการหลายอย่างกับไฟล์เฟิร์มแวร์ขนาดใหญ่ เช่น
แปลงจากไฟล์ Intel HEX, เติมขนาดบาง, ตั้งค่าผู้จำหน่ายและเพิ่ม
ข้อมูลใบอนุญาตแล้วบันทึกไปยังตำแหน่งระยะไกล

OPTIONS

โปรแกรมนี้ใช้ไวยากรณ์บรรทัดคำสั่งของ GNU ตามปกติ โดยมีตัวเลือกแบบยาวขึ้นต้นด้วย
สองขีดกลาง (-) สรุปตัวเลือกอยู่ด้านล่าง

--ช่วยด้วย
แสดงสรุปคำสั่งทั้งหมดที่มีให้ใช้งาน

--รุ่น
แสดงเวอร์ชันของ เครื่องมือ dfu การติดตั้ง

--รายละเอียด
แสดงข้อมูลการดีบักเพิ่มเติม

--อุปกรณ์=VID:PID
หากเชื่อมต่ออุปกรณ์ที่รองรับ DFU หลายเครื่อง คุณสามารถระบุผู้จำหน่ายเฉพาะได้
และ ID ผลิตภัณฑ์ของอุปกรณ์ DFU ที่คุณต้องการสอบถาม

--โอนขนาด=ไบต์
แทนที่ขนาดของการถ่ายโอน USB แต่ละรายการด้วยตนเอง ซึ่งคุณอาจต้องการไม่น่าเชื่อถือ
ฮาร์ดแวร์หรือเมื่ออุปกรณ์อยู่ที่ขนาดแพ็กเก็ตสูงสุดที่ยอมรับได้

--บังคับ
บังคับปฏิบัติการโดยไม่คำนึงถึงคำเตือนหรือตรวจสุขภาพจิต เช่น ไฟล์ CRC และ
เช็คซัม สิ่งนี้มีประโยชน์หากคุณรู้จริง ๆ ว่าคุณกำลังทำอะไรอยู่ หรือใน
กรณีเฉพาะของ libdfu การทดสอบฟัซ

อุปกรณ์ คำสั่ง

คำสั่งเหล่านี้ใช้เพื่อเชื่อมต่อกับอุปกรณ์ที่รองรับ DFU

รายการ
คำสั่งนี้แสดงรายการอุปกรณ์ที่รองรับ DFU ที่เชื่อมต่ออยู่ในปัจจุบัน อุปกรณ์บางอย่างไม่
รองรับโหมดรันไทม์ DFU อย่างเป็นทางการ จึงไม่รองรับการค้นหาอัตโนมัติโดยใช้
คำสั่งนี้ สำหรับอุปกรณ์เหล่านั้น ให้วางอุปกรณ์เข้าสู่โหมด DFU ด้วยตนเอง (เช่น
โดยกดปุ่มค้างไว้เมื่อรีบูตอุปกรณ์) จะทำให้ปรากฏขึ้นที่นี่

ถอดออก
คำสั่งนี้จะแยกอุปกรณ์ที่มีความสามารถ DFU ที่เชื่อมต่ออยู่ออกเป็นส่วนพิเศษ
โหมดการเขียนโปรแกรม ขณะที่อุปกรณ์อยู่ในโหมด DFU พิเศษนี้ จะไม่สามารถใช้งานได้
เป็นอุปกรณ์ปกติ ตัวอย่างเช่น เครื่องพิมพ์จะไม่รับเอกสารเมื่ออยู่ใน DFU
โหมด.

แนบ
คำสั่งนี้แนบอุปกรณ์ที่มีความสามารถ DFU กลับไปยังรันไทม์เพื่อให้สามารถใช้เป็นa
อุปกรณ์ปกติ อุปกรณ์บางอย่างไม่รองรับการต่อ และจำเป็นต้องเชื่อมต่อด้วยตนเอง
ตัดการเชื่อมต่อและเชื่อมต่อก่อนเปลี่ยนโหมด

ดู
คำสั่งนี้เฝ้าดูอุปกรณ์ DFU ที่กำลังถูกเสียบปลั๊กและสามารถใช้เพื่อตรวจสอบ libdfu
จับคู่รันไทม์และโหมด DFU เมื่อติดตั้งและถอดออก ใช้ CTRL + C ไปยัง
ทำให้คำสั่งนี้ออก

อ่าน ชื่อไฟล์
คำสั่งนี้จะอัปโหลดเฟิร์มแวร์ทั้งหมดจากอุปกรณ์ไปยังไฟล์ หากอุปกรณ์มี
พาร์ติชั่นหลายตัวส่งออกเป็นส่วนทางเลือกที่แตกต่างกันจากนั้นพวกเขาจะทั้งหมด
ถูกอ่านเป็นไฟล์รูปแบบ DfuSe แบบหลายภาพ หากคุณต้องการเนื้อหาของหนึ่ง
พาร์ทิชัน อ่าน-alt คือคำสั่งที่คุณต้องการ

อ่าน-alt ชื่อไฟล์ อุปกรณ์-ALT-ชื่อ|อุปกรณ์-ALT-ID
คำสั่งนี้จะอัปโหลดเฟิร์มแวร์จากพาร์ติชั่นหนึ่งไปยังไฟล์ คุณสามารถระบุ
แบ่งพาร์ติชันตาม ALT-ID หรือ ALT-NAME หากตั้งค่าไว้

เช่น เครื่องมือ dfu อ่าน-alt สำรองข้อมูล dfu SRAM

เขียน
คำสั่งนี้ดาวน์โหลดเฟิร์มแวร์จากไฟล์ไปยังพาร์ติชั่นที่เป็นไปได้ทั้งหมดของa
อุปกรณ์. หากคุณต้องการเขียนเพียงพาร์ติชั่นเดียว เขียน-alt เป็นคำสั่งให้คุณ
ต้องการ.

เขียน-alt ชื่อไฟล์ อุปกรณ์-ALT-ชื่อ|อุปกรณ์-ALT-ID [IMAGE-ALT-ชื่อ|IMAGE-ALT-ID]
คำสั่งนี้จะดาวน์โหลดเฟิร์มแวร์จากไฟล์ลงในพาร์ติชั่นเดียว คุณสามารถระบุ
พาร์ติชันโดย ALT-ID หรือ ALT-NAME หากตั้งค่าไว้

เช่น เครื่องมือ dfu เขียน-alt sram.dfu SRAM __สแรม

เฟิร์มแวร์ คำสั่ง

คำสั่งเหล่านี้ใช้เพื่ออ่านและแก้ไขไฟล์เฟิร์มแวร์ที่มีอยู่

กอง ชื่อไฟล์
คำสั่งนี้จะทิ้งรายละเอียดทั้งหมดเกี่ยวกับไฟล์เฟิร์มแวร์ แผนที่หน่วยความจำที่สมบูรณ์
จะแสดงพร้อมกับข้อมูลเมตาหรือข้อมูลผู้ขายเกี่ยวกับไฟล์เฟิร์มแวร์

แปลง FORMAT ไฟล์ใน ไฟล์ออก [ขนาด]
คำสั่งนี้จะแปลงเฟิร์มแวร์จากรูปแบบหนึ่งเป็นอีกรูปแบบหนึ่ง โดยสามารถเลือกช่องว่างภายในได้
ถึงขนาดที่แน่นอน ค่าที่เป็นไปได้สำหรับปลายทาง FORMAT รวม: ดิบ, ihex,
dfu และ dfuse NS ไฟล์ใน และ ไฟล์ออก ค่าสามารถเหมือนกันได้หากไฟล์ต้นฉบับ
จะถูกเขียนทับ แม้ว่า padding จะเพิ่มขนาดไฟล์โดยไม่มีความชัดเจน
ข้อดี สามารถใช้เพื่อรองรับอุปกรณ์ที่ไม่ได้จัดเก็บอิมเมจรันไทม์
ขนาดและตำแหน่งที่ต้องการการตรวจสอบความถูกต้องของเฟิร์มแวร์ที่เป็นลายลักษณ์อักษร

เช่น เครื่องมือ dfu แปลง DFU เฟิร์มแวร์.hex เฟิร์มแวร์. dfu 8000

การเข้ารหัสลับ FILENAME-ใน ชื่อไฟล์ออก ประเภท KEY
คำสั่งนี้เข้ารหัสข้อมูลเฟิร์มแวร์ เฉพาะเนื้อหาภาพเท่านั้น
แก้ไข ส่วนท้าย DFU และส่วนหัว DfuSe จะไม่มีการเปลี่ยนแปลง ค่าที่เป็นไปได้สำหรับ
ปลายทาง ประเภท รวม: xtea และ nop ถ้า KEY ไม่จำเป็น
ความยาวใช้เป็นอินพุตของฟังก์ชันแฮชซึ่งสามารถสร้างคีย์ของ
ขนาดที่ต้องการ

เช่น เครื่องมือ dfu การเข้ารหัสลับ เฟิร์มแวร์. dfu เฟิร์มแวร์ xdfu เอ็กซ์ที DeaDBeeF

ถอดรหัส FILENAME-ใน ชื่อไฟล์ออก ประเภท KEY
คำสั่งนี้จะถอดรหัสข้อมูลเฟิร์มแวร์ เฉพาะเนื้อหาภาพเท่านั้น
แก้ไข ส่วนท้าย DFU และส่วนหัว DfuSe จะไม่มีการเปลี่ยนแปลง ค่าที่เป็นไปได้สำหรับ
ปลายทาง ประเภท รวม: xtea และ nop ถ้า KEY ไม่จำเป็น
ความยาวใช้เป็นอินพุตของฟังก์ชันแฮชซึ่งสามารถสร้างคีย์ของ
ขนาดที่ต้องการ

เช่น เครื่องมือ dfu ถอดรหัส เฟิร์มแวร์ xdfu เฟิร์มแวร์. dfu เอ็กซ์ที DeaDBeeF

ผสาน ไฟล์ออก ไฟล์ 1 ไฟล์ 2 [ไฟล์3...]
คำสั่งนี้จะรวมไฟล์เฟิร์มแวร์หลายไฟล์เป็นไฟล์เดียว แม้ว่าคุณจะสามารถผสานได้
ไฟล์ที่มี ALT-ID หรือ ALT-NAME เดียวกัน อาจไม่ใช่สิ่งที่คุณต้องการทำ

เช่น เครื่องมือ dfu ผสาน รวม.dfu lib.dfu แอพ.dfu

set-alt-การตั้งค่า ไฟล์ ALT-ID
คำสั่งนี้แก้ไขหมายเลขสำรองในไฟล์เฟิร์มแวร์

เช่น เครื่องมือ dfu set-alt-การตั้งค่า เฟิร์มแวร์. dfu 1

ตั้งค่า alt การตั้งค่าชื่อ
คำสั่งนี้แก้ไขชื่ออื่นในไฟล์เฟิร์มแวร์

เช่น เครื่องมือ dfu ตั้งค่า alt การตั้งค่าชื่อ เฟิร์มแวร์. dfu SRAM

ชุดข้อมูลเมตา ไฟล์ KEY มูลค่า
คำสั่งนี้เพิ่มหรือแก้ไขข้อมูลเมตาที่มีอยู่ในไฟล์เฟิร์มแวร์ หมายเหตุ: มี
เฉพาะพื้นที่จัดเก็บข้อมูลเมตาที่จำกัดมากในไฟล์ DFU ดังนั้นคีย์และค่าควรเป็น
ให้สั้นที่สุด โดยเฉพาะอย่างยิ่ง ค่าใบอนุญาตควรระบุใน
รูปแบบ SPDX

เช่น เครื่องมือ dfu ชุดข้อมูลเมตา เฟิร์มแวร์. dfu ใบอนุญาต GPL-2.0+

ชุดผู้ขาย ไฟล์ VID
คำสั่งนี้ตั้งค่ารหัสผู้ขายในไฟล์เฟิร์มแวร์ที่จะใช้เพื่อให้ตรงกับเฉพาะ
อุปกรณ์ ค่าของ ffff จะตรงกับผู้จำหน่ายอุปกรณ์ใดๆ

เช่น เครื่องมือ dfu ชุดผู้ขาย เฟิร์มแวร์. dfu 273f

ชุดผลิตภัณฑ์ ไฟล์ PID
คำสั่งนี้ตั้งค่า ID ผลิตภัณฑ์ในไฟล์เฟิร์มแวร์ที่จะใช้เพื่อจับคู่
อุปกรณ์เฉพาะ ค่าของ ffff จะตรงกับผลิตภัณฑ์ของอุปกรณ์ใดๆ

เช่น เครื่องมือ dfu ชุดผลิตภัณฑ์ เฟิร์มแวร์. dfu 1004

ชุดปล่อย ไฟล์ ปล่อย
คำสั่งนี้ตั้งค่าเวอร์ชันที่วางจำหน่ายในไฟล์เฟิร์มแวร์ที่จะใช้เพื่อให้ตรงกัน
อุปกรณ์เฉพาะ ค่าของ ffff จะตรงกับรุ่นของอุปกรณ์ใดๆ

เช่น เครื่องมือ dfu ชุดปล่อย เฟิร์มแวร์. dfu ffff

ใช้ dfu-tool ออนไลน์โดยใช้บริการ onworks.net