ONVIF学习【3】——自发现功能实现(Discovery)

  server端Discovery实现,通过OnvifTestTool12.06测试

1. 在使用wsdl2h产生头文件前需要修改typemap.dat

  修改的依据在这里:http://www.cs.fsu.edu/~engelen/soap.html,在FAQ页面下的How do I use gSOAP for the ONVIF specifications?

#Use gSOAP 2.8.10 and up. In the typemap.dat file used by wsdl2h, add:  
#   ONVIF recommended prefixes  
tds = "http://www.onvif.org/ver10/device/wsdl"  
tev = "http://www.onvif.org/ver10/events/wsdl"  
tls = "http://www.onvif.org/ver10/display/wsdl"  
tmd = "http://www.onvif.org/ver10/deviceIO/wsdl"  
timg    = "http://www.onvif.org/ver20/imaging/wsdl"  
trt = "http://www.onvif.org/ver10/media/wsdl"  
tptz    = "http://www.onvif.org/ver20/ptz/wsdl"  
trv = "http://www.onvif.org/ver10/receiver/wsdl"  
trc = "http://www.onvif.org/ver10/recording/wsdl"  
tse = "http://www.onvif.org/ver10/search/wsdl"  
trp = "http://www.onvif.org/ver10/replay/wsdl"  
tan = "http://www.onvif.org/ver20/analytics/wsdl"  
tad = "http://www.onvif.org/ver10/analyticsdevice/wsdl"  
tdn = "http://www.onvif.org/ver10/network/wsdl"  
tt  = "http://www.onvif.org/ver10/schema"  
#   OASIS recommended prefixes  
wsnt    = "http://docs.oasis-open.org/wsn/b-2"  
wsntw   = "http://docs.oasis-open.org/wsn/bw-2"  
wsrfbf  = "http://docs.oasis-open.org/wsrf/bf-2"  
wsrfr   = "http://docs.oasis-open.org/wsrf/r-2"  
wsrfrw  = "http://docs.oasis-open.org/wsrf/rw-2"  
wstop   = "http://docs.oasis-open.org/wsn/t-1"  
#   WS-Discovery 1.0 remapping  
wsdd10__HelloType       = | wsdd__HelloType  
wsdd10__ByeType         = | wsdd__ByeType  
wsdd10__ProbeType       = | wsdd__ProbeType  
wsdd10__ProbeMatchesType    = | wsdd__ProbeMatchesType  
wsdd10__ProbeMatchType      = | wsdd__ProbeMatchType  
wsdd10__ResolveType     = | wsdd__ResolveType  
wsdd10__ResolveMatchesType  = | wsdd__ResolveMatchesType  
wsdd10__ResolveMatchType    = | wsdd__ResolveMatchType  
#   SOAP-ENV mapping  
SOAP_ENV__Envelope  = struct SOAP_ENV__Envelope { struct SOAP_ENV__Header *SOAP_ENV__Header; _XML SOAP_ENV__Body; }; | struct SOAP_ENV__Envelope  
SOAP_ENV__Header    = | struct SOAP_ENV__Header  
SOAP_ENV__Fault     = | struct SOAP_ENV__Fault  
SOAP_ENV__Detail    = | struct SOAP_ENV__Detail  
SOAP_ENV__Code      = | struct SOAP_ENV__Code  
SOAP_ENV__Subcode   = | struct SOAP_ENV__Subcode  
SOAP_ENV__Reason    = | struct SOAP_ENV__Reason  

2. 根据onvif官网提供的remotediscovery.wsdl产生onvif.h头文件

  关于onvif所有的wsdl都在这里:http://www.onvif.org/Documents/Specifications.aspx中的ONVIF WSDL and XML Schemas Specifications一节,虽然可以全部下载为wsdl文件,但是wsdl文件中存在相互依赖的关系,并且是带有存储的依赖,所以最好直接使用url来产生头文件,不要下载下来。

wsdl2h -o onvif.h -c -s -t ./typemap.dat http://www.onvif.org/onvif/ver10/network/wsdl/remotediscovery.wsdl  

3. 使用onvif.h来产生骨架代码

soapcpp2 -c onvif.h -x -I /root/onvif/gsoap-2.8/gsoap/import -I /root/onvif/gsoap-2.8/gsoap/  

4. ProbeMatches代码

  这样就创建了基本的服务端和客户端的代码了,下面需要添加具体的代码了。其中包括:

  1. 创建组播用的udp socket,绑定组播地址为239.255.255.250,端口为3702,因为ws-discovery的组播地址和端口就是为239.255.255.250和3702
  2. 在产生的Probe函数中添加ProbeMatches代码

  首先是udp socket

