MCGS嵌入版设备驱动开发文档

1、嵌入版设备驱动文档一驱动开发MCG嵌入版设备驱动开发文档一、MCG嵌入版这是指我们的嵌入版组态软件，他的组态环境与通用版一样，也是运行于通用PC的Windows （95，98, Me,2000）操作系统上的软件。但是，他的运行环境是运行于嵌入式操作 系统（如 Window CE.net ）上的软件。二、嵌入式设备驱动用C+（ VC&EVC编写的，供嵌入版组态软件调用的动态连接库。使用它的目的是为了 控制外部设备。即主程序通过调用动态连接库（嵌入式驱动程序）来与外部设备（硬件）通讯。这些驱动程序通常是操作嵌入式系统的串口，网口等各种I/O端口。三、嵌入式驱动的接口函数。在这里，我们用标准

2、的动态连接库的输出函数来实现需要的各种功能。动态连接库（驱动程序）中对外接口函数共有15个，编制驱动主要工作是编制各个函数，函数由主程序调用，不同的驱动在函数内部处理也不同。I, SvrGetProperty2,SvrSetProperty 3,SvrCollectDevData 4,SvrGetCha nnel 5,SvrDoHelp6,SvrEditCustomProperty 7,SvrEditProperties 8,SvrE nu mPropertyValue9,SvrExitDevRun 10,SvrGetDevI nfoII, SvrI ni tDevRun 12,SvrI ni

3、 tDevSet 13,SvrDevIOCtrl 14,SvrSetRu nIDispatch 15,SvrSetSetIDispatch函数的功能：1. MCGS_DLL_FUNC SvrGetProperty（MCGS_DATA & data,CStri ngArra y& strPropertyName, CStri ngArra y& strPropertyValue, CArray<bool,bool> & bPropertyHasValueArray）/函数功能：设置设备属性列表/函数返回：TRUE固定/参数意义：dataMCGS传过来的

4、MCGS_DAT结构的指针/strPropertyName设备属性的名称的数组/strPropertyValue/设备属性的当前值的数组/bPropertyHasValueArrayIIIIII表则可以获取取值列表III大小必须一致III 备 注：如图所示：指定设备属性是否具有取值列表的数组，true表示有，false 表示没有。如果具有取值列调用时，三个数组大小都为0,返回时，三个数组北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发函数主要是设置属性页中最小采样周期以后的设备属性名(strPropertyName)、设备属性初始值(strPropertyValue )，和是否有

5、下拉框(bPropertyHasValueArray )。设置 下拉菜单用 SvrEnumPropertyValue()函数。2. MCGS_DLL_FUNC SvrSetProperty(MCGS_DATA & data, CStri ngArra y& strPropertyName,CStri ngArra y& strPropertyValue)III 函数功能：获取设备属性列表的下拉框内容，把值写到data中去III函数返回：TRUE 固定III参数意义：dataIIIstrPropertyNameIIIstrPropertyValueIII备注：MCGS传过

6、来的MCGS_DAT结构的指针 设备属性的名称的数组设备属性的值的数组函数功能：获取设备属性列表，主程序在调通道连接和设备调试属性页之前运行，系统 获取基本属性页中的数据。必须保存。3. MCGS_DLL_FUNSVrCollectDevData(MCGS_DATA & data, CArray<i nt,i nt> & collectFlag,CArray<double,double >& valueArray, CStri ngArra y& strValueArray)III函数功能：主采集函数用于采集数据III函数返回：0,正确。

7、-100,错误。III参数意义：dataMCGS传过来的MCGS_DAT结构的指针IIIcollectFlag用于标志设备通道是否需要操作的数组IIIvalueArray用于返回设备通道的数值型数据的数组IIIstrValueArray用于返回设备通道的字符串型数据的数组III备注：在这里调用CDevBas中的mfcollectDevData函数进仃实际的数据采集操作函数功能：采集数据显示到各个通道中。除了板卡设备外，第 0通道为通讯状态通道(0表示正常，1表示不正常)。读数据成功时，通道0值赋0,函数返回0,读数据不成功时通道 0值赋1,函数返回-100。4. MCGS_DLL_FUNSvr

8、GetCha nn el(MCGS_DATA & data, CStri ngArra y&strCha nn elName,INTARRA Y& tyCha nn elType)设置通道个数，各个通道的名字和类型III参数意义：dataIIIstrCha nn elNameIIIstrPropertyValueIII备注：III 函数功能III 函数返回TRUE固定MCGS传过来的MCGS_DAT结构的指针设备通道的名称的数组设备通道的数据类型的数组函数功能：设置通道个数。数组strChannelName中设置名称，数组 tyChannelType中设置类型。+1表示

