Physical Address
304 North Cardinal St.
Dorchester Center, MA 02124
ISO/IEC 29341-1-1：UPnP设备架构v1.0
基础UPnP协议栈、设备描述与服务控制详解
1. UPnP设备架构1.0版概述
ISO/IEC 29341-1-1定义了基础性的UPnP设备架构1.0版，这是UPnP协议套件的首个标准化版本。该版本确立了所有后续UPnP标准所扩展和完善的基线协议和设备交互模型。作为29341系列的基石，它规定了设备和控制点的强制性行为。
1.0版引入了六层协议栈，至今仍是UPnP的核心支柱：通过DHCP/Auto-IP进行寻址、通过SSDP进行发现、使用XML获取设备和服务的描述文档、基于SOAP的控制、GENA事件通知以及可选的呈现页面。该架构在当时是革命性的，它将零配置网络技术带入了消费电子领域。
构建符合v1.0标准的设备时，请记住SSDP通告必须包含带有max-age指令的CACHE-CONTROL标头（按惯例至少1800秒），以便控制点能够正确管理设备在线超时。
2. 设备和服务描述模型
1.0版的描述模型使用XML模式来定义设备和服务能力。设备描述文档（通过SSDP LOCATION标头中嵌入的URL获取）包含制造商元数据、型号信息以及指向服务描述文档的链接。
每个服务描述文档定义了：动作列表（控制点可以调用的方法）、状态变量（反映设备运行时状态的类型化数据）以及服务控制协议定义。状态变量可以是事件型（变更时发送通知）或非事件型。支持的数据类型包括布尔型、数值类型（i1、ui1、i2、ui2、i4、ui4、int、r4、r8、number）、字符串、日期/时间类型和二进制数据（bin.base64、bin.hex）。
| 状态变量类型 | 说明 | 使用示例 |
|---|---|---|
| Boolean | 真/假标志 | PowerStatus, ConnectionState |
| ui1 | 无符号8位整数（0-255） | VolumeLevel, ChannelNumber |
| i4 | 有符号32位整数 | ErrorCode, TimeRemaining |
| string | UTF-8编码文本 | DeviceName, FriendlyName |
| r4 | 32位浮点数 | Temperature, Position |
| bin.base64 | Base64编码的二进制数据 | FirmwareImage, IconData |
| dateTime | ISO 8601日期/时间 | LastUpdate, AlarmTime |
| uri | 统一资源标识符 | DeviceURL, IconURL |
1.0版未定义强制性的安全机制。所有SOAP动作调用都以明文HTTP POST请求发送。在生产环境中，始终将UPnP与网络层安全措施（VLAN隔离、防火墙规则）结合使用，以降低未经授权访问的风险。
3. 可靠的UPnP v1.0部署工程实践
UPnP v1.0的现场经验揭示了几个工程最佳实践。首先，控制点必须实现健壮的超时处理——SSDP M-SEARCH响应可能延迟，且设备可能在不发送SSDP byebye消息的情况下变得无响应。其次，设备中的XML解析器应能抵抗格式错误的SOAP请求，防止设备协议栈崩溃。
关于多播稳定性，标准建议SSDP NOTIFY消息应发送时加入最多100毫秒的随机抖动，以避免大量设备同时开机时（停电后的常见场景）造成网络风暴。类似地，M-SEARCH响应应包含介于0和设备CACHE-CONTROL标头中指定的Advertisement Age之间的随机延迟。
正确实现v1.0发现抖动机制的设备在大规模开机事件中的网络丢包率显著低于同时发送所有通告的设备。
一个常见的v1.0实现陷阱是将完整的设备描述直接嵌入SSDP数据包中。LOCATION标头应包含指向XML描述的URL，而非XML本身——嵌入描述会导致UDP数据包分片和不可靠的发现。
4. 常见问题
问：v1.0中SSDP数据包的最大尺寸是多少？
答：SSDP消息使用UDP，理想情况下应适合单个以太网帧（1500字节MTU）。实践中，SSDP NOTIFY和M-SEARCH数据包不应超过1500字节，以避免IP分片，而IP分片在UDP上是不可靠的。
答：SSDP消息使用UDP，理想情况下应适合单个以太网帧（1500字节MTU）。实践中，SSDP NOTIFY和M-SEARCH数据包不应超过1500字节，以避免IP分片，而IP分片在UDP上是不可靠的。
问：UPnP v1.0设备能否拥有多个服务？
答：可以，单个设备可以托管多个服务，每个服务有各自的描述文档。设备描述文档列出所有可用服务及其对应的控制、事件订阅和描述URL。
答：可以，单个设备可以托管多个服务，每个服务有各自的描述文档。设备描述文档列出所有可用服务及其对应的控制、事件订阅和描述URL。
问：控制点如何发现设备离线？
答：有两种机制：（1）设备在关闭前发送NTS = ssdp:byebye的SSDP NOTIFY消息；（2）当设备通告过期时（基于CACHE-CONTROL max-age），控制点检测到超时。可靠的实现同时使用两种机制。
答：有两种机制：（1）设备在关闭前发送NTS = ssdp:byebye的SSDP NOTIFY消息；（2）当设备通告过期时（基于CACHE-CONTROL max-age），控制点检测到超时。可靠的实现同时使用两种机制。
