DB11 T 1164.5-2015 轨道交通联网收费系统技术要求 第5部分 车票处理单元.pdf

1、ICS 35.240.60 L 67 备案号 :45097-2015 DB11 北京市地方标准 DB11/T 1164.5 2015 轨道交通联网收费系统技术要求 第 5部分：车票处理单元 Network toll system of rail transit technical requirements Part V:Ticket processing unit 2015 - 01 - 28发布 2015 - 05 - 01实施 北京市质量技术监督局 发布DB11/T 1164.52015 I 目 次 前言 III 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定义 . 2 4 车

2、票处理单元种类 . 2 5 基本要求 . 2 5.1 外观结构 . 2 5.2 嵌入式主机要求 . 5 5.3 电源适应性 . 6 5.4 电磁兼容性 . 7 5.5 机械环境适应性 . 8 5.6 温湿环境适应性 . 9 5.7 可靠性性 . 9 6 性能要求 . 9 7 其他要求 10 7.1 车票处理单元票卡识别要求 10 7.2 防冲突要求 10 7.3 掉电保护要求 10 7.4 票卡处理完整性要求 10 7.5 安全模块接口要求 10 7.6 应用功能要求 10 7.7 应用接口要求 11 7.8 与终端设备的工作界面要求 11 8 应用编程接口 13 8.1 蜂鸣器 API 13

3、 8.2 LED灯 API . 14 8.3 以太网 API 14 8.4 串口 API 16 8.5 射频驱动程序 API 18 8.6 SIM卡驱动程序 API . 23 8.7 时钟/ 铁电 存储 器/E2PROM 存储器驱动程序 API 25 9 试验方法 26 9.1 试验环境 条件 26 9.2 外观和结构 检查 27 DB11/T 1164.52015 II 9.3 电源适应性 试验 27 9.4 电磁兼容性 试验 27 9.5 机械环境适应性 试验 27 9.6 温湿环境适应性 试验 27 9.7 可靠性 试验 27 9.8 非接触 式 IC读写操 作测试 . 27 9.9 通

4、信接口 试验 28 9.10 应用功能 试验 28 10 检验 规则 . 28 10.1 出厂检验 28 10.2 型式检验 28 参考文 献 . 30 DB11/T 1164.52015 III 前 言 本部分依据 GB/T1.1-2009给出的规 则起草。 DB11/T 1164 轨道交通联 网收费系统技 术要求 分为 6个部分： 第 1部分：系统 结构 及功能 第 2部分： 接口 数据格 式 第 3部分：数据传输 第 4部分：操 作界面 第 5部分： 车票处理单元 第 6部分： 票卡 本部分为 DB11/T 1164的 第 5部分。 本 部分由北京市交通委员会提出并归 口。 本部分由北京

5、市交通委员会负责组织实施。 本 部分 的起草 单位：北京市轨道交通指挥中心、北京航空航天大学。 本 部分主要起草人：战明辉、孙方、冯昕晖、王金利、童梅、潘晓军 、 张莉、梁材、孙越、王 照 华 、 尹秋霞 、 刘嘉军 、 黄悦 、 陈卫平 、 戴国强 、冯利 昌 、王 海英 、 杨萍 、 陈颖 、 刘敬光 、 宋伟 、 李寒松 、 边毅 、 于涛、王 桂英 、 翟熙 、 帅国莹、 张坤、 隋丽莉 、 靖立涛、孙 琦 、韩鹏、 黄斐、 刘稳、 詹淮、 尹宁 、 熊桂喜 、欧阳 元新 、张茂林 、 冷彪 、张姞 。 DB11/T 1164.52015 1 轨道交通联网收费系统技术要求 第 5部分：

6、车票处理单元 1 范围 本部分 规定 了非 接触 式集成 电 路（ IC） 卡车票处理单元的定义 、分 类 、接口、 要求、试验方法、检 验 规 则、 标志 、包装 及存储。 本部分 适用 于轨道交通联 网收费系统 的设 计 、 建 设 、验收 和运营管 理， 以及非 接 触式 IC卡车票处理 单元的设 计、 制造 及应用 。 2 规范性引用文件 下列文件 对于 本文件的应用 是必不 可少 的。 凡是注日 期 的引用文件 ， 仅所 注日 期 的版 本适用 于本文 件 。 凡是不注日 期的引用文件， 其最 新版 本（包 括所有的 修改 单） 适用 于本文件。 GB191 包装 储运 图示 标志

