YC/T 329-2009 烟叶电子收购系统接口规范

犐犆犛６５．１６０

犡８５

备案号：—

２７１０６２０１０

中华人民共和国烟草行业标准

／—

犢犆犜３２９２００９

烟叶电子收购系统接口规范

犐狀狋犲狉犳犪犮犲狊犲犮犻犳犻犮犪狋犻狅狀狅犳犾犲犪犳狋狅犫犪犮犮狅犲犾犲犮狋狉狅狀犻犮狌狉犮犺犪狊犲狊狊狋犲犿

狆狆狔

ㅤㅤㅤㅤ

２００９１２１４发布２０１００３０１实施

国家烟草专卖局发布

／—

犢犆犜３２９２００９

目次

前言Ⅰ

１范围１

２规范性引用文件１

３术语和定义１

４接口规范２

４．１概述２

４．２电子秤接口规范２

４．３显示屏接口规范３

４．４ＩＣ卡读写器接口规范７

４．５磁条读写器接口规范１４

４．６联网收购模式下的ＰＯＳ机接口规范１５

４．７流动收购模式下ＰＯＳ机的ＸＭＬ文档接口规范２１

附录（资料性附录）基础数据导出格式描述示例

ＡＸＭＬＳｃｈｅｍａ３６

附录（资料性附录）各语言函数调用示例

Ｂ３８

ㅤㅤㅤㅤ

／—

犢犆犜３２９２００９

烟叶电子收购系统接口规范

１范围

本标准规定了烟叶电子收购系统中软件和电子秤、显示屏、卡读写器、磁条读写器、机的接

ＩＣＰＯＳ

口函数功能和格式声明。

本标准适用于烟叶电子收购系统中的电子秤、显示屏、卡读写器、磁条读写器、机五类产品。

ＩＣＰＯＳ

２规范性引用文件

下列文件中的条款通过本标准的引用而成为本标准的条款。凡是注日期的引用文件，其随后所有

的修改单（不包括勘误的内容）或修订版均不适用于本标准，然而，鼓励根据本标准达成协议的各方研究

是否可使用这些文件的最新版本。凡是不注日期的引用文件，其最新版本适用于本标准。

／—信息技术可扩展置标语言（）

ＧＢＴ１８７９３２００２ＸＭＬ１．０

／／采用串行二进制数据交换方式的数据终端设备和数据回路终端

ＡＮＳＩＴＩＡＥＩＡ２３２Ｆ１９９７

设备之间的接口（—

ＩｎｔｅｒｆａｃｅｂｅｔｗｅｅｎｄａｔａｔｅｒｍｉｎａｌｅｕｉｍｅｎｔａｎｄｄａｔａｃｉｒｃｕｉｔＴｅｒｍｉｎａｔｉｎｅｕｉｍｅｎｔ

ｑｐｇｑｐ

）

ｅｍｌｏｉｎｓｅｒｉａｌｂｉｎａｒｄａｔａｉｎｔｅｒｃｈａｎｅ

ｐｙｇｙｇ

３术语和定义

下列术语和定义适用于本标准。

３．１ㅤㅤㅤㅤ

犔犈犇显示屏犔犈犇犪狀犲犾

狆

通过一定的控制方式，用于显示文字、文本、图形、图像、动画、行情等各种信息以及电视、录像信号

并由ＬＥＤ器件阵列组成的显示屏幕。

３．２

显示单元犱犻狊犾犪狌狀犻狋

狆狔

由电路及安装结构确定的并具有显示功能的组成ＬＥＤ显示屏的最小单元。

３．３

失控点狅狌狋狅犳犮狅狀狋狉狅犾狅犻狀狋

狆

发光状态与控制要求的显示状态不相符并呈离散分布的ＬＥＤ基本发光点。

３．４

电子秤犲犾犲犮狋狉狅狀犻犮狊犮犪犾犲狊

称重专用计量器具。包括称重仪表和称台，仪表对从称台传递过来的质量信号进行运算、转换。

３．５

集成电路（卡）读写器

犐犆犐犆犮犪狉犱狉犲犪犱犲狉