int bind_server_udp1(int server_s)  
{  
    struct sockaddr_in local_addr;  
    memset(&local_addr,0,sizeof(local_addr));  
    local_addr.sin_family = AF_INET;  
    local_addr.sin_addr.s_addr = htonl(INADDR_ANY);  
    local_addr.sin_port = htons(3702);  
    return bind(server_s,(struct sockaddr*)&local_addr,sizeof(local_addr));  
  
}  
static int create_server_socket_udp(void)  
{  
    int server_udp;  
    unsigned char one = 1;  
    int sock_opt = 1;  
      
    //server_udp = socket(PF_INET, SOCK_DGRAM, 0);  
    server_udp = socket(PF_INET, SOCK_DGRAM, IPPROTO_UDP);  
    if (server_udp == -1) {  
        printf("unable to create socket\n");  
    }  
  
    /* reuse socket addr */  
    if ((setsockopt(server_udp, SOL_SOCKET, SO_REUSEADDR, (void *) &sock_opt,  
                    sizeof (sock_opt))) == -1) {  
        printf("setsockopt\n");  
    }  
    if ((setsockopt(server_udp, IPPROTO_IP, IP_MULTICAST_LOOP,  
                       &one, sizeof (unsigned char))) == -1) {  
        printf("setsockopt\n");  
    }  
  
    struct ip_mreq mreq;  
    mreq.imr_multiaddr.s_addr = inet_addr("239.255.255.250");  
    mreq.imr_interface.s_addr = htonl(INADDR_ANY);  
  
    if(setsockopt(server_udp,IPPROTO_IP,IP_ADD_MEMBERSHIP,&mreq,sizeof(mreq))==-1){  
        perror("memberchip error\n");  
    }  
  
    return server_udp;  
}  

  需要注意几点:

  1. 设置socket属性SO_REUSEADDR
  2. 设置socket属性IP_ADD_MEMBERSHIP,目的是让3702的端口能够重复绑定,一家加入组播组。

  其次是添加ProbeMatches代码

  1. 首先复制client的soap_send___wsdd__ProbeMatches函数到服务端来,因为soap_send___wsdd__ProbeMatches已经写好了用于响应Probe消息的框架了,不用白不用啊。
  2. 编写__wsdd__Probe函数,添加如下内容
