# 设备评级用例指引
设备评级仅对设备上报的及时性进行判断，并不会对上报的状态数值进行准确性判断。
# msmart协议
每个用例中，点击开始，系统会清空该设备的影子状态。点击查看用例时，系统会首先判断设备是否有对应指令上报，没有则不通过，如果有对应指令就会比对影子系统中的状态。
所有用例中的属性都来源于能力定义中勾选的非只写属性。用例1-3会判断影子服务中的状态是否包含全状态，用例4-7判断影子服务中的状态是否包含期望状态，全状态/全属性即能力定义中勾选的非只写属性。
设备全状态上报的检查逻辑，保存在影子系统中的设备状态包含设备全状态。
注意：
- 因为设备上报会有延迟，为了确保设备上报完成，所以很多用例都需要进行一段时间的等待，可以打开事件调试台看到事件解析成功后再点击查看用例结果。
- 本指引中描述的“指令/消息类型”均为广域网通信协议中规定的消息类型。
# 快速开始
以下以用例2为例，展示一次评级流程：
1.选择调试环境后，另外打开一个tab页面，进入调试台。2.在原页面点击开始评级，按照步骤进行。3.转到调试台页面，在调试台看到指令类型为0004指令后出现指令类型为0040/0044的指令，则4.下拉查看事件触发，等待事件触发全部属性的解析后，回到评级界面查看用例结果。
# 各用例结果的排查方法与解读
# 1.在能力定义中勾选却未在事件中配置以下属性功能
(1)确认在能力定义->事件->数据格式中配置了对应属性。(2)如果没有读取该属性的需要，则在能力定义->属性->点击该属性->勾选只写。
# 2.未检测到xx指令0x00xx
进入调试台，在对应的时间区间找到对应的指令类型（msgType)。
例如用例2中的时间区间的判断顺序为:点击开始用例->第一条下线指令0x0000->第一条上线指令0x0004->第一条上报指令0x0040/0x0044。
如果调试台中有对应指令，但是无法被评级检测到，则需要检查：（1）评级使用的环境是否与调试台的环境相同。（2）评级使用的SN是否与调试台中的SN相同。（3）如果是太长时间没有操作评级，需要退出评级界面，输入sn重新评级。
# 3.上报指令和上线指令的间隔不在5s内
固件/电控板本身等级不足，无法达成评级条件，有的电控因为是定时上报会偶尔成功一次，但请不要强行要求用例通过。
# 4.未接收到上报信息，请检查事件配置是否正确，并确认设备是否具备下列属性功能/未接收到上报。
打开调试台，查看事件解析。
（1）没有事件解析时，需要查看调试台中指令，对比是否存在指令类型与配置的事件消息类型相同，或对比是否存在符合匹配规则的消息信息。
如果对应时间区间内有触发事件，则（2）检查事件解析内容中是否包含对应状态。如果未包含对应状态或者没有解析，请参考事件配置，结合该时间区间内的调试台中的指令配置指令解析。
如果对应事件区间有触发事件，且有全部状态的解析。（3）对比产品的识别依据与评级使用的sn，确认两者是否匹配。
# 指令与上报日志查看
设备消息日志可以在调试台或者沙箱环境的数据中心查看，每次进入评级界面，输入sn后，系统只会监测设备行为30分钟。
用例1-3中特别地包含对设备上下线/断线重连的判断，每个用例都会对设备的上报判断，需要注意的是要注意区分上报与响应的区别，响应的消息类型(msgType)一般为0x80xx，响应的结果最终会传输给调用方，而上报一般为0x00xx，最终的结果会返回到云端，影子系统中的状态由上报的状态构成。
以下列举评级中涉及的上报指令：
离线指令：消息类型为0000，原因为超时（timeout）
上线指令：消息类型为0004
状态上报指令：消息类型为0040、0044
控制指令：消息类型为0002，且消息信息（msg）第10位为02。
下附评级时间顺序，用例4、5、7与用例6相似，只是缺少了控制指令的判断。
# 评级结果
设备的评级结果与用例通过相关，用例1-3判断设备能否及时上报全状态，用例4-7判断设备能否在状态变动时及时上报该状态，设备等级分为5级。
| 等级 | 说明 |
|---|---|
| 5级 | 用例1-7全通过 |
| 4级 | 只有用例4-7全通过 |
| 3级 | 用例4-7任一不通过，且控制查询均为单指令 |
| 2级 | 用例4-7任一不通过，查询为多指令 |
| 1级 | 用例4-7任一不通过，控制为多指令 |
# 影子系统中的设备状态
来源：设备上报触发物模型1.0定义中的事件，通过事件中配置的出参解码解析上报二进制，解析的状态会保存到影子系统中。
保存到影子系统中的状态(属性)必须要达成3个条件：
(1) 设备通过广域网通信协议中消息类型为0040，0044的指令上报状态
(2) 事件被触发
(3) 该属性被解析（可以通过调试台调试事件）
# 半影子
半影子用例与原来的用例相似，只是判断的属性/状态范围减少了，用例1-7的属性都会从勾选的可读半影子属性中选择。
用例1-7走完之后，无论结果，设备的等级一定是3级，并且会过滤掉没有通过用例的一些属性，保留下通过用例的部分属性，并可以在查看可靠属性处查看结果。
注意：可靠属性是动态的，在评级结束后删除能力定义中的内容可能会导致展示的属性少于原来的属性，但是再次添加上去就能展示对应的内容了。