各类集成电路（卡）读写设备。如台式卡读写器、内置或外置（宿主机为微机）的卡通用读

ＩＣＩＣＩＣ

写器等。该类产品可与计算机（或网络）在联机或脱机方式下对卡完成识别和各种操作。

ＩＣ

３．６

磁条读写器／

犿犪狀犲狋犻犮狊狋狉犻狉犲犪犱犲狉犲狀犮狅犱犲狉

犵狆

用于读写磁卡、存折的磁条信息的硬件设备。

３．７

犘犗犛机犘犗犛犿犪犮犺犻狀犲

烟叶收购专用仪器，配合显示屏、打印机、集成电路（）卡读写器和电子秤完成烟叶收购。

ＩＣ

１

／—

犢犆犜３２９２００９

３．８

基础数据导出格式文档犲狓狅狉狋犫犪狊犲犱犱犪狋犪犳狅狉犿犪狋狅犳犱狅犮狌犿犲狀狋狊

狆

严格遵循本标准的定义和规范，反映烟叶电子收购系统与ＰＯＳ机数据中基础数据导出的标准

定义。

３．９

业务数据导入格式文档犻犿狅狉狋犫狌狊犻狀犲狊狊犱犪狋犪犳狅狉犿犪狋狅犳犱狅犮狌犿犲狀狋狊

狆

严格遵循本标准的定义和规范，反映烟叶电子收购系统与ＰＯＳ机数据中业务数据导入的标准

定义。

３．１０

数据类型犱犪狋犪狋犲狊

狔狆

用于界定一个元素或属性存储的数据类型，包括字符型、数值型、整型、逻辑型、字符串五种。数据

类型根据不同的字符选择确定。

字符型：可以保存任何的数据。

数值型：由数字组成，代表一个数值，可以含有小数点。

整型：由数字组成，代表一个数值，不含小数点。

逻辑型：用于判断“真”或“假”的值。

字符串：以ＮＵＬＬ结束的零个或多个字符组成的串。

注：元素或属性的名字严格区分大小写。

３．１１

犡犕犔文件犡犕犔犱狅犮狌犿犲狀狋狊

用ＸＭＬ语言标准表述烟叶电子收购系统ＰＯＳ机接口数据格式的计算机电子文档。

ㅤㅤㅤㅤ

３．１２

犡犕犔狊犮犺犲犿犪文件犡犕犔狊犮犺犲犿犪犱狅犮狌犿犲狀狋狊

符合ＸＭＬ标准文件格式，用一套预先规定的ＸＭＬ元素和属性创建的用于描述ＸＭＬ文件格式与

数据类型的文件。具体格式可参见附录。

Ａ

４接口规范

４．１概述

本接口规范详细介绍电子秤、显示屏、卡读写器、磁条读写器和机的接口函数功能和格式

ＩＣＰＯＳ

声明。对函数调用方式采用语言进行表述，具体其他程序语言表述可参见附录。

ＣＢ

４．２电子秤接口规范

初始化电子秤通讯通道＿＿

４．２．１犜犆犠犕犗犲狀犆狅犿

狆

函数调用：＿＿（）

ｓｈｏｒｔＴＣＷＭＯｅｎＣｏｍｓｈｏｒｔｉＣｏｍ

ｐ

功能描述：初始化电子秤通讯通道。

参数描述：

：位有符号整数，电子秤所连接的主机通讯通道，如果采用通讯模式则本参数值

ｉＣｏｍ１６ＵＳＢ

必须填，若采用、或通讯模式则本参数值对应主机的串口号。为入口参数。

０ＲＳ２３２ＲＳ４２２ＲＳ４８５

函数返回值：

位有符号整数，返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

电子秤连接主机的串口ＣＯＭＭ１，函数应按下面形式调用：

＿＿（）；

ＴＣＷＭＯｅｎＣｏｍ１

ｐ

２

／—

犢犆犜３２９２００９

关闭电子秤通讯通道＿＿

４．２．２犜犆犠犕犆犾狅狊犲犆狅犿

函数调用：＿＿（）

ｖｏｉｄＴＣＷＭＣｌｏｓｅＣｏｍＶｏｉｄ

功能描述：关闭初始化对应的电子秤通讯通道。

参数描述：

Ｖｏｉｄ无参数。

函数返回值：

无返回值。

示例：

＿＿（）；

ＴＣＷＭＣｌｏｓｅＣｏｍ

获取重量＿＿

４．２．３犜犆犠犕犌犲狋犠犲犻犺狋

犵

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＷＭＧｅｔＷｅｉｈｔｃｈａｒｆＴａｒｅｃｈａｒｆＮｅｔＷｅｉｈｔ

ｇｇ

功能描述：获取电子秤的皮重、净重。

参数描述：

ｆＴａｒｅ：字符串，返回电子秤皮重值。为出口参数。

ｆＮｅｔＷｅｉｈｔ：字符串，返回电子秤净重值。为出口参数。

ｇ

函数返回值：

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

ＣｈａｒｆＴａｒｅ；

ＣｈａｒｆＮｅｔＷｅｉｈｔ；

ｇ

＿＿（，）；ㅤㅤㅤㅤ

ＴＣＷＭＧｅｔＷｅｉｈｔｆＴａｒｅｆＮｅｔＷｅｉｈｔ

ｇｇ

４．３显示屏接口规范

初始化显示屏通讯通道＿＿

４．３．１犜犆犔犈犇犗犲狀犆狅犿

狆

函数调用：＿＿（）

ｓｈｏｒｔＴＣＬＥＤＯｅｎＣｏｍｓｈｏｒｔｉＣｏｍ

ｐ

功能描述：初始化显示屏通讯通道。

参数描述：

：位有符号整数，显示屏所连接的主机通讯通道，如果采用通讯模式则本参数值

ｉＣｏｍ１６ＵＳＢ

必须填，若采用、或通讯模式则本参数值对应主机的串口号。为入口参数。

０ＲＳ２３２ＲＳ４２２ＲＳ４８５

函数返回值：

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

显示屏连接主机的串口ＣＯＭＭ１，函数应按下面形式调用：

＿＿（）；

ＴＣＬＥＤＯｅｎＣｏｍ１

ｐ

关闭显示屏通讯通道＿＿

４．３．２犜犆犔犈犇犆犾狅狊犲犆狅犿

函数调用：＿＿（）

ｖｏｉｄＴＣＬＥＤＣｌｏｓｅＣｏｍｖｏｉｄ

功能描述：关闭初始化对应的显示屏通讯通道。

参数描述：

Ｖｏｉｄ无参数。

函数返回值：

无返回值。

示例：

＿＿（）；

ＴＣＬＥＤＣｌｏｓｅＣｏｍ

３

／—

犢犆犜３２９２００９

设置滚动屏行进入方式＿＿

４．３．３犜犆犔犈犇犛犲狋犈狀狋狉犕狅犱犲

狔

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＬＥＤＳｅｔＥｎｔｒＭｏｄｅｓｈｏｒｔｉＬｅｄＮｕｍｃｈａｒＥｎｔｒＭｏｄｅ

ｙｙ

功能描述：设置显示屏特定屏行字符显示时的进入方式。

参数描述：

：位有符号整数，显示屏中对应的滚动屏行。如显示屏为行显示屏，设置第

ｉＬｅｄＮｕｍ１６３

行屏的进入方式，则本参数值为。为入口函数。

２２

：位有符号整数，进入方式编码见表。为入口函数。

ＥｎｔｒＭｏｄｅ８１

ｙ

函数返回值：

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

设置第二屏行的进入方式为直接显示，函数应按下面形式调用：

［］；

ＣｈａｒＥｎｔｒＭｏｄｅ１

ｙ

ＥｎｔｒＭｏｄｅ＝０ｘ０１；

ｙ

＿＿（，）；

ＴＣＬＥＤＳｅｔＥｎｔｒＭｏｄｅ２ＥｎｔｒＭｏｄｅ

ｙｙ

表１进入方式代码表

序号进入方式编码

１直接显示０ｘ００

２向右移入０ｘ０１

３向左移入０ｘ０２

４向右展开０ｘ０３

