WCHISPTool CMD 명령줄 프로그래밍 도구
소개
소프트웨어 기능
WCHISPTool _ CMD는 WCH MCU 온라인 굽기를 위한 다중 플랫폼 명령줄 도구로, USB 또는 직렬 포트를 통해 WCH 시리즈 MCU에 대한 펌웨어 다운로드, 검증 및 기타 작업을 지원합니다. 이 도구에는 ISP 라이브러리 및 s가 포함되어 있습니다.ampISP 도구의 맞춤형 개발을 위한 프로그램입니다.
지원되는 운영 체제: 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 |
지침 |
매개변수 설명 |
|
| USB ISP 장치 또는 직렬 장치 노드 | /dev/ch37x /dev/ttyISPx | Linux에서 USB를 통해 다운로드 Linux에서 직렬 포트를 통해 다운로드 | |
| 위치lD COM(/dev/tty.*) | macOS에서 USB를 통해 다운로드 macOS에서 직렬 포트를 통해 다운로드 | ||
| -b | 직렬 포트의 통신 전송 속도 | 115200/230400/ | 직렬 포트의 통신 전송 속도 |
| -v | 버전 번호 인쇄 | 부팅/도구 | 부팅/도구 버전 |
| -c | 구성의 전체 경로 이름 file | xxx.ini | 전체/상대 경로 |
| -o | 작업 유형 | 프로그램/검증 | 다운로드/확인 |
| -f | 플래시의 이름 file | 트리플 엑스. 16진수/xxx. 큰 상자 | 전체/상대 경로 |
참고사항:
- 모든 명령과 매개변수는 "-x xxx" 형식으로 쌍으로 표시되어야 합니다.
- -p,-c,-o,-f 지침을 전달하려면 다운로드 또는 확인 작업이 필요합니다.
- – p 명령에 해당하는 USB ISP 장치 또는 직렬 포트 노드 이름을 확인하는 방법은,
상태 코드
| 지침 설명 | 매개변수 설명 |
| 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 Windows에서 WchIspStudio.exe의 "UI 구성 저장" 기능에 의해 생성됩니다. 구체적인 작업은 다음과 같습니다. 먼저 소프트웨어를 열고 소프트웨어 오른쪽에서 MCU 시리즈를 선택합니다. 다음으로, “Chip Option” 인터페이스에서 칩의 시리즈와 모델을 선택하고 “Download Config” 인터페이스에서 칩을 구성합니다. 그런 다음 기본 메뉴 '를 클릭하세요.File ->UI 구성 저장”. 마지막으로 구성의 이름과 위치를 선택합니다. file. 작동 인터페이스는 다음과 같습니다.
맞춤형 개발
각 시스템 폴더의 src 디렉토리에는 소스가 포함되어 있습니다. file사용자의 맞춤형 요구를 충족시키기 위해 이 코드를 기반으로 직접 개발할 수 있는 명령줄 굽기 도구입니다. lib 디렉토리에는 ISP 개발 동적 라이브러리와 헤더가 포함되어 있습니다. file에스. 기능 및 호출 지침에 대해서는 사용자가 WCH55XISPDLL을 참조할 수 있습니다. H 및 기타 헤더 filelib 디렉토리에 있습니다.
Windows 플랫폼
자세한 내용은 다음을 참조하세요. https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html 설치 경로 \WCHISPTool_XXX\Doc.
리눅스 플랫폼
지침
USB 다운로드 모드
- USB 연결
MCU가 BOOT 다운로드 모드인지, USB 장치의 PID가 0x55e0인지 확인하세요. - USB 장치 드라이버 설치
시스템 터미널을 열고 드라이버 폴더에 들어가서 “make install” 명령을 실행합니다. 이 작업은 첫 번째 다운로드에만 필요합니다. - USB ISP 장치 이름 확인
/dev/ch37x 문자 장치가 존재하는지 확인하려면 "ls" 명령을 사용하십시오. - 다운로드 명령 실행
예를 들어 도구의 명령 형식 요구 사항에 따라 실행합니다.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 다운로드 모드
- USB 연결
MCU가 BOOT 다운로드 모드인지, USB 장치의 PID가 0x55e0인지 확인하세요. - macOS 시스템에서 USB 장치의 위치 ID를 확인합니다. 시스템 보고서 ->하드웨어 ->USB에서 장치를 찾으세요. USB 장치 트리의 위치 ID는 다음 그림에 표시됩니다.
- 다운로드 명령 실행
예를 들어 도구의 명령 형식 요구 사항에 따라 실행합니다.amp파일, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o 프로그램 -f Target.hex
직렬 포트 다운로드 모드
- 직렬 포트로 MCU 연결
MCU가 BOOT 다운로드 모드인지 확인하세요. - 장치에 있는 직렬 포트의 노드 이름을 확인하고 해당 장치에서 "ls /dev/tty.*" 명령을 실행합니다.
macOS의 시리얼 포트를 확인하기 위한 터미널입니다(WCH 시리얼 포트 칩을 사용하는 경우 macOS의 CH34xVCPDriver를 설치하십시오). 구체적인 작업은 아래 그림에 나와 있습니다.
- 다운로드 명령 실행
예를 들어 도구의 명령 형식 요구 사항에 따라 실행합니다.amp파일, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o 프로그램 -f Target.hex
로그 실행 file
다운로드 성공 사례
다운로드 작업 실패 사례
BOOT 버전을 별도로 구하는 경우
소프트웨어 버전을 별도로 구하는 경우
문서 / 리소스
 | WCHISPTool CMD 명령줄 프로그래밍 도구 |
참고문헌
- 南京沁恒微电子股份有限公司wch.cn
- WCHISPTool_Setup.exe - 南京沁恒微电子股份有限公主www.wch.cn
- 사용자 설명서manual.tools