WCH-LinkE Online Download Debugger User Manual

1. Introduction and Overview

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. Functional Features

• 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. Hardware Description

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.

Pin Definition

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

4. Setup and Connection

4.1 Firmware Update

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

• Online Update: 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 Connection Methods

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 Overview

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.

General Operating Notes

• 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. Specifications

Serial Port Default Parameters

• Data bit: 8
• Stop bit: 1
• Checksum bit: None
• Flow control: None

Supported Baud Rates

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

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

7. Troubleshooting

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

• Connection Issues: 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.
• Software Configuration: Confirm that your IDE (MounRiver Studio, Keil) is correctly configured to detect and communicate with the WCH-LinkE and your target device.
• Power Supply: Ensure the target board is adequately powered, and the WCH-LinkE is receiving power via USB.

8. User Tips

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. Warranty and Support

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 Website.