通信协议中的hms_code为Mid360的诊断码，由设备主动推出，用于特殊情况的提示或者辅助用户迅速排查设备故障。

.. _诊断码组成格式:

组成格式
~~~~~~~~~~~~~~~~~~~~~~
一个完整的诊断码是一个4字节uint32代码，
其组成格式为异常ID+异常等级，见下表：

+-----------+---------+----------+
| Byte[3:2] | Byte[1] | Byte[0]  |
+===========+=========+==========+
| 异常ID    | RSVD    | 异常等级 |
+-----------+---------+----------+


其中，异常等级为非0的值，值越大严重等级越高，详见下表：

+------+----------------+--------------------------------------------------------------------------------------------+
| 值   | 等级           | 描述                                                                                       |
+======+================+============================================================================================+
| 0x01 | Info消息       | 正常工作情况下的消息通知                                                                   |
+------+----------------+--------------------------------------------------------------------------------------------+
| 0x02 | Warning警告    | 出现可能会影响设备继续正常工作的风险，请及时排查问题                                       |
+------+----------------+--------------------------------------------------------------------------------------------+
| 0x03 | Error错误      | 此时设备在非正常情况下继续工作，应及时排查问题，长期处于此状态可能会造成永久不可恢复的风险 |
+------+----------------+--------------------------------------------------------------------------------------------+
| 0x04 | fatal严重错误  | 严重异常，可能存在物理上不可恢复的风险，此时将停止工作                                     |
+------+----------------+--------------------------------------------------------------------------------------------+


解析示例
~~~~~~~~~~~~~~~~~~~~~~

如一个0x01060002的hms_code，按照 :ref:`诊断码组成格式<诊断码组成格式>`，
其异常ID为0x0106、异常等级为0x02(Warning)。

查找以下诊断码表可知，此诊断码代表“风扇转速可能存在异常”，该异常的严重程度为warning，
建议的处理办法为“请检查风扇状态”。

诊断码表
~~~~~~~~~~~~~~~~~~~~~~

==================  ================== ============================================= ===========================================
异常ID                异常等级            异常描述                                         处理办法
------------------  ------------------ --------------------------------------------- -------------------------------------------
0x0106              warning            风扇转速可能存在异常                            请检查风扇状态
0x0210              warning            扫描模块转速切换中                              等待转速稳定
0x0211-0x021B       fatal              扫描模块异常                                   请等待，若长时间未恢复，请尝试重启
0x0310-0x0312       warning            内部模块存在超温                                请检查设备散热条件
0x0313              warning            测距模块光功率裕度告警，请注意人眼安全            请等待，若长时间未恢复，请尝试重启
0x0314              fatal              测距模块光功率裕度异常，请注意人眼安全            请重启尝试恢复，
0x0315              warning            测距模块可能存在异常                            请重启尝试恢复,或联系livox技术人员
0x0316              warning            测试环境检测告警                                请确认场景内是否有高反或全反射物体并及时移除，否则可能损坏设备
0x0317-0x0318         fatal            测试场景检测错误                                请确认场景内是否有高反或全反射物体并及时移除,并重启设备恢复，否则可能损坏设备
0x0402              warning            ptp同步中断，或者时间跳变太大                    请排查ptp时钟源是否工作正常
0x0403              warning            ptp版本为1588-v2.1版本，设备不支持该版本         请更换1588-v2.0版本进行同步
0x0404              warning            pps同步异常                                    请检查pps及gps信号
0x0407              warning            缺失gps信号导致gps时间同步失败                   请检查gps信号
0x0408              warning            缺失pps信号导致gps时间同步失败                   请检查pps信号
0x0409              warning            gps信号异常                                    请检查gps信号源
0x040A              warning            多种时间同步信号同时存在，同步可能存在问题        请检查拓扑，单独使用某一种同步方式
==================  ================== ============================================= ===========================================