JMY600系列读写卡模块

Transcription

1 NFC & MIFARE & ISO14443A & ISO14443B & ISO15693 非接触式 IC 卡读写模块 JMY600 系列读写卡模块 通用技术手册 (Revision 5.31) 北京金木雨电子有限公司 2018/4/16 在使用本产品前请详细阅读本说明书, 如果有任何疑问, 请联系我们, 我们会给您详尽的解答

2 目录 文档更新记录 概述 功能 基本工作模式 自动寻卡 自动寻卡并输出卡序列号 空闲模式 关闭模式 EMV/PBOC 认证模式 默认功能配置 ISP 功能 读卡器安全认证功能 加密通讯功能 NFC 目标功能 NFC Tag 模拟模式 通讯协议 测试工具软件 JCP04 通讯协议 数据发送格式 数据返回格式 JCP05 通讯协议 数据包发送格式 数据包返回格式 数据包返回时间 通讯接口 UART 和 RS232C 接口 物理接口 通讯过程 IIC 接口 物理接口 数据链路 时钟和数据交换 开始条件 (Start Condition) 结束条件 (Stop Condition) 确认符 (ACK) 总线状态 设备地址 写数据操作 读数据操作 通讯过程 通讯过程描述 USB 接口 版权所有 北京金木雨电子有限公司保留所有权利 1/106

3 5 应用层协议详解 说明 系统设置命令 复位模块配置至出厂状态 读产品信息 读 PCD 的产品信息 ( 包含 UID) 模块工作模式设定 设置模块为空闲模式 设置 LED 设置蜂鸣器 读片内数据 FLASH 写片内数据 FLASH 读片外数据 FLASH 写片外数据 FLASH 设定 UART 通讯波特率 设定 UART 多机通讯地址 设定 IIC 通讯地址 设定多卡操作 设定 ISO15693 自动寻卡的 AFI 和 AFI 使能 设定自动寻卡时间间隔 设定开机时的默认自动寻卡状态 设定自动寻卡并输出卡片序列号开机默认状态 设定射频输出功率 设定读卡模式 读卡模块安全认证 取认证码 模块安全认证 修改模块认证密钥 加密通讯通道 ISO14443A/B CPU 卡命令 ISO14443 TYPE A 寻卡 ISO TYPE A 卡复位 (RATS) ISO TYPE B 寻卡 按照 EMV 或 PBOC 的规范寻卡 发送 APDU 到 ISO 卡片 ISO TYPE B 卡休眠 MIFARE 1K/4K/mini 卡命令 MIFARE 寻卡 MIFARE 1K/4K 读数据块 MIFARE 1K/4K 读多个数据块 MIFARE 1K/4K 写数据块 MIFARE 1K/4K 写多个数据块 MIFARE 1K/4K 初始化钱包 MIFARE 1K/4K 读钱包 版权所有 北京金木雨电子有限公司保留所有权利 2/106

4 5.5.8 MIFARE 1K/4K 钱包充值 MIFARE 1K/4K 钱包扣款 MIFARE 1K/4K 备份钱包 ISO14443A 卡休眠 下载 MIFARE 1K/4K 卡片密钥到模块中 有关密钥标识 MIFARE Ultralight/Ultralight C/Ultralight EV1 卡命令 MIFARE Ultralight/Ultralight C/Ultralight EV1 寻卡 MIFARE Ultralight/Ultralight C/Ultralight EV1 读卡 MIFARE Ultralight/Ultralight C/Ultralight EV1 写卡 MIFARE UltraLightC 认证密钥 MIFARE UltraLightC 读取 Ek(RndB) MIFARE UltraLight C 认证 Ek(RndA+RndB ) Ultralight EV1 读卡片版本号 Ultralight EV1 快速读取数据 Ultralight EV1 读计数器 Ultralight EV1 计数器递增 Ultralight EV1 认证密钥 Ultralight EV1 读取签名 Ultralight EV1 读取卡片计数器的 Tearing 事件 Ultralight EV1 读取虚拟卡片信息 MIFARE Plus 卡命令 卡片准备命令 MIFARE Plus 寻卡 MIFARE Plus 卡复位 MIFARE Plus 寻卡并复位 卡片初始化命令 MIFARE Plus Write Perso MIFARE Plus Commit Perso MIFARE Plus 切换到 Level2/ 卡片应用层命令 MIFARE Plus 授权数据块 MIFARE Plus 读数据块 MIFARE Plus 写数据块 MIFARE Plus 创建钱包 MIFARE Plus 读钱包余额 MIFARE Plus 钱包充值 MIFARE Plus 钱包扣款 MIFARE Plus 备份钱包 MIFARE PlusFirst Authenticate MIFARE PlusFollowing Authenticate 卡片返回的状态码 DESfire 卡命令 卡片准备命令 版权所有 北京金木雨电子有限公司保留所有权利 3/106

5 DESfire 寻卡 DESfire 卡复位 DESfire 寻卡并复位 DESFire Authenticate DESFire Authenticate first step Get ekno(rndb) DESFire Authenticate second step get ekno(rnda ) DESFire Select Application 卡片初始化命令 DESfireFormat Card DESFire Create Application DESFire Change Key Settings DESFire Get Key Settings DESFire Change Key DESFire Get Key Version DESFire Delete Application DESFire Get Version DESFire Get Application IDs DESFire Get File IDs DESFire Get FileSettings DESFire Change File Settings DESFire Create Std Data File DESFire Create Backup Data File DESFire Create Value File DESFire Create Linear Record File DESFire Create Cyclic Record File DESFire Delete File 卡片应用层命令 DESFire Read Data DESFire Write Data DESFire Get Value DESFire Credit DESFire Debit DESFire Limited Credit DESFire Write Record DESFire Read Record DESFire Clear Record File DESFire Commit Transaction DESFire Abort Transaction 卡片返回的状态码 SR176 卡命令 SR 系列卡单通道初始化 SR 系列卡选定卡 SR 系列卡操作结束 SR176 读卡 版权所有 北京金木雨电子有限公司保留所有权利 4/106

6 5.9.5 SR176 写卡 SR176 块锁定 SRI512/1K/2K/4K 卡命令 SR 系列卡单通道初始化 SRI 系列卡 16 通道初始化 SR 系列卡选定卡 SRI 系列卡回到初始化状态 SR 系列卡操作结束 SRI 系列卡读卡 SRI 系列卡写卡 SRI 系列卡块锁定 SRI 系列卡读 UID SRIX 系列卡认证 SAM 或 CPU 卡命令 SAM 或 CPU 卡复位 设定 SAM 或 CPU 卡复位后通讯速率 发送 APDU 到 SAM 或 CPU 卡 弹出 CPU 卡 ISO15693 电子标签命令 ISO15693 inventory ISO15693 stay quiet ISO15693 get system information ISO15693 reset to ready ISO15693 read blocks ISO15693 write blocks ISO15693 lock block ISO15693 write AFI ISO15693 lock AFI ISO15693 write DSFID ISO15693 lock DSFID ISO15693 get blocks security I.CODE 1 电子标签命令 I.CODE1 寻卡 I.CODE 1 读卡 I.CODE 1 写卡 I.CODE 1 卡休眠 二代身份证命令 身份证寻卡并获取 UID 身份证寻卡 发送 APDU 到身份证卡片 NFC 功能命令 设备 NFC 工作模式设置 发起者端命令 发起者寻找目标设备命令 版权所有 北京金木雨电子有限公司保留所有权利 5/106

7 发起者与目标设备数据交换命令 目标端命令 目标缓存交换数据命令 目标读取状态及数据交换结果 NFC Tag 功能命令 综述 发起者端命令 发起者读取模拟 NFC Tag 数据 发起者写入模拟 NFC Tag 数据 目标端命令 目标读取模拟 NFC Tag 数据 目标写入模拟 NFC Tag 数据 目标写入模拟 NFC Tag UID FeliCa 卡片命令 收发 FeliCa 卡片命令 版权所有 北京金木雨电子有限公司保留所有权利 6/106

8 文档更新记录 版本 日期 改动内容 V 年 1 月 23 日 在 中增加 起始位 :1 位 V 年 3 月 19 日 修正了文字书写中的错误 V 年 4 月 2 日 增加了自动寻卡并输出卡号可选 JCP04 或 JCP05 通讯协议增加了 JMY614 中弹出卡片的指令 V 年 5 月 12 日 更改文档书写中的错误 V 年 5 月 15 日 增加了对 MIFARE Ultralight EV1 的支持 V 年 6 月 11 日 修正文字错误 V 年 11 月 5 日 修正 和 的文字错误 V 年 12 月 12 日 将 SR176 和 SRI 系列卡的读写卡功能改为多块操作, 程序内部进行了处理, 兼容之前的单块操作 V 年 1 月 17 日 对 IIC 通讯部分的上拉电阻做了补充说明, 并建议新用户使用我们的 IIC 例子程序和开发测试板 建议新用户使用 TransPort 来了解通讯协议 V 年 1 月 31 日 增加读卡器安全认证功能章节 5.3 V 年 3 月 18 日 增加密文命令传输方式章节 V 年 3 月 24 日 增加 NFC 功能章节 5.15 V 年 4 月 21 日 增加 NFC Tag 功能章节 5.16 V 年 5 月 23 日 在配置自动寻卡并输出 UID 时增加了 JCP02 和 JCP03 的协议 V 年 9 月 30 日 增加 FeliCa 卡片功能支持 V 年 4 月 16 日 1. 复位模块到出厂状态后, 模块增加复位操作 2. Ultralight 卡片增加读多块功能 版权所有 北京金木雨电子有限公司保留所有权利 7/106

9 1 概述 本文详细介绍了 JMY600 系列读卡模块的工作模式和通讯协议, 本手册的使用对象为使用 JMY600 系列 RFID 模块的程序员, 我们也有通讯协议的例子代码, 可以在随货的产品光盘上找到, 也可以在金木雨的网站上找到 如果在编写程序中依然有任何的问题, 请随时联系我们的销售人员, 或发送电子邮件到 我们会给您满意的答复 2 功能 JMY600 系列读卡模块是精心设计的高性能产品, 模块具有很多先进功能 2.1 基本工作模式 模块的基本工作模式是上位机问答式, 上位机发送一条指令给模块, 模块执行后返回结果 在模块返回结果前, 再次发送新的指令, 模块是不接受的 因此, 在上位机编写程序时, 应等待模块的执行结果返回后再进行下一条指令的发送 2.2 自动寻卡 本读卡模块支持对 ISO14443A 和 ISO15693 的自动寻卡, 开启自动寻卡后, 模块进行不断的寻卡, 当寻到卡片后, 在 ICC 引脚上出现低电平, 此时, 可以直接对卡片进行读写而无需事先寻卡 上电默认的自动寻卡状态是通过 0x1D 命令设定的, 这个设定是掉电保存的 上电后, 可以通过命令 (0x11) 将自动寻卡功能临时开启或关闭, 在模块重新上电后, 将恢复为设定的默认状态 如果读卡模式设定为 ISO15693 模式, 那么自动寻卡功能就是针对 ISO15693 的卡片 ; 如果工作模式设定为 ISO14443A 模式, 那么自动寻卡就是针对 ISO14443A 的 在自动寻卡状态下, 任何其他类型的卡片操作都会造成读卡模式的改变, 从而造成错误的自动寻卡结果 自动寻卡功能对 ISO15693 全功能支持 自动寻卡功能对 MIFARE 1K/4K 和 Ultra Light 全功能支持 自动寻卡功能在工作时可以寻到 ISO14443A CPU 卡, 如果需要操作 CPU 卡, 需要先发送 RATS 命令 ( 命令代码 0x30), 模块在一个正确的 RATS 命令后, 会关闭自动寻卡功能, 请在使用中注意 自动寻卡只有当感应区内只有一张同类型卡片时才会有正确响应, 多张卡片将没有响应 如果天线区域中有多张卡片, 可能会造成数据错乱, 因此, 模块在开启自动寻卡后, 模块的多卡操作功能就将被强制禁止, 从而避免卡片数据错乱 版权所有 北京金木雨电子有限公司保留所有权利 8/106

