UPnP™ Device Architecture 1

1 upnp Device Architecture Document Revision Date: October 15, 2008. 2008 Contributing Members of the upnp Forum. All rights reserved. See for more information. Authors* Company Alan Presser AllegroSoft Lee Farrell Canon Devon Kemp Canon William Lupton Conexant Shinichi Tsuruyama Epson Shivaun Albright HP. Andrew Donoho IBM. John Ritchie Intel Bryan Roe Intel Mark Walker Intel Toby Nixon Microsoft Colleen Evans Microsoft Henry Rawas Microsoft Trevor Freeman Microsoft Joonyoung Park Motorola Cathy Chan Nokia Franklin Reynolds Nokia Jose Costa-Requena Nokia Yinghua Ye Nokia Tom McGee Philips Geert Knapen Philips Maarten Bodlaender Philips Jarno Guidi Philips Lex Heerink Philips John Gildred Pioneer Alan Messer Samsung YoonSoo Kim Samsung Markus Wischy Siemens Andrew Fiddian-Green Siemens Bruce Fairman Sony Jonathan Tourzan Sony John Fuller Sony *Note.

2 The upnp Forum in no way guarantees the accuracy or completeness of this author list and in no way implies any rights for or support from those members listed. This list is not the specifications' contributor list that is kept on the upnp . Forum's website. i Table of Contents List of Tables .. v List of Figures .. vi i Introduction .. 1 What is upnp Technology? .. 1 upnp Forum .. 1 In this document .. 2 Audience .. 5 Conformance terminology .. 5 Acronyms .. 6 Glossary .. 6 References and resources .. 7 0 Addressing .. 8 Determining whether to use Auto-IP .. 8 Choosing an address .. 8 Testing the address .. 9 Forwarding 10 Periodic checking for dynamic address availability .. 10 Device naming and DNS interaction.

3 10 Name to IP address resolution .. 11 References .. 11 1 Discovery .. 12 SSDP message format .. 15 SSDP Start-line .. 16 SSDP message header fields .. 16 SSDP header field extensions .. 16 UUID format and RECOMMENDED generation algorithms .. 17 SSDP processing rules .. 17 Advertisement .. 17 Advertisement protocols and standards .. 18 Device available - NOTIFY with ssdp:alive .. 19 Device unavailable -- NOTIFY with 25 Device Update NOTIFY with ssdp:update .. 27 Search .. 29 Search protocols and standards .. 29 Search request with M-SEARCH .. 30 Search response .. 33 References .. 36 2 Description .. 37 Generic requirements on HTTP 40 Generic requirements on XML usage .. 43 Device description.

4 43 ii upnp Device Template .. 48 Service description .. 48 Defining and processing extended data types .. 55 String equivalents of extended data types .. 57 Generic requirements .. 58 Ordering of Elements .. 58 Versioning .. 59 upnp Service 59 Non-standard vendor extensions and 60 Placement of Additional Elements and Attributes .. 61 upnp Device 61 upnp Service Schema .. 62 upnp Datatype Schema .. 62 Retrieving a description using HTTP .. 62 References .. 65 3 Control .. 67 Control protocols .. 69 SOAP Profile .. 69 Actions .. 73 Action invocation .. 73 Action Response .. 76 upnp Action Schema .. 79 Recommendations and additional requirements .. 79 Action error response .. 79 upnp Error Schema.

5 82 Query for variable .. 83 References .. 83 4 Eventing .. 84 Unicast eventing .. 85 Subscription .. 86 SUBSCRIBE with NT and CALLBACK .. 88 Renewing a subscription with SUBSCRIBE with SID .. 91 Canceling a subscription with UNSUBSCRIBE .. 93 Multicast Eventing .. 95 Event messages .. 96 Error Cases .. 97 Unicast eventing: Event messages: NOTIFY .. 97 Multicast Eventing: Event messages: NOTIFY .. 101 upnp Event Schema .. 104 Augmenting the upnp Device and Service Schemas .. 104 References .. 105 5 Presentation .. 106 References .. 107 Appendix A. IP Version 6 Support .. 109 iii Introduction .. 109 General Principles .. 109 Device operation .. 110 Control point operation .. 110 Addressing.

