ISO/IEC INTERNATIONAL STANDARD 29341-1-2 First edition 2017-06 Information technology UPnP Device Architecture Part 1-2: UPnP Device Architecture Version 2.0 Technologies de I'information Architecture de dispositif UPnP- Partie 1-2: Architecture de dispositif UPnP, version 2.0 Reference number IEC IS0/IEC 29341-1-2:2017(E) so @IS0/IEC2017 JACKEY, MA out license from IHS IS0/IEC29341-1-2:2017(E) COPYRIGHT PROTECTED DOCUMENT IS0/IEC 2017,Published in Switzerland All rights reserved. Unless otherwise specified, no part of this publication may be reproduced or utilized otherwise in any form written permission. Permission can be requested from either ISO at the address below or ISO's member body in the country of the requester. ISO copyright office Ch. de Blandonnet 8 . CP 401 CH-1214 Vernier, Geneva, Switzerland Tel. +41 22 749 01 11 Fax +41227490947 [email protected] www.iso.org @ IS0/IEC 2017 - All rights reserved icensee=Nanyang Technological Univ/5926867100, User=JACKEY, MA r networking permitted without license from IHS ISO/IEC 29341-1-2:2017(E) CONTENTS Introduction 0 Addressing 0.1 Determining whether to use Auto-IP 0.2 Choosing an address . 0.3 Testing the address . 0.4 Forwarding rules. 0.5 Periodic checking for dynamic address availability. 0.6 Device naming and DNS interaction 0.7 Name to IP address resolution .. 0.8 References. 9 1 Discovery ..10 1.1 SSDP message format.... 1.1.1 SSDP Start-line... 1.1.2 SSDP message header fields .. 1.1.3 SSDP header field extensions 14 1.1.4 UUID format and recommended generation algorithms. .14 1.1.5 SSDP processing rules... 14 1.2 Advertisement .. .15 1.2.1 Advertisement protocols and standards .15 1.2.2 Device available - NOTIFY with ssdp:alive... 1.2.3 Device unavailable -- NOTIFY with ssdp:byebye ... ...21 1.2.4 Device Update - NOTIFY with ssdp:update.. 1.3 Search ..25 1.3.1 Search protocols and standards .... ..25 1.3.2 Search request with M-SEARCH.. ..26 1.3.3 Search response. 1.4 References. 2 Description 2.1 Generic requirements on HTTP usage... ...35 2.2 Generic requirements on XML usage.. 2.3 Device description .... ....38 2.4 UPnP Device Template.. ....43 2.5 Service description .. ..44 2.5.1 Defining and processing extended data types ... 2.5.2 String equivalents of extended data types.... .52 2.5.3 Generic requirements... 2.5.4 Ordering of Elements 2.5.5 Versioning . 2.6 UPnP Service Template.. ...54 2.7 Non-standard vendor extensions and limitations .. ..54 2.7.1 Placement of Additional Elements and Attributes .56 2.8 UPnP Device Schema.. ..56 2.9 UPnP Service Schema... ..56 2.10 UPnP Datatype Schema.. .56 2.11 Retrieving a description using HTTP @ ISO/IEC 2017 - All rights reserved ii Copyright International Organization for Standardization JACKEY, MA ed without license from IHS Not for Re ISO/IEC 29341-1-2:2017(E) 2.12 References. ..59 3 Control. .60 3.1 Control protocols .... ...63 3.1.1 SOAP Profile.. ...63 3.2 Actions... ...67 3.2.1 Action invocation... .67 3.2.2 Action Response ... 3.2.3 UPnP Action Schema. 3.2.4 Recommendations and additionalreguirements 3.2.5 Action error response. ...73 3.2.6 UPnP Error Schema. 3.3 Query for variable. .76 3.4 References 77 4 Eventing 4.1 Unicast eventing .. .78 4.1.1 Subscription. .79 4.1.2 SUBSCRIBE with NT and CALLBACK. .81 4.1.3 Renewing a subscription with SUBSCRIBE with SID ...84 4.1.4 Canceling a subscription with UNSUBSCRIBE 4.2 Multicast Eventing . ...86 4.3 Event messages. ...88 4.3.1 ErrorCases .88 4.3.2 Unicast eventing: Event messages: NOTIFY ..89 4.3.3 Multicast Eventing: Event messages: NOTIFY .92 4.4 UPnP Event Schema.. ...95 4.5 Augmenting the UPnP Device and Service Schemas . 4.6 References. 5 Presentation... 5.1 References Annex A (normative) IP Version 6 Support.... A.0 Note (informative)... .98 A.1 Introduction. A.2 General Principles ..... A.2.1 UPnP Device Architecture V1.0.... ...98 A.2.2 UPnP Device Architecture V2.0 ... ...99 A.2.3 IPv6 and Dual Stack. .99 A.2.4 Device operation... .100 A.2.5 Controi