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

ICSCCS35.240.50GB/T42030—2022智能制造射频识别系统超高频读写器应用编程接口Applicationprogramminginterface(API)forUHFreaders国家市场监督管理总局国家标准化管理委员会IGB/T42030—2022 1 1 5.1交互机制 5.2接口描述 2 2 77.1建立连接 77.2断开连接 77.3联机请求 87.4停止设备当前操作 97.5设置执行超时时间 98设备配置功能接口 8.1读取设备信息 8.2读取设备工作参数 8.3设置设备工作参数 8.4读取设备寄存器 8.5设置设备寄存器 8.6保存设备寄存器 8.8进入设备休眠模式 8.9恢复设备出厂模式 8.11设置设备天线端口 8.13设备固件升级校验 8.14发送固件升级数据包 9标签操作访问功能接口 9.1标签分类参数设置 9.2单次识别 9.3启动循环识别 9.4获取标签识别号 9.5单次读取指定标签 Ⅱ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.1查询GPIO状态 10.2触发GPIO事件 11安全管理访问功能接口 11.2认证请求 11.3认证开始 11.4认证结束 11.5设备认证密钥更新 附录A(规范性)映射表 ⅢGB/T42030—2022本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本文件起草单位：中国电子技术标准化研究院、北京中科佐迪克电子科技发展有限公司、睿芯联科(北京)电子科技有限公司、广东中科臻恒信息技术有限公司、北京智芯微电子科技有限公司、四川华大恒芯科技有限公司、上海天臣微纳米科技股份有限公司、爱康普科技(大连)有限公司、青岛海尔洗衣机1GB/T42030—2022智能制造射频识别系统超高频读写器应用编程接口本文件规定了超高频射频识别读写器和客户端之间进行交互的规则及表达方式。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文本文件。GB/T16262(所有部分)信息技术抽象语法记法一(ASN.1)GB/T29261.3—2012信息技术自动识别和数据采集技术词汇第3部分：射频识别GB/T29768—2013信息技术射频识别800/900MHz空中接口协议GB/T29261.3—2012界定的以及下列术语和定义适用于本文件。3.1定义或影响一个动作所需要的信息。3.2软件系统不同组成部分衔接的约定。4缩略语下列缩略语适用于本文件。GPIO:通用输入输出(General-PurposeInput/Output)UII:惟一标识符(UniqueItemIdentifier)5概述一个客户端可同时连接多个读写器。一个读写器同一时刻只能连接一个客户端。2GB/T42030—2022本文件第7章到第11章分别针对连接访问等6类接口详细描述各个接口。这些接口描述独立于编程语言，接口表达方式符合GB/T16262(所有部分)。每个接口分以下5项进行描述：a)功能说明——给出该接口的主要功能；如，连接访问类接口中“建立连接”这个接是：此接口功能是在客户端应用程序和读写器之间建立连接端口。OUTReturnCodeuhfReaderConnect(c)参数说明——给出该接口的主要参数；如，连接访问类接口中“建立连接”这个接口的参数说cPort(输入)端口connectionHandle(输出)通信端口句柄d)先决条件——给出执行该接口时所需具备的先决条件；有些接口的执行无需先决条件。如，连有以下先决条件：已获取有效的connectionHandle。e)返回码———用抽象语法记法一(ASN.1)的规则给出该返回码的定义，指出收到该接口后应返UHF_API_INCORRECT_PARAMETERUHF_API_NOT_AVAILABLEUHF_API_COMMUNICATION_FAILURE6数据类型定义本文件中描述的数据类型采用GB/T16262(所有部分)的规定。Address::=OCTETSTRING--存储器地址数据类型是八位位组串AntInfoType::=BITSTRING--天线端口数据类型是位串{antl(1).3GB/T42030—2022一BankIndexType::=INTEGER(0..63)--存储区编码数据类型是整数BOOL::=BOOLEAN-DataLength::INTEGERDataOctet::=OCTET布尔类型STRING-数据内容的数据类型是八位位组串DataTypeInfo::=SEQUENCE-读取到的标签数据的数据类型是序列{antAntInfoType,-天线端口的数据类型是AntInfoTypeDataType::=CHOICE-标签返回数据的数据类型是选择{ant_dataDataTypeInfo-数据和天线数据类型是DataTypeInfoDataTypeUII::=SEQUENCEant_uiiTagInfoType,--天线与惟一标识符UII的数据类型是TagInfoTypeEnumMode::=ENUMERATED-标签识别方式的数据类型是枚举{4GB/T42030—2022multiple(2)--表示采用多标签识别的方式}EnumType::=ENUMERATED--设备工作参数的数据类型是枚举{power(1),--表示功率参数fhss(2),--表示频率参数modulation(3),--表示读写器调制方式参数backScattered-link-frequency(4),-表示标签反向链路频率参数encoding(5),--表示标签编码选择参数tc(6),--表示前向链路基trext(7)--表示前导信号指示TRext参数FirmwareType::=SEQUENCE-固件信息数据类型是序列{snOCTETSTRING,--设备惟一序列号的数据类型是八位位组串hardversionPrintableString,-设备硬件版本的数据类型是可打印字符串firmwareversionPrintableString--设备固件版本的数据类型是可打印字符串}FloatType::=REAL--浮点数据类型是实数GPioEvent{Type::=SEQUENCE--GPIO事件数据类型是序列portINTEGER,--端口号的数据类型是整数triggerModeENUMERATED{-触发方式的数据类型是枚举riseTrigger(1)},--表示上升沿触发方式forwardStateENUMERATED{--触发后状态的数据类型是枚举low-level(0),-表示低电平状态high-level(1)},--表示高电平状态delayTimeType,--触发延迟时间的数据类型是TimeTypeperiodTimeType--触发后状态保持时间的数据类型是TimeType}GpioStateType::=SEQUENCE--GPIO状态数据类型是序列{portINTEGER,--端口号的数据类型是整数triggerModeENUMERATED{-触发方式的数据类型是枚举5fallTrigger(0),--riseTrigger(1)},--表示上升沿触发方式currentStateEnumState,一当前状态数据类型是EnumStateperiodINTEGER--触发保持时间的数据类型是整数}Handle::=ANY--句柄数据类型是任意KeyIndexType::=INTEGER(0..36)--LockModeType::=ENUMERATED-{密钥索引号的数据类型是整数标签锁定方式的数据类型是枚举readUnable-writeUnable(3),-表示不可读不可写方式authentication-noSecurity(6),--表示需要鉴别，不需要安全通信方式}PortType::=PrintableString(PATTERN”IP:((2[0-4]\d|25[0-5]|[01]?[0-4]\d|25[0-5]|[01]?\d\d?)”|PATTERN”COM\d#(1,):d+”)-连接端口数据类型是可打印字符串{power_valueREAL,--功率数值的数据类型是实数modulation_codeENUMERATED{-调制方式的数据类型是枚举blf_factorENUMERATED{--反向链路频率因子K数据类型是枚举one-fifth(0),-表示K=1/5six-eleventh(2),--表示K=6/11two-fifth(4),--表示K=2/5six-seventh(5),-表示K=6/7twelve-eleventh(6),--表示K=11/126)GB/T42030—2022)encoding—valueENUMERATED{--编码方式的数据类型是枚举fm0(0),--表示反向链路编码FM0 表述反向链路编码米勒编码M为2miller4(2), 表示反向链路编码米勒编码M为4miller8(3)}, 表示反向链路编码米勒编码M为8tc-valueENUMERATED{--T。值得数据类型是枚举time125(1)},-表示T。=12.5μstrext-value}ENUMERATED{--Trext值得数据类型是枚举no-preamble(0),-表示无前导信号with-preamble(1)}--表示有前导信号ReturnCode::=INTEGER(0..255)--接口返回码数据类型是整数RN::=BITSTRING--随机数数据类型是位串RN32::=BITSTRING(SIZE(32))-32位随机数数据类型是位串SortParamType::=SEQUENCE--分类命令参数数据类型是序列sort-bankBankIndexType,--分类命令存储区数据域数据类型是BankIndexTypesort-targetBITSTRING(SIZE(4)),--分类命令目标数据域类型是位串sort-actionBITSTRING(SIZE(2)),-分类命令规则数据域数据类型是位串sort-addrBITSTRING(SIZE(16)),--分类命令指针数据域数据类型是位串sort-lengthBITSTRING(SIZE(8)),-分类命令长度数据域数据类型是位串sort-maskBITSTRING,-分类命令掩码数据域数据类型是位串query-matchBITquery-targetBIT}{STRING(SIZE(2)),-启动查询命令条件数据域数据类型是位串STRING(SIZE(1))-启动查询命令目标数据域数据类型是位串--系统信息数据类型是序列modePrintableString,--工作模式数据类型是可打印字符串protocolPrintableString,--空中接口协议数据类型是可打印字符串，默认为“GB/T29768—2013”parametersPrintableString--安全参数数据类型是可打印字符串TagInfoType::=SEQUENCE-对应天线端口的标签信息的数据类型是序列7GB/T42030—2022{antportAntInfoType,-uiiOCTETSTRING--标签惟一标识符的数据类型是八位位组串TimeType::=INTEGER--时间(ms)数据类型是整数7连接访问功能接口此接口功能是在客户端应用程序和读写器之间建立连接端口。OUTReturnCodeuhfReaderConnect(INPortTypecPort,OUTHandleconnectionHandle);建立连接功能的接口cPort(输入)端口示例1:IP:192.168.1.2示例2:COM2:9600connectionHandle(输出)通信端口句柄无retReturnCode::={UHF_API_OK|UHF_API_INCORRECT_PARAMETER|UHF_API_NOT_AVAILABLEUHF_API_COMMUNICATION_FAILURE}返回码应符合附录A中A.1的要求。此接口功能是关闭客户端应用程序和读写器之间已建立的端口连接。8GB/T42030—2022OUTReturnCodeuhfReaderDisconnect(INHandleconnectionHandle);断开连接功能的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_INCORRECT_PARAMETER|UHF_API_COMMUNICATION_FAILURE}参数。OUTReturnCodeuhfReaderOnlineRequest(INHandleconnectionHandle.OUTSysInfoTypesystemInfo);联机请求功能的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE9GB/T42030—2022返回码应符合A.1的要求。此接口功能是停止读写器当前的操作。OUTReturnCodeuhfReaderStopOperation(INHandleconnectionHandle);停止设备当前操作的接口connectionHandle(输入)通信端口句柄7.4.4先决条件已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE)返回码应符合A.1的要求。此接口功能是设置本文中API接口函数超时时间。7.5.2接口定义OUTReturnCodeuhfReaderApiExpiredTime(INTimeTypeexpiredTime);设置执行超时时间的接口expiredTime(输入)执行某一API接口函数返回UHF_API_COMMUNICATION_FAILURE时需要等待的时间(ms)无GB/T42030—2022UHF_API_OKUHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。8设备配置功能接口OUTReturnCodeuhfReaderGetFirmwareInfo(INHandleconnectionHandle,已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。OUTReturnCodeuhfReaderGetInfo(INHandleconnectionHandle,OUTReaderDataTypeinfo);读取设备工作参数GB/T42030—2022connectionHandle(输入)通信端口句柄info(输出)读写器当前工作参数已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。此接口功能是设置读写器的工作参数。8.3.2接口定义INHandleconnectionHandle,connectionHandle(输入)通信端口句柄flag(输入)参数类别info(输入)读写器工作参数已获取有效的connectionHandle。UHF_API_OKUHFAPICOMMUNICATIONFAILURE}返回码应符合A.1的要求。8.4读取设备寄存器此接口功能是读取设备寄存器的数据。OUTReturnCodeuhfReaderGetRegister(INHandleconnectionHandle,INDataLengthregLength,OUTDataOctetregisterInfo,8.4.4先决条件已获取有效的connectionHandle。8.4.5返回码retReturnCode::={UHF_API_OKUHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。8.5设置设备寄存器此接口功能是设置设备寄存器的数据，掉电之后设置内容失效，恢复为最后一次调用uhfReader-SaveRegister接口时的数据。8.5.2接口定义OUTReturnCodeuhfReaderSetRegister(INHandleconnectionHandle,INAddressregAddress,))INDataLengthregLength,INDataOctetregisterInfo,INDataLengthlength);设置设备寄存器的接口registerInfo(输入)寄存器的内容length(输入)registerInfo数据的长度已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHFAPIOKUHF_API_COMMUNICATION_FAILUREGB/T42030—2022返回码应符合A.1的要求。此接口功能是恢复设备寄存器的默认设置。OUTReturnCodeuhfReaderResetRegister(INHandleconnectionHandle);复位设备寄存器的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。8.8进入设备休眠模式此接口功能是设置读写器进入休眠模式。8.8.2接口定义OUTReturnCodeuhfReaderEnterSleepMode(INHandleconnectionHandle);进入设备休眠模式的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。8.9恢复设备出厂模式此接口功能是恢复设备出厂模式。OUTReturnCodeuhfReaderFactoryReset(INHandleconnectionHandle,connectionHandle(输入)通信端口句柄rn32(输入)已获取的读写器32位随机数已获取有效的connectionHandle,先调用uhfReaderGenerateRandom获取读写器32位随机数。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。8.10读取设备天线端口8.10.1功能说明此接口功能是读取设备的在用天线端口。OUTReturnCodeuhfReaderGetAntenna(INHandleconnectionHandle,8.10.3参数说明connectionHandle(输入)通信端口句柄antInfo(输出)天线在用天线端口号GB/T42030—2022已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。8.11设置设备天线端口此接口功能是设置读写器天线端口。OUTReturnCodeuhfReaderSetAntenna(INHandleconnectionHandle,connectionHandle(输入)通信端口句柄antInfo(输入)天线端口号已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。此接口功能是请求对读写器固件进行升级。OUTReturnCodeuhfReaderFirmwareUpdateRequest(connectionHandle(输入)通信端口句柄rn32(输出)32位随机数已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAI}此接口功能是对读写器的固件进行升级校验。OUTReturnCodeuhfReaderFirmwareUpdateCheck(connectionHandle(输入)通信端口句柄rn32(输入)设备固件升级请求uhfReaderFirmwareUpdateRequest返回的32位随机数取反已获取有效的connectionHandle,先调用uhfReaderFirmwareUpdateRequest获取32位随机数。UHF_API_COMMUNICATION_FAIGB/T42030—2022此接口功能是向读写器发送固件升级数据包。OUTReturnCodeuhfReaderFirmwareUpdate(INHandleconnectionHandle,INDataLengthpackLength,connectionHandle(输入)通信端口句柄packData(输入)升级包数据packLength(输入)升级包数据长度isLastPack(输入)是否是最后升级包已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。9标签操作访问功能接口此接口功能是设置分类命令和启动查询命令的参数。OUTReturnCodeuhfSortParam(INHandleconnectionHandle,GB/T42030—2022connectionHandle(输入)通信端口句柄sortInfo(输入)命令参数已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。此接口功能是进行单次标签识别。OUTReturnCodeuhfInventoryOnce(INHandleconnectionHandle,OUTTagInfoTypetagInfo);单次识别的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK返回码应符合A.1的要求。9.3启动循环识别此接口功能是开启读写器的循环识别模式，停止该模式使用uhfReaderStopOperation接口。9.3.2接口定义OUTReturnCodeuhfInventoryLoopStart(INHandleconnectionHandle,connectionHandle(输入)通信端口句柄mode(输入)循环识别模式，包括单标签循环模式和多标签循环模式已获取有效的connectionHandle。retReturnCode::={UHFAPIOKUHF_API_COMMUNICATION_FAILURE}9.4获取标签识别号此接口功能是读取读写器的循环识别读到的标签识别号，这些标签识别号是通过uhfInventory-LoopStart接口获得。9.4.2接口定义OUTReturnCodeuhfInventoryLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,connectionHandle(输入)通信端口句柄length(输出)tagInfo的长度GB/T42030—20229.4.4先决条件UHF_API_OK|UHFAPICOMMUNICATIONFAILURE返回码应符合A.1的要求。此接口功能是对指定标签的单次数据读取。OUTReturnCodeuhfINHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址wordLength(输入)需要返回的字长已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|22GB/T42030—2022UHF_API_ADDRESS_OVERFLOWIUHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。此接口功能是对未指定标签的单次数据读取。OUTReturnCodeuhfReadAnyTagOnce(INHandleconnectionHandle,INBankIndexTypebankIndex,INDataOctetstartAddress,INDataLengthwordLength,OUTDataTypeUIIdataInfoUII);单次读取任意标签的接口connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址wordLength(输入)需要返回的字长dataInfoUII(输出)读取的数据、天线端口和惟一标识符已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_ADDRESS_OVERFLOWIUHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。此接口功能是开启指定标签的循环读取，停止该模式使用uhfReaderStopOperation接口。GB/T42030—2022INHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度startAddress(输入)存储区起始地址wordLength(输入)需要返回的字长已获取有效的connectionHandle。UHF_API_OK|UHF_API_ADDRESS_OVERFLOW|UHFAPICOMMUNICATIONFAILURE返回码应符合A.1的要求。此接口功能是开启指定标签的循环读取，停止该模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfReadAnyTagLoopStart(INHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址wordLength(输入)需要返回的字长已获取有效的connectionHandle。UHF_API_OK|UHF_API_ADDRESS_OVERUHF_API_COMMUNICATION_FAI}fReadKnownTagLoopStartINHandleconnectionHandle,connectionHandle(输入)通信端口句柄已获取有效的connectionHandle;接口或uhfReadAnyTagLoopStart接口以及uhfReader-GB/T42030—2022retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE|UHF_API_IN_EXECUTION此接口功能是对指定标签进行单次数据写入。OUTReturnCodeuhfWriteKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INDataOctetstartAddress,INDataOctetdata,INDataLengthdataLength,OUTAntInfoTypeantInfo);单次写入指定标签的接口connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度startAddress(输入)存储区起始地址data(输入)待写入的数据dataLength(输入)data的字长antInfo(输出)天线端口已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|GB/T42030—2022UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。9.11单次写入任意标签此接口功能是对未指定标签进行单次数据写入。OUTReturnCodeuhfWriteAnyINHandleconnectionHandle,INBankIndexTypebankIndex,INDataLengthdataLength,OUTTagInfoTypetagInfo);单次写入任意标签的接口connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，应符合A.2的startAddress(输入)存储区起始地址data(输入)待写入的数据dataLength(输入)data已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE此接口功能是对指定标签进行循环数据写入，停止该模式使用uhfReaderStopOperation接口。GB/T42030—2022OUTReturnCodeuhfWriteKnownTagLoopStINHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度startAddress(输入)存储区起始地址data(输入)待写入的数据dataLength(输入)data的字长已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。此接口功能是对未指定标签进行循环数据写入，停止该模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfWriteAnyTagLoopStart(INHandleconnectionHanINBankIndexTypebankIndex,GB/T42030—2022INDataLengthdataLength);启动循环写入任意标签的接口connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址data(输入)待写入的数据dataLength(输入)data的字长已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE9.14获取写标签数据uhfWriteKnownTagLoopStart接口或uhfWriteAnyTagLoopStart接口获得。OUTReturnCodeuhfWriteLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,connectionHandle(输入)通信端口句柄length(输出)tagInfo的长度已获取有效的connectionHandle;执行过uhfWriteKnownTagLoopStartStopOperation。接口或uhfWriteAnyTagLoopStart接口以及uhfReader-GB/T42030—2022retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE|UHF_API_IN_EXECUTION此接口功能是对指定标签进行单次擦除数据。OUTReturnCodeuhfEraseKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INDataOctetstartAddress,INDatawordLength,connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址wordLength(输入)字长antInfo(输出)天线端口。已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILUREGB/T42030—2022返回码应符合A.1的要求。9.16单次擦除任意标签此接口功能是对未指定标签进行单次擦除数据。OUTReturnCodeuhfEraseAnyINHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄startAddress(输入)存储区起始地址wordLength(输入)字长tagInfo(输出)天线端口、标签的惟一标识符UII已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。9.17启动循环擦除指定标签此接口功能是对指定标签进行循环擦除数据，停止该模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfEraseKnownTagLoopStart(INHandleconnectionHandle,GB/T42030—2022INBankIndexTypebankIndex,INDataLengthwordLength);启动循环擦除指定标签的接口9.17.3参数说明connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址9.17.4先决条件已获取有效的connectionHandle。UHF_API_OK|}返回码应符合A.1的要求。9.18启动循环擦除任意标签此接口功能是对未指定标签进行循环擦除数据，停止该模式使用uhfReaderStopOperation接口。9.18.2接口定义OUTReturnCodeuhfEraseAnyTagLoopStart(INHandleconnectionHandle,INBankIndexTypebankIndex,INDataLengthwordLength);启动循环擦除任意标签的接口9.18.3参数说明connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，应符合A.2的要求startAddress(输入)存储区起始地址已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}此接口功能是读取读写器的循环擦除标签的数据，这些数据是通过uhfEraseKnownTagLoopStart接OUTReturnCodeuhfEraseLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,OUTDataLengthlength);获取擦除标签数据的接口connectionHandle(输入)通信端口句柄执行过uhfEraseKnownTagLoopStart接口或uhfEraseAnyTagLoopStart接口以及uhfReader-StopOperation。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILUREUHF_API_IN_EXECUTION}返回码应符合A.1的要求。GB/T42030—2022此接口功能是对指定标签进行单次锁定操作。OUTReturnCodeuhfLockKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INLockModeTypelockMode,OUTAntInfoTypeantInfo);单次锁定指定标签的接口connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIuiiLength(输入)uii的长度bankIndex(输入)存储区编码，应符合A.2的要求lockMode(输入)锁定方式antInfo(输出)天线端口9.20.4先决条件已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。9.21单次锁定任意标签此接口功能是对未指定的标签进行单次锁定操作。OUTReturnCodeuhfLockAnyTag(INHandleconnectionHandle,GB/T42030—2022INBankIndexTypebankIndex,INLockModeTypelockMode,connectionHandle(输入)通信端口句柄bankIndex(输入)存储区编码，lockMode(输入)锁定方式antInfo(输出)天线端口。已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。9.22启动循环锁定指定标签此接口功能是对指定标签进行循环锁定，停止该模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfLockKnownTagLoopStart(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIuiiLength(输入)uii的长度bankInder(输入)存储区编码，应符合A.2的要求lockMode(输入)锁定方式已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILUKE}返回码应符合A.1的要求。此接口功能是对未指定标签进行循环锁定，停止该模式使用uhfReaderStopOperation接口。INHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(输入)通信端口句柄lockMode(输入)锁定方式已获取有效的connectionHandle。UHF_API_COMMUNICATION_FAI}此接口功能是读取读写器的循环锁定标签的数据，这些数据是通过uhfLockKnownTagLoopStart接口或uhfLockAnyTagLoopStart接口获得。OUTReturnCodeuhfLockLoopGetResults(INHandleconnectiontagInfo(输出)天线端口、标签惟一标识符(执行uhfLockAnyTagLoopStart时)length(输出)tagInfo的长度执行过uhfLockKnownTagLoopStart接口或uhfLockAnyTagLoopStart接口以及uhfReader-UHF_API_OK|UHF_API_COMMUNICATION_FAIL}此接口功能是对指定标签进行单次销毁操作。OUTReturnCodeuhfKillKnownTagOnce(INHandleconnection已获取有效的connectionHandle。UHF_API_OKUHF_API_COMMUNICATION_FAILURE)OUTReturnCodeuhfKillAnyTag(connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。OUTReturnCodeuhfKillKnownTagLoopStart(INHandleconnectionHandle,GB/T42030—2022INDataLengthuiiLength);启动循环销毁指定标签的接口connectionHandle(输入)通信端口句柄uii(输入)指定的标签惟一标识符UIIuiiLength(输入)uii的长度9.27.4先决条件已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|}返回码应符合A.1的要求。9.28启动循环销毁任意标签此接口功能是对未指定标签进行循环销毁，停止该模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfKillAnyTagLoopStart(INHandleconnectionHandle);启动循环销毁任意标签的接口connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。此接口功能是获取读写器GPIO的状态信息。OUTReturnCodeuhfReaderGetGPIOState(OUTGpioStateTypegpioStateInfo,connectionHandle(输入)通信端口句柄已获取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAI}此接口功能是通过读写器触发GPIO事件。OUTReturnCodeuhfReaderTriggerGPIOEvent(INGpioEventTypetriggerGPIOEventInfo,INDataLengthlength);触发GPIO事件的接口40GB/T42030—2022triggerGPIOEventInfo(输入)触发GPIO的设置参数length(输入)triggerGPIOEventInfo数据的长度已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回码应符合A.1的要求。OUTReturnCodeuhfReaderGenerateRandom(INHandleconnectionHandle,connectionHandle(输入)通信端口句柄rnInfo(输出)随机数length(输出)rnInfo的位长度已获取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回码应符合A.1的要求。OUTReturnCodeuhfReaderAuthenticateRequest(INHandleconnectionHandle,rnInfo(输出)随机数length(输出)rnInfo