10 2.3 自动寻卡并输出卡序列号 本系列模块可以通过设定达到自动寻卡并把读到的卡号输出的功能, 但此功能只能在使用 UART 或 RS232C 时使用, 支持的卡片类型是 ISO14443 TYPE A 和 ISO15693 以及二代身份证 卡号输出方式可以是单次输出, 也可以是连续输出, 直到卡片移开 输出格式可以是 HEX 方式也可以是 ASCII 方式 ASCII 输出格式只输出 UID,HEX 输出格式按照 0x20 命令 0x5C 命令和 0x71 命令的返回格式 开启此功能后不能进行卡片的命令交互方式的读写操作, 不能通过命令去控制模块做其他的事情, 如果要做, 需要首先停止本功能 此时可以临时停止此功能, 方法是通过 模块工作模式设定 命令 完成对模块的其他操作后, 可以再次开启本功能 此功能在 IIC USB 或 SPI 通讯模式下无法工作, 当模块收到 IIC USB 或 SPI 接口的命令后, 此功能被自动屏蔽 2.4 空闲模式 这是为省电而设计的功能, 模块在非 USB 通讯模式时, 可以设定空闲模式, 此时模块射频电场关闭, 功耗降低到约 3mA 再次发送任何命令到模块即可唤醒模块, 此时模块会开启射频电场, 恢复对卡片的操作 请参照命令 : 设置模块为空闲模式 2.5 关闭模式 有些模块配有 CE 引脚, 当 CE 引脚为低电平时, 模块正常工作, 当 CE 引脚为高电平时, 模块被禁止, 模块功耗降低到大约 30 到 100uA( 取决于读卡芯片,RC522/RC523 的较低 ) 再次将模块的 CE 引脚拉低即可唤醒模块, 唤醒时间大约为 50ms 2.6 EMV/PBOC 认证模式 部分 JMY600 系列读卡模块内置了 PBOC 和 EMV 的认证工作模式, 此模式支持 EMV 和 PBOC 的 LEVEL 1 的协议认证和电气特性认证, 发送启动认证模式命令就可以开启 我们有充分的能力可以设计出能满足认证要求的读卡器, 如果您要将读卡器送检, 请联系我们的销售人员或技术支持 2.7 默认功能配置 本模块提供模块的默认操作方式设定功能, 可以设定的参数有 : 自动寻卡开或关, 自动输出卡序列号开或关, 连续或单次输出卡号,HEX 或 ASCII 格式输出卡号, 在自动寻卡并输出卡号时 ISO15693 模式中可设定的 AFI, 自动寻卡 ( 此功能不输出卡号, 为读写卡而设计 ) 时间间隔, 多卡操作开或关, 可设定的 UART 通讯地址和波特率, 可设定的 IIC 地址, 可设定的 RF 输出功率 设定命令的详细说明请参照 : 系统设置命令 版权所有 北京金木雨电子有限公司保留所有权利 9/106

11 2.8 ISP 功能 本模块可以通过 USB 或 UART/RS232C 进行升级内部软件, 如果客户需要定制某些功能或已经发货的产品有程序瑕疵, 可以通过此功能对模块进行程序更新, 此功能可以提供很大方便 使用方法是在 PC 上运行我们提供的升级软件, 按照我们提供的方法, 把我们提供的程序文件下载进去即可 2.9 读卡器安全认证功能 我们提供了控制器与读卡模块之间的身份认证方法 这是一个读卡模块与控制器之间的双向认证, 可以应用在一些对安全敏感的应用环境, 通过此认证后, 可以确保使用的是 JMNMUYU 的正规产品 有关读卡模块认证的相关方法, 请联系我公司, 签订保密协议后即可获得 2.10 加密通讯功能 一般情况下读卡模块的通讯是明文传送的, 但在某些数据敏感的应用环境, 通讯中的数据需要加密, 我们提供了一个加密传输的应用方法, 应用中的敏感数据以密文的方式传送 有关读卡模块加密通讯的方法, 请联系我公司, 签订保密协议后即可获得 2.11 NFC 目标功能 有些读卡模块的 PCD 使用了支持 NFC 功能的芯片, 如 PN512, 那么这个模块是支持 NFC 目标功能的, 同时也支持发起者或目标的主动通讯模式, 可以同其他的支持主动通讯模式的 NFC 设备进行通讯 如果发起设备仅仅支持被动模式, 那么被动模式是唯一可选的通讯模式 2.12 NFC Tag 模拟模式 支持 NFC 目标功能的读卡模块可以设定模拟成一个 NFC Tag, 这是一个 128 字节的 FLASH 数据存储空间, 按照 Ultralight 卡片的模式组织存储空间,4 字节为一块, 共计 32 块 当模块设定为模拟 NFC Tag 时, 这个空间中的数据可以通过通讯端口直接写入初始化内容, 而不必通过 RF 界面由其他读卡模块初始化 正常使用 NFC Tag 时, 可以通过通用读卡器的 Ultralight 卡读功能进行读取, 写功能则必须由我公司的读写模块中的专用指令进行写 版权所有 北京金木雨电子有限公司保留所有权利 10/106

12 3 通讯协议 3.1 测试工具软件 对于新接触本协议的用户, 建议在 PC 端使用我们提供的工具 : TransPort 来做实验, 先了解一下协议的各部分数据组织方法 对于 RS232C 或 USB HID 接口的模块可以直接连接 PC 操作 ; 对于 UART 或 IIC 接口的模块, 我们提供有 MT500 测试板, 可以把 PC 输出的 RS232C 信号转换为 UART 接口或 IIC 接口, 并直接完成数据的交互, 详细信息请咨询销售人员 在编写程序时, 建议参考我们的例子代码, 尤其是 IIC 接口, 只有时序正确才能达到最高的通讯速度, 请用户务必注意 3.2 JCP04 通讯协议 JCP04 通讯协议是早期广泛使用的协议,JCP05 通讯协议是在 JCP04 的基础上改进的, JMY600 系列模块同时支持这两种协议, 在新开发的产品中推荐使用 JCP05 协议 数据发送格式 长度字命令字数据域校验字 长度字 :1 字节, 指明从长度字到数据域最后一字节的字节数 命令字 :1 字节, 通讯协议的应用层命令, 详见应用层协议 数据域 : 数据长度由命令字决定, 长度为 0x00 至 0xFC 字节 校验字 :1 字节, 从长度字到数据域最后一字节的逐字节异或 (XOR) 值 数据返回格式 成功返回 : 长度字 命令字 数据域 校验字 失败返回 : 长度字 命令字取反 校验字 失败返回的含义是指模块与卡片通讯失败 3.3 JCP05 通讯协议 数据包发送格式 主机发送 : 长度字 通讯地址 命令字 数据域 校验字 版权所有 北京金木雨电子有限公司保留所有权利 11/106

13 长度字 :2 字节, 指明从长度字到数据域最后一字节的字节数, 高字节在前, 取值范围为 :0x0004~0x01FE 通讯地址 :1 字节,UART 或 RS232C 多机通讯的设备地址,1 为设备出厂默认地址,0 为群呼地址 命令字 :1 字节, 通讯协议的应用层命令, 详见应用层协议 数据域 : 数据长度由命令字决定, 长度为 0 至 506 字节, 根据所使用的处理器不同, 部分型号会小于 506 字节 校验字 :1 字节, 从长度字到数据域最后一字节的逐字节异或 (XOR) 值 数据包返回格式 成功返回 : 长度字 通讯地址 命令字 数据域 校验字 失败返回 : 长度字 通讯地址 命令字取反 校验字 失败返回的含义是指模块与卡片通讯失败 3.4 数据包返回时间 从机收到指令后开始执行指令, 执行指令需要的时间一般在 100ms 以内, 根据指令类型的不同, 从机执行时间可以很长 ( 可以有 60 秒, 如某些 CPU 卡生成密钥对的指令 ), 需要等待的时间由所操作的卡片以及指令类型决定, 因此主机端需要根据指令不同来设定等待时间 详细的指令时间可以使用 TransPort 软件进行测试, 获得的结果可以作为编写实际应用程序的依据 版权所有 北京金木雨电子有限公司保留所有权利 12/106

14 4 通讯接口 4.1 UART 和 RS232C 接口 物理接口 UART 接口即异步串行通讯口, 接口电平符合 TTL 电平规范 UART 中使用 TX 和 RX 两根引线以及 GND 进行通讯, 使用时需要把主机端的 TX 连接到设备端的 RX, 主机端的 RX 连接到设备端的 TX RS232C 即经过电平转换的 UART 接口, 接口电平符合 RS232C 规范 RS232C 中使用 TXD 和 RXD 两根引线以及 GND 进行通讯, 使用时需要把主机端的 TXD 连接到设备端的 RXD, 主机端的 RXD 连接到设备端的 TXD UART 和 RS232C 通信协议采用字节为单位, 接收和发送数据都是十六进制格式, 通信参数如下 : 波特率 :19200 bps( 默认 ), 可更改为 bps 9600bps 38400bps 和 57600bps 起始位 :1 位数据位 :8 位校验位 : 无停止位 :1 位流控制 : 无 通讯过程 UART 和 RS232C 的通讯为异步通讯, 主机端发送命令给从机端, 从机收到指令后执行, 然后发送执行结果给主机端 4.2 IIC 接口 物理接口 IIC 接口是两线同步串行通讯, 接口电平符合 TTL 电平规范 IIC 接口的 2 根线为 SDA 和 SCL,SDA 为串行数据线,SCL 为串行时钟线, 连接方法为主机端的 SDA 与设备端的 SDA 相连, 主机端 SCL 与设备端 SCL 相连 IIC 接口在设备端配置为漏极开路输出, 用户可以根据需要连接上拉电阻到电源, 上拉电阻根据实际情况, 可选 2.7K~10K, 电源电压是 3V~5V 如果不连接上拉电阻, 那么会影响通讯速率, 甚至导致通讯不成功 IIC 总线可以连接多达 128 个设备, 模块的 IIC 默认地址是 0xA0, 用户可以通过命令 ( 代码 :0x19) 来修改这个设置, 以达到在同一 IIC 总线上连接多个读卡模块的应用 版权所有 北京金木雨电子有限公司保留所有权利 13/106

