SamCardMaster
插件用途
居民身份证安全模块寻卡、选卡和显式读卡驱动
选择入口
进入“开发配置 → 采集配置”，创建设备并在“采集插件”中选择“SamCardMaster”。
支持的通道和数据类型
| 通道类型 | 配置前检查 |
|---|---|
| 串口 | 确认串口未被其它程序占用，并与设备保持一致的波特率、数据位、停止位和校验位。 |
| TCP 客户端 | 确认设备 IP、端口和网关到设备的网络可达性。 |
可选数据类型： 按页面可选项选择
地址规则
- SAM 身份证安全模块不支持寄存器变量地址，请通过读取模块编号、检查模块状态、寻卡、选卡和读卡动态方法执行完整读卡流程。
特殊方法
| 方法 | 用途 | 参数 |
|---|---|---|
| ReadModuleNumberAsync | 读取安全模块编号 | 无参数 |
| CheckModuleStatusAsync | 检查安全模块状态 | 无参数 |
| SearchCardAsync | 搜索身份证 | 无参数 |
| SelectCardAsync | 选择身份证 | 无参数 |
| ReadCardAsync | 读取身份证 | 无参数 |
设备调试
进入“开发配置 → 采集配置”，选择当前设备后点击“更多功能”并打开“调试”。
专用调试页
协议调试页按安全模块检查、寻卡、选卡和读卡顺序执行。
| 功能 | 作用 |
|---|---|
| 读取模块编号 | 确认当前连接的身份证安全模块身份。 |
| 检查模块状态 | 确认安全模块可以执行后续卡片操作。 |
| 寻卡 | 检测读卡区域内的身份证。 |
| 选卡 | 选择已找到的身份证，为读取做准备。 |
| 读卡 | 读取身份证信息，涉及个人敏感数据。 |
调试要点
寻卡、选卡和读取摘要可能显示身份信息，需要敏感数据权限并二次确认。
验证重点
- 先读取安全模块编号并检查模块状态，确认两项均成功。
- 使用已获授权的测试证件执行“寻卡”，确认设备检测到卡片。
- 依次执行“选卡”和“读卡”，不能跳过前置步骤。
- 只核对读取是否成功和必要字段是否完整，不在截图、日志或手册中保存真实身份证信息。
- 完成测试后移走证件，并确认调试页面和导出文件没有遗留个人敏感数据。
排障差异
- 模块编号和状态都无法读取：检查串口或 TCP 参数、模块供电和厂商驱动，再查看设备日志。
- 寻卡失败：确认测试证件位于有效读卡区域，且没有多张证件同时靠近。
- 选卡或读卡失败：重新执行“寻卡 → 选卡 → 读卡”完整顺序，并查看模块返回状态。
- 页面无权读卡：确认当前账号具有敏感数据调试权限，不要通过提高日志级别绕过权限控制。
- 串口设备无响应：确认串口未被占用，并核对波特率、数据位、停止位和校验位。