树莓派/香橙派玩转CH340串口模块Ubuntu 22.04下驱动编译与测试全记录在嵌入式开发和创客项目中串口通信是最基础也最常用的硬件交互方式之一。无论是连接Arduino进行固件烧录还是与ESP32模块进行调试通信CH340系列USB转串口芯片因其出色的性价比和稳定性成为了众多开发者的首选。然而当我们将目光投向树莓派、香橙派等流行的单板计算机时特别是在较新的Ubuntu 22.04 LTS或Raspberry Pi OS系统上CH340驱动的安装往往会遇到一些特有的挑战。不同于传统的x86架构PCARM架构的单板计算机在驱动编译和内核模块加载上有着自己的特点。加之Ubuntu 22.04采用了较新的Linux内核版本官方提供的CH340驱动源码可能需要一些针对性的修改才能顺利编译。本文将带领大家一步步解决这些问题从驱动源码的获取、修改、编译到最终的硬件连接和功能测试形成一个完整的解决方案。我们不仅会关注技术细节的实现还会分享在实际项目中积累的宝贵经验帮助开发者避开那些容易导致失败的坑。1. 环境准备与驱动源码获取在开始之前我们需要确保开发环境已经准备就绪。对于使用树莓派或香橙派的开发者来说建议使用最新的Raspberry Pi OS基于Debian 11或Ubuntu 22.04 LTS系统。这些系统不仅提供了长期支持还包含了大多数开发所需的工具链。首先我们需要安装一些基础的开发工具和内核头文件。打开终端执行以下命令sudo apt update sudo apt install -y build-essential git linux-headers-$(uname -r)这些命令会更新软件包列表并安装编译驱动所需的工具链和当前运行内核对应的头文件。值得注意的是在ARM架构的设备上某些软件包的名称或依赖关系可能与x86平台略有不同这也是为什么我们需要特别强调系统环境的原因。接下来获取CH340的驱动源码。虽然沁恒微电子官网上提供了驱动下载但为了确保我们使用的是最新版本可以直接从官方GitHub仓库获取git clone https://github.com/juliagoda/CH341SER cd CH341SER这个仓库维护了针对新内核的CH340驱动修改版本相比官网提供的驱动包它已经包含了对新内核的适配补丁可以大大减少我们手动修改的工作量。2. 驱动编译与内核适配在ARM架构的设备上编译内核模块有几个关键点需要特别注意。首先我们需要确认当前运行的内核版本与安装的内核头文件是否匹配。执行以下命令检查uname -r ls /usr/src/linux-headers-$(uname -r)如果两者不匹配可能会导致编译后的模块无法加载。这种情况在频繁更新系统的树莓派上较为常见。解决方法要么是更新系统到最新版本要么是安装与当前运行内核对应的头文件包。进入驱动源码目录后我们可以先查看Makefile文件确保它已经针对ARM架构做了适当配置。一个典型的Makefile内容如下obj-m : ch34x.o KDIR : /lib/modules/$(shell uname -r)/build PWD : $(shell pwd) all: $(MAKE) -C $(KDIR) M$(PWD) modules clean: $(MAKE) -C $(KDIR) M$(PWD) clean对于较新的内核版本5.15及以上驱动源码可能还需要一些额外的修改。特别是以下几个关键点等待队列接口的变化新内核中wait_queue_t类型已被移除函数返回类型的严格检查write_room和chars_in_buffer需要返回unsigned int必要的头文件包含如linux/sched/signal.h幸运的是我们从GitHub克隆的源码已经包含了这些修改。如果使用原始的驱动包则需要手动应用这些补丁。编译驱动只需执行make编译过程中终端会输出详细的构建信息。在ARM设备上这个过程可能会比x86平台稍慢一些特别是使用树莓派Zero等性能较低的设备时。如果编译成功当前目录下会生成ch34x.ko文件这就是我们需要的内核模块。3. 驱动安装与设备识别编译成功后接下来就是安装驱动并让系统识别CH340设备。安装过程分为几个步骤sudo make install sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial sudo depmod -a sudo modprobe ch34x这些命令的作用分别是安装模块、复制模块到标准驱动目录、更新模块依赖关系最后加载模块。为了验证驱动是否加载成功可以检查内核日志dmesg | grep ch34x如果一切正常你会看到类似以下的输出[ 12.345678] usbserial: USB Serial support registered for ch34x [ 12.345679] ch34x 1-1.2:1.0: ch34x converter detected [ 12.345987] usb 1-1.2: ch34x converter now attached to ttyUSB0现在插入CH340 USB转串口模块使用lsusb命令检查设备是否被识别lsusb | grep 1a86正确的输出应该显示类似这样的信息Bus 001 Device 004: ID 1a86:7523 QinHeng Electronics CH340 serial converter设备节点通常会被创建为/dev/ttyUSB0如果有多个串口设备可能是ttyUSB1等。为了确保普通用户也有权限访问串口设备我们需要将用户加入dialout组sudo usermod -a -G dialout $USER注意这个修改需要重新登录才能生效。如果不执行这一步后续的串口测试可能会遇到权限拒绝的错误。4. 串口测试与实战应用驱动安装成功后我们需要验证串口通信是否正常工作。这里介绍两种常用的测试方法回环测试和实际设备通信。4.1 回环测试回环测试是最基本的验证方法它不需要额外的硬件只需将CH340模块的TX和RX引脚短接即可。首先安装串口调试工具sudo apt install -y minicom然后配置minicom连接到CH340设备minicom -D /dev/ttyUSB0 -b 9600在minicom界面中开启本地回显按CtrlA然后按E然后输入任意字符。如果看到输入的字符回显说明串口通信正常。这是因为发送的数据(TX)被直接传送到接收端(RX)形成了一个完整的回路。4.2 与Arduino/ESP32通信在实际项目中我们更多是需要与各种开发板通信。以Arduino为例连接方式如下CH340的TX接Arduino的RXCH340的RX接Arduino的TXCH340的GND接Arduino的GND重要提示千万不要将VCC引脚随意连接特别是当开发板已经有独立供电时。这可能会导致电流倒灌损坏设备。安装必要的串口工具sudo apt install -y screen然后使用screen命令与Arduino建立连接screen /dev/ttyUSB0 115200如果Arduino端已经烧录了串口回显程序那么在这个终端中输入字符应该能看到Arduino的回复。要退出screen会话按CtrlA然后按K最后按Y确认。4.3 常见问题排查在实际使用中可能会遇到各种问题。下面列出了一些常见情况及其解决方法问题现象可能原因解决方案设备节点/dev/ttyUSB0不存在驱动未加载或设备未识别检查dmesg输出确认驱动加载成功权限拒绝错误用户不在dialout组将用户加入dialout组并重新登录通信数据乱码波特率不匹配确保两端使用相同的波特率间歇性通信中断电源不稳定或接触不良检查连接线确保供电充足对于更复杂的应用场景如同时使用多个CH340设备系统可能会将它们识别为ttyUSB0、ttyUSB1等。为了保持设备名称的持久性可以创建udev规则。例如创建一个名为/etc/udev/rules.d/99-ch340.rules的文件内容如下SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH340_%n然后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger这样每个CH340设备除了标准的ttyUSBx名称外还会有一个持久的ttyCH340_x别名方便脚本和设备管理。5. 性能优化与高级配置当CH340驱动正常工作后我们还可以进行一些优化配置提升串口通信的稳定性和性能。特别是对于需要高速或长时间稳定通信的应用场景这些调整尤为重要。5.1 调整串口缓冲区大小默认的串口缓冲区大小可能不适合高吞吐量应用。我们可以通过修改sysfs中的参数来调整echo 2048 | sudo tee /sys/bus/usb-serial/devices/ttyUSB0/latency_timer这个命令将缓冲区大小设置为2048字节最大值。要永久生效可以创建一个systemd服务或在rc.local中添加这个命令。5.2 禁用串口控制台服务在某些Linux发行版中串口可能被控制台服务占用导致应用程序无法访问。禁用相关服务可以解决这个问题sudo systemctl stop serial-gettyttyUSB0.service sudo systemctl disable serial-gettyttyUSB0.service5.3 使用硬件流控制对于长距离或高干扰环境下的通信启用硬件流控制RTS/CTS可以提高稳定性。在minicom或类似的终端程序中需要明确启用这个选项。在代码中使用串口时也要正确配置termios结构体struct termios options; tcgetattr(fd, options); options.c_cflag | CRTSCTS; // 启用硬件流控制 tcsetattr(fd, TCSANOW, options);5.4 自动重连机制在实际应用中USB设备可能会因为各种原因暂时断开。实现一个自动重连机制可以大大提高系统的健壮性。以下是一个简单的bash脚本示例#!/bin/bash while true; do if [ ! -c /dev/ttyUSB0 ]; then echo Device disconnected, waiting... while [ ! -c /dev/ttyUSB0 ]; do sleep 1 done echo Device reconnected, reloading driver... sudo modprobe -r ch34x sudo modprobe ch34x fi sleep 5 done这个脚本会每隔5秒检查一次设备是否存在如果发现设备断开它会等待设备重新连接后重新加载驱动模块。6. 跨平台兼容性考虑虽然本文主要关注Ubuntu 22.04和树莓派/香橙派平台但CH340模块在其他Linux发行版和平台上的使用也值得讨论。不同平台可能会遇到不同的问题需要有针对性的解决方案。6.1 不同Linux发行版的差异发行版特点注意事项Raspberry Pi OS针对树莓派优化内核更新频繁需确认头文件版本Ubuntu/Debian软件包丰富使用apt管理依赖关系Arch Linux滚动更新可能需要手动解决最新内核的兼容问题CentOS/RHEL长期支持版本内核版本较旧可能需要降级驱动6.2 内核版本兼容性矩阵CH340驱动在不同内核版本下的表现有所差异。以下是已知的兼容性情况内核版本兼容性所需修改 4.0良好无4.0-5.4需要小修改更新等待队列接口5.5-5.14需要较多修改调整函数返回类型≥5.15需要最新驱动使用GitHub上的维护版本6.3 容器化环境中的使用在Docker等容器环境中使用CH340设备需要特别注意设备映射和权限问题。以下是一个docker-compose.yml示例展示了如何正确暴露串口设备给容器version: 3 services: serial-app: build: . devices: - /dev/ttyUSB0:/dev/ttyUSB0 volumes: - /dev/bus/usb:/dev/bus/usb group_add: - dialout这个配置确保了容器内能够访问宿主机的USB设备和串口节点并且拥有正确的权限。
树莓派/香橙派玩转CH340串口模块：Ubuntu 22.04下驱动编译与测试全记录
树莓派/香橙派玩转CH340串口模块Ubuntu 22.04下驱动编译与测试全记录在嵌入式开发和创客项目中串口通信是最基础也最常用的硬件交互方式之一。无论是连接Arduino进行固件烧录还是与ESP32模块进行调试通信CH340系列USB转串口芯片因其出色的性价比和稳定性成为了众多开发者的首选。然而当我们将目光投向树莓派、香橙派等流行的单板计算机时特别是在较新的Ubuntu 22.04 LTS或Raspberry Pi OS系统上CH340驱动的安装往往会遇到一些特有的挑战。不同于传统的x86架构PCARM架构的单板计算机在驱动编译和内核模块加载上有着自己的特点。加之Ubuntu 22.04采用了较新的Linux内核版本官方提供的CH340驱动源码可能需要一些针对性的修改才能顺利编译。本文将带领大家一步步解决这些问题从驱动源码的获取、修改、编译到最终的硬件连接和功能测试形成一个完整的解决方案。我们不仅会关注技术细节的实现还会分享在实际项目中积累的宝贵经验帮助开发者避开那些容易导致失败的坑。1. 环境准备与驱动源码获取在开始之前我们需要确保开发环境已经准备就绪。对于使用树莓派或香橙派的开发者来说建议使用最新的Raspberry Pi OS基于Debian 11或Ubuntu 22.04 LTS系统。这些系统不仅提供了长期支持还包含了大多数开发所需的工具链。首先我们需要安装一些基础的开发工具和内核头文件。打开终端执行以下命令sudo apt update sudo apt install -y build-essential git linux-headers-$(uname -r)这些命令会更新软件包列表并安装编译驱动所需的工具链和当前运行内核对应的头文件。值得注意的是在ARM架构的设备上某些软件包的名称或依赖关系可能与x86平台略有不同这也是为什么我们需要特别强调系统环境的原因。接下来获取CH340的驱动源码。虽然沁恒微电子官网上提供了驱动下载但为了确保我们使用的是最新版本可以直接从官方GitHub仓库获取git clone https://github.com/juliagoda/CH341SER cd CH341SER这个仓库维护了针对新内核的CH340驱动修改版本相比官网提供的驱动包它已经包含了对新内核的适配补丁可以大大减少我们手动修改的工作量。2. 驱动编译与内核适配在ARM架构的设备上编译内核模块有几个关键点需要特别注意。首先我们需要确认当前运行的内核版本与安装的内核头文件是否匹配。执行以下命令检查uname -r ls /usr/src/linux-headers-$(uname -r)如果两者不匹配可能会导致编译后的模块无法加载。这种情况在频繁更新系统的树莓派上较为常见。解决方法要么是更新系统到最新版本要么是安装与当前运行内核对应的头文件包。进入驱动源码目录后我们可以先查看Makefile文件确保它已经针对ARM架构做了适当配置。一个典型的Makefile内容如下obj-m : ch34x.o KDIR : /lib/modules/$(shell uname -r)/build PWD : $(shell pwd) all: $(MAKE) -C $(KDIR) M$(PWD) modules clean: $(MAKE) -C $(KDIR) M$(PWD) clean对于较新的内核版本5.15及以上驱动源码可能还需要一些额外的修改。特别是以下几个关键点等待队列接口的变化新内核中wait_queue_t类型已被移除函数返回类型的严格检查write_room和chars_in_buffer需要返回unsigned int必要的头文件包含如linux/sched/signal.h幸运的是我们从GitHub克隆的源码已经包含了这些修改。如果使用原始的驱动包则需要手动应用这些补丁。编译驱动只需执行make编译过程中终端会输出详细的构建信息。在ARM设备上这个过程可能会比x86平台稍慢一些特别是使用树莓派Zero等性能较低的设备时。如果编译成功当前目录下会生成ch34x.ko文件这就是我们需要的内核模块。3. 驱动安装与设备识别编译成功后接下来就是安装驱动并让系统识别CH340设备。安装过程分为几个步骤sudo make install sudo cp ch34x.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial sudo depmod -a sudo modprobe ch34x这些命令的作用分别是安装模块、复制模块到标准驱动目录、更新模块依赖关系最后加载模块。为了验证驱动是否加载成功可以检查内核日志dmesg | grep ch34x如果一切正常你会看到类似以下的输出[ 12.345678] usbserial: USB Serial support registered for ch34x [ 12.345679] ch34x 1-1.2:1.0: ch34x converter detected [ 12.345987] usb 1-1.2: ch34x converter now attached to ttyUSB0现在插入CH340 USB转串口模块使用lsusb命令检查设备是否被识别lsusb | grep 1a86正确的输出应该显示类似这样的信息Bus 001 Device 004: ID 1a86:7523 QinHeng Electronics CH340 serial converter设备节点通常会被创建为/dev/ttyUSB0如果有多个串口设备可能是ttyUSB1等。为了确保普通用户也有权限访问串口设备我们需要将用户加入dialout组sudo usermod -a -G dialout $USER注意这个修改需要重新登录才能生效。如果不执行这一步后续的串口测试可能会遇到权限拒绝的错误。4. 串口测试与实战应用驱动安装成功后我们需要验证串口通信是否正常工作。这里介绍两种常用的测试方法回环测试和实际设备通信。4.1 回环测试回环测试是最基本的验证方法它不需要额外的硬件只需将CH340模块的TX和RX引脚短接即可。首先安装串口调试工具sudo apt install -y minicom然后配置minicom连接到CH340设备minicom -D /dev/ttyUSB0 -b 9600在minicom界面中开启本地回显按CtrlA然后按E然后输入任意字符。如果看到输入的字符回显说明串口通信正常。这是因为发送的数据(TX)被直接传送到接收端(RX)形成了一个完整的回路。4.2 与Arduino/ESP32通信在实际项目中我们更多是需要与各种开发板通信。以Arduino为例连接方式如下CH340的TX接Arduino的RXCH340的RX接Arduino的TXCH340的GND接Arduino的GND重要提示千万不要将VCC引脚随意连接特别是当开发板已经有独立供电时。这可能会导致电流倒灌损坏设备。安装必要的串口工具sudo apt install -y screen然后使用screen命令与Arduino建立连接screen /dev/ttyUSB0 115200如果Arduino端已经烧录了串口回显程序那么在这个终端中输入字符应该能看到Arduino的回复。要退出screen会话按CtrlA然后按K最后按Y确认。4.3 常见问题排查在实际使用中可能会遇到各种问题。下面列出了一些常见情况及其解决方法问题现象可能原因解决方案设备节点/dev/ttyUSB0不存在驱动未加载或设备未识别检查dmesg输出确认驱动加载成功权限拒绝错误用户不在dialout组将用户加入dialout组并重新登录通信数据乱码波特率不匹配确保两端使用相同的波特率间歇性通信中断电源不稳定或接触不良检查连接线确保供电充足对于更复杂的应用场景如同时使用多个CH340设备系统可能会将它们识别为ttyUSB0、ttyUSB1等。为了保持设备名称的持久性可以创建udev规则。例如创建一个名为/etc/udev/rules.d/99-ch340.rules的文件内容如下SUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, SYMLINKttyCH340_%n然后重新加载udev规则sudo udevadm control --reload-rules sudo udevadm trigger这样每个CH340设备除了标准的ttyUSBx名称外还会有一个持久的ttyCH340_x别名方便脚本和设备管理。5. 性能优化与高级配置当CH340驱动正常工作后我们还可以进行一些优化配置提升串口通信的稳定性和性能。特别是对于需要高速或长时间稳定通信的应用场景这些调整尤为重要。5.1 调整串口缓冲区大小默认的串口缓冲区大小可能不适合高吞吐量应用。我们可以通过修改sysfs中的参数来调整echo 2048 | sudo tee /sys/bus/usb-serial/devices/ttyUSB0/latency_timer这个命令将缓冲区大小设置为2048字节最大值。要永久生效可以创建一个systemd服务或在rc.local中添加这个命令。5.2 禁用串口控制台服务在某些Linux发行版中串口可能被控制台服务占用导致应用程序无法访问。禁用相关服务可以解决这个问题sudo systemctl stop serial-gettyttyUSB0.service sudo systemctl disable serial-gettyttyUSB0.service5.3 使用硬件流控制对于长距离或高干扰环境下的通信启用硬件流控制RTS/CTS可以提高稳定性。在minicom或类似的终端程序中需要明确启用这个选项。在代码中使用串口时也要正确配置termios结构体struct termios options; tcgetattr(fd, options); options.c_cflag | CRTSCTS; // 启用硬件流控制 tcsetattr(fd, TCSANOW, options);5.4 自动重连机制在实际应用中USB设备可能会因为各种原因暂时断开。实现一个自动重连机制可以大大提高系统的健壮性。以下是一个简单的bash脚本示例#!/bin/bash while true; do if [ ! -c /dev/ttyUSB0 ]; then echo Device disconnected, waiting... while [ ! -c /dev/ttyUSB0 ]; do sleep 1 done echo Device reconnected, reloading driver... sudo modprobe -r ch34x sudo modprobe ch34x fi sleep 5 done这个脚本会每隔5秒检查一次设备是否存在如果发现设备断开它会等待设备重新连接后重新加载驱动模块。6. 跨平台兼容性考虑虽然本文主要关注Ubuntu 22.04和树莓派/香橙派平台但CH340模块在其他Linux发行版和平台上的使用也值得讨论。不同平台可能会遇到不同的问题需要有针对性的解决方案。6.1 不同Linux发行版的差异发行版特点注意事项Raspberry Pi OS针对树莓派优化内核更新频繁需确认头文件版本Ubuntu/Debian软件包丰富使用apt管理依赖关系Arch Linux滚动更新可能需要手动解决最新内核的兼容问题CentOS/RHEL长期支持版本内核版本较旧可能需要降级驱动6.2 内核版本兼容性矩阵CH340驱动在不同内核版本下的表现有所差异。以下是已知的兼容性情况内核版本兼容性所需修改 4.0良好无4.0-5.4需要小修改更新等待队列接口5.5-5.14需要较多修改调整函数返回类型≥5.15需要最新驱动使用GitHub上的维护版本6.3 容器化环境中的使用在Docker等容器环境中使用CH340设备需要特别注意设备映射和权限问题。以下是一个docker-compose.yml示例展示了如何正确暴露串口设备给容器version: 3 services: serial-app: build: . devices: - /dev/ttyUSB0:/dev/ttyUSB0 volumes: - /dev/bus/usb:/dev/bus/usb group_add: - dialout这个配置确保了容器内能够访问宿主机的USB设备和串口节点并且拥有正确的权限。