15 4.2.2 数据链路 以下为 IIC 通讯的图示, 在如下的图示中, 指示的是 JCP04 协议的数据包格式 时钟和数据交换通常情况下,SDA 引脚上的数据只在 SCL 低时才被更改, 在 SCL 高时的数据更改, 则在随后的定义条件会指示重新开始或停止 开始条件 (Start Condition) 在 SCL 高时的高到低的 SDA 过渡是一个开始状态, 这必须先于其它任一命令 结束条件 (Stop Condition) 一个在 SCL 高时的高到低的 SDA 过渡是一个结束状态 确认符 (ACK) 所有地址和数据字以 8 位字的形式在模块间连续 ( 串口 ) 传送 模块发送零, 以确定它不忙, 并确定它已收到每一个字 这发生在第九个时钟周期期间 总线状态模块收到命令后, 那么不再接受 IIC 总线上的任何信息, 直到当前命令执行结束后, 才能再次响应 IIC 总线上的信息 版权所有 北京金木雨电子有限公司保留所有权利 14/106

16 设备地址启动条件后, 该模块需要一个 8 位的设备地址字, 使该芯片能够进行读 / 写操作 该设备地址字由七个地址位和 1 个操作选择位组成 该模块地址的前 7 位是 ( 0xA0 十六进制 ) 该设备地址的第八位是读 / 写操作选择位 如果该位是高位, 则一次读操作被启动, 如果该位是低位, 则一次写操作被启动 写数据操作 上位机设备通过写操作发送命令给模块 读数据操作 上位机设备使用读操作得到结果 通讯过程 该模块是 IIC 总线的一个从设备, 那么, 上位机需要使用写命令将 命令数据包 写 版权所有 北京金木雨电子有限公司保留所有权利 15/106

17 入模块 写操作之后, 模块开始执行刚刚写入的命令, 上位机在此时向模块不断发出 读 命令 如果模块未作出回应, 那么刚刚发出的指令尚未执行完毕 如果模块对一个读操作有回应, 则刚才命令执行结束, 此时上位机能够从模块上读取结果和 / 或数据 通讯过程描述 例如 : 我们需要读取 MIFARE 卡的第一块的数据, 以 JCP04 应用层协议为例, 我们需要 : 发送命令 :0A210001FFFFFFFFFFFF2A 其中包含步骤 : A. 写命令到模块中 1. 发送起始条件 2. 发送控制字节, 在此为 0xA0, 含义为 : 地址 0xA0+ 写控制 0x00 3. 发送模块命令序列 :0x0A210001FFFFFFFFFFFF 4. 发送模块命令序列校验字节 :0x2A 5. 发送停止条件 B. 发送读命令, 如果模块无 ACK, 表明模块正在工作, 此时重复发送读命令 1. 发送起始条件 2. 发送控制字节, 此处为 0xA1, 含义为 : 地址 0xA0+ 读控制 0x01 3. 如果模块无 ACK, 返回到 B, 重复, 如果有 ACK, 则到下一步 C C. 接收模块返回的数据 1. 接收 1 字节并发送 ACK, 如接收到的内容为 0x12, 含义为本数据包有 0x12 字节有效数据 2. 接收剩余的 17 字节 (0x12-1=0x11), 每接收到一字节都需要发送 ACK 3. 接收校验字节, 然后发送 NACK 4. 发送停止条件 D. 验证校验字节, 如果正确, 通讯过程成功 4.3 USB 接口 USB 接口符合 USB2.0 HID 规范, 连接方法为主机端与设备端同名相连 在 Windows 操作系统中, 不需要额外安装驱动程序, 也就是俗称的 : 免驱 在 Windows 系统中, 读卡器使用 SetReport 和 GetReport 发送命令和获取操作结果 在使用 USB 通讯接口时, 通讯中发送的每个数据包长度被限制在 64 字节, 这是 USB HID 在 Windows API 的限制, 在其他操作系统下可以自由设定发送长度 接收时数据包的长度没有限制 版权所有 北京金木雨电子有限公司保留所有权利 16/106

18 5 应用层协议详解 5.1 说明 本章的通讯协议部分, 是 JCP04 和 JCP05 的全部内容, 有些产品并不支持全部内容, 比如有些模块没有配置 SAM 卡座, 有些模块不支持 ISO14443B 或 ISO15693 的某些卡片, 用户需要根据订货型号和产品说明书中的 卡片支持类型表 来确定可以支持哪些卡片的命令 对于不支持的命令部分, 读卡模块会返回错误 本章将详细解释通讯协议应用层的命令和数据部分构成, 应用层协议只说明了命令和数据部分, 整个数据包的构成格式可以是 JPC04 和 JCP05, 但命令代码和数据部分完全相同 我们以下列格式说明每条命令的构成 : 帧头命令数据校验在这里, 帧头是指 JCP04 或 JCP05 的帧头, 解释如下 : JCP04 的帧头 :1 字节长度信息, 不包含校验字节在内的其他所有字节数 JCP05 的帧头 : 共 3 字节,2 字节长度信息 ( 高字节在前 ) 和 1 字节串行通讯地址, 长度信息为不包含校验字节在内的所有其他字节数, 串行通讯地址用于在 485 通讯时选择指定的设备进行通讯 校验 : 从帧头开始到数据部最后一个字节的异或 (XOR) 运算结果 举例说明, 我们以如下的命令来分别说明 帧头 0x11 模式校验这是控制模块工作状态的命令, 我们现在要通过这个命令关闭天线, 因此, 模式 赋值为 0x00, 那么, 下发的命令就是 : JCP04: 0x ; 其中,0x03 为帧头, 除去校验字节, 长度为 3, 因此取值 0x03; 0x11 为命令 ;0x00 为参数, 意为关闭自动寻卡, 关闭天线 ;0x12 为校验字节, 前面的 3 个字节的异或结果为 0x12; JCP05: 0x ; 其中,0x 为帧头,0x00 05 为长度,0x00 为串行通讯地址 ;0x11 为命令 ;0x00 为参数, 意为关闭自动寻卡, 关闭天线 ;0x14 为校验字节, 前面的 5 个字节的异或结果为 0x14; 在每个命令的说明最后都有示例, 示例命令是 JPC05 规范的, 是我们以 JMY6801H 作为试验机得到的结果 有关 JCP04 协议规范的部分, 不建议在新产品中使用 版权所有 北京金木雨电子有限公司保留所有权利 17/106

19 5.2 系统设置命令 复位模块配置至出厂状态 功能 : 模块内部具有可保存的配置信息, 当配置混乱后, 可以使用此命令复位模块的 各种配置状态至出厂默认状态 恢复默认配置后, 读卡模块的看门狗电路会将模块复位 帧头 0x0F 校验字 帧头 0x0F 校验字 帧头 0xF0 校验字 我们以 JMY6801H 为目标机, 分别使用 JCP04 和 JCP05 协议, 给出如下命令例子 : JCP04 发送 :0x07 0F D JCP04 返回 :0x02 0F 0D 在后续的指令例子中, 将不再给出 JCP04 的例子, 因为 JCP04 通讯协议是为了兼容旧 有产品, 在新产品设计中推荐使用 JCP05 通讯协议 JCP05 发送 :0x F JCP05 返回 :0x F 0A 读产品信息 功能 : 读取当前产品的产品信息, 包含 : 产品名称, 软件版本号, 软件日期, 以及配置信息 帧头 0x10 校验字 帧头 0x10 产品信息校验字产品信息 : 共 30 字节,8 字节产品名称,4 字节固件版本号,8 字节固件日期,1 字节 UART 波特率代码,1 字节 UART 多机通讯地址,1 字节 IIC 地址,1 字节多卡使能状态,1 字节 ISO15693 自动寻卡的 AFI,1 字节 ISO15693 自动寻卡的 AFI 使能状态,1 字节自动寻卡时间间隔,1 字节上电默认自动寻卡状态,1 字节上电默认自动输出 SNR 设定,1 字 版权所有 北京金木雨电子有限公司保留所有权利 18/106

20 节射频输出强度设定 帧头 0xEF 校验字 发送 :0x 返回 :0x A 4D E A A 读 PCD 的产品信息 ( 包含 UID) 功能 : 读取当前 PCD 的产品信息, 包含 : 产品类别识别码,UID, 以及配置信息 帧头 0x03 校验字 帧头 0x03 产品信息 校验字 产品信息 : 共 16 字节,5 字节产品识别码,3 字节保留,4 字节 UID,3 字节保留,1 字节 CRC 校验 帧头 0xFC 校验字 发送 :0x 返回 :0x FF FF 0F B A6 57 5E 38 E 模块工作模式设定 功能 : 模块功能临时设定, 模块不保存配置, 所有设置将在下一次上电时丢失 设定天线电场开或关, 设定自动寻卡开或关, 自动寻卡并输出 UID 开或关 在自动寻卡并输出 UID( 这个命令仅仅在 RS232C 或者 UART 接口时可用 ) 的状态下, 寻到卡片后就通过 RS232 或 UART 输出 UID, 然后就会将刚刚寻到的卡片休眠 如果设定了连续输出 UID, 那么当寻到卡片后就会连续输出卡号信息, 直到卡片移开 UID 的输出格式还可以设定为 ASCII 格式 版权所有 北京金木雨电子有限公司保留所有权利 19/106

21 帧头 0x11 模式 校验字 模式 :1 字节 天线状态 : BIT0=0: 关 ; BIT0=1: 开默认开 自动寻卡 : BIT1=0: 关 ; BIT1=1: 开默认关 自动寻卡并输出 UID: BIT2=0: 关 ; BIT2=1: 开默认关 自动寻卡并连续输出 UID: BIT3=0: 关 ; BIT3=1: 开默认关 自动寻卡并输出 UID 数据格式 :BIT4=0:HEX; BIT4=1:ASCII 默认 HEX 帧头 0x11 校验字 帧头 0xEE 校验字 发送 :0x 返回 :0x 设置模块为空闲模式 功能 : 将模块设定为空闲模式 空闲模式下, 模块的天线电场关闭, 射频基站关闭, CPU 进入空闲模式, 模块功耗将降低到 100uA 左右 向模块发送下一条命令即可唤醒模块 到工作状态, 唤醒后, 天线状态和自动寻卡功能将恢复默认设置 模块进入空闲模式前, 需要完成向上位机发送执行结果 在 IIC 和 SPI 通讯模式中, 上位机需要将执行结果读取 完毕, 然后模块才会进入空闲模式 模块工作在 USB 接口时不支持空闲模式 帧头 0x12 随机数 校验字 随机数 :1 字节随机数, 如 :0x55 帧头 0x12 校验字 帧头 0xED 校验字 发送 :0x 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 20/106

22 5.2.6 设置 LED 功能 : 点亮或熄灭模块上的 LED 灯 帧头 0x13 状态 校验字 状态 :1 字节, 位编码如下 LED1 BIT0=0: 关 ; BIT0=1: 开 LED2 BIT1=0: 关 ; BIT1=1: 开 LED3 BIT2=0: 关 ; BIT2=1: 开 LED4 BIT3=0: 关 ; BIT3=1: 开 帧头 0x13 校验字 帧头 0xEC 校验字 发送 :0x F 19 返回 :0x 设置蜂鸣器 功能 : 鸣响模块上的蜂鸣器 帧头 0x14 时间 校验字 时间 :1 字节, 单位是 10 毫秒, 如果时间是 0x0A 则蜂鸣时间是 100 毫秒 帧头 0x14 校验字 帧头 0xEB 校验字 发送 :0x AA BB 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 21/106