int  __wsdd__Probe(struct soap* soap, struct wsdd__ProbeType *wsdd__Probe)  
{  
    DBG("__wsdd__Probe\n");  
    char macaddr[6];  
    char _IPAddr[INFO_LENGTH];  
    char _HwId[1024];  
      
    wsdd__ProbeMatchesType ProbeMatches;  
    ProbeMatches.ProbeMatch = (struct wsdd__ProbeMatchType *)soap_malloc(soap, sizeof(struct wsdd__ProbeMatchType));  
    ProbeMatches.ProbeMatch->XAddrs = (char *)soap_malloc(soap, sizeof(char) * INFO_LENGTH);  
    ProbeMatches.ProbeMatch->Types = (char *)soap_malloc(soap, sizeof(char) * INFO_LENGTH);  
    ProbeMatches.ProbeMatch->Scopes = (struct wsdd__ScopesType*)soap_malloc(soap,sizeof(struct wsdd__ScopesType));  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceProperties = (struct wsa__ReferencePropertiesType*)soap_malloc(soap,sizeof(struct wsa__ReferencePropertiesType));  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceParameters = (struct wsa__ReferenceParametersType*)soap_malloc(soap,sizeof(struct wsa__ReferenceParametersType));  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ServiceName = (struct wsa__ServiceNameType*)soap_malloc(soap,sizeof(struct wsa__ServiceNameType));  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.PortType = (char **)soap_malloc(soap, sizeof(char *) * SMALL_INFO_LENGTH);  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.__any = (char **)soap_malloc(soap, sizeof(char*) * SMALL_INFO_LENGTH);  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.__anyAttribute = (char *)soap_malloc(soap, sizeof(char) * SMALL_INFO_LENGTH);  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.Address = (char *)soap_malloc(soap, sizeof(char) * INFO_LENGTH);  
  
    macaddr[0]=0x01;macaddr[1]=0x01;macaddr[2]=0x01;macaddr[3]=0x01;macaddr[4]=0x01;macaddr[5]=0x01;  
    sprintf(_HwId,"urn:uuid:2419d68a-2dd2-21b2-a205-%02X%02X%02X%02X%02X%02X",macaddr[0], macaddr[1], macaddr[2], macaddr[3], macaddr[4], macaddr[5]);  
  
    sprintf(_IPAddr, "http://%03d.%03d.%1d.%03d/onvif/device_service", 192, 168, 1, 233);  
    ProbeMatches.__sizeProbeMatch = 1;  
    ProbeMatches.ProbeMatch->Scopes->__item =(char *)soap_malloc(soap, 1024);  
    memset(ProbeMatches.ProbeMatch->Scopes->__item,0,sizeof(ProbeMatches.ProbeMatch->Scopes->__item));    
  
    //Scopes MUST BE  
    strcat(ProbeMatches.ProbeMatch->Scopes->__item, "onvif://www.onvif.org/type/NetworkVideoTransmitter");  
  
    ProbeMatches.ProbeMatch->Scopes->MatchBy = NULL;  
    strcpy(ProbeMatches.ProbeMatch->XAddrs, _IPAddr);  
    strcpy(ProbeMatches.ProbeMatch->Types, wsdd__Probe->Types);  
    DBG("wsdd__Probe->Types=%s\n",wsdd__Probe->Types);  
    ProbeMatches.ProbeMatch->MetadataVersion = 1;  
    //ws-discovery规定 为可选项  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceProperties->__size = 0;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceProperties->__any = NULL;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceParameters->__size = 0;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ReferenceParameters->__any = NULL;  
      
    ProbeMatches.ProbeMatch->wsa__EndpointReference.PortType[0] = (char *)soap_malloc(soap, sizeof(char) * SMALL_INFO_LENGTH);  
    //ws-discovery规定 为可选项  
    strcpy(ProbeMatches.ProbeMatch->wsa__EndpointReference.PortType[0], "ttl");  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ServiceName->__item = NULL;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ServiceName->PortName = NULL;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.ServiceName->__anyAttribute = NULL;  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.__any[0] = (char *)soap_malloc(soap, sizeof(char) * SMALL_INFO_LENGTH);  
    strcpy(ProbeMatches.ProbeMatch->wsa__EndpointReference.__any[0], "Any");  
    strcpy(ProbeMatches.ProbeMatch->wsa__EndpointReference.__anyAttribute, "Attribute");  
    ProbeMatches.ProbeMatch->wsa__EndpointReference.__size = 0;  
    strcpy(ProbeMatches.ProbeMatch->wsa__EndpointReference.Address, _HwId);  
  
    /*注释的部分为可选,注释掉onvif test也能发现ws-d*/  
    //soap->header->wsa__To = "http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous";  
    //soap->header->wsa__Action = "http://schemas.xmlsoap.org/ws/2005/04/discovery/ProbeMatches";  
    soap->header->wsa__RelatesTo = (struct wsa__Relationship*)soap_malloc(soap, sizeof(struct wsa__Relationship));  
    //it's here  
    soap->header->wsa__RelatesTo->__item = soap->header->wsa__MessageID;  
    soap->header->wsa__RelatesTo->RelationshipType = NULL;  
    soap->header->wsa__RelatesTo->__anyAttribute = NULL;  
  
    soap->header->wsa__MessageID =(char *)soap_malloc(soap, sizeof(char) * INFO_LENGTH);  
    strcpy(soap->header->wsa__MessageID,_HwId+4);  
  
    /* send over current socket as HTTP OK response: */  
    /*测试过,第二参数必须http,action随意*/  
    soap_send___wsdd__ProbeMatches(soap, "http://", NULL, &ProbeMatches);  
    return SOAP_OK;  
  
}  

  想要写出上述代码,是一定要了解SOAP格式的,在WS-Discovery中描述了discovery所用的soap格式

  1. 首先是了解消息头header和ProbeMatches中的内容,非常重要,可以参考这里http://www.w3.org/Submission/ws-addressing/ 最好详细的学习一下,里面的内容非常重要。
  2. 其次需要理解的是,其实当你看完ws-addressing后你会发现,骨架代码中的结构体和SOAP消息中的内容是一一对应的。例如:结构体osap->header对应SOAP消息的<SOAP-ENV:Header></SOAP-ENV:Header>中的内容,包含在header里的内容当然会包含在SOAP的header内。例如:结构体soap->header->wsa__RelatesTo对应的是<wsa:RelatesTo></wsa:RelatesTo>。
  3. 最后需要理解的是,在代码中的"__“双下划线一般对应xml中的命名空间的”:",下划线前是命名空间,后是具体内容
  4. 最后的最后是要详细的阅读ONVIF Core Specification

  下图为响应OnvifTestTool的Probe命令的SOAP消息
