树莓派玩转CH340串口驱动：从Linux内核编译到Python脚本通信保姆级教程

张

张建站

2026/4/19 20:22:04

10分钟阅读

树莓派玩转CH340串口驱动从Linux内核编译到Python脚本通信保姆级教程当你手握一块搭载CH340芯片的Arduino开发板准备在树莓派上大展拳脚时是否曾被串口权限问题卡住或是面对内核驱动编译一脸茫然本文将带你从零开始打通CH340在Linux系统下的全链路开发流程。1. CH340驱动在Linux内核中的前世今生CH340作为一款经济高效的USB转串口芯片在开源硬件领域几乎无处不在。但不同于Windows的即插即用Linux系统对这类外设的支持需要更深入的了解。现代Linux内核4.x及以上版本已经内置了CH340驱动模块但某些定制化场景仍需手动编译。检查现有驱动最快捷的方式是使用lsmod命令lsmod | grep ch34如果看到ch341或usbserial相关输出说明驱动已加载。但树莓派默认配置可能未包含这些模块这时就需要我们手动介入。提示不同Linux发行版的内核配置差异较大树莓派官方系统基于Debian定制驱动支持相对完善但某些精简版系统可能需要额外步骤。2. 内核驱动编译实战手册当预编译驱动无法满足需求时从源码构建是最彻底的解决方案。以树莓派OS为例完整流程如下2.1 准备编译环境首先安装必要的开发工具和内核头文件sudo apt update sudo apt install raspberrypi-kernel-headers build-essential git这个步骤会获取当前运行内核对应的头文件确保编译出的驱动模块与内核完美兼容。2.2 获取CH340驱动源码虽然内核已包含标准驱动但厂商提供的版本可能包含额外优化git clone https://github.com/juliagoda/CH341SER cd CH341SER关键文件说明Makefile驱动编译规则ch341.c核心驱动代码readme.txt厂商特定说明2.3 编译与安装执行编译前需要确认内核版本匹配uname -r然后调整Makefile中的KERNELDIR路径指向/lib/modules/$(uname -r)/build。编译命令很简单make成功后会生成ch341.ko文件这是可加载的内核模块。安装步骤sudo make install sudo depmod -a sudo modprobe ch341验证驱动加载状态dmesg | tail -n 20应该能看到类似ch341-uart converter detected的日志条目。3. 串口权限管理与持久化配置驱动就位后设备通常会出现在/dev/ttyUSB*路径下。但普通用户默认没有访问权限这会导致Python脚本运行时出现Permission denied错误。3.1 临时解决方案最直接的方式是使用chmodsudo chmod 666 /dev/ttyUSB0但这种方法在设备重插后会失效不是长久之计。3.2 udev规则配置专业的做法是通过udev规则永久设置权限。创建文件/etc/udev/rules.d/99-ch340.rulesSUBSYSTEMtty, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, MODE0666参数说明idVendor和idProductCH340的USB标识符MODE0666赋予所有用户读写权限应用新规则sudo udevadm control --reload-rules sudo udevadm trigger现在无论设备如何插拔权限都会自动配置妥当。4. Python串口通信全攻略有了稳定的驱动和正确的权限就可以用Python大显身手了。pyserial库是处理串口通信的瑞士军刀。4.1 环境准备安装必备库pip install pyserial基础通信示例import serial ser serial.Serial( port/dev/ttyUSB0, baudrate9600, parityserial.PARITY_NONE, stopbitsserial.STOPBITS_ONE, bytesizeserial.EIGHTBITS, timeout1 ) try: while True: if ser.in_waiting: line ser.readline().decode(utf-8).rstrip() print(fReceived: {line}) command input(Send to device (q to quit): ) if command q: break ser.write(f{command}\n.encode(utf-8)) finally: ser.close()4.2 高级技巧超时处理是串口编程的关键点。下面的代码展示了更健壮的实现from serial.tools import list_ports def find_ch340(): for port in list_ports.comports(): if port.vid 0x1A86 and port.pid 0x7523: return port.device return None ch340_port find_ch340() if ch340_port: print(fFound CH340 at {ch340_port}) else: print(CH340 device not detected)数据帧解析是另一个常见需求。假设设备发送JSON格式数据import json def parse_frame(data): try: return json.loads(data) except json.JSONDecodeError: print(fInvalid frame: {data}) return None5. 故障排查与性能优化即使按照步骤操作实际项目中仍可能遇到各种问题。以下是几个典型场景的解决方案。5.1 常见错误代码解析错误现象可能原因解决方案[Errno 2] No such file or directory设备节点不存在检查USB连接确认驱动加载[Errno 13] Permission denied用户权限不足配置udev规则或用户组数据乱码波特率不匹配确认设备与代码设置一致随机断开供电不足使用带电源的USB Hub5.2 内核参数调优对于高负载场景可以调整内核缓冲参数sudo sysctl -w kernel.printk4 4 1 7 sudo sysctl -w usbcore.usbfs_memory_mb1000这些设置会调整内核日志级别增加USB子系统内存分配5.3 实时性优化如果对延迟敏感可以考虑以下手段ser serial.Serial() ser.baudrate 115200 ser.rtscts True # 启用硬件流控 ser.dsrdtr True ser.xonxoff False配合内核实时补丁可以显著提升响应速度sudo apt install linux-image-rt-rpi-v76. 项目实战环境监测系统将所学知识融会贯通我们构建一个完整的物联网监测系统。硬件组成树莓派4B作为主控CH340转换的Arduino采集终端DHT22温湿度传感器MQ-135空气质量传感器数据采集端(Arduino)代码#include SoftwareSerial.h SoftwareSerial ch340(10, 11); // RX, TX void setup() { ch340.begin(9600); Serial.begin(9600); } void loop() { float temp readDHT22(); int air readMQ135(); ch340.print({\temp\:); ch340.print(temp); ch340.print(,\air\:); ch340.print(air); ch340.println(}); delay(2000); }数据处理端(Python)代码import serial from influxdb import InfluxDBClient db InfluxDBClient(hostlocalhost, port8086) db.switch_database(environment) ser serial.Serial(/dev/ttyUSB0, 9600, timeout1) while True: try: line ser.readline().decode().strip() if line: data parse_frame(line) if data: json_body [{ measurement: room_status, fields: { temperature: data[temp], air_quality: data[air] } }] db.write_points(json_body) except KeyboardInterrupt: break系统架构示意图Arduino通过CH340转换器与树莓派通信Python程序解析JSON数据结果存入InfluxDB时序数据库Grafana可视化展示7. 扩展应用多设备管理与负载均衡当需要连接多个CH340设备时管理策略就变得尤为重要。以下是几种实用方案方案对比表方案优点缺点适用场景多USB接口简单直接占用USB资源设备数量4USB Hub扩展节省主机接口需要优质Hub中等规模部署串口服务器专业稳定成本较高工业环境无线转换布线自由延迟较高移动设备Python多端口监控示例import serial from threading import Thread def monitor_port(port): with serial.Serial(port, 9600) as ser: while True: data ser.readline() print(f{port}: {data.decode().strip()}) ports [/dev/ttyUSB0, /dev/ttyUSB1] threads [] for port in ports: t Thread(targetmonitor_port, args(port,)) t.daemon True t.start() threads.append(t) for t in threads: t.join()在实际部署中我发现使用asyncio可以更高效地管理多个串口import asyncio import serial_asyncio async def create_reader(port): reader, _ await serial_asyncio.open_serial_connection( urlport, baudrate9600) while True: data await reader.readline() print(f{port}: {data.decode().strip()}) ports [/dev/ttyUSB0, /dev/ttyUSB1] loop asyncio.get_event_loop() tasks [create_reader(port) for port in ports] loop.run_until_complete(asyncio.wait(tasks)) loop.close()