23 5.2.8 读片内数据 FLASH 功能 : 读取模块 MCU 内部的数据 FLASH 中的数据 帧头 0x15 地址 字节数 校验字 地址 :2 字节, 读取起始地址, 地址范围 :0x0000 ~ 0x01FF, 高字节在前 字节数 :1 字节, 读取字节数 帧头 0x15 数据 校验字 数据 : 读到的数据 帧头 0xEA 校验字 发送 :0x 返回 :0x FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 写片内数据 FLASH 功能 : 将数据写入到模块 MCU 内部的数据 FLASH 中 帧头 0x16 地址 字节数 数据 校验字 地址 :2 字节, 写入起始地址, 地址范围 :0x0000 ~ 0x01FF, 高字节在前 字节数 :1 字节, 写入字节数 数据 : 要写入的数据 帧头 0x16 校验字 帧头 0xE9 校验字 发送 :0x A 0B 0C 0D 0E 0F 11 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 22/106

24 读片外数据 FLASH 功能 : 读取模块上的 FLASH 芯片中的数据 帧头 0x05 块号 块内偏移 字节数 校验字 块号 :2 字节, 读取起始地址, 地址范围 :0x0000 ~ 0x01FF, 高字节在前 块内偏移 :2 字节, 数据块内部地址偏移, 取值范围 :0x0000~0x0107, 高字节在前 字节数 :2 字节, 写入字节数, 取值范围 :0x0001~0x0108 字节, 高字节在前 帧头 0x05 数据 校验字 数据 : 读到的数据 帧头 0xFA 校验字 发送 :0x00 0A 返回 :0x00 0C 写片外数据 FLASH 功能 : 将数据写入到模块上的 FLASH 芯片中 FLASH 的数据共 2048(0x0800) 块, 每块 264(0x0108) 字节 帧头 0x06 块号 块内偏移 字节数 数据 校验字 块号 :2 字节, 写入块号, 地址范围 :0x0000 ~ 0x07FF, 高字节在前 块内偏移 :2 字节, 数据块内部地址偏移, 取值范围 :0x0000~0x0107, 高字节在前 字节数 :2 字节, 写入字节数, 取值范围 :0x0001~0x0108 字节 数据 : 要写入的数据 帧头 0x06 校验字 帧头 0xF9 校验字 版权所有 北京金木雨电子有限公司保留所有权利 23/106

25 发送 :0x E 返回 :0x 设定 UART 通讯波特率 功能 : 设定模块的 UART 通讯波特率, 模块接收到命令后, 首先保存新波特率的设定 值, 然后按照原来的波特率发送执行结果, 然后使设定值生效 模块的 UART 通讯波特率 默认为 19200bps, 设定值将被保存在模块中, 掉电不受影响 帧头 0x17 波特率 校验字 波特率 :1 字节, 波特率代码 ;0:19200bps( 默认 );1:115200bps;2:9600bps;3: 38400bps;4:57600bps; 帧头 0x17 校验字 帧头 0xE8 校验字 发送 :0x 返回 :0x 设定 UART 多机通讯地址 功能 : 设定模块的 UART 多机通讯地址, 模块接收到命令后, 首先保存新地址的设定 值, 然后按照原来的地址发送执行结果, 最后使设定值生效 模块的 UART 多机通讯地址 默认为 1, 设定值将被保存在模块中, 掉电不受影响 帧头 0x18 地址 校验字 地址 :1 字节,UART 多机通讯地址 ;1~0xFF 帧头 0x18 校验字 帧头 0xE7 校验字 版权所有 北京金木雨电子有限公司保留所有权利 24/106

26 发送 :0x F 返回 :0x E 设定 IIC 通讯地址 功能 : 设定模块的 IIC 通讯地址, 模块接收到命令后, 首先保存新地址, 然后按照原 来的地址发送执行结果, 最后使设定值生效 模块的 IIC 地址为一字节 HEX 数据, 最低位 为零, 即模块的地址必须为偶数, 不符合规定的地址不被接受, 设定值将被保存在模块中, 掉电不受影响 模块的地址默认为 0xA0 帧头 0x19 地址 校验字 地址 :1 字节, 最低位为 0, 即地址必须为偶数 帧头 0x19 校验字 帧头 0xE6 校验字 发送 :0x A0 BC 返回 :0x C 设定多卡操作 功能 : 设定多卡操作 如果用户从多张卡片中挑出一张来操作, 则需要使能多卡操作功能 如果用户设定了自动寻卡, 那么多卡操作将被强制禁止, 在天线区域内如果有多张卡片, 那么读卡模块就会报错, 从而避免卡片数据错乱 设定将被保存到模块中, 掉电不影响 多卡操作默认是使能的 多卡操作设定仅仅在 ISO14443A 适用 帧头 0x1A 多卡使能校验字多卡使能 :1 字节,0: 禁止多卡 ;1: 使能多卡 ( 默认 ); 其他值 : 保留 帧头 0x1A 校验字 版权所有 北京金木雨电子有限公司保留所有权利 25/106

27 帧头 0xE5 校验字 发送 :0x A 00 1F 返回 :0x A 1F 设定 ISO15693 自动寻卡的 AFI 和 AFI 使能 功能 : 设定在 ISO15693 模式的自动寻卡中的 AFI 和 AFI 使能 如果用户设定了 AFI 并且设定了 AFI 使能, 那么在自动寻卡时只能寻到与设定的 AFI 相等的卡片 设定将被保 存到模块中, 掉电不影响 默认 AFI 为 0, 默认 AFI 被禁止 帧头 0x1B AFI AFI 使能 校验字 AFI:1 字节,AFI, 取值 0 ~ 0xFF AFI 使能 :1 字节,0: 禁止 ;1: 使能 ; 其他值 : 保留 帧头 0x1B 校验字 帧头 0xE4 校验字 发送 :0x B 0A 返回 :0x B 1E 设定自动寻卡时间间隔 功能 : 设定自动寻卡时两次寻卡间的时间间隔, 默认 100ms 设定后模块会保存此配置, 不受断电影响 帧头 0x1C 间隔时间校验字间隔时间 :1 字节,0x00 ~ 0xFF, 单位为 10ms, 即 :0x01 代表间隔 10ms 帧头 0x1C 校验字 版权所有 北京金木雨电子有限公司保留所有权利 26/106

28 帧头 0xE3 校验字 发送 :0x C 返回 :0x C 设定开机时的默认自动寻卡状态 功能 : 设定开机时的默认自动寻卡状态, 设定后模块会保存此配置, 不受断电影响 临时开启或关闭自动寻卡, 请使用 0x11 命令 帧头 0x1D 状态 校验字 状态 :1 字节,0x00: 关闭 ;0x01: 开启 ; 其他值 : 保留 帧头 0x1D 校验字 帧头 0xE2 校验字 发送 :0x D 返回 :0x D 设定自动寻卡并输出卡片序列号开机默认状态 功能 : 设定自动寻卡并输出卡片序列号功能的开机默认状态 设定后模块会保存此配 置, 不受断电影响 帧头 0x1E 状态 校验字 状态 :1 字节, 位编码如下自动寻卡并输出 UID: BIT0=0: 关 ; BIT0=1: 开 连续输出 UID: BIT1=0: 关 ; BIT1=1: 开 以 ASCII 编码输出 : BIT2=0: 关 ; BIT2=1: 开 输出通讯协议选择 : 版权所有 北京金木雨电子有限公司保留所有权利 27/106

29 BIT4:BIT3 = 0:0 BIT4:BIT3 = 0:1 BIT4:BIT3 = 1:0 BIT4:BIT3 = 1:1 JCP04 JCP05 JCP02 JCP03 帧头 0x1E 校验字 帧头 0xE1 校验字 发送 :0x E 00 1B 返回 :0x E 1B 设定射频输出功率 功能 : 设定模块的射频输出功率, 功率减小后, 对于不同的卡片, 有不同的读卡距离 反应, 用户可以根据自己的实际情况设定 设定后模块会保存此配置, 不受断电影响 帧头 0x02 功率 校验字 功率 :1 字节,0x00: 最强 ;0x01: 次强 ;0x02: 次弱 ;0x03: 最弱 ; 其他值 : 保留 帧头 0x02 校验字 帧头 0xFD 校验字 JCP05 发送 :0x JCP05 返回 :0x 设定读卡模式 功能 : 设定读卡模块非接触界面的读卡模式 读卡模式默认为 ISO14443A, 如果模块不支持 ISO14443A, 那么读卡模式默认为 ISO15693, 设定不保存, 下一次上电会恢复到默认状态, 部分新的读卡模块会根据用户指令自动设定读卡类型 版权所有 北京金木雨电子有限公司保留所有权利 28/106

30 帧头 0x70 模式 校验字 模式 :1 字节,0:ISO14443A;1:ISO14443B;2:ISO15693;3:I.CODE 1; 其他 值 : 保留 帧头 0x70 校验字 帧头 0x8F 校验字 发送 :0x 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 29/106

31 5.3 读卡模块安全认证 取认证码 功能 : 读卡模块认证的第一步, 从模块取回加密的 8 字节认证码 帧头 0x07 校验字 帧头 0x07 认证码 校验字 认证码 :8 字节使用读卡器内的密钥加密的认证码 发送 :0x 返回 :0x00 0C D0 9B C B7 9F FB 模块安全认证 功能 : 控制器对读卡模块的身份认证 通过此认证, 用户可以确保使用的是正规产品 有关读卡模块认证的相关方法, 请联系我公司, 签订保密协议后即可获得 帧头 0x08 认证数据校验字认证数据 :16 字节, 使用认证算法得出的 16 字节认证数据 帧头 0x08 认证结果校验字认证结果 :8 字节, 读卡模块返回的认证结果 帧头 0xF7 校验字 发送 :0x DB 08 9B FD CD A EE FC 76 返回 :0x00 0C F 7A 61 4D 9D D 9C 版权所有 北京金木雨电子有限公司保留所有权利 30/106

32 5.3.3 修改模块认证密钥 功能 : 修改模块内部存储的认证密钥, 此操作需要在认证通过之后进行 帧头 0x09 密钥信息 校验字 密钥信息 :32 字节, 加密的密钥信息 帧头 0x09 校验字 帧头 0xF6 校验字 发送 :0x F 7A 61 4D 9D D B4 D0 A B BF ED C0 AD B0 0B 5F 5A 80 0C 返回 :0x C 加密通讯通道 功能 : 通过加密方式传输命令 帧头 0xFC 密文信息 校验字 密文信息 : 加密后的命令信息 帧头 0xFC 密文信息 校验字 帧头 0x03 校验字 发送 :0x00 0C 00 FC B0 A D7 F1 C3 返回 :0x FC 69 B6 C4 D2 1C 70 CA 6A 0F 1D 64 2B D6 D E8 版权所有 北京金木雨电子有限公司保留所有权利 31/106

