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

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