Device Overview

The CH591D module-Bluetooth Low Energy (BLE) and USB-C connectivity, making it ideal for low-power wireless applications that also require USB communication .

Technical Specifications

Connection & Pins

Fail:

- the description of Pb4 and Pb7 is reversed

Use Cases

• Wireless controllers or macro keypads( IMK8K )

• Portable BLE-enabled gadgets

• USB-HID device development

• IoT modules with BLE notifications

• Development and testing of BLE applications

Software Support

• IDE: MounRiver Studio (official from WCH)

• WCHISPTool

• Available libraries: BLE(HID,MESH...), USB HID, UART, SPI...

• SDK from WCH (open source)

• Datasheet...
• WCH Tools,drivers

Programming Steps:

1. Preparation

• Download and install MounRiver Studio from: https://www.wch.cn

• Create a new project for CH591D:

  • File → New → Project → CH591

  • Select target chip: CH591D

2. Write Code

• Write your C code (e.g., LED blink).

• Make sure you have a main() function.

• Save your .c file in the src directory.

  or 

• Download example
• Unzip
• Moun River Studio > Open existing project
• Edit ...

• Generating HEX File

  • Right-click your project in MounRiver → Build Project

  • The generated .hex file will be located at:
    ProjectFolder/output/ch591.hex

3. USB DFU Boot Setup

• CH591D can be programmed over USB if PB7 is pulled to GND during power-up.Steps:

  1. Press and hold the button BOOT1 (PB7 = GND)

  2. Plug in the USB cable

  3. Release the button

• The device will show up as WCHISP (depends on OS)

4. Uploading to Chip

• In MounRiver go to: Tools → WCHISPTool
  Or use standalone WCHISPTool

• Load the HEX file and click Download

• The firmware will be flashed over USB

• wchisp - WCH ISP Tool in Rust

• wchisp -tested on Kubuntu: 

  Quick Guide to Program CH591D with wchisp

  1. Install dependencies

  bash

  sudo apt install libusb-1.0-0-dev

  2. Install wchisp tool

  bash

   

  cargo install wchisp --git https://github.com/ch32-rs/wchisp

  3. Add udev rule (if not done yet)

   

  Create /etc/udev/rules.d/50-wchisp.rules with:

   

  sudo nano /etc/udev/rules.d/50-wchisp.rules

   

  SUBSYSTEM=="usb", ATTRS{idVendor}=="4348", ATTRS{idProduct}=="55e0", MODE="0666"

   

  (Ctrl+O, Enter, Ctrl+X)

  Reload rules:

  bash

  sudo udevadm control --reload-rules sudo udevadm trigger

  4. Connect CH591D via USB and check detection

  bash

  lsusb | grep 4348

  or

  bash

  dmesg | tail

  5. Check MCU info (verify access)

  bash

  wchisp info

  6. Flash hex/bin file

  Use absolute or relative path without leading ./:

  bash

  wchisp flash /path to/firmware.hex

Prototype Notice

NOTICE: This CH591D module is a development prototype. It may contain limitations, experimental firmware, or test components. Intended for development, debugging, and testing only.