Development preview
Eight UARTs.
Native ports.
A macOS DriverKit driver for WCH CH348 USB adapters. Standard serial devices for the tools you already use.
macOS 14+ Apple Silicon + Intel builds MIT
$ ls /dev/cu.CH348*
/dev/cu.CH34800100000-0
/dev/cu.CH34800100000-1
/dev/cu.CH34800100000-2
/dev/cu.CH34800100000-3
/dev/cu.CH34800100000-4
/dev/cu.CH34800100000-5
/dev/cu.CH34800100000-6
/dev/cu.CH34800100000-7Example after development installation.
Names include the adapter’s USB location.
Made for CH348.
One USB device. Eight native serial services.
- Hardware
- WCH CH348
1a86:55d9 - System
- macOS 14 or later
- Interface
- DriverKit + SerialDriverKit
- Devices
/dev/cu.*and/dev/tty.*
CH348 has eight UARTs per chip. Other WCH chip families, including CH343, need their own driver support.
Tested on real hardware.
The current development build is 0.1.0 / 12.
- Eight native serial ports on Apple Silicon.
- Driver replacement after a physical reconnect.
- H2Loader command exchange through native ports.
Intel runtime, simultaneous multi-adapter use, sustained throughput, sleep and reboot still need qualification.
Read the validation notesBuild from source.
A small native project, with host-side protocol and ring-buffer tests. Use a full Xcode installation and XcodeGen.
These commands produce an unsigned development package. The signing guide covers local driver activation.
scripts/test.sh
scripts/build.sh --unsigned
python3 scripts/package.py --unsignedv0.1.0-dev.12-pkg.1
Download the PKG preview.
CH348-0.1.0-build12-macos-universal-unsigned.pkg1.4 MB · Apple Silicon + IntelThe CI-built PKG contains the app and embedded driver. It places CH348.app in /Applications; extension activation is handled by the app. Find the installer under Assets in the PKG preview release.
Unsigned and not notarized. This preview cannot activate the driver without valid signing.