IC卡读写接口说明资料

军软IC卡读写操作库使用手册文件状态：文件标识：GZJR-RFID-SO-GUIDE[√]草稿当前版本：1.0[]正式发布作者：刘湘林[]正在修改完成日期：2016-07-01广州军软科技有限公司GuangzhouArmysoftTechnologyCo.,Ltd.军软IC卡读写操作库使用说明版本历史版本/状态作者参与者起止日期备注1.0刘湘林2016-06-30至2016-07-01广州军软科技有限公司 Page2of9军软IC卡读写操作库使用说明目录1.IC卡读写操作库41.1库文件说明41.2功能说明41.3IC卡扇区使用说明41.4人员信息说明42.API说明52.1初始化SO52.2释放SO52.3打开读卡器串口52.4关闭读卡器52.5判断RFID是否打开62.6寻卡62.7读取IC卡状态62.8读人员资料72.9写入备注信息172.9写入备注信息272.9写入备注信息372.10验证无指纹卡72.11读指纹82.12读钱包1余额82.13钱包1扣费82.14读钱包2余额82.15钱包2扣费82.16判断钱包是否锁定82.17锁定钱包92.18读取错误信息9广州军软科技有限公司 Page3of9军软IC卡读写操作库使用说明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前段一个字节用于记录字符串或字节数组长广州军软科技有限公司 Page4of9军软IC卡读写操作库使用说明binary度9.预留2String或1+length前段一个字节用于记录字符串或字节数组长binary度10.预留3String或1+length前段一个字节用于记录字符串或字节数组长binary度PS：因人员信息存取空间限定9个块即144个字节，所以不宜超过。2.API说明2.1 初始化SOpublic native static void initDll();程序启动时必须先调用此方法初始化 IC卡读写库2.2 释放SOpublic 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: 失败广州军软科技有限公司 Page5of9军软IC卡读写操作库使用说明2.5判断Rfid 是否打开public native static boolean isOpened();判断读卡器是否打开。返回值说明：True:已打开False: 未打开2.6寻卡public native static byte[]searchCard();寻卡操作，返回数据中第一元素为数据长度，为 0时表示读取失败或卡不存在；2.7读取ic卡状态publicnativestaticshortgetIcCardState();读取IC卡状态，取到的是状态代码;shortstate=rfid.getIcCardState();switch(state){case0:edtCardState.setText("未初始化");break;case1:edtCardState.setText("已初始化");break;case3:edtCardState.setText("已写资料");break;case5:edtCardState.setText("已写指纹");break;case7:edtCardState.setText("已写指纹、信息");break;case9:edtCardState.setText("已写钱包");break;广州军软科技有限公司 Page6of9军软IC卡读写操作库使用说明case11:edtCardState .setText( "已写信息、钱包 ");break;case15:edtCardState .setText( "已写信息、指纹、钱包 ");break;}2.8读人员资料public native static byte[]readPerson();返回数据中第一元素为数据长度，为 0时表示读取失败；2.9写入备注信息 1public native static boolean setReserved1( byte[]reserved1);用于修改人员资料中的备注信息，重要信息不得写入此处，以防被篡改。2.9写入备注信息 2public native static boolean setReserved2( byte[]reserved2);用于修改人员资料中的备注信息，重要信息不得写入此处，以防被篡改。2.9写入备注信息 3public native static boolean setReserved3( byte[]reserved3);用于修改人员资料中的备注信息，重要信息不得写入此处，以防被篡改。2.10验证无指纹卡public native static boolean checkNullFinger();判断IC卡是否为无指纹卡。返回值说明：True:无指纹卡False: 非无指纹卡广州军软科技有限公司 Page7of9军软IC卡读写操作库使用说明2.11读指纹public native static byte[]readFinger( byte fingerIndex);读指纹操作， fingerIndex 为指纹順序号，多指紋時有效，取值從 1開始。返回的字节数组第一个字节为 1时表示成功， 0时表示失败，返回的字节数组第二个字节为指纹类别 ,1单指纹； 2为多指纹； 3为无指纹剩余部分为指纹信息， 512字节2.12读钱包1余额public native static double getMoney();读取钱包 1余额，失败时返回 -1，成功时返回余额2.13钱包1扣费public native static double decMoney( double value);钱包1扣费操作，失败时返回 -1，成功时返回余额2.14读钱包2余额public native static float getMoney2();读取钱包 2余额，失败时返回 -1，成功时返回余额2.15钱包2扣费public native static float decMoney2( float value);钱包扣费操作，失败时返回 -1，成功时返回余额2.16判断钱包是否锁定public native static boolean isLockWallet( byte walletIndex);返回值说明：True:已锁定False: 未锁定广州军软科技有限公司 Page8of9军软IC卡读写操