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

ICSCCS65.020.99B00YNZYC标准RadiofrequencyIdentified-basedChinesemedicine(proprietaryChinesproductiontraceabilitysystem-Part2:ReaderapplicationspecificationIT/YNZYC0097—2023本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别这些专利的责任。本文件由云南省中药材种植养殖行业协会提出并归口。本文件起草单位：昆明高新区生物医药产业促进会、云南省中药材种植养殖行业协会、云南前海高新技术产业研究院有限公司、云南钰津供应链科技有限公司、昆药集团股份有限公司、昆明中药厂有限公司、云南三七科技有限公司本文件主要起草人：徐朝能、苏豹、张自骞、陈晓虹、丁剑、李纳、李艳、李学芬、尹容梅、胡俩剑、张雪、郑辉、田孟齐、唐婉筠、刘辉、江明、孙建宁、孙高飞、杨辉T/YNZYC0097—2023I基于射频识别的中药（中成药）生产追溯系统第2部分：读写器应用规范本文件规定了中成药行业基于射频识别的生产追溯系统中读写设备信息查询、参数设置、指令和状态报告四类接口。本文件适用于中成药行业基于射频识别的生产追溯系统中使用射频识别读写设备的生产，以及射频识别读写设备网络管理系统的设计与开发。2规范性引用文件下列文件中的条款通过本文件的引用而成为本文件的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本文件，然而，鼓励根据本文件达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本文件。3术语和定义3.1射频识别（RFlD）Radiofrequencyidentification在频谱的射频部分，利用电磁耦合或感应耦合，通过各种调制和编码方案，与射频标签进行通信，并读取射频标签的信息的技术。3.2射频标签Radiofrequencytag用于物体或物品标识、具有信息存储机制的、能接收读写器的电磁场调制信号并返回响应信号的数据载体，以下简称标签。3.3读写器Reader/writer一种电子设备，执行从射频标签获取数据和向射频标签写入数据的过程，适当时，执行冲突仲裁、错误控制、信道编码、信道解码、信源编码、信源译码和交换源端数据等过程。4接口流程RFID系统与上层应用之间采用网络接口，读写器与数据平台之间实现远程访问交互，交互流程如T/YNZYC0097—2023图1接口流程所有的交互分为配置、清点和读写三部分，数据处理系统对读写器下发命令，读写器通过空中接口与标签进行通信，结果反馈给数据处理系统。5数据类型5.1主要数据类型在接口规范中，采用与编程语言相关的数据类型来描述指令的参数和返回值，主要的数据类型见表表1数据类型数据类型描述String字符串，允许采用UTF-8编码表示Snteger整型Void无参数或无返回值Float浮点型T/YNZYC0097—2023Bool布尔类型LongintegerUnsignedintegerReaderComPortType自定义类型，详解见4.2ReaderWorkingAntenna自定义类型，详解见4.3ReaderWorkingModeType自定义类型，详解见4.4TagType自定义类型，详解见4.5ReaderWorkFrequency自定义类型，详解见4.6InterfaceParametersType自定义类型，详解见4.7ReaderLogicAddress自定义类型，详解见4.8ErrorReportType自定义类型，详解见4.95.2物理接口数据类型（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保留保留5.3读写设备天线端口逻辑地址（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保留保留5.4读写设备工作模式数据类型（ReaderWorkingModeType）读写设备当前所采用的工作模式，其数据类型见表4表4读写设备工作模式数据类型工作模式类型值类型名称描述0x01CONTUNUOUS_MODE连续模式0x02TRIGGER_MODE触发模式T/YNZYC0097—20230x03COMMAND_MODE命令模式0x04-0xff保留保留5.5工作频率数据类型（ReaderWorkFrequency）描述读写设备工作频率的范围，其数据类型包括最小工作频率和最大工作频率两个字段，其结构体structReaderWorkFrequency{floatMinWorkFrequency；floatMaxWorkFrequency；其中MinWorkFrequency为读写设备的最小工作频率值，MaxWorkFrequency为读写设备的最大工作频率值，其取值范围均为0.0--9999999.0。5.6接口参数数据类型（InterfaceParametersType）具有EIA-RS-232C或EIA-RS-485接口的读写设备参数数据类型，该数据类型是一个结构体，包含4个参数，其结构体为：structInterfaceParametersType{longintegerBaudrate；integerDataBits；integerParity；floatStopBits；Baudrate参数的取值范围为{600，1200，2400，4800，9600，19200，38400，56000，115200}。DataBits参数的取值范围为{6，7，8}。Parity参数的取值见表5。StopBits参数的取值见表6。表5Parity参数取值及描述Parity取值名称描述1Even设置偶校验位2Mark将奇偶校验位保留为3None不发生奇偶校验检查4Odd设置奇校验位5Space将奇偶校验位保留为表6StopBits参数取值及描述Parity取值名称描述0None必使用停止位。1One使用1个停止位。OnePointFive使用1.5个停止位。2Two使用2个停止位5.7通讯逻辑地址数据类型（ReaderLogicAddress）读写设备的通讯逻辑地址主要包括EIA-RS-485、以太网口的通讯地址，其数据类型是一个结构体，包含6个字段，其形式如下：structReaderLogicAddressV{ReaderComPortTypePortType;integerReaderRS485_Address;stringReaderIP_Address;stringReaderMark_Address;stringReaderGateWay;stringReaderDNS;其中PortType为物理端口RS_485或以太网类型；ReaderRS485_Address为RS_485地址，取值为0-32；ReaderIP_Address为以太网IP地址；ReaderMark_Address为子网掩码；ReaderGateWay为网关；ReaderDNS为域名系统。当ReaderComPortType为物理端口RS_485类型时，ReaderRS485_Address有效，ReaderIP_Address，ReaderMark_Address，ReaderGateWay，ReaderDNS无效；当PortType为以太网类型时，ReaderIP_Address，ReaderMark_Address，ReaderGateWay，ReaderDNS有效，ReaderRS485_Address无效。5.8错误报告类型（ErrorReportType）读写设备返回错误报告的数据类型，其定义见表7。表7错误报告类型错误报告类型值错误报告类型名称描述0x0001INVALID_COMMAND_ERRO无效指令0x0002OUTSIDE_INTERF_ERROR外部有射频干扰0x0003ANTENNA_ERROR天线故障或没有连接天线0x0004PARAMETER_ERROR参数错误0x0005-0xffff保留保留6接口功能6.1信息查询接口6.1.1getDescription功能：查询读写设备的硬件、软件信息，包括版本号及其特征描述信息。实现需求：必须实现用法：getDescription(void):string参数：数据类型：void。该命令不需要参数。返回值：数据类型：string。该命令返回读写设备的描述信息。6.1.2getCommunicationPortType功能：查询读写设备的物理接口类型(EIA-RS-232C、EIA-RS-485、以太网口、无线网络接口或其它类型)实现需求：必须实现用法：getCommunicationPortType(void):ReaderComPortType[]参数：数据类型：void。该命令不需要参数。返回值：ReaderComPortType数据类型。该命令返回读写设备的物理接口列表。6.1.3getAntennaCountT/YNZYC0097—2023功能：查询读写设备的天线数量实现需求：可选用法：getAntennaCount(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备可连接天线的数量。6.1.4getCurrentWorkingAntenna功能：查询读写设备当前工作的天线实现需求：可选用法：getCurrentWorkingAntenna(void):ReaderAntennaPort[]参数：数据类型：void。该命令不需要参数。返回值：ReaderAntennaPort数据类型。该命令返回读写设备当前工作天线的列表。6.1.5getWorkingMode功能：查询读写设备当前的工作模式实现需求：必须实现用法：getWorkingMode(void):ReaderWorkingModeType参数：数据类型：void。该命令不需要参数。返回值：ReaderWorkingModeType数据类型。该命令返回读写设备当前的工作模式。6.1.6getCommandInterval功能：查询读写设备当前读取命令间隔时间实现需求：必须实现用法：getCommandInterval(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备当前的读取周期，单位是毫秒（ms）。6.1.7getMaxReadCountLimit功能：查询读写设备当前设置的单次可识别标签数量实现需求：必须实现用法：getMaxReadCountLimit(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备当前可识别标签数量。6.1.8getWorkFrequency功能：查询读写设备当前工作频率范围实现需求：必须实现用法：getWorkFrequency(void):ReaderWorkFrequency参数：数据类型：void。该命令不需要参数。返回值：ReaderWorkFrequency数据类型（见4.5）。该命令返回读写设备当前的工作频率范围(工作频率最小值和工作频率最大值)，工作频率的单位是兆赫兹（MHz）。6.1.9getInterfaceParameters功能：查询读写设备EIA-RS-232C或者EIA-RS-485接口参数用法：getInterfaceParameters(void):InterfaceParametersType参数：数据类型：void。该命令不需要参数。返回值：InterfaceParametersType数据类型（见4.6）。该命令返回读写设备EIA-RS-232C或者EIA-RS-485接口参数。T/YNZYC0097—20236.1.10getRFPower功能：查询读写设备的输出功率实现需求：必须实现用法：getRFPower(void):integer参数：数据类型：void。该命令不需要参数。返回值：数据类型：integer。该命令返回读写设备的输出功率，单位是兆赫兹（MHz）。6.1.11getLogicAddress功能：查询读写设备的通信逻辑地址实现需求：必须实现用法：getLogicAddress(void):ReaderLogicAddress参数：数据类型：void。该命令不需要参数。返回值：ReaderLogicAddress数据类型（见4.7）。该命令返回读写设备的通信逻辑地址。6.2参数设置接口6.2.1setCommunicationPortType功能：设置读写设备的物理接口类型(EIA-RS-232C、EIA-RS-485、以太网口、无线网络接口或其它类型)实现需求：必须实现缺省值：EIA-RS-232C用法：setCommunicationPortType(ReaderComPortType[]):void参数：ReaderComPortType数据类型（见4.1）。读写设备的通讯端口类型。返回值：数据类型：void。该命令不需要返回值。6.2.2setAntennaCount功能：设置读写设备的天线数量实现需求：可选用法：setAntennaCount(integer):void参数：数据类型：integer。读写设备的天线数量。返回值：数据类型：void。该命令不需要返回值。6.2.3setCurrentWorkingAntenna功能：设置读写设备当前工作的天线实现需求：可选用法：setCurrentWorkingAntenna(ReaderAntennaPort[]):void参数：ReaderAntennaPort数据类型。读写设备当前工作的天线。返回值：数据类型：void。该命令不需要返回值。6.2.4setWorkingMode功能：设置读写设备当前的工作模式实现需求：必须实现用法：setWorkingMode(ReaderWorkingModeType):void参数：ReaderWorkingModeType数据类型。读写设备当前的工作模式。返回值：数据类型：void。该命令不需要返回值。6.2.5setCommandInterval功能：设置读写设备当前的读取命令间隔时间实现需求：必须实现用法：setCommandInterval(integer):voidT/YNZYC0097—2023参数：数据类型：integer。读写设备当前的读取命令间隔时间，单位是毫秒。返回值：数据类型：void。该命令不需要返回值。6.2.6setMaxReadCountLimit功能：设置读写设备单次可识别标签数实现需求：必须实现用法：setMaxReadCountLimit(integer):void参数：数据类型：integer。读写设备单次可识别标签数。返回值：数据类型：void。该命令不需要返回值。6.2.7setFrequency功能：设置读写设备工作频率范围实现需求：必须实现用法：setWorkFrequency(ReaderWorkFrequency):void参数：数据类型：ReaderWorkFrequency（4.5）。读写设备工作频率范围，单位是赫兹。返回值：数据类型：void。该命令不需要返回值。6.2.8setInterfaceParameters功能：设置读写设备EIA-RS-232C或者EIA-RS-485接口参数，包括波特率等信息。实现需求：可选缺省值：9600，8，None，1用法：setInterfaceParameters(InterfaceParametersType):void参数：数据类型：void。读写设备EIA-RS-232C或者EIA-RS-485接口参数。返回值：InterfaceParametersType数据类型（见4.6）。该命令不需要返回值。6.2.9setRFPower功能：设置读写设备射频输出功率实现需求：必须实现用法：setRFPower(float):void参数：数据类型：float。读写设备的输出功率，单位是dBm。返回值：void。该命令不需要返回值。6.2.10setLogicAddress功能：设置读写设备的通信逻辑地址实现需求：必须实现用法：setLogicAddress(ReaderLogicAddress):void参数：数据类型：ReaderLogicAddress（见4.7）。读写设备的通信逻辑地址。返回值：void。该命令不需要返回值。6.3设备指令接口6.3.1sleepReader功能：使读写设备进入休眠状态实现需求：可选用法：sleepReader(void):bool参数：数据类型：void。该命令不需要参数。返回值：bool。该命令返回值为true，使读写设备停止工作，进入休眠状态；为false，命令失败6.3.2awakeReader功能：唤醒处于休眠的读写设备实现需求：可选T/YNZYC0097—2023用法：awakeReader(void):bool参数：数据类型：