如何使用设备模拟器_物联网边缘计算(IoT Edge)-阿里云帮助中心

物联网边缘计算（Link IoT Edge）提供了场景联动、函数计算、流数据分析等多种服务，帮助用户构建物联网应用程序。考虑到用户没有大量可连接的实际设备来测试使用应用程序，物联网边缘计算同时提供一套设备模拟器（DeviceSimulator）的解决方案。

设备模拟器包含两部分：

驱动：在边缘端可以模拟所有类型的设备。设备的属性、事件、服务取决于物模型的定义，物模型相关信息，请参见物模型。
控制工具：改变设备模拟器的属性值、触发设备模拟器进行事件上报。

您只需要将设备和设备模拟器的驱动绑定，并部署至边缘端，结合控制工具，便可以脱离真实的物理设备进行应用程序的测试。本文将会对设备模拟器的使用进行详细介绍。

前提条件

下载设备模拟器驱动。
产品规格 边缘版本号 驱动下载地址
专业版、标准版 v1.8.2 ~ 最新版本 DeviceSimulator_v0.2
设备模拟器只适用于Link IoT Edge标准版和专业版v1.8.2及以上版本环境中使用，因此开始操作本文内容前，请确保您已完成边缘实例的创建。具体操作，请参见专业版环境搭建或标准版环境搭建。

使用设备模拟器驱动

上传驱动。
1. 登录边缘计算控制台。
2. 在左侧导航栏单击驱动管理。
3. 在驱动管理页面自研驱动页签下，单击新建驱动。
4. 在新建驱动对话框设置驱动参数，上传前提条件中下载到本地的设备模拟器驱动文件。具体操作，请参见云端发布。
  本示例中的参数设置如下图所示，其余参数，请参见云端发布内容设置，也可以不设置。
5. 完成参数的设置并上传成功驱动文件后，单击确认。您可以在驱动列表中看到刚刚创建的驱动。

分配驱动到边缘实例。

左侧导航栏单击边缘实例，在前提条件中创建好的边缘实例右侧单击查看。
在实例详情页面设备与驱动页签下，单击全部驱动右侧的+图标，在弹出面板中选择自研驱动，找到步骤1创建的DeviceSimulator驱动，单击对应操作列下的分配，将该驱动分配到边缘实例。

（可选）若您的边缘实例产品规格为专业版，则需要进行容器配置。

选择已分配的DeviceSimulator驱动，单击设备列表右侧的容器配置，设置如下图参数后，单击保存。

网络端口映射参数说明如下所示，其他说明，请参见示例驱动。

表 1. 参数说明
参数	描述
宿主机端口	设置一个宿主机当前没有在使用的端口号，将容器内端口映射到此端口上，例如设置为8999端口。
容器内端口	容器内端口固定位为9000。
协议类型	此处选择TCP。

添加子设备到边缘实例。
1. 在全部驱动下，单击DeviceSimulator驱动，然后在设备列表区域单击分配子设备，在DeviceSimulator驱动下，为边缘实例分配子设备。
2. 在分配子设备面板中，单击添加子设备。
3. 在添加设备对话框，单击新建产品，创建产品。
4. 在创建产品对话框中设置参数后，单击完成。
  详细的参数说明，请参见创建产品。
  表 2. 参数说明
  参数描述
  产品名称设置产品名称。
  所属品类选择标准品类下的边缘计算 > 其它设备。
  接入网关协议选择自定义。
5. 在添加设备对话框，单击前往配置为产品添加物模型。
  - 为产品添加temperature属性，详细的参数说明，请参见单个添加物模型中的“添加自定义功能”步骤。
  - 为产品添加high_temperature事件，详细的参数说明，请参见单个添加物模型中的“添加自定义功能”步骤。
    为事件增加参数。
6. 返回添加设备对话框，输入DeviceName的值后单击确定，为产品添加设备。
7. 在分配子设备对话框中，选择温度传感器产品下的temperatureSensor01设备，单击该设备右侧的分配，将该设备分配到实例中。
部署边缘实例。
在实例详情页面右上角单击部署，部署边缘实例。此时会弹出部署进程的对话框，您可以单击对话框中的查看日志查看具体部署情况。部署成功后边缘实例名称后显示部署成功。

使用设备模拟器控制工具

设备模拟器控制工具的功能和真实物理设备的按键类似。完成本文上方使用设备模拟器驱动的操作后，可使用设备模拟器控制工具。

登录您的远程终端。登录操作详情，请参见远程服务访问。
（可选）若您使用Link IoT Edge专业版软件，则需要在远程终端执行docker ps | grep 驱动名，查看是否有驱动容器。
如果有驱动容器，则需要执行如下命令，修改设备模拟器工具配置。否则无需执行此步骤。
```
echo 宿主机IP:宿主机端口 > /linkedge/run/ds_ctrl.conf
```
说明 宿主机IP为您边缘网关的宿主机IP；宿主机端口为您在本文上方使用设备模拟器驱动中的步骤2进行容器配置时设置的端口（本示例中为8999）。
使用设备模拟器控制工具控制设备行为。
进入/linkedge/gateway/build/bin 目录，执行 ./ds_ctrl命令即可看到工具的使用方式。
```
Usage: ds_ctrl <command>

where <command> is one of:
    property, event

ds_ctrl property productKey deviceName params            Change property
ds_ctrl event productKey deviceName eventCode params     Trigger event


For example(productKey = xxx, deviceName = yyy):
    ds_ctrl property xxx yyy '{"temperature":30}'
    ds_ctrl event xxx yyy alarm '{"temperature":90}'
```
- 可改变设备属性：
  1. 改变温度。
    使用工具将温度传感器温度改为30。
    ./ds_ctrl property a1WuxHr**** temperatureSensor01 '{"temperature":30}'
    系统返回如下信息，表示温度设置成功。
    Send property success!
  2. 登录物联网平台控制台，在实例概览页面，单击公共实例。
  3. 在左侧导航栏选择设备管理 > 设备，在相应设备名称右侧单击查看。
    在设备详情页面，选择物模型数据 > 运行状态页签，查看设备的运行状态。
  4. （可选）模拟多次温度变化。
    连续执行如下命令5次，每次将温度值+1。
    ./ds_ctrl property a1WuxHr**** temperatureSensor01 '{"temperature":31}'
    可在控制台中，设备的物模型数据 > 运行状态页签，单击查看数据查看数据的变化。
- 可触发设备事件：
  1. 上报高温事件。
```
./ds_ctrl event a1WuxHr**** temperatureSensor01 high_temperature '{"temperature":90}'
```
  2. 登录物联网平台控制台，在实例概览页面，单击公共实例。
  3. 在左侧导航栏选择设备管理 > 设备，在相应设备名称右侧单击查看。
    在设备详情页面，选择物模型数据 > 事件管理页签，查看设备的事件。

在线调试设备

在物联网平台控制台公共实例页面左侧导航栏，选择监控运维 > 在线调试，在在线调试页面，选择调试产品和调试设备。
获取设备属性。
单击属性调试，选择模块，然后单击获取，即可在输入框中看到当前温度值为35。
设置设备属性。
将温度设为40，单击设置后可在设备运行状态查看温度传感器温度值已变更为40。
其他自定义服务，会将相关信息打印到驱动日志中，并返回如下信息。
```
{"code":0,"message":"success"}
```

产品规格	边缘版本号	驱动下载地址
专业版、标准版	v1.8.2 ~ 最新版本	DeviceSimulator_v0.2

参数	描述
产品名称	设置产品名称。
所属品类	选择标准品类下的边缘计算 > 其它设备。
接入网关协议	选择自定义。