33 5.4 ISO14443A/B CPU 卡命令 ISO14443 TYPE A 寻卡 功能 :ISO14443A 寻卡, 包含 MIFARE 系列和其他所有符合 ISO14443A 标准的卡片 在返回结果中, 用户可以通过返回数据包的长度来判断序列号的长度, 也可以通过 ATQA 来判断卡片的类型, 还可以通过 SAK 来判断卡片是否支持 ISO 如果开启了自动寻卡, 那么此命令是取自动寻卡的结果, 而不是在接收到命令后进行寻卡 帧头 0x20 模式校验字模式 :1 字节,0:WUPA( 寻所有卡 );1:REQA( 寻未休眠的卡 ); 其它值 : 保留 帧头 0x20 数据校验字数据 :4,7 或 10 字节卡片序列号 +2 字节 ATQA+1 字节 SAK 帧头 0xDF 校验字 发送 :0x 返回 :0x00 0B ISO TYPE A 卡复位 (RATS) 功能 : 把一张符合 ISO 规格的卡片进行复位 在执行此命令前需要进行寻卡 ( 命 令代码 :0x20), 并在卡片的 SAK 中确认卡片支持 ISO 如果开启了自动寻卡功能, 那么在一次成功的执行 RATS 命令后, 自动寻卡功能将被强制关闭 帧头 0x30 校验字 帧头 0x30 信息 校验字 信息 : 卡片复位信息, 字节长度由卡片决定 帧头 0xCF 校验字 版权所有 北京金木雨电子有限公司保留所有权利 32/106

34 发送 :0x 返回 :0x BD ISO TYPE B 寻卡 功能 :ISO14443B 寻卡, 寻到卡后并对卡片与读卡模块的通讯进行设定 帧头 0x60 模式 AFI 校验字模式 :1 字节,0:WUPB( 寻所有卡 );1:REQB( 寻未休眠的卡 ); 其他值 : 保留 AFI: 要寻卡的 AFI, 如果不指定 AFI, 请使用 0x00 帧头 0x60 信息校验字信息 :12 字节, 卡复位信息, 构成内容如下 : 0x50(1 字节 ), PUPI(4 字节 ), 应用数据 (4 字节 ), 协议信息 (3 字节 ) 更多详细内容请参考 ISO ATQB Response 部分 帧头 0x9F 校验字 发送 :0x 返回 :0x 按照 EMV 或 PBOC 的规范寻卡 功能 : 按照 EMV 或 PBOC 规范的要求进行寻卡操作, 寻到卡后对卡片与读卡模块的 通讯进行设定 本命令的寻卡是针对 T=CL 的 CPU 卡的, 包含 ISO14443A 和 ISO14443B 通过此命令寻到卡后, 即可对卡片发送 APDU 进行操作 帧头 0x32 校验字 帧头 0x32 卡类型 信息 校验字 卡类型 :0x41 0x42 或 0x4D,0x41 代表寻到的卡片为 TYPE A;0x42 为 TYPE B;0x4D 版权所有 北京金木雨电子有限公司保留所有权利 33/106

35 为天线区域内有多张卡, 此时不能继续操作卡片 信息 : TYPE A 的返回信息构成内容如下 : 1 字节 UID 长度 ( 取值为 4,7 或 10),UID( 长度由前一字节决定 ),2 字节 ATQA,1 字节 SAK,ATS( 卡的 ATS 信息长度不固定, 请参照卡片厂商提供的手册 ); TYPE B 卡返回信息构成内容如下 : 0x50(1 字节 ), PUPI(4 字节 ), 应用数据 (4 字节 ), 协议信息 (3 字节 ), ATTRIB 信息 (1 或多字节, 由卡片决定 ) 帧头 0xCD 校验字 发送 :0x 返回 :0x 发送 APDU 到 ISO 卡片 功能 : 给一张符合 ISO 规格的卡片发送 APDU 命令 在执行此命令前需要对卡片进行复位 如果要操作 ISO 的卡片, 需要关闭自动寻卡, 因为自动寻卡的操作会使 ISO 卡片的状态丢失 帧头 0x31 APDU 校验字 APDU: 要发送的 APDU 帧头 0x31 回应校验字回应 : 卡片回应, 长度由具体的命令决定 帧头 0xCE 校验字 发送 :0x B4 返回 :0x000E B9 89 3A B E D EC 版权所有 北京金木雨电子有限公司保留所有权利 34/106

36 5.4.6 ISO TYPE B 卡休眠 功能 : 将当前操作的 ISO14443B 卡置入休眠状态 不是所有卡都支持这个命令, 尤其 是新卡, 多数不支持 帧头 0x62 PUPI 校验字 PUPI:4 字节, 需要休眠的卡的 PUPI 帧头 0x62 校验字 帧头 0x9D 校验字 发送 :0x B 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 35/106

37 5.5 MIFARE 1K/4K/mini 卡命令 MIFARE 寻卡 MIFARE 系列卡片的寻卡请参照 :ISO14443A 寻卡 MIFARE 1K/4K 读数据块 功能 : 读取 MIFARE 1K/4K 的一块数据 帧头 0x21 密钥标识块号密钥校验字密钥标识 :1 字节, 密钥标识 BIT0=0: 密钥 A;BIT0=1: 密钥 B; BIT1=0: 使用指令中的密钥 ;BIT1=1: 使用由 0x2D 命令下载到模块中的密钥 ; BIT6:BIT5:BIT4:BIT3:BIT2: 如果使用已经下载的密钥, 在这里指明密钥编号 ; BIT7=0: 使用上述密钥进行认证 ; BIT7=1: 该块已经认证过, 本次操作不需要认证密钥 这可以加快读写速度, 但需要使用者严密的思路来保证流程的正确性 ( 本操作与自动寻卡不能同时使用 ); ( 注意, 详细的信息请参照 : 有关密钥标识 ) 块号 :1 字节, 要读取的数据块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡的密钥 帧头 0x21 数据校验字数据 :16 字节卡片的数据 帧头 0xDE 校验字 发送 :0x000C FF FF FF FF FF FF 2C 返回 :0x A 0B 0C 0D 0E 0F 34 版权所有 北京金木雨电子有限公司保留所有权利 36/106

38 5.5.3 MIFARE 1K/4K 读多个数据块 功能 : 读取 MIFARE 1K/4K 的一个扇区内的多块数据 如果跨扇区, 读取操作将失败 帧头 0x2A 密钥标识起始块号块数密钥校验字密钥标识 :1 字节, 密钥标识起始块号 :1 字节, 要读取的起始块号块数 :1 字节, 要读取的块数 ( 取决于要读的卡片结构,S50 取值 1-4) 密钥 :6 字节, 卡片的密钥 帧头 0x2A 数据校验字数据 :16 字节卡片的数据 / 块 * 块数 帧头 0xD5 校验字 发送 :0x00 0D 00 2A FF FF FF FF FF FF 24 返回 :0x A A 0B 0C 0D 0E 0F A 1B 1C 1D 1E 1F 0F MIFARE 1K/4K 写数据块 功能 : 将数据写入 MIFARE 1K/4K 的一个块 帧头 0x22 密钥标识 块号 密钥 数据 校验字 密钥标识 :1 字节, 密钥标识 块号 :1 字节, 要写入的数据块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡片的密钥 数据 : 要写的 16 字节数据 帧头 0x22 校验字 帧头 0xDD 校验字 版权所有 北京金木雨电子有限公司保留所有权利 37/106

39 发送 :0x001C FF FF FF FF FF FF A 0B 0C 0D 0E 0F 3F 返回 :0x MIFARE 1K/4K 写多个数据块 功能 : 写入 MIFARE 1K/4K 多个块的数据 如果跨扇区, 在跨扇区后的第一块将写入失败, 并在返回结果中提示出错 帧头 0x2B 密钥标识起始块号块数密钥数据校验字密钥标识 :1 字节, 密钥标识起始块号 :1 字节, 要写入的起始块号块数 :1 字节, 需要写入的块数密钥 :6 字节, 卡片的密钥数据 :16 字节需要写入的数据 / 块 * 块数 帧头 0x2B 校验字 帧头 0xD4 校验字 发送 :0x00 2D 00 2B FF FF FF FF FF FF A 0B 0C 0D 0E 0F A 1B 1C 1D 1E 1F 05 返回 :0x B 2E MIFARE 1K/4K 初始化钱包 功能 : 将 MIFARE 1K/4K 的一个块初始化为一个钱包, 钱包的格式使用 MIFARE 1K/4K 默认的格式, 卡片的第 0 块和密钥块不能作为钱包使用 有关 MIFARE1K/4K 卡片的详细信息请阅读卡片资料 帧头 0x23 密钥标识块号密钥钱包值校验字 版权所有 北京金木雨电子有限公司保留所有权利 38/106

40 密钥标识 :1 字节, 密钥标识 块号 :1 字节, 要初始化的钱包块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡片的密钥 钱包值 :4 字节, 初始钱包数值, 低字节在前 帧头 0x23 校验字 帧头 0xDC 校验字 发送 :0x FF FF FF FF FF FF 返回 :0x MIFARE 1K/4K 读钱包 功能 : 读 MIFARE 1K/4K 的一个钱包 钱包的格式使用 MIFARE 1K/4K 默认的格式 读出卡片内容后, 会按照钱包的格式去做验证, 如果格式不正确就返回失败 帧头 0x24 密钥标识块号密钥校验字密钥标识 :1 字节, 密钥标识块号 :1 字节, 要读取的钱包块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡片的密钥 帧头 0x24 数据校验字数据 :4 字节数值数据, 低字节在前 帧头 0xDB 校验字 发送 :0x000C FF FF FF FF FF FF 29 返回 :0x 版权所有 北京金木雨电子有限公司保留所有权利 39/106

41 5.5.8 MIFARE 1K/4K 钱包充值 功能 : 把 MIFARE 1K/4K 的一个钱包进行加值 钱包的格式使用 MIFARE 1K/4K 默认 的格式 加值的意思是在原有钱包值的基础上增加 帧头 0x25 密钥标识 块号 密钥 数值 校验字 密钥标识 :1 字节, 密钥标识 块号 :1 字节, 要充值的钱包块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡片的密钥 数值 :4 字节, 钱包增加值, 低字节在前 帧头 0x25 校验字 帧头 0xDA 校验字 发送 :0x FF FF FF FF FF FF 返回 :0x MIFARE 1K/4K 钱包扣款 功能 : 把 MIFARE 1K/4K 的一个钱包进行减值 钱包的格式使用 MIFARE 1K/4K 默认的格式 减值的意思是在原有钱包值的基础上减少, 扣款只需要卡片的 读 权限就可进行 帧头 0x26 密钥标识块号密钥数值校验字密钥标识 :1 字节, 密钥标识块号 :1 字节, 要扣款的钱包块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 密钥 :6 字节, 卡片的密钥数值 :4 字节, 扣款值, 低字节在前 帧头 0x26 校验字 版权所有 北京金木雨电子有限公司保留所有权利 40/106

