基于第三方开源库的OPC服务器开发指南(4)——后记:与另一个开源库opc workshop库相关的问题
平心而论,我们从样例服务器的代码可以看出,利用LightOPC库开发OPC服务器还是比较啰嗦的,网上有人提出opc workshop库就简单很多,我千辛万苦终于找到一个05年版本的workshop库源码,忘了出处是在哪里了,依稀记得是Codeforge网站。相较于LightOPC,用这个库开发OPC服务器确实简单了很多,其对核心业务逻辑做了高度封装,使得服务器的开发流程非常清晰,这一点值得赞扬。但遗憾的是,完美的事情在这个世界上根本就不存在,经过实测,我手头上拥有的版本存在三个严重问题:
1、利用该库开发的OPC服务器无法由OPC客户端远程启动;
2、通过标准接口ValidateItems()无法获取指定变量的数据类型;
3、提供的样例服务器主处理逻辑存在重复注册的BUG,没有把服务器注册和处理逻辑分开;
好在已经有了LightOPC这碗酒垫底,这几个问题都不是问题。我的方法简单粗暴——直接上手改源码。对于第一个问题,通过分析源码发现,导致该问题的原因是注册函数在获取模块文件工作路径时,接收缓冲区的首地址错误导致的:
1 int COPCServerObject::RegisterServer() 2 { 3 char np[FILENAME_MAX + 32]; 4 printf("Registering"); 5 GetModuleFileName(NULL, np + 1, sizeof(np) - 8); 6 7 return ServerRegister(&CLSID_OPCServerEXE, 8 OPCServerProgID, 9 "OPCServer (c) Alexey Obukhov", np, 0); 10 }
出问题的这个注册函数在OPCServerObject.cpp文件中,不知道是什么原因让作者在获取进程工作路径时将缓冲区首地址后移了一个字节,即:
1 GetModuleFileName(NULL, np + 1, sizeof(np) - 8);
至今我没参透为何要“np + 1”。事实证明,把后面加的那个“1”去掉后,服后务器不仅可以远程启动了且工作也完全正常。看来这件事需要作者本人亲自解释这到底是为什么了,咱们只要能用就行了。
第2个问题更加匪夷所思,作者提供的“ValidateItems()”接口函数竟然缺少了关键的对变量类型的赋值语句:
1 STDMETHOD(ValidateItems)( /*[in]*/ DWORD dwCount, 2 /*[in, size_is(dwCount)]*/ OPCITEMDEF * pItemArray, 3 /*[in]*/ BOOL bBlobUpdate, 4 /*[out, size_is(,dwCount)]*/ OPCITEMRESULT ** ppValidationResults, 5 /*[out, size_is(,dwCount)]*/ HRESULT ** ppErrors ) 6 { 7 DWORD i; 8 HRESULT res = S_OK; 9 OPC_GROUP_CHECK_DELETED(); 10 11 VALIDATE_ARGUMENT(pItemArray); 12 VALIDATE_ARGUMENT(ppValidationResults); 13 VALIDATE_ARGUMENT(ppErrors); 14 15 *ppValidationResults = allocate_buffer<OPCITEMRESULT> ( dwCount ); 16 *ppErrors = allocate_buffer<HRESULT> ( dwCount ); 17 18 // TODO 19 for( i=0;i<dwCount; ++i) { 20 OPCHANDLE hServer = g_NameIndex[ CString(pItemArray[i].szItemID) ]; 21 CBrowseItemsList::iterator browseIT = g_BrowseItems.find( hServer ); 22 if( browseIT == g_BrowseItems.end() ) { 23 (*ppErrors)[i] = OPC_E_UNKNOWNITEMID; 24 res = S_FALSE; 25 } 26 } 27 // TODO 28 29 return res; 30 }
上述函数在IOPCItemMgtImpl.h源文件中可以找到。其中入口参数“ppValidationResults”即被用于获取指定变量的相关信息。但奇怪的是,在这个函数里作者只是对这个变量分配了一块内存,接下来的代码并没有对其赋值。如果说我到手的源码并不完整的话,那么为何解决上述几个问题后,OPC服务器竟然工作正常,没有任何问题?要不说这个问题很是匪夷所思呢。既然咱们有源码,这个事完全可以自己解决,在这个函数增加几行代码:
1 STDMETHOD(ValidateItems)( /*[in]*/ DWORD dwCount, 2 /*[in, size_is(dwCount)]*/ OPCITEMDEF * pItemArray, 3 /*[in]*/ BOOL bBlobUpdate, 4 /*[out, size_is(,dwCount)]*/ OPCITEMRESULT ** ppValidationResults, 5 /*[out, size_is(,dwCount)]*/ HRESULT ** ppErrors ) 6 { 7 DWORD i; 8 HRESULT res = S_OK; 9 OPC_GROUP_CHECK_DELETED(); 10 11 VALIDATE_ARGUMENT(pItemArray); 12 VALIDATE_ARGUMENT(ppValidationResults); 13 VALIDATE_ARGUMENT(ppErrors); 14 15 *ppValidationResults = allocate_buffer<OPCITEMRESULT> ( dwCount ); 16 *ppErrors = allocate_buffer<HRESULT> ( dwCount ); 17 18 /// TODO 19 for( i=0;i<dwCount; ++i) { 20 OPCHANDLE hServer = g_NameIndex[ CString(pItemArray[i].szItemID) ]; 21 CBrowseItemsList::iterator browseIT = g_BrowseItems.find( hServer ); 22 if( browseIT == g_BrowseItems.end() ) { 23 (*ppErrors)[i] = OPC_E_UNKNOWNITEMID; 24 res = S_FALSE; 25 } 26 else 27 { 28 (*ppValidationResults)->vtCanonicalDataType = browseIT->type; 29 break; 30 } 31 } 32 // TODO 33 34 return res; 35 }
连花括号都算着其实就增加了4行代码。只是对参数“ppValidationResults”的数据类型成员“vtCanonicalDataType”进行了赋值。如此一来,“ValidateItems()”接口即可满足我们的要求了。
第3个问题就简单多了,直接修改样例服务器的“main()”函数把注册和主处理逻辑分开就可以了:
1 int _tmain(int argc, _TCHAR* argv[]) 2 { 3 FILE *pfFile; 4 5 AllocConsole(); 6 freopen_s(&pfFile,"conout$","w+",stdout); //打䨰开a控?制?台¬¡§ 7 8 if(argc > 2) 9 { 10 printf("Usage:%s", argv[0]); 11 printf(" %s /r", argv[0]); 12 printf(" %s /u", argv[0]); 13 printf(" : start opc server\r\n"); 14 printf("/r: regist opc server\r\n"); 15 printf("/u: unregist opc server\r\n"); 16 17 fclose(pfFile); 18 FreeConsole(); 19 20 return -1; 21 } 22 23 char str[1024] = {0}; 24 25 HRESULT hr = CoInitializeEx(NULL, COINIT_MULTITHREADED); 26 27 // define server object 28 COPCServerObject server; 29 // define data event receiver 30 dataReceiver receiver; 31 32 // set server name and clsid 33 server.setServerProgID( _T("OPC.myTestServer") ); 34 server.setServerCLSID( CLSID_OPCServerEXE ); 35 36 // set delimeter for params name 37 server.SetDelimeter( "." ); 38 39 if(argc == 2) 40 { 41 if(strstr(argv[1], "/r")) 42 { 43 // register server as COM/DCOM object 44 server.RegisterServer(); 45 46 fclose(pfFile); 47 FreeConsole(); 48 49 return 0; 50 } 51 else if(strstr(argv[1], "/u")) 52 { 53 server.UnregisterServer(); 54 55 getchar(); 56 57 fclose(pfFile); 58 FreeConsole(); 59 60 return 0; 61 } 62 } 63 64 65 // define server values tree 66 server.AddTag("Values.int1", VT_I4 ); 67 server.AddTag("Values.int2", VT_I4 ); 68 server.AddTag("Values.fltArray2", VT_ARRAY|VT_R4 ); 69 server.AddTag("Values.fltArray2.In", VT_I4, false ); 70 71 { 72 CAG_Clocker cl("Create 10000 tags",false); 73 74 for(int i=0;i<10000;++i) { 75 sprintf(str,"RandomValues.int%d",i+1); 76 server.AddTag( str ,VT_I4 ); 77 } 78 } 79 80 // setup object will be received add values change 81 server.setDataReceiver( &receiver ); 82 83 // create COM class factory and register it 84 server.StartServer(); 85 86 printf("\t waiting return\n"); 87 gets(str); // 等待用户任意输入,比如按个回车键,服务器才会继续执行 88 89 // write initial values to OPC params 90 for( double x =0.; x< 50.;x+=.1 ) { 91 server.WriteValue( "Values.int1", FILETIME_NULL, 192, CComVariant( sin(x) ) ); 92 server.WriteValue( "Values.int2", FILETIME_NULL, 192, CComVariant( cos(x) ) ); 93 Sleep(100); 94 } 95 96 srand( (unsigned)time( NULL ) ); 97 98 for(int i=0;i<10000;++i) { 99 sprintf(str,"RandomValues.int%d",i+1); 100 server.WriteValue( str , FILETIME_NULL, 192, CComVariant( rand() ) ); 101 } 102 103 printf("\t waiting return for close server \n"); 104 gets(str); // 同样是等待用户在控制台的任意输入,服务器结束服务 105 106 server.StopServer(); 107 108 109 CoUninitialize(); 110 111 fclose(pfFile); 112 FreeConsole(); 113 114 return 0; 115 } 116 117
其实解决方案就是通过控制台输入参数来区分进程启动后进入注册流程还是处理流程,同时为了调试方便,并能够让我看到客户端远程启动服务器的实际效果,我还为服务器分配了一个输出控制台(缺省情况下OPC后台启动是看不到交互窗口的),这样服务器一旦被客户端启动,输出控制台将在远程机器上弹出,我们就可以看到服务器输出的调试信息了,是不是很酷!至此三个问题解决,workshop库的样例服务器可以正常工作了。
最后,已经调整完且测试通过的workshop库VS2010的源码工程还是在我的github仓库获取: