IC卡读写接口说明.docVIP

军软IC卡读写操作库使用手册  文件状态： [√] 草稿 [ ] 正式发布 [ ] 正在修改 文件标识： GZJR-RFID-SO-GUIDE 当前版本： 1.0 作 者： 刘湘林 完成日期： 2016-07-01 广 州 军 软 科 技 有 限 公 司 Guangzhou Armysoft Technology Co., Ltd. 版 本 历 史 版本/状态 作者 参与者 起止日期 备注 1.0 刘湘林 2016-06-30至2016-07-01 目 录 1. IC卡读写操作库 4 1.1 库文件说明 4 1.2 功能说明 4 1.3 IC卡扇区使用说明 4 1.4人员信息说明 4 2.API说明 5 2.1 初始化SO 5 2.2 释放SO 5 2.3打开读卡器串口 5 2.4关闭读卡器 5 2.5判断Rfid是否打开 6 2.6寻卡 6 2.7读取ic卡状态 6 2.8读人员资料 7 2.9写入备注信息1 7 2.9写入备注信息2 7 2.9写入备注信息3 7 2.10验证无指纹卡 7 2.11读指纹 8 2.12读钱包1余额 8 2.13钱包1扣费 8 2.14读钱包2余额 8 2.15钱包2扣费 8 2.16判断钱包是否锁定 8 2.17锁定钱包 9 2.18读取错误信息 9 1. IC卡读写操作库 1.1 库文件说明 Android平台的IC卡操作库文件为libGzjrRfid.so，是针对立宇泰Android系列车载平板的RFID模块操作的封装库，底层操作调用立宇泰提供的静态库文件。 1.2 功能说明 该库用于读取IC卡中的基本信息资料，钱包资料，指纹信息；具有钱包扣费功能。提供主副两个钱包，支持多指纹读取（是否为多指纹决定于管理平台的存取方式及IC卡的容量，以1K的卡为例，采用多指纹模式，可以存取两枚指纹）。 IC卡块区密码为动态密码，目前为统一算法，可扩展不同的平台或地区使用不同的密码算法。 1.3 IC卡扇区使用说明 以M1卡为标准，1区存初始化信息；2区存钱包信息；4~6、8~10、12~14区存人员信息；16~39区中存指纹1，40~63区存指纹2。 多指纹时，指纹数据在写入时经压缩处理，读取时解压处理；单指纹时不做压缩处理，故存取区间顺延至指纹2区块。 1.4人员信息说明 序号 字段名 数据类型 长度 备注 用户编号 long 4 平台产生的流水号，唯一标识 用户名称 String 1+length 前段一个字节用于记录字符串长度 身份证件编号 String 1+length 前段一个字节用于记录字符串长度 因为不一定是身份证，所以长度不定 卡类别 byte 1 1学员卡，2教练卡 企业编号 long 4 培训机构流水号 部门编号 long 4 分支机构流水号 车辆类型 String 1+length 前段一个字节用于记录字符串长度，教练员培训车型可能是多种，以分号隔开 预留1 String或binary 1+length 前段一个字节用于记录字符串或字节数组长度 预留2 String或binary 1+length 前段一个字节用于记录字符串或字节数组长度 预留3 String或binary 1+length 前段一个字节用于记录字符串或字节数组长度 PS：因人员信息存取空间限定9个块即144个字节，所以不宜超过。 2.API说明 2.1 初始化SO public native static void initDll(); 程序启动时必须先调用此方法初始化IC卡读写库 2.2 释放SO public native static void freeDll(); 程序退出时请调用此方法释放IC卡读写库，否则可能会引起内存泄漏 2.3打开读卡器串口 public native static boolean initReader(int cardType); 初始化读卡器，参数：卡类型，0x02 == A卡；0x01 == B卡； 返回值说明： True:成功 False:失败 2.4关闭读卡器 public native static boolean closeReader(); 关闭读卡器操作，一般读完卡即关闭 返回值说明： True:成功 False:失败 2.5判断Rfid是否打开 public native static boolean isOpened(); 判断读卡器是否打开。 返回值说明： True:已打开 False:未打开 2.6寻卡 public native static byte[] searchCard(); 寻卡操作，返回数据中第一元素为数据长度，为