YC/T 329.1-2013 烟叶管理信息系统外围设备接口 第1部分：烟叶收购

ICS65.160

X89

备案号:—

398612013

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

/—

YCT329.12013

代替/—

YCT3292009

烟叶管理信息系统外围设备接口

:

第部分烟叶收购

1

ㅤㅤㅤㅤ

—

Theinterfaceoferiheraleuimentintobaccoleafmanaement

ppqpg

:

Part1Tobaccoleafacuisition

q

2013-02-28发布2013-03-15实施

国家烟草专卖局发布

/—

YCT329.12013

目次

前言…………………………Ⅰ

1范围………………………1

2规范性引用文件…………………………1

3术语和定义………………1

4函数约定说明……………2

5接口函数规范……………2

5.1电子秤接口函数规范………………2

5.2显示屏接口函数规范………………4

5.3IC卡读写器接口函数规范…………6

5.4磁条读写器接口函数规范…………9

5.5RFID卡读写器接口函数规范……………………11

5.6定级设备接口函数规范……………14

5.7传送带控制器设备接口函数规范…………………18

5.8GPS设备接口函数规范…………20

5.9手持录入设备接口函数规范………………………22

ㅤㅤㅤㅤ

5.10指纹机接口函数规范……………24

参考文献……………………26

/—

YCT329.12013

烟叶管理信息系统外围设备接口

:

第部分烟叶收购

1

1范围

/、、、

YCT329的本部分规定了烟叶管理信息系统收购过程中电子秤显示屏IC卡读写器磁条读写

、、、、、。

器RFID卡读写器定级设备传送带控制器GPS设备手持录入设备和指纹机设备的接口规范

、、、、、

本部分适用于指导烟叶收购过程中电子秤显示屏IC卡读写器磁条读写器RFID卡读写器定

、、、。

级设备传送带控制器GPS设备手持录入设备和指纹机设备产品的接口设计

2规范性引用文件

。,

下列文件对于本文件的应用是必不可少的凡是注日期的引用文件仅注日期的版本适用于本文

。,()。

件凡是不注日期的引用文件其最新版本包括所有的修改单适用于本文件

/—显示屏通用规范

SJT111412012LED

3术语和定义

ㅤㅤㅤㅤ

下列术语和定义适用于本文件。

3.1

显示单元dislaunit

py

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

[/—,]

SJT111412012定义3.3

3.2

LED显示屏LEDanel

p

,、、、、、、

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

并由LED器件阵列组的显示屏幕。

[/—,]

SJT111412012定义3.2

3.3

电子秤electronicscales

,,、

电子称是秤重专用计量器具包括称重仪表和秤台仪表对从秤台传递过来的重量信号进行运算

转换。

3.4

集成电路()卡读写器

ICICcardreader

(),、()

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

ICICIC

。()。

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

IC

3.5

射频ID()卡读写器

RFIDRFIDcardreader

(),。

指各类射频IDRFID卡读写设备包括有固定式的和手持式的

1

/—2013

YCT329.1

3.6

磁条读写器/

maneticstrireaderencoder

gp

、。

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

3.7

定级设备radindevice

gg

指定级员用于评定烟叶等级的设备。

3.8

传送带设备conveoreuiment

yqp

指在收购过程中用于传送烟筐的输送设备。

3.9

设备

GPSolbalositionsstemdevice

gpy

、、。

全球定位系统设备通过卫星的通信可以返回当前设备所处的时间时区经纬度等信息

3.10

指纹机设备finerrintmachinedevice

gp

、。

指通过指纹来标识识别身份的设备

3.11

数据类型datates

yp

,、、。

用于界定一个元素或属性存储的数据类型包括浮点型整型逻辑型和字符串四种数据类型根

据不同的字符选择确定。

:,,。

浮点型由数字组成代表一个的数值可以含有小数点

:,,。

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

ㅤㅤㅤㅤ

:“”“”。

逻辑型用于判断真或假的值

:‘’()。

字符串以码结束的零个或多个字符组成的串

\0ASCⅡ0

:。

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

4函数约定说明

,(_)。

本部分对函数调用方式采用语言进行表述调用约定

Cstdcall

5接口函数规范

5.1电子秤接口函数规范

__

5.1.1初始化通讯通道TCWMConnect

函数调用:__(,

shortTCWMConnectshortiConnectTe

yp

char*sConnectParam)

:。

功能描述初始化电子秤所连接的主机通讯通道