7、GB/T 11463-1989 电子 测量仪 器可靠性 试验 GB/T 15454 工业循 环冷却水中 钠、 铵、 钾、 镁和 钙离子 的测 定 离子色谱 法 GB/T 17618 信息 技术设备 抗扰度限值 和测 量方法 GB/T 17626.2 1998 电磁兼容 试验 和测 量技 术 静 电 放电 抗扰度 试验 GB/T 17626.4 1998 电磁兼容 试验 和测 量技 术 电 快速瞬变脉 冲群抗扰度 试验 GB/T 17626.8 1998 电磁兼容 试验 和测 量技 术 工频磁 场抗扰度 试验 GB/T 176261998 电磁兼容 试验 和测 量技 术 GB 6587.2 电

8、子测 量仪 器 温 度试验 GB 6587.3 电 子测 量仪 器 湿 度试验 GB 6587.4 电 子测 量仪 器 振 动试验 GB 6587.5 电 子测 量仪 器 冲 击试验 GB 6587.6 电 子测 量仪 器 运 输试验 GB 9254 信息 技术设备的 无线 电骚扰限值 和测 量方法 GB/T 2423.1-2001 电工电 子产品 环境 试验 GB/T 2423.3-1993 电工电 子产品 环境 试验 GB/T 2423.10-1995 电工电 子产品 环境 试验 GB/T 2423.5-1995 电工电 子产品 环境 试验 GB/T 2423.8-1995 电工电 子产品

9、 环境 试验 DB11/T 159.1-2002 北京市 政 交通 一卡 通技 术标 准第 一部分： 卡片 ISO/IEC 7816-3 识别卡. 集成 电路 卡.第 3部分 :触点 卡 .电 子接口和 传输 协议 ISO/IEC 7810 识别卡. 物理特 性 DB11/T 1164.52015 2 ISO/IEC 14443A/B 识别卡 .非接 触集成 电路 卡.邻近 卡 ISO/IEC 10373 识别卡 .测试方法 ETSI ETS 300 977(GSM11.11) 数字 蜂窝 通信系统 ；用户 识别模块 -移 动装 置 接口的规范 3 术语和定义 3.1 非接触式集成电路卡 co

10、ntactless integrated circuit card ID-1卡类 型 （ ISO/IEC 7810中 规定 ） 的卡 内嵌 装集成 电路， 以非 接触操 作方 式与外部 集成 电路 进行 耦合操 作的卡 。 3.2 防冲突 anti-collision 在有多 张卡 同时 处于 车票处理单元的 操作 区域内 时， 车票处理单元应可 有效 识别并 拒绝 处理 。 3.3 非接触式集成电路卡读写器 contactless integrated circuit card reader-writer 非 接 触 式 IC卡 读写 器 是指轨道交通联 网 收费系统中含有IC 卡读写器 硬

11、件及 相 应应用逻辑 处理的单 元 ， 也称 为车票处理单元 （简称 TPU或读写 器 ） 。 3.4 一卡通卡 Multi-application card 由市政府授权 、在 国家 IC卡注册 中心 注册 的发 卡机构 统 一发行 ，并 符合 DB11/T159.1-2002的 IC卡。 3.5 一票通车票 all in one ticket “一票 通” 车票 是由轨道交通自 动售 检票 系统 清算 中心发行在 轨道交通 网络 内使用的车票 ， 可 实现 路 网 内换乘 的乘 车凭证 。 4 车票处理单元种类 车票处理单元 分为 一体 式车票处理单元和 分体 式车票处理单元 两种 。 其

12、 中， 一 体式车票处理单元应 将控制 板及天 线集成 在 封闭 外 壳内 ， 通常 用于 BOM桌 面；分 体式车票处理单元应 包 括控 制 板及天 线两部 分，通 过馈 线连 接。 5 基本要求 5.1 外观结构 DB11/T 1164.52015 3 5.1.1 外观 车票处理单元 表面应 色泽均匀， 无明 显缺陷 ， 面 板与 壳体封 装严密 。金 属 部分 应 无锈蚀 和损伤 ， 表 面文字 、图 标、 标志 应清晰 、 牢固 、完整 。 5.1.2 外形尺寸 5.1.2.1 一体式车票处理单元外形尺寸 一 体 式车票处理单元外 形尺寸不能大于 长175mm 宽 110mm高 35m

