当前位置：首页 > news >正文

告别驱动烦恼：在Ubuntu 22.04上5分钟搞定CH343串口驱动安装与开机自启

news 2026/5/7 3:37:16

5分钟极速指南：Ubuntu 22.04下CH343串口驱动一键配置实战

当你兴奋地拆开新到的物联网开发板，准备通过串口调试时，却发现在Ubuntu系统中/dev/ttyUSB0始终无法识别——这种场景对嵌入式开发者而言再熟悉不过。不同于Windows即插即用的便利，Linux下的USB转串口驱动配置常常成为新手的第一道门槛。本文将聚焦国产CH343芯片，用最简步骤实现从驱动编译到开机自启的全流程，特别针对Ubuntu 22.04 LTS版本优化操作路径。

1. 环境准备与驱动获取

在开始前，请确保你的系统已安装基本开发工具链。打开终端执行以下命令完成基础环境配置：

sudo apt update && sudo apt install -y build-essential linux-headers-$(uname -r)

CH343的官方驱动托管在GitHub仓库，推荐使用git直接克隆到本地。这里提供国内开发者更熟悉的Gitee镜像源以加速下载：

git clone https://gitee.com/mirrors/ch343ser_linux.git cd ch343ser_linux

常见问题排查：

若遇到make命令报错，请检查linux-headers版本是否与当前内核匹配
部分国内网络环境可能需要配置Git代理或改用HTTPS协议

2. 驱动编译与动态加载

现代Linux内核采用模块化设计，CH343驱动以内核模块(.ko文件)形式提供。编译过程仅需三步：

清理旧编译结果（首次可跳过）：
```
make clean
```
执行标准编译：
```
make
```
加载生成的驱动模块：
```
sudo insmod ch343.ko
```

关键验证步骤：

lsmod | grep ch343 # 检查驱动是否加载 dmesg | tail -n 10 # 查看内核日志确认设备识别

此时插入CH343设备，正常情况下会在/dev目录下生成ttyCH343USBx节点。若仍显示为ttyUSBx，可能需要处理驱动冲突问题。

3. 解决CDC驱动冲突

Ubuntu默认加载的cdc_acm驱动会与CH343产生冲突。通过修改模块加载顺序可彻底解决：

echo "blacklist cdc_acm" | sudo tee /etc/modprobe.d/blacklist-cdc-acm.conf

更优雅的方案是配置系统优先加载CH343驱动。编辑/etc/modules-load.d/ch343.conf文件：

# 优先加载CH343驱动 ch343

使用systemd的开发者可以通过新建服务单元实现更精细控制：

cat <<EOF | sudo tee /etc/systemd/system/ch343-driver.service [Unit] Description=Load CH343 USB-Serial Driver [Service] Type=oneshot ExecStart=/sbin/insmod /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch343.ko [Install] WantedBy=multi-user.target EOF sudo systemctl enable ch343-driver.service

4. 永久安装与设备权限配置

要实现真正的开箱即用，还需要解决两个问题：驱动持久化安装和普通用户设备访问权限。

驱动安装标准化：

sudo make install # 自动部署驱动到系统目录 sudo depmod -a # 重建模块依赖关系

设备权限配置（推荐方式）：

cat <<EOF | sudo tee /etc/udev/rules.d/99-ch343.rules SUBSYSTEM=="tty", ATTRS{idVendor}=="1a86", ATTRS{idProduct}=="55d9", MODE="0666", SYMLINK+="ttyCH343_%n" EOF sudo udevadm control --reload-rules

该规则实现三个功能：

固定设备节点权限为666（所有用户可读写）
创建易识别的符号链接（如/dev/ttyCH343_0）
自动适配多设备场景（%n表示设备序号）

5. 验证与高级调试

完成所有配置后，建议重启系统进行完整验证。快速测试脚本可帮助确认全链路功能：

#!/bin/bash # 检查驱动加载状态 echo -e "\n[Driver Status]" lsmod | grep -i ch343 || echo "Driver not loaded!" # 检查设备节点 echo -e "\n[Device Nodes]" ls -l /dev/ttyCH343* 2>/dev/null || ls -l /dev/ttyUSB* 2>/dev/null # 基础通信测试（需接回环头或实际设备） echo -e "\n[Loopback Test]" stty -F /dev/ttyCH3430 115200 raw -echo echo "TEST" > /dev/ttyCH3430 timeout 1 cat /dev/ttyCH3430 | grep -q TEST && echo "PASS" || echo "FAIL"

波特率极限测试： CH343支持最高6Mbps的传输速率，但实际性能受线材质量影响。建议使用screen进行高速测试：

screen /dev/ttyCH3430 6000000

6. 开发环境集成技巧

现代IDE通常需要额外配置才能识别自定义串口设备。以VS Code为例，在.vscode/settings.json中添加：

{ "terminal.integrated.env.linux": { "CH343_DEVICE": "/dev/ttyCH3430" }, "platformio.customDevicePath": "/dev/ttyCH343*" }

对于Python开发者，推荐使用pyserial库时增加自动重连逻辑：

import serial from serial.tools import list_ports def find_ch343(): for port in list_ports.comports(): if "1A86:55D9" in port.hwid: return port.device raise RuntimeError("CH343 device not found") ser = serial.Serial(find_ch343(), baudrate=115200, timeout=1)

7. 嵌入式开发板特殊配置

当在Raspberry Pi等ARM平台使用时，需要交叉编译驱动。示例使用树莓派官方工具链：

export KERNEL_SRC=/path/to/linux-source export ARCH=arm export CROSS_COMPILE=arm-linux-gnueabihf- make clean && make

针对Yocto项目，可创建自定义recipe：

SUMMARY = "CH343 USB-Serial Driver" LICENSE = "GPL-2.0-only" SRC_URI = "git://gitee.com/mirrors/ch343ser_linux.git;protocol=https" SRCREV = "最新提交哈希" S = "${WORKDIR}/git" inherit module do_install() { install -d ${D}${base_libdir}/modules/${KERNEL_VERSION}/kernel/drivers/usb/serial install -m 0644 ${S}/ch343.ko ${D}${base_libdir}/modules/${KERNEL_VERSION}/kernel/drivers/usb/serial }

实际部署中发现，某些定制内核可能需要手动指定内核源码路径。这时可以修改Makefile中的KERNELDIR变量：

# 原配置 # KERNELDIR ?= /lib/modules/$(shell uname -r)/build # 树莓派专用配置 KERNELDIR ?= /home/pi/linux

8. 性能优化与异常处理

CH343在高速传输时可能出现数据丢失，通过以下措施可显著改善：

USB控制器优化：

# 禁用USB自动挂起 for i in /sys/bus/usb/devices/*/power/autosuspend; do echo -1 | sudo tee $i; done # 提高USB传输缓冲区 echo 4096 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb

内核参数调整：

# 增加USB串口缓冲区 echo "options usbserial bulk_buflen=4096" | sudo tee /etc/modprobe.d/usbserial.conf

当遇到设备突然断开时，智能重连脚本能大幅提升开发体验：

#!/bin/bash while true; do if [ -c /dev/ttyCH3430 ]; then screen /dev/ttyCH3430 115200 else echo "等待设备重新连接..." while [ ! -c /dev/ttyCH3430 ]; do sleep 1; done fi sleep 1 done

在长期使用中发现，CH343对ESD保护要求较高。建议在实际产品中：