简介PCI转串口卡驱动程序合集面向台式机与工控设备维护人员、串口通信开发者及需要扩展RS-232/RS-485/RS-422接口的用户用于解决操作系统无法识别、资源分配异常或通信不稳定等问题。包内针对Y-7503、Y-7504、Y-7505、Y-7509、Y-7507等型号整理了驱动安装程序、sys驱动核心、inf配置、cat签名、dll组件及pdf/chm说明文档并附静默安装与卸载脚本、串口参数配置和诊断工具便于按硬件型号匹配版本、完成端口与中断配置。压缩包共828个文件约32.11MB目录按型号与平台分层检索和部署都较直观。已有895人学习下载可作为设备识别、波特率与数据位设置、多串口并发通信及常见超时校验错误排查的参考。包内还可见系统日志与诊断文件、多语言说明和批处理脚本能辅助定位旧驱动残留、资源冲突与设备枚举失败等问题同时保留了Linux平台相关源码与构建文件适合需要兼顾Windows与Linux环境的读者查阅。1. 一块 PCI 转串口卡插上去只认到未知设备这份驱动补的是哪一环工控机主板越做越薄串口往往最先被取消而现场那台设备还等着 RS-232 电平。插一块 PCI 转串口卡是最省事的办法可真到驱动这一层就开始卡壳lspci能看到设备/dev/ttyS*纹丝不动dmesg里一句 unknown PCI device 就把人打发了。这套 PCI 串口驱动要补的就是这一环——它不是双击即装的安装包而是以 8250 框架为底座的一套内核模块源码配编译脚本和自环测试工具把非标桥片的 BAR 布局、中断分配、uartclk三件事对齐。适合手上有一批老卡要维护、内核升级后串口集体失踪、又不想动内核源码树重建整颗内核的运维和嵌入式工程师。2. 从 PCI 配置空间到 /dev/ttyS*驱动骨架怎么搭才不返工把卡跑起来绕不开一个选择改内核源码树里的8250_pci.c加一条 ID还是写独立模块自己注册uart_port。前者干净坏处是每次内核小版本升级都得重新打补丁、重编整颗内核现场机器还不能随便换内核后者多写两百来行换来的是insmod/rmmod秒级迭代。我一般选后者尤其是设备已经装机、只能远程操作的环境。2.1 三层结构pci_driver 认设备、uart_port 管寄存器、tty 层出节点这三个层次分工很硬混在一起写就是自找麻烦。PCI 总线层负责在id_table里匹配厂商号/设备号/子系统号匹配上了才调probe这一层只干两件事抢资源、把硬件点亮。串口核心层拿一个struct uart_port8250 系用struct uart_8250_port包一层里面描述寄存器在哪、时钟多少、中断几号、FIFO 多深然后交给serial8250_register_8250_port()挂到 8250 框架上。tty 层才最终生成/dev/ttyS4这种节点波特率、流控、termios全由核心层接管。选 8250 框架而不是从零写一套uart_ops理由很实际16550 兼容寄存器的中断处理顺序、FIFO 读取时机、break 与 framing error 的清除内核里那套代码被几十种芯片磨了二十多年。自己重写 ISR 的结局通常是系统负载莫名飙到几十dmesg刷nobody cared。只有在寄存器布局非标——比如寄存器间隔 4 字节、必须先写全局使能寄存器才能访问通道——才值得自己填uart_ops。struct uart_port里几个字段填错症状各不相同先记这张表后面排查能省一半时间字段正确填法填错后的典型症状iotypeIO 空间用UPIO_PORT内存映射用UPIO_MEM32读 LSR 恒为 0xFF 或 0x00读写返回 -EIOiobase/mapbaseBAR1 起始地址 口序号 × 步长只认到一个口或几个口互相串数据uartclk板上晶振真实频率波特率整体偏移速率越高错得越离谱irqpci_irq_vector()返回值能发不能收收几个字节后彻底卡死fifosize芯片手册写的真实深度高速率下随机丢字节低速一切正常typePORT_16550A或PORT_16550FIFO 被当成不存在吞吐直接砍半2.2 probe 里必须拿到的四样东西BAR、IRQ、时钟、口数probe是整个驱动最容易翻车的地方因为它要一次性把四件事办对任何一件错位后面全是玄学问题。顺序也有讲究先pci_enable_device()打开 IO/MEM 空间再pci_request_regions()独占 BAR否则别的驱动甚至8250_pci自己可能已经把那块地址圈走了。中断用pci_alloc_irq_vectors()申请PCI_IRQ_ALL_TYPES表示 MSI、MSI-X、INTx 都行能拿到哪个算哪个。/* my_pci_serial.c —— 驱动骨架节选 */ #include linux/module.h #include linux/pci.h #include linux/serial_8250.h #include linux/serial_reg.h #define MY_VENDOR 0x1234 /* 占位用 lspci -nn 查到的真实 ID 替换 */ #define MY_DEVICE 0x5678 struct my_card { struct pci_dev *pdev; int nr_ports; int line[8]; /* 每口注册成功后返回的 ttyS 编号 */ unsigned long iobase; }; static int my_serial_probe(struct pci_dev *pdev, const struct pci_device_id *id) { struct my_card *card; struct uart_8250_port up; int ret, i; card devm_kzalloc(pdev-dev, sizeof(*card), GFP_KERNEL); if (!card) return -ENOMEM; card-pdev pdev; ret pci_enable_device(pdev); /* 打开 IO/MEM 空间 */ if (ret) return ret; ret pci_request_regions(pdev, KBUILD_MODNAME); /* 独占 BAR防别人抢 */ if (ret) goto err_disable; /* 常见布局BAR0 是卡级寄存器BAR1 起才是 16550 窗口每口间隔 8 字节 */ card-iobase pci_resource_start(pdev, 1); card-nr_ports (int)(pdev-subsystem_device 0x0f); /* 按卡的实际约定 */ ret pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_ALL_TYPES); if (ret 0) goto err_regions; for (i 0; i card-nr_ports; i) { memset(up, 0, sizeof(up)); up.port.iotype UPIO_PORT; /* 内存映射卡改成 UPIO_MEM32 */ up.port.iobase card-iobase i * 8; up.port.mapbase up.port.iobase; up.port.uartclk 14745600; /* 按板上晶振填见 4.1 */ up.port.irq pci_irq_vector(pdev, 0); up.port.dev pdev-dev; up.port.flags UPF_SHARE_IRQ | UPF_FIXED_TYPE; up.port.type PORT_16550A; up.port.fifosize 16; /* 按手册填不要默认 64 */ up.capabilities UART_CAP_FIFO; ret serial8250_register_8250_port(up); if (ret 0) goto err_ports; card-line[i] ret; } pci_set_drvdata(pdev, card); return 0; err_ports: while (--i 0) serial8250_unregister_port(card-line[i]); pci_free_irq_vectors(pdev); err_regions: pci_release_regions(pdev); err_disable: pci_disable_device(pdev); return ret; }几个参数值得单独说。UPF_SHARE_IRQ在 INTx 模式下必须带上因为 PCI 中断线天生是共享的不带这个标志内核会拒绝注册UPF_FIXED_TYPE告诉核心层别自作聪明去探测芯片型号卡上就是 16550A探测反而会把寄存器写乱。nr_ports的取法各家不一样有的是靠子系统 ID 低四位编码有的要读 BAR0 的全局寄存器我见过最省事的做法是直接写死在id_table的driver_data里一张卡一个数稳。serial8250_register_8250_port()返回的是分配到的 tty 编号比如 4 代表/dev/ttyS4这个值必须存下来卸载时原样传给serial8250_unregister_port()。忘了存、或者卸载顺序反了rmmod就会卡住不动。2.3 id_table 与 remove匹配写细卸载才不会漏匹配表用PCI_DEVICE还是PCI_DEVICE_SUB直接决定这张卡会不会被内核自带驱动先抢走。同一个桥片做出来的 4 口卡和 8 口卡厂商号设备号往往完全一样只有子系统 ID 不同这种情况必须用PCI_DEVICE_SUB精确到子系统否则两版卡共用一个配置口数永远对不上。static const struct pci_device_id my_serial_ids[] { /* 精确到子系统 ID同一颗桥片4 口和 8 口的 SSID 不一样 */ { PCI_DEVICE_SUB(MY_VENDOR, MY_DEVICE, 0x1234, 0x0004), .driver_data 4 }, { PCI_DEVICE_SUB(MY_VENDOR, MY_DEVICE, 0x1234, 0x0008), .driver_data 8 }, { } }; MODULE_DEVICE_TABLE(pci, my_serial_ids); static void my_serial_remove(struct pci_dev *pdev) { struct my_card *card pci_get_drvdata(pdev); int i; /* 顺序不能反先摘端口再还中断和 BAR */ for (i 0; i card-nr_ports; i) if (card-line[i] 0) serial8250_unregister_port(card-line[i]); pci_free_irq_vectors(pdev); pci_release_regions(pdev); pci_disable_device(pdev); } static struct pci_driver my_serial_driver { .name my_pci_serial, .id_table my_serial_ids, .probe my_serial_probe, .remove my_serial_remove, }; module_pci_driver(my_serial_driver); MODULE_LICENSE(GPL);MODULE_DEVICE_TABLE不能省它生成模块别名信息modprobe靠这个在设备插入时按需加载模块少了它只能手动insmod做进量产镜像后无人值守场景就露馅了。remove里用pci_get_drvdata取回自己的结构体说明probe里必须pci_set_drvdata这一对是配套的。另外注意module_pci_driver宏已经帮你写了 init/exit别再手写一份module_init重复定义会编译报错。3. 编译、加载与自环验证一份能照着敲的命令链源码包能编译通过和驱动能在目标机上跑起来是两回事。前一步失败多半是内核头文件版本对不上后一步失败基本都写在dmesg里只是没人从头翻。这一章按现场操作顺序走一遍每一步都给出判断依据别只看命令有没有报错。3.1 内核头文件对齐编译前先确认三件事外编模块最容易踩的坑是头文件对不上。/lib/modules/$(uname -r)/build必须指向一套和当前运行内核完全同版本的头文件版本号差一位编译出来的.ko加载时就会报version magic不匹配或者更隐蔽地加载成功但结构体偏移错位跑着跑着就崩。uname -r # 先记住这个版本号 ls -l /lib/modules/$(uname -r)/build # 必须是软链接不能是空目录 test -f /lib/modules/$(uname -r)/build/include/linux/pci.h echo headers ok modinfo -F vermagic /lib/modules/$(uname -r)/kernel/drivers/tty/serial/8250/8250_pci.ko第一条命令拿到运行版本第二条确认头文件在第三条抽查pci.h是否存在有的精简系统只装了部分头文件第四条读出内核自带模块的vermagic字符串跟自己编译出来的对比一下最稳妥。头文件缺了就装同名版本的内核头文件包别图省事装个 meta 包让它自动装最新版——那样十有八九和运行内核不是一个版本。# Makefile obj-m my_pci_serial.o KDIR ? /lib/modules/$(shell uname -r)/build all: $(MAKE) -C $(KDIR) M$(PWD) modules clean: $(MAKE) -C $(KDIR) M$(PWD) cleanM$(PWD)表示只编当前目录下的模块不碰内核树其他部分所以不需要make modules_install也不会污染系统。KDIR留成?是有意的交叉编译时直接用make KDIR/path/to/target/kernel ARCHarm64 CROSS_COMPILEaarch64-linux-gnu-覆盖不用改 Makefile。3.2 加载与看日志dmesg 里该出现哪几行insmod返回 0 不代表成功只能说明模块初始化函数没返回负值probe到底跑没跑、跑了几个口全在dmesg里。加载完立刻看尾部几十行重点找ttyS编号和 8250 框架打印的端口信息。make -j$(nproc) sudo insmod ./my_pci_serial.ko dmesg | tail -30 lspci -nn -d 1234:5678 -vv | grep -E Region|Interrupt|Subsystem ls -l /sys/class/tty/ttyS4/device/driver # 软链指向 my_pci_serial 才算绑定成功 cat /proc/tty/driver/serial | grep -E ^[0-9]:/sys/class/tty/ttyS4/device/driver这条软链是最快的判据指向my_pci_serial说明是你的模块注册的指向serial8250说明被内核自带驱动接管了压根不存在说明probe没跑或者中途失败。/proc/tty/driver/serial里能看到uart:16550A port:0000XXXX irq:16这样的行port值和lspci里的 Region 1 起始地址对得上才算地址映射正确对不上就是 BAR 序号取错了。部分内核没开这个 proc 接口那就退回去看dmesg。3.3 自环测试把 TX/RX 短接用 stty dd 验链路没有外设的时候最直接的验证办法是把 DB9 的 2 脚RX和 3 脚TX短接做成自环。写进去什么就该读回什么一个字节都不能差。这个方法能把地址映射、中断、FIFO、波特率四件事一次性验完比接一台真设备省事得多。PORT/dev/ttyS4 stty -F $PORT 921600 cs8 -cstopb -parenb -crtscts raw -echo head -c 4096 /dev/urandom /tmp/tx.bin cat /tmp/tx.bin $PORT timeout 3 dd if$PORT of/tmp/rx.bin bs4096 count1 2/dev/null cmp /tmp/tx.bin /tmp/rx.bin echo OK: 4096 字节全等 || echo FAIL: 丢字节或错位stty这行参数逐个解释cs8八位数据-cstopb一位停止位-parenb无校验-crtscts关硬件流控自环时 RTS/CTS 没有对端开着就发不出去raw关掉行规程的字符转换-echo防止回显把自己的数据混进来。读端必须先起cat丢到后台再往串口写顺序反了会因为 FIFO 溢出丢掉开头几个字节看起来像驱动有问题其实是测试方法不对。测试项建议值判断标准115200 自环 4096 字节全等基础链路通921600 自环 4096 字节全等uartclk填对FIFO 深度正确921600 连续 10 分钟无错位中断处理无丢帧拔插三次后重载模块编号不漂、无残留remove路径干净低速通、高速不通九成是uartclk或 FIFO 深度的问题别急着怀疑硬件高速通、长时间跑才出错往中断和 FIFO 阈值上找。4. 波特率、FIFO 与 RS-485四个决定稳不稳的参数前面几步把设备跑起来接下来是让它长期稳定运行。串口驱动出问题很少是完全不能用绝大多数是偶尔丢一个字节这类问题在办公室里复现不了到现场就是事故。下面这几个参数是分水岭。4.1 uartclk 与分频系数波特率误差是怎么算出来的8250 系的分频公式是divisor uartclk / (16 × baud)divisor必须是正整数部分芯片支持小数分频但那是加分项不是标配。这个公式决定了uartclk填错之后不是速率不准一点而是成倍偏移。板上晶振常见 1.8432MHz、7.3728MHz、14.7456MHz、24MHz 几种很多卡片为了省成本用 1.8432MHz结果就是最高只能跑到 115200。uartclk115200 分频921600 分频实际可达到的上限184320010.125无效115200737280040.5无效11520014745600819216002400000013误差 0.本文还有配套的精品资源点击获取 
长河君 · 2026/11/4 23:27:22 · 阅读 1.2k Linux PCI转串口驱动：8250内核模块、编译加载与自环验证
简介PCI转串口卡驱动程序合集面向台式机与工控设备维护人员、串口通信开发者及需要扩展RS-232/RS-485/RS-422接口的用户用于解决操作系统无法识别、资源分配异常或通信不稳定等问题。包内针对Y-7503、Y-7504、Y-7505、Y-7509、Y-7507等型号整理了驱动安装程序、sys驱动核心、inf配置、cat签名、dll组件及pdf/chm说明文档并附静默安装与卸载脚本、串口参数配置和诊断工具便于按硬件型号匹配版本、完成端口与中断配置。压缩包共828个文件约32.11MB目录按型号与平台分层检索和部署都较直观。已有895人学习下载可作为设备识别、波特率与数据位设置、多串口并发通信及常见超时校验错误排查的参考。包内还可见系统日志与诊断文件、多语言说明和批处理脚本能辅助定位旧驱动残留、资源冲突与设备枚举失败等问题同时保留了Linux平台相关源码与构建文件适合需要兼顾Windows与Linux环境的读者查阅。1. 一块 PCI 转串口卡插上去只认到未知设备这份驱动补的是哪一环工控机主板越做越薄串口往往最先被取消而现场那台设备还等着 RS-232 电平。插一块 PCI 转串口卡是最省事的办法可真到驱动这一层就开始卡壳lspci能看到设备/dev/ttyS*纹丝不动dmesg里一句 unknown PCI device 就把人打发了。这套 PCI 串口驱动要补的就是这一环——它不是双击即装的安装包而是以 8250 框架为底座的一套内核模块源码配编译脚本和自环测试工具把非标桥片的 BAR 布局、中断分配、uartclk三件事对齐。适合手上有一批老卡要维护、内核升级后串口集体失踪、又不想动内核源码树重建整颗内核的运维和嵌入式工程师。2. 从 PCI 配置空间到 /dev/ttyS*驱动骨架怎么搭才不返工把卡跑起来绕不开一个选择改内核源码树里的8250_pci.c加一条 ID还是写独立模块自己注册uart_port。前者干净坏处是每次内核小版本升级都得重新打补丁、重编整颗内核现场机器还不能随便换内核后者多写两百来行换来的是insmod/rmmod秒级迭代。我一般选后者尤其是设备已经装机、只能远程操作的环境。2.1 三层结构pci_driver 认设备、uart_port 管寄存器、tty 层出节点这三个层次分工很硬混在一起写就是自找麻烦。PCI 总线层负责在id_table里匹配厂商号/设备号/子系统号匹配上了才调probe这一层只干两件事抢资源、把硬件点亮。串口核心层拿一个struct uart_port8250 系用struct uart_8250_port包一层里面描述寄存器在哪、时钟多少、中断几号、FIFO 多深然后交给serial8250_register_8250_port()挂到 8250 框架上。tty 层才最终生成/dev/ttyS4这种节点波特率、流控、termios全由核心层接管。选 8250 框架而不是从零写一套uart_ops理由很实际16550 兼容寄存器的中断处理顺序、FIFO 读取时机、break 与 framing error 的清除内核里那套代码被几十种芯片磨了二十多年。自己重写 ISR 的结局通常是系统负载莫名飙到几十dmesg刷nobody cared。只有在寄存器布局非标——比如寄存器间隔 4 字节、必须先写全局使能寄存器才能访问通道——才值得自己填uart_ops。struct uart_port里几个字段填错症状各不相同先记这张表后面排查能省一半时间字段正确填法填错后的典型症状iotypeIO 空间用UPIO_PORT内存映射用UPIO_MEM32读 LSR 恒为 0xFF 或 0x00读写返回 -EIOiobase/mapbaseBAR1 起始地址 口序号 × 步长只认到一个口或几个口互相串数据uartclk板上晶振真实频率波特率整体偏移速率越高错得越离谱irqpci_irq_vector()返回值能发不能收收几个字节后彻底卡死fifosize芯片手册写的真实深度高速率下随机丢字节低速一切正常typePORT_16550A或PORT_16550FIFO 被当成不存在吞吐直接砍半2.2 probe 里必须拿到的四样东西BAR、IRQ、时钟、口数probe是整个驱动最容易翻车的地方因为它要一次性把四件事办对任何一件错位后面全是玄学问题。顺序也有讲究先pci_enable_device()打开 IO/MEM 空间再pci_request_regions()独占 BAR否则别的驱动甚至8250_pci自己可能已经把那块地址圈走了。中断用pci_alloc_irq_vectors()申请PCI_IRQ_ALL_TYPES表示 MSI、MSI-X、INTx 都行能拿到哪个算哪个。/* my_pci_serial.c —— 驱动骨架节选 */ #include linux/module.h #include linux/pci.h #include linux/serial_8250.h #include linux/serial_reg.h #define MY_VENDOR 0x1234 /* 占位用 lspci -nn 查到的真实 ID 替换 */ #define MY_DEVICE 0x5678 struct my_card { struct pci_dev *pdev; int nr_ports; int line[8]; /* 每口注册成功后返回的 ttyS 编号 */ unsigned long iobase; }; static int my_serial_probe(struct pci_dev *pdev, const struct pci_device_id *id) { struct my_card *card; struct uart_8250_port up; int ret, i; card devm_kzalloc(pdev-dev, sizeof(*card), GFP_KERNEL); if (!card) return -ENOMEM; card-pdev pdev; ret pci_enable_device(pdev); /* 打开 IO/MEM 空间 */ if (ret) return ret; ret pci_request_regions(pdev, KBUILD_MODNAME); /* 独占 BAR防别人抢 */ if (ret) goto err_disable; /* 常见布局BAR0 是卡级寄存器BAR1 起才是 16550 窗口每口间隔 8 字节 */ card-iobase pci_resource_start(pdev, 1); card-nr_ports (int)(pdev-subsystem_device 0x0f); /* 按卡的实际约定 */ ret pci_alloc_irq_vectors(pdev, 1, 1, PCI_IRQ_ALL_TYPES); if (ret 0) goto err_regions; for (i 0; i card-nr_ports; i) { memset(up, 0, sizeof(up)); up.port.iotype UPIO_PORT; /* 内存映射卡改成 UPIO_MEM32 */ up.port.iobase card-iobase i * 8; up.port.mapbase up.port.iobase; up.port.uartclk 14745600; /* 按板上晶振填见 4.1 */ up.port.irq pci_irq_vector(pdev, 0); up.port.dev pdev-dev; up.port.flags UPF_SHARE_IRQ | UPF_FIXED_TYPE; up.port.type PORT_16550A; up.port.fifosize 16; /* 按手册填不要默认 64 */ up.capabilities UART_CAP_FIFO; ret serial8250_register_8250_port(up); if (ret 0) goto err_ports; card-line[i] ret; } pci_set_drvdata(pdev, card); return 0; err_ports: while (--i 0) serial8250_unregister_port(card-line[i]); pci_free_irq_vectors(pdev); err_regions: pci_release_regions(pdev); err_disable: pci_disable_device(pdev); return ret; }几个参数值得单独说。UPF_SHARE_IRQ在 INTx 模式下必须带上因为 PCI 中断线天生是共享的不带这个标志内核会拒绝注册UPF_FIXED_TYPE告诉核心层别自作聪明去探测芯片型号卡上就是 16550A探测反而会把寄存器写乱。nr_ports的取法各家不一样有的是靠子系统 ID 低四位编码有的要读 BAR0 的全局寄存器我见过最省事的做法是直接写死在id_table的driver_data里一张卡一个数稳。serial8250_register_8250_port()返回的是分配到的 tty 编号比如 4 代表/dev/ttyS4这个值必须存下来卸载时原样传给serial8250_unregister_port()。忘了存、或者卸载顺序反了rmmod就会卡住不动。2.3 id_table 与 remove匹配写细卸载才不会漏匹配表用PCI_DEVICE还是PCI_DEVICE_SUB直接决定这张卡会不会被内核自带驱动先抢走。同一个桥片做出来的 4 口卡和 8 口卡厂商号设备号往往完全一样只有子系统 ID 不同这种情况必须用PCI_DEVICE_SUB精确到子系统否则两版卡共用一个配置口数永远对不上。static const struct pci_device_id my_serial_ids[] { /* 精确到子系统 ID同一颗桥片4 口和 8 口的 SSID 不一样 */ { PCI_DEVICE_SUB(MY_VENDOR, MY_DEVICE, 0x1234, 0x0004), .driver_data 4 }, { PCI_DEVICE_SUB(MY_VENDOR, MY_DEVICE, 0x1234, 0x0008), .driver_data 8 }, { } }; MODULE_DEVICE_TABLE(pci, my_serial_ids); static void my_serial_remove(struct pci_dev *pdev) { struct my_card *card pci_get_drvdata(pdev); int i; /* 顺序不能反先摘端口再还中断和 BAR */ for (i 0; i card-nr_ports; i) if (card-line[i] 0) serial8250_unregister_port(card-line[i]); pci_free_irq_vectors(pdev); pci_release_regions(pdev); pci_disable_device(pdev); } static struct pci_driver my_serial_driver { .name my_pci_serial, .id_table my_serial_ids, .probe my_serial_probe, .remove my_serial_remove, }; module_pci_driver(my_serial_driver); MODULE_LICENSE(GPL);MODULE_DEVICE_TABLE不能省它生成模块别名信息modprobe靠这个在设备插入时按需加载模块少了它只能手动insmod做进量产镜像后无人值守场景就露馅了。remove里用pci_get_drvdata取回自己的结构体说明probe里必须pci_set_drvdata这一对是配套的。另外注意module_pci_driver宏已经帮你写了 init/exit别再手写一份module_init重复定义会编译报错。3. 编译、加载与自环验证一份能照着敲的命令链源码包能编译通过和驱动能在目标机上跑起来是两回事。前一步失败多半是内核头文件版本对不上后一步失败基本都写在dmesg里只是没人从头翻。这一章按现场操作顺序走一遍每一步都给出判断依据别只看命令有没有报错。3.1 内核头文件对齐编译前先确认三件事外编模块最容易踩的坑是头文件对不上。/lib/modules/$(uname -r)/build必须指向一套和当前运行内核完全同版本的头文件版本号差一位编译出来的.ko加载时就会报version magic不匹配或者更隐蔽地加载成功但结构体偏移错位跑着跑着就崩。uname -r # 先记住这个版本号 ls -l /lib/modules/$(uname -r)/build # 必须是软链接不能是空目录 test -f /lib/modules/$(uname -r)/build/include/linux/pci.h echo headers ok modinfo -F vermagic /lib/modules/$(uname -r)/kernel/drivers/tty/serial/8250/8250_pci.ko第一条命令拿到运行版本第二条确认头文件在第三条抽查pci.h是否存在有的精简系统只装了部分头文件第四条读出内核自带模块的vermagic字符串跟自己编译出来的对比一下最稳妥。头文件缺了就装同名版本的内核头文件包别图省事装个 meta 包让它自动装最新版——那样十有八九和运行内核不是一个版本。# Makefile obj-m my_pci_serial.o KDIR ? /lib/modules/$(shell uname -r)/build all: $(MAKE) -C $(KDIR) M$(PWD) modules clean: $(MAKE) -C $(KDIR) M$(PWD) cleanM$(PWD)表示只编当前目录下的模块不碰内核树其他部分所以不需要make modules_install也不会污染系统。KDIR留成?是有意的交叉编译时直接用make KDIR/path/to/target/kernel ARCHarm64 CROSS_COMPILEaarch64-linux-gnu-覆盖不用改 Makefile。3.2 加载与看日志dmesg 里该出现哪几行insmod返回 0 不代表成功只能说明模块初始化函数没返回负值probe到底跑没跑、跑了几个口全在dmesg里。加载完立刻看尾部几十行重点找ttyS编号和 8250 框架打印的端口信息。make -j$(nproc) sudo insmod ./my_pci_serial.ko dmesg | tail -30 lspci -nn -d 1234:5678 -vv | grep -E Region|Interrupt|Subsystem ls -l /sys/class/tty/ttyS4/device/driver # 软链指向 my_pci_serial 才算绑定成功 cat /proc/tty/driver/serial | grep -E ^[0-9]:/sys/class/tty/ttyS4/device/driver这条软链是最快的判据指向my_pci_serial说明是你的模块注册的指向serial8250说明被内核自带驱动接管了压根不存在说明probe没跑或者中途失败。/proc/tty/driver/serial里能看到uart:16550A port:0000XXXX irq:16这样的行port值和lspci里的 Region 1 起始地址对得上才算地址映射正确对不上就是 BAR 序号取错了。部分内核没开这个 proc 接口那就退回去看dmesg。3.3 自环测试把 TX/RX 短接用 stty dd 验链路没有外设的时候最直接的验证办法是把 DB9 的 2 脚RX和 3 脚TX短接做成自环。写进去什么就该读回什么一个字节都不能差。这个方法能把地址映射、中断、FIFO、波特率四件事一次性验完比接一台真设备省事得多。PORT/dev/ttyS4 stty -F $PORT 921600 cs8 -cstopb -parenb -crtscts raw -echo head -c 4096 /dev/urandom /tmp/tx.bin cat /tmp/tx.bin $PORT timeout 3 dd if$PORT of/tmp/rx.bin bs4096 count1 2/dev/null cmp /tmp/tx.bin /tmp/rx.bin echo OK: 4096 字节全等 || echo FAIL: 丢字节或错位stty这行参数逐个解释cs8八位数据-cstopb一位停止位-parenb无校验-crtscts关硬件流控自环时 RTS/CTS 没有对端开着就发不出去raw关掉行规程的字符转换-echo防止回显把自己的数据混进来。读端必须先起cat丢到后台再往串口写顺序反了会因为 FIFO 溢出丢掉开头几个字节看起来像驱动有问题其实是测试方法不对。测试项建议值判断标准115200 自环 4096 字节全等基础链路通921600 自环 4096 字节全等uartclk填对FIFO 深度正确921600 连续 10 分钟无错位中断处理无丢帧拔插三次后重载模块编号不漂、无残留remove路径干净低速通、高速不通九成是uartclk或 FIFO 深度的问题别急着怀疑硬件高速通、长时间跑才出错往中断和 FIFO 阈值上找。4. 波特率、FIFO 与 RS-485四个决定稳不稳的参数前面几步把设备跑起来接下来是让它长期稳定运行。串口驱动出问题很少是完全不能用绝大多数是偶尔丢一个字节这类问题在办公室里复现不了到现场就是事故。下面这几个参数是分水岭。4.1 uartclk 与分频系数波特率误差是怎么算出来的8250 系的分频公式是divisor uartclk / (16 × baud)divisor必须是正整数部分芯片支持小数分频但那是加分项不是标配。这个公式决定了uartclk填错之后不是速率不准一点而是成倍偏移。板上晶振常见 1.8432MHz、7.3728MHz、14.7456MHz、24MHz 几种很多卡片为了省成本用 1.8432MHz结果就是最高只能跑到 115200。uartclk115200 分频921600 分频实际可达到的上限184320010.125无效115200737280040.5无效11520014745600819216002400000013误差 0.本文还有配套的精品资源点击获取