GB/T 42030-2022 智能制造 射频识别系统 超高频读写器应用编程接口

　　ICS 35 . 240 . 50 CCS L 65

　　中 华 人 民 共 和 国 国 家 标 准

　　GB/T 42030—2022

　　智能制造 射频识别系统

　　超高频读写器应用编程接口

　　Intelligentmanufacturing—Radiofrequencyidentificationsystem—

　　Applicationprogramminginterface(API)forUHF readers

　　2022-10-12 发布 2023-05-01 实施

　　国家市场监督管理总局国家标准化管理委员会

　　

　　发

　　

　　布

　　GB/T 42030—2022

　　目 次

　　前言 Ⅲ

　　1 范围 1

　　2 规范性引用文件 1

　　3 术语和定义 1

　　4 缩略语 1

　　5 概述 1

　　5 . 1 交互机制 1

　　5 . 2 接口描述 2

　　6 数据类型定义 2

　　7 连接访问功能接口 7

　　7 . 1 建立连接 7

　　7 . 2 断开连接 7

　　7 . 3 联机请求 8

　　7 . 4 停止设备当前操作 9

　　7 . 5 设置执行超时时间 9

　　8 设备配置功能接口 10

　　8 . 1 读取设备信息 10

　　8 . 2 读取设备工作参数 10

　　8 . 3 设置设备工作参数 11

　　8 . 4 读取设备寄存器 12

　　8 . 5 设置设备寄存器 12

　　8 . 6 保存设备寄存器 13

　　8 . 7 复位设备寄存器 14

　　8 . 8 进入设备休眠模式 14

　　8 . 9 恢复设备出厂模式 15

　　8 . 10 读取设备天线端口 15

　　8 . 11 设置设备天线端口 16

　　8 . 12 设备固件升级请求 16

　　8 . 13 设备固件升级校验 17

　　8 . 14 发送固件升级数据包 18

　　9 标签操作访问功能接口 18

　　9 . 1 标签分类参数设置 18

　　9 . 2 单次识别 19

　　9 . 3 启动循环识别 20

　　9 . 4 获取标签识别号 20

　　9 . 5 单次读取指定标签 21

　　I

　　GB/T 42030—2022

　　9 . 6 单次读取任意标签 22

　　9 . 7 启动循环读取指定标签 22

　　9 . 8 启动循环读取任意标签 23

　　9 . 9 获取读标签数据 24

　　9 . 10 单次写入指定标签 25

　　9 . 11 单次写入任意标签 26

　　9 . 12 启动循环写入指定标签 26

　　9 . 13 启动循环写入任意标签 27

　　9 . 14 获取写标签数据 28

　　9 . 15 单次擦除指定标签 29

　　9 . 16 单次擦除任意标签 30

　　9 . 17 启动循环擦除指定标签 30

　　9 . 18 启动循环擦除任意标签 31

　　9 . 19 获取擦除标签数据 32

　　9 . 20 单次锁定指定标签 33

　　9 . 21 单次锁定任意标签 33

　　9 . 22 启动循环锁定指定标签 34

　　9 . 23 启动循环锁定任意标签 35

　　9 . 24 获取锁定标签数据 35

　　9 . 25 单次销毁指定标签 36

　　9 . 26 单次销毁任意标签 37

　　9 . 27 启动循环销毁指定标签 37

　　9 . 28 启动循环销毁任意标签 38

　　10 触发信号功能接口 39

　　10 . 1 查询 GPIO状态 39

　　10 . 2 触发 GPIO事件 39

　　11 安全管理访问功能接口 40

　　11 . 1 生成随机数 40

　　11 . 2 认证请求 41

　　11 . 3 认证开始 41

　　11 . 4 认证结束 42

　　11 . 5 设备认证密钥更新 43

　　11 . 6 口令更新 43

　　附录 A (规范性) 映射表 45

　　Ⅱ

　　GB/T 42030—2022

　　前 言

　　本文件按照 GB/T 1 . 1—2020《标准化工作导则 第 1 部分:标准化文件的结构和起草规则》的规定起草 。