ㅤㅤㅤㅤ

５向左展开０ｘ０４

６从左右向中间展开０ｘ０５

７从中间向左右展开０ｘ０６

８向上展开０ｘ０７

９向下展开０ｘ０８

１０从上下向中间展开０ｘ０９

１１从中间向上下展开０ｘ１０

１２水平百叶窗０ｘ１１

１３垂直百叶窗０ｘ１２

设置滚动屏行退出方式＿＿

４．３．４犜犆犔犈犇犛犲狋犗狌狋犕狅犱犲

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＬＥＤＳｅｔＯｕｔＭｏｄｅｓｈｏｒｔｉＬｅｄＮｕｍｃｈａｒＯｕｔＭｏｄｅ

功能描述：设置参数中对应的屏行字符退出时的退出方式。

参数描述：

：位有符号整数，显示屏中对应的滚动屏行。如显示屏为行显示屏，设置第行

ｉＬｅｄＮｕｍ１６３２

屏的退出方式，则本参数值为。为入口函数。

２

：位有符号整数，退出方式编码见表。为入口函数。

ＥｎｔｒＭｏｄｅ８２

ｙ

函数返回值：

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

设置第二行屏的退出方式为直接退出，函数应按下面形式调用：

４

／—

犢犆犜３２９２００９

［］；

ＣｈａｒＯｕｔＭｏｄｅ１

ＯｕｔＭｏｄｅ＝０ｘ０１；

＿＿（，）；

ＴＣＬＥＤＳｅｔＯｕｔＭｏｄｅ２０ｘ０１

表２退出方式代码表

序号退出方式编码

１直接显示０ｘ００

２向右移入０ｘ０１

３向左移入０ｘ０２

４向右展开０ｘ０３

５向左展开０ｘ０４

６从左右向中间展开０ｘ０５

７从中间向左右展开０ｘ０６

８向上展开０ｘ０７

９向下展开０ｘ０８

１０从上下向中间展开０ｘ０９

１１从中间向上下展开０ｘ１０

１２水平百叶窗０ｘ１１

１３垂直百叶窗０ｘ１２

设置滚动屏行显示完成后的停留时间＿＿

４．３．５犜犆犔犈犇犛犲狋犓犲犲犜犻犿犲

狆

ㅤㅤㅤㅤ

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＬＥＤＳｅｔＫｅｅＴｉｍｅｓｈｏｒｔｉＬｅｄＮｕｍｓｈｏｒｔｉＴｉｍｅ

ｐ

功能描述：设置显示屏中特定屏行字符显示完成后的字符停留时间。

参数描述：

：位有符号整数，显示屏中对应的屏行。如显示屏为行显示屏，设置第行屏

ｉＬｅｄＮｕｍ１６３２

的字符保留时间，则本参数值为。为入口函数。

２

：位有符号整数，停留时间，单位：秒。为入口函数。

ｉＴｉｍｅ１６

函数返回值：

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

设置第二行屏的字符显示保留时间为，函数应按下面形式调用：

５ｓ

＿＿（，）；

ＴＣＬＥＤＳｅｔＫｅｅＴｉｍｅ２５

ｐ

设置滚动屏行字符的移动速度＿＿

４．３．６犜犆犔犈犇犛犲狋犛狋犲

狆

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＬＥＤＳｅｔＳｔｅｓｈｏｒｔｉＬｅｄＮｕｍｃｈａｒｉＳｔｅ

ｐｐ

功能描述：设置显示屏中特定屏行字符的移动速度。

参数描述：

：位有符号整数，显示屏中对应的屏行。如显示屏为行显示屏，设置第行屏

ｉＬｅｄＮｕｍ１６３２

的字符保留时间，则本参数值为。为入口函数。

２

：位有符号整数，移动速度编码见表，为入口函数。

ｉＳｔｅ８３

ｐ

函数返回值：

位有符号整数。返回值为表示成功，非表示失败。由设备提供商自定义失败值所表示

１６００

意义。

５

／—

犢犆犜３２９２００９

示例：

设置第二行屏的字符移动速度为一般，函数应按下面形式调用：

＿＿（，）；

