Unitoll用户手册_v30.doc

广东省高速公路联网收费系统 非接触式IC卡读写机具高速公路 收费专用接口用户手册 广东联合电子收费股份有限公司 二零零七年四月 目 录 前言 1 技术服务 1 1 动态库说明 2 2 功能简介及使用流程 2 2.1 功能简介 2 2.2 应用流程 3 3 TOLLDATA数据结构 4 3.1 基础数据结构 5 3.2 设备与卡数据结构 8 3.3 TOLLDATA数据结构 8 4 函数说明 10 4.1 设备初始化(DeviceInit) 10 4.2 设备关闭(DeviceQuit) 11 4.3 打开卡片（OpenCard） 11 4.4 关闭卡片（CloseCard） 12 4.5 粤通卡读文件(ProReadFile) 13 4.6 粤通卡写文件(ProWriteFile) 14 4.7 粤通卡消费(ProConsume) 15 4.8 粤通卡取交易认证码(ProGetTac) 16 4.9 逻辑加密卡读文件(IccReadFile) 17 4.10 逻辑加密卡写文件(IccWriteFile) 18 4.11 SAM卡/粤通卡TimeCos指令 (SamCommand/ProCommand) 18 4.12 二进制数据与字符串互转换(BinToStr/StrToBin) 19 4.13 常规时间与UNIX时间的互换(DatetimeToUnixtime/UnixtimeToDatetime) 21 4.14 取设备方指示信息（GetDeviceMsg） 23 5 函数执行状态代码表 24 附录 FAQ 25 前言 本手册主要说明非接触式读写机具面向广东省高速公路收费应用的专用应用程序接口UniToll V3.0（API），旨在为广东省高速公路收费应用的集成商开发车道收费程序提供指导。 本手册与广东省高速公路收费专用接口基于广东省地方标准《广东省高速公路联网收费系统》（DB44/127-2003）编写和设计，集成商需在该标准的指导下使用本手册。 集成商采用的非接触式卡读写机具的应用程序接口必须符合《广东省高速公路联网收费——非接触式IC卡读写机具通用接口要求》，应用程序接口为UniReader.dll（API）。 广东省高速公路收费专用接口为集成商用户提供关于非接触式IC卡（含逻辑加密卡和粤通卡）操作和读写机具操作的简明接口: 读写机具的初始化与关闭：DeviceInit,DeviceQuit 卡片的打开与关闭：OpenCard, CloseCard 粤通卡文件操作：ProReadFile，ProWriteFile，ProConsume,ProGetTac 逻辑加密卡文件操作：IccReadFile，IccWriteFile SAM卡/CPU卡TimeCos指令接口：SamCommand,ProCommand 操作错误后，获取设备方的指示信息：GetDeviceMsg 数据类型转换函数：BinToStr,StrToBin 时间格式转换：DatetimeToUnixtime，UnixtimeToDatetime 技术服务 广东联合电子收费股份有限公司提供公路收费专用接口方面的技术支持。 公司主页： 联系电话：02084207113 传真号码：020 电子邮件：wanghp@ 1 动态库说明 广东省高速公路收费专用接口以动态库的形式提供，动态库名称为UniToll.dll；适用于WIN98/WIN2000及更高级版本操作系统和该系统下的各种应用程序开发平台如Visual Studio、Delphi和Power Builder等; 数据结构涉及IC卡文件结构部分请参考广东省高速公路收费地方标准DB44《广东省高速公路联网收费系统》; 关于高速公路联网收费应用流程请参考广东省高速公路收费地方标准DB44《广东省高速公路联网收费系统》，本手册不涉及此内容; 本手册采用C/C++语言方式描述。 2 功能简介及使用流程 2.1 功能简介 序号 函 数 名 称 功 能 描 述 备 注 1 DeviceInit 设备初始化 机具用 2 DeviceQuit 设备关闭，退出 3 OpenCard 打开卡片 卡片共用 4 CloseCard 关闭卡片 5 ProReadFile 粤通卡读文件 粤通卡专用 6 ProWriteFile 粤通卡写文件 7 ProConsume 粤通卡消费（限于储值卡） 8 ProGetTac 取交易认证码（限于记帐卡） 9 IccReadFile 逻辑加密卡读文件 逻辑加密卡 专用 10 IccWriteFile 逻辑加密卡写