42 帧头 0xD9 校验字 发送 :0x FF FF FF FF FF FF 返回 :0x MIFARE 1K/4K 备份钱包 功能 : 把 MIFARE 1K/4K 的一个钱包备份到同一扇区中的另外一块中 钱包的格式使 用 MIFARE 1K/4K 默认的格式 帧头 0x27 密钥标识 来源 目标 密钥 校验字 密钥标识 :1 字节, 密钥标识 来源 :1 字节, 需要备份的钱包块逻辑编号,S50 卡从 0 到 0x3F;S70 卡从 0 到 0xFF 目标 :1 字节, 钱包目的块逻辑编号 ( 来源和目标需要在同一个扇区里 ) 密钥 :6 字节, 卡片的密钥 帧头 0x27 校验字 帧头 0xD8 校验字 发送 :0x000D FF FF FF FF FF FF 29 返回 :0x ISO14443A 卡休眠 功能 : 把当前操作的包含 MIFARE 系列和其他所有符合 ISO14443A 标准的卡片设定为 休眠状态 帧头 0x28 校验字 帧头 0x28 校验字 版权所有 北京金木雨电子有限公司保留所有权利 41/106

43 帧头 0xD7 校验字 发送 :0x C 返回 :0x D 下载 MIFARE 1K/4K 卡片密钥到模块中 功能 : 把 MIFARE 1K/4K 卡片的密钥下载到模块中 模块中有 32 个密钥存储空间, 可 以存储 32 个不同的密钥 在使用下载到模块中的密钥时, 这个密钥不会出现在射频基站的 引脚上, 可以防止被不法分子窃取, 保密性更强 因为 EEPROM 是有写的次数限制的, 因 此, 不可频繁使用此命令, 这会造成 EEPROM 的失效而导致设备故障 帧头 0x2D 密钥索引 密钥 校验字 密钥索引 :1 字节, 在模块中储存此密钥的编号, 编号取值从 0 到 0x1F 密钥 :6 字节, 需要保存在模块里的密钥 帧头 0x2D 校验字 帧头 0xD2 校验字 发送 :0x000B 00 2D 00 FF FF FF FF FF FF 26 返回 :0x D 有关密钥标识 在 MIFARE 1K/4K 读卡写卡等指令序列中有一字节密钥标识, 此字节用于模块来识别用什么方式获得操作卡片的密钥 KeyIdentification BIT7 BIT6 BIT5 BIT4 BIT3 BIT2 BIT1 BIT0 BIT0=0: 密钥 A;BIT0=1: 密钥 B; BIT1=0: 使用指令中的密钥 ;BIT1=1: 使用由命令 0x2D 下载到模块中的密钥 版权所有 北京金木雨电子有限公司保留所有权利 42/106

44 BIT6:BIT5:BIT4:BIT3:BIT2: 如果使用已经下载的密钥, 在这里指名密钥编号 BIT7=0: 该块使用上述密钥进行认证 BIT7=1: 该块已经认证通过, 本次操作不需认证操作如果指令中的 BIT1=0, 则 BIT6:BIT5:BIT4:BIT3:BIT2 的数据与本次操作卡片无关, 如果指令中的 BIT1=1, 则使用已经下载的密钥, 密钥编号为 BIT6:BIT5:BIT4:BIT3:BIT2, 同时, 指令中的后续 6 字节密钥 就变成与本次操作卡片无关的数据了 例如 : 一个密钥标识为 0x00, 二进制为 : , 此时 : BIT0 = 0; 代表认证卡片的 A 密钥 BIT1 = 0; 代表使用已经命令中的密钥 BIT6:BIT5:BIT4:BIT3:BIT2 为 :00000, 由于不使用已经下载的密钥, 此时这个密钥索引在本条命令中无用 例如 : 一个密钥标识为 0x33, 二进制为 : , 此时 : BIT0 = 1; 代表认证卡片的 B 密钥 BIT1 = 1; 代表使用已经下载到模块中的密钥 BIT6:BIT5:BIT4:BIT3:BIT2 为 :01100, 那么, 就使用已经下载的第 号密钥,16 进制为 0x0C,10 进制就是 12 版权所有 北京金木雨电子有限公司保留所有权利 43/106

45 5.6 MIFARE Ultralight/Ultralight C/Ultralight EV1 卡命令 MIFARE Ultralight/Ultralight C/Ultralight EV1 寻卡 MIFARE Ultralight/Ultralight C/Ultralight EV1 的寻卡请参照 :ISO14443A 寻卡 MIFARE Ultralight/Ultralight C/Ultralight EV1 读卡 功能 : 读取 Ultralight 或 Ultra Light C 卡中数据 对于 Ultralight, 每次读可以得到 4 块 或指定数量块数的数据, 如果读取起始块为最后一块, 那么读出块号是循环的 帧头 0x41 读取起始块 校验字 或 帧头 0x41 读取起始块 N 校验字 读取起始块 :1 字节, 读取起始块号 N: 读取块数, 如不输入块数则为默认 4 块, 参数仅支持 4 的倍数, 如 :4,8,12, 16, 最大数量仅受卡片存储空间限制 帧头 0x41 数据 校验字 数据 :4 N 字节数据, 每次读操作读取起始块号开始的 4 块数据 帧头 0xBE 校验字 发送 :0x ( 默认读取 4 块, 共 16 字节 ) 返回 :0x FF AD 发送 :0x A ( 读取 8 块, 共 32 字节 ) 返回 :0x FF FF AD MIFARE Ultralight/Ultralight C/Ultralight EV1 写卡 功能 : 写入数据到 Ultra Light 或 Ultra Light C 卡中 每次写 1 块数据 版权所有 北京金木雨电子有限公司保留所有权利 44/106

46 帧头 0x42 块号 数据 校验字 块号 :1 字节, 需要写入的数据块逻辑编号 数据 : 写入的 4 字节数据 帧头 0x42 校验字 帧头 0xBD 校验字 发送 :0x E 返回 :0x MIFARE UltraLightC 认证密钥 功能 : 输入 UltraLight C 的密钥, 设备直接认证密钥, 认证过程由模块控制 帧头 0x43 密钥 校验字 密钥 : 16 字节的 UltraLight C 密钥 帧头 0x43 校验字 帧头 0xBC 校验字 发送 :0x D 4B E F 返回 :0x MIFARE UltraLightC 读取 Ek(RndB) 功能 : 读取 UltraLight C 卡片产生的加密 RndB;0x44 和 0x45 指令是 Ultra Light C 认证的分离指令, 因为单片机计算 3DES 会比较慢, 因此认证也就比较耗时, 因此把认证部分分离出来可以让用户去计算 3DES 以节约认证的时间 用户可以先考虑用 0x43 去认证, 如果有认证速度上的要求, 那么可以联系我们获得技术支持后使用分离认证指令 版权所有 北京金木雨电子有限公司保留所有权利 45/106

47 帧头 0x44 校验字 帧头 0x44 Ek(RndB) 校验字 Ek(RndB): 卡片返回的 RndB 加密数据 使用卡片的密钥对 RndB 进行 DES 解密 ; 解密后进行字节移位, 首字节移动到最后, 得到 RndB ; 此时 Ek(RndB) 为后续的 3DES CBC 算法的初始向量 帧头 0xBB 校验字 发送 :0x 返回 :0x00 0C AB 8B F AF 14 AC MIFARE UltraLight C 认证 Ek(RndA+RndB ) 功能 : 输入加密好的 RndA+RndB 帧头 0x45 Ek(RndA+RndB ) 校验字 Ek(RndA+RndB ): 使用 DES CBC 对 RndA+RndB 进行加密的 16 字节结果 ;RndA 为用户自己指定的 8 字节随机数,RndB 由 0x44 指令获得的 RndB 经解密移位获得 ( 首字节移动到最后 ); 帧头 0x45 Ek(RndA) 校验字 帧头 0xBA 校验字 Ek(RndA): 卡片返回的加密 RndA;3DES CBC 解密并移位后与 RndA 比较, 若相等则认证通过 发送 :0x E 30 F6 C C0 BE DE C 9F F0 98 返回 :0x00 0C F6 C C0 BE 6E 4D 版权所有 北京金木雨电子有限公司保留所有权利 46/106

48 5.6.7 Ultralight EV1 读卡片版本号 功能 : 读取 Ultralight EV1 卡片的版本号 帧头 0x46 校验字 帧头 0x46 版本信息 校验字 版本信息 :8 字节版本信息 帧头 0xB9 校验字 发送 :0x 返回 :0x000C B Ultralight EV1 快速读取数据 功能 : 快速读取 Ultralight EV1 卡片的数据 帧头 0x47 起始块号结束块号校验字起始块号 :1 字节, 开始读取的块号结束块号 :1 字节, 读取结束的块号 帧头 0x47 卡片数据校验字卡片数据 : 块数 * 4 字节卡片数据 帧头 0xB8 校验字 发送 :0x 返回 :0x001C F A1 42 F A 版权所有 北京金木雨电子有限公司保留所有权利 47/106

49 5.6.9 Ultralight EV1 读计数器 功能 : 读取 Ultralight EV1 卡片内计数器的数据 帧头 0x48 地址 校验字 地址 :1 字节, 计数器的地址 帧头 0x48 数据 校验字 数据 :3 字节计数器数据 帧头 0xB7 校验字 发送 :0x D 返回 :0x Ultralight EV1 计数器递增 功能 :Ultralight EV1 卡片内计数器的数据递增 帧头 0x49 地址 数据 校验字 地址 :1 字节, 计数器的地址 数据 :3 字节计数器递增数据 帧头 0x49 校验字 帧头 0xB6 校验字 发送 :0x 返回 :0x C 版权所有 北京金木雨电子有限公司保留所有权利 48/106

50 Ultralight EV1 认证密钥 功能 :Ultralight EV1 卡片认证密钥 帧头 0x4A 密钥 校验字 密钥 :4 字节, 卡片密钥 帧头 0x4A 校验字 帧头 0xB5 校验字 发送 :0x A FF FF FF FF 42 返回 :0x A D Ultralight EV1 读取签名 功能 : 读取 Ultralight EV1 卡片签名 帧头 0x4B 校验字 帧头 0x4B 签名 校验字 签名 :32 字节签名数据 帧头 0xB4 校验字 发送 :0x B 4F 返回 :0x B 6F DA EF C9 87 1A DB D0 CF 66 4D 47 F7 0A C9 EC 2E EC 7C FD 81 FF 74 4B 2E F 4D Ultralight EV1 读取卡片计数器的 Tearing 事件 功能 : 读取 Ultralight EV1 卡片计数器的 Tearing 事件 版权所有 北京金木雨电子有限公司保留所有权利 49/106

51 帧头 0x8C 地址 校验字 地址 :1 字节, 计数器地址 帧头 0x8C 标志 校验字 标志 :1 字节, 计数器合法标志 帧头 0x73 校验字 发送 :0x C 返回 :0x C BD Ultralight EV1 读取虚拟卡片信息 功能 : 读取 Ultralight EV1 卡片的虚拟卡片标识 帧头 0x8D 安装标识射频描述校验字安装标识 :16 字节, 安装标识 (IID) 射频描述 :4 字节, 射频基站能力标识 (PCDCAPS) 帧头 0x8D 标识校验字标识 :1 字节, 虚拟卡片标识符 (VCTID) 帧头 0x72 校验字 发送 :0x D 返回 :0x D 05 8C 版权所有 北京金木雨电子有限公司保留所有权利 50/106

