版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
ICS03.220.20R10
DB63青 海 省 地 方 标 准DB63/T1719—2018高速公路收费车道通用外围设备接口技术要求Techinicalrequirementforuniversalperipheralinterfaceofexpresswaytolllane2018-12-26发布 2019-03-20实施青海省市场监督管理局 发布DB63/T1719DB63/T1719—2018PAGE\*ROMANPAGE\*ROMANII目 次前言 II范围 1规范性引用文件 1术语、定义和缩略语 1基本规定 5物理接口 6通信协议 7软件接口 8附录A(规范性附录)收费专用键盘按键布局和键值 10附录B(规范性附录)路侧单元应用编程接口 12附录C(规范性附录)自动发卡机通讯协议 20附录D(规范性附录)IO控制器API指令函数定义 34附录E(规范性附录)收/发卡机API指令函数定义 39附录F(规范性附录)IC卡读写器API指令函数定义 48附录G(规范性附录)票据打印机API指令函数定义 63附录H(规范性附录)扫码枪API指令函数定义 67附录I(规范性附录)车牌自动识别设备API指令函数定义 72附录J(规范性附录)车道摄像机API指令函数定义 75附录K(规范性附录)计重设备API指令函数定义 77附录L(规范性附录)费额显示器API指令函数定义 81附录M(规范性附录)字符叠加器API指令函数定义 90前 言本标准按照GB/T1.1-2009给出的规则起草。本标准由青海省交通运输标准化专业技术委员会提出并归口。有限公司。孙永德、李建中、吴茂呈、杨义和、崔伟佳、崔龙波。DB63/T1719DB63/T1719—2018PAGEPAGE91高速公路收费车道通用外围设备接口技术要求范围本标准规定了高速公路收费车道通用外围设备的软硬件接口技术要求。本标准适用于高速公路收费车道机电系统新建项目和改扩建项目。规范性引用文件件。凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T18367公路收费方式GB/T20839智能运输系统通用术语GB/T24723公路收费用票据打印机GB/T24724收费专用键盘GB/T24973收费用电动栏杆GB/T27879公路收费用费额显示器GB/T28423电子收费路侧单元与车道控制器接口GB/T28967电子收费车道系统技术要求GB/T31441电子收费集成电路(IC)卡读写器技术要求术语、定义和缩略语术语和定义GB/T18367、GB/T20839、GB/T24723、GB/T24724、GB/T24973、GB/T27879和GB/T28967界定的以及下列术语和定义适用于本文件。为了便于使用,以下重复列出了某些术语和定义。3.1.1IO控制器IOcontroller检测、控制车辆检测器、电动栏杆、雨棚信号灯、车道信号灯等设备数字IO电平信号的车道设备。3.1.2收费专用键盘keyboardforthetoll完成收费功能的专用键盘。[GB/T24724—2009,定义3.1]3.1.3路侧单元roadsideunit(RSU)又称为电子标签读写器、路侧读写天线、ETC天线、路侧设备。安装在收费车道门架上或收费岛立柱上的用于同过往车辆上的车载设备进行通信的天线及相应的控制设备。[GB/T20839—2007,定义9.8]3.1.4发卡机carddistributor设在收费站入口车道处,发放非接触式IC卡,并对卡的周转进行监控和管理的机电装置。3.1.5收卡机cardreceiverIC转、监控和管理。3.1.6IC卡读写器ICcardreaderIC件和接口,例如与主机通讯的接口。3.1.7票据打印机receiptprinter完成发票、车票等票据打印功能的设备。[GB/T24723—2009,定义3.1]3.1.8扫码枪codescanner用于扫描手机二维码实现移动支付的车道设备。3.1.9车牌自动识别设备vehiclelicenseplaterecognitionequipment用于抓拍车辆图片,通过计算机视频图像识别技术识别车辆牌号、颜色等信息的车道设备。3.1.10车道摄像机lanecamer用于实现对车道状况的全天候监视的车道设备。[GB/T28967—2012,定义3.1.7]3.1.11计重设备weighingequipment用于检测通过车辆的轴组数量、类型、载重以实现计重收费的车道设备。3.1.12费额显示器patronexternaldisplay控制装置和电源模块等组成。[GB/T27879—2011,定义3.1]3.1.13字符叠加器onscreendisplay用于向车道摄像机和收费亭摄像机的视频流动态叠加字符的车道设备。3.1.14车辆检测器vehicledetector又称为地感线圈,车辆检测器状态用I/O信号的电平方式输入到车道控制器,用于系统检测车辆的到来和离去。[GB/T28967—2012,定义3.1.6]3.1.15车道信号灯lanelights用于提示驾驶员本次交易状态,如是否能正常通行等的车道设备。[GB/T28967—2012,定义3.1.5]3.1.16雨棚信号灯canopylights用于指示车道当前工作状态的车道设备。[GB/T28967—2012,定义3.1.4]3.1.17报警设备alarmequipment用于提示驾驶员和现场工作人员本次交易失败、车道发生异常等的车道设备。[GB/T28967—2012,定义3.1.2]3.1.18电动栏杆tollelectricbarrier通过控制器控制电动机驱动高出地面的栏杆臂绕特定的轴向旋转起落来阻挡车辆通行和控制车辆进出的机械设备。[GB/T24973—2010,定义3.1]3.1.19非接触式IC卡contactlessICcard(不大于无线通信方式进行信息读写的IC卡,简称IC卡。3.1.20安全访问模块secureaccessmodule(SAM)IC卡读写器中负责安全控制管理的模块。SAM的类型依赖于IC卡读写器的交易类型,如用于支持消费的SAM称为PSAM,用于支持充值交易的SAM称为ISAM。3.1.21收费车道tolllane在收费广场用收费岛或其它设施隔离出来并用于收费目的的车道称为收费车道。[GB/T18367—2001,定义3.13]3.1.22人工收费车道manualtollcollectionlane的收费车道。3.1.23电子收费electronictollcollection(ETC)应用先进的技术手段,自动完成电子收费交易,实现在不停车条件下自动收取道路通行费。[GB/T20839—2007,定义9.1]3.1.24电子收费车道electronictollcollectionlane采用全自动电子收费方式实现对通过车辆的数据采集与收费、车道设备控制等功能的收费车道。缩略语下列缩略语适用于本标准。API:应用程序接口(ApplicationProgrammingInterface)CM:卡机(CardMachine)CPU:中央处理单元(CenteralProcessCRW:卡读写器(CardReader&Writer)ETC:电子收费(ElectronicTollColletion)IC:集成电路(IntegratedCircuit)IO:输入/输出(Input/Output)MAD:Mifare应用目录(MifareApplicationDirectory)MTC:人工半自动收费(ManualTollCollection)OBU:车载单元(OnBoardUnit)PC:计算机(PersonalComputer)PLR:车牌识别(LicensePlateRecognition)PRT:打印机(Printer)PS/2:第二代电脑系统(PersonalSystem2)QR:快速反应(QuickResponse)RSU:路侧单元(RoadsideUnit)SAM:安全访问模块(SecureAccessModule)TFI:费额指示器(TollFareIndicator)VC:视频卡(VideoCard)VDM:字符叠加器(VideoDataMixer)WE:计重设备(WeighingEquipment)IC器、字符叠加器、车辆检测器、车道信号灯、雨棚信号灯、报警设备、电动栏杆。不同类型的收费车道其外围设备组成略有不同,如表1所示。表1各类收费车道通用外围设备组成外围设备MTC入口MTC出口入口自动发卡开放式MTCETCIO控制器√√√√√收费专用键盘√√√√√路侧单元√发卡机(可选)√收卡机(可选)√自动发卡机√IC卡读写器√√√√√票据打印机√√扫码枪(可选)√√车牌自动识别设备√√√√√车道摄像机√√√√√计重设备√√费额显示器√√√√√字符叠加器√√√√√车辆检测器√√√√√车道信号灯√√√√√表1 各类收费车道通用外围设备组成(续)外围设备MTC入口MTC出口入口自动发卡开放式MTCETC雨棚信号灯√√√√√报警设备√√√√√电动栏杆√√√√√连接关系IOIC换设备与车道控制机连接。IOIO具体连接方式见第5章。调用的接口函数的执行返回时间应在毫秒级。GB/T28967物理接口IOIOIOETC,IO168IO8IOIO设备接入。收费专用键盘PS/2A路侧单元路侧单元与车道控制机的连接应符合GB/T28423的要求。ICIC卡读写器应通过用标准串行接口与车道控制机连接。IC卡读写器的非接触式接口和SAM接口应符合GB/T31441的要求。车牌自动识别设备车牌自动识别设备应通过以太网接口与车道控制机连接。车道摄像机车道摄像机应通过以太网口接口与车道控制机连接。IOIOIOIOIOIOIOIO其它外围设备收/发卡机、自动发卡机、票据打印机、扫码枪、计重设备、费额显示器和字符叠加器应通过用标准串行接口与车道控制机连接。通信协议IOIO协议指令可自定义。收费专用键盘收费专用键盘与车道控制机之间应采用标准键盘协议。路侧单元路侧单元与车道控制机之间的通信协议见附录B。自动发卡机自动发卡机与车道控制机之间应采用标准串口通信协议,通讯参数和信息帧格式见附录C。车牌自动识别设备车牌自动识别设备与车道控制机间应采用标准网络协议,协议格式和协议指令可自定义。车道摄像机车道摄像机与车道控制机之间应采用标准网络协议,协议格式和协议指令可自定义。其它采用标准串行接口的外围设备收/发卡机、IC卡读写器、票据打印机、扫码枪、计重设备、费额显示器和字符叠加器与车道控制机之间应采用标准串口通信协议,协议格式和协议指令可自定义。软件接口总体要求采用自定义通信协议的外围设备应封装成软件接口库,软件接口库应以动态库的形式提供,WindowsWindowsAPIstdcall,WindowsC/C++Windows软件接口库在编制过程中应充分利用外围设备硬件资源,减少对车道控制机系统资源的占用,应提交收费系统软件编制单位或第三方机构审查验证,通过相关测试后方可在高速公路收费系统中使用。软件接口库存放路径和文件名可由车道应用程序在配置文件中指定,软件接口库用到的配置文殊说明。IOIOIOIOIOCPU1%50ms,0.1Hz50ms。IO输出控制应等待指令发送完成后返回。IOAPID。收/发卡机收/发卡机软件接口库的名称应以CM开头,收/发卡机软件接口库API指令函数定义见附录E。ICICCRWICICCPUSAMIC300ms。ICAPIF。票据打印机PRT3s。APIG。扫码枪扫码枪软件接口库的名称应以QR开头,扫码枪软件接口库API指令函数定义见附录H。车牌自动识别设备PLR状态变化和车牌识别结果应采用回调函数的方式主动通知调用程序。APII。车道摄像机车道摄像机软件接口库的名称应以VC开头,车道摄像机软件接口库API指令函数定义见附录J。计重设备计重设备软件接口库的名称应以WE开头,计重设备软件接口库API指令函数定义见附录K。费额显示器费额显示器软件接口库的名称应以TFI开头,费额显示器软件接口库API指令函数定义见附录L。字符叠加器字符叠加器软件接口库的名称应以VDM开头,字符叠加器软件接口库API指令函数定义见附录M。附录A(规范性附录)收费专用键盘按键布局和键值按键布局收费专用键盘按键布局见图A.1。图A.1收费专用键盘按键布局示意图按键键值收费专用键盘按键键值见表A.1。表A.1收费专用键盘按键键值对应表按键字符键值按键字符键值按键字符键值取消Esc27车道开/关=187上/下班PgUp33报警/解除PgDn34AA65牵引B66CC67模拟线圈D68语音E69农用F70废票G71补票H72欠费I73改轴J74货5K75强制变档L76入口图片M77车辆引出N78OO79货4P80无卡Q81坏卡R82SS83换卡T84货3U85绿通V86公务车W87紧急车X88货1Y89货2Z90票号Home36功能End35更改Backspace8775588569957表A.1收费专用键盘按键键值对应表(续)按键字符键值按键字符键值按键字符键值4452555366531149225033510048↑↑38•.190←←37↓↓40→→39车队F5116军警车*106客4F4115优惠/111客3F3114银联卡-109客2F2113支付卡+107客1F1112确定/放行Enter13现金Ins45附录B(规范性附录)协议约定通讯协议中除明确指出为低字节在前的字段,所有整型、长整型、短整型字段都为高字节在前。通讯方式RSU与车道控制机之间的通信接口应支持以太网接口和标准串行接口。采用以太网接口时,应采用TCP/IP协议进行连接;“115200,N,8,1特率115200bps,无奇偶校验,8位数据,1个停止位。数据帧的结构和特殊字节转义处理RSU和PC之间通讯的数据帧结构和特殊字节转义处理应符合GB/T28423,发送的数据具体定义见B.4。数据域定义数据域格式RSU和PC之间通讯的数据帧结构中的DATA数据域格式见表B.1。表B.1DATA数据域格式数据项字节数说明Type1数据类型,具体定义见B.4.2ContentN数据内容,具体定义见B.4.3数据类型(Type)的定义PC发往RSU的数据类型PC发往RSU的指令说明见表B.2。表B.2PC发往RSU的指令指令名称代码功能说明初始化指令C0对RSU关键参数如功率、车道模式等进行初始化/设置继续交易指令C1对PC收到RSU发来的信息的应答,表示收到信息并要求继续处理指定OBU停止交易指令C2对PC收到RSU发来的信息的应答,表示收到信息并要求当前不再继续处理指定OBU表B.2PC发往RSU的指令(续)指令名称代码功能说明写站信息指令C3将站信息写入指定的卡片读CPU卡免费区间指令C5获取CPU卡免费区间消费并写站信息指令C6对电子钱包扣费,并向指定的卡片写站信息取TAC码指令C7对CPU卡取TAC的指令开关天线指令4C天线开关,00H表示关天线,01H表示开天线RSU发往PC的数据类型RSU发往PC的信息帧见表B.3。表B.3RSU发往PC的信息帧帧名称代码功能说明RSU设备状态信息帧B0RSU的设备状态信息,含PSAM卡号等OBU系统信息帧B2主要包括OBU系统信息文件内容OBU车辆信息帧B3主要包括车辆信息文件内容IC卡信息帧B4主要包括IC卡关键信息文件内容成功交易结束帧B5RSU与OBU交易完成后的结果信息数据内容(Content)的定义PC指令数据帧结构初始化指令初始化指令(简称C0指令),见表B.4。表B.4初始化指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC024Seconds1970/1/10:0:0距离当前的秒数,高位在前67Datetime当前日期时间,YYYYMMDDHHmmSS,7字节BCD码131LaneMode车道模式,取值分别为3/4/6/7/8分别为ETC入口、出口、开放式、表示站、合建站141WaitTime最小重读时间(单位:秒)151TxPower功率级数161PLLChannelID信道号171SendFlagInfoa是否处理标识站信息,0-处理,1-不处理181BCC异或校验值a当SendFlagInfo0(C3,C6)00099车道应从0009文件内读取前9字节,填写B4帧内标识站信息。继续交易指令继续交易指令(简称C1指令),见表B.5。表B.5继续交易指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC124OBUIDOBU号,高字节在前61BCC异或校验值停止交易指令停止交易指令(简称C2指令),见表B.6。表B.6停止交易指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC224OBUIDOBU号61BCC异或校验值注:C2指令为拒绝交易指令,表示不对该OBU进行交易处理,RSU须重新搜索OBU。写过站信息指令写过站信息指令(简称C3指令),见表B.7.表B.7写过站信息指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC324OBUIDOBU号67PurchaseTimeYYYYMMDDHHmmSS,7字节BCD码,用此时间计算TAC码1340File00190019文件(除前3字节后的40字节)531BCC异或校验值注:C3指令用于非消费站模式,该指令只对RSU发送过来的正常B4帧信息的回应有效。对于CPU卡,如果需要读取标识站信息,写过站信息同时,需应清除标识站信息。写标识站信息指令写标识站信息指令(简称C4指令),见表B.8。表B.8写标识站信息指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC424OBUIDOBU号69File00090009文件前9字节151BCC异或校验值注:C4指令用于标识站写标识站,该指令只对RSU发送过来的正常B4帧信息的回应有效,天线回应B5帧(CPU卡)。获取CPU卡免费区间指令获取CPU卡免费区间指令(简称C5指令),见表B.9。表B.9获取CPU卡免费区间指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC524OBUIDOBU号61BCC异或校验值注:C5指令用于获取去CPU卡免费行车区间指令,该指令在出口车道接收到B4帧后回应RSU。消费和写过站信息指令消费和写过站信息指令(简称C6指令),见表B.10。表B.10消费和写过站信息指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC624OBUIDOBU号64PurchaseMoney扣款金额(单位:分)107PurchaseTimeYYYYMMDDHHmmSS,7字节BCD码,用此时间计算TAC码1740File00190019文件40字节571BCC异或校验值注:C6指令用于消费站模式,该指令只对RSU发送过来的正常B4帧信息的回应有效。对于CPU卡,如果设置为处理标识站信息时,入口写过站信息同时,需应清除标识站信息。取TAC码指令取TAC码指令(简称C7指令),见表B.11。表B.11取TAC码指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0xC724OBUIDOBU号61BCC异或校验值注:C7指令只对RSU发送过来的正常B4帧信息的回应有效,返回的TAC码从回应的正常B5帧中获取。开关天线指令开关天线指令(简称4C指令),见表B.12。表B.12开关天线指令位置字节数数据元数据内容01RSCTL串口帧序列号11CMDType指令代码,此处取值0x4C21AntennaStatus天线开关,00表示关天线,01表示开天线远区;02表示开天线近区31BCC异或校验值RSU信息帧数据结构RSU设备状态信息帧RSU设备状态信息帧(简称B0帧),见表B.13。表B.13RSU位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧21RSUStatusRSU主状态参数;0x00表示正常,否则表示异常36RSUTerminalId1PSAM卡终端机编号96RSUTerminalId2PSAM卡终端机编号(对应CPU卡)151RSUAlgId算法标识(对应CPU卡的交易类型)161RSUManuIDRSU厂商代码173RSUIndividualIDRSU编号202RSUVersionRSU软件版本号225Reserved保留字节271BCC异或校验值注:RSU在上电或收到PC初始化指令后发送该帧信息给PC。如果RSCTL等于0x98,表示RSU刚刚上电,PC应发送初始化指令(C0指令)到RSU,作为对收到信息的应答,同时设置RSU的工作参数;如果RSCTL不等于0x98,PC则应答继续交易指令(C1指令)。OBU系统信息帧OBU系统信息帧(简称B2帧),见表B.14。表B.14OBU位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧类型标识,此处取值0xB224OBUIDOBU号61ErrorCodeOBU执行状态,取值为0x00时才有后续数据内容78ContractProvider发行商代码151ContractType协约类型,暂取1161ContractVersion协约版本,暂取1178ContractSerialNumber应用序列号,8个字节,BCD编码254ContractSignedDate协议签署日期,yyyymmdd(BCD编码)294ContractExpiredDate协议过期日期,yyyymmdd(BCD编码)331EquitmentstatusOBU硬件版本342OBUStatusOBU状态361BCC异或校验值注:RSU在搜索到OBU号后发送OBU号给PC,表示通讯区域内存在此OBU,同时ErrorCode为0;RSU在其通信区域内始终搜索不到OBU的情况下,也需要每分钟向车道控制机发送此帧,作为心跳信息使用,表示天线正常工作,同时ErrorCode取值为0x80,OBUID取值为0x00,0x00,0x00,0x00。OBU车辆信息帧OBU车辆信息帧(简称B3帧),见表B.15。表B.15OBU位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧类型标识,此处取值0xB324OBUIDOBU号61ErrorCode执行状态代码,此处取值0x00712VehicleLicencePlateNumberOBU记载的车牌号192VehicleLicencePlateColor车牌颜色211VehicleClass车辆类型221VehicleUserType车辆用户类型234VehicleDimensions车辆尺寸,包括长(2个字节)、宽(1个字节)、高(1个字节)271VehicleWheels车轮数281VehicleAxles车轴数292VehicleWheelBases轴距,二进制表示,长度为2个字节,单位为分米;如0x28,表示轴距为4米313VehicleWeightLimits车辆载重(货车)或座位数(客车),二进制表示,单位为公斤/座B.15OBU(续)位置字节数数据元数据内容3416VehicleSpecificInformationASCII驰307”5016VehicleEngineNumber车辆发动机号661BCC异或检验注:B3帧信息主要包含车辆信息,PC应答C1指令,RSU继续对该OBU进行操作;PC应答C2指令,RSU将重新搜索OBU。IC卡信息帧IC卡信息帧(简称B4帧),见表B.16。表B.16IC卡信息帧位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧类型标识,此处取值0xB424OBUIDOBU号61ErrorCode执行状态代码71CardType卡类型(CPU卡为0)84CardRestMoney卡余额,高位在前。1250File00150015文件,不足50字节后补00H6240File00190019文件1029File000920(C0字段)1111BCC异或校验值注:B4帧信息主要包含IC卡基本信息,当ErrorCode等于0x02时表示OBU无卡。PC应答写卡(C3/C4/C6)指令,RSU对该OBU进行写卡操作;PC应答C2指令,表示不对该OBU进行处理,RSU退出此次操作;PC应答C5指令时,读取CPU卡000A文件。成功交易结束帧成功交易结束帧(简称B5帧),见表B.17。表B.17成功交易结束帧位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧类型标识,此处取值B5H24OBUIDOBU号61ErrorCode执行状态代码,此值为0才有后续内容77PurchaseTime本次交易日期和时间146RSUTerminalIdPSAM卡终端机编号204PSAMPaySerialPSAM卡交易序列号表B.17成功交易结束帧(续)位置字节数数据元数据内容242CPUCardPaySerialCPU卡交易序列号261RSUAlgId算法标识(对应CPU卡的交易类型)271KeyVer密钥版本号284TACTAC码321BCC异或校验值注:B5帧表示本次交易成功结束,PC应答C1指令。CPU卡免费区间信息帧CPU卡免费区间信息帧(简称B6帧),见表B.18。表B.18CPU位置字节数数据元数据内容01RSCTL串口帧序列号11FrameType数据帧类型标识,此处取值B5H24OBUIDOBU号61ErrorCode执行状态代码,此值为0才有后续内容766File000A000A文件731BCC异或校验值注:只有对B4帧应答C5指令时,RSU才发送B6帧。附录C(规范性附录)通讯参数采用标准RS232串行接口进行通讯,通讯参数如下:——波特率:9600bps;——数据位:8——停止位:1——奇偶校验:无;——流控制:无。信息帧格式信息帧采用ASCII字符串进行编码,具体格式(PC至卡机、卡机至PC)见表C.1。表C.1信息帧格式STXRSCTLCTLDATAETX帧起始标志,1个字节,值为3CH(1‘0帧序列号一致;1个字节,详见后续描述;数据域,配合控制信详见后续描述;帧结束标志,1个字节,值为3EH(字符‘>’);注:重复发送信息帧时,其帧序列号不变。为了调试方便,考虑到串口线一般较短(1.5m左右)、通讯协议相对简单以及所控制设备误动作后不会对车辆造成损害,因此在协议中不设校验字节,接收方根据STX、ETX是否正确完整,以及控制信息对应的信息帧长度校验接收信息是否正确。正负应答信息帧(PC至卡机、卡机至PC)正应答信息(30H)帧正应答信息(30H)帧见表C.2。表C.2正应答信息(30H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL30H(字符‘0’)31ETX3EH(字符‘>’)注:接收方校验接收信息正确后在准备执行操作前回应正应答帧;是否回应正应答帧视控制信息而定。负应答信息(31H)帧负应答信息(31H)帧见表C.3。表C.3负应答信息(31H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL31H(字符‘1’)31ETX3EH(字符‘>’)注:接收方校验接收信息错误后回应负应答帧;发送方接收到负应答帧后应立即重复发送相应信息帧;是否回应负应答帧视控制信息而定。自动发卡机至PC机的信息帧上电信息(41H)帧上电信息(41H)帧见表C.4。表C.4上电信息(41H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL41H(字符‘A’)31ETX3EH(字符‘>’)注:卡机加电自检后上报;等待PC机回应初始化信息(61H)帧,如果在1s后没有回应重复上报。状态信息(42H)帧状态信息(42H)帧见表C.5,该帧的数据域见表C.6。表C.5状态信息(42H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL42H(字符‘B’)326DATA见表C.6291ETX3EH(字符‘>’)注:当卡机检测相关状态发生改变时上报;卡机在空闲状态下每2s上报一次。无需PC应答。表C.6状态信息(42H)帧DATA域位置字节数数据内容01上工位当前卡机:30H;31H1#机;32H2#机;表C.6状态信息(42H)帧DATA域(续)位置字节数数据内容11下工位当前卡机:30H无;33H为3#机;34H为4#机;211#卡机状态:30H卡机正常;31H卡机故障;32H卡机有坏卡;311#卡夹状态:30H卡夹已装上;31H卡夹已卸下;431#“050”50711#卡机天线是否有卡状态,30H无卡;31H有卡812#卡机状态:30H卡机正常;31H卡机故障;32H卡机有坏卡;912#卡夹状态:30H卡夹已装上;31H卡夹已卸下;1032#“050”501312#卡机天线是否有卡状态,30H无卡;31H有卡1413#卡机状态:30H卡机正常;31H卡机故障;32H卡机有坏卡;1513#卡夹状态:30H卡夹已装上;31H卡夹已卸下;1633#“050”501913#卡机天线是否有卡状态,30H无卡;31H有卡2014#卡机状态:30H卡机正常;31H卡机故障;32H卡机有坏卡;2114#卡夹状态:30H卡夹已装上;31H卡夹已卸下;2234#“050”502514#卡机天线是否有卡状态,30H无卡;31H有卡注:卡机中卡计数值包括卡夹内卡的实际值和天线位置卡片数(1或0)。已出卡信息(43H)帧已出卡信息(43H)帧见表C.7。表C.7已出卡信息(43H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL43H(字符‘C’)31工位信息31H为上工位;32H为下工位;33H为出卡失败41当前卡机编号30H无;31H为1#机;32H为2#机;33H为3#机;34为4#机51ETX3EH(字符‘>’)注:当卡机按PC机要求成功执行出卡操作后上报该信息帧;等待PC机回应正负应答信息(30H、31H)帧,如果未收到回应帧,间隔1s上报一次;如果收到负应答信息(31H)帧立即重复上报;如果收到正应答信息(30H)帧结束;出卡失败后修改卡机状态为故障,重新切换卡机,并重新上报按键。按钮取卡信息(44H)帧按钮取卡信息(44H)帧见表C.8。表C.8按钮取卡信息(44H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL44H(字符‘D’)31工位信息31H为上工位;32H为下工位41当前卡机编号30H无;31H为1#机;32H为2#机;33H为3#机;34为4#机51ETX3EH(字符‘>’)注:PC机回应正负应答信息(30H31H)1s(30H)时间应≤0.5s;当相应工位所有卡机无法发卡(卡机故障、无卡、坏卡等)时,屏蔽司机的按键。卡被取走信息(45H)帧卡被取走信息(45H)帧见表C.9。表C.9卡被取走信息(45H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL45H(字符‘E’)31工位信息31H为上工位;32H为下工位41当前卡机编号30H无;31H为1#机;32H为2#机;33H为3#机;34为4#机51ETX3EH(字符‘>’)注:当卡机出卡口卡被取走时上报该信息帧;等待PC机回应正负应答信息(30H、31H)帧,如果未收到回应帧,间隔1s上报一次;如果收到负应答信息(31H)帧立即重复上报;如果收到正应答信息(30H)帧结束;从司机取走卡到上报信息的延时时间应≤0.5s。上报卡夹号信息(46H)帧上报卡夹号信息(46H)帧见表C.10,该帧的数据域见表C.11。表C.10上报卡夹号信息(46H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL46H(字符‘E’)336DATA见表C.11391ETX3EH(字符‘>’)注:当发卡机检测到内部小卡机卡夹编号发生变化时上报(换上、换下卡夹);在收到初始化命令后,主动上报,如果未收到回应帧,间隔1s上报一次。PC应答正负应答帧。表C.11上报卡夹号信息(46H)帧DATA域位置字节数数据内容061#卡机内卡夹编号631#“050”50962#卡机内卡夹编号1532#“050”501863#卡机内卡夹编号2433#“050”502764#卡机内卡夹编号3334#“050”50注:卡夹号保存在信息扭扣的第1扇区(0x10),长度为6,以0-9的ASCII码表示,如卡夹号为123456,则在该扇区实际写入的内容为:313233343536;没有卡夹时,卡夹号为000000。读卡夹信息反馈(57H)帧读卡夹信息反馈(57H)帧见表C.12,该帧的数据域见表C.13。表C.12读卡夹信息反馈(57H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL57H(字符‘W’)3n+8DATA见表C.13,n为读取信息的长度n+111ETX3EH(字符‘>’)表C.13读卡夹信息反馈(57H)帧DATA域位置字节数数据内容01工位信息:31H,32H,33H,34H号工位11读状态:30H失败,31H成功24读取信息的开始地址,字符串表示的16进制,如12ABH为字符串‘12AB’62读取信息的长度n,字符串表示的16进制8n读取的数据内容回收IC卡反馈(58H)帧回收IC卡反馈(58H)帧见表C.14。表C.14回收IC卡反馈(58H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL58H(字符‘X’)31工位信息31H,32H,33H,34H号工位表C.14回收IC卡反馈(58H)帧(续)位置字节数数据数据内容41回收卡结果30H-失败;31H-成功51ETX3EH(字符‘>’)注:返回回收卡是否成功,卡道无卡返回失败。PC应答正负应答帧。PC机至自动发卡机的信息帧与卡机应答初始化信息(61H)帧初始化信息(61H)帧见表C.15。表C.15初始化信息(61H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL61H(字符‘a’)33卡夹最大计数值“500”表示卡夹最大允许装500张卡614同步时间“20050102120102”表示时间为2005-01-0212:01:02201ETX3EH(字符‘>’)注:车道程序启动检测自动发卡机存在后发送该信息帧;当接收到卡机发送的上电信息(41H)帧时回应该信息帧;等待卡机回应正负应答信息(30H、31H)帧,如果未收到回应帧,间隔1s上报一次;如果收到负应答信息(31H)帧立即重复上报;如果收到正应答信息(30H)帧结束。卡机接收到初始化信息帧后应初始化卡机,卡机恢复到初始状态,在卡机能正常发卡的情况下能够重新响应司机的按键取卡操作并进行上报。出卡信息(62H)帧出卡信息(62H)帧见表C.16。表C.16出卡信息(62H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL62H(字符‘b’)31DATA30H默认卡机出卡;31H1#卡机出卡;32H2#卡机出卡;33H3#卡机出卡;34H4#卡机出卡;35H上工位默认卡机出卡;36H下工位默认卡机出卡;41ETX3EH(字符‘>’)注:IC卡读写成功后,DATA域的值为30H;操作员执行取坏卡操作时,DATA域的值为相应卡机编号。PC等待卡机回应正负应答信息(30H、31H)帧,如果未收到回应帧,间隔1s上报一次;如果收到负应答信息(31H)帧立即重复上报;如果收到正应答信息(30H)帧结束。卡机接收到该信息帧后先进行正负应答然后执行出卡操作;卡机成功出卡后回应已出卡信息(43H)(44H)发卡;卡机未成功出卡且已无卡机可用时回应状态信息并屏蔽司机的按键操作。坏卡信息(63H)帧坏卡信息(63H)帧见表C.17。表C.17坏卡信息(63H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL63H(字符‘c’)31DATA30H默认卡机坏卡;31H1#卡机坏卡;32H2#卡机坏卡;33H3#卡机坏卡;34H4#卡机坏卡;35H上工位默认卡机坏卡;36H下工位默认卡机坏卡;41ETX3EH(字符‘>’)注:IC(30H31H)(31H)(30H)帧后先进行正负应答然后执行切换操作;卡机执行切换当前卡机操作后回应按键取卡信息(44H)帧要求重新发在以后的状态信息中体现出来。查询卡机状态(65H)帧查询卡机状态(65H)帧见表C.18。表C.18查询卡机状态(65H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL65H(字符‘e’)31DATA无41ETX3EH(字符‘>’)注:PC(30H31H)1s上报一次;如果收到负应答信息(31H)(30H)0x42(‘B’)帧。查询卡夹(66H)帧查询卡夹(66H)帧见表C.19。表C.19查询卡夹(66H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL66H(字符‘f’)表C.19查询卡夹(66H)帧(续)位置字节数数据数据内容31DATA无41ETX3EH(字符‘>’)注:(30H31H)1s上报一次;如果收到负应答信息(31H)帧立即重复上报;如果收到正应答信息(30H)帧结束;卡机回应正应答后,主动上报0x46(‘F’)帧。设置卡夹卡数(67H)帧设置卡夹卡数(67H)帧只针对固定卡机,见表C.20。表C.20设置卡夹卡数(67H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL67H(字符‘g’)31工位信息31H,32H,33H,34H号工位43卡夹卡数“050”表示卡夹有50张卡71ETX3EH(字符‘>’)注:设置相应工位卡夹卡数,通过42H帧判断卡数是否设置成功。更换卡夹后必须设置卡数,否则为原来卡数。卡机应答正负应答帧。读卡夹信息(77H)帧读卡夹信息(77H)帧见表C.21。表C.21读卡夹信息(77H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL77H(字符‘w’)31工位信息31H,32H,33H,34H号工位44开始地址读取信息的开始地址,字符串表示的16进制82信息长度读取信息的长度,字符串表示的16进制101ETX3EH(字符‘>’)注:此协议只有在卡机无司机按键时发生才有效。如从2号工位卡夹的10H地址读6个字节,假设包序号为0,发送的协议为‘<0w2001006>’,卡机读失败返回读失败信息,读成功返回数据。卡机应答为正负应答帧。回收卡道中的IC卡(78H)帧回收卡道中的IC卡(78H)帧见表C.22。表C.22回收卡道中的IC卡(78H)帧位置字节数数据数据内容01STX3CH(字符‘<’)11RSCTL帧序列号,1‘0’到‘9’依次循环21CTL78H(字符‘x’)31DATA工位信息:31H,32H,33H,34H号工位41ETX3EH(字符‘>’)注:将指定工位上的IC卡回收,如卡道无卡返回失败;卡道有卡执行回收动作,动作执行成功返回成功,动作执行失败返回失败。卡机应答正负应答帧。通讯过程说明卡机上电自检进卡到读写位置往PC发送41H帧并等待PC回应61H进卡到读写位置往PC发送41H帧并等待PC回应61H间隔1s发送一次响应正应答,同步与PC间的时间并设置卡夹最大卡数,初始化系统,如果相应工位能够发卡响应司机的按键取卡操作,如果各工位均无法出卡屏蔽司机的按键取卡操作空闲时期每隔2s上报一次卡机状态信息(42H)帧PCPC接收到41H帧后获接收到41H帧后获应初始化信息帧,并等待卡没有回应间隔1s有负应答立即重结束操作初始化信息(61H)更新显示自动发卡机状态并上报监视程序更新显示自动发卡机状态并上报监视程序图C.1卡机上电自检车道程序启动化信息61H帧要求卡机同步时间并初始化卡机系统,允许重新响应司机的按键取卡操作,与卡机的通讯过程如图C.2。信息帧正应答信息信息帧正应答信息(30H)帧状态信息(42H)帧响应正应答,结束设置卡夹最大卡数,初始化系统,如果相应工位能够发卡响应司机的按空闲时期每隔2s上报一次卡机状态信息(42H)帧自动发卡机更新显示自动发卡机状态并上报监视程序如果自动发卡机存在,发送初始化信息(61H)帧,要求卡机同步时间并初始化系统,等待卡机回应,如果无回应间隔1s重复发送一次,收到负应答立即重发,收到正应答结束PC车道程序启动后监听自动发卡机是否存在,如果不存在更新自动发卡机状态并上报监视程序发卡流程发卡流程见图C.3,发卡流程中PC与自动发卡机的通讯过程见图C.4、图C.5、图C.6、图C.7。车道计算机与自动发卡机均正常工作车道程序检测有车驶入抓拍线圈,通过卡机喇叭提示“请按键取卡…”,如果司机没有反应间隔5s重复播报,车牌识别仪自动识别车辆牌照,车道程序提示操作终端输入车型、车情等信息并抓拍车辆图像车道计算机与自动发卡机均正常工作车道程序检测有车驶入抓拍线圈,通过卡机喇叭提示“请按键取卡…”,如果司机没有反应间隔5s重复播报,车牌识别仪自动识别车辆牌照,车道程序提示操作终端输入车型、车情等信息并抓拍车辆图像司机按下取卡按钮,卡机往PC上报按键取卡信息帧,并等待应答车道程序接收按键取卡信息帧后回应正应答信息帧,然后执行刷卡操作将有关信息写入IC通行卡中写卡是否成功?写卡是否成功?失败成功按键取卡信息帧判断卡机发送的信息帧状态信息帧指示所有卡机均故障已出卡信息帧通过卡机喇叭提示“请取卡…”,如果司机没有反应,间隔3s重复提示更新卡机状态,声光提示操作人员卡机故障,如果抓拍线圈有车,通过卡机喇叭提示司机5s重复一次,直到卡机正常重发按键取卡信息帧或抓拍线圈无车司机取走通行卡,卡机上报卡已被取走信息帧车道程序回应应答信息帧后控制自动栏杆机抬杆,车辆通过过车线圈后程序控制自动栏杆机落杆,结束一次发卡流程结束往卡机发出卡信息帧,卡机接收到出卡指令后执行出卡操作,如果操作成功上报已出卡信息帧,如果操作失败切换当前卡机,并重新发送按键取卡信息帧,如果所有卡机均无法正常使用,不执行任何操作,发送状态信息帧往卡机发坏卡信息帧,卡机接收到指令后切换当前卡机,并重新发送按键取卡信息帧,如果所有卡机均无法正常使用,不执行任何操作,发送状态信息帧图C.3发卡流程状态信息(42H)帧状态信息(42H)帧按键取卡信息(44H)帧正应答信息(30H)帧(43H)帧(45H)(30H)帧检测司机取走通行卡,发1s重发响应正应答,执行出卡操PC1s重发卡机检测司机按下取卡按钮,发送按键取卡信息帧重发自动发卡机回应正应答信号,提示司机“请取卡…”,如果司5s回应正应答信号,控制自动栏杆机抬杆,并提示“谢谢合作,请通将入口信息写入通行卡检测车辆触发抓拍线圈提示司机“请按键取等待卡机按键取卡信息PCPC自动发卡机更新卡机状态状态信息(42H)PC自动发卡机更新卡机状态状态信息(42H)帧空闲时间隔2s卡机状态检测车辆触发抓拍线圈提等待卡机按键取卡信息将入口信息写入通行卡按键取卡信息(44H)帧 (30H)帧卡机检测司机按下取卡按钮,发送按键取卡信息帧并等待应答,无应答间隔重发按键取卡信息(44H)帧正应答信息(30H)帧状态信息(42H)帧按键取卡信息(44H)状态信息(42H)帧按键取卡信息(44H)帧正应答信息(30H)帧按键取卡信息(44H)帧正应答信息(30H)帧响应正应答,切换当前卡1s重发卡机检测司机按下取卡按钮,发送按键取卡信息帧并等待应答,无应答间隔重发自动发卡机空闲时间隔2s卡机状态回应正应答信息帧,开始将入口信息写入通行卡中,如果写卡失败往卡机发坏卡指令并等待卡机应答信号,无回应间隔1s重发检测车辆触发抓拍线圈提等待卡机按键取卡信息PC更新卡机状态状态信息(42H)帧按键取卡信息(44H)状态信息(42H)帧按键取卡信息(44H)帧正应答信息(30H)帧状态信息(42H)帧响应正应答,如果所有卡机均无法正常工作,回应状态信息帧上报故障情况,屏蔽司机按键操作卡机检测司机按下取卡按钮,发送按键取卡信息帧并等待应答,无应答间隔重发自动发卡机空闲时间隔2s卡机状态障请稍候…”将入口信息写入通行卡指令并等待卡机应答信1s重发检测车辆触发抓拍线圈提等待卡机按键取卡信息PC更新卡机状态卡机内坏卡处理停留在卡机中的坏卡,维护员可以通过执行坏卡出卡操作将卡从卡机内取出,通讯过程见图C.8。状态信息(42H)状态信息(42H)帧(43H)帧(30H)帧卡被取走信息(45H)帧 (30H)帧PC报卡被取走信息帧并等待PC应答,无应答间隔1s重发响应正应答,按出卡指令(62H)PC上报PC应1s重发自动发卡机空闲时间隔2s卡机状态操作取走坏卡检测维护员需要执行坏卡1s重发PC更新卡机状态附录D(规范性附录)IO控制器API指令函数定义打开设备函数名称:intIO_Open(intnType,constchar*szParas)功能描述:在主机与设备之间建立连接。参数说明见表D.1。返回值说明见表D.2表D.1IO_Open参数说明参数参数类型说明nType传入连接方式:0-板卡;1-串口szParas传入连接信息,如“COM1”表D.2IO_Open返回值说明返回值说明>0打开设备成功,返回值为设备句柄号-100设备无响应-1000传入参数错误-1001设备被占用-1002设备打开失败-2000其它错误关闭设备函数名称:intIO_Close(intnHandle)功能描述:主机与设备断开连接。参数说明见表D.3。返回值说明见表D.4表D.3IO_Close参数说明参数参数类型说明nHandle传入设备句柄表D.4IO_Close返回值说明返回值说明0关闭设备成功表D.4IO_Close返回值说明(续)返回值说明-100设备无响应-1000传入参数错误-2000其它错误获取输入函数名称:intIO_GetInput(intnHandle,int*pInput)功能描述:获取设备输入。参数说明见表D.5。返回值说明见表D.6表D.5IO_GetInput参数说明参数参数类型说明nHandle传入设备句柄pInput传出设备输入,按位表示,高位在前表D.6IO_GetInput返回值说明返回值说明0操作成功-100设备无响应-1000传入参数错误-2000其它错误控制输出函数名称:intIO_SetOutput(intnHandle,intnOutput)功能描述:控制设备输出。参数说明见表D.7。返回值说明见表D.8表D.7IO_SetOutput参数说明参数参数类型说明nHandle传入设备句柄nOutput传入输出控制,按位表示,高位在前表D.8IO_SetOutput返回值说明返回值说明0操作成功-100设备无响应表D.8IO_SetOutput返回值说明(续)返回值说明-1000传入参数错误-2000其它错误注册IO设备输入回调函数名称:intIO_RegInputStatusCallBack(intnHandle,PIO_OnInputChangedpFunc,constvoid*pUser)功能描述:注册IO设备输入回调函数。参数说明见表D.9。返回值说明见表D.10。IO设备输入回调函数定义:typedefvoid(*PIO_OnInputChanged)(intnHandle,intnInput,constvoid*pUser)IO设备输入回调函数参数说明见表D.11。表D.9IO_RegInputStatusCallBack参数参数类型说明nHandle传入设备句柄pFunc传入回调函数,为NULL时取消回调pUser传入用户自定义数据表D.10 IO_RegInputStatusCallBack返回值说明返回值说明0操作成功-100设备无响应-1000传入参数错误-2000其它错误表D.11IO设备输入回调函数参数说明参数参数类型说明nHandle传入设备句柄nInput传入IO设备输入,同调用IO_GetInput主动获取的设备输入pUser传入用户自定义数据获取设备运行状态函数名称:intIO_GetDevStatus(intnHandle,int*pDevStatus)功能描述:获取设备运行状态。参数说明见表D.12。返回值说明见表D.13表D.12IO_GetDevStatus参数参数类型说明nHandle传入设备句柄pDevStatus传出设备状态表D.13IO_GetDevStatus返回值说明0操作成功-100设备无响应-1000传入参数错误-2000其它错误注册设备状态变化回调函数函数名称:intIO_RegDevStatusCallBack(intnHandlePIO_OnDevStatusChangedpFuncconstvoid*pUser)功能描述:注册IO设备状态变化回调函数。参数说明见表D.14。返回值说明见表D.15。IO设备状态回调函数定义:typedefvoid(*PIO_OnDevStatusChanged)(intnHandle,intnDevStatus,constvoid*pUser)IO设备状态回调函数参数说明见表D.16。表D.14 IO_RegDevStatusCallBack参数说明参数参数类型说明nHandle传入设备句柄pFunc传入回调函数,为NULL时取消回调pUser传入用户自定义数据表D.15 IO_RegDevStatusCallBack返回值说明返回值说明0操作成功-100设备无响应-1000传入参数错误-2000其它错误表D.16IO设备状态回调函数参数说明参数参数类型说明nHandle传入设备句柄nDevStatus传入设备状态,同调用IO_GetDevStatus主动获取的设备状态pUser传入用户自定义数据获取错误码详细描述函数名称:intIO_GetStatusMsg(intnStatusCode,char*sStatusMsg,intnStatusMsgLen)功能描述:获取错误码详细描述。参数说明见表D.17。返回值说明见表D.18表D.17IO_GetStatusMsg参数参数类型说明nStatusCode传入错误码sStatusMsg传出错误码信息缓存nStatusMsgLen传入错误码信息缓存长度表D.18IO_GetStatusMsg返回值说明0操作成功-1000传入参数错误-2000其它错误获取版本信息函数名称:intIO_GetVersion(intnHandle,char*sHWVersion,intnHWVerMaxLen,char*sFWVersion,intnFWVerMaxLen)功能描述:获取版本信息。参数说明见表D.19。返回值说明见表D.20。表D.19IO_GetVersion参数参数类型说明nHandle传入设备句柄sHWVersion传出硬件版本信息nHWVerMaxLen传入硬件版本信息缓存最大长度sFWVersion传出设备固件版本信息nFWVerMaxLen传入设备固件版本信息缓存最大长度表D.20IO_GetVersion返回值说明0操作成功-100设备无响应-1000传入参数错误-2000其它错误附录E(规范性附录)收/发卡机API指令函数定义LONGWINAPICreateObj(void*pOwner)功能描述:创建对象函数。参数:pOwner为卡机对象指针。pOwner来区分不同的卡机对象。建议用户定义一个卡机类,并为不同的卡机生成卡机对象,再将对象指针传递给CreateObj。若用户不使用卡机类,可用不同的整数来标识不同的卡机对象。除调用回调函数时使用pOwner外,DLL对pOwner不进行任何处理。BOOLWINAPIDestroyObj(longhObj)功能描述:析构对象函数。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:析构成功返回TRUE;否则返回FALSE。BOOLWINAPIOpen(longhObj,intnPort)功能描述:打开卡机串口。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nPort199(COM1,nPort=1)。返回值:串口打开成功返回TRUE;否则返回FALSE。BOOLWINAPIClose(longhObj)功能描述:关闭卡机串口。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:串口关闭成功返回TRUE;否则返回FALSE。BOOLWINAPICardMoveOut(longhObj)功能描述:发卡(发卡机把卡从卡夹送到天线范围)。参数:hObj为对象句柄,由创建对象函数CreateObj返回值:命令成功发送后返回TRUE;否则返回FALSE。说明:此命令只负责通知卡机发卡,至于发卡是否成功则由回调函数通知调用者。BOOLWINAPICardMoveIn(longhObj)功能描述:收卡,收卡机将卡从天线范围送进卡夹。参数:hObj为对象句柄,由创建对象函数CreateObj返回值:命令成功发送后返回TRUE;否则返回FALSE。说明:此命令只负责通知卡机收卡,至于收卡是否成功则由回调函数通知调用者。BOOLWINAPICardReject(longhObj)功能描述:弹出卡(将卡从天线范围弹出到通道口)。参数:hObj为对象句柄,由创建对象函数CreateObj返回值:命令成功发送后返回TRUE;否则返回FALSE。由回调函数通知调用者。BOOLWINAPIIsHaveCard(longhObj)功能描述:天线范围是否有卡。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:天线范围有卡返回TRUE;否则返回FALSE。说明:只对当前工作通道有效。例如:若通道1为工作通道,若通道2天线范围有卡而通道1天线范围无卡,则返回FALSE。BOOLWINAPIIsBoxEmpty(longhObj)功能描述:只对发卡机有效,判断卡夹中卡数是否为空。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:发卡机卡夹已空时返回TRUE;否则返回FALSE。说明:只对当前工作通道有效。例如:若通道1为工作通道,若通道2卡夹已空而通道1卡夹未空,BOOLWINAPIIsOverFlow(longhObj)功能描述:只对收卡机有效,判断卡夹中卡数是否已满。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:收卡机卡夹已满时返回TRUE;否则返回FALSE。说明:对当前工作通道有效。例如:若通道1为工作通道,若通道2卡夹已满而通道1卡夹未满,则返回FALSE。卡机的卡满到位开关触发卡数目满标志,若卡机的卡满到位开关被触发,卡机不再向卡夹内收卡。BOOLWINAPIIsHaveBox(longhObj)功能描述:工作通道中是否有卡夹。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:卡机内有卡夹时返回TRUE;否则返回FALSE。12有卡夹而通道1FALSE。intWINAPIGetCurCardNum(longhObj)功能描述:获取当前卡夹中卡数目。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:返回当前通道卡夹中卡数目。说明:若要获取指定通道卡数目,应使用函数GetCardNumber。intWINAPIGetCardNumber(longhObj,intnChannel)功能描述:获取指定通道卡夹中卡数目。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel12返回值:返回指定通道卡夹中卡数目说明:若指定通道为当前工作通道,则本函数等同于GetCurCardNum。BOOLWINAPISetCurCardNum(longhObj,intnCurNum)功能描述:设定当前通道卡夹中的卡数目。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nCurNum0999返回值:设置成功返回TRUE;否则返回FALSE。BOOLWINAPISetCardNumber(longhObj,intnChannel,intnValue)功能描述:设置指定通道卡夹中的卡数目。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel为通道号码,允许范围为1或2。——nValue0999返回值:设置成功返回TRUE;否则返回FALSE说明:若指定通道为当前工作通道,则本函数等同于SetCurCardNum。BOOLWINAPIGetBoxSerialNo(longhObj,int*pnSn,BOOLbRefresh)功能描述:获取当前通道卡夹编号。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——pnSn返回卡夹编号。——bRefreshbershFLETU返回值:获取成功返回TRUE;否则返回FALSE。BOOLWINAPIGetBoxNo(longhObj,intnChannel,int*pnSn,BOOLbRefresh)功能描述:获取指定通道卡夹号。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel为通道号码,允许范围为1或2。——pnSn返回卡夹编号。——bRefreshbershFLETU返回值:获取成功返回TRUE;否则返回FALSE。说明:若指定通道为当前工作通道,则本函数等同于GetBoxSerialNo。BOOLWINAPISetBoxSerialNo(longhObj,intnSn)功能描述:设置当前通道卡夹编号。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nSn为要设置的卡夹编号。返回值:设置成功返回TRUE;否则返回FALSE。BOOLWINAPISetBoxNo(longhObj,intnChannel,intnSn)功能描述:设置指定通道卡夹。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel为通道号码,允许范围为1或2。——nSn为要设置的卡夹编号。返回值:设置成功返回TRUE;否则返回FALSE。说明:若指定通道为当前工作通道,则本函数等同于SetBoxSerialNo。BOOLWINAPIRegEventProc(longhObj,PCM_OnDevStatusChangedpHookFun)功能描述:注册卡机回调函数。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——pHookFunDLL返回值:注册成功返回TRUE;否则返回FALSE。卡机回调函数定义函数定义:typedefvoid(WINAPI*PCM_OnDevStatusChanged)(void*pOwner,intnMsgID,intnParam1,intnParam2)参数:——pOnwer为调用CreateObj函数时传入的对象指针。——Param1——Param2——MsgID为事件类型,编码如下:constMID_PowerOn=0; //上电constMID_HaveCard=1; //有卡constMID_NoCard=2; //无卡constMID_CardReject=3; //退卡完成,卡抽走后constMID_CardSendOut=4; //卡发出完成,对于发卡机,在卡拿走后constMID_CardMoveIn=5; //卡收入完成,对于收卡机,在入卡盒后constMID_BoxLoad=6; constMID_BoxUnLoad=7; constMID_BoxEmpty=8; 发卡机卡盒卡数告警,卡盒已空constMID_BoxFull=9; 收卡机卡盒卡数告警,卡盒已满constMID_NumChange=10; //卡数改变constMID_DoorOpen=11; //卡箱上盖开启(目前不支持)constMID_DoorClose=12; //卡箱上盖关闭(目前不支持)constMID_ChannelChange=13; //切换通道constMID_MachineTypeChange=14; //卡机类型改变constMID_MachineFault=15; //卡机故障constMID_CardAtEntry=16; //通道口有卡constMID_Unknown=300; //其他事件BOOLWINAPIRemoveFault(longhObj)功能描述:排除故障。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:命令成功发送后返回TRUE;否则返回FALSE。说明:此命令只负责通知卡机排除故障,至于故障是否排除则由回调函数通知调用者。BOOLWINAPIOpenDoor(longhObj)功能描述:打开卡机当前通道上盖锁。参数:hObj为对象句柄,由创建对象函数CreateObj返回。返回值:命令成功发送后返回TRUE;否则返回FALSE。说明:此命令只负责通知卡机开启上盖锁,至于上盖锁是否开启则由回调函数通知调用者。BOOLWINAPIOpenChannel(longhObj,intnChannel)功能描述:打开指定通道上盖锁。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel12返回值:命令成功发送后返回TRUE;否则返回FALSE。通道为当前工作通道,则本函数等同于OpenDoor。BOOLWINAPIChangeChannel(longhObj,intnChannel)功能描述:切换卡机通道。参数:——hObj为对象句柄,由创建对象函数CreateObj返回。——nChannel12返回值:命令成功发送后返回TRUE;否则返回FALSE。说明:此命令
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 混凝土运输协议书
- 财务分析报告范文
- 传热学课件教学课件
- 设备维修保养合同(04版)
- 冷冻供货合同模板范本 2篇
- 猫咪巨结肠课件
- 《居住区景观设计》课件
- 租赁厂房合同
- 职业经理人合作协议书 合同范本
- 基于二零二四年度计划的营销推广合同
- 职业生涯人物访谈音乐教师
- 中核韶关锦原铀业有限公司745矿退役治理II期工程环评报告
- 01SS105给排水常用仪表及特种阀门安装图集
- 消化道穿孔病例讨论培训课件
- 2023学年完整公开课版《5AM3U1Aroundthecity》
- 浙人美版七年级美术下册《鲁迅与美术》说课稿
- DB22-T 5040-2020 建设工程见证取样检测标准
- 空调维保合同
- 计量经济学期末考试试题及答案
- (4.5)-《动物解剖学》课件-第五章(呼吸系统)
- 心理统计学考研历年真题及答案
评论
0/150
提交评论