Q/SY
中国石油天然气集团公司企业标准
Q/SY 10009.2—2017
天然气零售系统建设与运维规范第2部分：燃气表IC卡接口
Specifications for gas retail system
implementation,operation & maintenance -
Part 2 : Interface of gas meter IC card
2017-06—28发布
2017－09-15实施
发布
中国石油天然气集团公司 Q/SY 10009.2—2017
目 次
前言范围
1
2 规范性引用文件 3 术语和定义 4
IC卡读写器动态库
5
5.1 名称 5.2 编写语言 5.3 加密 5.4 运行环境 6 接口函数 6.1 基本要求 6.2 读卡函数 6.3 写新卡函数 6.4 写用户卡函数 6.5 清卡函数 6.6 判卡函数测试
7
7.1 测试目的 7.2 测试类型 7.3 测试准备 7.4 测试内容附录A（规范性附录） 参数定义附录B（规范性附录） 函数返回值附录C（资料性附录） 函数功能验证附录D（资料性附录） 系统功能测试
H
L
14 Q/SY10009.2—2017
前言
Q/SY10009《天然气零售系统建设与运维规范》分为六个部分：
第1部分：运维管理：一第2部分：燃气表IC卡接口：一第3部分：银行代收系统接口：第4部分：远传表数据采集：第5部分：燃气表信息安全：第6部分：燃气自助服务终端。
本部分为Q/SY10009的第2部分。 本部分按照GB/T1.1一2009《标准化工作导则第1部分：标准的结构和编写》给出的规则
起草。
本部分由中国石油天然气集团公司信息管理部和中国石油天然气集团公司天然气与管道分公司提出。
本部分由中国石油天然气集团公司标准化委员会信息技术专业标准化技术委员会归口。 本部分起草单位：中国石油规划总院，昆仑能源有限公司、中国石油天然气与管道分公司。 本部分主要起草人：王爱玲，高峰。刘世章，柴宏恩。骆科东，张志强，金强。铁伟，江鹰。
1I Q/SY 10009.2—2017
天然气零售系统建设与运维规范第2部分：燃气表IC卡接口
1范围
Q/SY10009的本部分规定了中国石油天然气零售系统（以下简称系统）燃气表IC卡接口读卡器、动态库，给出了用户卡的读卡、写新卡、写用户卡、清卡、判卡等功能函数的定义，并且规定了函数返回值和测试要求
本部分适用于接人系统的各燃气表厂商（以下简称厂商）的以气量计量的燃气表IC卡接口的设计、开发、测试及应用。
规范性引用文件
2
下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。
Q/SY1355.2计算机软件测试规范第2部分：集成测试 Q/SY1355.3计算机软件测试规范第3部分：系统测试
3术语和定义
下列术语和定义适用于本文件。
3.1
新卡 initialized card 初始化后的卡，系统可以识别此状态的卡。
3.2
开户卡openaccountcard 通过系统将卡信息与客户信息进行关联后的卡。
3.3
用户卡 user card 开户卡与燃气表进行一卡一表绑定后的卡。
4IC卡读写器
系统使用IC卡读写器应符合以下技术标准： a）应支持通过RS232口或USB口与计算机连接 b）应支持ISO7816接触式CPU卡，SLE4442，SLE4428，AT88SC102，AT88SC153，AT88SC1604
AT88SC1608以及AT24C系列卡。 ）应提供电源状态，卡到位状态指示灯。
1 Q/SY 10009.2—2017
d）应支持Windows7及以上版本操作系统。
5动态库 5.1名称
应以“CNPC_*加“燃气表类型编号_"加“厂商名称汉语拼音首字母四位大写”对动态库命名。
示例杭州先锋电子技术股份有限公司民用IC卡燃气表动态库名称为：CNPC_01_HZXF
5.2编写语言
应采用C6.0及以上版本编写。 5.3加密
应采用软件加密算法保证动态库读写IC卡数据安全，不应采用硬件或软件加密方式限制动态库的安装使用。 5.4运行环境
应支持在Windows7及以上版本操作系统运行。
6接口函数
6.1基本要求
接口函数应符合以下要求： a）应包含燃气表IC卡接口所有函数的输人参数，输出参数的变量名，参数名，参数类型，取值
范围和描述，详细描述见附录A。 b）应包含函数调用成功与失败的返回值和含义，详细描述见附录B。 c）对于各厂商当前卡类型不支持的其他输出参数，如果参数类型为字符则返回空字符串，如果
参数类型为整数则返回负1。 d）使用串口通信，各函数中应包含串口的打开和关闭功能。各函数在串口打开之前，必须先执
行一次串口关闭。
6.2读卡函数
6.2.1功能描述
读出卡内数据，包括用户卡号，用户号，气量，购气次数等。
6.2.2 函数原型
读卡函数原型如下： int_stdcall ReadGasCard (_int16 com,_int32 baud, unsigned char *kmm,int16 *klx._int16
*kzt, unsigned char *kh, unsigned char *dqdm, unsigned char *yhh, unsigned char *tm. int32 *qlint16*csint32*ljgqlint16*bkcsint32*ljyql.int32*syqlint32*bjql-int32 2 Q/SY 10009.2—2017
*czsx,_int32*tzed)。 6.2.3输入参数
输人参数包括：com，baud，kmm。 6.2.4 输出参数
输出参数包括：klx，kzt，khdqdmyhhtm，ql，cs，ligql，bkcs，ljyql，syql.bjql，czsxtzed。 6.2.5 5返回值
应按设计要求返回值： a）操作成功应返回0。 b）操作失败，应返回其他值，详细描述见附录B。
6.3写新卡函数 6.3.1功能描述
将开户卡或用户卡数据写人已格式化的新卡中。 根据卡类型和卡状态确定写数据的格式。 用户卡号、用户号。气量。购气次数是应使用的参数。
6.3.2函数原型
写新卡函数原型如下： intstdcall WriteNewCard (_int16 com._int32 baud, unsigned char *kmm,int16 klx,int16
kzt, unsigned char *kh, unsigned char *dqdm, unsigned char *yhh, unsigned char *tm,_int32 ql,_int16 cs,_int32 ligql,_int16 bkcs,_int32 liyql,_int32 bjql,_int32 czsx,_int32 tzed)。 6.3.3输入参数
输人参数包括：com,baud.kmm.klx.kzt,kh.dqdm.yhh.tm.ql.cs.ligql.bkcs,ljyql. bjql, czsx. tzed. 6.3.4返回值
应按设计要求返回值： a）操作成功应返回0。 b）操作失败，应返回其他值，详细描述见附录B。
6.4 写用户卡函数 6.4.1功能描述
写用户卡函数功能描述如下： a）用于用户卡购气、冲正，气量大于0代表购气，气量等于0代表冲正。 b）应验证卡内的用户卡号和地区代码是否与传人的参数值（kh，dqdm）相符合，不符合不能进
行写人操作，如果卡内没有地区代码，则只需要验证用户卡号相符合。
3 Q/SY 10009.2—2017
℃）用户卡号，用户号、气量，购气次数是应使用的参数。 6.4.2 函数原型
写用户卡函数原型如下： int_stdcall WriteGasCard (int16 com._int32 baud,unsigned char*kmm,int16 klx,unsigned
char*kh,unsigned char *dqdm,unsigned char *yhh,_int32ql,_int16 cs,_int32 ljgql,_int32 bjql,_int32 czsx,_int32 tzed)。 6.4.3输入参数
输入参数包括：com，baud,kmm，klx，kh，dqdm，yhh，ql，cs,ljgql,bjql，czsx，tzed。 6.4.4返回值
应按设计要求返回值： a）操作成功应返回0。 b）操作失败，应返回其他值，详细描述见附录B。
6.5清卡函数 6.5.1功能描述
清卡函数功能描述如下： a）将开户卡或用户卡格式化成新卡。 b）应验证卡内的用户卡号和地区代码是否与传人的参数值（kh，dqdm）相符合，不符合不能进
行格式化操作，如果卡内没有地区代码，则只需要验证用户卡号相符合。
6.5.2 函数原型
清卡函数原型如下： int_stdcall FormatGasCard (int16 com -int32 baud, unsigned char *kmm,int16 klx , unsigned
char *kh, unsigned char *dqdm). 6.5.3 输入参数
输人参数包括：com，baud，kmm，klx，kh，dqdm。 6.5.4返回值
应按设计要求返回值： a）操作成功应返回0。 b）操作失败，应返回其他值，详细描述见附录B。
6.6判卡函数 6.6.1 功能描述
判卡函数功能描述如下： a）根据卡片中的特征信息，应识别插人的卡片是否为各厂商驱动支持的开户卡或用户卡。
4