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.
บรรทัดคำสั่ง
ดาวน์โหลด
โหมด 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
ตรวจสอบ
โหมด 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 ใน Linux ดาวน์โหลดผ่านพอร์ตอนุกรมใน Linux | |
| สถานที่ตั้ง COM(/dev/tty.*) | ดาวน์โหลดผ่าน USB ใน macOS ดาวน์โหลดผ่านพอร์ตอนุกรมใน macOS | ||
| -b | อัตรารับส่งข้อมูลการสื่อสารของพอร์ตอนุกรม | 115200/230400/ | อัตรารับส่งข้อมูลการสื่อสารของพอร์ตอนุกรม |
| -v | พิมพ์หมายเลขรุ่น | บูต / เครื่องมือ | เวอร์ชันการบูต/เครื่องมือ |
| -c | ชื่อพาธแบบเต็มของการกำหนดค่า file | xxx.อินี่ | เส้นทางเต็ม/สัมพันธ์ |
| -o | ประเภทของการดำเนินการ | โปรแกรม/ตรวจสอบ | ดาวน์โหลด/ยืนยัน |
| -f | ชื่อแฟลช file | xxx. ฐานสิบหก/xxx ถังขยะ | เส้นทางเต็ม/สัมพันธ์ |
หมายเหตุ:
- คำสั่งและพารามิเตอร์ทั้งหมดจะต้องปรากฏเป็นคู่ในรูปแบบ “-x xxx”
- จำเป็นต้องดาวน์โหลดหรือตรวจสอบการดำเนินการเพื่อส่งผ่านคำแนะนำ -p,-c,-o,-f
- สำหรับวิธีการยืนยันอุปกรณ์ USB ISP หรือชื่อโหนดพอร์ตอนุกรมที่สอดคล้องกับคำสั่ง – p
รหัสสถานะ
| คำอธิบายคำสั่ง | คำอธิบายพารามิเตอร์ |
| 0 | ดำเนินการให้สำเร็จ |
| 1 | พารามิเตอร์อินพุตไม่ถูกต้อง |
| 2 | ไม่สามารถรับพารามิเตอร์จากการกำหนดค่าได้ file |
| 3 | ไม่สามารถตั้งค่าพารามิเตอร์ ISP |
| 4 | ชื่อพอร์ตอนุกรมที่ระบุไม่ถูกต้อง |
| 5 | ไม่มีการระบุอุปกรณ์ |
| 6 | ประเภทชิปที่ระบุไม่สอดคล้องกับประเภทชิปจริง |
| 7 | ไม่สามารถรับข้อมูลอุปกรณ์ได้ |
| 8 | แฟลชไม่ถูกต้อง file เส้นทาง |
| 9 | แฟลชไม่ถูกต้อง file ความยาว |
| 10 | ไม่สามารถอ่านแฟลชได้ file |
| 11 | ไม่สามารถแปลง Flash file จากรูปแบบ HEX เป็นรูปแบบ BIN |
| 12 | ไม่สามารถปิดใช้งานการป้องกันการอ่าน |
| 13 | ดาวน์โหลดไม่สำเร็จ |
| 14 | ล้มเหลวในการตรวจสอบ |
| 100 | ข้อผิดพลาดที่ไม่รู้จัก |
การกำหนดค่า file
การกำหนดค่า file สร้างขึ้นโดยฟังก์ชัน "บันทึก UI Config" ของ WchIspStudio.exe ใน Windows การดำเนินการเฉพาะมีดังนี้: ขั้นแรก ให้เปิดซอฟต์แวร์และเลือกซีรีส์ MCU ที่ด้านขวาของซอฟต์แวร์ จากนั้นเลือกซีรีส์และรุ่นของชิปในอินเทอร์เฟซของ "Chip Option" และกำหนดค่าชิปในอินเทอร์เฟซของ "Download Config" จากนั้นคลิกเมนูหลัก “File -> บันทึกการกำหนดค่า UI” สุดท้ายเลือกชื่อและตำแหน่งของการกำหนดค่า file- อินเทอร์เฟซการทำงานมีดังนี้
การพัฒนาที่กำหนดเอง
ไดเร็กทอรี src ในแต่ละโฟลเดอร์ระบบมีแหล่งที่มา fileของเครื่องมือเบิร์นบรรทัดคำสั่งซึ่งสามารถพัฒนาได้โดยตรงโดยใช้โค้ดนี้เพื่อตอบสนองความต้องการที่กำหนดเองของผู้ใช้ ไดเร็กทอรี lib ประกอบด้วยไลบรารีไดนามิกและส่วนหัวสำหรับการพัฒนา ISP fileส. สำหรับฟังก์ชันและคำแนะนำการโทร ผู้ใช้สามารถอ้างอิงถึง WCH55XISPDLL H และส่วนหัวอื่น ๆ fileอยู่ในไดเร็กทอรี lib
แพลตฟอร์ม Windows
สำหรับรายละเอียด โปรดดูที่: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html เส้นทางการติดตั้ง \ WCHISPTool_XXX\Doc
แพลตฟอร์มลินุกซ์
คำแนะนำ
โหมดดาวน์โหลด USB
- เสียบยูเอสบี
ตรวจสอบให้แน่ใจว่า MCU อยู่ในโหมดดาวน์โหลด BOOT และ PID ของอุปกรณ์ USB คือ 0x55e0 - ติดตั้งไดรเวอร์อุปกรณ์ USB
เปิดเทอร์มินัลระบบ เข้าสู่โฟลเดอร์ไดรเวอร์ และดำเนินการคำสั่ง "make install" การดำเนินการนี้จำเป็นสำหรับการดาวน์โหลดครั้งแรกเท่านั้น - กำหนดชื่ออุปกรณ์ USB ISP
ใช้คำสั่ง “ls” เพื่อตรวจสอบว่ามีอุปกรณ์อักขระ /dev/ch37x อยู่หรือไม่ - ดำเนินการตามคำแนะนำการดาวน์โหลด
ดำเนินการตามข้อกำหนดรูปแบบคำสั่งของเครื่องมือ เช่นampเลอ 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 - ดำเนินการตามคำแนะนำการดาวน์โหลด
ดำเนินการตามข้อกำหนดรูปแบบคำสั่งของเครื่องมือ เช่นampเลอ sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o โปรแกรม -f Target.hex
บันทึกการเรียกใช้ file
ตัวอย่างของการดำเนินการดาวน์โหลดที่สำเร็จ
อินสแตนซ์ของการดำเนินการดาวน์โหลดที่ล้มเหลว
อินสแตนซ์ของการรับเวอร์ชัน BOOT แยกกัน
ตัวอย่างการรับเวอร์ชันซอฟต์แวร์แยกกัน
แพลตฟอร์ม macOS
คำแนะนำ
โหมดดาวน์โหลด USB
- เสียบยูเอสบี
ตรวจสอบให้แน่ใจว่า MCU อยู่ในโหมดดาวน์โหลด BOOT และ PID ของอุปกรณ์ USB คือ 0x55e0 - กำหนด ID ตำแหน่งของอุปกรณ์ USB ในระบบ macOS ค้นหาอุปกรณ์ในรายงานระบบ -> ฮาร์ดแวร์ -> USB ID ตำแหน่งในแผนผังอุปกรณ์ USB จะแสดงในรูปต่อไปนี้
- ดำเนินการตามคำแนะนำการดาวน์โหลด
ดำเนินการตามข้อกำหนดรูปแบบคำสั่งของเครื่องมือ เช่นampเลอ, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o โปรแกรม -f Target.hex
โหมดดาวน์โหลดพอร์ตอนุกรม
- เชื่อมต่อ MCU กับพอร์ตอนุกรม
ตรวจสอบให้แน่ใจว่า MCU อยู่ในโหมดดาวน์โหลด BOOT - กำหนดชื่อโหนดของพอร์ตอนุกรมบนอุปกรณ์ และเรียกใช้คำสั่ง “ls /dev/tty.*” บน
เทอร์มินัลเพื่อตรวจสอบพอร์ตอนุกรมบน macOS (หากใช้ชิปพอร์ตอนุกรม WCH ให้ติดตั้ง CH34xVCPDriver ของ macOS) การดำเนินการเฉพาะแสดงในรูปด้านล่าง
- ดำเนินการตามคำแนะนำการดาวน์โหลด
ดำเนินการตามข้อกำหนดรูปแบบคำสั่งของเครื่องมือ เช่นampเลอ sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o โปรแกรม -f Target.hex
บันทึกการเรียกใช้ file
ตัวอย่างของการดำเนินการดาวน์โหลดที่สำเร็จ
อินสแตนซ์ของการดำเนินการดาวน์โหลดที่ล้มเหลว
อินสแตนซ์ของการรับเวอร์ชัน BOOT แยกกัน
ตัวอย่างการรับเวอร์ชันซอฟต์แวร์แยกกัน
เอกสาร / แหล่งข้อมูล
 |
WCH WCHISPTool เครื่องมือการเขียนโปรแกรมบรรทัดคำสั่ง CMD [พีดีเอฟ] คำแนะนำ WCHISPTool เครื่องมือการเขียนโปรแกรมบรรทัดคำสั่ง CMD, WCHISPTool, เครื่องมือการเขียนโปรแกรมบรรทัดคำสั่ง CMD, เครื่องมือการเขียนโปรแกรมบรรทัดคำสั่ง, เครื่องมือการเขียนโปรแกรมบรรทัด, เครื่องมือการเขียนโปรแกรม |
