Next.js无法连接Linux HID设备及Smartec读卡器读取异常

将Smartec ST-CEO11EM感应读卡器连接到Linux系统，已配置所有必要权限，设备连接成功，但刷卡时无法读取有效数据。查看设备信息后发现设备似乎不支持标准数据输入输出，随后尝试通过以下命令读取设备数据，均得到无法识别的结果：

• 使用sudo cat /dev/hidraw0
  刷卡后返回乱码：'''&%!!%&'('''&%!!%&'(

• 使用sudo hexdump -C /dev/hidraw0
  返回十六进制数据：

  00000000  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  *
  00000030  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  00000040  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  00000050  00 00 21 00 00 00 00 00  00 00 00 00 00 00 00 00  |..!.............|
  *
  00000070  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  00000080  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  00000090  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  000000a0  00 00 28 00 00 00 00 00  00 00 00 00 00 00 00 00  |..(.............|
  000000b0  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  *
  000000e0  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  000000f0  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  00000100  00 00 21 00 00 00 00 00  00 00 00 00 00 00 00 00  |..!.............|
  *
  00000120  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  00000130  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  00000140  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  00000150  00 00 28 00 00 00 00 00  00 00 00 00 00 00 00 00  |..(.............|
  00000160  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  *
  00000190  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  000001a0  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  000001b0  00 00 21 00 00 00 00 00  00 00 00 00 00 00 00 00  |..!.............|
  *
  000001d0  00 00 25 00 00 00 00 00  00 00 00 00 00 00 00 00  |..%.............|
  000001e0  00 00 26 00 00 00 00 00  00 00 00 00 00 00 00 00  |..&.............|
  000001f0  00 00 27 00 00 00 00 00  00 00 00 00 00 00 00 00  |..'.............|
  00000200  00 00 28 00 00 00 00 00  00 00 00 00 00 00 00 00  |..(.............|
  

• 使用sudo od -An -t x1z /dev/hidraw0
  返回内容：

  00 00 27 00 00 00 00 00 00 00 00 00 00 00 00 00  >..'.............<
  *
   00 00 26 00 00 00 00 00 00 00 00 00 00 00 00 00  >..&.............<
   00 00 25 00 00 00 00 00 00 00 00 00 00 00 00 00  >..%.............<
   00 00 21 00 00 00 00 00 00 00 00 00 00 00 00 00  >..!.............<
  *
   00 00 25 00 00 00 00 00 00 00 00 00 00 00 00 00  >..%.............<
   00 00 26 00 00 00 00 00 00 00 00 00 00 00 00 00  >..&.............<
   00 00 27 00 00 00 00 00 00 00 00 00 00 00 00 00  >..'.............<
   00 00 28 00 00 00 00 00 00 00 00 00 00 00 00 00  >..(.............<
  

问题根源分析 #

1. HID报告格式不匹配：从hidraw输出的十六进制数据来看，设备发送的是自定义格式的HID报告，但你用的是通用文本/十六进制读取工具，没有按照设备的HID协议解析数据。这类读卡器通常会将卡号编码在特定的报告字段中，而非直接输出ASCII文本。
2. 设备工作模式不符：很多读卡器默认是键盘仿真模式（把卡号当作键盘输入直接输出），但如果设备被配置为HID原始模式，通用工具无法直接识别。你看到的乱码是把二进制HID数据直接当作ASCII文本显示导致的。
3. 缺少专用驱动或解析工具：Smartec ST-CEO11EM可能需要厂商提供的Linux驱动或配置软件，来切换工作模式或解析自定义HID报告。默认的Linux通用HID驱动无法直接处理这类设备的非标准数据格式。

解决建议 #

• 查阅设备说明书，确认是否支持键盘仿真模式，若支持，通过厂商工具切换到该模式，刷卡后终端会直接输出卡号。
• 若必须使用HID原始模式，可基于hidapi库编写解析程序，提取HID报告中对应的卡号字段；也可查找社区是否有适配该设备的现成工具。
• 用lsusb -v命令获取设备的Vendor ID和Product ID，查看其HID报告描述符，明确数据的编码规则，再针对性解析。

内容的提问来源于stack exchange，提问作者Aybek Madrakhimov