1. 项目概述与背景在嵌入式硬件和工控领域我们经常会遇到一些“古老”但依然重要的接口比如并口。虽然现在新电脑上早已不见其踪影但在很多工业设备、老式打印机、特定测试治具上它依然是不可或缺的存在。为了让这些设备在现代基于PCIe或PCI总线的计算机上继续工作我们通常会使用像沁恒微电子WCH的CH35X或CH38X系列这样的桥接芯片将PCIe信号转换成我们熟悉的串口和并口。问题来了当你采购或生产了一批这样的PCIe转并口卡如何快速、批量地验证每一块卡上的每一个并口引脚都是好的总不能接上打印机打张测试页或者写个复杂的上位机程序一个个引脚去测吧那效率太低了尤其是在出厂测试环节我们需要一个在Linux下运行的、命令行驱动的、能自动完成所有引脚功能验证的“产测工具”。这就是今天要跟大家深入聊的这个项目——一个专为CH35X/CH38X系列芯片设计的Linux并口批量产测工具。它不依赖图形界面通过简单的硬件治具连接就能在几秒钟内完成一整块转接卡的并口全功能测试并精准定位到具体是哪一根信号线出了问题非常适合产线批量作业。2. 并口测试的核心原理与硬件治具设计要理解这个测试工具怎么工作首先得搞明白标准并口IEEE 1284标准常说的LPT口的引脚定义和通信模式。一个标准的25针D-Sub并口其信号线大致可以分为三组8根数据线D0-D7、5根状态线如BUSY, ACK, PE, SELT, ERR、4根控制线如STB, AFD, INIT, SIN。我们的测试本质上就是验证主机能否通过并口芯片正确地控制这些引脚输出高/低电平以及能否正确地读取这些引脚上的高/低电平状态。2.1 测试逻辑拆解这个工具的测试逻辑非常巧妙它利用了并口可以双向通信的特性设计了一个“回环测试”方案。但请注意这并不是简单的将输出直接短接到输入因为并口引脚有输入和输出之分直接短接可能损坏芯片。工具的做法是第一阶段数据线输出状态线输入验证。程序先将并口的8根数据线D0-D7设置为输出模式。然后它分两次向数据端口写入特定的值第一次全写00x00第二次将高4位D4-D7写10xF0。与此同时我们需要通过外部硬件治具将数据线的D4, D5, D6, D7分别连接到状态线的SELT, PE, ACK, ERR上具体对应关系见下文治具表。这样当程序写入数据时这些电平变化会通过硬件治具“传递”到对应的状态线引脚上。程序接着读取状态寄存器的值检查SELT, PE, ACK, ERR, BUSY这5根线的电平是否与预期相符。这就验证了数据线输出功能和状态线输入功能以及它们之间的硬件连接通路是否正常。第二阶段控制线输出数据线输入验证。接着程序将8根数据线切换为输入模式。然后它通过控制寄存器分两次控制4根控制线STB, AFD, INIT, SIN输出特定的高低电平组合。同样我们需要通过外部硬件治具将这4根控制线分别连接到数据线的D0, D1, D2, D3上。程序随后读取数据端口的值检查D0-D3的电平是否与控制线输出的电平一致。这就验证了控制线输出功能和数据线输入功能以及对应的硬件连接。通过这两个阶段的组合测试25针并口中所有用于通信的关键引脚8数据5状态4控制的功能都被覆盖到了。BUSY信号比较特殊它在两个阶段都被读取用于辅助判断总线状态。2.2 硬件治具制作详解这是整个测试能否成功的关键。你需要制作一个简单的治具本质上就是一个特定接法的DB25母头转接板。根据源码中help_msg()函数和测试逻辑引脚连接关系如下测试阶段并口引脚输出端并口引脚输入端对应关系与说明阶段1(数据线输出 - 状态线输入)数据端口 D4(Pin 2)状态 SELT(Pin 13)验证数据位4的输出能否被状态位SELSelect正确读取。数据端口 D5(Pin 3)状态 PE(Pin 12)验证数据位5的输出能否被状态位PEPaper Empty正确读取。数据端口 D6(Pin 4)状态 ACK(Pin 10)验证数据位6的输出能否被状态位ACKAcknowledge正确读取。数据端口 D7(Pin 5)状态 ERR(Pin 15)验证数据位7的输出能否被状态位ERRError正确读取。(不连接)状态 BUSY(Pin 11)BUSY信号由并口芯片内部状态决定在此阶段仅作监视。阶段2(控制线输出 - 数据线输入)控制 STB(Pin 1)数据端口 D0(Pin 2)验证控制位STBStrobe的输出能否被数据位0正确读取。控制 AFD(Pin 14)数据端口 D1(Pin 3)验证控制位AFDAuto Feed的输出能否被数据位1正确读取。控制 INIT(Pin 16)数据端口 D2(Pin 4)验证控制位INITInitialize的输出能否被数据位2正确读取。控制 SIN(Pin 17)数据端口 D3(Pin 5)验证控制位SINSelect In的输出能否被数据位3正确读取。实操心得治具制作注意事项防短路是第一位建议使用一个DB25母头插座和杜邦线在面包板上连接或者直接焊接一个专用的测试板。确保除了上述表格中列出的连接线外其他引脚全部悬空任何意外的短路都可能损坏并口芯片。引脚编号务必核对DB25接口的引脚编号容易看错一定要对着接口的实物图或引脚排列图用万用表蜂鸣档逐一确认连接是否正确。Pin 1通常在接插件有缺口的一侧。线材选择如果测试频率不高普通导线即可。如果考虑产线长期使用建议用排线或彩虹线并做好标签便于维护和排查。共地问题虽然并口本身通过接口已经共地但在治具制作时确保所有信号线的参考地是一致的。通常不需要额外连接地线但如果你发现测试不稳定可以检查并口插头是否插紧地线引脚如Pin 18-25是否接触良好。3. 软件环境准备与驱动加载测试工具的运行依赖于Linux内核的并口子系统。在开始编译和运行测试程序之前必须确保系统环境已经就绪。3.1 内核驱动模块检查与加载CH35X/CH38X芯片在Linux下通常由parport_pc这个驱动来支持其并口功能。它是一个标准的内核模块。插入硬件并检查识别 将待测的PCIe转并口卡插入主板。开机进入Linux系统后首先使用lspci命令查看设备是否被系统识别。lspci -v | grep -A 5 -B 2 -i 1c00\|4348这里的1c00和4348是沁恒微电子WCH的PCI厂商ID和设备ID的一部分。如果看到类似“Serial controller: Device 1c00:3470 (rev 10)”或包含“WCH”字样的信息说明硬件已被PCI子系统识别。检查并口驱动 接着检查并口相关的内核模块是否已加载。lsmod | grep -E “parport|lp”你期望看到的模块至少包括parport并口核心模块。parport_pc支持PC架构包括PCI/PCIe并口的模块。lp并口打印机驱动模块我们的测试程序不直接依赖它但它加载后通常会创建/dev/lpX节点是并口子系统正常工作的一个标志。手动加载驱动如果需要 如果上述模块没有自动加载可以手动加载sudo modprobe parport_pcparport模块通常会被parport_pc自动依赖加载。lp模块可以不用加载不影响我们的测试。确认设备节点 驱动加载成功后系统会在/dev目录下创建对应的并口设备节点。ls -l /dev/parport*通常会看到/dev/parport0。如果你的系统有多个并口例如主板自带一个PCIe卡又提供一个可能会看到parport0,parport1等。我们的测试工具就需要指定这个节点。注意事项驱动加载失败排查现象lspci能看到设备但lsmod找不到parport_pc/dev下也没有parport0。可能原因1内核配置。某些精简的Linux发行版或自定义内核可能没有编译并口支持。需要检查内核配置CONFIG_PARPORT和CONFIG_PARPORT_PC是否为y或m。可能原因2资源冲突。极少数情况下PCIe卡的并口占用的I/O端口或中断与其它设备冲突。可以查看dmesg日志dmesg | grep -i parport或者更详细地查看lspci -v输出中该设备的I/O ports信息。可能原因3CH35X/CH38X特定驱动。绝大多数情况下标准parport_pc驱动即可支持。但如果你使用的是非常新的芯片型号可能需要确认内核版本是否足够新或者咨询芯片厂商是否有特定的驱动补丁。4. 测试工具编译与使用详解4.1 源码获取与编译项目提供的源码是一个完整的C程序。你需要一个Linux开发环境如gcc编译器来编译它。保存源码将提供的wchparporttest.c源码文件保存到本地。编译命令gcc -o wchparporttest wchparporttest.c这条命令会将wchparporttest.c编译成名为wchparporttest的可执行文件。编译过程通常很顺利因为它只依赖标准C库和Linux系统头文件。编译可能遇到的问题错误sys/ioctl.h或linux/parport.h找不到。原因你的系统可能没有安装完整的开发包或内核头文件。解决在基于Debian/Ubuntu的系统上安装libc6-dev和linux-headers-$(uname -r)包。在基于RHEL/CentOS的系统上安装glibc-headers和kernel-headers包。警告一些关于未使用参数的警告可以忽略不影响功能。4.2 工具使用方法与参数解析编译成功后就可以运行测试工具了。它的命令行界面非常简洁。查看帮助sudo ./wchparporttest -h输出会显示工具的用法和最重要的信息——硬件治具的连接方式。每次使用前都建议先看一遍确认治具连接无误。执行测试 假设你的并口设备节点是/dev/parport0执行测试的命令如下sudo ./wchparporttest -d /dev/parport0 -s-d指定并口设备节点必须参数。-s开始测试必须参数。为什么需要sudo因为直接读写/dev/parportX设备文件需要root权限。测试过程与输出解读 程序运行后会依次执行4.1节描述的两个阶段共四次检测。如果所有测试都通过你会看到简洁的Parport pin test passed如果任何一次检测失败程序会打印出具体的错误信息例如[error code: 5] D4-SELT ERROR [error code: 7] D6-ACK ERROR Parport pin test failed这明确指出了是D4到SELT这条通路以及D6到ACK这条通路测试失败。4.3 错误码深度解析与故障定位工具定义了0-8共9个错误码每个对应一条特定的信号线测试失败。理解这些错误码背后的硬件含义能帮你快速定位问题。错误码信号线组合测试阶段物理引脚 (输出 - 输入)故障排查方向0STB-D0阶段2Pin 1 (STB) - Pin 2 (D0)检查治具上STB到D0的连线。可能是开路、短路或STB控制引脚输出损坏或D0数据输入引脚损坏。1AFD-D1阶段2Pin 14 (AFD) - Pin 3 (D1)检查治具上AFD到D1的连线。2INIT-D2阶段2Pin 16 (INIT) - Pin 4 (D2)检查治具上INIT到D2的连线。3SIN-D3阶段2Pin 17 (SIN) - Pin 5 (D3)检查治具上SIN到D3的连线。4D6-ERR阶段1Pin 4 (D6) - Pin 15 (ERR)检查治具上D6到ERR的连线。可能是D6输出损坏或ERR状态输入损坏。5D4-SELT阶段1Pin 2 (D4) - Pin 13 (SELT)检查治具上D4到SELT的连线。6D5-PE阶段1Pin 3 (D5) - Pin 12 (PE)检查治具上D5到PE的连线。7D6-ACK阶段1Pin 4 (D6) - Pin 10 (ACK)注意错误码4和7都涉及D6引脚。如果两者同时报错极大概率是D6输出引脚本身故障。如果只报7则可能是ACK引脚或D6到ACK的连线问题。8D7-BUSY阶段1Pin 5 (D7) - Pin 11 (BUSY)检查治具上D7到BUSY的连线。BUSY信号比较特殊它在此阶段被读取但程序期望它处于特定状态。如果D7输出正常但BUSY读取值不对也可能是BUSY引脚问题。实操心得利用错误码快速排故单一错误如果只报一个错误码比如错误码5首先怀疑硬件治具。用万用表检查对应的那根连线D4到SELT是否导通是否有虚焊或接触不良。这是最常见的问题。关联错误如果报出的错误码在物理引脚上是相邻的例如错误码4和7都涉及D6那么高度怀疑是芯片的该引脚D6损坏。因为一根治具连线同时出问题的概率远低于芯片的一个引脚损坏。批量错误如果所有涉及“数据线输出”的阶段1测试都失败错误码4,5,6,7,8而阶段2测试正常这可能意味着数据端口D0-D7的整体输出使能或驱动电路有问题。反之亦然。软件验证在怀疑硬件前可以尝试用pptest等通用的并口测试工具手动控制各个引脚输出和输入进行交叉验证以确定是测试程序问题还是硬件问题。5. 测试实例深度分析与脚本化批量测试5.1 测试成功与失败实例分析让我们结合代码逻辑还原测试成功和失败时程序内部到底发生了什么。测试成功实例流程程序打开/dev/parport0声明独占访问。阶段1-1设置数据口为输出写0x00。此时D4-D7输出低电平。通过治具SELT, PE, ACK, ERR也应读到低电平。BUSY信号在空闲时应为高电平逻辑负真硬件高电平表示“不忙”。程序检查状态寄存器预期值为0x87二进制1000 0111即BUSY1ACK/PE/SELT/ERR0。check_result函数比对通过。阶段1-2写0xF0到数据口。D4-D7输出高电平。通过治具SELT, PE, ACK, ERR应读到高电平。BUSY仍为高。预期状态寄存器值为0x7b二进制0111 1011。比对通过。阶段2-1设置数据口为输入。控制寄存器写0x0b使得STB, AFD, INIT输出低SIN输出高具体值由ctrl_reg_update逻辑决定。通过治具D0-D2应读到低D3应读到高。程序读取数据口预期值为0xf0二进制1111 0000高4位D4-D7为输入且内部上拉可能为高低4位D0-D3为读取值。比对通过。阶段2-2控制寄存器写0x04使得STB, AFD, INIT输出高SIN输出低。通过治具D0-D2应读到高D3应读到低。预期数据口值为0xffD0-D2高D3低D4-D7高。比对通过。所有四次检查均返回0打印“Passed”。测试失败实例分析以输出“D4-SELT ERROR, D5-PE ERROR...”为例假设阶段1-1的检查就失败了。程序写入0x00期望SELT(对应D4)和PE(对应D5)读到0。但check_result函数发现状态寄存器中对应位是1。于是它依次打印错误码5和6。这说明可能性A最高治具上D4到SELT、D5到PE的连线断了或者接触不良导致输入端悬空被内部上拉电阻拉成了高电平。可能性BCH35X芯片的D4或D5引脚输出驱动能力不足无法在治具连线上产生稳定的低电平。可能性CSELT或PE输入引脚内部损坏始终锁定为高电平。5.2 实现自动化批量测试脚本在产线上我们不可能手动为每一块卡插拔、输入命令。编写一个简单的Shell脚本可以极大提升效率。#!/bin/bash # 文件名batch_parport_test.sh # 描述自动检测并测试所有parport设备 TEST_TOOL./wchparporttest LOG_FILEtest_report_$(date %Y%m%d_%H%M%S).log echo 开始批量并口测试 $(date) | tee -a $LOG_FILE # 查找所有parport设备节点 for pp_device in /dev/parport*; do if [ -c $pp_device ]; then # 确保是字符设备 echo 正在测试设备: $pp_device | tee -a $LOG_FILE # 运行测试工具捕获输出 sudo $TEST_TOOL -d $pp_device -s 21 | tee -a $LOG_FILE TEST_RESULT${PIPESTATUS[0]} # 获取测试程序的退出状态码 if [ $TEST_RESULT -eq 0 ]; then echo 结果: $pp_device - PASS | tee -a $LOG_FILE else echo 结果: $pp_device - FAIL | tee -a $LOG_FILE fi echo ---------------------------------------- | tee -a $LOG_FILE fi done echo 批量测试结束 $(date) | tee -a $LOG_FILE脚本使用与增强建议将编译好的wchparporttest和此脚本放在同一目录。给脚本执行权限chmod x batch_parport_test.sh。运行脚本sudo ./batch_parport_test.sh。所有输出会同时显示在屏幕和日志文件中。增强方向结果汇总在脚本末尾添加逻辑解析日志文件统计总测试数、通过数、失败数并列出所有失败的设备节点和错误码。循环压力测试对于已通过的设备可以加入for i in {1..100}; do ... done循环进行长时间的压力测试检测是否有间歇性故障。网络上报在产线环境中可以让脚本在测试结束后将结果通过HTTP或MQTT协议发送到服务器数据库便于质量追踪。6. 常见问题排查与核心技巧实录在实际部署和使用这个测试工具的过程中我踩过不少坑也总结了一些教科书上不会写的经验。6.1 驱动与权限类问题问题1运行测试程序时报错“open: Permission denied”原因没有使用sudo或以root权限运行。普通用户无权直接访问/dev/parport0。解决始终使用sudo运行。或者可以创建一个udev规则让特定用户组拥有该设备的读写权限。# 创建文件 /etc/udev/rules.d/99-parport.rules # 内容SUBSYSTEMparport, GROUPplugdev, MODE0660 # 然后将当前用户添加到plugdev组sudo usermod -aG plugdev $USER # 重新登录后生效问题2/dev/parport0 设备节点不存在原因aparport_pc驱动未加载。排查运行lsmod | grep parport。若无输出则sudo modprobe parport_pc。原因b内核不支持或未编译PCI并口。排查检查内核配置CONFIG_PARPORT_PC。在嵌入式定制系统中常见。原因cCH35X芯片未被正确识别或驱动不兼容。排查运行dmesg | grep -i parport或dmesg | grep -i ch35查看内核启动或插拔设备时的日志。确认芯片型号是否在parport_pc驱动支持列表中。6.2 硬件与测试结果类问题问题3测试随机性失败有时PASS有时FAIL原因a最常见硬件治具接触不良。杜邦线、面包板连接在多次插拔后极易松动。解决将所有连接点焊接牢固。对于产线治具建议使用带锁紧机构的DB25连接器和高品质排线。原因b电源噪声或地线干扰。尤其是在使用长导线或开关电源的工控环境中。解决尽量缩短治具连线。在并口信号线靠近芯片端并联一个小电容如100pF到地可以滤除高频噪声。确保测试平台接地良好。原因c系统负载过高。在性能紧张的系统中用户态程序通过ioctl控制硬件的时序可能受到调度延迟的影响。解决测试时使用chrt命令给测试程序设置实时调度优先级需rootsudo chrt -f 99 ./wchparporttest -d /dev/parport0 -s问题4所有测试都通过但实际接打印机仍无法工作原因这个测试工具只验证了并口引脚的数字输入输出基本功能即“通断”测试。它没有测试电气特性如输出电流驱动能力、输入阈值电压、信号上升/下降时间。协议时序如STB选通脉冲的宽度、ACK应答信号的响应时间等这些是打印机正常工作的关键。中断功能并口通常使用中断来高效处理数据本测试未涉及中断请求IRQ相关引脚的测试。建议本工具是高效的“粗测”或“引脚通断测试”工具。对于最终的功能验证仍需连接真实打印机或专业的并口协议分析仪进行“精测”。6.3 源码级调试技巧如果你需要修改或调试这个C程序以下技巧可能有用增加调试输出在check_result函数内部或每次ioctl调用后打印出读取到的寄存器原始值。这能帮你精确看到是哪一次比较出了问题以及实际读到的值是什么。printf(“Debug: Stage X, Read value: 0x%02x, Expected: 0x%02xn”, val, cmp_val);单步测试你可以手动修改main函数注释掉后面的测试阶段只执行第一阶段或第一次写操作然后配合万用表或逻辑分析仪测量实际引脚电平进行硬件级的交叉验证。理解控制寄存器代码中的CTRL_REG_INITVAL_OUT (0xc0)和CTRL_REG_INITVAL_IN (0xe0)是关键。这两个值是根据并口标准控制寄存器的位定义设置的主要区别在于第5位DIR位它控制数据口的方向0输出1输入。深入理解这些位可以让你定制更复杂的测试模式。这个基于Linux的LPT并口批量产测工具以其简洁的设计和明确的故障定位能力在批量硬件测试中展现出了极高的效率价值。它完美地诠释了“用最简单的方案解决特定问题”的工程哲学。从驱动检查、治具制作到脚本化批量运行每一个环节都充满了硬件工程师与系统打交道时的实用主义色彩。记住再好的测试软件也离不开一个稳定可靠的硬件治具在动手焊接第一根线之前反复确认原理图和引脚定义是避免后续无数调试时间的最佳投资。