13、m，具体尺寸按 照 图 1的要求 执 行 。； 图 1 一体式车票处理单元外形物理尺寸 5.1.2.2 分体式车票处理单元外形尺寸 分体式车票处理单元外 形物 理 尺寸 要求 按照 表 1的要求执 行。 表 1 分体式车票处理单元外形物理尺寸 名 称 尺寸（单位：mm） 长 宽 高 孔径尺寸 外壳尺寸 200 125 30 - 安 装 孔尺寸 160 108 - 5 普 通天线尺寸 120 120 20 - 普 通天线安装尺寸 100 100 - 3 小 天 线 尺寸 75 45 20 - DB11/T 1164.52015 4 表 1 分体式车票处理单元外形物理尺寸 （续 ） 名 称 尺寸（

14、单位：mm） 长 宽 高 孔径尺寸 小天线安装尺寸 68 38 - 3 外 壳 的 布局 和尺寸 要求 按照 图 2的要求 执行 ， 普 通天 线 的安 装尺寸按 照图 3的要求 执行 ， 小 天线 的 安装尺寸按 照图 4的要求 执行。 图 2 车票处理单元外壳的布局和尺寸 DB11/T 1164.52015 5 图 3 普通天线的尺寸 图 4 小天线的尺寸 5.1.3 结构连 接件 DB11/T 1164.52015 6 车票处理单元结构应 牢固 ，有关 联接导 线、 接插件 及SAM卡 插座 应完好 无损 ， 天线接口 采 用带屏蔽 的 同 轴电 缆。 5.1.4 配置要求 车票处理单元

15、应 由天 线、 控制板 、 SAM卡、 控制 软件组 成 。 控 制板 应包 括微 程序 控 制器 、 射频电 路、 接口单元 、存储 器和电源模块。 5.2 嵌入式 主机 要求 车票和处理单元嵌入式主机要求 ： a) 采 用 32位嵌入式 微处理器， 工作频 率不 低于 180MHz； b) 数据总 线至 少支持 16位、32 位 ； c) 外 部 地址总 线不少于 16位 ； d) 具 有 复 位 和电源 监控 电路， 具 备看门狗 功能 ； e) 提 供 DB9（ Female）形 式的 3线 RS232或 4线 RS422数据通信 接口 ， 通信 速率 不低于 115200 b/s。

16、其 中 D-Sub 9针插头 与终端设备 连接 ，线 长 1000mm端为机器外 部连 线， 200mm端 为机器 内部 连线， 具体 要求 按照 图 5 的要求 执行； f) 提 供 USB2.0及以 上接口 ， 接口通信 速率 不低于 10M b/s， USB线长 1000mm。 其 中， 线长 1000mm 端为机器外 部连 线， 200mm端 为机器 内部 连线 ，具体 要求 按照 图 6 的要求 执 行； g) 预留 10M/100M自适应 RJ45网 络接口 ； h) 支持通 过 USB接口 连接 移动式存储 器； i) 具 备 实时时钟 ，支持 实时时钟的电 池寿命 应大 于 5

17、年； j) 支持在线 编程 ，包 括在 系统 编程 （ISP ）和 在应用编程 （ IAP） 。 图 5 RS232和 RS422接 口线缆 的长度 要求 图 6 USB接 口 线 缆 的 长度 要求 5.3 电源适应 性 DB11/T 1164.52015 7 5.3.1 一体式车票处理单元电 源要求 应提供 AC-DC电源适 配器 ， 适配器 输入规 格应 为AC220V 10%， 输出 规格 应为DC12V/1.5A 。 电源适 配 器的AC220V 接口 为三爪 插头 。 5.3.2 分体式车票处理单元电 源要求 分体式车票处理单元电源要求如 下： a) 采 用 直流 电源 供电 ，应

18、能 在 12V 0.5V条件 下正 常工作 ； b) 应 采 用 3芯 航空 插头 （公 口）形 式的电源接口与终端设备 相连 接， 按照 图 7 的要求 执行 。 图 7 电源接口示意 图 电源接口 线的 连接 关系 说明 按 照表 的要求 执行 。 表 2 电源接口 线的 连接 说明 连 接 关 系 引 脚说明 3芯航空插头的 1脚 VCC(DC-12V) 3芯 航空插头的 2脚 外壳地 3芯航空插头的 3脚 GND 电源接口线可根据外接设备提供的 12V电源供电接口定制。 5.4 电磁兼容 性 5.4.1 无线电 干扰极限值 DB11/T 1164.52015 8 车票处理单元的 无线