　　请注意本文件的某些内容可能涉及专利 。本文件的发布机构不承担识别专利的责任 。

　　本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归口 。

　　本文件起草单位:中国电子技术标准化研究院 、北京中科佐迪克电子科技发展有限公司 、睿芯联科(北京)电子科技有限公司 、广东中科臻恒信息技术有限公司 、北京智芯微电子科技有限公司 、四川华大恒芯科技有限公司 、上海天臣微纳米科技股份有限公司 、爱康普科技(大连)有限公司 、青岛海尔洗衣机有限公司 、高新兴智联科技有限公司 、紫光同芯微电子有限公司 、品冠物联科技有限公司 。

　　本文件主要起草人:刘文莉 、冯敬 、王大庆 、管超 、王立 、金学明 、王文赫 、时汉 、姚茜 、周吉天 白 、张倩倩 、周立雄 、冯进 、孟毅 、王金龙 、孙晓红 、蒋宗清 。

　　Ⅲ

　　GB/T 42030—2022

　　智能制造 射频识别系统

　　超高频读写器应用编程接口

　　1 范围

　　本文件规定了超高频射频识别读写器和客户端之间进行交互的规则及表达方式 。

　　本文件适用于超高频射频识别读写器和客户端的设计 、生产 、测试和使用 。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中 , 注 日期的引用文件 , 仅该日期对应的版本适用于本文件;不注日期的引用文件 , 其最新版本(包括所有的修改单)适用于本文件 。

　　GB/T 16262(所有部分) 信息技术 抽象语法记法一(ASN. 1)

　　GB/T 29261 . 3—2012 信息技术 自动识别和数据采集技术 词汇 第 3 部分:射频识别GB/T 29768—2013 信息技术 射频识别 800/900 MHz 空中接口协议

　　3 术语和定义

　　GB/T 29261 . 3—2012 界定的以及下列术语和定义适用于本文件 。

　　3.1

　　参数 parameter

　　定义或影响一个动作所需要的信息 。

　　3.2

　　应用编程接口 application programming interface

　　软件系统不同组成部分衔接的约定 。

　　4 缩略语

　　下列缩略语适用于本文件 。

　　GPIO:通用输入输出(General-Purpose Input/Output)

　　UII:惟一标识符(Unique Item Identifier)

　　5 概述

　　5 . 1 交互机制

　　一个客户端可同时连接多个读写器 。

　　一个读写器同一时刻只能连接一个客户端 。

　　1

　　GB/T 42030—2022

　　客户端通过调用应用编程接口传递消息 , 控制读写器 、访问标签 。

　　5 . 2 接口描述

　　本文件第 7 章到第 11 章分别针对连接访问等 6 类接口详细描述各个接口 。

　　这些接口描述独立于编程语言 , 接口表达方式符合 GB/T16262(所有部分) 。每个接口分以下 5 项进行描述:

　　a) 功能说明 — 给出该接口的主要功能;如 , 连接访问类接口中“建立连接”这个接口的功能说明是:此接口功能是在客户端应用程序和读写器之间建立连接端口 。

　　b) 接口定义 — 给出该接口的定义;如 , 连接访问类接口中“建立连接”这个接口的接口定义是: OUT ReturnCode uhfReaderconnect(

　　IN PortType cport ,

　　OUT Handle connectionHandle) ;

　　c) 参数说明— 给出该接 口 的主要参数;如 , 连接访问类接 口 中“建立连接”这个接 口 的参数说明是:

　　cport (输入)端 口

　　connectionHandle (输出)通信端口句柄

　　d) 先决条件 — 给出执行该接口时所需具备的先决条件;有些接口的执行无需先决条件 。如 , 连接访问类接口中“建立连接”这个接口没有先决条件 。连接访问类接口中“联机请求”这个接口有以下先决条件:

　　已获取有效的 connectionHandle 。

　　e) 返回码 — 用抽象语法记法一(ASN. 1)的规则给出该返回码的定义 , 指出收到该接口后应返回的代码;如 , 连接访问类接口中“建立连接”这个接口的返回码是:

　　ret ReturnCode : :={

　　UHF一API一 OK|

　　UHF一API一INCORRECT一PARAMETER|

　　UHF一API一NOT一AVAILABLE|

　　UHF API COMMUNICATION FAILURE

　　一 一 一

　　}

　　6 数据类型定义

　　本文件中描述的数据类型采用 GB/T 16262(所有部分)的规定 。

　　Address: : =OCTET STRING--存储器地址数据类型是八位位组串

　　AntInfoType: : =BIT STRING--天线端口数据类型是位串

　　{

　　ant0(0) ,

　　ant1(1) ,

　　2

　　GB/T 42030—2022

　　ant2(2) ,

　　ant3(3) ,

　　ant4(4) ,

　　ant5(5) ,

　　ant6(6) ,

　　ant7(7) ,

　　..

　　ant127(127)

　　}

　　BankIndexType: :=INTEGER(0 . . 63)--存储区编码数据类型是整数

　　BOOL: : =BOOLEAN --布尔类型

　　DataLength: : INTEGER--数据字节长度数据类型是整数

　　DataOctet: : =OCTET STRING--数据内容的数据类型是八位位组串

　　DataTypeInfo : : =SEQUENCE--读取到的标签数据的数据类型是序列{

　　ant AntInfoType , --天线端口的数据类型是 AntInfoType

　　words OCTET STRING, --标签数据字的数据类型是八位位组串

　　len INTEGER--words 长度数据类型是整数 }

　　DataType: : =CHOICE--标签返回数据的数据类型是选择{

　　ant-uii-data DataTypeUII , --数据 、UII 和天线数据类型是 DataTypeUII

　　ant-data DataTypeInfo --数据和天线数据类型是 DataTypeInfo }

　　DataTypeUII: : =SEQUENCE--惟一标识数据的数据类型是序列{

　　ant-uii TagInfoType , --天线与惟一标识符 UII 的数据类型是 TagInfoType

　　words OCTET STRING, --存储区数据内容的数据类型是八位位组串

　　len INTEGER--words 长度的数据类型是整数 }

　　EnumMode: : =ENUMERATED--标签识别方式的数据类型是枚举{

　　single(1) , --表示采用单标签识别的方式

　　3

　　GB/T 42030—2022

　　multiple(2) --表示采用多标签识别的方式 }

　　EnumType: : =ENUMERATED--设备工作参数的数据类型是枚举

　　{

　　power(1) , --表示功率参数

　　fhss(2) , --表示频率参数

　　modulation(3) , --表示读写器调制方式参数

　　backscattered-link-frequency(4) , --表示标签反向链路频率参数

　　encoding(5) , --表示标签编码选择参数

　　tc(6) , --表示前向链路基准时间 Tc 参数

　　trext(7) --表示前导信号指示 TRext 参数 }

　　FirmwareType: : =sEQUENCE--固件信息数据类型是序列

　　{

　　sn OCTET sTRING, --设备惟一序列号的数据类型是八位位组串

　　hardversion printablestring , --设备硬件版本的数据类型是可打印字符串

　　firmwareversion printablestring --设备固件版本的数据类型是可打印字符串

　　}

　　FloatType: : =REAL--浮点数据类型是实数

　　GpioEventType: : =sEQUENCE--GpIO事件数据类型是序列

　　{

　　port INTEGER, --端口号的数据类型是整数

　　triggerMode ENUMERATED{ --触发方式的数据类型是枚举fallTrigger(0) , --表示下降沿触发方式

　　riseTrigger(1)} , --表示上升沿触发方式

　　forwardstate ENUMERATED{ --触发后状态的数据类型是枚举low-level(0) , --表示低电平状态

　　high-level(1)} , --表示高电平状态

　　delay TimeType , --触发延迟时间的数据类型是 TimeType

　　period TimeType --触发后状态保持时间的数据类型是 TimeType }

