在线调试设备


你可以在线调试 EnOS 中已注册的设备，以快速定位问题，促进应用开发。

支持调试的设备类型和功能范围
  • 真实设备：是指当前已激活并连接到 EnOS，且处于 在线 状态的设备。仅支持在云端对真实设备进行以下下行操作：
    • 测点调试：获取测点的最新值，或下发设置测点值的命令。
    • 服务调用：下发调用设备服务的命令，并获取设备的执行状态日志。
  • 虚拟设备：是 EnOS 中处于 未激活 或 离线 状态的设备。虚拟设备可以模拟真实设备和云端建立连接，你可以在云端模拟上行和下行操作，包括：
    • 属性上报：模拟设备上报属性值。
    • 测点上报：模拟设备上报实时测点值。
    • 测点调试：获取测点的最新值，或下发设置测点值的命令。
    • 服务调用：下发调用设备服务的命令，并获取设备的执行状态日志。


设备支持何种属性、测点和命令，以及测点值是否支持设置，由该设备的模型决定。更多信息，参见 模型与资产建模。

前提条件


你需要有 开发者 角色，以访问应用门户的开发者控制台，如果没有需联系 OU 管理员添加。

调试设备数据


  1. 在 EnOS 应用门户的开发者控制台中选择 运行监控 > 在线调试。

  2. 选择设备所属的 产品，然后选择你要调试的 设备。

  3. 在右侧查看当前设备的状态。

    • 若该设备处于 在线 状态，且是 真实设备，前往 调试真实设备 标签页。

    • 若该设备处于 未激活 或 离线 状态，或显示为 虚拟设备，前往 调试虚拟设备 标签页。若当前设备未启用虚拟设备，你需要先点击 启动虚拟设备。


../../_images/debug_status.png


也可以前往 设备管理 > 设备资产，查看当前 OU 所有设备的状态。更多信息，参见 查看设备状态。


根据你需要调试的设备，进行以下操作。

测点调试

获取测点最新值


你可以从云端获取设备单个测点的最新值。该功能同时适用于真实设备和虚拟设备。

  1. 在 调试真实设备 或 调试虚拟设备 标签页，点击 测点调试，在 获取 的 调试功能 下拉列表中选择测点。

  2. 打开 自动刷新 开关，获取的数据将展示在 最新值 中，每 10 秒中刷新一次。右侧则无实时日志。


../../_images/debug_latest_point.png


当前值将同步更新在 设备管理 > 设备资产，你可以在设备详情页面的 测点 标签页查看。更多信息，参见 查看设备数据。

设置测点值


你可以在云端设置测点的值。该功能的完整步骤是：首先从云端向设备发送了一个“更新测点值”的命令，设备收到命令后，对该命令作出响应。该功能同时适用于真实设备和虚拟设备。

  1. 在 调试真实设备 或 调试虚拟设备 标签页，点击 测点调试，在 设置 的 调试功能 下拉列表中选择一个测点。

  2. 根据测点的数据类型，在输入框中输入你需要指定的测点值。

  3. 点击 发送指令。提示设置成功后，右侧将显示云端和设备端的相应日志，最新日志在最上方。以下图为例，日志包括以下部分：

    1. 模型服务调用：云端初始化了一个命令，目标是设置测点 AI1 的值。这是整个流程的起点，表示系统开始处理这个请求。

    2. 云到设备命令调用：云端向设备发送了一个具体的指令，要求将测点 AI1 的值设置为 2000。

    3. 模型服务调用：命令已成功发布到设备端，表明云端已将指令发送出去，等待设备响应。

    4. 设备到云命令调用：设备收到命令并成功执行，返回状态码 200 和消息 success，表示设备已将测点 AI1 设置为 2000。

    5. 模型服务调用：整个任务完成，云端确认设备成功执行了命令。taskResult 中的 code: 200 和 desc: success 进一步验证了成功状态。


../../_images/debug_set_point.png


由于这是云端向设备发送的命令，而不是设备上报的测点值，如果设备没有将更新后的测点值回传给云端，云端查看的测点最新值就不会变化。

该命令的下发和执行状态将同步更新在 设备管理 > 设备资产，你可以在设备详情页面的 命令 标签页查看。更多信息，参见 查看设备数据。

服务调用


你可以下发调用设备服务的命令，并获取设备的执行状态日志。该功能同时适用于真实设备和虚拟设备。

  1. 在 调试真实设备 或 调试虚拟设备 标签页，点击 服务调用，从 调试功能 下拉列表中选择一项服务。

  2. 根据所列出的服务的输入参数的数据类型，在输入框中数输入参数值。

  3. 点击 发送指令。提示调用成功后，右侧将显示云端和设备端的相应日志。


该命令的下发和执行状态将同步更新在 设备管理 > 设备资产，你可以在设备详情页面的 命令 标签页查看。更多信息，参见 查看设备数据。

上报属性


你可以模拟设备上送属性值。该功能仅适用于虚拟设备。

  1. 在 调试虚拟设备 标签页，选择 属性上报 标签页，从 调试功能 下拉列表中选择一个或多个属性。

  2. 根据属性的数据类型，在对应的输入框中输入属性的值。

  3. 选择 推送 按钮上报属性值，或选择 策略推送 配置定时推送时间或多次推送的频率。上报成功后，右侧将显示上报属性的相应日志。


../../_images/debug_attribute.png


由于这是从设备到云的属性上报，属性值将同步更新在 设备管理 > 设备资产。你可以选择页面中的 查看数据，跳转到设备的 属性 页面查看最新属性值。

上报测点


你可以模拟设备上送测点值。该功能仅适用于虚拟设备。

  1. 在 调试虚拟设备 标签页，选择 测点上报，从 调试功能 下拉列表中选择一个或多个测点。

  2. 根据测点的数据类型，在对应的输入框中输入测点的值。

  3. 点击 推送 按钮上报测点，或选择 策略推送 配置定时推送时间或多次推送的频率。上报成功后，右侧将显示上报测点的相应日志。


由于这是从设备到云的测点上报，测点值将同步更新在 设备管理 > 设备资产。你可以选择页面中的 查看数据，跳转到设备的 测点 页面查看最新测点值。

其它操作


在 调试真实设备 或 调试虚拟设备 标签页，你还可以对调试数据进行以下操作：

  • 重置调试数据：选择 重置 reset 按钮，重置已输入的调试数据。

  • 关闭虚拟设备：选择 关闭 close 按钮，关闭虚拟设备。关闭后，你仍然可以再次启动虚拟设备。

  • 刷新实时日志：自动刷新 开关默认打开。你也可以选择 刷新 refresh 手动刷新实时日志。

  • 清除实时日志：选择 清除 clear 按钮，清除右侧展示的实时日志。