52 5.7 MIFARE Plus 卡命令 JMY600 系列读卡模块提供了操作 MIFARE Plus 卡的命令通道,MIFARE Plus 卡是 NXP 公司推出的用于代替 MIFARE 1 卡的产品, 我们提供的应用层指令都是基于层级 3 的, 在卡片的层级 3 中, 加密认证采用 AES 加密算法 JMY600 系列读卡模块在与卡片通讯的过程中, 全部采用加密数据 + 命令带 MAC+ 响应带 MAC 的方式, 与卡片的射频通讯过程中的数据安全性极高 使用以下的命令可以使用户快速开展 MIFARE Plus 的研发任务, 对于高级用户, 也可以使用 ISO 的通道对卡片进行操作, 这样就可以绕开我们在下面提供的这些操作 MIFARE Plus 的命令, 完全自己操控加密过程, 完全自己掌握安全性 当然, 这样也会让用户在研发过程中有巨大投入, 如果不是大型系统, 可以不必考虑这种方式 卡片准备命令 MIFARE Plus 寻卡 MIFARE Plus 的寻卡请参照 :ISO14443A 寻卡 MIFARE Plus 卡复位请参照 :ISO TYPE A 卡复位 (RATS) MIFARE Plus 寻卡并复位此命令会寻卡并对卡片复位, 请参照 : 按照 EMV 或 PBOC 的规范寻卡 卡片初始化命令 MIFARE Plus Write Perso 功能 : 初始化 AES 密钥及其所有块的初始值, 有关这些块的地址范围和应先择的默认值, 请参考 MIFARE Plus 的 datasheet 或咨询我们 帧头 0x33 块地址数据校验字块地址 :2 字节 ( 高字节在前 ), 数据 :16 字节 版权所有 北京金木雨电子有限公司保留所有权利 51/106

53 帧头 0x33 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xCC 校验字 发送 :0x FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 65 返回 :0x MIFARE Plus Commit Perso 功能 :Level 0 指令, 从 Level0 切换到 Level1 或者 Level3, 切换到的 Level 取决于卡 片, 需要在卡片订货时说明是 Level 1 或 Level 3, 在使用此指令前需要先使用 MIFARE Plus Write Perso 指令写入所有 AES Key 及其他块的初始值, 然后才能使用此指令使改动生效 帧头 0x34 校验字 帧头 0x34 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xCB 校验字 发送 :0x 返回 :0x MIFARE Plus 切换到 Level2/3 功能 :Level 1 或 Level 2 指令, 将卡片功能切换到 Level2 或者 Level3 帧头 0x35 目标层级 密钥 校验字 目标层级 :1 字节,2: 层级 2;3: 层级 3 密钥 :16 字节 帧头 0x35 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 版权所有 北京金木雨电子有限公司保留所有权利 52/106

54 见表格 : 卡片返回的状态码 帧头 0xCA 校验字 发送 :0x FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 23 返回 :0x 卡片应用层命令 MIFARE Plus 授权数据块功能 :Level 3 指令, 只对数据块进行授权 帧头 0x36 密钥类型块地址密钥校验字密钥类型 :0:A 密钥 ;1:B 密钥块地址 :2 字节 ( 高字节在前 ) 密钥 :16 字节 帧头 0x36 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC9 校验字 发送 :0x FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 24 返回 :0x MIFARE Plus 读数据块功能 :Level 3 指令, 对数据块进行读操作, 读前要对相应块进行授权 帧头 0x37 起始块号块数校验字起始块号 :2 字节 ( 高字节在前 ) 要读的块数 :1 字节 版权所有 北京金木雨电子有限公司保留所有权利 53/106

55 帧头 0x37 状态码数据校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码数据 : 块数 16 字节 ( 不成功无此部分 ) 帧头 0xC8 校验字 发送 :0x 返回 :0x FF FF FF FF FA 05 FA MIFARE Plus 写数据块功能 :Level 3 指令, 对数据块进行写操作, 写前要对相应块进行授权 帧头 0x38 起始块号块数数据校验字起始块号 :2 字节 ( 高字节在前 ) 块数 :1 字节, 要写入的块数数据 : 要写的数据, 块数 16 字节 帧头 0x38 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC7 校验字 发送 :0x FF FF FF FF FA 05 FA 2A 返回 :0x D MIFARE Plus 创建钱包功能 :Level 3 指令, 用初始值创建钱包 帧头 0x39 块号钱包值校验字块号 :2 字节 ( 高字节在前 ), 要建立钱包的数据块编号钱包值 :4 字节 ( 低字节在前 ), 钱包初始值 版权所有 北京金木雨电子有限公司保留所有权利 54/106

56 帧头 0x39 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC6 校验字 发送 :0x00 0A 返回 :0x C MIFARE Plus 读钱包余额功能 :Level 3 指令读取钱包余额 帧头 0x3A 块号校验字块号 :2 字节 ( 高字节在前 ) 帧头 0x3A 状态码数据校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码数据 :4 字节钱包余额 ( 不成功无此部分 ) 帧头 0xC5 校验字 发送 :0x A 返回 :0x A MIFARE Plus 钱包充值功能 :Level 3 指令, 给钱包充值 帧头 0x3B 块号钱包增加值校验字块号 :2 字节 ( 高字节在前 ) 钱包增加值 :4 字节 ( 低字节在前 ) 版权所有 北京金木雨电子有限公司保留所有权利 55/106

57 帧头 0x3B 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC4 校验字 发送 :0x00 0A 00 3B 返回 :0x B 3E MIFARE Plus 钱包扣款功能 :Level 3 指令, 给钱包扣款 帧头 0x3C 块号钱包扣款值校验字块号 :2 字节 ( 高字节在前 ) 钱包扣款值 :4 字节 ( 低字节在前 ) 帧头 0x3C 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC3 校验字 发送 :0x00 0A 00 3C 返回 :0x C MIFARE Plus 备份钱包功能 :Level3 指令, 备份钱包到同一扇区的另一块 帧头 0x3D 源块号目地块号校验字源块号 :2 字节 ( 高字节在前 ) 目地块号 :2 字节 ( 高字节在前 ) 帧头 0x3D 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 版权所有 北京金木雨电子有限公司保留所有权利 56/106

58 见表格 : 卡片返回的状态码 帧头 0xC2 校验字 发送 :0x D 返回 :0x D MIFARE PlusFirst Authenticate 功能 :Level 1/3 指令, 在 Level 3 该指令主要在对块读写等操作前对块进行 AES 密钥认证授权 包括数据块 配置块 AES 密钥块等所有块进行授权操作, 然后进行读写 帧头 0x3E AES Key 地址 AES Key 值校验字 AES Key 地址 :2 字节 ( 高字节在前 ) AES Key 值 :16 字节 帧头 0x3E 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC1 校验字 发送 :0x E FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 6A 返回 :0x E 3B MIFARE PlusFollowing Authenticate 功能 :Level 1/3 指令, 在 Level 3 该指令主要在对非数据块读写等操作前对块重新进行 AES 密钥认证授权, 一般应用场合可以不用 主要在 First authenticate 认证后, 需要认证时, 可以用此指令 帧头 0x3F AES Key 地址 AES Key 值校验字 AES Key 地址 :2 字节 ( 高字节在前 ) AES Key 值 :16 字节 版权所有 北京金木雨电子有限公司保留所有权利 57/106

59 帧头 0x3F 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0xC0 校验字 发送 :0x F FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 6B 返回 :0x F 3A 版权所有 北京金木雨电子有限公司保留所有权利 58/106

60 5.7.4 卡片返回的状态码 MIFARE Plus 卡片操作后会给出执行结果, 下表指示了这些可能的状态 HEX 编码 状态 解释 0x90 OPERATION_SUCCESS 操作正常结束 0x06 AUTHENTICATION_ERROR 认证条件不满足 不存在的块 以数值格式访问的块不是一个数值块 0x07 COMMAND_OVERFLOW 在一个任务中的明文读写命令次数溢出 0x08 INVALID_MAC MAC 错 0x09 INVALID_BLOCK_NUMBER 非法的块号 0x0A NOT_EXIST_BLOCK_NUMBER 不存在的块号 0x0B CONDITIONS_NOT_SATISFIED 使用条件不满足 0x0C LENGTH_ERROR 长度错误 0x0F GENERAL_MANIPULATION_ERROR 卡片内部错误 版权所有 北京金木雨电子有限公司保留所有权利 59/106

61 5.8 DESfire 卡命令 我们在此提供了分立的操作 DESfire 卡片的命令,DESfire 卡片的加密认证与通讯过程采用 DES 加密算法,JMY600 系列读卡模块在与卡片通讯的过程中, 完全按照用户对卡片的加密设定进行与卡片的通讯, 如果用户设定了与卡片的射频通讯过程是加密的, 那么与卡片的射频通讯过程中的数据安全性极高 使用以下的命令可以使用户快速开展 DESfire 的研发任务, 当然, 对于高级用户, 也可以使用 ISO 的通道对 DESfire 卡片进行操作, 这样就可以完全绕开我们在下面提供的这些操作 DESfire 的命令, 完全自己操控加密过程, 完全自己掌握安全性 当然, 这样也会让用户在研发过程中有巨大投入, 如果不是大型系统, 可以不必考虑这种方式 卡片准备命令 DESfire 寻卡 DESfire 的寻卡请参照 :ISO14443A 寻卡 DESfire 卡复位 请参照 :ISO TYPE A 卡复位 (RATS) DESfire 寻卡并复位 此命令会寻卡并对卡片复位, 请参照 : 按照 EMV 或 PBOC 的规范寻卡 DESFire Authenticate 功能 : 卡片与读写器三重相互认证, 认证的密钥编号可以是主控密钥或任何其他密钥 本命令是上位机把密钥发给读卡模块, 由模块进行加解密并与卡片交互获得认证 结果 对于高级用户, 用户可以自己控制认证过程以提高安全性, 我们提供了额外的 认证接口, 参见 0x8E:DESFire Authenticate first step Get ekno(rndb) 和 0x8F:DESFire Authenticate second step get ekno(rnda ), 对于提高保密性能有帮助, 但操作相对复杂 对于所有有关卡片操作中的加密解密方法, 请参照 datasheet 进行加密计算, 或使 用我们提供的工具以及可参考的源代码, 如果需要帮助, 请联系我们 帧头 0x90 密钥号 密钥 校验字 密钥号 :1 字节 版权所有 北京金木雨电子有限公司保留所有权利 60/106

62 密钥 :16 字节 帧头 0x90 状态码 过程密钥 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 过程密钥 :16 字节, 只有认证通过才会有过程密钥返回, 过程密钥在后续的卡片操作 中会用到, 在加密的通讯过程中的加密数据都需要使用此密钥来加解密 帧头 0x6F 校验字 发送 :0x 返回 :0x CC 6C E D 1B C 67 A DESFire Authenticate first step Get ekno(rndb) 功能 : 模块发起认证, 从卡片获得 ekno(rndb) 帧头 0x8E 密钥号 校验字 密钥号 :1 字节 帧头 0x8E 状态码 ekno(rndb) 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 在此状态码为 0xAF 是正确的, 需要由上位机提供进一 步的数据, 后续命令必须为 :DESFire Authenticate second step get ekno(rnda ) 才能进 行继续进行认证 ekno(rndb):8 字节, 卡片产生的随机数, 由指定认证的密钥进行加密后的结果 模 块得到后使用正确密钥进行解密计算, 可以得到 RndB 帧头 0x71 校验字 发送 :0x E 00 8B 返回 :0x00 0D 01 8E AF 28 EA 37 7B 60 A0 DC F8 47 版权所有 北京金木雨电子有限公司保留所有权利 61/106

