GB/T 42030-2022 智能制造 射頻識別系統(tǒng) 超高頻讀寫器應(yīng)用編程接口（正式版）

ICSCCS35.240.50GB/T42030—2022智能制造射頻識別系統(tǒng)超高頻讀寫器應(yīng)用編程接口Applicationprogramminginterface(API)forUHFreaders國家市場監(jiān)督管理總局國家標(biāo)準(zhǔn)化管理委員會IGB/T42030—2022 1 1 5.1交互機(jī)制 5.2接口描述 2 2 77.1建立連接 77.2斷開連接 77.3聯(lián)機(jī)請求 87.4停止設(shè)備當(dāng)前操作 97.5設(shè)置執(zhí)行超時時間 98設(shè)備配置功能接口 8.1讀取設(shè)備信息 8.2讀取設(shè)備工作參數(shù) 8.3設(shè)置設(shè)備工作參數(shù) 8.4讀取設(shè)備寄存器 8.5設(shè)置設(shè)備寄存器 8.6保存設(shè)備寄存器 8.8進(jìn)入設(shè)備休眠模式 8.9恢復(fù)設(shè)備出廠模式 8.11設(shè)置設(shè)備天線端口 8.13設(shè)備固件升級校驗(yàn) 8.14發(fā)送固件升級數(shù)據(jù)包 9標(biāo)簽操作訪問功能接口 9.1標(biāo)簽分類參數(shù)設(shè)置 9.2單次識別 9.3啟動循環(huán)識別 9.4獲取標(biāo)簽識別號 9.5單次讀取指定標(biāo)簽 Ⅱ9.6單次讀取任意標(biāo)簽 9.7啟動循環(huán)讀取指定標(biāo)簽 9.8啟動循環(huán)讀取任意標(biāo)簽 9.9獲取讀標(biāo)簽數(shù)據(jù) 9.10單次寫入指定標(biāo)簽 9.11單次寫入任意標(biāo)簽 9.12啟動循環(huán)寫入指定標(biāo)簽 9.13啟動循環(huán)寫入任意標(biāo)簽 9.14獲取寫標(biāo)簽數(shù)據(jù) 9.15單次擦除指定標(biāo)簽 9.16單次擦除任意標(biāo)簽 9.17啟動循環(huán)擦除指定標(biāo)簽 9.18啟動循環(huán)擦除任意標(biāo)簽 9.19獲取擦除標(biāo)簽數(shù)據(jù) 9.20單次鎖定指定標(biāo)簽 9.21單次鎖定任意標(biāo)簽 9.22啟動循環(huán)鎖定指定標(biāo)簽 9.23啟動循環(huán)鎖定任意標(biāo)簽 9.24獲取鎖定標(biāo)簽數(shù)據(jù) 9.25單次銷毀指定標(biāo)簽 9.26單次銷毀任意標(biāo)簽 9.27啟動循環(huán)銷毀指定標(biāo)簽 9.28啟動循環(huán)銷毀任意標(biāo)簽 10.1查詢GPIO狀態(tài) 10.2觸發(fā)GPIO事件 11安全管理訪問功能接口 11.2認(rèn)證請求 11.3認(rèn)證開始 11.4認(rèn)證結(jié)束 11.5設(shè)備認(rèn)證密鑰更新 附錄A(規(guī)范性)映射表 ⅢGB/T42030—2022本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。請注意本文件的某些內(nèi)容可能涉及專利。本文件的發(fā)布機(jī)構(gòu)不承擔(dān)識別專利的責(zé)任。本文件由全國信息技術(shù)標(biāo)準(zhǔn)化技術(shù)委員會(SAC/TC28)提出并歸口。本文件起草單位：中國電子技術(shù)標(biāo)準(zhǔn)化研究院、北京中科佐迪克電子科技發(fā)展有限公司、睿芯聯(lián)科(北京)電子科技有限公司、廣東中科臻恒信息技術(shù)有限公司、北京智芯微電子科技有限公司、四川華大恒芯科技有限公司、上海天臣微納米科技股份有限公司、愛康普科技(大連)有限公司、青島海爾洗衣機(jī)1GB/T42030—2022智能制造射頻識別系統(tǒng)超高頻讀寫器應(yīng)用編程接口本文件規(guī)定了超高頻射頻識別讀寫器和客戶端之間進(jìn)行交互的規(guī)則及表達(dá)方式。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文本文件。GB/T16262(所有部分)信息技術(shù)抽象語法記法一(ASN.1)GB/T29261.3—2012信息技術(shù)自動識別和數(shù)據(jù)采集技術(shù)詞匯第3部分：射頻識別GB/T29768—2013信息技術(shù)射頻識別800/900MHz空中接口協(xié)議GB/T29261.3—2012界定的以及下列術(shù)語和定義適用于本文件。3.1定義或影響一個動作所需要的信息。3.2軟件系統(tǒng)不同組成部分銜接的約定。4縮略語下列縮略語適用于本文件。GPIO:通用輸入輸出(General-PurposeInput/Output)UII:惟一標(biāo)識符(UniqueItemIdentifier)5概述一個客戶端可同時連接多個讀寫器。一個讀寫器同一時刻只能連接一個客戶端。2GB/T42030—2022本文件第7章到第11章分別針對連接訪問等6類接口詳細(xì)描述各個接口。這些接口描述獨(dú)立于編程語言，接口表達(dá)方式符合GB/T16262(所有部分)。每個接口分以下5項(xiàng)進(jìn)行描述：a)功能說明——給出該接口的主要功能；如，連接訪問類接口中“建立連接”這個接是：此接口功能是在客戶端應(yīng)用程序和讀寫器之間建立連接端口。OUTReturnCodeuhfReaderConnect(c)參數(shù)說明——給出該接口的主要參數(shù)；如，連接訪問類接口中“建立連接”這個接口的參數(shù)說cPort(輸入)端口connectionHandle(輸出)通信端口句柄d)先決條件——給出執(zhí)行該接口時所需具備的先決條件；有些接口的執(zhí)行無需先決條件。如，連有以下先決條件：已獲取有效的connectionHandle。e)返回碼———用抽象語法記法一(ASN.1)的規(guī)則給出該返回碼的定義，指出收到該接口后應(yīng)返UHF_API_INCORRECT_PARAMETERUHF_API_NOT_AVAILABLEUHF_API_COMMUNICATION_FAILURE6數(shù)據(jù)類型定義本文件中描述的數(shù)據(jù)類型采用GB/T16262(所有部分)的規(guī)定。Address::=OCTETSTRING--存儲器地址數(shù)據(jù)類型是八位位組串AntInfoType::=BITSTRING--天線端口數(shù)據(jù)類型是位串{antl(1).3GB/T42030—2022一BankIndexType::=INTEGER(0..63)--存儲區(qū)編碼數(shù)據(jù)類型是整數(shù)BOOL::=BOOLEAN-DataLength::INTEGERDataOctet::=OCTET布爾類型STRING-數(shù)據(jù)內(nèi)容的數(shù)據(jù)類型是八位位組串DataTypeInfo::=SEQUENCE-讀取到的標(biāo)簽數(shù)據(jù)的數(shù)據(jù)類型是序列{antAntInfoType,-天線端口的數(shù)據(jù)類型是AntInfoTypeDataType::=CHOICE-標(biāo)簽返回?cái)?shù)據(jù)的數(shù)據(jù)類型是選擇{ant_dataDataTypeInfo-數(shù)據(jù)和天線數(shù)據(jù)類型是DataTypeInfoDataTypeUII::=SEQUENCEant_uiiTagInfoType,--天線與惟一標(biāo)識符UII的數(shù)據(jù)類型是TagInfoTypeEnumMode::=ENUMERATED-標(biāo)簽識別方式的數(shù)據(jù)類型是枚舉{4GB/T42030—2022multiple(2)--表示采用多標(biāo)簽識別的方式}EnumType::=ENUMERATED--設(shè)備工作參數(shù)的數(shù)據(jù)類型是枚舉{power(1),--表示功率參數(shù)fhss(2),--表示頻率參數(shù)modulation(3),--表示讀寫器調(diào)制方式參數(shù)backScattered-link-frequency(4),-表示標(biāo)簽反向鏈路頻率參數(shù)encoding(5),--表示標(biāo)簽編碼選擇參數(shù)tc(6),--表示前向鏈路基trext(7)--表示前導(dǎo)信號指示TRext參數(shù)FirmwareType::=SEQUENCE-固件信息數(shù)據(jù)類型是序列{snOCTETSTRING,--設(shè)備惟一序列號的數(shù)據(jù)類型是八位位組串hardversionPrintableString,-設(shè)備硬件版本的數(shù)據(jù)類型是可打印字符串firmwareversionPrintableString--設(shè)備固件版本的數(shù)據(jù)類型是可打印字符串}FloatType::=REAL--浮點(diǎn)數(shù)據(jù)類型是實(shí)數(shù)GPioEvent{Type::=SEQUENCE--GPIO事件數(shù)據(jù)類型是序列portINTEGER,--端口號的數(shù)據(jù)類型是整數(shù)triggerModeENUMERATED{-觸發(fā)方式的數(shù)據(jù)類型是枚舉riseTrigger(1)},--表示上升沿觸發(fā)方式forwardStateENUMERATED{--觸發(fā)后狀態(tài)的數(shù)據(jù)類型是枚舉low-level(0),-表示低電平狀態(tài)high-level(1)},--表示高電平狀態(tài)delayTimeType,--觸發(fā)延遲時間的數(shù)據(jù)類型是TimeTypeperiodTimeType--觸發(fā)后狀態(tài)保持時間的數(shù)據(jù)類型是TimeType}GpioStateType::=SEQUENCE--GPIO狀態(tài)數(shù)據(jù)類型是序列{portINTEGER,--端口號的數(shù)據(jù)類型是整數(shù)triggerModeENUMERATED{-觸發(fā)方式的數(shù)據(jù)類型是枚舉5fallTrigger(0),--riseTrigger(1)},--表示上升沿觸發(fā)方式currentStateEnumState,一當(dāng)前狀態(tài)數(shù)據(jù)類型是EnumStateperiodINTEGER--觸發(fā)保持時間的數(shù)據(jù)類型是整數(shù)}Handle::=ANY--句柄數(shù)據(jù)類型是任意KeyIndexType::=INTEGER(0..36)--LockModeType::=ENUMERATED-{密鑰索引號的數(shù)據(jù)類型是整數(shù)標(biāo)簽鎖定方式的數(shù)據(jù)類型是枚舉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+”)-連接端口數(shù)據(jù)類型是可打印字符串{power_valueREAL,--功率數(shù)值的數(shù)據(jù)類型是實(shí)數(shù)modulation_codeENUMERATED{-調(diào)制方式的數(shù)據(jù)類型是枚舉blf_factorENUMERATED{--反向鏈路頻率因子K數(shù)據(jù)類型是枚舉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{--編碼方式的數(shù)據(jù)類型是枚舉fm0(0),--表示反向鏈路編碼FM0 表述反向鏈路編碼米勒編碼M為2miller4(2), 表示反向鏈路編碼米勒編碼M為4miller8(3)}, 表示反向鏈路編碼米勒編碼M為8tc-valueENUMERATED{--T。值得數(shù)據(jù)類型是枚舉time125(1)},-表示T。=12.5μstrext-value}ENUMERATED{--Trext值得數(shù)據(jù)類型是枚舉no-preamble(0),-表示無前導(dǎo)信號with-preamble(1)}--表示有前導(dǎo)信號ReturnCode::=INTEGER(0..255)--接口返回碼數(shù)據(jù)類型是整數(shù)RN::=BITSTRING--隨機(jī)數(shù)數(shù)據(jù)類型是位串RN32::=BITSTRING(SIZE(32))-32位隨機(jī)數(shù)數(shù)據(jù)類型是位串SortParamType::=SEQUENCE--分類命令參數(shù)數(shù)據(jù)類型是序列sort-bankBankIndexType,--分類命令存儲區(qū)數(shù)據(jù)域數(shù)據(jù)類型是BankIndexTypesort-targetBITSTRING(SIZE(4)),--分類命令目標(biāo)數(shù)據(jù)域類型是位串sort-actionBITSTRING(SIZE(2)),-分類命令規(guī)則數(shù)據(jù)域數(shù)據(jù)類型是位串sort-addrBITSTRING(SIZE(16)),--分類命令指針數(shù)據(jù)域數(shù)據(jù)類型是位串sort-lengthBITSTRING(SIZE(8)),-分類命令長度數(shù)據(jù)域數(shù)據(jù)類型是位串sort-maskBITSTRING,-分類命令掩碼數(shù)據(jù)域數(shù)據(jù)類型是位串query-matchBITquery-targetBIT}{STRING(SIZE(2)),-啟動查詢命令條件數(shù)據(jù)域數(shù)據(jù)類型是位串STRING(SIZE(1))-啟動查詢命令目標(biāo)數(shù)據(jù)域數(shù)據(jù)類型是位串--系統(tǒng)信息數(shù)據(jù)類型是序列modePrintableString,--工作模式數(shù)據(jù)類型是可打印字符串protocolPrintableString,--空中接口協(xié)議數(shù)據(jù)類型是可打印字符串，默認(rèn)為“GB/T29768—2013”parametersPrintableString--安全參數(shù)數(shù)據(jù)類型是可打印字符串TagInfoType::=SEQUENCE-對應(yīng)天線端口的標(biāo)簽信息的數(shù)據(jù)類型是序列7GB/T42030—2022{antportAntInfoType,-uiiOCTETSTRING--標(biāo)簽惟一標(biāo)識符的數(shù)據(jù)類型是八位位組串TimeType::=INTEGER--時間(ms)數(shù)據(jù)類型是整數(shù)7連接訪問功能接口此接口功能是在客戶端應(yīng)用程序和讀寫器之間建立連接端口。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}返回碼應(yīng)符合附錄A中A.1的要求。此接口功能是關(guān)閉客戶端應(yīng)用程序和讀寫器之間已建立的端口連接。8GB/T42030—2022OUTReturnCodeuhfReaderDisconnect(INHandleconnectionHandle);斷開連接功能的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_INCORRECT_PARAMETER|UHF_API_COMMUNICATION_FAILURE}參數(shù)。OUTReturnCodeuhfReaderOnlineRequest(INHandleconnectionHandle.OUTSysInfoTypesystemInfo);聯(lián)機(jī)請求功能的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE9GB/T42030—2022返回碼應(yīng)符合A.1的要求。此接口功能是停止讀寫器當(dāng)前的操作。OUTReturnCodeuhfReaderStopOperation(INHandleconnectionHandle);停止設(shè)備當(dāng)前操作的接口connectionHandle(輸入)通信端口句柄7.4.4先決條件已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE)返回碼應(yīng)符合A.1的要求。此接口功能是設(shè)置本文中API接口函數(shù)超時時間。7.5.2接口定義OUTReturnCodeuhfReaderApiExpiredTime(INTimeTypeexpiredTime);設(shè)置執(zhí)行超時時間的接口expiredTime(輸入)執(zhí)行某一API接口函數(shù)返回UHF_API_COMMUNICATION_FAILURE時需要等待的時間(ms)無GB/T42030—2022UHF_API_OKUHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。8設(shè)備配置功能接口OUTReturnCodeuhfReaderGetFirmwareInfo(INHandleconnectionHandle,已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。OUTReturnCodeuhfReaderGetInfo(INHandleconnectionHandle,OUTReaderDataTypeinfo);讀取設(shè)備工作參數(shù)GB/T42030—2022connectionHandle(輸入)通信端口句柄info(輸出)讀寫器當(dāng)前工作參數(shù)已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。此接口功能是設(shè)置讀寫器的工作參數(shù)。8.3.2接口定義INHandleconnectionHandle,connectionHandle(輸入)通信端口句柄flag(輸入)參數(shù)類別info(輸入)讀寫器工作參數(shù)已獲取有效的connectionHandle。UHF_API_OKUHFAPICOMMUNICATIONFAILURE}返回碼應(yīng)符合A.1的要求。8.4讀取設(shè)備寄存器此接口功能是讀取設(shè)備寄存器的數(shù)據(jù)。OUTReturnCodeuhfReaderGetRegister(INHandleconnectionHandle,INDataLengthregLength,OUTDataOctetregisterInfo,8.4.4先決條件已獲取有效的connectionHandle。8.4.5返回碼retReturnCode::={UHF_API_OKUHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。8.5設(shè)置設(shè)備寄存器此接口功能是設(shè)置設(shè)備寄存器的數(shù)據(jù)，掉電之后設(shè)置內(nèi)容失效，恢復(fù)為最后一次調(diào)用uhfReader-SaveRegister接口時的數(shù)據(jù)。8.5.2接口定義OUTReturnCodeuhfReaderSetRegister(INHandleconnectionHandle,INAddressregAddress,))INDataLengthregLength,INDataOctetregisterInfo,INDataLengthlength);設(shè)置設(shè)備寄存器的接口registerInfo(輸入)寄存器的內(nèi)容length(輸入)registerInfo數(shù)據(jù)的長度已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHFAPIOKUHF_API_COMMUNICATION_FAILUREGB/T42030—2022返回碼應(yīng)符合A.1的要求。此接口功能是恢復(fù)設(shè)備寄存器的默認(rèn)設(shè)置。OUTReturnCodeuhfReaderResetRegister(INHandleconnectionHandle);復(fù)位設(shè)備寄存器的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。8.8進(jìn)入設(shè)備休眠模式此接口功能是設(shè)置讀寫器進(jìn)入休眠模式。8.8.2接口定義OUTReturnCodeuhfReaderEnterSleepMode(INHandleconnectionHandle);進(jìn)入設(shè)備休眠模式的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。8.9恢復(fù)設(shè)備出廠模式此接口功能是恢復(fù)設(shè)備出廠模式。OUTReturnCodeuhfReaderFactoryReset(INHandleconnectionHandle,connectionHandle(輸入)通信端口句柄rn32(輸入)已獲取的讀寫器32位隨機(jī)數(shù)已獲取有效的connectionHandle,先調(diào)用uhfReaderGenerateRandom獲取讀寫器32位隨機(jī)數(shù)。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。8.10讀取設(shè)備天線端口8.10.1功能說明此接口功能是讀取設(shè)備的在用天線端口。OUTReturnCodeuhfReaderGetAntenna(INHandleconnectionHandle,8.10.3參數(shù)說明connectionHandle(輸入)通信端口句柄antInfo(輸出)天線在用天線端口號GB/T42030—2022已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。8.11設(shè)置設(shè)備天線端口此接口功能是設(shè)置讀寫器天線端口。OUTReturnCodeuhfReaderSetAntenna(INHandleconnectionHandle,connectionHandle(輸入)通信端口句柄antInfo(輸入)天線端口號已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。此接口功能是請求對讀寫器固件進(jìn)行升級。OUTReturnCodeuhfReaderFirmwareUpdateRequest(connectionHandle(輸入)通信端口句柄rn32(輸出)32位隨機(jī)數(shù)已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAI}此接口功能是對讀寫器的固件進(jìn)行升級校驗(yàn)。OUTReturnCodeuhfReaderFirmwareUpdateCheck(connectionHandle(輸入)通信端口句柄rn32(輸入)設(shè)備固件升級請求uhfReaderFirmwareUpdateRequest返回的32位隨機(jī)數(shù)取反已獲取有效的connectionHandle,先調(diào)用uhfReaderFirmwareUpdateRequest獲取32位隨機(jī)數(shù)。UHF_API_COMMUNICATION_FAIGB/T42030—2022此接口功能是向讀寫器發(fā)送固件升級數(shù)據(jù)包。OUTReturnCodeuhfReaderFirmwareUpdate(INHandleconnectionHandle,INDataLengthpackLength,connectionHandle(輸入)通信端口句柄packData(輸入)升級包數(shù)據(jù)packLength(輸入)升級包數(shù)據(jù)長度isLastPack(輸入)是否是最后升級包已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。9標(biāo)簽操作訪問功能接口此接口功能是設(shè)置分類命令和啟動查詢命令的參數(shù)。OUTReturnCodeuhfSortParam(INHandleconnectionHandle,GB/T42030—2022connectionHandle(輸入)通信端口句柄sortInfo(輸入)命令參數(shù)已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。此接口功能是進(jìn)行單次標(biāo)簽識別。OUTReturnCodeuhfInventoryOnce(INHandleconnectionHandle,OUTTagInfoTypetagInfo);單次識別的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK返回碼應(yīng)符合A.1的要求。9.3啟動循環(huán)識別此接口功能是開啟讀寫器的循環(huán)識別模式，停止該模式使用uhfReaderStopOperation接口。9.3.2接口定義OUTReturnCodeuhfInventoryLoopStart(INHandleconnectionHandle,connectionHandle(輸入)通信端口句柄mode(輸入)循環(huán)識別模式，包括單標(biāo)簽循環(huán)模式和多標(biāo)簽循環(huán)模式已獲取有效的connectionHandle。retReturnCode::={UHFAPIOKUHF_API_COMMUNICATION_FAILURE}9.4獲取標(biāo)簽識別號此接口功能是讀取讀寫器的循環(huán)識別讀到的標(biāo)簽識別號，這些標(biāo)簽識別號是通過uhfInventory-LoopStart接口獲得。9.4.2接口定義OUTReturnCodeuhfInventoryLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,connectionHandle(輸入)通信端口句柄length(輸出)tagInfo的長度GB/T42030—20229.4.4先決條件UHF_API_OK|UHFAPICOMMUNICATIONFAILURE返回碼應(yīng)符合A.1的要求。此接口功能是對指定標(biāo)簽的單次數(shù)據(jù)讀取。OUTReturnCodeuhfINHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址wordLength(輸入)需要返回的字長已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|22GB/T42030—2022UHF_API_ADDRESS_OVERFLOWIUHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。此接口功能是對未指定標(biāo)簽的單次數(shù)據(jù)讀取。OUTReturnCodeuhfReadAnyTagOnce(INHandleconnectionHandle,INBankIndexTypebankIndex,INDataOctetstartAddress,INDataLengthwordLength,OUTDataTypeUIIdataInfoUII);單次讀取任意標(biāo)簽的接口connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址wordLength(輸入)需要返回的字長dataInfoUII(輸出)讀取的數(shù)據(jù)、天線端口和惟一標(biāo)識符已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_ADDRESS_OVERFLOWIUHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。此接口功能是開啟指定標(biāo)簽的循環(huán)讀取，停止該模式使用uhfReaderStopOperation接口。GB/T42030—2022INHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度startAddress(輸入)存儲區(qū)起始地址wordLength(輸入)需要返回的字長已獲取有效的connectionHandle。UHF_API_OK|UHF_API_ADDRESS_OVERFLOW|UHFAPICOMMUNICATIONFAILURE返回碼應(yīng)符合A.1的要求。此接口功能是開啟指定標(biāo)簽的循環(huán)讀取，停止該模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfReadAnyTagLoopStart(INHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址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此接口功能是對指定標(biāo)簽進(jìn)行單次數(shù)據(jù)寫入。OUTReturnCodeuhfWriteKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INDataOctetstartAddress,INDataOctetdata,INDataLengthdataLength,OUTAntInfoTypeantInfo);單次寫入指定標(biāo)簽的接口connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度startAddress(輸入)存儲區(qū)起始地址data(輸入)待寫入的數(shù)據(jù)dataLength(輸入)data的字長antInfo(輸出)天線端口已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|GB/T42030—2022UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。9.11單次寫入任意標(biāo)簽此接口功能是對未指定標(biāo)簽進(jìn)行單次數(shù)據(jù)寫入。OUTReturnCodeuhfWriteAnyINHandleconnectionHandle,INBankIndexTypebankIndex,INDataLengthdataLength,OUTTagInfoTypetagInfo);單次寫入任意標(biāo)簽的接口connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的startAddress(輸入)存儲區(qū)起始地址data(輸入)待寫入的數(shù)據(jù)dataLength(輸入)data已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE此接口功能是對指定標(biāo)簽進(jìn)行循環(huán)數(shù)據(jù)寫入，停止該模式使用uhfReaderStopOperation接口。GB/T42030—2022OUTReturnCodeuhfWriteKnownTagLoopStINHandleconnectionHanINBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度startAddress(輸入)存儲區(qū)起始地址data(輸入)待寫入的數(shù)據(jù)dataLength(輸入)data的字長已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。此接口功能是對未指定標(biāo)簽進(jìn)行循環(huán)數(shù)據(jù)寫入，停止該模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfWriteAnyTagLoopStart(INHandleconnectionHanINBankIndexTypebankIndex,GB/T42030—2022INDataLengthdataLength);啟動循環(huán)寫入任意標(biāo)簽的接口connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址data(輸入)待寫入的數(shù)據(jù)dataLength(輸入)data的字長已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE9.14獲取寫標(biāo)簽數(shù)據(jù)uhfWriteKnownTagLoopStart接口或uhfWriteAnyTagLoopStart接口獲得。OUTReturnCodeuhfWriteLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,connectionHandle(輸入)通信端口句柄length(輸出)tagInfo的長度已獲取有效的connectionHandle;執(zhí)行過uhfWriteKnownTagLoopStartStopOperation。接口或uhfWriteAnyTagLoopStart接口以及uhfReader-GB/T42030—2022retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE|UHF_API_IN_EXECUTION此接口功能是對指定標(biāo)簽進(jìn)行單次擦除數(shù)據(jù)。OUTReturnCodeuhfEraseKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INDataOctetstartAddress,INDatawordLength,connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址wordLength(輸入)字長antInfo(輸出)天線端口。已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILUREGB/T42030—2022返回碼應(yīng)符合A.1的要求。9.16單次擦除任意標(biāo)簽此接口功能是對未指定標(biāo)簽進(jìn)行單次擦除數(shù)據(jù)。OUTReturnCodeuhfEraseAnyINHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄startAddress(輸入)存儲區(qū)起始地址wordLength(輸入)字長tagInfo(輸出)天線端口、標(biāo)簽的惟一標(biāo)識符UII已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。9.17啟動循環(huán)擦除指定標(biāo)簽此接口功能是對指定標(biāo)簽進(jìn)行循環(huán)擦除數(shù)據(jù)，停止該模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfEraseKnownTagLoopStart(INHandleconnectionHandle,GB/T42030—2022INBankIndexTypebankIndex,INDataLengthwordLength);啟動循環(huán)擦除指定標(biāo)簽的接口9.17.3參數(shù)說明connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址9.17.4先決條件已獲取有效的connectionHandle。UHF_API_OK|}返回碼應(yīng)符合A.1的要求。9.18啟動循環(huán)擦除任意標(biāo)簽此接口功能是對未指定標(biāo)簽進(jìn)行循環(huán)擦除數(shù)據(jù)，停止該模式使用uhfReaderStopOperation接口。9.18.2接口定義OUTReturnCodeuhfEraseAnyTagLoopStart(INHandleconnectionHandle,INBankIndexTypebankIndex,INDataLengthwordLength);啟動循環(huán)擦除任意標(biāo)簽的接口9.18.3參數(shù)說明connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求startAddress(輸入)存儲區(qū)起始地址已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}此接口功能是讀取讀寫器的循環(huán)擦除標(biāo)簽的數(shù)據(jù)，這些數(shù)據(jù)是通過uhfEraseKnownTagLoopStart接OUTReturnCodeuhfEraseLoopGetResults(INHandleconnectionHandle,OUTTagInfoTypetagInfo,OUTDataLengthlength);獲取擦除標(biāo)簽數(shù)據(jù)的接口connectionHandle(輸入)通信端口句柄執(zhí)行過uhfEraseKnownTagLoopStart接口或uhfEraseAnyTagLoopStart接口以及uhfReader-StopOperation。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILUREUHF_API_IN_EXECUTION}返回碼應(yīng)符合A.1的要求。GB/T42030—2022此接口功能是對指定標(biāo)簽進(jìn)行單次鎖定操作。OUTReturnCodeuhfLockKnownTagOnce(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,INLockModeTypelockMode,OUTAntInfoTypeantInfo);單次鎖定指定標(biāo)簽的接口connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIuiiLength(輸入)uii的長度bankIndex(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求lockMode(輸入)鎖定方式antInfo(輸出)天線端口9.20.4先決條件已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。9.21單次鎖定任意標(biāo)簽此接口功能是對未指定的標(biāo)簽進(jìn)行單次鎖定操作。OUTReturnCodeuhfLockAnyTag(INHandleconnectionHandle,GB/T42030—2022INBankIndexTypebankIndex,INLockModeTypelockMode,connectionHandle(輸入)通信端口句柄bankIndex(輸入)存儲區(qū)編碼，lockMode(輸入)鎖定方式antInfo(輸出)天線端口。已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。9.22啟動循環(huán)鎖定指定標(biāo)簽此接口功能是對指定標(biāo)簽進(jìn)行循環(huán)鎖定，停止該模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfLockKnownTagLoopStart(INHandleconnectionHandle,INDataOctetuii,INDataLengthuiiLength,INBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIuiiLength(輸入)uii的長度bankInder(輸入)存儲區(qū)編碼，應(yīng)符合A.2的要求lockMode(輸入)鎖定方式已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAILUKE}返回碼應(yīng)符合A.1的要求。此接口功能是對未指定標(biāo)簽進(jìn)行循環(huán)鎖定，停止該模式使用uhfReaderStopOperation接口。INHandleconnectionHandle,INBankIndexTypebankIndex,connectionHandle(輸入)通信端口句柄lockMode(輸入)鎖定方式已獲取有效的connectionHandle。UHF_API_COMMUNICATION_FAI}此接口功能是讀取讀寫器的循環(huán)鎖定標(biāo)簽的數(shù)據(jù)，這些數(shù)據(jù)是通過uhfLockKnownTagLoopStart接口或uhfLockAnyTagLoopStart接口獲得。OUTReturnCodeuhfLockLoopGetResults(INHandleconnectiontagInfo(輸出)天線端口、標(biāo)簽惟一標(biāo)識符(執(zhí)行uhfLockAnyTagLoopStart時)length(輸出)tagInfo的長度執(zhí)行過uhfLockKnownTagLoopStart接口或uhfLockAnyTagLoopStart接口以及uhfReader-UHF_API_OK|UHF_API_COMMUNICATION_FAIL}此接口功能是對指定標(biāo)簽進(jìn)行單次銷毀操作。OUTReturnCodeuhfKillKnownTagOnce(INHandleconnection已獲取有效的connectionHandle。UHF_API_OKUHF_API_COMMUNICATION_FAILURE)OUTReturnCodeuhfKillAnyTag(connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。OUTReturnCodeuhfKillKnownTagLoopStart(INHandleconnectionHandle,GB/T42030—2022INDataLengthuiiLength);啟動循環(huán)銷毀指定標(biāo)簽的接口connectionHandle(輸入)通信端口句柄uii(輸入)指定的標(biāo)簽惟一標(biāo)識符UIIuiiLength(輸入)uii的長度9.27.4先決條件已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|}返回碼應(yīng)符合A.1的要求。9.28啟動循環(huán)銷毀任意標(biāo)簽此接口功能是對未指定標(biāo)簽進(jìn)行循環(huán)銷毀，停止該模式使用uhfReaderStopOperation接口。OUTReturnCodeuhfKillAnyTagLoopStart(INHandleconnectionHandle);啟動循環(huán)銷毀任意標(biāo)簽的接口connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。此接口功能是獲取讀寫器GPIO的狀態(tài)信息。OUTReturnCodeuhfReaderGetGPIOState(OUTGpioStateTypegpioStateInfo,connectionHandle(輸入)通信端口句柄已獲取有效的connectionHandle。UHF_API_OK|UHF_API_COMMUNICATION_FAI}此接口功能是通過讀寫器觸發(fā)GPIO事件。OUTReturnCodeuhfReaderTriggerGPIOEvent(INGpioEventTypetriggerGPIOEventInfo,INDataLengthlength);觸發(fā)GPIO事件的接口40GB/T42030—2022triggerGPIOEventInfo(輸入)觸發(fā)GPIO的設(shè)置參數(shù)length(輸入)triggerGPIOEventInfo數(shù)據(jù)的長度已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE返回碼應(yīng)符合A.1的要求。OUTReturnCodeuhfReaderGenerateRandom(INHandleconnectionHandle,connectionHandle(輸入)通信端口句柄rnInfo(輸出)隨機(jī)數(shù)length(輸出)rnInfo的位長度已獲取有效的connectionHandle。retReturnCode::={UHF_API_OK|UHF_API_COMMUNICATION_FAILURE}返回碼應(yīng)符合A.1的要求。OUTReturnCodeuhfReaderAuthenticateRequest(INHandleconnectionHandle,rnInfo(輸出)隨機(jī)數(shù)length(輸出)rnInfo