IC卡读写接口说明

军软IC卡读写操作库使用手册文件状态：[√]草稿[]正式发布[]正在修改文件标识：GZJR-RFID-SO-GUIDE当前版本：1.0作者：刘湘林完成日期：2016-07-01广州军软科技有限公司GuangzhouArmysoftTechnologyCo.,Ltd.军软IC卡读写操作库使用说明广州军软科技有限公司Page2of9版本历史版本/状态作者参与者起止日期备注1.0刘湘林2016-06-30至2016-07-01军软IC卡读写操作库使用说明广州军软科技有限公司Page3of9目目录录1.IC卡读写操作库................................................................................................................41.1库文件说明...................................................................................................................41.2功能说明.......................................................................................................................41.3IC卡扇区使用说明.......................................................................................................41.4人员信息说明................................................................................................................42.API说明...............................................................................................................................52.1初始化SO.....................................................................................................................52.2释放SO.........................................................................................................................52.3打开读卡器串口............................................................................................................52.4关闭读卡器....................................................................................................................52.5判断RFID是否打开.......................................................................................................62.6寻卡................................................................................................................................62.7读取IC卡状态...............................................................................................................62.8读人员资料....................................................................................................................72.9写入备注信息1.............................................................................................................72.9写入备注信息2.............................................................................................................72.9写入备注信息3.............................................................................................................72.10验证无指纹卡..............................................................................................................72.11读指纹..........................................................................................................................82.12读钱包1余额..............................................................................................................82.13钱包1扣费..................................................................................................................82.14读钱包2余额..............................................................................................................82.15钱包2扣费..................................................................................................................82.16判断钱包是否锁定......................................................................................................82.17锁定钱包......................................................................................................................92.18读取错误信息..............................................................................................................9军软IC卡读写操作库使用说明广州军软科技有限公司Page4of91.IC卡读写操作库1.1库文件说明Android平台的IC卡操作库文件为libGzjrRfid.so，是针对立宇泰Android系列车载平板的RFID模块操作的封装库，底层操作调用立宇泰提供的静态库文件。1.2功能说明该库用于读取IC卡中的基本信息资料，钱包资料，指纹信息；具有钱包扣费功能。提供主副两个钱包，支持多指纹读取（是否为多指纹决定于管理平台的存取方式及IC卡的容量，以1K的卡为例，采用多指纹模式，可以存取两枚指纹）。IC卡块区密码为动态密码，目前为统一算法，可扩展不同的平台或地区使用不同的密码算法。1.3IC卡扇区使用说明以M1卡为标准，1区存初始化信息；2区存钱包信息；4~6、8~10、12~14区存人员信息；16~39区中存指纹1，40~63区存指纹2。多指纹时，指纹数据在写入时经压缩处理，读取时解压处理；单指纹时不做压缩处理，故存取区间顺延至指纹2区块。1.4人员信息说明序号字段名数据类型长度备注1.用户编号long4平台产生的流水号，唯一标识2.用户名称String1+length前段一个字节用于记录字符串长度3.身份证件编号String1+length前段一个字节用于记录字符串长度因为不一定是身份证，所以长度不定4.卡类别byte11学员卡，2教练卡5.企业编号long4培训机构流水号6.部门编号long4分支机构流水号7.车辆类型String1+length前段一个字节用于记录字符串长度，教练员培训车型可能是多种，以分号隔开8.预留1String或1+length前段一个字节用于记录字符串或字节数组长军软IC卡读写操作库使用说明广州军软科技有限公司Page5of9binary度9.预留2String或binary1+length前段一个字节用于记录字符串或字节数组长度10.预留3String或binary1+length前段一个字节用于记录字符串或字节数组长度PS：因人员信息存取空间限定9个块即144个字节，所以不宜超过。2.API说明2.1初始化SOpublicnativestaticvoidinitDll();程序启动时必须先调用此方法初始化IC卡读写库2.2释放SOpublicnativestaticvoidfreeDll();程序退出时请调用此方法释放IC卡读写库，否则可能会引起内存泄漏2.3打开读卡器串口publicnativestaticbooleaninitReader(intcardType);初始化读卡器，参数：卡类型，0x02==A卡；0x01==B卡；返回值说明：True:成功False:失败2.4关闭读卡器publicnativestaticbooleancloseReader();关闭读卡器操作，一般读完卡即关闭返回值说明：True:成功False:失败军软IC卡读写操作库使用说明广州军软科技有限公司Page6of92.5判断Rfid是否打开publicnativestaticbooleanisOpened();判断读卡器是否打开。返回值说明：True:已打开False:未打开2.6寻卡publicnativestaticbyte[]searchCard();寻卡操作，返回数据中第一元素为数据长度，为0时表示读取失败或卡不存在；2.7读取ic卡状态publicnativestaticshortgetIcCardState();读取IC卡状态，取到的是状态代码;shortstate=rfid.getIcCardState();switch(state){case0:edtCardState.setText(未初始