Narzędzie do programowania wiersza poleceń WCHISPTool CMD

Wstęp
Funkcja oprogramowania
WCHISPTool _ CMD to wieloplatformowe narzędzie wiersza poleceń do nagrywania online MCU WCH, które obsługuje pobieranie oprogramowania sprzętowego, weryfikację i inne operacje dla serii MCU WCH przez USB lub port szeregowy. Narzędzie zawiera bibliotekę ISP i sampprogramy do niestandardowego rozwoju narzędzia ISP.
Obsługiwany system operacyjny: Windows x86/x64, Linux x64, macOS x64/arm64.
Obsługiwane modele chipów: CH54x/ CH55x/ CH56x/ CH641x/ CH643x/ CH57x/ CH58x/ CH59x/ CH32F10x/ CH3F20x/ CH32V00x/ CH32V10x/ CH32V20x/ CH32V30x/ CH32X03x/ CH32L10x.
Wiersz poleceń
Pobierać
Tryb USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o program -f Target.hex
Tryb portu szeregowego:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o program -f Target.hex
Zweryfikować
Tryb USB:
sudo ./WCHISPTool_CMD -p /dev/ch37x -c Config.ini -o zweryfikować -f Target.hex
Tryb portu szeregowego:
sudo ./WCHISPTool_CMD -p /dev/ttyISP0 -b 115200 -c Config.ini -o zweryfikować -f Target.hex
Opis parametrów
| -p |
Instrukcja |
Opis parametrów |
|
| Urządzenie USB ISP lub węzeł urządzenia szeregowego | /dev/ch37x /dev/ttyISPx | Pobieranie przez USB w systemie Linux Pobieranie przez port szeregowy w systemie Linux | |
| LokalizacjalD COM(/dev/tty.*) | Pobieranie przez USB w systemie macOS Pobieranie przez port szeregowy w systemie macOS | ||
| -b | Szybkość transmisji komunikacji portu szeregowego | 115200/230400/ | Szybkość transmisji komunikacji portu szeregowego |
| -v | Numer wersji do druku | rozruch/narzędzie | Wersja rozruchowa/narzędzia |
| -c | Pełna nazwa ścieżki pliku konfiguracyjnego file | xxx.ini | Pełna/względna ścieżka |
| -o | Rodzaj operacji | zaprogramować/zweryfikować | Pobierz/zweryfikuj |
| -f | Imię Flasha file | xxx. szesnastkowy/xxx. kosz | Pełna/względna ścieżka |
Uwagi:
- Wszystkie polecenia i parametry muszą występować parami w formacie „-x xxx”.
- Pobierz lub sprawdź, czy operacja jest wymagana do przekazania instrukcji -p, -c, -o, -f.
- W przypadku metody potwierdzenia nazwy urządzenia USB ISP lub węzła portu szeregowego odpowiadającej poleceniu – p,
Kod statusu
| Opis instrukcji | Opis parametrów |
| 0 | Wykonaj pomyślnie |
| 1 | Nieprawidłowy parametr wejściowy |
| 2 | Nie udało się pobrać parametrów z konfiguracji file |
| 3 | Nie udało się ustawić parametrów ISP |
| 4 | Podana nazwa portu szeregowego jest nieprawidłowa |
| 5 | Nie wymieniono żadnego urządzenia |
| 6 | Określony typ chipa nie jest zgodny z rzeczywistym typem chipa |
| 7 | Nie udało się pobrać informacji o urządzeniu |
| 8 | Nieprawidłowy Flash file ścieżka |
| 9 | Nieprawidłowy Flash file długość |
| 10 | Nie udało się odczytać Flasha file |
| 11 | Nie udało się przekonwertować Flasha file z formatu HEX na BIN |
| 12 | Nie udało się wyłączyć ochrony przed odczytem |
| 13 | Nie udało się pobrać |
| 14 | Nie udało się zweryfikować |
| 100 | Nieznany błąd |
Konfiguracja file
Konfiguracja file jest generowany przez funkcję „Save UI Config” programu WchIspStudio.exe w systemie Windows. Konkretne operacje są następujące: Najpierw otwórz oprogramowanie i wybierz serię MCU po prawej stronie oprogramowania. Następnie wybierz serię i model chipa w interfejsie „Chip Option” i skonfiguruj chip w interfejsie „Download Config”. Następnie kliknij menu główne „File ->Zapisz konfigurację interfejsu użytkownika”. Na koniec wybierz nazwę i lokalizację konfiguracji file. Interfejs operacyjny jest następujący.

