Công cụ lập trình dòng lệnh WCHISPTool CMD
Giới thiệu
Chức năng phần mềm
WCHISPTool _ CMD là công cụ dòng lệnh đa nền tảng để ghi WCH MCU trực tuyến, hỗ trợ tải xuống firmware, xác minh và các hoạt động khác cho loạt MCU của WCH thông qua USB hoặc cổng nối tiếp. Công cụ này chứa thư viện ISP vàampcác chương trình để phát triển tùy chỉnh công cụ ISP.
Hệ điều hành được hỗ trợ: Windows x86/x64, Linux x64, macOS x64/arm64.
Model chip được hỗ trợ: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
Dòng lệnh
Tải về
Chế độ usb:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o chương trình -f Target.hex
Chế độ cổng nối tiếp:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o chương trình -f Target.hex
Xác minh
Chế độ usb:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o verify -f Target.hex
Chế độ cổng nối tiếp:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o verify -f Target.hex
Mô tả về Thông Số
| -p |
Chỉ dẫn |
Mô tả thông số |
|
| Thiết bị USB ISP hoặc nút thiết bị nối tiếp | /dev/ch37x /dev/ttyISPx | Tải xuống qua USB trong Linux Tải xuống qua cổng nối tiếp trong Linux | |
| Vị trílD COM(/dev/tty.*) | Tải xuống qua USB trong macOS Tải xuống qua cổng nối tiếp trong macOS | ||
| -b | Tốc độ truyền thông của cổng nối tiếp | 115200/230400/ | Tốc độ truyền thông của cổng nối tiếp |
| -v | Số phiên bản in | khởi động/công cụ | Phiên bản khởi động/công cụ |
| -c | Tên đường dẫn đầy đủ của cấu hình file | xxx.ini | Đường dẫn đầy đủ/tương đối |
| -o | Loại hoạt động | chương trình/xác minh | Tải xuống/Xác minh |
| -f | Tên của Flash file | xxx. hex/xxx. thùng rác | Đường dẫn đầy đủ/tương đối |
Ghi chú:
- Tất cả các lệnh và tham số phải xuất hiện theo cặp ở định dạng “-x xxx”.
- Cần phải tải xuống hoặc xác minh thao tác để chuyển các hướng dẫn -p,-c,-o,-f.
- Đối với phương thức xác nhận của thiết bị USB ISP hoặc tên nút cổng nối tiếp tương ứng với lệnh – p,
Mã trạng thái
| Mô tả hướng dẫn | Mô tả thông số |
| 0 | Thực hiện thành công |
| 1 | Tham số đầu vào không hợp lệ |
| 2 | Không thể lấy tham số từ cấu hình file |
| 3 | Không thể đặt tham số ISP |
| 4 | Tên cổng nối tiếp được chỉ định không hợp lệ |
| 5 | Không có thiết bị nào được liệt kê |
| 6 | Loại chip được chỉ định không phù hợp với loại chip thực tế |
| 7 | Không lấy được thông tin thiết bị |
| 8 | Flash không hợp lệ file con đường |
| 9 | Flash không hợp lệ file chiều dài |
| 10 | Không đọc được Flash file |
| 11 | Không thể chuyển đổi Flash file từ định dạng HEX sang BIN |
| 12 | Không thể tắt chức năng bảo vệ đọc |
| 13 | Không thể tải xuống |
| 14 | Không thể xác minh |
| 100 | Lỗi không thể nhận biết |
Cấu hình file
Cấu hình file được tạo bởi chức năng “Save UI Config” của WchIspStudio.exe trong Windows. Các thao tác cụ thể như sau: Đầu tiên các bạn mở phần mềm lên và chọn dòng MCU ở phía bên phải phần mềm. Tiếp theo, chọn dòng và model chip trong giao diện “Chip Option” và cấu hình chip trong giao diện “Tải xuống cấu hình”. Sau đó nhấp vào menu chính “File ->Lưu cấu hình giao diện người dùng”. Cuối cùng chọn tên và vị trí cấu hình file. Giao diện hoạt động như sau.
Phát triển phong tục
Thư mục src trong mỗi thư mục hệ thống chứa nguồn files của công cụ ghi dòng lệnh, có thể được phát triển trực tiếp dựa trên mã này để đáp ứng nhu cầu tùy chỉnh của người dùng. Thư mục lib chứa thư viện động phát triển ISP và tiêu đề fileS. Để biết các chức năng và hướng dẫn gọi, người dùng có thể tham khảo WCH55XISPDLL. H và tiêu đề khác files trong thư mục lib.
Nền tảng Windows
Chi tiết vui lòng tham khảo: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html đường dẫn cài đặt\WCHISPTool_XXX\Doc.
Nền tảng Linux
Chỉ dẫn
Chế độ tải xuống USB
- Cắm USB
Đảm bảo MCU ở chế độ tải xuống BOOT và PID của thiết bị USB là 0x55e0. - Cài đặt trình điều khiển thiết bị USB
Mở thiết bị đầu cuối hệ thống, nhập thư mục trình điều khiển và thực hiện lệnh “make install”. Thao tác này chỉ được yêu cầu cho lần tải xuống đầu tiên. - Xác định tên thiết bị USB ISP
Sử dụng lệnh “ls” để kiểm tra xem thiết bị ký tự /dev/ch37x có tồn tại hay không. - Thực hiện hướng dẫn tải xuống
Thực hiện theo yêu cầu định dạng hướng dẫn của công cụ, ví dụ:ample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o chương trình -f Target.hex
Chế độ tải xuống cổng nối tiếp
- Kết nối MCU với cổng nối tiếp
Đảm bảo MCU ở chế độ tải xuống BOOT. - Tạo tên thiết bị ISP nối tiếp
Xác nhận tên nút thiết bị cổng nối tiếp, sau đó sử dụng lệnh “ln” để tạo liên kết mềm có tên “ttyISPx” cho thiết bị này. Lệnh cụ thể như sau. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Thực hiện hướng dẫn tải xuống.
Thực hiện theo yêu cầu định dạng hướng dẫn của công cụ, ví dụ:ample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o chương trình -f Target.hex
Chạy nhật ký file
Trường hợp thao tác tải xuống thành công
Trường hợp thao tác tải xuống không thành công
Trường hợp lấy riêng phiên bản BOOT
Trường hợp lấy riêng phiên bản phần mềm
Nền tảng macOS
Chỉ dẫn
Chế độ tải xuống USB
- Cắm USB
Đảm bảo MCU ở chế độ tải xuống BOOT và PID của thiết bị USB là 0x55e0. - Xác định ID vị trí của thiết bị USB trong hệ thống macOS. Tìm thiết bị trong Báo cáo hệ thống ->Phần cứng ->USB. ID vị trí trong cây thiết bị USB được hiển thị trong hình dưới đây.
- Thực hiện hướng dẫn tải xuống
Thực hiện theo yêu cầu định dạng hướng dẫn của công cụ, ví dụ:amptập tin, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o chương trình -f Target.hex
Chế độ tải xuống cổng nối tiếp
- Kết nối MCU với cổng nối tiếp
Đảm bảo MCU ở chế độ tải xuống BOOT. - Xác định tên nút của cổng nối tiếp trên thiết bị và chạy lệnh “ls /dev/tty.*” trên
terminal để kiểm tra cổng nối tiếp trên macOS (Nếu sử dụng chip cổng nối tiếp WCH, hãy cài đặt CH34xVCPDriver của macOS). Một hoạt động cụ thể được hiển thị trong hình dưới đây.
- Thực hiện hướng dẫn tải xuống
Thực hiện theo yêu cầu định dạng hướng dẫn của công cụ, ví dụ:ample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o chương trình -f Target.hex
Chạy nhật ký file
Trường hợp thao tác tải xuống thành công
Trường hợp thao tác tải xuống không thành công
Trường hợp lấy riêng phiên bản BOOT
Trường hợp lấy riêng phiên bản phần mềm
Tài liệu / Tài nguyên
 |
Công cụ lập trình dòng lệnh WCH WCHISPTool CMD [tập tin pdf] Hướng dẫn WCHISPTool Công cụ lập trình dòng lệnh CMD, WCHISPTool, Công cụ lập trình dòng lệnh CMD, Công cụ lập trình dòng lệnh, Công cụ lập trình dòng, Công cụ lập trình |
