# 设备管理
# 一、概述
物联网平台的设备管理模块是整个平台的核心组成部分,它负责对物联网设备的全生命周期进行管理,包括设备的添加、批量添加和删除等操作。通过设备管理模块,用户可以方便地对大量的物联网设备进行集中管理,提高设备的使用效率和可靠性。
# 二、功能介绍
# 2.1 设备添加
- 功能描述:物联网平台的添加设备功能是设备管理模块中基础且关键的功能,它是将新的物联网设备纳入平台管理的入口,待添加成功后,平台就能对该设备进行后续的配置、监控、维护等管理操作。
- 操作步骤:
- 登录物联网平台,选择实例进入实例详情页面,通过左侧导航菜单点击进入设备管理页面;

- 点击“添加设备”按钮;
- 在弹出的表单中填写设备的基本信息:
- 产品:选择设备所属的产品;
- DeviceName:输入设备的唯一标识符,通常由设备厂商提供;
- 备注名称:为设备添加一个有意义的备注名称,方便后续管理。

- 点击“提交”按钮,完成设备添加。
# 2.2 批量添加
- 功能描述:物联网平台的批量添加设备功能旨在提升设备管理效率,允许用户一次性添加多个物联网设备到平台,而无需逐个手动添加。这对于拥有大量设备的企业或项目来说,能够显著节省时间和人力成本。
- 试用场景:
- 大规模部署:当企业需要快速部署大量新设备时,如智能工厂中一次性投入大量传感器,或城市智能照明系统安装多个路灯控制器。
- 设备替换:在设备更新换代时,需要同时替换多个旧设备,使用批量添加功能可以迅速将新设备接入平台。
- 操作步骤:
- 登录物联网平台,选择实例进入实例详情页面,通过左侧导航菜单点击进入设备管理页面;

- 在设备管理页面中,找到并点击“批量添加”按钮,进入批量添加设备的操作界面;

- 在批量添加设备的操作界面中,按照提示填写设备信息:
- 产品:选择设备所属的产品。
- 生成方式:选择“自动生成”,系统会自动生成设备的唯一标识符;选择“批量上传”,则需要用户手动上传设备的导入文件。
- 设备数量:输入需要批量添加的设备数量。
- 点击“确定”按钮,完成设备批量添加。
- 登录物联网平台,选择实例进入实例详情页面,通过左侧导航菜单点击进入设备管理页面;
# 2.3 设备删除
- 功能描述:允许用户将不再使用的设备从平台中删除。
- 操作步骤:
- 在设备管理页面中,找到需要删除的设备。
- 点击设备表格右侧的“删除”按钮。
- 在确认提示框中,点击“确定”按钮,完成设备删除。
# 2.4 设备查看
- 功能描述:允许用户在物联网平台上对已注册的设备进行查看和了解。通过该功能,用户可以获取设备的各种信息,包括实时状态、历史数据等,从而实现对设备的有效监控和管理。
- 操作步骤:
- 在设备管理页面中,找到需要查看的设备;
- 点击设备表格右侧的“查看”按钮,进入到设备的详情页面。
- 具体查看内容:
设备基本信息
- 设备信息:包括设备的名称、所属产品相关信息、MQTT连接参数、运行状态、备注等基本信息。
- 设备扩展信息:包括设备的扩展信息,如设备的版本号、模组信息等。

Topic列表:显示设备订阅的Topic列表。

物模型数据:物模型数据展示内容围绕设备的属性、服务和事件展开,能帮助用户全面了解设备的状态、功能及运行情况。

# 2.5 设备上线和下线
# 功能描述
- 设备上线:设备上线是指将处于离线状态的物联网设备连接到物联网平台,使其能够与平台进行数据交互和通信的操作。当设备成功上线后,平台可以对该设备进行实时监控、配置管理、数据采集等一系列操作。设备上线功能为物联网系统的正常运行提供了基础,确保设备能够及时、准确地将自身状态和采集到的数据传输到平台,从而实现对设备的远程管理和控制。
- 设备下线:设备下线则是使处于在线状态的物联网设备与平台断开连接的操作。设备下线可能是由于多种原因引起的,例如设备需要进行维护、更换位置、电量不足等。当设备下线后,平台将无法实时获取该设备的数据,但设备的基本信息和历史数据仍会保留在平台中。设备下线功能有助于在特定情况下对设备进行有效的管理和控制,避免不必要的数据传输和资源浪费。
# 操作步骤
- 设备上线:
- 获取MQTT连接参数
- 进入设备管理页面,然后点击设备表格右侧的“查看”按钮,进入到设备的详情页面;
- 设备详情页面获取,点击查看MQTT连接参数;

- 复制MQTT连接参数,包括MQTT Broker地址、端口号、客户端ID、用户名和密码;
- 在设备端,使用MQTT客户端连接到MQTT Broker,并使用上述连接参数进行连接;
- 连接成功后,设备可以开始发布和订阅相关的Topic,以实现与平台的通信;
- 设备上线后,在租户平台设备列表状态栏显示设备状态为在线,后续可以对设备进行管理和控制。

- 设备下线:
- 设备下线操作通常由设备端发起,设备端可以通过MQTT客户端与MQTT Broker断开连接;
- 设备下线后,平台将无法实时获取该设备的数据,但设备的基本信息和历史数据仍会保留在平台中;
- 设备下线后,平台可以对设备进行有效的管理和控制,避免不必要的数据传输和资源浪费。
# 注意事项
- 在设备上线前,确保设备的网络配置正确,并且能够访问平台的服务器;
- 在设备下线前,确保已完成必要的数据备份和操作,避免数据丢失;
- 如果设备上线或下线遇到问题,可以参考常见问题解答部分进行排查。
# 三、常见问题解答
# 3.1 设备添加失败怎么办?
- 检查设备的唯一标识符是否已经被使用。
- 检查设备的网络连接是否正常。
- 联系平台管理员,寻求帮助。
# 3.2 设备数据显示异常怎么办?
- 检查设备的传感器是否正常工作。
- 检查设备的通信参数是否配置正确。
- 检查平台的服务器是否正常运行。
# 3.3 设备维护操作失败怎么办?
- 检查设备的网络连接是否正常。
- 检查设备的固件版本是否支持该维护操作。
- 联系平台管理员,寻求帮助。