هذه هي أداة dfu للأوامر التي يمكن تشغيلها في مزود الاستضافة المجانية OnWorks باستخدام إحدى محطات العمل المجانية المتعددة على الإنترنت مثل Ubuntu Online أو Fedora Online أو محاكي Windows عبر الإنترنت أو محاكي MAC OS عبر الإنترنت
برنامج:
اسم
dfu-tool - أداة ترقية البرامج الثابتة للجهاز
موجز
أداة dfu [ - الإسراف ] [ --الإصدار ] [ --فرض ] [ - الجهاز = VID: PID ] [ --تحويل-
الحجم = بايت ]
الوصف
توثق صفحة الدليل هذه بإيجاز ملف أداة dfu أمر.
أداة dfu يسمح للمستخدم بكتابة أنواع مختلفة من البرامج الثابتة على الأجهزة التي تدعم USB
بروتوكول ترقية البرامج الثابتة للجهاز. يمكن استخدام هذه الأداة لتبديل الجهاز من ملف
وضع وقت التشغيل العادي إلى "وضع DFU" الذي يسمح للمستخدم بقراءة البرامج الثابتة وكتابتها.
يمكن كتابة الجهاز بأكمله في عملية واحدة ، أو يمكن كتابة "أهداف" فردية
المحدد بالاسم البديل أو الرقم.
أداة dfu يستخدم مكتبة libdfu المشتركة لأداء الإجراءات. يمكن لجميع الإجراءات المتزامنة
يتم إلغاؤها بأمان وعند الفشل ستُرجع أخطاء بنوعها ونصها الكامل
وصف. libdfu يدعم DFU 1.0 و DFU 1.1 وامتداد البائع ST DfuSe و
يتعامل مع العديد من "المراوغات" الخاصة بالأجهزة اللازمة لتطبيقات العالم الحقيقي لـ DFU.
وبالإضافة إلى ذلك أداة dfu يمكن استخدامها لتحويل البرامج الثابتة من تنسيقات مختلفة مختلفة ، أو
لتعديل التفاصيل حول العناصر والصور والبيانات الوصفية الموجودة داخل البرنامج الثابت
ملف. على سبيل المثال ، يمكنك بسهولة تحويل البرامج الثابتة DFU 1.1 إلى DfuSe الخاص بالبائع
تنسيق ، قم بتحويل ملف Intel HEX إلى ملف خام مبطن بحجم معين ، أو إضافة ملف جديد
معلومات حقوق النشر والترخيص لملف موجود. الحقول مثل البائع و
يمكن تغيير معرفات المنتج ، ويمكن تشفير عناصر البرنامج الثابت وفك تشفيرها باستخدام
طرق مختلفة ومختلفة. من الممكن أيضًا دمج ملفين DfuSe معًا ، بالرغم من ذلك
يُعد تحديد أرقام إعدادات بديلة مختلفة قبل الدمج فكرة جيدة لتجنب الالتباس.
بالرغم ان أداة dfu يحاول توفير عدد كبير من الأوامر سهلة الاستخدام ، فقد يكون كذلك
من الممكن القيام بعمليات معينة باستخدام مكتبة libdfu مباشرة. هذا أسهل من
يبدو أن المكتبة مبنية بدعم GObject Introspection مما يجعلها قابلة للاستخدام فيها
العديد من اللغات مثل C و Javascript و Python. علاوة على ذلك ، فإن استخدام المكتبة أمر جيد
فكرة إذا كنت تريد إجراء عمليات متعددة على ملفات البرامج الثابتة الكبيرة ، على سبيل المثال ،
التحويل من ملف Intel HEX ، والحشو إلى حجم معين ، وإعداد البائع والإضافة
معلومات الترخيص ثم الحفظ في مكان بعيد.
OPTIONS
هذا البرنامج يتبع الصيغة المعتادة لسطر أوامر جنو ، مع خيارات طويلة تبدأ بـ
شرطان (-). يتم تضمين ملخص من الخيارات أدناه.
--مساعدة
عرض ملخص لجميع الأوامر المتاحة للاستخدام.
--الإصدار
إظهار إصدار أداة dfu تثبيت.
- الإسراف
إظهار معلومات تصحيح الأخطاء الإضافية.
- الجهاز = VID: PID
إذا تم توصيل عدة أجهزة قادرة على DFU ، يمكنك تحديد البائع المحدد
ومعرف المنتج لجهاز DFU الذي تريد الاستعلام عنه.
- حجم النقل = بايت
تجاوز حجم كل نقل USB يدويًا ، وهو ما قد ترغب فيه لعدم الاعتماد عليه
الأجهزة أو عندما يقع الجهاز حول الحد الأقصى لحجم الحزمة الذي يقبله.
--فرض
فرض العملية ، وتجاهل التحذيرات أو فحوصات السلامة مثل ملف CRC و
اختباري. هذا مفيد إذا كنت تعرف حقًا ما تفعله ، أو في
حالة متخصصة لاختبار الزغب libdfu.
DEVICE أوامر
تُستخدم هذه الأوامر للتفاعل مع الأجهزة التي تدعم DFU.
قائمة
يسرد هذا الأمر الأجهزة المرفقة التي تدعم DFU. بعض الأجهزة لا تفعل ذلك
دعم وضع وقت تشغيل DFU الرسمي وبالتالي لا تدعم الاكتشاف التلقائي باستخدام
هذا الأمر. بالنسبة لتلك الأجهزة ، ضع الجهاز في وضع DFU يدويًا (على سبيل المثال
بالضغط على زر لأسفل عند إعادة تشغيل الجهاز) سيجعله يظهر هنا.
فصل
يفصل هذا الأمر الجهاز القادر على DFU المرفق حاليًا في ملف
وضع البرمجة. عندما يكون الجهاز في وضع DFU الخاص هذا ، لا يمكن استخدامه
كجهاز عادي. على سبيل المثال ، لن تقبل الطابعة المستندات عندما تكون في DFU
واسطة.
يرفق
يقوم هذا الأمر بإرفاق جهاز قادر على DFU مرة أخرى بوقت التشغيل بحيث يمكن استخدامه كملف
جهاز عادي. بعض الأجهزة لا تدعم التوصيل ، ويجب أن تكون يدويًا
غير متصل ومتصل قبل تغيير الأوضاع.
راقب
يراقب هذا الأمر أجهزة DFU التي يتم توصيلها سريعًا ويمكن استخدامها للتحقق من libdfu
يطابق وقت التشغيل وأوضاع DFU عند التوصيل والفصل. يستخدم CTRL + C إلى
اجعل هذا الأمر يستقيل.
اقرأ اسم الملف
يقوم هذا الأمر بتحميل جميع البرامج الثابتة من الجهاز إلى ملف. إذا كان الجهاز يحتوي على
يتم تصدير أقسام متعددة كأقسام بديلة مختلفة ، فسيقومون جميعًا بذلك
يمكن قراءتها في ملف بتنسيق DfuSe متعدد الصور. إذا كنت تريد فقط محتويات واحد
تقسيم، قراءة- بديل هو الأمر الذي تريده.
قراءة- بديل اسم الملف DEVICE-ALT-NAME | DEVICE-ALT-ID
يقوم هذا الأمر بتحميل البرامج الثابتة من قسم إلى ملف. يمكنك تحديد
التقسيم إما عن طريق ALT-ID أو ALT-NAME إذا تم تعيينه.
على سبيل المثال أداة dfu قراءة- بديل ملف النسخ الاحتياطي SRAM
اكتب
يقوم هذا الأمر بتنزيل البرامج الثابتة من ملف إلى جميع الأقسام الممكنة من ملف
جهاز. إذا كنت تريد كتابة قسم واحد فقط ، اكتب بديل هو الأمر لك
تريد.
اكتب بديل اسم الملف DEVICE-ALT-NAME | DEVICE-ALT-ID [IMAGE-ALT-NAME | IMAGE-ALT-ID]
يقوم هذا الأمر بتنزيل البرامج الثابتة من الملف إلى قسم واحد. يمكنك تحديد
القسم إما عن طريق ALT-ID أو ALT-NAME إذا تم تعيينه.
على سبيل المثال أداة dfu اكتب بديل sram.dfu SRAM __SRAM
البرامج الثابتة أوامر
تُستخدم هذه الأوامر لقراءة ملفات البرامج الثابتة الموجودة وتعديلها.
تفريغ اسم الملف
يقوم هذا الأمر بتفريغ جميع التفاصيل المعروفة حول ملف البرنامج الثابت. خريطة الذاكرة الكاملة
يتم عرضه ، إلى جانب أي بيانات وصفية أو معلومات عن البائع حول ملف البرنامج الثابت.
تحول FORMAT إملأ ملف [بحجم]
يحول هذا الأمر البرنامج الثابت من تنسيق إلى آخر ، اختياريا الحشو
بحجم معين. القيم الممكنة للوجهة FORMAT تشمل: خام ، ihex ،
dfu و dfuse. ال إملأ و ملف يمكن أن تكون القيم هي نفسها إذا كان الملف المصدر
يتم الكتابة فوقه. على الرغم من أن الحشو يزيد من حجم الملف مع عدم وجود ظاهرة
مزايا يمكن استخدامه لدعم الأجهزة التي لا تخزن صورة وقت التشغيل
الحجم وحيث يلزم التحقق من صحة البرامج الثابتة المكتوبة.
على سبيل المثال أداة dfu تحول DFU البرامج الثابتة البرامج الثابتة.dfu 8000
تشفير اسم الملف اسم الملف-خارج النوع KEY
يقوم هذا الأمر بتشفير بيانات البرامج الثابتة. فقط محتويات الصورة هي في الواقع
تم تعديله ، يتم ترك تذييل DFU ورأس DfuSe دون تغيير. القيم الممكنة لـ
الوجهة النوع تشمل: xtea و nop. إذا كان KEY ليس من المطلوب
length يتم استخدامه كمدخل لوظيفة التجزئة التي يمكن أن تنتج مفتاح
الحجم المطلوب.
على سبيل المثال أداة dfu تشفير البرامج الثابتة.dfu البرامج الثابتة.xdfu com.xtea لحم البقر الميت
فك تشفير اسم الملف اسم الملف-خارج النوع KEY
يقوم هذا الأمر بفك تشفير بيانات البرامج الثابتة. فقط محتويات الصورة هي في الواقع
تم تعديله ، يتم ترك تذييل DFU ورأس DfuSe دون تغيير. القيم الممكنة لـ
الوجهة النوع تشمل: xtea و nop. إذا كان KEY ليس من المطلوب
length يتم استخدامه كمدخل لوظيفة التجزئة التي يمكن أن تنتج مفتاح
الحجم المطلوب.
على سبيل المثال أداة dfu فك تشفير البرامج الثابتة.xdfu البرامج الثابتة.dfu com.xtea لحم البقر الميت
دمج ملف FILE1 FILE2 [FILE3 ...]
يدمج هذا الأمر العديد من ملفات البرامج الثابتة في ملف واحد. على الرغم من أنه يمكنك الدمج
مع نفس ALT-ID أو ALT-NAME ، ربما لا يكون هذا ما تريد القيام به.
على سبيل المثال أداة dfu دمج مجتمعة. dfu lib.dfu app.dfu
ضبط بديل FILE معرف البديل
يقوم هذا الأمر بتعديل الرقم البديل في ملف البرنامج الثابت.
على سبيل المثال أداة dfu ضبط بديل البرامج الثابتة.dfu 1
تعيين اسم بديل الإعداد
يقوم هذا الأمر بتعديل الاسم البديل في ملف البرنامج الثابت.
على سبيل المثال أداة dfu تعيين اسم بديل الإعداد البرامج الثابتة.dfu SRAM
مجموعة البيانات الوصفية FILE KEY VALUE
يقوم هذا الأمر بإضافة أو تعديل البيانات الأولية الموجودة في ملف البرنامج الثابت. ملاحظة: هناك
مساحة تخزين البيانات الوصفية محدودة للغاية في ملفات DFU ، لذلك يجب أن تكون المفاتيح والقيم
أبقى قصيرة قدر الإمكان. على وجه الخصوص ، يجب تحديد قيمة الترخيص في
تنسيق SPDX.
على سبيل المثال أداة dfu مجموعة البيانات الوصفية البرامج الثابتة.dfu رخصة GPL-2.0 +
مجموعة البائع FILE VID
يقوم هذا الأمر بتعيين معرف البائع في ملف البرنامج الثابت الذي سيتم استخدامه لمطابقة محددة
الأجهزة. تتطابق قيم ffff مع أي بائع أجهزة.
على سبيل المثال أداة dfu مجموعة البائع البرامج الثابتة.dfu 273f
مجموعة المنتج FILE PID
يقوم هذا الأمر بتعيين معرف المنتج في ملف البرنامج الثابت الذي سيتم استخدامه للمطابقة
أجهزة محددة. تتطابق قيم ffff مع أي منتج للجهاز.
على سبيل المثال أداة dfu مجموعة المنتج البرامج الثابتة.dfu 1004
مجموعة الافراج FILE RELEASE
يقوم هذا الأمر بتعيين إصدار الإصدار في ملف البرنامج الثابت الذي سيتم استخدامه للمطابقة
أجهزة محددة. تتطابق قيم ffff مع أي إصدار للجهاز.
على سبيل المثال أداة dfu مجموعة الافراج البرامج الثابتة.dfu FFFF
استخدم أداة dfu عبر الإنترنت باستخدام خدمات onworks.net