6 110 Summary of boot/startup process .. 111 Short overview of protocol specified by RFC 2462 .. 111 Discovery .. 112 Advertisement .. 113 Advertisement: Device unavailable .. 114 Advertisement: Device update .. 114 Search .. 114 Search response .. 115 Description .. 115 Control .. 115 Eventing .. 115 Presentation .. 116 References .. 116 Appendix B. Schemas .. 117 upnp Device 117 upnp Service Schema .. 122 upnp Control Schema .. 126 upnp Error 127 upnp Event Schema .. 128 Schema references .. 129 iv List of Tables Table i-1: Acronyms .. 6. Table 1-1: Root Device discovery messages .. 20. Table 1-2: Embedded Device discovery messages .. 20. Table 1-3: Service discovery messages.

7 20. Table 2-1: Vendor extensions .. 60. Table 3-1: SOAP upnp Profile .. 70. Table 3-2: mustUnderstand attribute .. 71. Table 3-3: upnp Defined Action error codes .. 82. Table 4-4: HTTP Status Codes indicating a Subscription Error .. 91. Table 4-5: HTTP Status Codes indicating a Resubscription Error .. 93. Table 4-6: HTTP Status Codes indicating a Cancel Subscription Error .. 94. Table 4-7: HTTP Status Codes indicating a Notify Error .. 101. Table 4-7: Multicast event levels .. 103. v List of Figures Figure i-1: Protocol stack .. 2. Figure 1-1: Discovery Architecture .. 13. Figure 1-2: Advertisement protocol stack .. 19. Figure 1-3: Initial and repeat announcements, no announcement spreading.

8 21. Figure 1-4: Initial and repeat announcements, message spreading of repeat announcements 21. Figure 1-5: Search protocol stack .. 30. Figure 2-1: Description Architecture .. 37. Figure 2-2: Description retrieval protocol stack .. 63. Figure 3-1: Control Architecture .. 67. Figure 3-2: Control protocol stack .. 69. Figure 4-1: Unicast eventing Architecture .. 85. Figure 4-2: Unicast eventing protocol stack .. 86. Figure 4-3: Multicast eventing Architecture .. 95. Figure 4-4: Mulitcast eventing protocol 95. Figure 5-1: Presentation Architecture .. 106. Figure 5-2: Presentation protocol stack .. 107. vi i Introduction [Informative]. What is upnp 1 Technology? upnp technology defines an Architecture for pervasive peer-to-peer network connectivity of intelligent appliances, wireless devices , and PCs of all form factors.

9 It is designed to bring easy-to-use, flexible, standards-based connectivity to ad-hoc or unmanaged networks whether in the home, in a small business, public spaces, or attached to the Internet. upnp technology provides a distributed, open networking Architecture that leverages TCP/IP and Web technologies to enable seamless proximity networking in addition to control and data transfer among networked devices . The upnp Device Architecture (UDA) is more than just a simple extension of the plug and play peripheral model. It is designed to support zero-configuration, "invisible" networking, and automatic discovery for a breadth of Device categories from a wide range of vendors. This means a Device can dynamically join a network, obtain an IP address, convey its capabilities, and learn about the presence and capabilities of other devices .

10 Finally, a Device can leave a network smoothly and automatically without leaving any unwanted state behind. The technologies leveraged in the upnp Architecture include Internet protocols such as IP, TCP, UDP, HTTP, and XML. Like the Internet, contracts are based on wire protocols that are declarative, expressed in XML, and communicated via HTTP. Using Internet protocols is a strong choice for UDA because of its proven ability to span different physical media, to enable real world multiple-vendor interoperation, and to achieve synergy with the Internet and many home and office intranets. The upnp . Architecture has been explicitly designed to accommodate these environments. Further, via bridging, UDA accommodates media running non-IP protocols when cost, technology, or legacy prevents the media or devices attached to it from running IP.