参数描述:

:,,,,,

整型表示连接类型当值表示串口值表示网口值表示口为入

iConnectTe012USB

yp

口参数。

:,,:

sConnectParam字符串表示设备连接参数为入口参数

,,、

如果值为则本参数值为电子秤所对应的串口号如对应值为对

iConnectTe0COM11COM2

yp

应值为…对应值为;

2COMNN

2

/—

YCT329.12013

,,:;

如果值为则本参数值为电子秤所对应的地址和端口例如

iConnectTe1IP192.168.0.15000

yp

,。

如果值为则本参数值为电子秤所对应的唯一识别号

iConnectTe2USB

yp

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,,:

电子秤连接主机的地址为端口号为那么函数应该按下面形式调用

IP192.168.0.15000

__(,:);

TCWMConnect1"192.168.0.15000"

__

5.1.2关闭通讯通道TCWMDisconnect

函数调用:__()

shortTCWMDisconnectvoid

:。

功能描述断开对应的电子秤通讯通道

参数描述:

无参数。

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,:

断开对应的电子秤通讯通道那么函数应该按下面形式调用

__();

TCWMDisconnect

__

5.1.3电子秤重量回调函数绑定TCWMSetEvent

函数调用:__()

voidTCWMSetEventCallBackWeiht*OnNotifWeiht

gyg

ㅤㅤㅤㅤ

:。

功能描述电子秤重量回调函数绑定

参数描述:

:,。

OnNotifWeiht获取电子秤重量回调函数指针为入口参数

yg

回调函数定义:

(_)(,

tedefvoidstdcall*CallBackWeihtchar*fTare

ypg

)

char*fNetWeiht

g

:。

功能描述当电子秤读取到数量时主动把电子秤重量数据通过此回调函数发送给外部系统

参数描述:

:,,。

fTare字符串返回电子秤皮重值例如"0.20"

:,,。

fNetWeiht字符串返回电子秤净重值例如"6.8"

g

函数返回值:

无返回值。

函数返回值:

无返回值。

例子:

,用:

绑定电子秤重量回调函数那么函数应该按下面形式调

(,

voidCallBackWeihtchar*fTare

g

)

char*fNetWeiht

g

{

//接收到数据处理

}

__();

TCWMSetEventCallBackWeiht

g

3

/—

YCT329.12013

__

5.1.4获取操作错误信息TCWMGetLastError

函数调用:__()

voidTCWMGetLastErrorchar*sLastError

:。

功能描述获取最后一次对电子秤设备操作的错误信息

参数描述:

:,。

sLastError表示操作错误信息为出口参数

函数返回值:

无返回值。

例子:

,:

获取最后一次对电子秤设备操作的错误信息那么函数应该按下面形式调用

[];

charsLastError100

TC__();

WMGetLastErrorsLastError

5.2显示屏接口函数规范

__

5.2.1初始化通讯通道TCLEDConnect

函数调用:__(,

shortTCLEDConnectshortiConnectTe

yp

char*sConnectParam)

:。

功能描述初始化显示屏所连接的主机通讯通道

参数描述:

:,,,,,

整型表示连接类型当值表示串口值表示网口值表示口为入

iConnectTe012USB

yp

ㅤㅤㅤㅤ

口参数。

:,,:

sConnectParam字符串表示设备连接参数为入口参数

,,、

如果iConnectTe值为0则本参数值为显示屏所对应的串口号如COM1对应值为1COM2对

yp

应值为…对应值为;

2COMNN

,,:;

如果值为则本参数值为显示屏所对应的地址和端口例如

iConnectTe1IP192.168.0.15000

yp

,。

如果iConnectTe值为2则本参数值为显示屏所对应的USB唯一识别号

yp

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,,:

显示屏连接主机的地址为端口号为那么函数应该按下面形式调用

IP192.168.0.15000

__(,:);

TCLEDConnect1"192.168.0.15000"

__

5.2.2关闭通讯通道TCLEDDisconnect

函数调用:__()

shortTCLEDDisconnectvoid

:。

功能描述断开对应的显示屏通讯通道

参数描述:

无参数。

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,:

断开对应的显示屏通讯通道那么函数应该按下面形式调用

__();

TCLEDDisconnect

4

/—

YCT329.12013

__

5.2.3获取显示屏屏号列表TCLEDGetLedNumList

函数调用:__()

shortTCLEDGetLedNumListchar*sLedNumList

