YC/T 329-2009 烟叶电子收购系统接口规范 YC/T329-2009 标准下载解压密码：www.bzxz.net

ICS65.160
备案号：27106—2010
中华人民共和国烟草行业标准
YC/T329—2009
烟叶电子收购系统接口规范
Interface specificationofleaf tobaccoelectronicpurchase system2009-12-14发布
数码防伪
国家烟草专卖局
2010-03-01实施
YC/T329—2009
规范性引用文件
术语和定义
接口规范
电子秤接口规范
显示屏接口规范
IC卡读写器接口规范
磁条读写器接口规范·
联网收购模式下的POS机接口规范4.6
流动收购模式下POS机的XML文档接口规范次
附录A（资料性附录）基础数据导出XMLSchema格式描述示例附录B（资料性附录）
各语言函数调用示例
本标准的附录A和附录B为资料性附录。本标准由国家烟草专卖局提出。YC/T329—2009
本标准由全国烟草标准化技术委员会信息分技术委员会（SAC/TC144/SC7)归口。本标准起草单位：中国烟叶公司、国家烟草专卖局烟草经济信息中心、厦门中软海晟信息技术有限公司。
本标准主要起草人：刘、高一军、姜海云、轩松岭、何勇。1范围
烟叶电子收购系统接口规范
YC/T329—2009
本标准规定了烟叶电子收购系统中软件和电子秤、显示屏、IC卡读写器、磁条读写器、POS机的接口函数功能和格式声明。
本标准适用于烟叶电子收购系统中的电子秤、显示屏、IC卡读写器、磁条读写器、POS机五类产品。2规范性引用文件
下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。GB/T18793-2002信息技术可扩展置标语言（XML)1.0ANSI/TIA/EIA-232-F-1997采用串行二进制数据交换方式的数据终端设备和数据回路终端设备之间的接（Interfacebetwecndataterminalcquipmentanddatacircuit—Terminatingequipmentemployingserialbinarydatainterchange)3术语和定义
下列术语和定义适用于本标准。3.1
LED显示屏LEDpanel
通过一定的控制方式，用于显示文字、文本、图形、图像、动画、行情等各种信息以及电视、录像信号并由LED器件阵列组成的显示屏幕。3.2
显示单元displayunit
由电路及安装结构确定的并具有显示功能的组成LED显示屏的最小单元。3.3
失控点
out-of-controlpoint
发光状态与控制要求的显示状态不相符并呈离散分布的LED基本发光点。3.4
电子秤electronicscales
称重专用计量器具。包括称重仪表和称台，仪表对从称台传递过来的质量信号进行运算、转换。3.5
集成电路（IC卡）读写器ICcardreader各类集成电路（IC卡）读写设备。如台式IC卡读写器、内置或外置（宿主机为微机）的IC卡通用读写器等。该类产品可与计算机(或网络)在联机或脱机方式下对IC卡完成识别和各种操作。3.6
magneticstripreader/encoder
磁条读写器
用于读写磁卡、存折的磁条信息的硬件设备。3.7
POS机POSmachine
烟叶收购专用仪器，配合显示屏、打印机、集成电路（IC)卡读写器和电子秤完成烟叶收购。1
YC/T329—2009
基础数据导出格式文档export-baseddataformatofdocuments严格遵循本标准的定义和规范，反映烟叶电子收购系统与POS机数据中基础数据导出的标准定义。
业务数据导入格式文档import-businessdataformatofdocuments严格遵循本标准的定义和规范，反映烟叶电子收购系统与POS机数据中业务数据导入的标准定义。
数据类型datatypes
用于界定一个元素或属性存储的数据类型，包括字符型、数值型、整型、逻辑型、字符串五种。数据类型根据不同的字符选择确定。字符型：可以保存任何的数据。数值型：由数字组成，代表一个数值，可以含有小数点。整型：由数字组成，代表一个数值，不含小数点。逻辑型：用于判断“真”或“假”的值。字符中：以NULL结束的零个或多个字符组成的串。注：元素或属性的名字严格区分大小写，3.11
XML文件XMLdocuments
用XML语言标准表述烟叶电子收购系统POS机接口数据格式的计算机电子文档。3.12
XMLschema文件XMLschemadocuments符合XML标准文件格式，用一套预先规定的XML元素和属性创建的用于描述XML文件格式与数据类型的文件。具体格式可参见附录A。4接口规范
4.1概述
本接口规范详细介电子秤、显示屏、IC卡读写器、磁条读写器和POS机的接口函数功能和格式声明。对函数调用方式采用C语言进行表述，具体其他程序语言表述可参见附录B。4.2电子秤接口规范
4.2.1初始化电子秤通讯通道TC_WM_OpenCom函数调用：shortTC_WM_OpenCom（shortiCom）功能描述：初始化电子秤通讯通道。参数描述：
iCom：16位有符号整数，电子秤所连接的主机通讯通道，如果采用USB通讯模式则本参数值必须填0，若采用RS232、RS422或RS485通讯模式则本参数值对应主机的串口号。为人口参数。函数返回值：
16位有符号整数，返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
电子秤连接主机的申口COMM1，函数应按下面形式调用：TC_WM_OpenCom(1);
2关闭电子秤通讯通道TC_WM_CloseCom4.2.2
函数调用：voidTC_WM_CloseCom(Void）功能描述：关闭初始化对应的电子秤通讯通道。参数描述：
Void无参数。
函数返回值：
无返回值。
示例：
TC_WM_CloseCom();
4.2.3获取重量TC_WM_GetWeight函数调用：shortTC_WM_GetWcight（char*fTare，charfNetWeight）功能描述：获取电子秤的皮重、净重。参数描述：
fTare：字符串，返回电子秤皮重值。为出口参数。fNetWeight：字符串，返回电子秤净重值。为出口参数。函数返回值：
YC/T329—2009
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
Char +fTare;
Char *fNetWeight;
TC_WM_GetWeight(fTare,fNetWeight);4.3显示屏接口规范
4.3.1初始化显示屏通讯通道TC_LED_OpenCom函数调用：shortTC_LED_OpcnCom(shortiCom）功能描述：初始化显示屏通讯通道。参数描述：
iCom：16位有符号整数，显示屏所连接的主机通讯通道，如果采用USB通讯模式则本参数值必须填0，若采用RS232、RS422或RS485通讯模式则本参数值对应主机的串口号。为入口参数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
显示屏连接主机的串口COMM1，函数应按下面形式调用：TC_LED_OpenCom(1);
4.3.2关闭显示屏通讯通道TC_LED_CloseCom函数调用：voidTC_LED_CloseCom(void）功能描述：关闭初始化对应的显示屏通讯通道。参数描述：
Void无参数。
函数返回值：
无返回值。
示例：
TC_LED_CloseCom();
YC/T329—2009
设置滚动屏行进入方式TC_LED_SetEntryMode函数调用：shortTC_LED_SetEntryMode(shortiLedNum，charEntryMode)功能描述：设置显示屏特定屏行字符显示时的进人方式，参数描述：
iLedNum：16位有符号整数，显示屏中对应的滚动屏行。如显示屏为3行显示屏，设置第2行屏的进入方式，则本参数值为2。为人口函数。EntryModc：8位有符号整数，进人方式编码见表1。为人口函数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
设置第二屏行的进入方式为直接显示，函数应按下面形式调用：Char EntryMode[1];
EntryMode=Oxol,
TC_LED_SetEntryMode(2，EntryMode);表1
进入方式代码表
进人方式
直接显示
向右移人
向左移入
向右展开
向左履开
从左右向中间展开
从中间向左右展开
向上展开
向下履开
从上下向中间展开
从中间向上下展开
水平百叶窗
垂直百叶窗
设置滚动屏行退出方式TC_LED_SetOutMode4.3.4
函数调用：shortTC_LED_SetOutMode(shortiLedNum，charOutMode)功能描述：设置参数中对应的屏行字符退出时的退出方式。参数描述：
iLedNum：16位有符号整数，显示屏中对应的滚动屏行。如显示屏为3行显示屏，设置第2行屏的退出方式，则本参数值为2。为人口函数。EntryMode：8位有符号整数，退出方式编码见表2。为人口函数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
设置第二行屏的退出方式为直接退出，函数应按下面形式调用：4
Char OutMode[1];
OutMode=Oxol；
TC_LED_SetOutMode(2,0x01);
退出方式代码表
退出方式
直接显示
向右移人
向左移人
向右展开
向左展开
从左右向中间展开
从中间向左右展开
向上展开
向下展开
从上下向中间展开
从中间向上下展开
水平百叶窗
垂直百叶窗
设置滚动屏行显示完成后的停留时间TC_LED_SetKeepTime函数调用：shortTC_LED_SetKeepTime(shortiLedNum，shortiTime)功能描述：设置显示屏中特定屏行字符显示完成后的字符停留时间。参数描述：
YC/T329—2009
iLedNum：16位有符号整数，显示屏中对应的屏行。如显示屏为3行显示屏，设置第2行屏的字符保留时间，则本参数值为2。为入口函数。iTime：16位有符号整数，停留时间，单位：秒。为人口函数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
设置第二行屏的字符显示保留时间为5s，函数应按下面形式调用：TC_LED_SetKeepTime(2,5);
设置滚动屏行字符的移动速度TC_LED_SetStep4.3.6
函数调用：shortTC_LED_SetStep(shortiLedNum，chariStep)）功能描述：设置显示屏中特定屏行字符的移动速度。参数描述：
iLedNum：16位有符号整数，显示屏中对应的屏行。如显示屏为3行显示屏，设置第2行屏的字符保留时间，则本参数值为2。为入口函数。iStep：8位有符号整数，移动速度编码见表3，为人口函数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败。由设备提供商自定义失败值所表示意义。
YC/T329—2009
示例：
设置第二行屏的字符移动速度为一般，函数应按下面形式调用：TC_LED_SetStep(2,0x00)；
移动速度代码表
移动速度
向特定屏行发送显示内容TC_LED_SendStr4.3.7
函数调用：shortTC_LED_SendStr(shortiLedNum，charStr）编码
功能描述：向设定的屏行发送显示内容。如果设定的屏行为滚动屏则显示内容不作限制，若设定的屏行为静态文本屏则显示内容不应超过8个字节。参数描述：
iLedNum：16位有符号整数，显示屏中对应的屏行。如显示屏为3行显示屏，设置第2行屏作为显示屏行，则本参数填2。为入口函数。Str：字符串，显示内容。为入口函数。函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败。由设备提供商自定义失败值所表示意义。
示例：
设置第二行屏的显示内容，函数应按下面形式调用：Char*Str=‘测试内容'；
Short iLedNum = 2;
TC_LED_SendStr(iLedNum，Str)；4.3.8向显示屏发送固定格式的显示内容TC_LED_SendInfo函数调用：shortTC_LED_SendInfo(char*FarmerName，char*FarmerID，charLeafLevel，char*Price，char*Weight，char*Money，char*OtherStr)功能描述：向显示屏发送固定格式的显示内容，用户可根据实际情况设定要显示的选项，对于不需显示的内容，可直接用空字符串作为赋值。函数只涉及到显示内容，不对显示位置进行限定。参数描述：
FarmerName：字符串，烟农姓名。若对应的显示烟农姓名的屏行是可滚动屏栏，则不限制烟农姓名显示长度；若为静态文本屏，则烟农姓名最大长度为8个字节。为人口函数。FarmerID：字符串，烟农微机号。若对应的显示烟农微机号的屏行为可滚动屏栏，则不限制烟农微机号字节长度，如果为静态文本屏，则烟农微机号最大长度为10个字节。为人口函数，LeafLevel：字符串，烟叶等级。如果对应的显示烟叶等级的屏行为可滚动屏栏，则不限制烟叶等级字节长度，如果为静态文本屏，则烟叶等级最大长度为8个字节。为入口函数。Pricc：字符串，烟叶等级单价，保留2位小数点。为入口函数。Amount：字符串，烟叶重量，保留2位小数点。为人口函数。6
Money：字符串，烟叶金额，保留2位小数点。为人口函数。OtherStr：字符串，备用显示。为人口函数。函数返回值：
YC/T329—2009
16位有符号整数。返回值为0表示成功，非0表示失败。由设备提供商自定义失败值所表示意义。
示例：
设置显示屏的显示内容，函数应按下面形式调用：Char*FarmerName“张三'；
Char *Farmerld=‘01010001';
Char *LeafLevel =‘上柠_';
Char *Price=‘18.45';
Char*Weight ‘10.00';
Char*Money=1845.00';
Char*OtherStr =“\
TC_LED_SendInfo(FarmerName，FarmerID,LeafLevel，Price,weight，Money,Otherstr);4.3.9发送语音信息TC_LED_SendSound函数调用：shortTC_LED_SendSound(char*sSound)功能描述：只支持报语音功能的显示屏。参数描述：
sSound：字符串，语音内容。
函数返回值：
16位有符号整数。返回值为0表示成功，非0表示失败；由设备提供商自定义失败值所表示意义。
示例：
Char*sSound=
“欢迎光临；
TC_LED_SendSound（sSound）；4.4IC卡读写器接口规范
4.4.1初始化IC卡读写器通讯通道TC_IC_OpenCom函数调用：shortTC_IC_OpenCom（shortiCom）功能描述：初始化IC卡读写器通讯通道。参数描述：
iCom：16位有符号整数，IC卡读写器所连接的主机通讯通道，如果采用USB通讯模式则本参数值必须填0，若采用RS232、RS422或RS485通讯模式则本参数值对应主机的串口号。为人口参数。
函数返回值：此内容来自标准下载网
16位有符号整数。返回值为0表示成功，非0表示失败。由设备提供商自定义失败值所表示意义。
示例：
IC卡读写器连接主机的串口COM1，那么函数应该按下面形式调用：TC_IC_OpenCom(1);
4.4.2关闭IC卡读写器通讯通道TC_IC_CloseCom函数调用：voidTC_IC_CloseCom（void）功能描述：关闭初始化对应的IC卡读写器通讯通道。7
YC/T329—2009
参数描述：
Void无参数。
函数返回值：
void无返回值。
示例：
TC_IC_CloseCom();
4.4.3获取IC卡读写器版本信息TC_IC_ReaderVersion函数调用：voidTC_IC_ReaderVersion(char*sReaderVersion）功能描述：获取IC卡读写器版本信息。参数描述：
sReaderVersion：字符串，IC卡读写器版本信息。为出口参数。函数返回值
void无返回值。
示例：
char sReaderVersion[100] ;
TC_IC_ReaderVersion（sReaderVersion）；4.4.4获取操作错误信息TC_IC_GetLastError函数调用：shortTC_IC_GetLastError(char*sLastError)功能描述：获取最后一次对IC卡读写器操作的执行信息。参数描述：
sLastError：操作错误信息。为出口参数。函数返回值：
16位有符号整数，操作错误代码见表4。示例：
char sl.astError[10o];
TC_IC_GetLastError(sLastError)表4
操作错误信息代码表
错误类型
CRC校验错
值溢出
未验证密码
奇偶校验错
通讯出错
接收的数据位错误
接收的数据字节错误
写失败
读失败
小提示：此标准内容仅展示完整标准里的部分截取内容，若需要完整标准请到上方自行免费下载完整标准文档。