WCH-LinkE Online Download Debugger User Manual

1. Introducció i finalview

The WCH-LinkE module is a versatile online download debugger designed for microcontrollers (MCUs) based on WCH RISC-V architecture and ARM chips utilizing the Serial Wire Debug (SWD) interface. It facilitates online debugging and programming of target chips. The module connects to a host computer via a USB2.0 full-speed interface, offering plug-and-play, driver-free installation. Additionally, it provides a serial port for convenient debugging output.

2. Característiques funcionals

• Supports online downloading and debugging of WCH RISC-V architecture MCUs and ARM chips with SWD interface.
• Features a two-wire interface for fast and stable operation.
• Provides 3.3V/5V dual power output.
• Equipped with red and blue LED indicators for easy monitoring of working status.
• Interface definitions are directly marked on the board for user convenience.
• Supports automatic firmware detection and upgrade.
• Allows one-button switching between RISC-V and ARM modes via the host computer.
• Comes with a transparent case for motherboard protection and portability.

3. Descripció del maquinari

The WCH-LinkE module is designed for robust performance and ease of use. Below is a physical representation and the pin definitions for connecting to target boards.

Definició del pin

Table 1: WCH-LinkE Pin Definitions and their functions.

4. Configuració i connexió

4.1 Actualització del microprogramari

It is recommended to keep your WCH-LinkE firmware updated for optimal performance and compatibility.

• Actualització en línia: When using MounRiver Studio or WCH-LinkUtility, a pop-up reminder will appear if a firmware update is available upon clicking 'download'. Click 'Yes' to proceed with the update.
• Manual Online Update: Press and hold the IAP key on the WCH-LinkE module. While holding, power on the device. Continue holding until the blue LED lights up. Then, click 'download' in MounRiver Studio or WCH-LinkUtility. A pop-up reminder will appear; click 'Yes' to start the update.

4.2 Mètodes de connexió

SWD Connection

For debugging and programming WCH RISC-V and ARM chips, connect the WCH-LinkE to your target evaluation board using the SWD interface as shown below.

USB to TTL Serial Port Connection

To utilize the serial port for debugging output, connect the WCH-LinkE to your target evaluation board's UART pins as depicted.

5. Operating Instructions: Mode Switching

The WCH-LinkE supports different operating modes for RISC-V and ARM architectures. The mode can be switched using software or a physical key (for specific versions).

Mode acabatview

Table 2: Detailed description of WCH-LinkE operating modes.

5.1 Mode Switching via MounRiver Studio

• Power up the WCH-LinkE module.
• Open MounRiver Studio software and navigate to the download configuration.
• Select the desired target mode (e.g., WCH-LinkRV) from the dropdown menu.
• Click 'Apply' to set the new mode. You can click 'Query' to check the current mode.

5.2 Mode Switching via WCH-LinkUtility Tool

• Power up the WCH-LinkE module.
• Open the WCH-LinkUtility tool.
• Select the desired target mode from the dropdown menu.
• Click 'Set' to apply the mode. You can click 'Get' to retrieve the current mode.

5.3 Mode Switching via ModeS Key (WCH-LinkE-R0-1v2 only)

• For WCH-LinkE-R0-1v2 versions, press and hold the ModeS key.
• While holding the ModeS key, power on the WCH-LinkE.
• Continue holding until the status indicator LED lights up, which signifies the mode switch is complete.

Notes generals de funcionament

• During active downloading or debugging, the blue LED indicator on the WCH-LinkE will flash.
• Once a mode is set, the WCH-LinkE will maintain this mode for subsequent uses until explicitly changed.
• The high-speed version of WCH-LinkE offers accelerated performance specifically for CH32F20x, CH32V20x, and CH32V30x series chips.

6. Especificacions

Serial Port Default Parameters

• Bit de dades: 8
• Bit d'aturada: 1
• Checksum bit: None
• Control de flux: cap

Taxes de baudis compatibles

The WCH-LinkE serial port supports the following baud rates:

Table 3: List of supported serial port baud rates for WCH-LinkE.

7. Solució De Problemes

If you encounter issues while using the WCH-LinkE, consider the following common troubleshooting steps:

• Problemes de connexió: Ensure all physical connections (USB, SWD, UART) are secure and correctly wired according to the pin definitions and connection diagrams.
• Mode Mismatch: Verify that the WCH-LinkE is set to the correct mode (RISC-V or ARM) for your target chip using MounRiver Studio or WCH-LinkUtility.
• Firmware Outdated: Check for and apply any available firmware updates for the WCH-LinkE module.
• Configuració del programari: Confirm that your IDE (MounRiver Studio, Keil) is correctly configured to detect and communicate with the WCH-LinkE and your target device.
• Font d'alimentació: Ensure the target board is adequately powered, and the WCH-LinkE is receiving power via USB.

8. Consells d'usuari

Based on general usage patterns for similar debugging tools, here are some tips:

• Always double-check your wiring before powering on to prevent damage to the debugger or target board.
• Keep the WCH-LinkE firmware updated to ensure compatibility with the latest MCUs and software versions.
• When switching between RISC-V and ARM projects, remember to verify and adjust the WCH-LinkE's operating mode accordingly.
• Utilize the transparent case to protect the module from dust and physical damage, especially when transporting it.

9. Garantia i Suport

For technical support, software downloads, and further information, please refer to the official WCH resources:

• MounRiver Studio: http://mounriver.com/
• WCH-LinkUtility: https://www.wch.cn/downloads/WCH-LinkUtility_ZIP.html
• WCHISPTool: https://www.wch.cn/downloads/WCHISPTool_Setup_exe.html
• WCH-Link Information: https://www.wch.cn/products/WCH-Link.html

For official product information and updates, visit the WCH Official Weblloc.