dfu-tool - מקוון בענן

תָכְנִית:

שֵׁם

dfu-tool - כלי לשדרוג קושחה למכשיר

תַקצִיר

dfu-tool [ --מִלוּלִי ] [ --גִרְסָה ] [ --כּוֹחַ ] [ --device=VID:PID ] [ --לְהַעֲבִיר-
גודל=BYTES ]

תיאור

דף מדריך זה מתעד בקצרה את dfu-tool פקודה.

dfu-tool מאפשר למשתמש לכתוב סוגים שונים של קושחה על גבי מכשירים התומכים ב-USB
פרוטוקול שדרוג קושחת התקן. ניתן להשתמש בכלי זה כדי להחליף את המכשיר מה-
מצב זמן ריצה רגיל ל'מצב DFU' המאפשר למשתמש לקרוא ולכתוב קושחה.
או שהמכשיר כולו יכול להיכתב בפעולה אחת, או יכול להיות 'יעדים' בודדים
צוין עם השם או המספר החלופי.

dfu-tool משתמש בספרייה המשותפת libdfu לביצוע פעולות. כל הפעולות הסינכרוניות יכולות
יבוטל בבטחה ובכשל יחזיר שגיאות עם סוג וטקסט מלא
תיאור. libdfu תומך ב-DFU 1.0, DFU 1.1 והרחבת הספק ST DfuSe, וכן
מטפל ב'מוזרויות' רבות של מכשירים הנחוצות להטמעות של DFU בעולם האמיתי.

בנוסף dfu-tool יכול לשמש להמרת קושחה מפורמטים שונים, או
כדי לשנות פרטים על האלמנטים, התמונות והמטא נתונים הכלולים בקושחה
קוֹבֶץ. לדוגמה, אתה יכול בקלות להמיר קושחה של DFU 1.1 ל-DfuSe הספציפי לספק
פורמט, המר קובץ Intel HEX לקובץ גולמי מרופד לגודל מסוים, או הוסף חדש
מידע על זכויות יוצרים ורישוי לקובץ קיים. שדות כגון הספק ו
ניתן לשנות מזהי מוצר, וניתן להצפין ולפענח את רכיבי הקושחה באמצעות
שיטות שונות ומגוונות. מיזוג שני קבצי DfuSe יחד אפשרי גם כן
ציון מספרים שונים של הגדרות אלט לפני המיזוג הוא רעיון טוב כדי למנוע בלבול.

למרות dfu-tool מנסה לספק מספר רב של פקודות קלות לשימוש, ייתכן שרק
ניתן לבצע פעולות מסוימות באמצעות ספריית libdfu ישירות. זה קל יותר מאשר
זה נשמע, כשהספרייה בנויה עם תמיכת GObject Introspection מה שהופך אותה לשמישה ב
שפות רבות כגון C, Javascript ו-Python. יתר על כן, השימוש בספריה הוא טוב
רעיון אם ברצונך לבצע מספר פעולות על קבצי קושחה גדולים, למשל,
המרה מקובץ Intel HEX, ריפוד לגודל מסוים, הגדרת ספק והוספה
מידע רישוי ולאחר מכן שמירה במיקום מרוחק.

אפשרויות

תוכנית זו עוקבת אחר תחביר שורת הפקודה הרגיל של GNU, עם אפשרויות ארוכות שמתחילות ב
שני מקפים (-). סיכום האפשרויות כלול להלן.

- עזרה
הצג סיכום של כל הפקודות הזמינות לשימוש.

--גִרְסָה
הצג את הגרסה של dfu-tool מותקן.

--מִלוּלִי
הצג מידע נוסף על ניפוי באגים.

--device=VID:PID
אם מחוברים מספר התקנים בעלי יכולת DFU, תוכל לציין את הספק הספציפי
ומזהה המוצר של מכשיר ה-DFU שברצונך לבצע שאילתה.

--transfer-size=BYTES
תעקוף ידנית את הגודל של כל העברה מסוג USB, שאולי תרצה כי היא לא אמינה
חומרה או כשהמכשיר משקר לגבי גודל החבילה המרבי שהוא מקבל.