ＴＣＬＥＤＳｅｔＳｔｅ２０ｘ００

ｐ

表３移动速度代码表

序号移动速度编码

１最慢０ｘ００

２慢０ｘ０１

３较慢０ｘ０２

４一般０ｘ０３

５较快０ｘ０４

６快０ｘ０５

７最快０ｘ０６

向特定屏行发送显示内容＿＿

４．３．７犜犆犔犈犇犛犲狀犱犛狋狉

函数调用：＿＿（，）

ｓｈｏｒｔＴＣＬＥＤＳｅｎｄＳｔｒｓｈｏｒｔｉＬｅｄＮｕｍｃｈａｒＳｔｒ

功能描述：向设定的屏行发送显示内容。如果设定的屏行为滚动屏则显示内容不作限制，若设定

的屏行为静态文本屏则显示内容不应超过个字节。

８

参数描述：

：位有符号整数，显示屏中对应的屏行。如显示屏为行显示屏，设置第行屏

ｉＬｅｄＮｕｍ１６３２

作为显示屏行，则本参数填。为入口函数。

２

Ｓｔｒ：字符串，显示内容。为入口函数。

ㅤㅤㅤㅤ

函数返回值：

位有符号整数。返回值为表示成功，非表示失败。由设备提供商自定义失败值所表示

１６００

意义。

示例：

设置第二行屏的显示内容，函数应按下面形式调用：

ＣｈａｒＳｔｒ＝‘测试内容’；

ＳｈｏｒｔｉＬｅｄＮｕｍ＝２；

＿＿（，）；

ＴＣＬＥＤＳｅｎｄＳｔｒｉＬｅｄＮｕｍＳｔｒ

向显示屏发送固定格式的显示内容＿＿

４．３．８犜犆犔犈犇犛犲狀犱犐狀犳狅

函数调用：＿＿（，，

ｓｈｏｒｔＴＣＬＥＤＳｅｎｄＩｎｆｏｃｈａｒＦａｒｍｅｒＮａｍｅｃｈａｒＦａｒｍｅｒＩＤｃｈａｒ

，，，，）

ＬｅａｆＬｅｖｅｌｃｈａｒＰｒｉｃｅｃｈａｒＷｅｉｈｔｃｈａｒＭｏｎｅｃｈａｒＯｔｈｅｒＳｔｒ

ｇｙ

功能描述：向显示屏发送固定格式的显示内容，用户可根据实际情况设定要显示的选项，对于不

需显示的内容，可直接用空字符串作为赋值。函数只涉及到显示内容，不对显示位置进行限定。

参数描述：

ＦａｒｍｅｒＮａｍｅ：字符串，烟农姓名。若对应的显示烟农姓名的屏行是可滚动屏栏，则不限制烟

农姓名显示长度；若为静态文本屏，则烟农姓名最大长度为个字节。为入口函数。

８

ＦａｒｍｅｒＩＤ：字符串，烟农微机号。若对应的显示烟农微机号的屏行为可滚动屏栏，则不限制

烟农微机号字节长度，如果为静态文本屏，则烟农微机号最大长度为个字节。为入口函数。

１０

ＬｅａｆＬｅｖｅｌ：字符串，烟叶等级。如果对应的显示烟叶等级的屏行为可滚动屏栏，则不限制烟

叶等级字节长度，如果为静态文本屏，则烟叶等级最大长度为个字节。为入口函数。

８

：字符串，烟叶等级单价，保留位小数点。为入口函数。

Ｐｒｉｃｅ２

：字符串，烟叶重量，保留位小数点。为入口函数。

Ａｍｏｕｎｔ２

６

／—

犢犆犜３２９２００９

：字符串，烟叶金额，保留位小数点。为入口函数。

Ｍｏｎｅｙ２

ＯｔｈｅｒＳｔｒ：字符串，备用显示。为入口函数。

函数返回值：

位有符号整数。返回值为表示成功，非表示失败。由设备提供商自定义失败值所表示

１６００

意义。

示例：

设置显示屏的显示内容，函数应按下面形式调用：

ＣｈａｒＦａｒｍｅｒＮａｍｅ＝‘张三’；