63 DESFire Authenticate second step get ekno(rnda ) 功能 : 上位机产生随机数 RndA, 并与 RndB 进行组合后使用正确密钥加密, 通过模块发送给卡片, 从卡片获得 RndA,RndA 经过移位后, 如果与 RndA 相等, 此时即可与卡片获得相互认证 帧头 0x8F dkno(rnda+rndb ) 校验字 dkno(rnda+rndb ):16 字节 帧头 0x8F 状态码 ekno(rnda ) 校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 ekno(rnda ): 加密的上位机随机数, 使用正确密钥解密后即可还原, 经过移位后如果与 RndA 相等, 那么认证通过 后续过程密钥 :16 字节, 由 RndA 和 RndB 组合得到如下公式 : Senssion key = RndA[0..3]+RndB[0..3]+RndA[4..7]+RndB[4..7] 过程密钥在后续的卡片操作中会用到, 在加密的通讯过程中的加密数据都需要使用此过程密钥来加解密 帧头 0x70 校验字 发送 :0x F 42 FF CF C7 87 A B9 CC B8 A5 E7 70 C6 F5 66 返回 :0x00 0D 01 8F C A C DESFire Select Application 功能 : 选择指定的卡片应用 以后的指令将针对这个应用产生作用 帧头 0x98 应用标识校验字应用标识 :3 字节, 低字节在前 帧头 0x98 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 版权所有 北京金木雨电子有限公司保留所有权利 62/106

64 帧头 0x67 校验字 发送 :0x EF 返回 :0x C 卡片初始化命令 DESfireFormat Card 功能 : 格式化卡片, 卡片所有应用和应用下的所有文件都被删除 帧头 0x99 校验字 帧头 0x99 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x67 校验字 发送 :0x D 返回 :0x D DESFire Create Application 功能 : 建立新的卡片应用 帧头 0x95 应用标识 密钥设置 密钥数量 校验字 应用标识 :3 字节, 低字节在前 密钥设置 :1 字节 密钥数量 :1 字节 帧头 0x95 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 版权所有 北京金木雨电子有限公司保留所有权利 63/106

65 帧头 0x6A 校验字 发送 :0x EF 返回 :0x DESFire Change Key Settings 功能 : 修改主控密钥 / 应用主密钥的密钥设置信息 指令执行过程中数据采用 DES/3DES 加密和 CRC 校验 帧头 0x91 新的密钥设置信息 校验字 新的密钥设置信息 : 经过加密的 8 字节信息 帧头 0x91 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x6E 校验字 发送 :0x00 0C F C B1 C9 EA 返回 :0x DESFire Get Key Settings 功能 : 取得主控密钥 / 应用主密钥的当前密钥设置信息 帧头 0x92 校验字 密钥号 :1 字节 帧头 0x92 状态码 密钥信息 密钥个数 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 密钥设置信息 :1 字节 密钥个数 :1 字节 版权所有 北京金木雨电子有限公司保留所有权利 64/106

66 帧头 0x6D 校验字 发送 :0x 返回 :0x EF 0C DESFire Change Key 功能 : 修改存储在卡片内的任何密钥 该指令执行过程中数据采用 DES/3DES 加密和 CRC 校验 帧头 0x93 密钥 ID 加密密钥数据 校验字 密钥 ID:1 字节 加密密钥数据 :24 字节 ( 请参照 datasheet 进行加密计算, 或使用我们提供的工具以及 可参考的源代码 ) 帧头 0x93 状态码 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x6C 校验字 发送 :0x00 1D B5 30 7D 8F 42 7E D4 E3 C2 9B 0E 2B F0 A8 9D E 62 1F FE C8 00 BA 返回 :0x DESFire Get Key Version 功能 : 取得当前密钥版本信息 帧头 0x94 密钥号 校验字 密钥号 :1 字节 帧头 0x94 状态码 密钥版本信息 校验字 状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 版权所有 北京金木雨电子有限公司保留所有权利 65/106

67 见表格 : 卡片返回的状态码密钥版本信息 :1 字节 帧头 0x6B 校验字 发送 :0x 返回 :0x F DESFire Delete Application 功能 : 删除指定的卡片应用 帧头 0x96 应用标识校验字应用标识 :3 字节, 低字节在前 帧头 0x96 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x69 校验字 发送 :0x A 4D 59 CF 返回 :0x DESFire Get Version 功能 : 该函数返回卡片的制造业的相关数据 帧头 0x9A 校验字 帧头 0x9A 状态码数据校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码数据 :28 字节卡片的制造业的相关数据 版权所有 北京金木雨电子有限公司保留所有权利 66/106

68 帧头 0x65 校验字 发送 :0x A 9E 返回 :0x A B 30 9A 4F BA A E DESFire Get Application IDs 功能 : 该函数返回卡片当前所有应用的应用标识符 帧头 0x97 校验字 帧头 0x97 状态码应用标识校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码应用标识 : 每个应用标识长度为 3 字节, 长度为 : 标识个数 3 字节 帧头 0x68 校验字 发送 :0x 返回 :0x00 0B A 4D 07 4A 4D 59 C DESFire Get File IDs 功能 : 取卡片当前应用目录下的所有文件的文件标识符 帧头 0x9B 校验字 帧头 0x9B 状态码文件标识校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码文件标识 : 每个文件标识长度为 1 字节, 总长度为文件个数 1 字节 帧头 0x64 校验字 发送 :0x B 9F 版权所有 北京金木雨电子有限公司保留所有权利 67/106

69 返回 :0x B DESFire Get FileSettings 功能 : 取当前应用目录下的指定文件的设置信息 帧头 0x9C 文件标识校验字文件标识 :1 字节 帧头 0x9C 状态码数据校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码数据 : 根据文件类型的不同长度有所不同, 具体情况如下 : 数据文件 :1 字节文件类型 +1 字节通讯设置 +2 字节访问权限 +3 字节文件大小 数值文件 :1 字节文件类型 +1 字节通讯设置 +2 字节访问权限 +4 字节最小值 +4 字节最大值 +4 字节当前最大限存金额 +1 字节是否支持限存 记录文件 :1 字节文件类型 +1 字节通讯设置 +2 字节访问权限 +3 字节记录大小 +3 字节最大记录数 +3 字节当前记录数 ( 注 : 以上多字节数据均为低字节在前 ) 帧头 0x63 校验字 发送 :0x C 返回 :0x C EE EE DESFire Change File Settings 功能 : 修改卡片当前应用目录下的指定文件的设置信息 明文 : 帧头 0x9D 文件标识通信设置文件权限校验字密文 : 帧头 0x9D 文件标识设置信息校验字文件标识 :1 字节通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密 版权所有 北京金木雨电子有限公司保留所有权利 68/106

70 文件权限 :2 字节 ( 低字节在前 ) 加密的设置信息 :8 字节,1 字节通讯设置 +2 字节文件权限 +2 字节 CRC+3 字节 0x00 经加密得到 帧头 0x9D 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x62 校验字 发送 :0x D 返回 :0x D DESFire Create Std Data File 功能 : 在卡片当前应用目录下的建新的标准数据文件 帧头 0x9E 文件标识通信设置操作权限文件长度校验字文件标识 :1 字节通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密操作权限 :2 字节 ( 低字节在前 ) 文件长度 :3 字节 ( 低字节在前 ) 帧头 0x9E 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x61 校验字 发送 :0x00 0B 00 9E EE EE 返回 :0x E 00 9A DESFire Create Backup Data File 功能 : 在卡片当前应用目录下建新的数据文件, 支持备份机制 卡片给该文件分配的 版权所有 北京金木雨电子有限公司保留所有权利 69/106

71 空间总是大于或等于文件大小的两倍, 且为 32 的倍数 帧头 0x9F 文件标识通信设置操作权限文件长度校验字文件标识 :1 字节通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密操作权限 :2 字节 ( 低字节在前 ) 文件长度 :3 字节 ( 低字节在前 ) 帧头 0x9F 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x60 校验字 发送 :0x00 0B 00 9F EE EE 返回 :0x F 00 9B DESFire Create Value File 功能 : 在卡片当前应用目录下的建新的数值文件, 支持备份机制 帧头 0xA0 文件标识 通信设置 操作权限 最小值 最大值 初始值 是否限存 校验字 文件标识 :1 字节通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密操作权限 :2 字节 ( 低字节在前 ) 最小值 :4 字节 ( 有符号整型, 低字节在前 ) 最大值 :4 字节 ( 有符号整型, 低字节在前 ) 初始值 :4 字节 ( 有符号整型, 低字节在前 ) 是否限存 :1 字节,0: 不限制 ;1: 限制 帧头 0xA0 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 版权所有 北京金木雨电子有限公司保留所有权利 70/106

72 见表格 : 卡片返回的状态码 帧头 0x5F 校验字 发送 :0x A EE EE B4 返回 :0x A0 00 A DESFire Create Linear Record File 功能 : 在卡片当前应用目录下的建新的线性记录文件, 支持备份机制 帧头 0xA1 文件标识 通信设置 操作权限 记录大小 最大记录个数 校验字 文件标识 :1 字节通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密操作权限 :2 字节 ( 低字节在前 ) 记录大小 :3 字节 ( 低字节在前 ), 单个记录的字节数最大记录个数 :3 字节 ( 低字节在前 ), 记录文件的条目数量 帧头 0xA1 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x5E 校验字 发送 :0x00 0E 00 A A7 返回 :0x A1 00 A DESFire Create Cyclic Record File 功能 : 在卡片当前应用目录下的建新的循环记录文件 帧头 0xA2 文件标识 通信设置 操作权限 记录大小 最大记录个数 校验字 文件标识 :1 字节 通信设置 :1 字节,0: 明文传输 ;1:MAC 码校验 ;3:DES/3DES 加密 版权所有 北京金木雨电子有限公司保留所有权利 71/106

73 操作权限 :2 字节 ( 低字节在前 ) 记录大小 :3 字节 ( 低字节在前 ), 单个记录的字节数最大记录个数 :3 字节 ( 低字节在前 ), 记录文件的条目数量 帧头 0xA2 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x5D 校验字 发送 :0x00 0E 00 A EE EE AA 返回 :0x A2 00 A DESFire Delete File 功能 : 删除卡片当前应用目录下指定的文件 帧头 0xA3 文件标识校验字文件标识 :1 字节 帧头 0xA3 状态码校验字状态码 : 由卡片返回的执行结果代码, 指与卡片通讯成功, 但执行条件不符合等错误, 见表格 : 卡片返回的状态码 帧头 0x5C 校验字 发送 :0x A3 06 A0 返回 :0x A3 00 A 卡片应用层命令 DESFire Read Data 功能 : 读取卡片当前目录下指定数据文件 ( 标准数据文件或备份数据文件 ) 的数据 版权所有 北京金木雨电子有限公司保留所有权利 72/106