最近在做摄像机ONVIF的协议,看了几天文档调了点代码和大家分享下,下步准备实现RTSP的流地址的获取。
附件里面是我的完整代码工程,使用的是arm-linux-gcc,代码也可以在X86的Linux上跑,只要将Makefile里面额CC=arm-linux-gcc换成gcc即可
工作平台及工具:
Ubuntu:12.04 + arm-linux-gcc/gcc + OnvifTestTool12.12
gsoap下载:
http://www.cs.fsu.edu/~engelen/soap.html
目前的最新版本为:gsoap2.8.21
1.搞定工具:
首先需要做的是提取工具一共有3样:
soapcpp2 wsdl2h typemap.dat
我下载的的gsoap里面的typemap.dat已经包含了WS-Discovery的支持因此不需要再像网上那样去添加ONVIF支持了
下载好的源码解压出来,到gsoap-2.8/gsoap/bin目录里面一看,没有我们需要的soapcpp2 wsdl2h:
没有我们只好自己编译一个了,看了下他的README.txt里面有这么一句话(PS:我比较喜欢看项目里面的README能帮助我们解决很多问题).
For other platforms: see installation instructions INSTALL.txt in the root dir.
到根目录里面看下INSTALL.txt知道了怎么编译了
cd gsoap/src
make -f MakefileManual
cd gsoap/wsdl
make -f MakefileManual
2. Remotediscovery.wsdl产生onvif.h头文件
对于这里我们只要实现设备发现的功能,所以我们只需要Remotediscovery.wsdl这一个wsdl就可以了
./wsdl2h -o onvif.h -c -s -k -t ./typemap.dat
http://www.onvif.org/onvif/ver10 ... emotediscovery.wsdl
生成的时候会报SOAP_ENV__Fault
重定义的错误,将gsoap-2.8/gsoap/import/wsa5.h里面的第277行的SOAP_ENV__Fault改为SOAP_ENV__Fault_ex就可以了
3.生成ONVIF的框架代码
./soapcpp2 -c onvif.h -x -d ./ -I ${HOME}/workspace/source/gsoap-2.8/gsoap/import -I ${HOME}/workspace/source/gsoap-2.8/gsoap/
这里的${HOME}/workspace/source/gsoap-2.8/gsoap/import 和${HOME}/workspace/source/gsoap-2.8/gsoap/注意修成自己的。
这里会报
4.拷贝相关代码
建立一个onvif_test的目录将${HOME}/workspace/source/gsoap-2.8如下文件拷贝过来过来
gsoap/dom.c
gsoap/stdsoap2.c
gsoap/stdsoap2.h
gsoap/custom/duration.c
gsoap/plugin/mecevp.c
gsoap/plugin/mecevp.h
gsoap/plugin/smdevp.c
gsoap/plugin/smdevp.h
gsoap/plugin/threads.c
gsoap/plugin/threads.h
gsoap/plugin/wsaapi.c
gsoap/plugin/wsaapi.h
gsoap/plugin/wsseapi.c
gsoap/plugin/wsseapi.h
gsoap/plugin/wsddapi.c
gsoap/plugin/ wsddapi.h
这些代码会帮我很多工作的,下面就知道了
5.实现关键代码
- soap_wsdd_mode wsdd_event_Probe(struct soap *soap, const char *MessageID, const char *ReplyTo, const char *Types, const char *Scopes, const char *MatchBy, struct wsdd__ProbeMatchesType *matches)
- {
- #if 0
- printf("%s,%d\n",__FUNCTION__, __LINE__);
- printf("MessageID:%s\n", MessageID);
- printf("ReplyTo:%s\n", ReplyTo);
- printf("Types:%s\n", Types);
- printf("Scopes:%s\n", Scopes);
- printf("MatchBy:%s\n", MatchBy);
- #endif
- soap_wsdd_init_ProbeMatches(soap, matches);
- soap_wsdd_add_ProbeMatch(soap, matches,
- "urn:uuid:464A4854-4656-5242-4530-313035394100",
- "tdn:NetworkVideoTransmitter",
- "onvif://www.onvif.org/type/video_encoder onvif://www.onvif.org/type/audio_encoder onvif://www.onvif.org/type/ptz onvif://www.onvif.org/type/video_analytics onvif://www.onvif.org/hardware/HD-IPCAM onvif://www.onvif.org/location/country/china onvif://www.onvif.org/name/IPCAM",
- NULL,
- "http://192.168.1.22/onvif/device_service",10);
- return SOAP_WSDD_MANAGED;
-
- }
复制代码
这个就是回应设备发现工具的主要代码,是不是很简单如果不适用wsddapi.c 里面的代码将要写一大推的填充代码具体,具体可以看最后面的参考链接。
6.实现的main函数
-
- #include "soapH.h"
- #include "wsdd.nsmap"
- #include "wsddapi.h"
- #include <stdio.h>
- #include <sys/types.h> /* See NOTES */
- #include <sys/socket.h>
- #include <unistd.h>
- #include <errno.h>
- int main(int argc, char* argv[])
- {
- int m, s;
- struct ip_mreq mcast;
- struct soap soap;
- soap_init2(&soap, SOAP_IO_UDP | SOAP_IO_FLUSH, SOAP_IO_UDP|SOAP_IO_FLUSH);
- soap_set_namespaces(&soap, namespaces);
- soap_set_mode(&soap, SOAP_C_UTFSTRING);
- soap.bind_flags = SO_REUSEADDR;
- soap.connect_timeout = 0;
- soap.recv_timeout = 0;
- soap.send_timeout = 0;
- soap_register_plugin(&soap, soap_wsa); //这个很重要,我分析了很久才得出的
- // 打开调试信息
- soap_set_recv_logfile(&soap, "./log/recv.xml");
- soap_set_sent_logfile(&soap, "./log/send.xml");
- soap_set_test_logfile(&soap, "./log/test.log");
- if(!soap_valid_socket(soap_bind(&soap, NULL, 3702, 16)))
- {
- soap_print_fault(&soap, stderr);
- exit(1);
- }
- mcast.imr_multiaddr.s_addr = inet_addr("239.255.255.250");
- mcast.imr_interface.s_addr = inet_addr("0.0.0.0");
- if(setsockopt(soap.master, IPPROTO_IP, IP_ADD_MEMBERSHIP, (char*)&mcast, sizeof(mcast)) < 0) {
- printf("setsockopt error!\n");
- return 0;
- }
- //成功绑定之后,便开始监听
- for (;;) {
- //监听直到有连接请求
- soap_wsdd_listen(&soap, 0);
- soap_destroy(&soap);
- soap_end(&soap);
- fprintf(stderr, "Socket connection successful: slave socket = %d\n", s);
- }
- soap_done(&soap);
- return 0;
- }
-
复制代码
整体的主函数就是这样,需要注意的一点是需要在wsdd.nsmap里多添加一个命名空间
{"tds", "http://www.onvif.org/ver10/device/wsdl", NULL, NULL},
7.测试结果
消息格式:
-
- <?xml version="1.0" encoding="UTF-8"?>
- <SOAP-ENV:Envelope
- xmlns:SOAP-ENV="http://www.w3.org/2003/05/soap-envelope"
- xmlns:SOAP-ENC="http://www.w3.org/2003/05/soap-encoding" x
- mlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xmlns:xsd="http://www.w3.org/2001/XMLSchema"
- xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/08/addressing"
- xmlns:wsdd="http://schemas.xmlsoap.org/ws/2005/04/discovery"
- xmlns:tdn="http://www.onvif.org/ver10/network/wsdl"
- xmlns:tds="http://www.onvif.org/ver10/device/wsdl">
- <SOAP-ENV:Header>
- <wsa:MessageID>urn:uuid:54a3c06c-96c8-47ca-b4b0-dc5119495cff</wsa:MessageID>
- <wsa:RelatesTo>uuid:5e054455-4d8e-4060-8ef8-e1cb9bfd7940</wsa:RelatesTo>
- <wsa:To SOAP-ENV:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</wsa:To>
- <wsa:Action SOAP-ENV:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2005/04/discovery/ProbeMatches</wsa:Action>
- <wsdd:AppSequence MessageNumber="3" InstanceId="0"></wsdd:AppSequence>
- </SOAP-ENV:Header><SOAP-ENV:Body>
- <wsdd:ProbeMatches>
- <wsdd:ProbeMatch>
- <wsa:EndpointReference>
- <wsa:Address>urn:uuid:464A4854-4656-5242-4530-313035394100</wsa:Address>
- </wsa:EndpointReference>
- <wsdd:Types>tdn:NetworkVideoTransmitter</wsdd:Types>
- <wsdd:Scopes>onvif://www.onvif.org/type/video_encoder onvif://www.onvif.org/type/audio_encoder onvif://www.onvif.org/type/ptz onvif://www.onvif.org/type/video_analytics onvif://www.onvif.org/hardware/HD-IPCAM .. onvif://www.onvif.org/location/country/china onvif://www.onvif.org/name/IPCAM</wsdd:Scopes>
- <wsdd:XAddrs>http://192.168.1.230/onvif/device_service</wsdd:XAddrs>
- <wsdd:MetadataVersion>10</wsdd:MetadataVersion>
- </wsdd:ProbeMatch>
- </wsdd:ProbeMatches>
- </SOAP-ENV:Body>
- </SOAP-ENV:Envelope>
-
复制代码
8.过程总结
ONVIF这个设备发现的实现耗费了我好几天近去调试和阅读相关文档,虽然网上有很多的资料可供参考,但是真正去理解所有的东西还是要花上一些功夫的
如xml的命名空间,gsoap的消息格式和wsdl等,这些东西还是很耗费时间的,尤其是调试出问题后怎么去解决问题。
PC端抓包收到了,但是还是发现不了设备?
可能出现的问题1:
"tdn:NetworkVideoTransmitter"填的不对他的前缀不是随便填的是和命名空间相关的
可能出现的问题2:
wsa:RelatesTo这个字段没有,这个没有的原因是因为我们使用到了 int soap_wsa_reply(struct soap *soap, const char *id, const char *action) 函数
而这个函数里面里面有这些代码
struct soap_wsa_data *data = (struct soap_wsa_data*)soap_lookup_plugin(soap, soap_wsa_id);
struct SOAP_ENV__Header *oldheader, *newheader;
DBGFUN1("soap_wsa_reply", "action=%s", action?action:"(null)");
if (!data) // 这里总是返回0
return soap->error = SOAP_PLUGIN_ERROR;
网上收到了一些做法是将
if (!data) return soap->error = SOAP_PLUGIN_ERROR;
向后移一移解决的,填充了wsa:RelatesTo再判断,我觉得问题不是这么来的,最终我调试和血毒代码后,加上了 soap_register_plugin(&soap, soap_wsa);
完美解决,同时知道了为什么这么做,这很重要。见gsoap-2.8/gsoap/doc/wsa里面的文档
参考链接:
http://blog.csdn.net/ghostyu/article/details/8182516
http://www.360doc.com/content/14/0828/15/9075092_405360193.shtml
四层协议、
【from:http://www.ebaina.com/bbs/thread-4929-1-1.html】