API功能简介

Size: px

Start display at page:

Download "API功能简介"

雾司
4 years ago
Views:

1 FM8303 API 说明手册时间 : 版本 :0.10 FM8303 版本

2 日期版本号简要描述初始版本上海复旦微电子集团股份有限公司中国上海 FM8303 版本

3 目录 1 FM8303 驱动简介驱动 API 功能及描述 API 描述 FM_Reader_Factory getinstance getreader FM_Reader open close setcardtype closerf fieldon reset dsiactive setdefualtpps4ct setpps4ct setpps4rf getappinfo ReadAppCrc IsoDepReader apdu tpdu MifareReader authenticatesectorwithkeya authenticatesectorwithkeyb decrement increment transfer initval readval readblock writeblock FM8303 版本

4 1 驱动简介该驱动为 FM8303 实现读 / 写卡功能提供了一套应用层接口, 使 Java 应用程序无需关心底层驱动程序实现细节 FM8303 版本

5 2 驱动 API 功能及描述 2.1 API 描述 FM_Reader_Factory 根据读卡器设备实例的厂类 getinstance public FM_Reader_Factory getinstance() 功能 : 用于获取场类的实例 getreader public FM_Reader getreader() 功能 : 获取不同类型的卡读写器 FM_Reader 8303 读写器对象 open public int open(string dev) 功能 : 终端打开 8303 读卡器, 该操作不会触发打开天线动作 dev: 设备的标识信息 FM8303 版本

6 返回值 : 0: 表示成功, 其它表示失败, 具体请见后续结果代码定义 close public int close() 功能 : 关闭当前打开的设备, 该操作不会触发打开天线动作 setcardtype public int setcardtype (byte mode) 功能 : 设置 8303 读卡的类型 mode: 设置非接触工作模式 :0x01 TYPE A( 缺省 ); 0x02: TYPE B 返回值 : 0: 表示成功, 其它表示失败, 具体请见后续结果代码定义 closerf public int closerf () 功能 :FM8303 关场返回值 : 0: 表示成功, 其它表示失败, 具体请见后续结果代码定义 fieldon public int fieldon(byte mode, byte FSDI_CID, FM_Bytes TagType, FM8303 版本

7 FM_Bytes SAK, FM_Bytes snr, FM_Bytes ratsdata) 功能 : 激活卡进入到 active 状态, 完成 request anticoll select 全部过程,rats 可选 ; mode, 定义如下 : b6 b5 b4 b3 b2 b1 b0 说明 (1)ALL 模式, 选择天线范围内所有卡片 0x52 = Wakeup (0)IDLE 模式, 只选择天线范围内 IDLE 模式的卡片 0x26 = ReqA 执行 RATS (1) 内卡 (0) 外卡 (0) 标准 FSDI_CID 定义如下 : FSDI_CID 高半字节 : 表示 FSDI,FSDI 的取值决定了 FSD( 近场通讯帧长度 ),FSDI 对应 FSD 如下 : FSDI F FSD >256(RFU) FSDI_CID 低半字 : 表示已编址的 PICC 的逻辑号出口 :TagType, 返回卡类型值,0x0004 为 M1 卡,0x0010 为 ML 卡 SAK, 返回 SAK; snr, 返回卡系列号 ( 允许多级 UID 情况 ) ratsdata,rats 应答数据, 不含 SW1 和 SW2 返回值 : 0 表示成功, 其它表示失败, 具体请见后续结果代码定义 FM8303 版本

8 reset public byte[] reset(int type,boolean isoutresponse) 功能 : 接触卡复位, 包括冷复位和热复位, 冷复位 : 设备会进行上电操作 ; 热复位 : 设备不进行上电操作 type: 复位类型 0: 冷复位 ;1: 热复位 isoutresponse: 复位结果是否输出,false: 不输出 ;rue: 输出返回 : 应答数据 ( 如果不输出, 则返回 0 长度的字节数组 ) dsiactive public int dsiactive () 功能 : 取消选卡 ( 接触式 ) 返回 : 成功则返回 0, 其它详见错误代码表 setdefualtpps4ct setpps4ct setpps4rf getappinfo public byte[] getappinfo () 功能 : 获取程序版本信息 FM8303 版本