19、电干 扰极限值 应符合 GB 9254规范规定的 A级干 扰极 限值 要求 。 5.4.2 电磁敏感度 车票处理单元电磁 敏感 度要求如 下： a) 电磁敏感 度应 符合 GB/T 17618规定的 试验 要求 。 b) 静 电 放 电 敏感 度应 符合 GB/T 17626.21998 规定的试验要求 。 c) 辐 射 敏感 度应 符合 GB/T 17626.41998 规定的 试验要求。 d) 辐 射 干 扰 应 符合 GB/T 17626.4 1998规定的 试验 要求 。 e) 工作状态 磁场 干扰 应符合 GB/T 17626.8 1998规定的 试验 要求 。 f) 静 电 放 电

20、 抗扰度 应符合 GB/T17626.2-1998规定的 试验 要求 。 5.5 机械环境适应 性 5.5.1 振动 车票处理单元应能承受 GB 6587.4第 组要求的 振 动试验， 试验后 性能特 性应 符合本 部分6.1 6.8 的规定 。振 动适应性要求 按照表 的要求 执行 。 表 3 振动适应 性 初始和最后振动响应检查 频率范围 Hz 10-55 扫描速度 OCT/min 1 驱动振幅 0.15mm 定频耐久试验 驱动振幅 0.75mm(10-25Hz) 0.15mm(25-55Hz) 持续时间 min 30 1 扫 频 耐久实验 频率范围 Hz 10-55-10 扫描速度 OC

21、T/min 1 驱动振幅 0.15mm 循 环 次 数 5 注 ： 表 中 驱动振幅为峰值 5.5.2 冲击 车票处理单元应能承受 GB 6587.4第 组要求的冲击 试验， 试验后 性能特 性应 符合本 部分6.1 6.8 的规定 。冲 击适应性 按照 表 4的要求 执行 。 表 4 冲击适应 性 峰值加速度(m/s) 脉 冲 持续时间(ms) 冲 击 波 形 300 11 半正弦波形或后峰锯、齿波或梯形波 注：产品规范中规定具体的冲击波形 5.5.3 运输 车票处理单元 运输实验 应符合GB6587.6 流 通条 件为 2级 的要求 ， 试验 后 性能 特性应符合 6.16.8 的 规定。

22、 DB11/T 1164.52015 9 运 输 包装 件跌落 适应性 按照 表 的要求 执行 。 表 5 运输包装 件跌落适应性 包装件质量 kg 跌落高度 mm 15 1000 15- 30 800 30- 40 600 40- 45 500 45- 50 400 50 300 碰撞适应性 按照 表 的要求执 行 。 表 6 碰撞适应 性 峰值加速度(m/s) 脉 冲 持续时间(ms) 碰撞次数 300 11 1000 5.6 温湿环境适应 性 温湿度 环境环境适应性 按照 表 的要求 执行 。 表 7 温湿度环境适应 性 温 度 工作环境温度 050 存储温度 20 60 相对湿度 工作

23、环境相对湿度 2090 （非凝露） 存储相对湿度 1090 （非凝露） 5.7 可靠性性 采 用 平均 无故障 工作 时间 （MTBF ） 衡 量产品 的可靠性 水 平。 车票处理单元的 m1值 应 （ MTBF的不 可接 近值）不 得低 于10000h， 且读写 寿命 应满足 3年 100万次； 6 性能要求 车票处理单元性能要求 按照 表 的要求 执行 。 表 8 车票处理单元性 能要求 性能名称 性能要求 车票处理单元与天线的距离 应支持最长 2000mm 车票处理单元 IC卡 读写距离 （ 卡片至天线的距离） 60-100mm 大天线的 有效读写 范围（ 以天 线中心点 为原点， 车票

24、平面与天线平面之间的角度不大于 45 ） X： 100mm Y： 60mm Z: 0 100mm 小 天 线 的 读写范围（车票平面与天线平面平行） 40 60mm DB11/T 1164.52015 10 表 8 车票处理单元性 能要求 （ 续） 性能名称 性能要求 车票处理单元的大、小天线最小距离 50mm， 且 不 产 生 相 互干扰和影响 存储指标 非易失性存储器空间不小于 256MB； 易失性存储器空间不小于 64MB； 访问程序运行存储器的时间周期不大于 7ns； 访问程序存储器的最大时间周期不大于 90ns。 设备的峰值功率 2W 车票处理单元读写时间 介质为 UltraLigh