　　GpiostateType: : =sEQUENCE--GpIO状态数据类型是序列

　　{

　　port INTEGER, --端口号的数据类型是整数

　　triggerMode ENUMERATED{ --触发方式的数据类型是枚举

　　4

　　GB/T 42030—2022

　　fallTrigger(0) , --表示下降沿触发方式

　　riseTrigger(1)} , --表示上升沿触发方式

　　currentState EnumState , --当前状态数据类型是 EnumState

　　period INTEGER--触发保持时间的数据类型是整数 }

　　Handle: : =ANY --句柄数据类型是任意

　　KeyIndexType: : =INTEGER(0 . . 36) --密钥索引号的数据类型是整数

　　LocKModeType: : =ENUMERATED--标签锁定方式的数据类型是枚举

　　{

　　read-write(0) , --表示可读可写方式

　　read-writeUnable(1) , --表示可读不可写方式

　　readUnable-write(2) , --表示不可读可写方式

　　readUnable-writeUnable(3) , --表示不可读不可写方式

　　noAuthentication(5) , --表示不需要鉴别方式

　　authentication-noSecurity(6) , --表示需要鉴别 , 不需要安全通信方式

　　authentication-Security(7) --表示需要鉴别 , 需要安全通信方式 }

　　PortType : :=PrintableString(PATTERN” IP:((2[0—4]/d| 25[0—5] | [01]? /d/d?)/ . ) {3} (2 [0—4]/d|25[0—5]| [01]? /d/d?) ” |PATTERN” COM/d# (1 , ) : d+ ” ) --连接端口数据类型是可打印字符串

　　ReaderDataType: : CHOICE--读写器数据类型是选择

　　{

　　power-value REAL, --功率数值的数据类型是实数

　　fhss-value SEQUENCE OF INTEGER(0 . . 39) , --跳频信道号的数据类型是单一序列modulation-code ENUMERATED{ --调制方式的数据类型是枚举

　　DSB-ASK(0) , --表示读写器 DSB-ASK调制方式

　　SSB-ASK(1)} , --表示读写器 SSB-ASK调制方式

　　blf-factor ENUMERATED{ --反向链路频率因子 K 数据类型是枚举

　　one-fifth(0) , --表示 K=1/5

　　three-seventh(1) , --表示 K=3/7

　　six-eleventh(2) , --表示 K=6/11

　　one(3) , --表示 K =1

　　two-fifth(4) , --表示 K=2/5

　　six-seventh(5) , --表示 K=6/7

　　twelve-eleventh(6) , --表示 K=11/12

　　two(7)} , --表示 K =2

　　5

　　GB/T 42030—2022

　　encoding—value ENUMERATED{ --编码方式的数据类型是枚举

　　fm0(0) , --表示反向链路编码 FM0

　　miller2(1) , --表述反向链路编码米勒编码 M 为 2

　　miller4(2) , --表示反向链路编码米勒编码 M 为 4

　　miller8(3)} , --表示反向链路编码米勒编码 M 为 8

　　tc-value ENUMERATED{ --Tc 值得数据类型是枚举

　　time625(0) , --表示 Tc =6 . 25 μs

　　time125(1)} , --表示 Tc =12 . 5 μs

　　trext-value ENUMERATED{ --Trext 值得数据类型是枚举

　　no-preamble(0) , --表示无前导信号

　　with-preamble(1)} --表示有前导信号 }

　　ReturnCode: : =INTEGER(0 . . 255) --接口返回码数据类型是整数

　　RN: : =BIT STRING--随机数数据类型是位串

　　RN32 : : =BIT STRING(SIZE(32)) --32 位随机数数据类型是位串

　　SortparamType: : =SEQUENCE--分类命令参数数据类型是序列

　　{

　　sort-bank BankIndexType , --分类命令存储区数据域数据类型是 BankIndexType

　　sort-target BIT STRING(SIZE(4)) , --分类命令目标数据域类型是位串

　　sort-action BIT STRING(SIZE(2)) , --分类命令规则数据域数据类型是位串

　　sort-addr BIT STRING(SIZE(16)) , --分类命令指针数据域数据类型是位串

　　sort-length BIT STRING(SIZE(8)) , --分类命令长度数据域数据类型是位串

　　sort-mask BIT STRING, --分类命令掩码数据域数据类型是位串

　　query-match BIT STRING(SIZE(2)) , --启动查询命令条件数据域数据类型是位串

　　query-target BIT STRING(SIZE(1)) --启动查询命令目标数据域数据类型是位串 }

　　SysInfoType: : =SEQUENCE--系统信息数据类型是序列

　　{

　　mode printableString , --工作模式数据类型是可打印字符串

　　protocol printableString , --空中接口协议数据类型是可打印字符串 , 默认为 “ GB/T 29768— 2013 ”

　　parameters printableString --安全参数数据类型是可打印字符串 }

　　TagInfoType: : =SEQUENCE--对应天线端口的标签信息的数据类型是序列

　　6

　　GB/T 42030—2022

　　{

　　antport AntInfoType , --天线端口数据的数据类型是 AntInfoType

　　uii OCTET STRING--标签惟一标识符的数据类型是八位位组串 }

　　TimeType: : =INTEGER--时间(ms)数据类型是整数

　　7 连接访问功能接口

　　7 . 1 建立连接

　　7 . 1 . 1 功能说明

　　此接口功能是在客户端应用程序和读写器之间建立连接端口 。

　　7 . 1 . 2 接口定义

　　OUT ReturnCode uhfReaderconnect(

　　IN PortType cport ,

　　OUT Handle connectionHandle );建立连接功能的接 口

　　7 . 1 . 3 参数说明

　　cport (输入)端 口

　　示例 1 : IP:192 . 168 . 1 . 2

　　示例 2 : COM2 : 9600

　　connectionHandle (输出)通信端口句柄

　　7 . 1 . 4 先决条件

　　无

　　7 . 1 . 5 返回码

　　ret ReturnCode : :={

　　UHF-API-OK|

　　UHF-API-INCORRECT-PARAMETER|

　　UHF-API-NOT-AVAILABLE|

　　UHF API COMMUNICATION FAILURE

　　- - -

　　}

　　返回码应符合附录 A 中 A. 1 的要求 。

　　7 . 2 断开连接

　　7 . 2 . 1 功能说明

　　此接口功能是关闭客户端应用程序和读写器之间已建立的端口连接 。

　　7

　　GB/T 42030—2022

　　7 . 2 . 2 接口定义

　　OUT ReturnCode uhfReaderDisconnect(

　　IN Handle connectionHandle );断开连接功能的接 口

　　7 . 2 . 3 参数说明

　　connectionHandle (输入)通信端口句柄

　　7 . 2 . 4 先决条件

　　已获取有效的 connectionHandle 。

　　7 . 2 . 5 返回码

　　ret ReturnCode : :={

　　UHF-API-OK|

　　UHF-API-INCORRECT-PARAMETER|

　　UHF-API-COMMUNICATION-FAILURE}

　　返回码应符合 A. 1 的要求 。

　　7 . 3 联机请求

　　7 . 3 . 1 功能说明

　　此接口功能对读写器发送联机请求 , 可返回读写器是否连接 、读写器工作模式 、工作协议以及密钥参数 。

　　7 . 3 . 2 接口定义

　　OUT ReturnCode uhfReaderonlineRequest(

　　IN Handle connectionHandle ,

　　OUT SYSInfoTYpe systemInfo );联机请求功能的接 口

　　7 . 3 . 3 参数说明

　　connectionHandle (输入)通信端口句柄

　　systemInfo (输出)系统信息 , 包括工作模式 、工作环境 、密钥参数

　　7 . 3 . 4 先决条件

　　已获取有效的 connectionHandle 。

　　7 . 3 . 5 返回码

　　ret ReturnCode : :={

　　UHF-API-OK|

　　UHF API COMMUNICATION FAILURE

　　- - -

　　}

　　8