扫码模组接入电脑后,可能直接把条码内容输入文本框,也可能需要软件先打开一个端口才能收到数据。两种设备都使用 USB,主机软件的接收方式却不同。
对于设备厂和系统集成商,接口选型需要先回答一个问题:主机是把扫码结果当作键盘输入,还是由应用程序主动接收并处理数据? 这个选择会影响软件开发、字符准确性、异常恢复和现场维护。
本文比较常见的 USB HID 键盘模式与 USB CDC 虚拟串口方案。具体型号支持哪些模式、如何配置,以及能否接收控制命令,应按交付硬件与固件资料核对。
图1:两种常见接收路径。HID-POS、厂商自定义 HID 等采用其他应用接收方式,不能全部归入键盘模拟。
1. HID 键盘模式:通过系统键盘路径输入结果
HID 是 Human Interface Device,即人机接口设备。条码扫描器常见的 HID-KBW 或 HID Keyboard,是其中的键盘模拟方式。
在这种模式下,模组把解码结果转换成键盘报告,主机通过系统键盘输入路径处理。普通文本输入场景中,结果进入当前获得输入焦点的控件。需要把扫码内容填入既有 ERP、仓库软件或网页表单时,这种接入方式便于快速评估。
例如条码内容为 00012345,输入框通常会收到相应字符;如果设备配置了回车后缀,还可能触发软件的提交动作。回车是否提交、前导零是否保留,仍取决于目标软件的行为和字段设置。 电子表格把内容转换成数值,也可能造成前导零消失。
集成时尤其要测试以下情况:
- 操作员切换窗口、点击其他输入框后,扫码结果进入哪里。
- 设备设置的键盘国家布局与主机布局是否一致,符号和大小写是否正确。
- 输入法、快捷键及连续扫码节奏是否影响结果。
- 中文、GS1 分隔符等内容如何输出,目标软件是否能按预期接收。
HID 键盘模式不等于任意字节的透明传输。部分固件可能提供特殊字符或中文输出方案,需要单独核对和验证。
对于自研软件,Windows Raw Input 等机制也可用于识别输入设备、开发专用接收逻辑。因此,不能笼统地说 HID 无法区分多台扫描器或无法后台采集;采用这类方案需要相应的软件开发。
2. CDC:由应用程序读取扫码数据
USB CDC 是通信设备类,扫码设备的虚拟串口方案常见实现为 CDC-ACM。兼容的 Windows 设备可显示为 COM 端口,应用通过端口接收字节。Linux 中,适用的 CDC-ACM 设备常见为 /dev/ttyACM*。
这一接收路径不依赖当前文本框的焦点。应用可以维护接收缓存、记录原始数据、识别完整消息,再把结果交给业务系统,适合需要掌控采集流程的自研设备软件。
出现 COM 端口,不能单独证明设备采用 CDC。 USB 转串口芯片或厂商专用驱动也可能提供虚拟串口,需要结合手册、设备描述符和驱动信息确认。
驱动也应按系统与设备实现核对。Windows 对符合条件的设备可使用系统自带的 Usbser.sys;不能据此承诺所有标为“USB COM”的产品都一律免驱。Linux 还需处理设备权限和设备节点变化;Android 则需确认主机具备 USB Host 能力,并由应用获得访问权限、使用相容的通信实现。
3. CDC 收到的数据,需要识别完整消息
CDC 为应用提供字节流接收方式。一次软件读取或接收回调,可能只包含一条扫码结果的一部分,也可能包含多条结果。
下面仅作程序设计示例:假设项目已约定每条结果以 CR LF(十六进制 0D 0A)结束,且内容本身不含该结束符。 两条结果分别为 00012345 和 ABCD,程序有可能分三次收到:
第1次:30 30 30 31
第2次:32 33 34 35 0D 0A 41 42
第3次:43 44 0D 0A
合并并按约定分帧后:
第1条:00012345
第2条:ABCD
如果把“每次收到的数据”直接作为“一条条码”,业务记录就可能被截断或拼错。程序应先缓存,再按协议边界提取完整消息,并处理超时、异常长度和断线后的残留数据。
CR LF 只是一个可选约定。二维码内容可能包含换行,GS1 数据可能含有 ASCII 29(0x1D)分隔字符。项目应根据真实内容和设备协议选择结束符、长度字段、转义或其他分帧方式。
字符编码同样需要约定。CDC 本身不会把所有二维码内容自动转换成 UTF-8;接收端应按实际输出编码解释字节。排查乱码时,保留十六进制原始日志,便于区分接收问题与显示问题。
4. 两种方式如何按项目需求选择
| 项目情况 | 优先评估 | 需要确认的条件 |
|---|---|---|
| 既有软件只接受键盘输入,暂不改接收程序 | HID 键盘模式 | 输入焦点、键盘布局、字符、前后缀及软件字段格式 |
| 自研 Windows 或 Linux 应用负责采集 | CDC 或已确认的虚拟串口方案 | 驱动、编码、分帧、端口权限与异常恢复 |
| 多台扫描器分别对应不同工位 | 按软件架构评估 CDC、专用 HID 或 Raw Input | 可靠区分设备,避免只依赖 COM 编号或输入时间 |
| 安卓设备、嵌入式终端 | 先核对主机与应用能力 | USB Host、供电、权限及设备兼容性 |
| 软件需要触发扫码、读取状态或修改参数 | 核对设备控制协议 | 当前接口与固件是否支持相应命令及响应 |
多设备应用中,VID/PID 可帮助筛选设备类型;区分同型号的多个实例,通常还需结合设备序列号、安装端口或经过验证的绑定规则。不能假定每台设备都有唯一序列号,也不能把本次分配的 COM 编号当作永久身份。
CDC 是否比 HID 更快,需要在目标设备、固件和应用上测试。HID 的输出节奏、主机处理和软件响应都可能影响表现。虚拟串口中设置的波特率也不能直接当作 USB 总线速度;该参数是否影响设备内部处理,应按固件协议确认。
5. 从“解码成功”验收到“业务接受”
模组成功解码后,仍需验证主机收到完整数据,以及业务系统接受这条记录。
建议按三个环节记录结果:
- 模组解码成功:设备得到码内数据,并按其配置输出。
- 主机接收完整:接收端获得预期内容,长度、编码和边界均正确。
- 业务系统接受:应用完成格式、工单或权限检查,并记录接受或拒绝的原因。
设备提示音或指示灯的具体含义,应查对应手册。它们不能直接证明 MES 已成功入库或闸机已完成权限校验。主机向设备发送业务确认、触发命令或参数设置,也需要设备协议支持;CDC 类本身不提供这些业务功能。
重复结果同样需要结合业务判断。同一个条码连续出现,可能来自重复扫码、持续读码配置或软件重复处理。去重窗口、重试和断线后补发策略,应按项目流程设计,避免把有效的再次扫描一起过滤。
6. 结合鑫龙模组,样品阶段应确认哪些资料
鑫龙 F42-NFC 开发资料明确区分 HID-KBW、USB CDC 和 HID-POS;F31/F41/F53 工业系列设置手册也分别介绍 HID 键盘、CDC 虚拟串口与 HID-POS。
这些资料说明应分别确认接口配置,并为所选模式采用相应的接收方式。落实到具体项目,应确认样品型号、硬件版本、固件版本、当前模式及适用手册。支持多种模式,不代表可以同时输出,也不代表任意出货版本都采用相同默认配置。
HID-POS 应单独识别。 它采用 HID 报告与应用协议接收数据,不能按“插入后直接向文本框输入”的方式验收。
评估样品时,建议随设备准备真实条码清单和预期数据,至少覆盖:
- 前导零、大小写、标点、长内容,以及项目实际涉及的中文与 GS1 数据。
- 连续扫码、同码重复扫描和两台设备同时接入。
- HID 路径的窗口切换、输入法变化及目标软件字段格式。
- 端口路径的拔插、端口占用、应用重启和系统休眠恢复。
记录测试时的设备模式、系统版本、原始接收内容和业务处理结果。出现漏录时,就能沿着“模组输出—主机接收—业务处理”定位,而不是只凭输入框里是否出现字符判断接口是否合适。
如需评估扫码模组接入方式,可提供主机系统、现有软件接收方式、实际条码样本及所需控制功能,逐项确认样品的接口配置与验证方法。
继续查看扫码器通信接口综合选型指南,或核对F42-NFC二维码与NFC模组、F31-BW扫码模组集成文章的项目资料。准备主机系统、真实条码与接收需求后,可通过鑫龙物联联系入口讨论样品验证。
技术参考
- 鑫龙《F31F41F53(工业)设置手册》,PDF 第25、35–36页:HID 键盘、CDC 虚拟串口与 HID-POS。具体产品适用性以交付资料为准。
- 鑫龙 F42-NFC 开发包原中文设置文档:HID-KBW、USB CDC、HID-POS 接口设置。
- Microsoft:USB serial driver(Usbser.sys)
- Microsoft:About Raw Input
- Android Developers:USB host overview
- Linux Kernel:USB ACM driver