25、t的 一 票 通 车票的进出站处理时间：200ms ； 介质为 Mifare On的 一 票 通 车票的进出站处理时间：300ms ； 一 卡 通 卡的进出站处理时间：300ms。 在有效的感应距离内，天线表面磁场强最大值 7.5A/m 5cm处电磁场强度最小值 1.5A/m 工作频率 13.56MHz 7kHz 车票处理单元与票卡之间的通信速率 106k b/s。 7 其他要求 7.1 车票处理单元票卡 识别 要求 应可识别 符合 ISO/IEC 14443A/B、 DB11/T 159.1-2002规范规定的非 接触式 IC卡 ， 以 及 本 标 准 第 6 部分要求的 IC卡 。 7.2

26、 防冲突要求 在多张 IC卡 同时 处于 车票处理单元的 操作 区域内 时， 车票处理单元应 不进行 读写。 7.3 掉电保护 要求 外 部 电源掉电 时，不 应 破坏 或改变 车票处理单元的 内存数据。 电源 恢复 时， 应可恢 复到 掉电前的 内 存数据。 7.4 票卡处理 完整 性要求 票卡在读写 过 程离 开 读写范围且再次 进 入时 ， 车票处理单元应可继 续处理 并 保证写入 信息的完整 性 。 7.5 安全模块 接口 要求 安全模块接口要求 如下 ： a) 车票处理单元应 具有 与安全模块 连接的 硬件接口 ； b) 车票处理单元 至少 提供 4个 标 准的 SAM插 槽 ， 操

27、 作 符合 ETSI ETS 300 977(GSM11.11) ,3-5V 的 票卡。 车票处理单元 通过 2个专 门的 控制 器来 实现 对卡片 的访问 ， 系统 软件 API库 支持 对这些 卡 片 的访问 （T=0/1 通信 协议， ISO/IEC 7816-3标 准）。 c) 车票处理单元可 同时 独立 访问装 载 的 SAM卡， 并在 不同的工作频 率下 同时 独立 工作 ； DB11/T 1164.52015 11 d) 安全模块应 具有 加密 和反破 译 功能 ，且 物理 上相 对独 立 的硬 件加 密模块 ； e) 安全模块 SAM插槽 的物 理 特性、 逻辑 接口和 通信

28、协议 应 符合 ETSI ETS 300 977（GSM11.11） 规范的要求 ； f) 满足北京市轨道交通 一票 通车票的安全处理要求 ； g) 满足北京市 政交通 一卡 通公 司 一卡 通卡的安全处理要求； h) 与安全模块 SAM卡的 通信 支持独 立 的 PPS设置 ，和 高速通信 （不 低于 312K b/s）。 7.6 应用功能 要求 车票处理单元应用功能要求 ： a) 满足北京市政 交通一 卡通 公司提出 的安全保密 处理要求及 IC 卡处理流 程要求 ,具 备支持符合 DB11/T 159.1-2002规范卡 片 的能 力； b) 满足轨道交通 ACC提出 的一 票 通安全保

29、 密处理要求 及规范 IC卡处理 流程要求； c) 内 部 集成 业 务处理，包 括票卡读写 处理 、安全保 密认 证 、 IC 卡 业务 处理 （包 括进站 、出站 、 售卡、 充值 等业 务处理 ）、参数 处理 (包 括 ACC和 BMACS下 发的 参数数据、 黑名 单 检查、 各 种 降级运 行设置 、获取 同步 系统时 间、能 够根据 车票 状态自 动切换 车票的 不同 钱包)、交 易 数据 生 成 、设备 运行 等功能 ； d) 具 备 高 级 应用程序接口 （API）。 7.7 应用接 口要求 内 部 软 件应 包 括内 核 软件及 应用程序 两 部分 ， 二者均 保 存 在车票

30、处理单元 控 制板上的 非易失 闪存 中 ， 应用程序 对外 提供 应用程序编程接口 （API ） 。 内 核 软件应 提供 任务 运行 服务、 内存 管理以 及定 时事 件 管理 等功能 ， 提 供给 应用程序的功能 函数 将 编译成 为系统 应用程序编程接口 （API ） 库， 应用 开发 人员 使用 该API 进行 应用程序开 发。 当车票处理单 元在线 连接 时， 内核 软件应 支持 通过 串行 口进行 远程 固 件下 载。 应 提 供API 接口 函数 来支持外 部 应用的编程 ， 这些 API接口函 数将 为低 层硬 件接口 提 供一 种方 便而 清 晰 的接口 ， 外 部应用 通

