ICSCCS65.020.99B00YNZYC標(biāo)準(zhǔn)RadiofrequencyIdentified-basedChinesemedicine(proprietaryChinesproductiontraceabilitysystem-Part2:ReaderapplicationspecificationIT/YNZYC0097—2023本文件按照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é)任。本文件由云南省中藥材種植養(yǎng)殖行業(yè)協(xié)會(huì)提出并歸口。本文件起草單位：昆明高新區(qū)生物醫(yī)藥產(chǎn)業(yè)促進(jìn)會(huì)、云南省中藥材種植養(yǎng)殖行業(yè)協(xié)會(huì)、云南前海高新技術(shù)產(chǎn)業(yè)研究院有限公司、云南鈺津供應(yīng)鏈科技有限公司、昆藥集團(tuán)股份有限公司、昆明中藥廠有限公司、云南三七科技有限公司本文件主要起草人：徐朝能、蘇豹、張自騫、陳曉虹、丁劍、李納、李艷、李學(xué)芬、尹容梅、胡倆劍、張雪、鄭輝、田孟齊、唐婉筠、劉輝、江明、孫建寧、孫高飛、楊輝T/YNZYC0097—2023I基于射頻識(shí)別的中藥（中成藥）生產(chǎn)追溯系統(tǒng)第2部分：讀寫器應(yīng)用規(guī)范本文件規(guī)定了中成藥行業(yè)基于射頻識(shí)別的生產(chǎn)追溯系統(tǒng)中讀寫設(shè)備信息查詢、參數(shù)設(shè)置、指令和狀態(tài)報(bào)告四類接口。本文件適用于中成藥行業(yè)基于射頻識(shí)別的生產(chǎn)追溯系統(tǒng)中使用射頻識(shí)別讀寫設(shè)備的生產(chǎn)，以及射頻識(shí)別讀寫設(shè)備網(wǎng)絡(luò)管理系統(tǒng)的設(shè)計(jì)與開發(fā)。2規(guī)范性引用文件下列文件中的條款通過(guò)本文件的引用而成為本文件的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本文件，然而，鼓勵(lì)根據(jù)本文件達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本文件。3術(shù)語(yǔ)和定義3.1射頻識(shí)別（RFlD）Radiofrequencyidentification在頻譜的射頻部分，利用電磁耦合或感應(yīng)耦合，通過(guò)各種調(diào)制和編碼方案，與射頻標(biāo)簽進(jìn)行通信，并讀取射頻標(biāo)簽的信息的技術(shù)。3.2射頻標(biāo)簽Radiofrequencytag用于物體或物品標(biāo)識(shí)、具有信息存儲(chǔ)機(jī)制的、能接收讀寫器的電磁場(chǎng)調(diào)制信號(hào)并返回響應(yīng)信號(hào)的數(shù)據(jù)載體，以下簡(jiǎn)稱標(biāo)簽。3.3讀寫器Reader/writer一種電子設(shè)備，執(zhí)行從射頻標(biāo)簽獲取數(shù)據(jù)和向射頻標(biāo)簽寫入數(shù)據(jù)的過(guò)程，適當(dāng)時(shí)，執(zhí)行沖突仲裁、錯(cuò)誤控制、信道編碼、信道解碼、信源編碼、信源譯碼和交換源端數(shù)據(jù)等過(guò)程。4接口流程RFID系統(tǒng)與上層應(yīng)用之間采用網(wǎng)絡(luò)接口，讀寫器與數(shù)據(jù)平臺(tái)之間實(shí)現(xiàn)遠(yuǎn)程訪問(wèn)交互，交互流程如T/YNZYC0097—2023圖1接口流程所有的交互分為配置、清點(diǎn)和讀寫三部分，數(shù)據(jù)處理系統(tǒng)對(duì)讀寫器下發(fā)命令，讀寫器通過(guò)空中接口與標(biāo)簽進(jìn)行通信，結(jié)果反饋給數(shù)據(jù)處理系統(tǒng)。5數(shù)據(jù)類型5.1主要數(shù)據(jù)類型在接口規(guī)范中，采用與編程語(yǔ)言相關(guān)的數(shù)據(jù)類型來(lái)描述指令的參數(shù)和返回值，主要的數(shù)據(jù)類型見表表1數(shù)據(jù)類型數(shù)據(jù)類型描述String字符串，允許采用UTF-8編碼表示Snteger整型Void無(wú)參數(shù)或無(wú)返回值Float浮點(diǎn)型T/YNZYC0097—2023Bool布爾類型LongintegerUnsignedintegerReaderComPortType自定義類型，詳解見4.2ReaderWorkingAntenna自定義類型，詳解見4.3ReaderWorkingModeType自定義類型，詳解見4.4TagType自定義類型，詳解見4.5ReaderWorkFrequency自定義類型，詳解見4.6InterfaceParametersType自定義類型，詳解見4.7ReaderLogicAddress自定義類型，詳解見4.8ErrorReportType自定義類型，詳解見4.95.2物理接口數(shù)據(jù)類型（ReaderComPortType）讀寫設(shè)備所采用的通訊連接物理接口(EIA-RS-232C、EIA-RS-485、以太網(wǎng)口、無(wú)線網(wǎng)絡(luò)接口或其它類型)，數(shù)據(jù)類型見表2。表2物理接口數(shù)據(jù)類型物理接口類型值類型名稱描述0x00RS232_PROT_TYPEEIA-RS-232C接口類型0x01RS485_PROT_TYPEEIA-RS-485接口類型0x02ETH_PROT_TYPE以太網(wǎng)接口類型0x03WIRELESS_PROT_TYPE無(wú)線網(wǎng)絡(luò)接口類型0x04-0xff保留保留5.3讀寫設(shè)備天線端口邏輯地址（ReaderAntennaPort）用于描述讀寫外界天線端口的邏輯地址，地址取值為integer型，其數(shù)據(jù)類型見表3。表3讀寫設(shè)備天線接口數(shù)據(jù)類型天線接口類型值類型名稱描述0x0000READERANTENNA_PORT1讀寫設(shè)備第1個(gè)天線接口0x0001READERANTENNA_PORT2讀寫設(shè)備第2個(gè)天線接口0x0002READERANTENNA_PORT3讀寫設(shè)備第3個(gè)天線接口0x0003READERANTENNA_PORT4讀寫設(shè)備第4個(gè)天線接口0x0004READERANTENNA_PORT5讀寫設(shè)備第5個(gè)天線接口0x0005READERANTENNA_PORT6讀寫設(shè)備第6個(gè)天線接口0x0006READERANTENNA_PORT7讀寫設(shè)備第7個(gè)天線接口0x0007-0xffff保留保留5.4讀寫設(shè)備工作模式數(shù)據(jù)類型（ReaderWorkingModeType）讀寫設(shè)備當(dāng)前所采用的工作模式，其數(shù)據(jù)類型見表4表4讀寫設(shè)備工作模式數(shù)據(jù)類型工作模式類型值類型名稱描述0x01CONTUNUOUS_MODE連續(xù)模式0x02TRIGGER_MODE觸發(fā)模式T/YNZYC0097—20230x03COMMAND_MODE命令模式0x04-0xff保留保留5.5工作頻率數(shù)據(jù)類型（ReaderWorkFrequency）描述讀寫設(shè)備工作頻率的范圍，其數(shù)據(jù)類型包括最小工作頻率和最大工作頻率兩個(gè)字段，其結(jié)構(gòu)體structReaderWorkFrequency{floatMinWorkFrequency；floatMaxWorkFrequency；其中MinWorkFrequency為讀寫設(shè)備的最小工作頻率值，MaxWorkFrequency為讀寫設(shè)備的最大工作頻率值，其取值范圍均為0.0--9999999.0。5.6接口參數(shù)數(shù)據(jù)類型（InterfaceParametersType）具有EIA-RS-232C或EIA-RS-485接口的讀寫設(shè)備參數(shù)數(shù)據(jù)類型，該數(shù)據(jù)類型是一個(gè)結(jié)構(gòu)體，包含4個(gè)參數(shù)，其結(jié)構(gòu)體為：structInterfaceParametersType{longintegerBaudrate；integerDataBits；integerParity；floatStopBits；Baudrate參數(shù)的取值范圍為{600，1200，2400，4800，9600，19200，38400，56000，115200}。DataBits參數(shù)的取值范圍為{6，7，8}。Parity參數(shù)的取值見表5。StopBits參數(shù)的取值見表6。表5Parity參數(shù)取值及描述Parity取值名稱描述1Even設(shè)置偶校驗(yàn)位2Mark將奇偶校驗(yàn)位保留為3None不發(fā)生奇偶校驗(yàn)檢查4Odd設(shè)置奇校驗(yàn)位5Space將奇偶校驗(yàn)位保留為表6StopBits參數(shù)取值及描述Parity取值名稱描述0None必使用停止位。1One使用1個(gè)停止位。OnePointFive使用1.5個(gè)停止位。2Two使用2個(gè)停止位5.7通訊邏輯地址數(shù)據(jù)類型（ReaderLogicAddress）讀寫設(shè)備的通訊邏輯地址主要包括EIA-RS-485、以太網(wǎng)口的通訊地址，其數(shù)據(jù)類型是一個(gè)結(jié)構(gòu)體，包含6個(gè)字段，其形式如下：structReaderLogicAddressV{ReaderComPortTypePortType;integerReaderRS485_Address;stringReaderIP_Address;stringReaderMark_Address;stringReaderGateWay;stringReaderDNS;其中PortType為物理端口RS_485或以太網(wǎng)類型；ReaderRS485_Address為RS_485地址，取值為0-32；ReaderIP_Address為以太網(wǎng)IP地址；ReaderMark_Address為子網(wǎng)掩碼；ReaderGateWay為網(wǎng)關(guān)；ReaderDNS為域名系統(tǒng)。當(dāng)ReaderComPortType為物理端口RS_485類型時(shí)，ReaderRS485_Address有效，ReaderIP_Address，ReaderMark_Address，ReaderGateWay，ReaderDNS無(wú)效；當(dāng)PortType為以太網(wǎng)類型時(shí)，ReaderIP_Address，ReaderMark_Address，ReaderGateWay，ReaderDNS有效，ReaderRS485_Address無(wú)效。5.8錯(cuò)誤報(bào)告類型（ErrorReportType）讀寫設(shè)備返回錯(cuò)誤報(bào)告的數(shù)據(jù)類型，其定義見表7。表7錯(cuò)誤報(bào)告類型錯(cuò)誤報(bào)告類型值錯(cuò)誤報(bào)告類型名稱描述0x0001INVALID_COMMAND_ERRO無(wú)效指令0x0002OUTSIDE_INTERF_ERROR外部有射頻干擾0x0003ANTENNA_ERROR天線故障或沒(méi)有連接天線0x0004PARAMETER_ERROR參數(shù)錯(cuò)誤0x0005-0xffff保留保留6接口功能6.1信息查詢接口6.1.1getDescription功能：查詢讀寫設(shè)備的硬件、軟件信息，包括版本號(hào)及其特征描述信息。實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getDescription(void):string參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：數(shù)據(jù)類型：string。該命令返回讀寫設(shè)備的描述信息。6.1.2getCommunicationPortType功能：查詢讀寫設(shè)備的物理接口類型(EIA-RS-232C、EIA-RS-485、以太網(wǎng)口、無(wú)線網(wǎng)絡(luò)接口或其它類型)實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getCommunicationPortType(void):ReaderComPortType[]參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：ReaderComPortType數(shù)據(jù)類型。該命令返回讀寫設(shè)備的物理接口列表。6.1.3getAntennaCountT/YNZYC0097—2023功能：查詢讀寫設(shè)備的天線數(shù)量實(shí)現(xiàn)需求：可選用法：getAntennaCount(void):integer參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：數(shù)據(jù)類型：integer。該命令返回讀寫設(shè)備可連接天線的數(shù)量。6.1.4getCurrentWorkingAntenna功能：查詢讀寫設(shè)備當(dāng)前工作的天線實(shí)現(xiàn)需求：可選用法：getCurrentWorkingAntenna(void):ReaderAntennaPort[]參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：ReaderAntennaPort數(shù)據(jù)類型。該命令返回讀寫設(shè)備當(dāng)前工作天線的列表。6.1.5getWorkingMode功能：查詢讀寫設(shè)備當(dāng)前的工作模式實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getWorkingMode(void):ReaderWorkingModeType參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：ReaderWorkingModeType數(shù)據(jù)類型。該命令返回讀寫設(shè)備當(dāng)前的工作模式。6.1.6getCommandInterval功能：查詢讀寫設(shè)備當(dāng)前讀取命令間隔時(shí)間實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getCommandInterval(void):integer參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：數(shù)據(jù)類型：integer。該命令返回讀寫設(shè)備當(dāng)前的讀取周期，單位是毫秒（ms）。6.1.7getMaxReadCountLimit功能：查詢讀寫設(shè)備當(dāng)前設(shè)置的單次可識(shí)別標(biāo)簽數(shù)量實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getMaxReadCountLimit(void):integer參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：數(shù)據(jù)類型：integer。該命令返回讀寫設(shè)備當(dāng)前可識(shí)別標(biāo)簽數(shù)量。6.1.8getWorkFrequency功能：查詢讀寫設(shè)備當(dāng)前工作頻率范圍實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getWorkFrequency(void):ReaderWorkFrequency參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：ReaderWorkFrequency數(shù)據(jù)類型（見4.5）。該命令返回讀寫設(shè)備當(dāng)前的工作頻率范圍(工作頻率最小值和工作頻率最大值)，工作頻率的單位是兆赫茲（MHz）。6.1.9getInterfaceParameters功能：查詢讀寫設(shè)備EIA-RS-232C或者EIA-RS-485接口參數(shù)用法：getInterfaceParameters(void):InterfaceParametersType參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：InterfaceParametersType數(shù)據(jù)類型（見4.6）。該命令返回讀寫設(shè)備EIA-RS-232C或者EIA-RS-485接口參數(shù)。T/YNZYC0097—20236.1.10getRFPower功能：查詢讀寫設(shè)備的輸出功率實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getRFPower(void):integer參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：數(shù)據(jù)類型：integer。該命令返回讀寫設(shè)備的輸出功率，單位是兆赫茲（MHz）。6.1.11getLogicAddress功能：查詢讀寫設(shè)備的通信邏輯地址實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：getLogicAddress(void):ReaderLogicAddress參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：ReaderLogicAddress數(shù)據(jù)類型（見4.7）。該命令返回讀寫設(shè)備的通信邏輯地址。6.2參數(shù)設(shè)置接口6.2.1setCommunicationPortType功能：設(shè)置讀寫設(shè)備的物理接口類型(EIA-RS-232C、EIA-RS-485、以太網(wǎng)口、無(wú)線網(wǎng)絡(luò)接口或其它類型)實(shí)現(xiàn)需求：必須實(shí)現(xiàn)缺省值：EIA-RS-232C用法：setCommunicationPortType(ReaderComPortType[]):void參數(shù)：ReaderComPortType數(shù)據(jù)類型（見4.1）。讀寫設(shè)備的通訊端口類型。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.2setAntennaCount功能：設(shè)置讀寫設(shè)備的天線數(shù)量實(shí)現(xiàn)需求：可選用法：setAntennaCount(integer):void參數(shù)：數(shù)據(jù)類型：integer。讀寫設(shè)備的天線數(shù)量。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.3setCurrentWorkingAntenna功能：設(shè)置讀寫設(shè)備當(dāng)前工作的天線實(shí)現(xiàn)需求：可選用法：setCurrentWorkingAntenna(ReaderAntennaPort[]):void參數(shù)：ReaderAntennaPort數(shù)據(jù)類型。讀寫設(shè)備當(dāng)前工作的天線。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.4setWorkingMode功能：設(shè)置讀寫設(shè)備當(dāng)前的工作模式實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setWorkingMode(ReaderWorkingModeType):void參數(shù)：ReaderWorkingModeType數(shù)據(jù)類型。讀寫設(shè)備當(dāng)前的工作模式。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.5setCommandInterval功能：設(shè)置讀寫設(shè)備當(dāng)前的讀取命令間隔時(shí)間實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setCommandInterval(integer):voidT/YNZYC0097—2023參數(shù)：數(shù)據(jù)類型：integer。讀寫設(shè)備當(dāng)前的讀取命令間隔時(shí)間，單位是毫秒。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.6setMaxReadCountLimit功能：設(shè)置讀寫設(shè)備單次可識(shí)別標(biāo)簽數(shù)實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setMaxReadCountLimit(integer):void參數(shù)：數(shù)據(jù)類型：integer。讀寫設(shè)備單次可識(shí)別標(biāo)簽數(shù)。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.7setFrequency功能：設(shè)置讀寫設(shè)備工作頻率范圍實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setWorkFrequency(ReaderWorkFrequency):void參數(shù)：數(shù)據(jù)類型：ReaderWorkFrequency（4.5）。讀寫設(shè)備工作頻率范圍，單位是赫茲。返回值：數(shù)據(jù)類型：void。該命令不需要返回值。6.2.8setInterfaceParameters功能：設(shè)置讀寫設(shè)備EIA-RS-232C或者EIA-RS-485接口參數(shù)，包括波特率等信息。實(shí)現(xiàn)需求：可選缺省值：9600，8，None，1用法：setInterfaceParameters(InterfaceParametersType):void參數(shù)：數(shù)據(jù)類型：void。讀寫設(shè)備EIA-RS-232C或者EIA-RS-485接口參數(shù)。返回值：InterfaceParametersType數(shù)據(jù)類型（見4.6）。該命令不需要返回值。6.2.9setRFPower功能：設(shè)置讀寫設(shè)備射頻輸出功率實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setRFPower(float):void參數(shù)：數(shù)據(jù)類型：float。讀寫設(shè)備的輸出功率，單位是dBm。返回值：void。該命令不需要返回值。6.2.10setLogicAddress功能：設(shè)置讀寫設(shè)備的通信邏輯地址實(shí)現(xiàn)需求：必須實(shí)現(xiàn)用法：setLogicAddress(ReaderLogicAddress):void參數(shù)：數(shù)據(jù)類型：ReaderLogicAddress（見4.7）。讀寫設(shè)備的通信邏輯地址。返回值：void。該命令不需要返回值。6.3設(shè)備指令接口6.3.1sleepReader功能：使讀寫設(shè)備進(jìn)入休眠狀態(tài)實(shí)現(xiàn)需求：可選用法：sleepReader(void):bool參數(shù)：數(shù)據(jù)類型：void。該命令不需要參數(shù)。返回值：bool。該命令返回值為true，使讀寫設(shè)備停止工作，進(jìn)入休眠狀態(tài)；為false，命令失敗6.3.2awakeReader功能：?jiǎn)拘烟幱谛菝叩淖x寫設(shè)備實(shí)現(xiàn)需求：可選T/YNZYC0097—2023用法：awakeReader(void):bool參數(shù)：數(shù)據(jù)類型：