TYNZYC 0097-2023 基于射频识别的中药（中成药）生产追溯系统 第2部分：读写器应用规范

ICS65.020.99CCSB00YNZYC团 体 标 准T/YNZYC0097—2023（2RadiofrequencyIdentified-basedChinesemedicine(proprietaryChinesemedicine)productiontraceabilitysystem-Part2:Readerapplicationspecification2023-12-11发布 2023-12-11实施云南省中药材种植养殖行业协会  发布T/YNZYC0097T/YNZYC0097—2023T/YNZYC0097T/YNZYC0097—2023IIII前 言本文件按照GB/T1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由云南省中药材种植养殖行业协会提出并归口。（中成药2范围规范性引用文件（不包括勘误的内容术语和定义射频识别（RFlD）Radiofrequencyidentification在频谱的射频部分，利用电磁耦合或感应耦合，通过各种调制和编码方案，与射频标签进行通信，并读取射频标签的信息的技术。射频标签Radiofrequencytag读写器Reader/writer一种电子设备，执行从射频标签获取数据和向射频标签写入数据的过程，适当时，执行冲突仲裁、错误控制、信道编码、信道解码、信源编码、信源译码和交换源端数据等过程。接口流程RFID系统与上层应用之间采用网络接口，读写器与数据平台之间实现远程访问交互，交互流程如图1所示。T/YNZYC0097T/YNZYC0097—2023T/YNZYC0097T/YNZYC0097—2023PAGE\*ROMANPAGE\*ROMANVIIIPAGE\*ROMANPAGE\*ROMANIII图1接口流程数据类型主要数据类型在接口规范中，采用与编程语言相关的数据类型来描述指令的参数和返回值，主要的数据类型见表1。表1 数据类型数据类型描述String字符串，允许采用UTF-8编码表示Snteger整型Void无参数或无返回值Float浮点型Bool布尔类型LongintegerUnsignedintegerReaderComPortType自定义类型，详解见4.2ReaderWorkingAntenna自定义类型，详解见4.3ReaderWorkingModeType自定义类型，详解见4.4TagType自定义类型，详解见4.5ReaderWorkFrequency自定义类型，详解见4.6InterfaceParametersType自定义类型，详解见4.7ReaderLogicAddress自定义类型，详解见4.8ErrorReportType自定义类型，详解见4.9物理接口数据类型（ReaderComPortType）读写设备所采用的通讯连接物理接口(EIA-RS-232C、EIA-RS-485、以太网口、无线网络接口或其2。表2 物理接口数据类型物理接口类型值类型名称描述0x00RS232_PROT_TYPEEIA-RS-232C接口类型0x01RS485_PROT_TYPEEIA-RS-485接口类型0x02ETH_PROT_TYPE以太网接口类型0x03WIRELESS_PROT_TYPE无线网络接口类型0x04-0xff保留保留读写设备天线端口逻辑地址（ReaderAntennaPort）用于描述读写外界天线端口的逻辑地址，地址取值为integer型，其数据类型见表3。表3 读写设备天线接口数据类型天线接口类型值类型名称描述0x0000READERANTENNA_PORT1读写设备第1个天线接口0x0001READERANTENNA_PORT2读写设备第2个天线接口0x0002READERANTENNA_PORT3读写设备第3个天线接口0x0003READERANTENNA_PORT4读写设备第4个天线接口0x0004READERANTENNA_PORT5读写设备第5个天线接口0x0005READERANTENNA_PORT6读写设备第6个天线接口0x0006READERANTENNA_PORT7读写设备第7个天线接口0x0007-0xffff保留保留读写设备工作模式数据类型（ReaderWorkingModeType）读写设备当前所采用的工作模式，其数据类型见表4表4 读写设备工作模式数据类型工作模式类型值类型名称描述0x01CONTUNUOUS_MODE连续模式0x02TRIGGER_MODE触发模式0x03COMMAND_MODE命令模式0x04-0xff保留保留工作频率数据类型（ReaderWorkFrequency）structReaderWorkFrequency{floatMinWorkFrequency；floatMaxWorkFrequency；}；其中MinWorkFrequency为读写设备的最小工作频率值，MaxWorkFrequency为读写设备的最大工作频率值，其取值范围均为0.0--9999999.0。接口参数数据类型（InterfaceParametersType）EIA-RS-232CEIA-RS-485structInterfaceParametersType{longintegerBaudrate；integerDataBits；integerParity；floatStopBits；}；Baudrate参数的取值范围为{600，1200，2400，4800，9600，19200，38400，56000，115200}。DataBits参数的取值范围为{6，7，8}。Parity5。StopBits6表5 Parity参数取值及描述Parity取值名称描述1Even设置偶校验位2Mark将奇偶校验位保留为3None不发生奇偶校验检查4Odd设置奇校验位5Space将奇偶校验位保留为表6 StopBits参数取值及描述Parity取值名称描述0None必使用停止位。1One使用1个停止位。1.5OnePointFive使用1.5个停止位。2Two使用2个停止位通讯逻辑地址数据类型（ReaderLogicAddress）EIA-RS-4856structReaderLogicAddress{ReaderComPortTypePortType;integerReaderRS485_Address;stringReaderIP_Address;stringReaderMark_Address;stringReaderGateWay;stringReaderDNS;};PortTypeRS_485ReaderRS485_AddressRS_485ReaderIP_AddressIPReaderMark_AddressReaderGateWay为域名系统。当ReaerCmPotTye为物理端口RS_85ReaerR485AddessReaerI_Adres，ReaderMark_AddressReaderGateWayReaderDNS无效；当PortType为以太网类型时，ReaderIP_Address，ReaderMark_Address，ReaderGateWay，ReaderDNS有效，ReaderRS485_Address无效。错误报告类型（ErrorReportType）读写设备返回错误报告的数据类型，其定义见表7。表7 错误报告类型错误报告类型值错误报告类型名称描述0x0001INVALID_COMMAND_ERRO无效指令0x0002OUTSIDE_INTERF_ERROR外部有射频干扰0x0003ANTENNA_ERROR天线故障或没有连接天线0x0004PARAMETER_ERROR参数错误0x0005-0xffff保留保留接口功能信息查询接口getDescription功能：查询读写设备的硬件、软件信息，包括版本号及其特征描述信息。实现需求：必须实现用法：getDescription(void):string参数：数据类型：void。该命令不需要参数。返回值：数据类型：string。该命令返回读写设备的描述信息。getCommunicationPortType功能：查询读写设备的物理接口类型(EIA-RS-232C、EIA-RS-485、以太网口、无线网络接口或其它类型)实现需求：必须实现用法：getCommunicationPortType(void):ReaderComPortType[]参数：数据类型：void。该命令不需要参数。返回值：ReaderComPortType数据类型。该命令返回读写设备的物理接口列表。getAntennaCount功能：查询读写设备的天线数量实现需求：可选用法：getAntennaCount(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备可连接天线的数量。getCurrentWorkingAntenna功能：查询读写设备当前工作的天线实现需求：可选用法：getCurrentWorkingAntenna(void):ReaderAntennaPort[]参数：数据类型：void。该命令不需要参数。返回值：ReaderAntennaPort数据类型。该命令返回读写设备当前工作天线的列表。getWorkingMode功能：查询读写设备当前的工作模式实现需求：必须实现用法：getWorkingMode(void):ReaderWorkingModeType参数：数据类型：void。该命令不需要参数。返回值：ReaderWorkingModeType数据类型。该命令返回读写设备当前的工作模式。getCommandInterval功能：查询读写设备当前读取命令间隔时间实现需求：必须实现用法：getCommandInterval(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备当前的读取周期，单位是毫秒（ms）。getMaxReadCountLimit功能：查询读写设备当前设置的单次可识别标签数量实现需求：必须实现用法：getMaxReadCountLimit(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备当前可识别标签数量。getWorkFrequency功能：查询读写设备当前工作频率范围实现需求：必须实现用法：getWorkFrequency(void):ReaderWorkFrequency参数：数据类型：void。该命令不需要参数。返回值：ReaderWorkFrequency数据类型（见4.5）。该命令返回读写设备当前的工作频率范围(工作频率最小值和工作频率最大值)，工作频率的单位是兆赫兹（MHz）。getInterfaceParameters功能：查询读写设备EIA-RS-232C或者EIA-RS-485接口参数用法：getInterfaceParameters(void):InterfaceParametersType参数：数据类型：void。该命令不需要参数。返回值：InterfaceParametersType（4.6）EIA-RS-232CgetRFPower功能：查询读写设备的输出功率实现需求：必须实现用法：getRFPower(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备的输出功率，单位是兆赫兹（MHz）。getLogicAddress功能：查询读写设备的通信逻辑地址实现需求：必须实现用法：getLogicAddress(void):ReaderLogicAddress参数：数据类型：void。该命令不需要参数。返回值：ReaderLogicAddress数据类型（见4.7）。该命令返回读写设备的通信逻辑地址。参数设置接口setCommunicationPortType功能：设置读写设备的物理接口类型(EIA-RS-232C、EIA-RS-485、以太网口、无线网络接口或其它类型)实现需求：必须实现缺省值：EIA-RS-232C用法：setCommunicationPortType(ReaderComPortType[]):void参数：ReaderComPortType（4.1）。读写设备的通讯端口类型。返回值：数据类型：void。该命令不需要返回值。setAntennaCount功能：设置读写设备的天线数量实现需求：可选用法：setAntennaCount(integer):void参数：数据类型：integer。读写设备的天线数量。返回值：数据类型：void。该命令不需要返回值。setCurrentWorkingAntenna功能：设置读写设备当前工作的天线实现需求：可选用法：setCurrentWorkingAntenna(ReaderAntennaPort[]):void参数：ReaderAntennaPort数据类型。读写设备当前工作的天线。返回值：数据类型：void。该命令不需要返回值。setWorkingMode功能：设置读写设备当前的工作模式实现需求：必须实现用法：setWorkingMode(ReaderWorkingModeType):void参数：ReaderWorkingModeType数据类型。读写设备当前的工作模式。返回值：数据类型：void。该命令不需要返回值。setCommandInterval功能：设置读写设备当前的读取命令间隔时间实现需求：必须实现用法：setCommandInterval(integer):void参数：数据类型：integer。读写设备当前的读取命令间隔时间，单位是毫秒。返回值：数据类型：void。该命令不需要返回值。setMaxReadCountLimit功能：设置读写设备单次可识别标签数实现需求：必须实现用法：setMaxReadCountLimit(integer):void参数：数据类型：integer。读写设备单次可识别标签数。返回值：数据类型：void。该命令不需要返回值。setFrequency功能：设置读写设备工作频率范围实现需求：必须实现用法：setWorkFrequency(ReaderWorkFrequency):void参数：数据类型：ReaderWorkFrequency（4.5）。读写设备工作频率范围，单位是赫兹。返回值：数据类型：void。该命令不需要返回值。setInterfaceParametersEIA-RS-232CEIA-RS-485缺省值：9600，8，None，1用法：setInterfaceParameters(InterfaceParametersType):void参数：数据类型：void。读写设备EIA-RS-232C或者EIA-RS-485接口参数。返回值：InterfaceParametersType数据类型（见4.6）。该命令不需要返回值。setRFPower功能：设置读写设备射频输出功率实现需求：必须实现用法：setRFPower(float):void参数：数据类型：float。读写设备的输出功率，单位是dBm。返回值：void。该命令不需要返回值。setLogicAddress功能：设置读写设备的通信逻辑地址实现需求：必须实现用法：setLogicAddress(ReaderLogicAddress):void参数：数据类型：ReaderLogicAddress（见4.7）。读写设备的通信逻辑地址。返回值：void。该命令不需要返回值。设备指令接口sleepReader功能：使读写设备进入休眠状态实现需求：可选用法：sleepReader(void):bool参数：数据类型：void。该命令不需要参数。返回值：bool。该命令返回值为true，使读写设备停止工作，进入休眠状态；为false，命令失败awakeReader功能：唤醒处于休眠的读写设备实现需求：可选用法：awakeReader(void):bool参数：数据类型：void。该命令不需要参