ابزار برنامه نویسی خط فرمان 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/ CH32Vx03 x
خط فرمان
دانلود کنید
حالت USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
حالت پورت سریال:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
تأیید کنید
حالت USB:
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 |
دستورالعمل |
توضیحات پارامترها |
|
دستگاه ISP USB یا گره دستگاه سریال | /dev/ch37x /dev/ttyISPx | دانلود از طریق USB در لینوکس دانلود از طریق پورت سریال در لینوکس | |
LocationlD COM(/dev/tty.*) | دانلود از طریق USB در macOS دانلود از طریق پورت سریال در macOS | ||
-b | نرخ باود ارتباطی پورت سریال | 115200/230400/ | نرخ باود ارتباطی پورت سریال |
-v | چاپ شماره نسخه | بوت/ابزار | نسخه بوت/ابزار |
-c | نام مسیر کامل پیکربندی file | xxx.ini | مسیر کامل/نسبی |
-o | نوع عملیات | برنامه/تأیید | دانلود/تأیید |
-f | نام فلش file | xxx هگز/xxx. صندوقچه | مسیر کامل/نسبی |
یادداشت ها:
- تمام دستورات و پارامترها باید به صورت جفت در قالب "-x xxx" ظاهر شوند.
- برای ارسال دستورالعمل های -p,-c,-o,-f عملیات دانلود یا تأیید مورد نیاز است.
- برای روش تأیید دستگاه ISP USB یا نام گره پورت سریال مربوط به دستور – p،
کد وضعیت
توضیحات دستورالعمل | توضیحات پارامترها |
0 | با موفقیت اجرا شود |
1 | پارامتر ورودی نامعتبر است |
2 | دریافت پارامترها از پیکربندی انجام نشد file |
3 | تنظیم پارامترهای ISP انجام نشد |
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 در ویندوز ایجاد می شود. عملیات خاص به شرح زیر است: ابتدا نرم افزار را باز کرده و سری MCU را در سمت راست نرم افزار انتخاب کنید. سپس سری و مدل تراشه را در رابط «Chip Option» انتخاب کنید و تراشه را در رابط «Download Config» پیکربندی کنید. سپس روی منوی اصلی کلیک کنیدFile -> Save UI Config. در نهایت نام و محل پیکربندی را انتخاب کنید file. رابط عملیات به شرح زیر است.
توسعه سفارشی
دایرکتوری src در هر پوشه سیستم حاوی منبع است files از ابزار سوزاندن خط فرمان، که می تواند به طور مستقیم بر اساس این کد توسعه یابد تا تقاضای سفارشی کاربران را برآورده کند. دایرکتوری lib شامل کتابخانه پویا و هدر توسعه ISP است fileس برای عملکردها و دستورالعمل های تماس، کاربران می توانند به WCH55XISPDLL مراجعه کنند. H و هدر دیگر files در دایرکتوری lib.
بستر ویندوز
برای جزئیات لطفا به آدرس زیر مراجعه کنید: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html مسیر نصب \ WCHISPTool_XXX\Doc.
پلتفرم لینوکس
دستورالعمل
حالت دانلود USB
- USB را وصل کنید
مطمئن شوید که MCU در حالت دانلود BOOT است و PID دستگاه USB 0x55e0 است. - درایور دستگاه USB را نصب کنید
ترمینال سیستم را باز کنید، وارد پوشه درایور شوید و دستور make install را اجرا کنید. این عملیات فقط برای اولین بارگیری لازم است. - نام دستگاه ISP USB را تعیین کنید
از دستور "ls" برای بررسی وجود دستگاه کاراکتر /dev/ch37x استفاده کنید. - اجرای دستور دانلود
مطابق با الزامات قالب دستورالعمل ابزار، برای مثال، اجرا کنیدample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -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 program -f Target.hex
اجرای گزارش file
نمونه عملیات دانلود موفقیت آمیز
نمونه عملیات دانلود ناموفق
نمونه دریافت نسخه BOOT به طور جداگانه
نمونه گرفتن نسخه نرم افزار به صورت جداگانه
پلتفرم macOS
دستورالعمل
حالت دانلود USB
- USB را وصل کنید
مطمئن شوید که MCU در حالت دانلود BOOT است و PID دستگاه USB 0x55e0 است. - شناسه مکان دستگاه USB را در سیستم macOS تعیین کنید. دستگاه را در System Report ->Hardware ->USB پیدا کنید. شناسه مکان در درخت دستگاه USB در شکل زیر نشان داده شده است.
- اجرای دستور دانلود
مطابق با الزامات قالب دستورالعمل ابزار، برای مثال، اجرا کنیدample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o program -f Target.hex
حالت دانلود پورت سریال
- MCU را با پورت سریال وصل کنید
مطمئن شوید که MCU در حالت دانلود BOOT است. - نام گره پورت سریال دستگاه را تعیین کنید و دستور "ls /dev/tty.*" را روی دستگاه اجرا کنید.
ترمینال برای بررسی پورت سریال در macOS (اگر از تراشه پورت سریال WCH استفاده می شود، درایور CH34xVCPD macOS را نصب کنید). یک عملیات خاص در شکل زیر نشان داده شده است.
- اجرای دستور دانلود
مطابق با الزامات قالب دستورالعمل ابزار، برای مثال، اجرا کنیدample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex
اجرای گزارش file
نمونه عملیات دانلود موفقیت آمیز
نمونه عملیات دانلود ناموفق
نمونه دریافت نسخه BOOT به طور جداگانه
نمونه گرفتن نسخه نرم افزار به صورت جداگانه
اسناد / منابع
![]() |
ابزار برنامه نویسی خط فرمان WCH WCHISPTool CMD [pdfدستورالعملها WCHISPTool CMD Command Line Programming Tool, WCHISPTool, CMD Command Line Programming Tool, Command Line Programming Tool, Line Programming Tool, Programming Tool |