9、只读或读写开关型,+2表示只读或读写数值型，+3表示只读或读写字符型，-1表示只写开关型，-2表示只写数值型，-3表示只写字符型。如图，画面上显示11个通道。设备属牲设背：-设备町基本属性迺逾|彗设备调试|数据处理通道对应数据对象通道类型周期上J快速连接o |通讯状态痕1拷贝连按| 1XIRO.O1 J2读 IR(L11删除连接3ilR0.21 1|4IIRQ.31屋頊回追5IIRO.41册1除i甬i首6读 IRQ. 511读 IR0.618IIRO.719iDMWDOIQ读DMWD1J检查凶确认M |取消K3 |帮助(H)5. MCGS_DLL_FUNC SvrDoHelp(CStri ng

10、& strFileName, Io ng& In gID)/函数功能：弹出在线帮助/函数返回：TRUE 固定/参数意义：strFileName帮助文件名/ln gID帮助ID号/备注：在基本属性页中弹出在线帮助，如图:在基本属性页中，单击“查看设备在线帮助时”，系统调用本函数。在函数中共2个参数，第一个参数返回帮助文件名，第二个参数返回帮助ID号，帮助ID号由设备组组长在分析中指定。6. MCGS_DLL_FUNC SvrEditCustomProperty(MCGS_DATA & data)/函数功能：编辑客户自定义属性，调用DEV的内部属性页，在这里删除和添加通道/

11、函数返回：TRUE 固定/参数意义：dataMCGS传过来的MCGS_DAT结构的指针/备注：7. MCGS_DLL_FUNSVrEditProperties(MCGS_DATA& data, bool& bDefaultPeopertyDialog, CStri ng& strName, CStri ng& strComme nt, Io ng& DevCltTime, lo ng& DevCha nn elNum, long& DevWorkFlag,CStri ngArray*strCha nn elVarName,CArray&l

12、t;i nt,i nt>*iCha nn elType)/函数功能：编辑客户自定义属性，调用DEV的内部属性页/函数返回：TRUE 固定/参数意义：dataMCGS传过来的MCGS_DAT结构的指针/bDefaultPeopertyDialog= false, 使用自定义属性对话框进行编辑/strName设备名称/strComme nt设备注释/DevCltTime最小采集周期/DevCha nn elNum通道数量/DevWorkFlag初始工作状态/strCha nn elVarName通道所连接的数据对象名数组/iCha nn elType通道的数据类型/备注：& MCGS

13、_DLL_FUNC SvrE nu mPropertyValue(MCGS_DATA & data, CStri ng& strPropertyName, CStri ngArra y& strPropertyValue)/函数功能：设置设备属性列表的下拉框内容/函数返回：TRUE 固定/参数意义：dataMCGS传过来的MCGS_DAT结构的指针/strPropertyName设备属性的名称/strPropertyValue设备属性的值的数组，在这个数组中返回设备属性列表的下拉框内容/ 备 注：9. MCGS_DLL_FUNC SvrExitDevRu n(MCGS_

14、DATA & data)/函数功能：退出设备采/函数返回：TRUE 固定/参数意义：dataMCGS传过来的MCGS_DAT结构的指针/strCha nn elName设备通道的名称的数组/strPropertyValue设备通道的数据类型的数组/备注：10.MCGS_DLL_FUNSVrGetDevInfo(CString&strName, DEVTYPE&evType, DEVSTYLE&devStyle, MCGS_RUNTIME_TYPE cType, CStri ng& strDllName)/函数功能：获取设备驱动的名称等信息/函数返回：TR

15、UE 固定/参数意义：strName设备的名称/DEVTYPE设备类型子设备/devStyle设备类别串口设备/cType运行类别/strDllName运行时调用驱动的名称/备注：一般来说此函数可以不用修改，可用于任何设备11.MCGS_DLL_FUNC SvrI ni tDevRu n(MCGS_DATA & data)/ 函数功能：在本函数中，从 Mcgs_Data中回复出DEV_DATA中的数据来北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发MCG传过来的MCGS_DAT结构的指针12.MCGS_DLL_FUNC SvrIni tDevSet(MCGS_DATA

16、& data)/函数功能：初次创建设备时调用本函数/函数返回：TRUE 固定/参数意义：dataMCG传过来的MCGS_DAT结构的指针/备注：III函数返回：TRUE固定/ 参数意义：dataIII备 注：13.CStri ng&strCmd,/函数功能：此函数实现命令功能，所有的命令操作都在这里进行/函数返回：0,正确。2,设备命令无效。/参数意义：dataMCG传过来的MCGS_DAT结构的指针/strCmdMCG传过来的命令字符串/valueArray用于返回设备通道的数值型数据的数组/strValueArray用于返回设备通道的字符串型数据的数组/备注：在这里对写命令

17、解码，后调用CDevBas中的mfWriteChannel数进行实际的写操作函MCGS_DLL_FUNC SvrDevlOCtrl(MCGS_DATA&data,CArray<double,double >& valueArray, CStri ngArra y& strValueArray)14. MCGS_DLL_FUNC SvrSetRu nlDispatch(LPDISPATC H& lpDispatch)15. MCGS_DLL_FUNC SvrSetSetlDispatch(LPDISPATC H& lpDispatch)四、嵌入

18、式数据保存直接调用 CDevBas:mfSaveDevData(data);函数就可以了。五、编辑客户自定义属性，如图：设备屋性设置：一设备0基本属性 通道连接|设备调试|数据处理|北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发检查lig礦认(X)取消国1帮助凹北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发北京昆仑通态自动化软件科技有限公司嵌入版设备驱动文档一驱动开发当单击"设置内部属性”时，系统会调用函数SvrEditCustomProperty (),弹出一个自定义的对话框，如下图：欧期

19、龙HoLinkjl道屋性设置序号卩LC通道谏写类型A01只读P"数据创02只读P"数据删除一个03IR0.2只读P"数据04IR0.3只馔P"数据全部删除05IR0.4只谀PLC数据06IR0.S只读P"数据索引拷贝07IR0.6只读P"数据08rR0.7只读卩"数据09DMUDB只读P"数据10DI1UD1只谀F5数据11DMUD2只读P"数据12DMUD3只读P"数据13DMUD4只读PLC数据1UDMUDS只读P"数据喪认皿J 取消帮助KJ不同的设备上述对话框，样式可能不同，上述对话框显示的是PLC设备常用的对话框，某些简单的设备通道是固定的，前面的提到的个函数 SvrEditCustomProperty 可以不用，直DevDef.