在这里插入图片描述
  结合上图再分析代码就亲切多了。在ONVIF Core Specification的7.3.2.2 Scopes 一节描述了onvif需要的Scopes,这个是需要在程序里填充,具体填充什么,文档里说的很明确:
在这里插入图片描述
  注意点是在太多,随便漏掉一个都可能会导致搜不到设备,下图是非常重要的一个:
在这里插入图片描述
  SOAP1.1和SOAP1.2所使用的SOAP-ENV是不同的,ONVIF使用的是SOAP1.1,如果soapcpp2产生的nsmap文件中的SOAP-ENV是SOAP1.2版本的话,那么OnvifTestTool是不会识别设备发出的SOAP消息的。

5. 该main函数登场了

int main()  
{  
    int server_udp;  
      
    int retval=0;  
    struct soap *soap_udp;  
    int fault_flag = 0;  
      
    server_udp = create_server_socket_udp();  
    bind_server_udp1(server_udp);  
    while(1){  
        soap_udp=soap_new();  
        soap_init1(soap_udp, SOAP_IO_UDP);  
        soap_udp->master = server_udp;  
        soap_udp->socket = server_udp;  
        soap_udp->errmode = 0;  
        soap_udp->bind_flags = 1;  
        if (!soap_valid_socket(soap_bind(soap_udp, NULL, 3702, 100)))  
        {      
            soap_print_fault(soap_udp, stderr);  
        }  
        fprintf(stderr,"soap_serve starting..\n");  
        retval = soap_serve(soap_udp); //阻塞在这里  
        fprintf(stderr,"retval=%d\n",retval);  
        if(retval && !(fault_flag))  
        {  
            fault_flag = 1;  
        }  
        else if(!retval)  
        {  
            fault_flag = 0;  
        }  
        soap_destroy(soap_udp);  
        soap_end(soap_udp);  
        soap_done(soap_udp);  
        free(soap_udp);  
    }  
}  

  soap_server函数会一直阻塞,直到接收到SOAP消息,并且该处理是一次性的,所以要将将soap_server放到while里或者独立的线程中。
  最后编译运行

make server
./discovery.tmp

  单击OnvifTestTool的Discover Devices,运行discovery.tmp的中会打印调试信息,如图
在这里插入图片描述
  响应Discover Devices的SOAP消息如下:

<?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"   
    xmlns: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:ns1="http://www.onvif.org/ver10/network/wsdl/RemoteDiscoveryBinding"   
    xmlns:ns2="http://www.onvif.org/ver10/network/wsdl/DiscoveryLookupBinding"   
    xmlns:ns3="http://www.onvif.org/ver10/network/wsdl/DiscoveryLookupBinding"   
    xmlns:tdn="http://www.onvif.org/ver10/network/wsdl">  
  
    <SOAP-ENV:Header>  
        <wsa:MessageID>uuid:2419d68a-2dd2-21b2-a205-010101010101</wsa:MessageID>  
        <wsa:RelatesTo>uuid:88a3958a-6155-4510-8279-69aeafd31681</wsa:RelatesTo>  
        <wsa:To SOAP-ENV:mustUnderstand="true">urn:schemas-xmlsoap-org:ws:2005:04:discovery</wsa:To>  
        <wsa:Action SOAP-ENV:mustUnderstand="true">http://schemas.xmlsoap.org/ws/2005/04/discovery/Probe</wsa:Action>  
    </SOAP-ENV:Header>  
  
    <SOAP-ENV:Body>  
        <wsdd:ProbeMatches>  
            <wsdd:ProbeMatch xmlns:_0="http://www.onvif.org/ver10/device/wsdl">  
                <wsa:EndpointReference>  
                <wsa:Address>urn:uuid:2419d68a-2dd2-21b2-a205-010101010101</wsa:Address>  
                <wsa:ReferenceProperties></wsa:ReferenceProperties>  
                <wsa:ReferenceParameters></wsa:ReferenceParameters>  
                <wsa:PortType>ttl</wsa:PortType>  
                </wsa:EndpointReference>  
                <wsdd:Types>_0:Device</wsdd:Types>  
                <wsdd:Scopes>onvif://www.onvif.org/type/NetworkVideoTransmitter</wsdd:Scopes>  
                <wsdd:XAddrs>http://192.168.1.233/onvif/device_service</wsdd:XAddrs>  
                <wsdd:MetadataVersion>1</wsdd:MetadataVersion>  
            </wsdd:ProbeMatch>  
        </wsdd:ProbeMatches>  
    </SOAP-ENV:Body>  
</SOAP-ENV:Envelope>  
  • 0
    点赞
  • 7
    收藏
    觉得还不错? 一键收藏
  • 1
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值