31、过 这些接口 函数 应能 访问 车票处理单元 内的 各种 部件 。 应通 过硬 件和 软件保护相 结 合 的方 式， 确保车票处理单元 内的 各种 部件 硬件 不被外 部应用程序 直接 访问 ， 外部 应用程序 只有通过 API接口 函数 才能 访问这些硬 件 资源 。车票处理单元应 提 供描 述清晰 且符合 本标 准 的API 接口 函数 文档， 以便外 部应用编程 人员通 过此API 接口 函数 文档 进行程序开 发。 7.8 与终端设 备的 工作界面 要求 7.8.1 与闸机（ AG）接 口界面 与 AG间 的接口界面要求 如下 ： a) USB驱动程序 及预留 RJ45或 RS232/

32、RS422接口 ：车票处理单元 需提 供不 同运 行环境 （操 作系 统）平 台 下 的 USB及 RJ45或 RS232/RS422驱动程序 ， 车票处理单元 USB、 RJ45或 RS232/RS422 接口的驱动程序安 装于 AG主机； b) 程序配 置参数 接口 ：闸 机主程序 根据 有关 规范 向车票处理单元 提供配 置参数。 配 置参数 包 括 ： 票价表 、运 行模式 、运 行时 间 、黑 名单 、产品 参数 等； c) 通信控 制命 令接口： 闸机主程序通 过发 送串 行通信 控制 命 令数据 包的 方式 控制 车票处理单元的 运 作 、车票处理单元 软件 更新、 获取 交易

33、数据 UD、 获取车票处理单元的 运行 情况。 DB11/T 1164.52015 12 与 AG间 的接口界面 按照 图 8 的要求 执行 。 AG 读写 器 接口界面 TICKET 电源 线 信号 线 图 8 车票处理单元 与 AG接 口界面示意 图 7.8.2 与自动售 票机（ TVM）接 口界面 与TVM 接口界面要求 如下 ： a) USB驱动程序 及预留 RJ45或 RS232/RS422接口 ：车票处理单元 需提 供不 同运 行环境 （操 作系 统）平 台 下 的 USB及 RJ45或 RS232/RS422驱动程序 ， 车票处理单元 USB、 RJ45或 RS232/RS422

34、 接口的驱动程序安 装于 TVM主机 。 b) 程序配 置参数 接口 ：TVM 主程序 根据 有关 规范 向车票处理单元 提供配 置参数。 配 置参数 包 括 ： 票价表 、运 行模式 、运 行时 间 、黑 名单 、产品 参数 等。 c) 通信控 制命 令接口 ： TVM主程序通 过 API函 数调 用的 方式控 制车票处理单元的 运作、 车票处理 单元软 件更 新、 获取 交易 数据 UD与获 得车票处理单元的运 行情况 。 与 TVM接口界面 按照 图 9 的要求执 行。 TVM 车票处理单元 车票处理单元 接口界面 票卡 电源线 信号线 TVM 图 9 车票处理单元 与 TVM接 口界面

35、示意 图 DB11/T 1164.52015 13 7.8.3 车票处理单元 与半自动售 票机（ BOM）接 口界面 与 BOM间的接口界面要求 如 下： a) USB驱动程序 及预留 RJ45或 RS232/RS422接口 ：车票处理单元 需提 供不 同运 行环境 （操 作系 统）平 台 下 的 USB及 RJ45或 RS232/RS422驱动程序 ， 车票处理单元 USB、 RJ45或 RS232/RS422 接口的驱动程序安 装于 BOM主机 ； b) 程序配 置参数 接口 ：BOM 主程序 根据 有关 规范 向车票处理单元 提供配 置参数。 配 置参数 包 括 ： 票价表 、运 行模式

36、 、运 行时 间 、黑 名单 、产品 参数 等； c) 通信控 制命 令接口 ： BOM主程序通 过 API函 数调 用的 方式控 制车票处理单元的 运作、 车票处理 单元软 件更 新、 获取 交易 数据 UD与获 得车票处理单元的运 行情况 。 与 BOM间的接口界面 按照 图 10的要求 执行 。 8 应用编程 接口 8.1 蜂鸣 器 API 8.1.1 Beep Key Open Beep Key Open 包括 ： a) 原 型： S16_t BeepKeyOpen(void)； b) 描 述 ： 打 开 BeepKey（蜂鸣器） 设备 ； c) 参数： 无。 8.1.2 Beep K

