东海电子收费专用短程通信便携式ETC处理终端开发手册

东海电子收费专用短程通信便携式ETC处理终端开发手册DONGHAI上海东海电脑股份有限公司2008年11月东海电子收费专用短程通信便携式ETC处理终端开发手册上海东海电脑股份有限公司-I-目录1概述...........................................................................................................................................12二次应用开发环境...................................................................................................................22.1二次应用开发环境需求...................................................................................................22.2建立终端与PC的连接......................................................................................................23二次应用开发指南...................................................................................................................43.1运行EVC4.0.....................................................................................................................43.2东海便携式ETC处理终端SDK开发包库函数说明.......................................................93.2.1DSRC处理库函数.........................................................................................................93.2.2非接触IC卡读写库函数.........................................................................................11东海电子收费专用短程通信便携式ETC处理终端开发手册1概述东海电子收费专用短程通信便携式ETC处理终端（TQXS-WB-HIU-2）是按照中国电子收费专用短程通信标准GB/T20851-2007进行设计开发。本产品可用于公路电子收费系统领域，可以和符合中国电子收费专用短程通信标准的车载电子标签设备通讯。本终端具有IC接口，可操作发行各类用户卡；具有DSRC专用短程通信接口，可对OBU进行初始化、个人化和查验OBU数据的功能。本开发手册阐述了东海电子收费专用短程通信便携式ETC处理终端（TQXS-WB-HIU-2）二次应用开发的指导说明，供应用集成开发人员进行应用开发参考。东海电子收费专用短程通信便携式ETC处理终端（TQXS-WB-HIU-2）应用开发接口定义参照了以下标准、规范和技术要求：1.GB/T20851.3-2007《电子收费专用短程通信第3部分：应用层》2.GB/T20851.4-2007《电子收费专用短程通信第4部分：设备应用》3.“区域联网电子不停车收费系统应用示范技术规范第10部分OBE-RSE间ETC应用交易流程规范”，交通部公路科学研究院，2008年4月4.“区域联网电子不停车收费系统应用示范技术规范第12部分电子收费RSU与车道控制器的接口”，交通部公路科学研究院，2008年4月5.“DSRC设备协议一致性检测送检指南”，交通部公路科学研究院，2008年4月6.“长三角（苏、浙、沪、皖、赣）高速公路联网电子不停车收费(ETC)系统应用技术要求”，2008年9月7.“上海市高速公路电子不停车收费(ETC)系统应用技术要求”，上海市市政工程管理局，2008年9月上海东海电脑股份有限公司-1-东海电子收费专用短程通信便携式ETC处理终端开发手册2二次应用开发环境2.1二次应用开发环境需求东海电子收费专用短程通信便携式ETC处理终端内嵌WindowsCE5.0操作系统，应用集成开发人员可在PC上使用嵌入式开发工具进行二次开发，并将程序下载至终端内存中。在进行二次开发前，PC上建议安装如下开发包：„eMbeddedVisualC++4.0（SP4）„StandardSDKforWindowsCE.net„MicorosoftActiveSync4.5„东海便携式ETC处理终端SDK开发包2.2建立终端与PC的连接„PC上安装MicorosoftActiveSync4.5„用USB数据线连接PC机和手持机，在PC机端将会检测到USB设备，然后指定路径安装驱动；„选择东海便携式ETC处理终端驱动目录下的驱动文件，安装好驱动后,将会弹出”建立合作关系”对话框,选择’否’,点击下一步继续,如下图:上海东海电脑股份有限公司-2-东海电子收费专用短程通信便携式ETC处理终端开发手册„这时ActiveSync显示已连接，如下图。„此时可以在我的电脑里打开移动设备，查看ETC终端上的文件。注意事项：„ETC终端上“NandFlash”文件夹是掉电以后还能够保存的，如果拷贝文件到其他文件夹掉电以后会丢失。„请等ETC终端WindowsCE系统启动完毕后，PC再与其进行连接。上海东海电脑股份有限公司-3-东海电子收费专用短程通信便携式ETC处理终端开发手册3二次应用开发指南3.1运行EVC4.01.File菜单下选择New，如下图2.选择WCEMFCAppWixard(exe),CPUs选择Win32(WCEARMV4I),在Projectname中输入工程名，在Location中确定工程所在的路径，点击“OK”按钮继续，如下图：上海东海电脑股份有限公司-4-东海电子收费专用短程通信便携式ETC处理终端开发手册3.在WCEMFCAppWizard(exe)-Step1of4中，将语言设置为“其他”,保持默认值，点击“Next”继续，如下图：4.在WCEMFCAppWizard(exe)-Step2of4中，点击“Next”继续，如下上海东海电脑股份有限公司-5-东海电子收费专用短程通信便携式ETC处理终端开发手册图：5.在WCEMFCAppWizard(exe)-Step3of4中，选择MFC静态连接,点击“Next”继续，如下图：上海东海电脑股份有限公司-6-东海电子收费专用短程通信便携式ETC处理终端开发手册6.在WCEMFCAppWizard(exe)-Step4of4中，点击“Finish”结束向导上海东海电脑股份有限公司-7-东海电子收费专用短程通信便携式ETC处理终端开发手册7.选择“Build”菜单中的“SetActivePlatform…”，如下图：8.在SetActivePlatform对话框中，选择新安装的DHETCHandHeld，点击“OK”按钮继续，如下图：9.点击运行,工程编译链接完成后，会自动下载到ETC处理终端的WINCE根目上海东海电脑股份有限公司-8-东海电子收费专用短程通信便携式ETC处理终端开发手册录上去，并运行。注意:如果WCE无法连接,请修改一下ETC处理终端的网卡设置为DHCP动态获取IP。3.2东海便携式ETC处理终端SDK开发包库函数说明3.2.1DSRC处理库函数1.打开DRSC设备端口函数：DHETCOpenReader();参数：无返回：0－成功，非0－失败2.关闭DRSC设备端口函数：DHETCCloseReader()参数：无返回：0－成功，非0－失败3.DSRC设备蜂鸣函数：DHETCReaderBeep(unsignedchar_10ms)参数：_10ms，蜂鸣时间（取值范围1～30，30即300ms）返回：0－成功，非0－失败4.复位DSRC设备函数：DHETCResetReader()参数：无返回：0－成功，非0－失败5.初始化DSRC设备函数：DHETCInitDSRC(unsignedcharBSTInterval,unsignedcharRetryInterval,上海东海电脑股份有限公司-9-东海电子收费专用短程通信便携式ETC处理终端开发手册unsignedcharTxPower,unsignedcharPLLChannelID,unsignedchar*Respond,int*rlen)参数：BSTInterval－BST间隔，单位毫秒，范围1-10ms；RetryInterval－交易重试间隔，单位毫秒，范围1-10ms；TxPower－RSU发射功率设置，取值范围为0～31，0：关闭天线，31：最大功率；PLLChannelID－信道号，范围0-1Respond—OBU返回数据rlen—OBU返回数据长度返回：0－成功，非0－失败6.发送BST函数：DHETCDSRCbst(unsignedchar*Command,intlen,unsignedchar*Respond,int*rlen,intNoRespond)参数：Command－BST数据串,从段字头0x91开始，例如91C005D100004933B58800010100；len－BST数据串长度；Respond－OBU返回数据rlen－OBU返回数据长度NoRespond－0需等待OBU应答非0无需等待OBU应答返回：0－成功，非0－失败7.DSRC交易函数：DHETCDSRC(unsignedchar*Command,intlen,unsignedchar*Respond,int*rlen,intNoRespond)参数：Command－DSRC命令数据串,从段字头0x91开始，例如910401041A00；len－命令数据串长度；Respond－OBU返回数据rlen－OBU返回数据长度NoRespond－0需等待OBU应答非0无需等待OBU应答上海东海电脑股份有限公司-10-东海电子收费专用短程通信便携式ETC处理终端开发手册返回：0－成功，非0－失败8.PSAM通道复位函数：DHETCResetPSAM()参数：无参数返回：0－成功，非0－失败9.添加PSAM通道命令函数：DHETCAddPSAMCommand(unsignedchar*cmd,intcmdlen)参数：cmd－PSAMAPDU命令，例如“\x00\x84\x00\x00\x04”cmdlen－PSAMAPDU命令长度返回：0－成功，非0－失败10.PSAM通道命令列表处理函数：DHETCPSAMChannel(intPSAMSlot)参数：PSAMSlot－PSAMSlot号，0～2返回：0－成功，非0－失败11.从第一条开始依次取出PSAM处理结果函数：DHETCPopPSAMRespond(unsignedchar*buf,int&rlen)参数：buf－PSAM返回的处理结果rlen－处理结果长度返回：0－成功，非0－失败注：每发一次DHETCPopPSAMRespond指令，按顺序返回对应的DHETCAddPSAMCommand发出的指令执行结果3.2.2非接触IC卡读写库函数1.打开非接触IC卡读写器函数：DHOpenReader();上海东海电脑股份有限公司-11-东海电子收费专用短程通信便携式ETC处理终端开发手册参数：无返回：0－成功，非0－失败2.关闭非接触IC卡读写器函数：DHCloseReader();参数