9 返回 : 程序版本信息 ReadAppCrc IsoDepReader CPU 卡读写器 apdu public byte[] apdu(byte flag,byte[] request,int timeout) 功能 :CPU 卡指令执行 ; request: 上位机向卡片发送的数据 timeout: 超时时间, 单位毫秒,0 表示由系统默认超时时间返回值 : 卡片向上位机应答的数据 tpdu public byte[] tpdu(byte flag,byte[] request,int timeout) 功能 :CPU 卡指令执行 ; flag: b7 b6 b5 b4 b3 b2 b1 b0 说明非接通道接触式通道 FM8303 版本

10 或协议由驱动处理或协议由设备处理 request: 上位机向卡片发送的数据 timeout: 超时时间, 单位毫秒,0 表示由系统默认超时时间返回值 : 卡片向上位机应答的数据 MifareReader M1 卡的读写器 authenticatesectorwithkeya public boolean authenticatesectorwithkeya(int sector,byte[] key) 功能 :keya 的密钥认证, 密钥的长度是 6 个字节 sector: 扇区号 (0~63) key: 密钥返回 : true: 密钥验证通过 false: 密钥验证失败 authenticatesectorwithkeyb public boolean authenticatesectorwithkeya(int sector,byte[] key) 功能 :keya 的密钥认证, 密钥的长度是 6 个字节 FM8303 版本

11 sector: 扇区号 (0~63) key:, 密钥返回 : true: 密钥验证通过 false: 密钥验证失败 decrement public void increment(byte block,int value) 功能 : 增值操作, 用于将卡中的数值块加上某一数值 (value) 并把结果存于卡内的寄存器注意 : 执行此操作时, 结果存放在卡内的寄存器中, 并没有对卡片的 EEPROM 写操作需要再执行 Transfer 操作 block: 待增值块号 value: 待增加金额 increment public void decrement(byte block,long value) 功能 : 减值操作, 用于将卡中的数值块减去某一数值 (value) 并把结果存于卡内的寄存器注意 : 执行此操作时, 结果存放在卡内的寄存器中, 并没有对卡片的 EEPROM 写操作需要再执行 Transfer 操作 block: 待扣减块号 value: 待扣减金额 transfer public void transfer(byte block) 功能 : 传送, 将寄存器的内容传送到 EEPROM 中, 用于将卡内寄存器中的内容写入块中. FM8303 版本

12 此操作只能在执行 increment decrement 和 restore 操作后才可以直接调用 ; block, 钱包块地址 initval public void initval(byte block,long value) 功能 : 给卡片中的某一块区赋予初值 (value), 以供加值和减值实际上执行的是 Write 命令 ; block: 钱包块地址 value: 初始化钱包数值 readval public byte[] readval(int block) 功能 : 读取钱包块金额, 实际上执行的是 read 命令 ; block: 钱包块地址返回 : 钱包金额 readblock public byte[] read(byte block) 功能 : 读出卡中某一块的 16 个字节数 ; block: 待读出数据的块号返回 : FM8303 版本

13 读出的数据 writeblock public void write(byte block, byte[] data) 功能 : 将数据写入卡中的某一块 ; block: 待写入数据块号 data: 待写入块数据,16 字节 FM8303 版本

Microsoft Word - FM11RF08_fs_chs.doc

Microsoft Word - FM11RF08_fs_chs.doc FM11RF08 8KBits EEPROM 非接触式射频卡芯片 2008. 5 FM11RF08 8KBits 非接触式射频卡芯片版本 2.1 1 本资料是为了让用户根据用途选择合适的上海复旦微电子股份有限公司 ( 以下简称复旦微电子 ) 的产品而提供的参考资料, 不转让属于复旦微电子或者第三者所有的知识产权以及其他权利的许可在使用本资料所记载的信息最终做出有关信息和产品是否适用的判断前,