ICS 35.240.50 CCS L 65
GB
中华人民共和国国家标准
GB/T42030—2022
智能制造 射频识别系统超高频读写器应用编程接口
Intelligent manufacturing--Radio frequency identification system-
Application programming interface(API) for UHF readers
2023-05-01实施
2022-10-12发布
国家市场监督管理总局
国家标准化管理委员会 发布 GB/T42030—2022
目 次
前言 1 范围 2 规范性引用文件 3
术语和定义缩略语概述 5.1 交互机制 5.2 接口描述 6 数据类型定义
5
连接访问功能接口 7.1 建立连接 7.2 断开连接 7.3 联机请求 7.4 停止设备当前操作 7.5 设置执行超时时间 8设备配置功能接口 8.1 读取设备信息 8.2 读取设备工作参数 8.3 设置设备工作参数· 8.4 读取设备寄存器 8.5 设置设备寄存器 8.6 保存设备寄存器.. 8.7 复位设备寄存器 8.8 进入设备休眠模式， 8.9 恢复设备出厂模式 8.10 读取设备天线端口 8.11 设置设备天线端口 8.12 设备固件升级请求 8.13 设备固件升级校验 8.14 发送固件升级数据包 9标签操作访问功能接口 9.1 标签分类参数设置： 9.2 单次识别 9.3 启动循环识别 9.4 获取标签识别号 9.5 单次读取指定标签
7
X
10 10 10
12 12 13 14
14
15 15 16
16 17 18 18 18 19 20 20 21 I GB/T42030—2022
9.6 单次读取任意标签 9.7 启动循环读取指定标签 9.8 启动循环读取任意标签 9.9 获取读标签数据 9.10 单次写入指定标签 9.11 单次写入任意标签 9.12 启动循环写人指定标签 9.13 启动循环写入任意标签 9.14 获取写标签数据 9.15 单次擦除指定标签 9.16 单次擦除任意标签 9.17 启动循环擦除指定标签 9.18 启动循环擦除任意标签 9.19 获取擦除标签数据 9.20 单次锁定指定标签 9.21 单次锁定任意标签 9.22 启动循环锁定指定标签 9.23 启动循环锁定任意标签 9.24 获取锁定标签数据 9.25 单次销毁指定标签 9.26单次销毁任意标签 9.27 启动循环销毁指定标签 9.28启动循环销毁任意标签 10触发信号功能接口 10.1查询GPIO状态 10.2触发GPIO事件 11 安全管理访问功能接口 11.1 生成随机数 11.2认证请求 11.3认证开始 11.4 认证结束 11.5 设备认证密钥更新 11.6 口令更新附录A（规范性） 映射表
22 22 23 24 25 26 26 27 28 29 30 30 31 32 33 33 34 35 35 36 37 37 38 39 39 39 40 40 41 41 42 43 43 45
...
= GB/T 42030—2022
前言
本文件按照GB/T1.1一2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由全国信息技术标准化技术委员会（SAC/TC28)提出并归口。 本文件起草单位：中国电子技术标准化研究院、北京中科佐迪克电子科技发展有限公司、睿芯联科
（北京）电子科技有限公司、广东中科臻恒信息技术有限公司、北京智芯微电子科技有限公司、四川华大恒芯科技有限公司、上海天臣微纳米科技股份有限公司、爱康普科技（大连)有限公司、青岛海尔洗衣机有限公司、高新兴智联科技有限公司、紫光同芯微电子有限公司、品冠物联科技有限公司。
本文件主要起草人：刘文莉、冯敬、王大庆、管超、王立、金学明、王文赫、时汉、姚茜、周吉天白、 张倩倩、周立雄、冯进、孟毅、王金龙、孙晓红、蒋宗清。
I GB/T42030—2022
智能制造射频识别系统超高频读写器应用编程接口
1范围
本文件规定了超高频射频识别读写器和客户端之间进行交互的规则及表达方式。 本文件适用于超高频射频识别读写器和客户端的设计、生产、测试和使用。
2规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
GB/T16262（所有部分）信息技术抽象语法记法一（ASN.1) GB/T29261.3一2012信息技术自动识别和数据采集技术词汇第3部分：射频识别 GB/T29768一2013信息技术射频识别800/900MHz空中接口协议
3术语和定义
GB/T29261.3一2012界定的以及下列术语和定义适用于本文件。
3.1
参数 parameter 定义或影响一个动作所需要的信息。
3.2
应用编程接口applicationprogramminginterface 软件系统不同组成部分衔接的约定。
4缩略语
下列缩略语适用于本文件。 GPIO：通用输人输出（General-PurposeInput/Output) UII：惟一标识符（UniqueItemIdentifier)
5概述
5.1交互机制
一个客户端可同时连接多个读写器。 一个读写器同一时刻只能连接一个客户端。
1 GB/T42030—2022
客户端通过调用应用编程接口传递消息，控制读写器、访问标签。
5.2接口描述
本文件第7章到第11章分别针对连接访问等6类接口详细描述各个接口。 这些接口描述独立于编程语言，接口表达方式符合GB/T16262（所有部分）。每个接口分以下5项
进行描述：
a） 功能说明一一给出该接口的主要功能；如，连接访问类接口中“建立连接”这个接口的功能说明
是：此接口功能是在客户端应用程序和读写器之间建立连接端口。 b) 接口定义一一给出该接口的定义；如，连接访问类接口中“建立连接”这个接口的接口定义是：
OUTReturnCodeuhfReaderConnect( IN PortType cPort, OUTHandleconnectionHandle);
c） 参数说明一-给出该接口的主要参数；如，连接访问类接口中“建立连接”这个接口的参数说
明是： cPort（输人)端口 connectionHandle（输出）通信端口句柄
d）先决条件—给出执行该接口时所需具备的先决条件；有些接口的执行无需先决条件。如，连
接访问类接口中“建立连接”这个接口没有先决条件。连接访问类接口中“联机请求”这个接口有以下先决条件：已获取有效的connectionHandle。
e）返回码一用抽象语法记法一（ASN.1)的规则给出该返回码的定义，指出收到该接口后应返
回的代码；如，连接访问类接口中“建立连接”这个接口的返回码是： ret ReturnCode ::{ UHF_API_OKI UHF_API_INCORRECT_PARAMETER UHF_API_NOT_AVAILABLE UHF_API_COMMUNICATION_FAILURE 1
6数据类型定义
本文件中描述的数据类型采用GB/T16262（所有部分）的规定。
AddresS：：=OCTETSTRING--存储器地址数据类型是八位位组串
AntInfoType：：=BITSTRING-天线端口数据类型是位串
anto(0), antl(1),
2 GB/T 42030—2022
ant2(2), ant3(3), ant4(4), ant5(5), ant6(6), ant7(7), . ant127(127)
1 BankIndexType：：=INTEGER(0..63)-存储区编码数据类型是整数
BOOL：：=BOOLEAN-布尔类型
DataLength：：INTEGER-数据字节长度数据类型是整数
DataOctet：：=OCTETSTRING-数据内容的数据类型是八位位组串
DataTypeInfo：：=SEQUENCE-读取到的标签数据的数据类型是序列
antAntInfoType，-天线端口的数据类型是AntInfoType WordsOCTETSTRING，-标签数据字的数据类型是八位位组串 lenINTEGER-words长度数据类型是整数
1
DataType：：=CHOICE-标签返回数据的数据类型是选择 (
ant_uii_dataDataTypeUII，一数据、UII和天线数据类型是DataTypeUII ant_dataDataTypeInfo-数据和天线数据类型是DataTypeInfo
1
DataTypeUII::=SEQUENCE 一惟一标识数据的数据类型是序列 1
ant_uiiTagInfoType，一天线与惟一标识符UII的数据类型是TagInfoType WordsOCTETSTRING，一存储区数据内容的数据类型是八位位组串 lenINTEGER-words长度的数据类型是整数
1
EnumMode：：=ENUMERATED-标签识别方式的数据类型是枚举
single(1)，一表示采用单标签识别的方式
3 GB/T42030—2022
multiple(2）一表示采用多标签识别的方式
1
EnumType：：=ENUMERATED-设备工作参数的数据类型是枚举 1
power(1)，-表示功率参数 fhss(2），--表示频率参数 modulation(3)，--表示读写器调制方式参数 backScattered-link-frequency(4），一表示标签反向链路频率参数 encoding（5），一表示标签编码选择参数 tc(6)，一表示前向链路基准时间T。参数 trext(7）--表示前导信号指示TRe参数
FirmwareType：：=SEQUENCE一固件信息数据类型是序列
SnOCTETSTRING，--设备惟一序列号的数据类型是八位位组串 hardversionPrintableString，一设备硬件版本的数据类型是可打印字符串 firmwareversionPrintableString一设备固件版本的数据类型是可打印字符串
1
FloatType：：=REAL一浮点数据类型是实数
GPioEventType：：=SEQUENCE-GPIO事件数据类型是序列
portINTEGER，--端口号的数据类型是整数 triggerModeENUMERATED(--触发方式的数据类型是枚举
fallTrigger(0），一表示下降沿触发方式 riseTrigger(1)），一表示上升沿触发方式 forwardStateENUMERATED一触发后状态的数据类型是枚举
low-level(0），-表示低电平状态 high-level(1）），一表示高电平状态
delayTimeType，一触发延迟时间的数据类型是TimeType periodTimeType一触发后状态保持时间的数据类型是TimeType
1
GpioStateType：：=SEQUENCE-GPIO状态数据类型是序列 (
portINTEGER，一端口号的数据类型是整数 triggerModeENUMERATED(一触发方式的数据类型是枚举
4