:。

功能描述获取显示屏屏号列表

参数描述:

:,,,,

sLedNumList字符串表示显示屏屏号列表屏号由正整数表示屏号之间以"||"分隔例如

"1||6||12"。

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,:

获取显示屏屏号列表那么函数应该按下面形式调用

[];

charsLedNumList200

__();

TCLEDGetLedNumListsLedNumList

__

5.2.4发送显示内容TCLEDSendInfo

函数调用:__(,

shortTCLEDSendInfoshortiLedNum

)

char*sDislaStr

py

:。

功能描述向显示屏发送显示内容

参数描述:

:,,,,。

iLedNum整型表示显示屏屏号如果显示屏设备无屏号则值为-1为入口参数

:,,’’,,

sDislaStr字符串表示显示信息信息项与信息项之间以分隔符||分开为入口函数格

py

ㅤㅤㅤㅤ

式定义如下:

信息项信息项信息项信息项信息项信息项

1||2||3||4||5||6

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,,,,

设置屏号为的烟农姓名为张三微机号为烟叶等级为上柠一单价为18.45元

201010001

,,:

重量为10.00千克金额为1845.00元的显示内容那么函数应按下面形式调用

shortiLedNum;

[];

charsDislaStr100

py

iLedNum=2;

张三上柠一;

sDislaStr="||01010001||||18.45||10.00||1845.00"

py

__();

TCLEDSendInfosDislaStr

py

__

5.2.5发送语音报信息TCLEDSendSound

函数调用:__()

shortTCLEDSendSoundchar*sSound

:。

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

参数描述:

:,,。

sSound字符串表示语音内容为入口参数

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

‘’,:

使显示屏报音欢迎光临那么函数应按下面形式调用

5

/—

YCT329.12013

[];

charsSound10

欢迎光临;

sSound=""

__();

TCLEDSendSoundsSound

__

5.2.6获取操作错误信息TCLEDGetLastError

函数调用:__()

voidTCLEDGetLastErrorchar*sLastError

:。

功能描述获取最后一次对显示屏设备操作的错误信息

参数描述:

:,。

sLastError表示操作错误信息为出口参数

函数返回值:

无返回值。

例子:

,:

获取最后一次对显示屏设备操作的错误信息那么函数应按下面形式调用

[];

charsLastError100

__();

TCLEDGetLastErrorsLastError

5.3IC卡读写器接口函数规范

__

5.3.1初始化通讯通道TCICConnect

函数调用:__(,

shortTCICConnectshortiConnectTe

yp

char*sConnectParam)

ㅤㅤㅤㅤ

功能描述:初始化卡读写器所连接的主机通讯通道。

IC

参数描述:

:,,,,,

整型表示连接类型当值表示串口值表示网口值表示口为入

iConnectTe012USB

yp

口参数。

:,,:

sConnectParam字符串表示设备连接参数为入口参数

,,、

如果值为则本参数值为卡读写器所对应的串口号例如对应值为

iConnectTe0ICCOM11COM2

yp

对应值为…对应值为;

2COMNN

,,:;

如果值为则本参数值为卡读写器所对应的地址和端口例如

iConnectTe1ICIP192.168.0.15000

yp

,。

如果值为则本参数值为卡读写器所对应的唯一识别号

iConnectTe2ICUSB

yp

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

例子:

,,:

卡读写器连接主机的地址为端口号为那么函数应该按下面形式调用

ICIP192.168.0.15000

__

TCIC(,:);

Connect1"192.168.0.15000"

__

5.3.2关闭通讯通道TCICDisconnect

函数调用:__()

shortTCICDisconnectvoid

:。

功能描述断开对应的卡读写器通讯通道

IC

参数描述:

无参数。

函数返回值:

,,,。

整型返回值为表示成功非表示失败由设备提供商自定义失败值所表示意义

00

6

/—

YCT329.12013

例子:

,:

断开对应的卡读写器通讯通道那么函数应该按下面形式调用

IC

__();

TCICDisconnect

__

5.3.3获取操作错误信息TCICGetLastError

函数调用:__()

voidTCICGetLastErrorchar*sLastError

:。

功能描述获取最后一次对卡读写器操作的错误信息

IC

参数描述:

:,。

sLastError表示操作错误信息为出口参数

函数返回值:

无返回值。

例子:

,:

获取最后一次对卡读写器操作的错误信息那么函数应该按下面形式调用

IC

[];

charsLastError100