海恒借还书机需在借还机竖屏最新版中，运行根目录下的 GPI.AutoBorrowBack.exe 程序。若配置参数错误，程序将触发报错并无法正常启动，需优先排查配置项。
报错类型 | 原因分析 | 解决措施 |
设备编号或 MAC 错误 | 海恒服务器未完成当前设备的 “MAC 地址 - 设备类型” 绑定 | 在海恒服务器端，录入当前设备的 MAC 地址及对应设备类型，完成绑定配置 |
一卡通交互失败 | 一卡通程序未正确配置，或未与借还书程序协同运行 | 按本指南 “一卡通配置” 章节要求检查参数，确保一卡通程序与借还书程序同时启动，实现条码号读取、账号输入等交互功能 |
配置文件需通过专用工具修改，具体步骤如下：
找到借还书机程序同目录下的 配置管理器.exe 并双击打开；
在界面的 “组合框配置” 下拉菜单中，选择 SysConfig 选项；
点击 “打开” 按钮，进入配置参数编辑界面，按以下章节要求修改各项参数。
配置项 | 要求值 | 说明 |
GPI 服务器 IP | 按实际部署填写 | 需确保借还书机与服务器网络连通 |
端口 | 按实际部署填写 | 与服务器端 GPI 服务端口保持一致 |
设备编号 | 按服务器分配填写 | 需与服务器绑定的设备编号完全匹配 |
连接方式 | 短链接 | 避免长链接导致的网络资源占用问题 |
串口 | 设备管理器查询结果 | 进入 “设备管理器 - 端口”，选择借还书机对应的串口（如 COM3） |
配置项 | 要求值 | 说明 |
图书 EPC 模型 | 00030053 | 固定模型编号，用于识别图书电子标签 |
标签格式 | EPC | 统一标签解析格式，确保标签信息读取准确 |
馆代码 | 10247 | 固定馆代码，与图书馆系统标识匹配 |
配置项 | 要求值 | 说明 |
波特率 | 115200 | 与一卡通读卡设备的波特率参数一致 |
一卡通类型 | 高频读卡（力博） | 按实际使用的一卡通设备型号选择 |
一卡通是否需要密码验证 | 不勾选 | 当前配置下，一卡通读卡无需密码校验 |
配置项 | 要求值 | 说明 |
数据库 IP 地址 | 按实际部署填写 | 需确保借还书机与数据库网络连通 |
数据库名称 | 按实际部署填写 | 与图书馆业务数据库名称一致 |
用户名 | 按实际部署填写 | 数据库访问账号，需具备读写权限 |
密码 | 按实际部署填写 | 数据库访问密码，确保正确性 |
超时时间 | 6000 | 单位：毫秒，避免因网络延迟导致的数据库连接失败 |
配置项 | 要求值 | 说明 |
逾期是否可以借书 | 不勾选 | 读者名下有逾期图书时，禁止新的借书操作 |
是否以调试模式运行（退出按钮显示） | 不勾选 | 避免非管理员误操作退出程序，仅调试时勾选 |
超期图书是否可归还 | 不勾选 | 当前配置下，超期图书暂不支持通过自助机归还（需到人工台处理） |
配置项 | 要求值 | 说明 |
GPI 编码格式 | UTF-8 | 确保 GPI 通信数据的编码解析一致，避免乱码 |
GPI 结束字符 | {Enter} | 定义 GPI 指令的结束标识，与服务器端指令格式匹配 |
连接超时 | 3000 | 单位：毫秒，GPI 服务器连接的超时阈值 |
重试次数 | 3 | 连接失败时自动重试 3 次，提高稳定性 |
Socket 超时 | 5000 | 单位：毫秒，Socket 通信的超时阈值 |
串口波特率 | 57600 | 与借还书机串口设备的波特率参数一致 |
是否存在 SIP 接口 | 勾选 | 启用 SIP 接口，支持与图书馆系统的标准化交互 |
配置类别 | 配置项 | 要求值 | 说明 |
登录选择配置 | 条码卡 | 勾选 | 仅支持通过条码卡登录借还书系统 |
界面样式配置 | 借书、还书、续借、查询 | 均勾选 | 界面显示核心功能按钮，供读者操作 |
开机启动配置 | - | 全部为空 | 不设置额外开机启动项，避免程序冲突 |
界面详细配置 | 显示借书数量 | 勾选 | 界面展示读者当前可借 / 已借图书数量 |
界面详细配置 | 其余选项（如显示读者等级、积分等） | 全部不勾选 | 简化界面信息，聚焦核心功能 |
界面详细配置 | 最大借书数量 | 9 | 限制读者单次最大借书数量为 9 本 |
界面详细配置 | 证号键盘类型、密码键盘类型 | 无键盘输入框 | 仅通过一卡通 / 条码卡读取账号，不支持手动输入 |
打印机及 LED 配置 | 显示读者姓名 | 勾选 | 打印凭条及 LED 屏显示时，包含读者姓名信息 |
