أداة برمجة سطر الأوامر WCHISPTool CMD
مقدمة
وظيفة البرنامج
WCHISPTool _ CMD هي أداة سطر أوامر متعددة المنصات لحرق WCH MCU عبر الإنترنت، والتي تدعم تنزيل البرامج الثابتة والتحقق والعمليات الأخرى لسلسلة MCU من WCH عبر USB أو المنفذ التسلسلي. تحتوي الأداة على مكتبة ISP وملفات sampبرامج لو للتطوير المخصص لأداة ISP.
نظام التشغيل المدعوم: Windows x86/x64، Linux x64، macOS x64/arm64.
نموذج الشريحة المدعومة: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
سطر الأوامر
تحميل
وضع كابل التوصيل:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o برنامج -f Target.hex
وضع المنفذ التسلسلي:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o برنامج -f Target.hex
يؤكد
وضع كابل التوصيل:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o تحقق -f Target.hex
وضع المنفذ التسلسلي:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o تحقق -f Target.hex
وصف المعلمة
-p |
تعليمات |
وصف المعلمات |
|
جهاز USB ISP أو عقدة الجهاز التسلسلي | /dev/ch37x /dev/ttyISPx | التنزيل عبر USB في Linux التنزيل عبر المنفذ التسلسلي في Linux | |
الموقع د كوم(/dev/tty.*) | التنزيل عبر USB في macOS التنزيل عبر المنفذ التسلسلي في macOS | ||
-b | معدل باود الاتصالات للمنفذ التسلسلي | 115200/230400/ | معدل باود الاتصالات للمنفذ التسلسلي |
-v | رقم نسخة الطباعة | التمهيد/الأداة | إصدار التمهيد/الأداة |
-c | اسم المسار الكامل للتكوين file | xxx.ini | المسار الكامل/النسبي |
-o | نوع العملية | البرنامج/التحقق | تنزيل/تحقق |
-f | اسم فلاش file | xxx. عرافة/xxx. سلة مهملات | المسار الكامل/النسبي |
ملحوظات:
- يجب أن تظهر كافة الأوامر والمعلمات في أزواج بالتنسيق "-x xxx".
- يلزم تنزيل العملية أو التحقق منها لتمرير تعليمات -p,-c,-o,-f.
- للحصول على طريقة تأكيد جهاز USB ISP أو اسم عقدة المنفذ التسلسلي المطابق للأمر – p،
رمز الحالة
وصف التعليمات | وصف المعلمات |
0 | تنفيذ بنجاح |
1 | معلمة الإدخال غير صالحة |
2 | فشل في الحصول على المعلمات من التكوين file |
3 | فشل في تعيين معلمات مزود خدمة الإنترنت |
4 | اسم المنفذ التسلسلي المحدد غير صالح |
5 | لم يتم تعداد أي جهاز |
6 | نوع الشريحة المحدد لا يتوافق مع نوع الشريحة الفعلي |
7 | فشل الحصول على معلومات الجهاز |
8 | فلاش غير صالح file طريق |
9 | فلاش غير صالح file طول |
10 | فشل في قراءة الفلاش file |
11 | فشل تحويل الفلاش file من HEX إلى تنسيق BIN |
12 | فشل في تعطيل حماية القراءة |
13 | فشل في التحميل |
14 | أخفق التحقق |
100 | خطأ غير معروف |
إعدادات file
التكوين file يتم إنشاؤه بواسطة وظيفة "Save UI Config" الخاصة بـ WchIspStudio.exe في نظام التشغيل Windows. العمليات المحددة هي كما يلي: أولاً، افتح البرنامج وحدد سلسلة MCU على الجانب الأيمن من البرنامج. بعد ذلك، حدد سلسلة وطراز الشريحة في واجهة "Chip Option" وقم بتكوين الشريحة في واجهة "Download Config". ثم اضغط على القائمة الرئيسية "File ->حفظ تكوين واجهة المستخدم". وأخيرا حدد اسم وموقع التكوين file. واجهة التشغيل هي كما يلي.
التنمية المخصصة
يحتوي دليل src الموجود في كل مجلد نظام على المصدر fileأداة نسخ سطر الأوامر، والتي يمكن تطويرها مباشرة بناءً على هذا الكود لتلبية الطلب المخصص للمستخدمين. يحتوي دليل lib على المكتبة الديناميكية لتطوير مزود خدمة الإنترنت (ISP) والرأس fileس. للحصول على الوظائف وتعليمات الاتصال، يمكن للمستخدمين الرجوع إلى WCH55XISPDLL. H ورأس آخر fileموجود في دليل lib.
منصة ويندوز
لمزيد من التفاصيل، يرجى الرجوع إلى: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html مسار التثبيت \ WCHISPTool_XXX\Doc.
منصة لينكس
تعليمات
وضع التنزيل عبر USB
- قم بتوصيل USB
تأكد من وجود MCU في وضع التنزيل BOOT، وأن PID لجهاز USB هو 0x55e0. - تثبيت برنامج تشغيل جهاز USB
افتح محطة النظام، وأدخل مجلد برنامج التشغيل، وقم بتنفيذ أمر "make install". هذه العملية مطلوبة فقط للتنزيل الأول. - تحديد اسم جهاز USB ISP
استخدم الأمر "ls" للتحقق من وجود جهاز الأحرف /dev/ch37x. - تنفيذ تعليمات التنزيل
قم بالتنفيذ وفقًا لمتطلبات تنسيق التعليمات الخاصة بالأداة، على سبيل المثالample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o برنامج -f Target.hex
وضع تنزيل المنفذ التسلسلي
- قم بتوصيل MCU بالمنفذ التسلسلي
تأكد من وجود MCU في وضع التنزيل BOOT. - إنشاء اسم جهاز ISP التسلسلي
قم بتأكيد اسم عقدة جهاز المنفذ التسلسلي، ثم استخدم الأمر "ln" لإنشاء رابط ناعم يسمى "ttyISPx" لهذا الجهاز. الأمر المحدد هو كما يلي. Sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - تنفيذ تعليمات التنزيل.
قم بالتنفيذ وفقًا لمتطلبات تنسيق التعليمات الخاصة بالأداة، على سبيل المثالample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o برنامج -f Target.hex
تشغيل السجل file
مثال عملية التنزيل الناجحة
مثيل عملية التنزيل الفاشلة
مثيل الحصول على إصدار BOOT بشكل منفصل
مثيل الحصول على إصدار البرنامج بشكل منفصل
منصة ماك
تعليمات
وضع التنزيل عبر USB
- قم بتوصيل USB
تأكد من وجود MCU في وضع التنزيل BOOT، وأن PID لجهاز USB هو 0x55e0. - حدد معرف الموقع لجهاز USB في نظام macOS. ابحث عن الجهاز في تقرير النظام ->الأجهزة ->USB. يظهر معرف الموقع في شجرة جهاز USB في الشكل التالي.
- تنفيذ تعليمات التنزيل
قم بالتنفيذ وفقًا لمتطلبات تنسيق التعليمات الخاصة بالأداة، على سبيل المثالampلو، سودو ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o برنامج -f Target.hex
وضع تنزيل المنفذ التسلسلي
- قم بتوصيل MCU بالمنفذ التسلسلي
تأكد من وجود MCU في وضع التنزيل BOOT. - حدد اسم عقدة المنفذ التسلسلي على الجهاز، وقم بتشغيل الأمر "ls /dev/tty.*" على
محطة للتحقق من المنفذ التسلسلي على نظام التشغيل macOS (إذا تم استخدام شريحة المنفذ التسلسلي WCH، فقم بتثبيت برنامج CH34xVCPDriver لنظام التشغيل macOS). يتم عرض عملية محددة في الشكل أدناه.
- تنفيذ تعليمات التنزيل
قم بالتنفيذ وفقًا لمتطلبات تنسيق التعليمات الخاصة بالأداة، على سبيل المثالample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o برنامج -f Target.hex
تشغيل السجل file
مثال عملية التنزيل الناجحة
مثيل عملية التنزيل الفاشلة
مثيل الحصول على إصدار BOOT بشكل منفصل
مثيل الحصول على إصدار البرنامج بشكل منفصل
المستندات / الموارد
![]() |
WCH WCHISPTool CMD أداة برمجة سطر الأوامر [بي دي اف] تعليمات WCHISPTool CMD أداة برمجة سطر الأوامر، WCHISPTool، أداة برمجة سطر الأوامر CMD، أداة برمجة سطر الأوامر، أداة برمجة الخط، أداة البرمجة |