--כּוֹחַ
לאלץ את הפעולה, תוך התעלמות מאזהרות או בדיקות שפיות כמו קובץ CRC ו
סכומי בדיקה. זה שימושי אם אתה באמת יודע מה אתה עושה, או ב-
מקרה מיוחד של בדיקת fuzz libdfu.

מכשיר פקודות

פקודות אלה משמשות להתממשק עם מכשירים התומכים ב-DFU.

רשימה
פקודה זו מפרטת התקנים המצורפים כעת ל-DFU. חלק מהמכשירים לא
תומכים במצב זמן הריצה הרשמי של DFU ובכך לא תומכים בגילוי אוטומטי באמצעות
הפקודה הזו. עבור מכשירים אלה, העברת המכשיר למצב DFU באופן ידני (למשל
על ידי לחיצה ממושכת על כפתור בעת אתחול מחדש של המכשיר) יגרום לו להופיע כאן.

לנתק
פקודה זו מנתקת את ההתקן בעל יכולת ה-DFU המחובר כעת למכשיר מיוחד
מצב תכנות. בזמן שהמכשיר נמצא במצב DFU מיוחד זה, לא ניתן להשתמש בו
כמכשיר רגיל. לדוגמה, מדפסת לא תקבל מסמכים ב-DFU
מצב.

לצרף
פקודה זו מחברת התקן בעל יכולת DFU חזרה לזמן הריצה כך שניתן להשתמש בו בתור
מכשיר רגיל. חלק מהמכשירים אינם תומכים בחיבור, וצריך לעשות זאת באופן ידני
מנותק ומחובר לפני שינוי מצבים.

שעון
פקודה זו צופה בהתקני DFU בחיבור חם וניתן להשתמש בהם כדי לאמת libdfu
תואם את מצבי זמן הריצה ו-DFU בעת חיבור וניתוק. להשתמש CTRL + C ל
להפסיק את הפקודה הזו.

לקרוא שם קובץ
פקודה זו מעלה את כל הקושחה מהמכשיר לקובץ. אם יש למכשיר
מחיצות מרובות מיוצאות כחלקים חלופיים שונים ואז כולן יעשו זאת
לקרוא לקובץ בפורמט DfuSe מרובה תמונות. אם אתה רק רוצה את התוכן של אחד
מחיצה, read-alt היא הפקודה שאתה רוצה.

read-alt שם קובץ DEVICE-ALT-NAME|DEVICE-ALT-ID
פקודה זו מעלה קושחה ממחיצה אחת לקובץ. אתה יכול לציין את
מחיצה על ידי ALT-ID או ALT-NAME אם מוגדר.

לְמָשָׁל dfu-tool read-alt backup.dfu SRAM

לכתוב
פקודה זו מורידה קושחה מקובץ לכל המחיצות האפשריות של a
התקן. אם אתה רוצה לכתוב רק מחיצה אחת, כתיבה-אלט הוא הפקודה אתה
רוצה.

כתיבה-אלט שם קובץ DEVICE-ALT-NAME|DEVICE-ALT-ID [IMAGE-ALT-NAME|IMAGE-ALT-ID]
פקודה זו מורידה קושחה מהקובץ למחיצה אחת. אתה יכול לציין
המחיצה על ידי ALT-ID או ALT-NAME אם הוגדרה.

לְמָשָׁל dfu-tool כתיבה-אלט sram.dfu SRAM __SRAM

תוכנת תוכנה פקודות

פקודות אלו משמשות לקריאה ושינוי של קובצי קושחה קיימים.

שפך שם קובץ
פקודה זו שולפת את כל הפרטים הידועים על קובץ קושחה. מפת הזיכרון המלאה
מוצג, יחד עם כל מטא נתונים או מידע על הספק על קובץ הקושחה.