Niestandardowy rozwój
Katalog src w każdym folderze systemowym zawiera źródło files narzędzia do nagrywania wiersza poleceń, które można bezpośrednio opracować w oparciu o ten kod, aby sprostać indywidualnym wymaganiom użytkowników. Katalog lib zawiera dynamiczną bibliotekę programistyczną ISP i nagłówek fileS. Aby uzyskać informacje na temat funkcji i instrukcji wywołań, użytkownicy mogą zapoznać się z WCH55XISPDLL. H i inny nagłówek files w katalogu lib.
Platforma Windows
Aby uzyskać szczegółowe informacje, zapoznaj się z: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html ścieżka instalacyjna \ WCHISPTool_XXX\Doc.
Platforma Linux
Instrukcja
Tryb pobierania USB
- Podłącz USB
Upewnij się, że MCU jest w trybie pobierania BOOT, a PID urządzenia USB to 0x55e0. - Zainstaluj sterownik urządzenia USB
Otwórz terminal systemowy, wejdź do folderu sterownika i wykonaj polecenie „make install”. Ta operacja jest wymagana tylko przy pierwszym pobraniu. - Określ nazwę urządzenia USB ISP
Użyj polecenia „ls”, aby sprawdzić, czy urządzenie znakowe /dev/ch37x istnieje. - Wykonaj instrukcję pobierania
Wykonaj zgodnie z wymaganiami dotyczącymi formatu instrukcji narzędzia, npample, sudo ./WCHISPTool_CMD -p /dev/ch37x0 -c Config.ini -o program -f Target.hex
Tryb pobierania przez port szeregowy
- Podłącz MCU do portu szeregowego
Upewnij się, że MCU jest w trybie pobierania BOOT. - Utwórz nazwę urządzenia szeregowego ISP
Potwierdź nazwę węzła urządzenia portu szeregowego, a następnie użyj polecenia „ln”, aby utworzyć miękkie łącze o nazwie „ttyISPx” dla tego urządzenia. Konkretne polecenie jest następujące. sudo ln –s /dev/ttyUSB0 /dev/ttyISP0 - Wykonaj instrukcję pobierania.
Wykonaj zgodnie z wymaganiami dotyczącymi formatu instrukcji narzędzia, npample, sudo ./WCHISPTool_CMD -p /dev/ttyISP0 –b 115200 -c Config.ini -o program -f Target.hex
Uruchom dziennik file
Instancja pomyślnej operacji pobierania

Instancja nieudanej operacji pobierania

Przykład osobnego pobrania wersji BOOT

Przykład osobnego pobrania wersji oprogramowania

Platforma macOS
Instrukcja
Tryb pobierania USB
- Podłącz USB
Upewnij się, że MCU jest w trybie pobierania BOOT, a PID urządzenia USB to 0x55e0. - Określ identyfikator lokalizacji urządzenia USB w systemie macOS. Znajdź urządzenie w Raporcie systemowym -> Sprzęt -> USB. Identyfikator lokalizacji w drzewie urządzeń USB pokazano na poniższym rysunku.
- Wykonaj instrukcję pobierania
Wykonaj zgodnie z wymaganiami dotyczącymi formatu instrukcji narzędzia, npample, sudo ./WCHISPTool_CMD -p 0x02131000 -c Config.ini -o program -f Target.hex

Tryb pobierania przez port szeregowy
- Podłącz MCU do portu szeregowego
Upewnij się, że MCU jest w trybie pobierania BOOT. - Określ nazwę węzła portu szeregowego urządzenia i uruchom na nim komendę „ls /dev/tty.*”.
terminal, aby sprawdzić port szeregowy w systemie macOS (jeśli używany jest układ portu szeregowego WCH, zainstaluj sterownik CH34xVCPDriver w systemie macOS). Konkretną operację pokazano na poniższym rysunku.

- Wykonaj instrukcję pobierania
Wykonaj zgodnie z wymaganiami dotyczącymi formatu instrukcji narzędzia, npample, sudo ./WCHISPTool_CMD -p tty.wchusbserial214201–b 115200 -c Config.ini -o program -f Target.hex
Uruchom dziennik file
Instancja pomyślnej operacji pobierania

Instancja nieudanej operacji pobierania

Przykład osobnego pobrania wersji BOOT

Przykład osobnego pobrania wersji oprogramowania


Dokumenty / Zasoby
![]() |
WCH WCHISPTool CMD Narzędzie do programowania wiersza poleceń [plik PDF] Instrukcje WCHISPTool Narzędzie do programowania z wiersza poleceń CMD, WCHISPTool, Narzędzie do programowania z wiersza poleceń CMD, Narzędzie do programowania z wiersza poleceń, Narzędzie do programowania liniowego, Narzędzie do programowania |




