CH34xSerCfg GUI

English | 简体中文

CH34xSerCfg GUI is an open-source Python GUI for macOS that reads and writes USB configuration data on supported WCH CH34x devices. The interface can switch instantly between Chinese and English.

The currently hardware-tested target is CH343P (VID:PID 1A86:55D3). Other chips using the same WCH EEPROM control protocol may work, but test with recoverable hardware before production use.

Features

• Direct EEPROM access through libusb, without relying on the 300-baud serial configuration mode.
• Editable Serial Number, Product, and Manufacturer strings.
• Import and edit WCH fields including VID, PID, BCD, power, Attributes, and CFG.
• Import .cfg files exported by WCH CH34xSerCfg.
• Byte-for-byte readback verification after writing.
• Automatic increment for serial numbers ending in digits, plus programming logs.
• Chinese / English UI switching.
• Builds as a standalone Apple Silicon .app with Python and libusb bundled.

Run from Python

brew install libusb
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python app.py

Build the macOS App

chmod +x build_app.command
./build_app.command

The result is dist/CH34xSerCfg GUI.app. The packaged app stores state and logs in:

~/Library/Application Support/CH34xSerCfg GUI/

Usage

1. Connect only one target device.
2. Enter its current VID/PID and click Detect and Read.
3. Review or edit SN, Product, and Manufacturer, or import example.cfg.
4. Click Write and Verify.
5. Reconnect the device after a successful write so macOS reloads its USB descriptors.

Changing VID/PID can prevent the original driver from matching the device. Confirm your driver strategy before changing these values.

License

MIT