37、ey Close Beep Key Close 包括 ： a) 原 型： S16_t BeepKeyClose(void)； b) 描 述 ： 关闭 BeepKey（蜂鸣器） 设备 ； c) 参数： 无。 BOM 车票处理单元 车票处理单元 接口界面 票卡 电源线 信号线 BOM 图 10 车票处理单元 与 BOM接 口界面示意 图 DB11/T 1164.52015 14 8.1.3 Beep Beep 包括 ： a) 原 型： S16_t Beep(U32_t BeepLev, U32_t Delay50Ms)； b) 描 述 ： 蜂鸣器 开始 鸣叫 ； c) 参数： 1) U32_t B

38、eepLev： Beep音调 （0 - 6 ） 其 中 6声音 最响 ； 2) U32_tDelay50Ms： 响的 声音 长 度。 8.1.4 函数返回值 无特殊 说明时 ，函 数返回 0为成功 ，其他 为失 败。 8.2 LED灯 API LedLight 包括 ： a) 原 型： S16_t LedLight(U32_t index, U32_t mode)； b) 描 述 ： 控 制 LED灯； c) 参数： 1) U32_t Index： LED灯的 索 引位置 ， 从 1开始 ； 2) U32_t mode： 灯状态 0表示 熄灭 ，1 表示 亮 。 8.3 以太 网 API 8.

39、3.1 TCPIP_CommOpen TCPIP CommOpen 包括 ： a) 原 型：S32_t TCPIP_CommOpen( U8_t * pPortDescriptor, U8_t *pOpenParams, S32_t dwPortAttr, S32_t nTimeout, S32_t *pErrCode )； b) 描 述 ： 建立 TCP连接 ； c) 参数： 1) U8_t *pPortDescriptor： Linux网络 设备 描述 符字符 串 （ “/dev/eth0“, “/dev/eth1“） ； 2) U8_t *pOpenParams： IP地址 和端口 号字

40、符 串具体 格式 IP： PORT 比如“192.167.1.22:2000“ 如 果 作为 服务 器， IP地址可以忽略 ； 3) S32_t dwPortAttr： 工作模式 ： 0表 示本 地服务 器端口 ； 1表 示连 接远 程服务 器的 客户机 ； 2表示 连接本 地服务 器的 客户机 ； 4) S32_t nTimeout： 连接 超 时时间 澹( 单位 毫秒) ； 5) S32_t *pErrCode：出 错返回码， 参考 本标 准部分 的“ 函 数返回码 ”。 d) 返回值 ：网 络句柄 网 络 句柄 包括 ： 1) =0出 错句柄 无效； 2) 0正 确句柄 有效 。 8.3

41、.2 TCPIP_CommAccept DB11/T 1164.52015 15 TCPIP_CommAccept 包括 ： a) 原 型： S32_t TCPIP_CommAccept(S32_t hPort )； b) 描 述 ： 服务 器监控 TCP/IP端口的 TCP/IP连接 ； c) 参数： S32_t hPort： 服务器端口 号； d) 返回值 ： 网络句柄 ： 0表 示出 错句柄 无效； 大于 0表示 正确句柄 有效。 8.3.3 TCPIP_CommRead TCPIP_CommRead 包括 ： a) 原 型： S32_t TCPIP_CommRead( S32_t hP

42、ort,U8_t *pBuffer,S32_t nBytesToRead)； b) 描 述 ： 向已打开 TCP/IP端口 读数据 ； c) 参数： 1) S32_t hPort： 端口 句柄 ； 2) U8_t *pBuffer： 接 收数据 所放 数据指 针； 3) S32_t nBytesToRead： 希望接 收的 数据个数 ； d) 返回值 ：实 际从 PORT端口读 的 数据个数。 8.3.4 TCPIP_CommWrite TCPIP_CommWrite 包 括： a) 原 型： Int TCPIP_CommWrite( S32_t hPort,U8_t *pBuffer, S3

43、2_t nBytesToWrite)； b) 描 述 ： 向已打开 TCP/IP端口 写 入数据 ； c) 参数： 1) S32_thPort： 端口 句柄 ； 2) U8_t *pBuffer： 发 送数据 所放 数据指 针； 3) S32_t nBytesToWrite： 希望 发送 的数据个数 ； d) 返回值 ：实 际向 PORT端口发 送 的数据个数。 8.3.5 TCPIP_CommControl TCPIP_CommControl 包括 ： a) 原 型：S32_t TCPIP_CommControl( S32_t hPort, S32_t nCmd, void *pBuffer

44、, S32_t nDataLength)； b) 描 述 ： 向已打开 TCP/IP端口 通 过命 令发 送控 制信 息； c) 参数： 1) S32_t hPort： 端口句柄 ； 2) S32_t nCmd： 发送命 令字 节具体 规划 如下 ： 1表 示获取 上次 TCP/IP端口 操 作失 败的 错误码 （适 合服务 器和 客户 器） ； 2表示 获取向 端口 发送 的信 息 数据 （适 合服务 器和 客户器 ）； 3表示 设置 通信 超时 间（ 单位 ms）（ 适合 服务 器和客 户 器） ； 4表 示获取 通信 超时 间； DB11/T 1164.52015 16 5表 示 清 除

