Ubuntu 22.04下CH340串口驱动深度配置指南最近在折腾树莓派和Arduino项目时发现手头的CH340串口设备在Ubuntu 22.04上死活识别不出来。这让我想起几年前第一次接触Linux时也被类似的问题困扰过。虽然现在Linux对硬件的支持已经好了很多但某些国产芯片的驱动问题依然存在。本文将分享一套完整的解决方案不仅解决驱动安装问题还会深入探讨如何让系统自动加载驱动避免每次重启都要手动操作的麻烦。1. 准备工作与环境检查在开始安装驱动之前我们需要先确认几个关键信息。打开终端CtrlAltT执行以下命令查看当前系统内核版本uname -r典型输出可能是5.15.0-xx-generic这样的格式。这个信息很重要因为驱动需要与内核版本匹配。接下来检查系统是否已经加载了某些可能冲突的模块lsmod | grep usbserial如果输出为空表示没有加载任何USB串口驱动如果有输出则需要记下具体的模块名称。注意某些情况下系统自带的brltty服务会占用串口设备。如果遇到设备被占用的情况可以暂时移除这个服务sudo apt remove brltty2. 获取与编译CH340驱动由于官方提供的Linux驱动更新不及时我们需要手动编译适合当前内核的驱动版本。首先创建一个工作目录并下载驱动源码mkdir ~/ch340_driver cd ~/ch340_driver wget http://www.wch.cn/downloads/CH341SER_LINUX_ZIP.html -O ch341ser_linux.zip unzip ch341ser_linux.zip解压后你会看到三个文件但真正需要关注的只有ch34x.c这个源文件。由于这个文件可能比较旧我们需要做一些调整打开ch34x.c文件查找linux/version.h的引用如果发现这个头文件引用可以注释掉新内核已经不再需要保存修改后准备编译环境sudo apt update sudo apt install build-essential linux-headers-$(uname -r)现在可以开始编译了make如果编译过程中出现警告通常可以忽略只要没有致命错误就行。编译完成后会生成ch34x.ko文件这就是我们需要的驱动模块。3. 驱动安装与系统集成单纯的编译只是第一步要让驱动真正工作并实现自动加载还需要以下几个步骤首先检查系统现有的USB串口驱动位置ls /lib/modules/$(uname -r)/kernel/drivers/usb/serial你可能会看到一些已有的驱动文件比如cp210x.ko、pl2303.ko等。我们需要把新编译的驱动放到这个目录并确保命名与系统预期一致。执行以下命令进行安装sudo rm /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko # 移除旧驱动如果有 sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko sudo depmod -a # 更新模块依赖关系为了让系统启动时自动加载驱动我们需要编辑模块配置文件sudo nano /etc/modules-load.d/ch341.conf在文件中添加一行ch341保存后退出。这样系统启动时就会自动加载这个模块了。4. 验证与故障排除完成上述步骤后重启系统或者手动加载驱动sudo modprobe ch341然后插入CH340设备使用以下命令检查是否识别成功dmesg | grep ch34正常应该能看到类似这样的输出[ 5.123456] usbserial: USB Serial support registered for ch341-uart [ 5.123457] ch341 1-1.2:1.0: ch341-uart converter detected还可以查看具体的设备节点ls /dev/ttyUSB*如果一切正常你应该能看到/dev/ttyUSB0这样的设备文件。常见问题及解决方案问题现象可能原因解决方法设备未出现在/dev下驱动未正确加载检查dmesg输出确认驱动加载情况权限不足当前用户不在dialout组sudo usermod -aG dialout $USER设备间歇性断开电源管理问题禁用USB自动挂起echo 1-15. 高级配置与优化对于需要长期稳定使用CH340设备的用户还可以进行以下优化1. 固定设备名称默认情况下USB设备的节点名称如ttyUSB0可能会随插入顺序变化。可以通过udev规则固定设备名称sudo nano /etc/udev/rules.d/99-ch340.rules添加以下内容根据实际设备ID调整SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH340保存后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger2. 调整串口参数对于需要特定串口参数的应用可以预先配置stty -F /dev/ttyCH340 115200 cs8 -parenb -cstopb或者创建systemd服务在启动时自动设置。3. 内核模块参数如果需要调整驱动行为可以添加模块参数echo options ch341 ignore_sysrq1 | sudo tee /etc/modprobe.d/ch341.conf6. 替代方案与比较如果觉得手动编译驱动太麻烦也可以考虑以下替代方案1. 使用DKMS自动编译将驱动设置为DKMS模块可以在内核更新时自动重新编译sudo apt install dkms sudo mkdir -p /usr/src/ch341/1.0 sudo cp ch34x.c /usr/src/ch341/1./ sudo cp Makefile /usr/src/ch341/1./然后创建dkms.conf文件PACKAGE_NAMEch341 PACKAGE_VERSION1.0 MAKE[0]make all KVERSION$kernelver CLEANmake clean BUILT_MODULE_NAME[0]ch341 DEST_MODULE_LOCATION[0]/updates AUTOINSTALLyes2. 其他兼容驱动有些第三方维护的驱动可能更新更及时比如sudo apt install git git clone https://github.com/juliagoda/CH341SER.git cd CH341SER make sudo make install3. 硬件替代方案如果可能考虑使用驱动支持更好的芯片比如CP2102/CP2104Silicon LabsFT232FTDIPL2303Prolific这些芯片在Linux下的支持通常更好但成本可能略高。7. 实际应用案例最后分享一个真实场景我在开发一个基于Arduino的温室监控系统时遇到了CH340设备在Ubuntu服务器上不稳定的问题。通过以下步骤最终解决了问题按照本文方法编译安装了最新驱动设置了固定的设备名称创建了systemd服务自动重连添加了udev规则确保设备权限正确系统已经稳定运行了6个月经历了多次内核更新和重启。关键是要理解整个驱动加载机制而不仅仅是照搬步骤。每次内核更新后DKMS会自动重新编译驱动这大大减少了维护工作量。
Ubuntu 22.04下CH340串口驱动安装全攻略（附自动加载解决方案）
Ubuntu 22.04下CH340串口驱动深度配置指南最近在折腾树莓派和Arduino项目时发现手头的CH340串口设备在Ubuntu 22.04上死活识别不出来。这让我想起几年前第一次接触Linux时也被类似的问题困扰过。虽然现在Linux对硬件的支持已经好了很多但某些国产芯片的驱动问题依然存在。本文将分享一套完整的解决方案不仅解决驱动安装问题还会深入探讨如何让系统自动加载驱动避免每次重启都要手动操作的麻烦。1. 准备工作与环境检查在开始安装驱动之前我们需要先确认几个关键信息。打开终端CtrlAltT执行以下命令查看当前系统内核版本uname -r典型输出可能是5.15.0-xx-generic这样的格式。这个信息很重要因为驱动需要与内核版本匹配。接下来检查系统是否已经加载了某些可能冲突的模块lsmod | grep usbserial如果输出为空表示没有加载任何USB串口驱动如果有输出则需要记下具体的模块名称。注意某些情况下系统自带的brltty服务会占用串口设备。如果遇到设备被占用的情况可以暂时移除这个服务sudo apt remove brltty2. 获取与编译CH340驱动由于官方提供的Linux驱动更新不及时我们需要手动编译适合当前内核的驱动版本。首先创建一个工作目录并下载驱动源码mkdir ~/ch340_driver cd ~/ch340_driver wget http://www.wch.cn/downloads/CH341SER_LINUX_ZIP.html -O ch341ser_linux.zip unzip ch341ser_linux.zip解压后你会看到三个文件但真正需要关注的只有ch34x.c这个源文件。由于这个文件可能比较旧我们需要做一些调整打开ch34x.c文件查找linux/version.h的引用如果发现这个头文件引用可以注释掉新内核已经不再需要保存修改后准备编译环境sudo apt update sudo apt install build-essential linux-headers-$(uname -r)现在可以开始编译了make如果编译过程中出现警告通常可以忽略只要没有致命错误就行。编译完成后会生成ch34x.ko文件这就是我们需要的驱动模块。3. 驱动安装与系统集成单纯的编译只是第一步要让驱动真正工作并实现自动加载还需要以下几个步骤首先检查系统现有的USB串口驱动位置ls /lib/modules/$(uname -r)/kernel/drivers/usb/serial你可能会看到一些已有的驱动文件比如cp210x.ko、pl2303.ko等。我们需要把新编译的驱动放到这个目录并确保命名与系统预期一致。执行以下命令进行安装sudo rm /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko # 移除旧驱动如果有 sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko sudo depmod -a # 更新模块依赖关系为了让系统启动时自动加载驱动我们需要编辑模块配置文件sudo nano /etc/modules-load.d/ch341.conf在文件中添加一行ch341保存后退出。这样系统启动时就会自动加载这个模块了。4. 验证与故障排除完成上述步骤后重启系统或者手动加载驱动sudo modprobe ch341然后插入CH340设备使用以下命令检查是否识别成功dmesg | grep ch34正常应该能看到类似这样的输出[ 5.123456] usbserial: USB Serial support registered for ch341-uart [ 5.123457] ch341 1-1.2:1.0: ch341-uart converter detected还可以查看具体的设备节点ls /dev/ttyUSB*如果一切正常你应该能看到/dev/ttyUSB0这样的设备文件。常见问题及解决方案问题现象可能原因解决方法设备未出现在/dev下驱动未正确加载检查dmesg输出确认驱动加载情况权限不足当前用户不在dialout组sudo usermod -aG dialout $USER设备间歇性断开电源管理问题禁用USB自动挂起echo 1-15. 高级配置与优化对于需要长期稳定使用CH340设备的用户还可以进行以下优化1. 固定设备名称默认情况下USB设备的节点名称如ttyUSB0可能会随插入顺序变化。可以通过udev规则固定设备名称sudo nano /etc/udev/rules.d/99-ch340.rules添加以下内容根据实际设备ID调整SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH340保存后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger2. 调整串口参数对于需要特定串口参数的应用可以预先配置stty -F /dev/ttyCH340 115200 cs8 -parenb -cstopb或者创建systemd服务在启动时自动设置。3. 内核模块参数如果需要调整驱动行为可以添加模块参数echo options ch341 ignore_sysrq1 | sudo tee /etc/modprobe.d/ch341.conf6. 替代方案与比较如果觉得手动编译驱动太麻烦也可以考虑以下替代方案1. 使用DKMS自动编译将驱动设置为DKMS模块可以在内核更新时自动重新编译sudo apt install dkms sudo mkdir -p /usr/src/ch341/1.0 sudo cp ch34x.c /usr/src/ch341/1./ sudo cp Makefile /usr/src/ch341/1./然后创建dkms.conf文件PACKAGE_NAMEch341 PACKAGE_VERSION1.0 MAKE[0]make all KVERSION$kernelver CLEANmake clean BUILT_MODULE_NAME[0]ch341 DEST_MODULE_LOCATION[0]/updates AUTOINSTALLyes2. 其他兼容驱动有些第三方维护的驱动可能更新更及时比如sudo apt install git git clone https://github.com/juliagoda/CH341SER.git cd CH341SER make sudo make install3. 硬件替代方案如果可能考虑使用驱动支持更好的芯片比如CP2102/CP2104Silicon LabsFT232FTDIPL2303Prolific这些芯片在Linux下的支持通常更好但成本可能略高。7. 实际应用案例最后分享一个真实场景我在开发一个基于Arduino的温室监控系统时遇到了CH340设备在Ubuntu服务器上不稳定的问题。通过以下步骤最终解决了问题按照本文方法编译安装了最新驱动设置了固定的设备名称创建了systemd服务自动重连添加了udev规则确保设备权限正确系统已经稳定运行了6个月经历了多次内核更新和重启。关键是要理解整个驱动加载机制而不仅仅是照搬步骤。每次内核更新后DKMS会自动重新编译驱动这大大减少了维护工作量。
