一卡通接口与 Android/Linux SDK 对接需求说明（精简版）

我们的需求

请贵方提供现有一卡通接口的完整资料，并优先提供可在 Android 11 上运行的 SDK；如只有 Linux SDK，请明确它是否兼容 Android，或者是否需要单独部署 Linux 中转设备。

我们不要求把现有 Windows DLL 强行转换成 Android .so。我们需要的是厂商正式支持、可维护、能连接读卡器和 PSAM 的接口或 SDK。

1. 现有老接口资料

请提供以下现有 Windows 接口资料：

1. Change.dll、版本、日期、SHA-256；如有 Change.lib、Change.h一并提供。
2. 打开/关闭读卡器、寻卡、读卡、扣款、连接中心、上传、人员、部门、黑名单等函数说明。
3. CustomerInfo、UPLOADINFO、人员和部门结构体的字段、长度、对齐、编码和单位。
4. 接口返回码、卡状态、钱包类型和异常处理说明。
5. 读卡器/PSAM驱动、注册工具、授权/初始化文件、依赖DLL和安装顺序。
6. Change.set、WebService、应用ID、终端ID、科目ID和混淆参数说明。
7. 只读、扣款、上传、人员查询Demo及测试资源。

如果不能提供DLL源码，至少提供正式头文件、结构体、调用约定、接口文档、错误码和可运行Demo。

2. Android SDK 或 Linux SDK

2.1 首选：Android 11 SDK

• 支持Android 11和目标ABI，优先arm64-v8a。
• 提供.aar/.jar、Android NDK编译的.so、JNI或Kotlin/Java说明。
• 提供读卡器和PSAM的Android驱动、权限及USB/串口/HID连接方法。
• 支持初始化、设备状态、寻卡、读卡、扣款、写后余额/opCount、中心上传和人员查询。
• 提供Demo、文档、错误码、授权方式、版本和SHA-256。

2.2 备选：Linux SDK

• Android NDK/Bionic版本：可以评估直接集成Android，但必须提供目标ABI、JNI Demo和硬件驱动。
• 普通Linux glibc版本：不能直接放进Android，需要单独部署Linux中转机，并提供REST接口和部署说明。
• 未说明ABI和运行库的Linux .so 暂不可接受。

Android虽然基于Linux内核，但使用Bionic运行库。普通Linux的glibc .so 通常不能直接在Android加载。

3. 必须覆盖的能力

设备连接、读卡、扣款、写后余额和opCount、中心上传、人员查询，以及必要的部门和黑名单同步。

4. 最小验收

库能加载、读卡器/PSAM能打开、测试卡能读取、人员能查询、授权小额扣款成功、中心能查到流水、重复订单不发生二次扣款。

5. 请贵方回复

• 能否完整提供现有Windows老接口资料及版本？
• 是否有Android 11 SDK，支持哪些ABI？
• 是否有Linux SDK，适用什么CPU和运行库？
• Linux SDK能否在Android Bionic运行，还是需要单独Linux中转机？
• 支持哪些读卡器和PSAM？
• 预计何时可以交付？

最终选择：优先Android 11 SDK；只有普通Linux SDK时使用独立Linux中转器；两者均无正式SDK时继续使用Windows中转器。