45、 发 送缓 冲区 数据 ； 6表 示清 除接 收缓 冲区 数据 ； 7表 示设 置最 大可 连接 客户 机的 个数 ； 8表示 获取 最大 可连 接客 户机的 个数 ； 9表示 获取当 前已经 连接的 客 户机的 个数 ； 10表 示获取当 前服务 器所能 连 接客 户机器 最大个数 能力； 其他值 表示 为预留 ； 3) void *pBuffer： 输入数据指 针， S32_t nDataLength： 输 入 数据 长度 ： 当 nCmd =1时候 ，pBuffer： 错误码 ，nDataLength ： 固定 4个字 节； 当 nCmd =2时候 ，pBuffer：输入 信息 指针 ，

46、nDataLength：输 入信 息长 度； 当 nCmd =3、4 时 候，pBuffer：输 入超 时信 息结构 指 针，nDataLength ：输 入超时信息 结 构长度； 当 nCmd =5、6 时候 ，pBuffer：NULL ，nDataLength ：NULL ； 当 nCmd =7、8 、9、 10时 候，pBuffer ：个数 ，nDataLength ：固 定 4个字 节。 8.3.6 TCPIP_CommClose TCPIP_CommClose 包 括： a) 原 型： S32_t TCPIP_CommClose( S32_t hPort )； b) 描 述 ： 关闭

47、 已打 开端口 并释 放 端口 资源 ； c) 参数： S32_t hPort：端口句柄； d) 返回值 ： 1) 0表 示 关闭 成功 ； 2) 小 于 0表 示 关闭 失败 。 8.3.7 函数返回码 无特殊 说明时 ，函 数返回 0为成功 ，其他 为失 败。 8.4 串口 API 8.4.1 Serial_CommOpen Serial_CommOpen 包 括； a) 原 型： S32_t Serial_CommOpen( U8_t *pPortDescriptor, U8_t *pOpenParams, S32_t dwPortAttr, S32_t nTimeout, S32_t

48、*pErrCode)； b) 描 述 ： 打 开 串口 函数 ； c) 参数： 1) U8_t*pPortDescriptor： Linux串口设备 描述 符字符 串 ； 串口 0：“/dev/ttyS0“； 串口 1：“/dev/ttyS1“； 串口 2：“/dev/ttyS2“； 串口 3：“/dev/ttyS3“； 串口 4：“/dev/ttyS4“； 2) U8_t * pOpenParams：串口 参数 字符 串具体 格式 如： “9600， n， 8， 1“； DB11/T 1164.52015 17 3) S32_t dwPortAttr： 工作模式； =0本 地服务 器端口 ；

49、 =1连 接远 程服务 器的 客户机 ； =2连 接本 地服务 器的 客户机 ； 4) S32_t nTimeout： 连接超 时时 间澹 (单 位毫秒) ； 5) S32_t *pErrCode： 出错返回码 ，参考 本标 准部分的 “函 数返回码 ”； d) 返回值 ：网 络句柄 1) =0出 错句柄 无效； 2) 0正 确句柄 有效 。 8.4.2 Serial_CommRead Serial_CommRead 包 括： a) 原 型： S32_t Serial_CommRead( S32_t hPort,U8_t *pBuffer,S32_t nBytesToRead)； b) 描 述 ： 向已打开 TCP/IP端口 读数据 ； c) 参数： 1) S32_thPort ：端口 句柄 ； 2) U8_t *pBuffer：接 收数据所放数据指 针； 3) S32_t nBytes ToRead： 希望接 收的 数据个数 ； d) 返回值 ：实 际从 PORT端口读 的 数据个数。 8.4.3 Serial_CommW