东方仙盟IOT智能设备交互格式和规范说明书

一、概述

东方仙盟IOT智能设备交互系统采用特定的格式进行数据交互，核心以 CyberPHP->Param 和 CyberPHP->Value 为一对的键值对形式来传递设备相关信息。这种交互格式简洁明了，易于解析和扩展，能够满足不同类型智能设备在多种场景下的数据交互需求。

二、交互格式详细说明

（一）基本结构

交互数据由多个 CyberPHP->Param 和 CyberPHP->Value 组成的键值对构成，每个键值对之间通过换行分隔，用于描述设备的不同参数及其对应的值。其基本形式如下：

CyberPHP->Param:参数名称1
CyberPHP->Value:参数值1
CyberPHP->Param:参数名称2
CyberPHP->Value:参数值2
...
    

（二）参数说明

1. hotelsign
   • 含义：酒店标识，用于唯一标识设备所属的酒店信息。
   • 取值：通常为一个特定的字符串，例如在示例中可能包含 {cwpdcms{$DeviceConfig_DoorLock.mcode} 这样的占位符或动态取值，实际应用中会根据具体的设备配置和系统规则进行填充。
2. devaddress
   • 含义：设备地址，标识设备的通信地址，可能是物理地址或网络地址等。
   • 取值：同样可能包含占位符，如 {cwpdcms{$DeviceConfig_DoorLock.communication_address}，实际值会根据设备的通信地址配置来确定。
3. lockno
   • 含义：锁编号，用于唯一标识设备中的锁。
   • 取值：为一个字符串，示例中取值为 ynwlzc，可根据实际情况进行自定义。
4. checkingouttime
   • 含义：退房时间，记录设备相关的退房时间信息。
   • 取值：示例中取值为 ynwlzc，在实际应用中可能会是具体的时间格式，如 YYYY - MM - DD HH:MM:SS。

三、交互规范

（一）数据发送

1. 发送方在发送交互数据时，必须严格按照 CyberPHP->Param 和 CyberPHP->Value 成对的格式进行组织，确保每个参数都有对应的参数值。
2. 每个键值对必须独占一行，且参数名称和参数值之间不能有多余的空格或特殊字符（除了参数值本身包含的字符）。
3. 若参数值需要包含占位符或动态取值，应遵循系统预先定义的规则进行替换和处理。

（二）数据接收

1. 接收方在接收到交互数据后，应按照 CyberPHP->Param 和 CyberPHP->Value 成对的规则进行解析，依次提取每个参数及其对应的值。
2. 对于包含占位符的参数值，接收方需要根据系统的配置和规则进行相应的替换和处理，以获取实际的有效数据。
3. 在解析过程中，若发现数据格式不符合规范，接收方应返回错误信息给发送方，并说明具体的错误原因。

（三）错误处理

1. 若发送方发送的数据格式错误，接收方应拒绝接收该数据，并返回错误码和错误描述给发送方，以便发送方进行修正。
2. 若在数据交互过程中出现网络故障、设备故障等异常情况，双方应根据预先定义的错误处理机制进行相应的处理，如重试、报警等。

CyberPHP->Param:hotelsign
CyberPHP->Value:{cwpdcms{$DeviceConfig_DoorLock.mcode}
CyberPHP->Param:devaddress
CyberPHP->Value:{cwpdcms{$DeviceConfig_DoorLock.communication_address}
CyberPHP->Param:lockno
CyberPHP->Value:ynwlzc
CyberPHP->Param:checkingouttime
CyberPHP->Value:ynwlzc