‘’；

ＣｈａｒＦａｒｍｅｒＩｄ＝０１０１０００１

ＣｈａｒＬｅａｆＬｅｖｅｌ＝‘上柠一’；

‘’；

ＣｈａｒＰｒｉｃｅ＝１８．４５

‘’；

ＣｈａｒＷｅｉｈｔ＝１０．００

ｇ

‘’；

ＣｈａｒＭｏｎｅ＝１８４５．００

ｙ

ＣｈａｒＯｔｈｅｒＳｔｒ＝‘’；

＿＿（，，，，，，）；

ＴＣＬＥＤＳｅｎｄＩｎｆｏＦａｒｍｅｒＮａｍｅＦａｒｍｅｒＩＤＬｅａｆＬｅｖｅｌＰｒｉｃｅｗｅｉｈｔＭｏｎｅＯｔｈｅｒｓｔｒ

ｇｙ

发送语音信息＿＿

４．３．９犜犆犔犈犇犛犲狀犱犛狅狌狀犱

函数调用：＿＿（）

ｓｈｏｒｔＴＣＬＥＤＳｅｎｄＳｏｕｎｄｃｈａｒｓＳｏｕｎｄ

功能描述：只支持报语音功能的显示屏。

参数描述：

ｓＳｏｕｎｄ：字符串，语音内容。

函数返回值：

ㅤㅤㅤㅤ

位有符号整数。返回值为表示成功，非表示失败；由设备提供商自定义失败值所表示

１６００

意义。

示例：

ＣｈａｒｓＳｏｕｎｄ＝‘欢迎光临’；

＿＿（）；

ＴＣＬＥＤＳｅｎｄＳｏｕｎｄｓＳｏｕｎｄ

４．４犐犆卡读写器接口规范

初始化卡读写器通讯通道＿＿

４．４．１犐犆犜犆犐犆犗犲狀犆狅犿

狆

函数调用：＿＿（）

ｓｈｏｒｔＴＣＩＣＯｅｎＣｏｍｓｈｏｒｔｉＣｏｍ

ｐ

功能描述：初始化卡读写器通讯通道。

ＩＣ

参数描述：

：位有符号整数，卡读写器所连接的主机通讯通道，如果采用通讯模式则本

ｉＣｏｍ１６ＩＣＵＳＢ

参数值必须填，若采用、或通讯模式则本参数值对应主机的串口号。为入口

０ＲＳ２３２ＲＳ４２２ＲＳ４８５

参数。

函数返回值：

位有符号整数。返回值为表示成功，非表示失败。由设备提供商自定义失败值所表示

１６００

意义。

示例：

ＩＣ卡读写器连接主机的串口ＣＯＭ１，那么函数应该按下面形式调用：

＿＿（）；

ＴＣＩＣＯｅｎＣｏｍ１

ｐ

关闭卡读写器通讯通道＿＿

４．４．２犐犆犜犆犐犆犆犾狅狊犲犆狅犿

函数调用：＿＿（）

ｖｏｉｄＴＣＩＣＣｌｏｓｅＣｏｍｖｏｉｄ

功能描述：关闭初始化对应的卡读写器通讯通道。

ＩＣ

７

／—

犢犆犜３２９２００９

参数描述：

Ｖｏｉｄ无参数。

函数返回值：

ｖｏｉｄ无返回值。

示例：

＿＿（）；

ＴＣＩＣＣｌｏｓｅＣｏｍ

获取卡读写器版本信息＿＿

４．４．３犐犆犜犆犐犆犚犲犪犱犲狉犞犲狉狊犻狅狀

函数调用：＿＿（）

ｖｏｉｄＴＣＩＣＲｅａｄｅｒＶｅｒｓｉｏｎｃｈａｒｓＲｅａｄｅｒＶｅｒｓｉｏｎ

功能描述：获取卡读写器版本信息。

ＩＣ

参数描述：

：字符串，卡读写器版本信息。为出口参数。

ｓＲｅａｄｅｒＶｅｒｓｉｏｎＩＣ

函数返回值：

ｖｏｉｄ无返回值。

示例：