管理设备¶

本文介绍如何查看设备状态，导出、导入、启用、禁用、删除设备，如何获取设备三元组信息等管理操作。

前提条件¶

你需要有开发者角色，以访问应用门户的开发者控制台，如果没有需联系 OU 管理员添加。
了解设备的激活运行状态，参见设备安全认证。
了解设备的使用限制，参见使用限制 - 设备。

查看设备概览¶

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 概览。
在概览报表中，你可以获知以下信息：
- 设备状态：包括设备总数、在线设备数量、离线设备数量、未激活设备数量和禁用设备数量。
- 固件版本分布：所选范围內设备固件的版本统计。
- 测点上报：包括测点上报成功数量和失败请求数量。
- 命令下发：包括命令下发成功数量和下发失败数量。

查看设备状态 ¶

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
在设备列表中状态栏可查看设备状态。
- 未激活：设备在 EnOS 云端从未激活。一旦设备被激活，页面将显示设备的运行状态：在线和离线。
- 在线：设备目前在线。可能是真实设备在线，也可能是云端为该设备启用了虚拟设备，模拟设备在线状态。
- 离线：设备目前离线。
- 禁用：设备已被禁用。

查看设备数据 ¶

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 逻辑资产。
点击设备对应的查看图标，可在设备详情执行以下操作：
- 在 设备信息 标签页，查看设备的基本信息，及其关联的模型信息。
- 在属性标签页，查看设备的属性值。
  - 如果已有真实设备，可使用 MQTT 协议上报设备属性。更多信息，参见上报属性信息。
  - 如果需要在真实设备接入前，调试该设备的数据，可以通过在线调试模拟 未激活 或离线状态的设备上报属性值的过程。模拟的属性值同样展示在当前列表。
- 在测点标签页，查看设备上送的测点值。
  - 如果已有真实设备，可使用 MQTT 或 HTTP 协议上报设备测点数据。更多信息，参见 EnOS 设备接入协议。
  - 如果没有真实设备，可以通过设备模拟器模拟设备在一段时间内上送测点值的过程。模拟的测点值将展示在当前列表。
  - 如果需要在真实设备接入前，调试该设备的数据，可以通过在线调试模拟 未激活 或离线状态的设备上报测点值的过程。模拟的测点值同样展示在当前列表。
- 在命令标签页，查看云端给设备发送的命令状态。更多信息，参见下发命令。
  - 如果需要调试设备（无论有无真实设备）接收命令的过程，可以通过在线调试模拟云端下发命令，包括设置测点和服务调用，并获取云端和设备端的日志。
- 在 文件管理 标签页，查看设备已经上传的文件，并可以下载或删除指定的文件。更多信息，参见管理资产文件。

导出设备¶

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产，并点击 批量操作。
导出有两种方式。点击 导出 > 导出全部 以导出在设备列表中所有的设备，或在设备列表中勾选需要导出的设备，点击 导出 > 导出勾选项。
将包含 Excel 文件的压缩包保存到本地目录。导出的设备信息将按照产品分为不同 Excel 文件，每个 Excel 文件代表一个产品，文件名称是产品的 product key。

导入设备 ¶

你可以通过导入 Excel 文件批量创建新设备，或批量更新不同产品的现有设备。如果导入已存在的设备，将更新原有设备的信息。若设备不存在，将新建设备。

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
点击 导入设备。
上传包含一个或多个设备 .xlsx 文件的压缩包。若需要模板，从模板下拉框选择一个或多个当前产品，然后点击 生成模板 以下载一个压缩包，其中包含基于所选产品而生成的 Excel 模板。下载后请编辑模板，压缩并上传文件。

备注

每个 Excel 模板代表一个产品。模板文件命名规则为 ProductKey_yourProductKey.xlsx，yourProductKey 为设备所属产品的 product key，可以在 设备管理 > 产品管理 中获取。因此，Excel 文件内的所有设备都将归到 Excel 模板所代表的产品下。

4. 点击导入。表格中请勿出现空行，否则可能导致文件无法导入成功。

5. 如果无效记录存在，将弹出窗口显示错误消息和 下载错误文件 链接。点击链接下载文件，检查错误原因，并纠正错误，然后重新上传文件。

6. 新设备导入成功后将会出现在 设备管理 > 设备资产 的设备列表中。

启用/禁用设备¶

设备成功创建后默认启用，如果发现设备有异常情况，可在 EnOS 中禁用该设备。

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
启用/禁用设备有两种方式。
- 启用/禁用单个设备：在设备列表中，为需要启用/禁用的设备切换 启用/禁用 开关。
- 批量启用/禁用：点击 批量操作，选择需要启用/禁用的设备并根据需求点击启用或禁用。
如果设备已启用，状态列将显示其状态（未激活/在线/离线）。如果设备被禁用，状态列将显示 “已禁用”。

删除设备¶

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
删除设备有两种方式。
- 删除单个设备：在设备列表中，为需要删除的设备点击 … > 删除。
- 批量删除：点击 批量操作，选择需要删除的设备并点击 … > 删除。
在弹窗中点击删除。删除的设备将不再显示在设备列表中。

获取设备三元组信息 ¶

设备三元组信息包括 Product Key, Device Key 和 Device Secret，用于设备身份认证。

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
在设备列表中找到目标设备，点击该设备的查看进入设备详情页面。
找到 Product Key, Device Key 和 Device Secret 的信息。

为网关设备批量添加子设备¶

按照以下步骤，可以为网关设备添加子设备。

在 EnOS 应用门户的开发者控制台中选择 设备管理 > 设备资产。
对于节点类型为网关的设备，点击 … > 子设备，进入 子设备 标签页。
点击 添加子设备，在弹窗中输入搜索条件，选择未被添加到其它网关下的设备，点击确定。

消息跟踪¶

在设备激活、命令下发和数据上报过程中，若出现业务故障，可通过消息跟踪功能快速定位故障，并进行原因分析。

进入 设备管理 > 设备资产。
对需要消息跟踪的设备，点击查看。
在 设备详情 页，选择 消息跟踪 标签页。
点击 启动跟踪 并设置跟踪时间（最长 3 天）然后点击确定。
设备实时日志（若有）将滚动显示在下方列表中，按时间倒序排列，最近的显示在最上面。点击 清空历史数据 可清空列表。
点击 停止跟踪 即可停止消息跟踪。

备注

关闭网页则自动停止抓取实时日志信息和显示，但不会停止消息跟踪。停止该过程需手动点击 停止跟踪。