להמיר פורמט קובץ קובץ הוצאת קובץ [גודל]
פקודה זו ממירה את הקושחה מפורמט אחד לאחר, אופציונלי ריפוד
לגודל מסוים. ערכים אפשריים עבור היעד פורמט כוללים: raw, ihex,
dfu ו-dfuse. ה קובץ קובץ ו הוצאת קובץ הערכים יכולים להיות זהים אם קובץ המקור
יש לדרוס. למרות שהריפוד מגדיל את גודל הקובץ ללא ניכר
יתרונות זה יכול לשמש לתמיכה במכשירים שאינם מאחסנים את תמונת זמן הריצה
גודל והיכן נדרש אימות של הקושחה הכתובה.

לְמָשָׁל dfu-tool להמיר דפו firmware.hex firmware.dfu 8000

להצפין FILENAME-IN FILENAME-OUT סוג מפתח
פקודה זו מצפינה נתוני קושחה. רק תוכן התמונה הוא למעשה
שונה, הכותרת התחתונה של DFU וכותרת ה-DfuSe נותרות ללא שינוי. ערכים אפשריים עבור
היעד סוג כוללים: xtea ו-nop. אם ה מפתח אינו מהנדרש
אורך זה משמש כקלט לפונקציית hash שיכולה לייצר מפתח של
גודל נדרש.

לְמָשָׁל dfu-tool להצפין firmware.dfu firmware.xdfu xtea בשר מת

לפענח FILENAME-IN FILENAME-OUT סוג מפתח
פקודה זו מפענחת נתוני קושחה. רק תוכן התמונה הוא למעשה
שונה, הכותרת התחתונה של DFU וכותרת ה-DfuSe נותרות ללא שינוי. ערכים אפשריים עבור
היעד סוג כוללים: xtea ו-nop. אם ה מפתח אינו מהנדרש
אורך זה משמש כקלט לפונקציית hash שיכולה לייצר מפתח של
גודל נדרש.

לְמָשָׁל dfu-tool לפענח firmware.xdfu firmware.dfu xtea בשר מת

למזג הוצאת קובץ קובץ1 קובץ2 [קובץ 3...]
פקודה זו ממזגת מספר קובצי קושחה לקובץ אחד. למרות שאתה יכול למזג
קבצים עם אותו ALT-ID או ALT-NAME זה כנראה לא מה שאתה רוצה לעשות.

לְמָשָׁל dfu-tool למזג combined.dfu lib.dfu app.dfu

set-alt-setting קובץ ALT-ID
פקודה זו משנה את המספר החלופי בקובץ הקושחה.

לְמָשָׁל dfu-tool set-alt-setting firmware.dfu 1

set-alt-setting-name
פקודה זו משנה את השם החלופי בקובץ הקושחה.

לְמָשָׁל dfu-tool set-alt-setting-name firmware.dfu SRAM

set-metadata קובץ מפתח ערך
פקודה זו מוסיפה או משנה מטא נתונים קיימים בקובץ קושחה. הערה: יש
רק שטח אחסון מטא נתונים מוגבל מאוד בקבצי DFU, כך שמפתחות וערכים צריכים להיות
קצר ככל האפשר. בפרט, יש לציין את ערך הרישיון ב
פורמט SPDX.

לְמָשָׁל dfu-tool set-metadata firmware.dfu רישיון GPL-2.0+

ספק סט קובץ VID
פקודה זו מגדירה את מזהה הספק בקובץ קושחה שישמש להתאמה ספציפית
מכשירים. הערכים של ffff יתאימו לכל ספק מכשיר.

לְמָשָׁל dfu-tool ספק סט firmware.dfu 273f

סט-מוצר קובץ מח"ש
פקודה זו מגדירה את מזהה המוצר בקובץ קושחה שישמש להתאמה
מכשירים ספציפיים. הערכים של ffff יתאימו לכל מוצר מכשיר.

לְמָשָׁל dfu-tool סט-מוצר firmware.dfu 1004

סט-שחרור קובץ שחרור
פקודה זו מגדירה את גרסת השחרור בקובץ הקושחה שתשמש להתאמה
מכשירים ספציפיים. הערכים של ffff יתאימו לכל מהדורת מכשיר.

לְמָשָׁל dfu-tool סט-שחרור firmware.dfu פ פ פ פ

השתמש ב-dfu-tool מקוון באמצעות שירותי onworks.net